具体化されたビュー ロールを管理する
プリンシパルには、ロールベースのアクセス制御モデルを使用してリソースへのアクセス権が付与されます。ここで、割り当てられたセキュリティ ロールによってリソース アクセスが決定されます。
具体化されたビューでは、セキュリティ ロールは adminsのみです。 具体化されたビュー admins には、具体化されたビューを表示、変更、および削除する機能があります。
この記事では、管理コマンドを使用して既存の管理者を表示する方法と具体化されたビューに対する管理者の追加と削除する方法について説明します。
Note
具体化されたビュー管理者になるには、プリンシパルがデータベースまたはテーブル レベルに対するアクセス権を持っている必要があります。
アクセス許可
これらのコマンドを実行するには、データベース管理者のアクセス許可を持っているか、特定の具体化されたビューの具体化されたビュー管理者である必要があります。 詳細については、ロールベースのアクセス制御に関するページを参照してください。
既存の管理者を表示する
プリンシパルを追加または削除する前に、 .show コマンドを使用して、具体化されたビューで既に管理者アクセス権を持っているすべてのプリンシパルを含むテーブルを表示できます。
構文
すべてのロールを表示するには:
.showmaterialized-view MaterializedViewName principals
ロールを表示するには:
.showmaterialized-view MaterializedViewName principal roles
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| MaterializedViewName | string |
✔️ | プリンシパルを一覧表示する具体化されたビューの名前。 |
例
次のコマンドは、 SampleView 具体化されたビューにアクセスできるすべてのセキュリティ プリンシパルを一覧表示します。
.show materialized view SampleView principals
出力例
| ロール | PrincipalType | PrincipalDisplayName | PrincipalObjectId | PrincipalFQN |
|---|---|---|---|---|
| 具体化されたビュー SampleView 管理者 | Microsoft Entra ユーザー | Abbi Atkins | cd709aed-a26c-e3953dec735e | aaduser=abbiatkins@fabrikam.com |
管理者の追加と削除
このセクションでは、プリンシパルを追加および削除するための構文、パラメーター、および例を示します。
構文
Action materialized-view MaterializedViewName admins ( Principal [, Principal...] ) [skip-results] [ Description ]
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| 操作 | string |
✔️ | コマンド .add、 .drop、または .set。.add は指定したプリンシパルを追加し、 .drop は指定したプリンシパルを削除し、 .set は指定したプリンシパルを追加し、前のすべてのプリンシパルを削除します。 |
| MaterializedViewName | string |
✔️ | プリンシパルを追加する具体化されたビューの名前。 |
| プリンシパル | string |
✔️ | 1 つ以上のプリンシパル。 これらのプリンシパルを指定する方法のガイダンスについては、「 セキュリティ プリンシパルの参照を参照してください。 |
skip-results |
string |
指定した場合、このコマンドはマテリアライズド ビュー プリンシパルの更新された一覧を返しません。 | |
| 説明 | string |
.show コマンドの使用時に表示される変更を説明するテキスト。 |
Note
プリンシパルの一覧ではなく、noneを含む .set コマンドでは、すべてのプリンシパルが削除されます。
例
次の例では、同じコマンドで 管理者の追加、 管理者の削除、管理者の追加と削除を する方法について説明します。
.add を使用して管理者を追加する
次の例では、SampleViewマテリアライズド ビューのadmins ロールにプリンシパルを追加します。
.add materialized-view SampleView admins ('aaduser=imikeoein@fabrikam.com')
.drop を使用して管理者を削除する
次の例では、グループ内のすべてのプリンシパルを、SampleView具体化されたビューのadminsロールから削除します。
.drop materialized-view SampleView admins ('aadGroup=SomeGroupEmail@fabrikam.com')
新しい管理者を追加し、.set を使用して古い管理者を削除する
次の例では、既存のadminsを削除し、指定されたプリンシパルをSampleViewマテリアライズド ビューにadminsとして追加します。
.set materialized-view SampleView admins ('aaduser=imikeoein@fabrikam.com', 'aaduser=abbiatkins@fabrikam.com')
.set を使用してすべての管理者を削除する
次のコマンドは、SampleViewマテリアライズド ビューの既存のadminsをすべて削除します。
.set materialized-view SampleView admins none