ALTER LISTING¶

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>'

Parameter¶

name

Gibt den Bezeichner (Namen) für das zu ändernde Freigabeangebot an.

yaml_manifest_string

Gibt das Manifest im YAML-Format für das Freigabeangebot an. Informationen und Beispiele für Freigabeangebote von Manifestdateien 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:

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 zum Ausführen dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

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 Konten die Einrichtung der Cloud-übergreifenden automatischen Ausführung erlauben.

Um ein Objekt in einem Schema zu bearbeiten, benötigen Sie außerdem die Berechtigung USAGE für die übergeordnete Datenbank und das Schema.

Anweisungen zum Erstellen einer kundenspezifische Rolle mit einer bestimmten Anzahl von Berechtigungen finden Sie unter creating custom roles.

Allgemeine Informationen zu Rollen und Berechtigungen zum Ausführen 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

Ä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