ALTER ORGANIZATION PROFILE

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

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

CREATE ORGANIZATION PROFILEDESCRIBE AVAILABLE ORGANIZATION PROFILEDESCRIBE ORGANIZATION PROFILEDROP ORGANIZATION PROFILESHOW AVAILABLE ORGANIZATION PROFILESSHOW ORGANIZATION PROFILESSHOW VERSIONS IN ORGANIZATION PROFILE

構文

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> AS '<yaml_manifest_string>'

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> PUBLISH

ALTER ORGANIZATION PROFILE <name> ADD VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM @<yaml_manifest_stage_location>

ALTER ORGANIZATION PROFILE <name> ADD LIVE VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM LAST

ALTER ORGANIZATION PROFILE <name> COMMIT

ALTER ORGANIZATION PROFILE <name> ABORT
Copy

パラメーター

name

変更する組織プロファイルの識別子(名前)を指定します。組織プロファイル名には、大文字または数字のみを含めることができ、大文字で始まる必要があります。

RENAME TO new_name

組織プロファイル名を new_name に変更します。新しい識別子は、現在の組織内で一意でなければなりません。識別子は、Snowflakeの識別子要件に準拠する必要があります。識別子の要件 をご参照ください。さらに、組織プロファイル名には、大文字または数字のみを含めることができ、大文字で始まる必要があります。

注釈

同じ名前の組織プロファイルが既に組織に存在することはできません。そうでない場合、ステートメントはエラーを返します。

PUBLISH

これまで発見できなかった組織プロファイルを発見できるようにします。

ADD VERSION [ [ IF NOT EXISTS ] version_alias_name ]

追加するバージョンの一意なバージョン識別子を指定します。version_alias_name が指定されていない場合、エイリアスは作成されません。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、識別子全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。FIRST、 LAST、 DEFAULT、 LIVE のキーワードはバージョンのショートカットとして予約されており、使用できません。一意なバージョン識別子は「version$」で始まることはできず、スラッシュ(/)を含むこともできません。識別子の構文については、 識別子の要件 をご参照ください。

ADD LIVE VERSION [ [ IF NOT EXISTS ] version_alias_name ]

最後にコミットされたバージョンから、指定された名前の新しい編集可能なライブバージョンを追加します。version_alias_name はオプションで、指定されない場合はエイリアスは作成されません。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、識別子全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。FIRST、 LAST、 DEFAULT、 LIVE のキーワードはバージョンのショートカットとして予約されており、使用できません。一意なバージョン識別子は「version$」で始まることはできず、スラッシュ(/)を含むこともできません。識別子の構文については、 識別子の要件 をご参照ください。

ライブバージョンでファイルに加えられた変更は、ライブバージョンがコミットされるまで、組織プロファイルには適用されません。組織プロファイルのプロパティは、ライブバージョンがコミットされるまで変更されません。

AS yaml_manifest_string

組織プロファイルの YAML マニフェスト。組織リストプロファイルのマニフェストフィールドについては、組織プロファイルのマニフェストリファレンス をご参照ください。

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

FROM 'yaml_manifest_stage_location'

外部ステージ、内部ステージ、またはSnowflake Gitリポジトリクローン YAML 形式のマニフェストステージの場所を指定します。

COMMIT

組織プロファイルの変更をコミットします。コミットされるライブバージョンには、有効な組織プロファイルマニフェストファイルが含まれている必要があります。

ABORT

組織プロファイルの変更を破棄します。

アクセス制御の要件

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

権限

オブジェクト

注意

OWNERSHIP または MODIFY

組織プロファイル

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

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

使用上の注意

  • 組織プロファイルの名前を変更できるのは、ドラフト状態のときのみです。

  • YAML 形式マニフェストのライブバージョンを組織プロファイルに設定する場合、 COMMIT を使用して変更を適用するか、 ABORT を使用して変更を破棄する必要があります。同時に存在できる組織プロファイルのライブバージョンは1つだけです。

更新されたマニフェストファイルを使用するように、組織プロファイル MYORGPROFILE を変更します。

ALTER ORGANIZATION PROFILE MYORGPROFILE ADD VERSION V2 FROM @STAGE_PATH_WITH_UPDATED_MANIFEST;
Copy

組織プロファイル MYORGPROFILE を公開:

ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;
Copy