ALTER CONTACT¶
既存の 連絡先 のプロパティを変更します。
- こちらもご参照ください。
構文¶
ALTER CONTACT [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER CONTACT [ IF EXISTS ] <name> SET
[ {
USERS = ( <user_name> [ , <user_name> ... ] )
| EMAIL_DISTRIBUTION_LIST = '<email>'
| URL = '<url>'
} ]
[ COMMENT = '<string_literal>' ]
パラメーター¶
name
変更する連絡先の識別子を指定します。
識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
RENAME TO new_name
連絡先の名前を
new_name
に変更します。新しい識別子は、スキーマに対して一意にする必要があります。識別子についての詳しい情報は、 識別子の要件 をご参照ください。
オプションでオブジェクトの名前を変更して、オブジェクトを別のデータベースやスキーマに移動できます。これを実行するには、新しいデータベース名やスキーマ名をそれぞれ
db_name.schema_name.object_name
またはschema_name.object_name
の形式で含む、修飾されたnew_name
値を指定します。注釈
宛先データベースやスキーマはすでに存在している必要があります。また、同じ名前のオブジェクトが宛先データベースにすでに存在することはできません。存在する場合、ステートメントはエラーを返します。
オブジェクトを管理アクセススキーマに移動することは、オブジェクトの所有者(つまり、オブジェクトに対して OWNERSHIP 権限を持つロール)がターゲットスキーマも所有している場合を 除き 禁止されています。
連絡先の名前が変更されると、その連絡先を参照する他のオブジェクトも新しい名前に更新する必要があります。
SET ...
連絡先に以下のパラメーターを設定します。
USERS = ( user_name [ , user_name ... ] )
連絡先となるSnowflakeユーザーのコンマ区切りリスト(ユーザーオブジェクト名で指定)。
EMAIL_DISTRIBUTION_LIST = 'email'
有効なメールアドレス。ユーザーが複数の個人に連絡できるようにしたい場合は、配布リストにすることができます。
URL = 'url'
オブジェクトに関する連絡先として使用できる URL。
COMMENT = '<string_literal>'
ユーザー定義の文字列。連絡先のコメントを指定します。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、 最低 1 つ の次の 権限 が必要です。
権限 |
オブジェクト |
注意 |
---|---|---|
MODIFY |
お問い合わせ |
|
OWNERSHIP |
お問い合わせ |
OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege). |
スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
メタデータについて:
注意
Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。
例¶
ALTER CONTACT my_contact SET EMAIL_DISTRIBUTION_LIST = 'support@example.com';