ALTER LISTING

Ändert die Eigenschaften eines Freigabeangebots.

Siehe auch:

CREATE LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, Referenz zum Freigabeangebots-Manifest

Syntax

ALTER LISTING [ IF EXISTS ] <name>
  [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
  [ PUBLISH={ TRUE | FALSE } ]
  [ REVIEW= { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;

ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'
Copy

Parameter

name

Gibt den Bezeichner (d. h. den Namen) des zu ändernden Freigabeangebots an.

yaml_manifest_string

Gibt das Manifest im YAML-Format für das Freigabeangebot an. Weitere Informationen und Beispiele zu Manifest-Dateien von Freigabeangeboten finden Sie unter Referenz zum Freigabeangebots-Manifest.

Manifeste werden normalerweise als in Dollarzeichen eingeschlossene Zeichenfolgen bereitgestellt. Weitere Informationen dazu finden Sie unter In Dollarzeichen eingeschlossene Zeichenfolgenkonstanten.

RENAME TO new_name

Gibt den neuen Bezeichner des Freigabeangebots an, der eindeutig sein muss. Der neue Bezeichner kann nicht verwendet werden, wenn der Bezeichner bereits für ein anderes Freigabeangebot verwendet wird.

{ PUBLISH | UNPUBLISH }

Gibt die Aktion an, die auf dem Freigabeangebot ausgeführt werden soll:

  • PUBLISH Macht ein zuvor nicht auffindbares Freigabeangebot auffindbar.

    Die Angabe von PUBLISH bei einem bereits veröffentlichten Angebot hat keine Auswirkungen.

  • UNPUBLISH Macht einen zuvor auffindbares Freigabeangebot für neue Verbraucher unauffindbar. Bestehende Verbraucher können weiterhin auf die Daten zugreifen, die mit einem unveröffentlichten Angebot verbunden sind.

    Die Angabe von UNPUBLISH bei einem zuvor unveröffentlichten Angebot hat keine Auswirkungen.

Siehe auch Freigabeangebot zurückziehen.

SET ...

Gibt eine (oder mehrere) Eigenschaften an, die für das Freigabeangebot festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder Neue-Zeile-Zeichen):

COMMENT = 'string_literal'

Fügt einen Kommentar hinzu oder überschreibt den vorhandenen Kommentar zu einem vorhandenen Freigabeangebot.

PUBLISH = { TRUE | FALSE }

Gibt an, wie das Freigabeangebot veröffentlicht werden soll.

Bei TRUE, wird das Angebot sofort bei der Veröffentlichung an Marketplace Ops zur Überprüfung weitergeleitet.

Standard: TRUE.

REVIEW =  { TRUE | FALSE }

Gibt an, ob das Freigabeangebot zur Überprüfung an Marketplace Ops weitergeleitet werden soll oder nicht.

Standard: TRUE.

Verschiedene Kombinationen von Werten für die Eigenschaften PUBLISH und REVIEW führen zu den folgenden Verhaltensweisen:

PUBLISH

REVIEW

Verhalten

TRUE

TRUE

Anfordern einer Überprüfung und direkte Veröffentlichung nach der Genehmigung.

TRUE

FALSE

Führt zu einem Fehler. Sie können kein Angebot auf Snowflake Marketplace ohne Überprüfung veröffentlichen.

FALSE

TRUE

Anfordern einer Überprüfung, ohne dass danach automatisch die Veröffentlichung erfolgt.

FALSE

FALSE

Speichern des Freigabeangebots als Entwurf, ohne eine Überprüfung oder Veröffentlichung anzufordern.

Nutzungshinweise

  • Nur Entwürfe oder unveröffentlichte Freigabeangebote können umbenannt werden.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zum Ausführen dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigungen

Berechtigung

Objekt

Anmerkungen

OWNERSHIP oder MODIFY

Für das zu ändernde Freigabeangebot.

Delegierte Berechtigungen für die Konfiguration der Cloud-übergreifenden automatischen Auftragsausführung.

ALTER-Befehl ändert Manifest-Inhalt für automatische Auftragsausführung

Weitere Informationen dazu finden Sie unter Konten die Einrichtung der Cloud-übergreifenden automatischen Ausführung erlauben.

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einem bestimmten Satz von Berechtigungen finden Sie unter Erstellen kundenspezifischer Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zum Ausführen von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Beispiele

Ändern des Freigabeangebots MY_LISTING, um eine aktualisierte Manifest-Datei zu verwenden:

ALTER LISTING MYLISTING
AS
  $$
  title: "MyListing"
  subtitle: "Subtitle for MyListing"
  description: "Description or MyListing"
  listing_terms:
    type: "STANDARD"
  targets:
    accounts: ["Org1.Account1"]
  usage_examples:
     - title: "this is a test sql"
       description: "Simple example"
       query: "select *"
  $$
Copy

Ändern des Freigabeangebots MYLISTING, um das Angebot zu veröffentlichen:

ALTER LISTING MYLISTING PUBLISH;
Copy

Ändern des Freigabeangebots MYLISTING, um die Veröffentlichung des Angebots zurückzunehmen.

ALTER LISTING MYLISTING UNPUBLISH;
Copy

Ändern des Freigabeangebots MYLISTING, um einen neuen Kommentar einzugeben:

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
Copy
Sprache: Deutsch