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>'
パラメーター¶
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 |
レビューや公開をリクエストせずに、リストをドラフトとして保存します。 |
使用上の注意¶
リスト名の変更は DRAFT の状態でのみ可能です。
YAML 形式マニフェストのライブバージョンをリストにセットする場合、
COMMIT
を使用して変更を適用するか、ABORT
を使用して変更を破棄する必要があります。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 のいずれかが必要です。
権限 |
オブジェクト |
メモ |
---|---|---|
OWNERSHIP または MODIFY |
変更されたリストに対して。 |
ALTER コマンドを使用して自動履行のマニフェスト内容を変更する場合は、クロス クラウド自動履行の構成に必要な権限委譲を受けたロールを使用する必要があります。 アカウントがクロスクラウドの自動複製を設定できるようにする をご参照ください。
スキーマ内のオブジェクトを操作するには、親データベースとスキーマの USAGE 権限も必要です。
指定された権限セットを持つカスタムロールの作成手順については、 カスタムロールの作成 を参照してください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
例¶
更新されたマニフェスト・ファイルを使用するようにリスト MYLISTING を変更します。
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 *" $$
リストを公開することで MYLISTING を変更します。
ALTER LISTING MYLISTING PUBLISH;
リストの公開を解除することで、リスト MYLISTING を変更します。
ALTER LISTING MYLISTING UNPUBLISH;
新しいコメントをセットすることで、リスト MYLISTING を変更します。
ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';