ALTER LISTING

Ändert die Eigenschaften eines Freigabeangebots mit einem Inline-YAML-Manifest oder aus einer Datei, die sich an einem Stagingbereich-Standort befindet.

Siehe auch:

CREATE LISTING, DESCRIBE LISTING, SHOW LISTINGS, SHOW VERSIONS IN LISTING, DROP LISTING

Syntax

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH | REVIEW } ]

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

ALTER LISTING <name> ADD VERSION [ [ IF NOT EXISTS ] <version_name> ]
  FROM <yaml_manifest_stage_location>
  [ 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 (Namen) für das zu ändernde Freigabeangebot an.

{ PUBLISH | UNPUBLISH | REVIEW }

Die Aktion, die für das Freigabeangebot durchgefü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.

  • REVIEW Reicht das Freigabeangebot zur Überprüfung ein.

yaml_manifest_string

Das YAML-Manifest für das Freigabeangebot. Die Parameter für das Manifest finden Sie unter Referenz zum Freigabeangebots-Manifest.

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

ADD VERSION version_name

Gibt den eindeutigen Bezeichner der Version an, die hinzugefügt wird. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss der gesamte Bezeichner in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelten Anführungszeichen eingeschlossen sind, wird ebenfalls zwischen Groß- und Kleinschreibung unterschieden. Informationen zur Syntax der Bezeichner finden Sie unter Anforderungen an Bezeichner.

FROM 'yaml_manifest_stage_location'

Gibt den Pfad für die manifest.yml-Datei des internen oder Snowflake-Git-Repository-Klons an. Wenn die Änderungen eine Überprüfung durch Marketplace Ops erfordern, verwenden Sie die Operationen REVIEW und PUBLISH.

RENAME TO new_name

Ändert den Namen des Freigabeangebots in new_name. Die Namen von Freigabeangeboten müssen eindeutig sein. Der neue Bezeichner kann nicht verwendet werden, wenn der Bezeichner bereits für ein anderes Freigabeangebot verwendet wird.

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

  • Freigabeangebote können nur im Zustand DRAFT umbenannt werden.

  • Wenn Sie die Live-Version des Manifests im Format YAML für ein Freigabeangebot einstellen, müssen Sie COMMIT verwenden, um die Änderungen zu übernehmen, oder ABORT, um die Änderungen zu verwerfen.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

OWNERSHIP oder MODIFY

Für das zu ändernde Freigabeangebot.

Wenn Sie den Befehl ALTER verwenden, um den Inhalt des Manifests für die automatische Ausführung zu ändern, müssen Sie eine Rolle mit den delegierten Berechtigungen verwenden, die für die Konfiguration der Cloud-übergreifenden automatischen Ausführung erforderlich sind. Siehe Delegieren Sie Berechtigungen, um die automatische Ausführung einzurichten.

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

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

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

Beispiele

Ändert das Freigabeangebot MYLISTING, um eine aktualisierte Manifestdatei 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

Reicht das Freigabeangebot MYLISTING zur Überprüfung ein:

ALTER LISTING MYLISTING REVIEW;
Copy

Ändert das Freigabeangebot MYLISTING, indem es veröffentlicht wird:

ALTER LISTING MYLISTING PUBLISH;
Copy

Ändert das Freigabeangebot MYLISTING, indem die Veröffentlichung aufgehoben wird:

ALTER LISTING MYLISTING UNPUBLISH;
Copy

Ändert das Freigabeangebot MYLISTING, indem ein neuer Kommentar eingegeben wird:

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

Fügt eine neue Version aus dem Stagingbereich-Standort der angegebenen YAML-Manifestdatei hinzu:

ALTER LISTING MYLISTING ADD VERSION V3 FROM @dbforstage.public.listingstage/listingmanifests;
Copy