CREATE ORGANIZATION LISTING¶
Erstellen Sie ein Organisations-Freigabeangebot, um Datenprodukte sicher innerhalb Ihrer Organisation zu teilen.
Syntax¶
CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
[ { SHARE <share_name> | APPLICATION PACKAGE <package_name> } ]
AS '<yaml_manifest_string>'
[ PUBLISH = { TRUE | FALSE } ]
CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
[ { SHARE <share_name> | APPLICATION PACKAGE <package_name> } ]
FROM '<yaml_manifest_stage_location>'
[ PUBLISH = { 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.
FROM 'yaml_manifest_stage_location'
Gibt den Pfad für die manifest.yml-Datei des internen Stagingbereichs oder des Git-Repository-Klons an.
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'
Das YAML-Manifest für das Organisationsprofil. Details und Beispiele zu den Manifestfeldern finden Sie unter Manifest-Referenz für Organisations-Freigabeangebot.
Manifeste werden normalerweise als in Dollarzeichen eingeschlossene Zeichenfolgen angegeben. Weitere Informationen dazu finden Sie unter Zeichenfolgenkonstanten in Dollarzeichen.
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.
Anforderungen an die Zugriffssteuerung¶
Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:
Berechtigung |
Objekt |
Anmerkungen |
---|---|---|
CREATE ORGANIZATION LISTING oder CREATE LISTING |
Konto |
Zum Erstellen und Ändern von Organisations-Freigabeangeboten. |
Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens eine der folgenden Berechtigungen haben:
Berechtigung |
Objekt |
Anmerkungen |
---|---|---|
CREATE ORGANIZATION LISTING |
ACCOUNT |
Um die angegebene Freigabe oder die angegebene Snowflake Native App Framework an ein Freigabeangebot anzuhängen. Wenn Sie eine Snowflake Native App Framework angeben, sind auch OWNERSHIP oder ATTACH LISTING erforderlich. |
IMPORT ORGANIZATION LISTING |
ACCOUNT |
Um ein Freigabeangebot zu mounten oder eine Abfrage auszuführen, die einen Uniform Listing Locator (ULL) verwendet, um auf ein Organisations-Freigabeangebot zu verweisen. |
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.
Bemerkung
support_contact
ist erforderlich. approver_contact
ist erforderlich, wenn ein discovery
Ziel angegeben ist.
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>"
$$
Erstellt einen Entwurf eines Freigabeangebots mit dem Namen ‚MYLISTING‘ von einem bestimmten Stagingbereich aus. Im folgenden Beispiel befindet sich die Datei manifest.yml
im Ordner listingmanifests
im Stagingbereich mit dem Namen listingstage
.
CREATE ORGANIZATION LISTING MYLISTING
SHARE MySHARE FROM @dbforstage.public.listingstage/listingmanifests;