CREATE LISTING

リスト を無料で作成し、特定のコンシューマーと直接共有することができます。

こちらもご参照ください。

ALTER LISTING、 DESCRIBE LISTING、 SHOW LISTINGS、 DROP LISTING、 リストマニフェスト参照

構文

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

パラメーター

name

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

  • アカウントはどのSnowflake Regionにあるかに関係なく、組織内で一意である必要があります。

  • アルファベット文字で始まる必要があり、スペースやアンダースコア（_） 以外の 特殊文字を含めることはできません。

AS 'yaml_manifest_string'

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

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

SHARE share_name

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

APPLICATION PACKAGE package_name

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

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

PUBLISH = { TRUE | FALSE }

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

TRUE の場合、リストはMarketplace Opsへのリストにレビューのためにすぐに公開されます。

デフォルト: TRUE。

REVIEW =  { TRUE | FALSE }

リストがMarketplace Opsのレビューに提出されるべきかどうかを指定します。

デフォルト: TRUE。

COMMENT = 'string_literal'

リストのコメントを指定します。

デフォルト: 値なし

PUBLISH、REVIEW プロパティの値の組み合わせが異なると、以下のような動が引き起こされます。

PUBLISH

REVIEW

動作

TRUE

TRUE

レビューをリクエストし、承認されたらすぐに公開します。

TRUE

FALSE

エラーが発生します。レビューなしで Snowflake Marketplace にリストを公開できません。

FALSE

TRUE

レビュー後、自動的に公開されることなくレビューをリクエストできます。

FALSE

FALSE

レビューや公開をリクエストせずに、リストをドラフトとして保存します。

アクセス制御の要件

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

権限

オブジェクト

メモ

CREATE DATA EXCHANGE LISTING

アカウント

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

クロスクラウド自動複製を構成するために委任された権限。

ALTER コマンドが自動フルフィルメントのためにマニフェストコンテンツを変更している場合

アカウントがクロスクラウドの自動複製を設定できるようにする をご参照ください。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

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

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • CREATE LISTING ... を使用して作成されたリストは、自動的に公開されます。非公開と公開の操作については、 ALTER LISTING をご参照ください。

例

指定されたマニフェストで名前が 'MYLISTING' のリストを作成し、レビューとその後の公開のために送信します。

SQL を使用したリスト管理に関連するその他の例と使用例については、 SQL をプロバイダーとしてリスティングを管理する - 例 をご参照ください。

注釈

この例では、PUBLISH と REVIEW にデフォルト値を使用しています。

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

指定されたマニフェストを持つ、名前が 'MYLISTING' のリストをドラフトとして作成します。

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
言語: 日本語