ALTER LISTING

インライン YAML マニフェスト、またはステージの場所にあるファイルからの リスト のプロパティを変更します。

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

CREATE LISTINGDESCRIBE LISTINGSHOW LISTINGSSHOW VERSIONS IN LISTINGDROP LISTING

構文

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH | REVIEW } ]

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

ALTER LISTING <name> ADD VERSION [ [ IF NOT EXISTS ] <version_name> ]
  FROM <yaml_manifest_stage_location>
  [ COMMENT = '<string>' ]

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

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

パラメーター

name

変更されるリストの識別子(名前)を指定します。

{ PUBLISH | UNPUBLISH | REVIEW }

リストに対して実行するアクション:

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

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

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

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

リストの公開解除 もご参照ください。

  • REVIEW はレビューのためにリストを提出します。

yaml_manifest_string

リストの YAML マニフェスト。マニフェストのパラメーターについては、 リストマニフェスト参照 をご参照ください。

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

ADD VERSION version_name

追加するバージョンの一意なバージョン識別子を指定します。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、識別子全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。識別子の構文については、 識別子の要件 をご参照ください。

FROM 'yaml_manifest_stage_location'

内部またはSnowflake Gitリポジトリクローン manifest.ymlファイルのパスを指定します。変更にMarketplace Opsのレビューが必要な場合は、 REVIEW と PUBLISH の操作を使用してください。

RENAME TO new_name

リスト名を new_name に変更します。リスト名は一意でなければなりません。新しい識別子が既に別のリストで使用されている場合は、その識別子を使用することはできません。

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 を使用して変更を破棄する必要があります。

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

注意

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 REVIEW;
Copy

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

ALTER LISTING MYLISTING PUBLISH;
Copy

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

ALTER LISTING MYLISTING UNPUBLISH;
Copy

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

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

指定された YAML マニフェストファイルのステージの場所から新しいバージョンを追加します。

ALTER LISTING MYLISTING ADD VERSION V3 FROM @dbforstage.public.listingstage/listingmanifests;
Copy