ALTER ORGANIZATION PROFILE¶
組織プロファイルのプロパティを変更します。
- こちらもご参照ください。
CREATE ORGANIZATION PROFILE、 DESCRIBE AVAILABLE ORGANIZATION PROFILE、 DESCRIBE ORGANIZATION PROFILE、 DROP ORGANIZATION PROFILE、 SHOW AVAILABLE ORGANIZATION PROFILES、 SHOW ORGANIZATION PROFILES、 SHOW VERSIONS IN ORGANIZATION PROFILE
構文¶
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
パラメーター¶
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$」で始まることはできず、スラッシュ(/)を含むこともできません。識別子の構文については、 識別子の要件 をご参照ください。ライブバージョンでファイルに加えられた変更は、ライブバージョンがコミットされるまで、組織プロファイルには適用されません。組織プロファイルのプロパティは、ライブバージョンがコミットされるまで変更されません。
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;
組織プロファイル MYORGPROFILE を公開:
ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;