ALTER MODEL¶
名前、タグ、デフォルトバージョン、コメントなど、既存のモデルのプロパティを変更します。
このコマンドには他に2つのバリエーションがあります。
ALTER MODEL ...ADD VERSION は、モデルの新しいバージョンを追加します。
ALTER MODEL ... MODIFY VERSION は、モデルバージョンのコメントまたはメタデータを設定します。
構文¶
ALTER MODEL [ IF EXISTS ] <name> SET
[ COMMENT = '<string_literal>' ]
[ DEFAULT_VERSION = '<version>']
ALTER MODEL [ TAG <tag_name> = '<tag_value>' ]
ALTER MODEL [IF EXISTS] <model_name> UNSET TAG <tag_name> [ , <tag_name> ... ]
パラメーター¶
name
モデルの識別子(つまり名前)を指定します。
識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
RENAME TO 'new_model_name'
指定されたモデルの名前を、スキーマ内の他のモデルで現在使用されていない新しい識別子に変更します。
モデル識別子の詳細については、 識別子の要件 をご参照ください。
SET ...
設定する1つ以上のモデルプロパティを指定します。
COMMENT = 'string_literal'
モデルのコメントを設定します。これは、 COMMENT コマンドを使用しても実行できます。
DEFAULT_VERSION = 'version'
モデルのデフォルトバージョン(モデル上でメソッドを呼び出す際に呼び出されるメソッドのバージョン)を設定します。
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
タグ の名前とタグ文字列の値を指定します。
タグ値は常に文字列であり、タグ値の最大文字数は256です。
ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。
UNSET TAG tag_name [ , tag_name ... ]
モデルで設定解除するタグを1つ以上指定します。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
---|---|---|
OWNERSHIP |
モデル |
スキーマに既存のオブジェクトと同じ名前の仮オブジェクトを作成するには、ロールにオブジェクトの権限(OWNERSHIP)を付与するか継承する必要があります。 |
スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。