ALTER LISTING

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

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

CREATE LISTINGDESCRIBE LISTINGSHOW LISTINGSDROP 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

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

使用上の注意

  • リスト名の変更は 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 *"
  $$
Copy

リストを公開することで MYLISTING を変更します。

ALTER LISTING MYLISTING PUBLISH;
Copy

リストの公開を解除することで、リスト MYLISTING を変更します。

ALTER LISTING MYLISTING UNPUBLISH;
Copy

新しいコメントをセットすることで、リスト MYLISTING を変更します。

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
Copy