CREATE ORGANIZATION LISTING¶

Syntax¶

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

Parameter¶

name

Gibt den Bezeichner (Namen) für das Freigabeangebot an. Dieser muss den folgenden Anforderungen genügen:

• Muss innerhalb eines Kontos eindeutig sein, unabhängig davon, in welcher Snowflake Region sich das Konto befindet. Der Uniform Listing Locator (ULL) muss innerhalb einer Organisation eindeutig sein.

• Kann keine eingebetteten Dollarzeichen enthalten.

• Muss den Bezeichner-Anforderungen von Snowflake entsprechen. Siehe Anforderungen an Bezeichner.

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.

AS 'yaml_manifest_string'

Gibt das Manifest im YAML-Format für das Freigabeangebot an. Unter Referenz zum Freigabeangebots-Manifest finden Sie Details und Beispiele für Freigabeangebote von Manifestdateien.

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

PUBLISH = { TRUE | FALSE }

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

Wenn Sie TRUE wählen, wird das Freigabeangebot sofort auf dem Internal Marketplace veröffentlicht.

Standard: TRUE.

REVIEW =  { TRUE | FALSE }

Gibt an, ob das Freigabeangebot zur Überprüfung und Genehmigung vorgelegt wird.

Standard: TRUE.

In der folgenden Tabelle sind die verschiedenen Eigenschaftskombinationen von PUBLISH und REVIEW und die damit verbundenen Verhaltensweisen aufgeführt:

PUBLISH	REVIEW	Verhalten
TRUE	TRUE	Anfordern einer Überprüfung und direkte Veröffentlichung nach der Genehmigung.
TRUE	FALSE	Gibt einen Fehler zurück. Ein Freigabeangebot muss vor der Veröffentlichung geprüft werden.
FALSE	TRUE	Fragt eine Überprüfung ohne automatische Veröffentlichung an.
FALSE	FALSE	Speichert das Freigabeangebot als Entwurf ohne Überprüfung oder Veröffentlichung.

Anforderungen an die Zugriffssteuerung¶

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

Die Rolle, mit der Sie diesen SQL-Befehl ausführen, muss eine der folgenden Berechtigungen haben:

Nutzungshinweise¶

• Freigabeangebote, die mit CREATE ORGANIZATIONLISTING … erstellt wurden, werden automatisch veröffentlicht.

Beispiele¶

In diesem Beispiel wird ein Freigabeangebot mit dem Namen MYORGLISTING unter Verwendung der im Manifest-YAML angegebenen Einstellungen erstellt. Es zielt auf eine Rolle in einem Konto in einer Region ab und umfasst Support- und Genehmigungskontakte.

USE ROLE <organization_listing_role>;

CREATE ORGANIZATION LISTING MYORGLISTING
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
discovery:
   - account: "<account_name>"
roles:
   - "<role>"
access:
   - account: "<account_name>"
   roles:
   - "<role>"
support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
   access_regions:
   - name: "PUBLIC.<snowflake_region>"
$$
;