ALTER LISTING

リスト のプロパティを変更します。

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

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

構文

ALTER LISTING [ IF EXISTS ] <name>
  [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
  [ PUBLISH={ TRUE | FALSE } ]
  [ REVIEW= { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;

ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'
Copy

パラメーター

name

変更するリストの識別子（つまり、名前）を指定します。

yaml_manifest_string

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

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

RENAME TO new_name

一意でなければならないリストの新しい識別子を指定します。識別子が別のリストにすでに配置されている場合、新しい識別子は使用できません。

{ PUBLISH | UNPUBLISH }

リストで実行するアクションを指定します。

  • PUBLISH 以前は発見不可能だったリストを発見可能にします。

    以前に公開されたリストに PUBLISH を指定しても効果はありません。

  • UNPUBLISH 以前は発見可能だったリストが、新しいコンシューマーには発見不可能になります。既存のコンシューマーは、未公開リストに関連するデータに引き続きアクセスすることができます。

    以前に公開されていないリストに UNPUBLISH を指定しても効果はありません。

リストを非公開にする もご参照ください。

SET ...

リストに設定する1つ（または複数）のプロパティを指定します（空白、コンマ、または改行で区切り）。

COMMENT = 'string_literal'

コメントを追加するか、既存のリストの既存のコメントを上書きします。

PUBLISH = { TRUE | FALSE }

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

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

デフォルト: TRUE。

REVIEW =  { TRUE | FALSE }

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

デフォルト: TRUE。

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

PUBLISH

REVIEW

動作

TRUE

TRUE

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

TRUE

FALSE

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

FALSE

TRUE

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

FALSE

FALSE

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

使用上の注意

  • 名前を変更できるのは、ドラフトまたは未公開のリストのみです。

アクセス制御の要件

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

権限

権限

オブジェクト

メモ

OWNERSHIP または MODIFY

変更されたリストに対して。

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

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

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

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

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

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

例

更新されたマニフェストファイルを使用するようにリスト MY_LISTING を変更します。

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

リスト MYLISTING を変更して、リストを公開します。

ALTER LISTING MYLISTING PUBLISH;
Copy

リスト MYLISTING を変更して、リストを非公開にします。

ALTER LISTING MYLISTING UNPUBLISH;
Copy

リスト MYLISTING を変更して、新しいコメントを設定します。

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
Copy
言語: 日本語