CREATE LISTING¶

Erstellen Sie ein kostenloses Freigabeangebot, das Sie direkt für bestimmte Verbrauchern freigeben.

Siehe auch:: ALTER LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, Referenz zum Freigabeangebots-Manifest

Syntax¶

CREATE EXTERNAL LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  AS '<yaml_manifest_string>'
  [ PUBLISH = { TRUE | FALSE } ]
  [ REVIEW = { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

Copy

Parameter¶

name

Gibt den Bezeichner (d. h. den Namen) des Freigabeangebots an. Dieser muss den folgenden Anforderungen genügen:

Muss innerhalb einer Organisation eindeutig sein, unabhängig davon, in welcher Snowflake Region sich das Konto befindet.
Muss mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, es handelt sich um Unterstriche (_).

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

SHARE share_name

Gibt den Bezeichner der Freigabe an, die dem Freigabeangebot zugeordnet ist.

APPLICATION PACKAGE package_name

Gibt das Anwendungspaket an, das dem Freigabeangebot zugeordnet ist.

Siehe auch SHOW APPLICATION PACKAGES.

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.

COMMENT = 'string_literal'

Gibt einen Kommentar zum Freigabeangebot an.

Standard: Kein Wert

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.

Anforderungen an die Zugriffssteuerung¶

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

Berechtigung	Objekt	Anmerkungen
CREATE DATA EXCHANGE LISTING	Konto	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.
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 Rolle, die zum Ausführen dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

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.

Nutzungshinweise¶

Freigabeangebote, die mit CREATE LISTING … erstellt wurden, werden automatisch veröffentlicht. Weitere Informationen zu den Operationen zum Veröffentlichen und Zurückziehen von Angeboten finden Sie unter ALTER LISTING.

Beispiele¶

Erstellen Sie ein Freigabeangebot mit dem Namen ‚MYLISTING‘ und mit dem angegebenen Manifest, und reichen Sie es zur Überprüfung und anschließenden Veröffentlichung ein.

Weitere Beispiele und Anwendungsfälle für das Verwalten von Freigabeangeboten mit SQL finden Sie unter Freigabeangebote mit SQL als Anbieter verwalten – Beispiele.

Bemerkung

In diesem Beispiel werden die Standardwerte für PUBLISH und REVIEW verwendet.

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

Copy

Erstellen Sie ein Freigabeangebot mit dem Namen ‚MYLISTING‘ und mit dem angegebenen Manifest als Entwurf.

CREATE EXTERNAL LISTING MYLISTING
SHARE MySHARE AS
$$
title: "MyListing"
subtitle: "Subtitle for MyListing"
description: "Description for MyListing"
listing_terms:
  type: "OFFLINE"
targets:
   regions: ["PUBLIC.AWS_US_EAST_1", "PUBLIC.AZURE_WESTUS2"]
usage_examples:
   - title: "this is a test sql"
     description: "Simple example"
     query: "select *"
$$ PUBLISH=FALSE REVIEW=FALSE;

Copy