CREATE ORGANIZATION LISTING¶

構文¶

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

パラメーター¶

name

リストの識別子（名前）を指定します。以下に準拠する必要があります。

• アカウントがどのSnowflake Regionにあるかに関わらず、アカウント内で一意である必要があります。Uniform Listing Locator (ULL) は、組織内で一意でなければなりません。

• ドル記号を埋め込むことはできません。

• Snowflakeの識別子要件に適合していること。 識別子の要件 をご参照ください。

SHARE share_name

リストにアタッチする共有の識別子を指定します。

APPLICATION PACKAGE package_name

リストにアタッチされているアプリケーションパッケージを指定します。

SHOW APPLICATION PACKAGES もご参照ください。

AS 'yaml_manifest_string'

リストの YAML 形式マニフェストを指定します。マニフェストファイルのリストの詳細と例については、 リストマニフェスト参照 を参照してください。

マニフェストは通常、ドル引用符で囲まれた文字列として提供されます。詳細については、 ドル引用符付き文字列定数 をご参照ください。

PUBLISH = { TRUE | FALSE }

リストの公開方法を指定します。

TRUE の場合、リストは即座に社内マーケットプレイスに公開されます。

デフォルト: TRUE。

REVIEW =  { TRUE | FALSE }

リストがレビューと承認のために提出されるかどうかを指定します。

デフォルト: TRUE。

以下の表は、 PUBLISH と REVIEW プロパティの組み合わせと、それらに関連する動作のリストです。

PUBLISH	REVIEW	動作
TRUE	TRUE	レビューをリクエストし、承認されたらすぐに公開します。
TRUE	FALSE	エラーを返します。リストは掲載前に審査を受ける必要があります。
FALSE	TRUE	自動掲載されないレビューのリクエスト。
FALSE	FALSE	リストを下書きとして保存します。

アクセス制御の要件¶

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 のいずれかが必要です。

この SQL コマンドの実行に使用されるロールは、次のいずれかの権限を持っている必要があります。

使用上の注意¶

• CREATE ORGANIZATION LISTING... を使用して作成されたリストは、自動的に公開されます。

例¶

この例では、マニフェスト YAML で指定されたセットを使用して、 MYORGLISTING という名前のリストを作成します。1リージョンの1アカウントの1ロールをターゲットとし、サポートと承認者の連絡先を含みます。

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>"
$$
;