ALTER LISTING¶
Ändert die Eigenschaften eines Freigabeangebots mit einem Inline-YAML-Manifest oder aus einer Datei, die sich an einem Stagingbereich-Standort befindet.
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>'
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, oderABORT
, 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 *" $$
Reicht das Freigabeangebot MYLISTING zur Überprüfung ein:
ALTER LISTING MYLISTING REVIEW;
Ändert das Freigabeangebot MYLISTING, indem es veröffentlicht wird:
ALTER LISTING MYLISTING PUBLISH;
Ändert das Freigabeangebot MYLISTING, indem die Veröffentlichung aufgehoben wird:
ALTER LISTING MYLISTING UNPUBLISH;
Ändert das Freigabeangebot MYLISTING, indem ein neuer Kommentar eingegeben wird:
ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
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;