ALTER DATABASE ROLE

既存のデータベースロールのプロパティを変更します。

現在、サポートされている操作は、データベースロールの名前変更またはデータベースロールのコメントの追加/上書き/削除のみです。

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

CREATE DATABASE ROLEDROP DATABASE ROLESHOW DATABASE ROLES

構文

ALTER DATABASE ROLE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER DATABASE ROLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER DATABASE ROLE [ IF EXISTS ] <name> UNSET COMMENT

ALTER DATABASE ROLE [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER DATABASE ROLE [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

パラメーター

name

データベースロールの識別子(つまり、名前)を指定します。ロールが作成されるデータベース内で一意にする必要があります。

識別子はアルファベットで始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません(例: "My object")。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

識別子が db_name.database_role_name の形式で完全修飾されていない場合、コマンドはセッションの現在のデータベースでデータベースロールを検索します。

RENAME TO new_name

データベースロールの新しい識別子を指定します。アカウントに対して一意にする必要があります。

詳細については、 識別子の要件 をご参照ください。

データベースロールの完全修飾名を指定する場合は、別のデータベースを指定することが できない ことに注意してください。データベースの名前 db_name は変更しないでください。名前の変更操作中に変更できるのは database_role_name のみです。

SET ...

データベースロールに設定するプロパティを指定します。

COMMENT = 'string_literal'

データベースロールのコメントを追加するか、既存のコメントを上書きします。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。

UNSET ...

データベースロールの設定を解除するプロパティを指定します。これにより、デフォルトにリセットされます。

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

アクセス制御権限

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

権限

オブジェクト

メモ

OWNERSHIP

データベースロール

このコマンドを実行できるのは、データベースロールの所有者(つまり、データベースロールに対する OWNERSHIP 権限を持つデータベースロール)またはそれ以上のロールのみです。

所有者ロールは、所有済みのデータベースロールに付与された権限を継承しません。データベースロールから権限を継承するには、そのデータベースロールを別のロールに付与して、ロール階層に親子関係を作成する必要があります。

APPLY

タグ

データベースロールにタグを設定できるようにします。

使用上の注意

メタデータについて、

注意

Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

データベース d1 でデータベースロール dr1dbr2 に名前変更します。

ALTER DATABASE ROLE d1.dr1 RENAME TO d1.dbr2;
Copy

データベースロール d1.dbr2 のコメントを追加します。

ALTER DATABASE ROLE d1.dbr2 SET COMMENT = 'New comment for database role';
Copy