sp_table_privileges (Transact-SQL)
指定した 1 つ以上のテーブルに対するテーブル権限 (INSERT、DELETE、UPDATE、SELECT、REFERENCES など) の一覧を返します。
構文
sp_table_privileges [ @table_name = ] 'table_name'
[ , [ @table_owner = ] 'table_owner' ]
[ , [ @table_qualifier = ] 'table_qualifier' ]
[ , [ @fUsePattern = ] 'fUsePattern' ]
引数
[ @table\_name= ] 'table_name'
カタログ情報を返すために使用するテーブルを指定します。 table_name のデータ型は nvarchar(384) で、既定値はありません。 ワイルドカードによるパターン照合がサポートされています。[ @table\_owner= ] 'table_owner'
カタログ情報を返すために使用するテーブルのテーブル所有者です。 table_ownerのデータ型は nvarchar(384) で、既定値は NULL です。 ワイルドカードによるパターン照合がサポートされています。 所有者を指定しない場合は、基になる DBMS の既定のテーブル可視性ルールが適用されます。指定した名前のテーブルを現在のユーザーが所有している場合は、そのテーブルの列が返されます。 owner を指定せず、また指定した name のテーブルを現在のユーザーが所有していない場合は、データベース所有者が所有する、指定した table_name のテーブルが検索されます。 そのテーブルが存在する場合、そのテーブルの列が返されます。
[ @table\_qualifier= ] 'table_qualifier'
テーブル識別子の名前です。 table_qualifier のデータ型は sysname で、既定値は NULL です。 さまざまな DBMS 製品において、テーブル名には 3 つの要素から成る名前 (qualifier.owner.name) がサポートされています。 SQL Server では、この列はデータベース名を表します。 製品によっては、テーブルのデータベース環境のサーバー名を表す場合があります。[ @fUsePattern= ] 'fUsePattern'
アンダースコア (_)、パーセント (%)、および角かっこ ([ または ]) の各文字がワイルドカードとして解釈されるかどうかを指定します。 有効な値は 0 (パターン一致がオフ) および 1 (パターン一致がオン) です。 fUsePattern のデータ型は bit で、既定値は 1 です。
リターン コードの値
なし
結果セット
列名 |
データ型 |
説明 |
---|---|---|
TABLE_QUALIFIER |
sysname |
テーブル修飾子の名前。 SQL Server では、この列はデータベース名を表します。 このフィールドには NULL を指定できます。 |
TABLE_OWNER |
sysname |
テーブル所有者の名前。 このフィールドは常に値を返します。 |
TABLE_NAME |
sysname |
テーブル名。 このフィールドは常に値を返します。 |
GRANTOR |
sysname |
この TABLE_NAME の権限を、表示される GRANTEE に与えたデータベース ユーザーの名前。 SQL Server では、この列は常に TABLE_OWNER と同じです。 このフィールドは常に値を返します。 GRANTOR 列には、データベース所有者 (TABLE_OWNER) が返されます。また、データベース所有者が GRANT ステートメントで WITH GRANT OPTION 句を使用して権限を与えたユーザーが返される場合もあります。 |
GRANTEE |
sysname |
この TABLE_NAME の権限を、表示される GRANTOR によって与えられたデータベース ユーザーの名前。 SQL Server では、この列には常に sys.database_principals システム ビューからのデータベース ユーザーが格納されます。 このフィールドは常に値を返します。 |
PRIVILEGE |
sysname |
使用可能なテーブル権限の 1 つ。 テーブル権限は、次に挙げる値 (または実装が定義されるときにデータ ソースによってサポートされるその他の値) のいずれかになります。 SELECT。GRANTEE は、1 列以上のデータを取得できます。 INSERT。GRANTEE は、新しい行の 1 列以上にデータを提供できます。 UPDATE。GRANTEE は、1 列以上の既存のデータを修正できます。 DELETE。GRANTEE は、テーブルから行を削除できます。 REFERENCES。GRANTEE は、主キー/外部キーのリレーションシップで外部テーブル内の列を参照できます。 SQL Server では、主キー/外部キーのリレーションシップはテーブル制約で定義されます。 特定のテーブル特権によって GRANTEE に与えられる操作の範囲は、データ ソースに依存します。 たとえば、UPDATE 特権の場合、GRANTEE は、あるデータ ソース上ではテーブルのすべての列を更新することが許可されても、別のデータ ソース上では、GRANTOR が UPDATE 特権を持っている列しか更新できないことがあります。 |
IS_GRANTABLE |
sysname |
GRANTEE が他のユーザーに権限を与えることが許可されているかどうかを示します。これは "許可の許可" 権限とも呼ばれます。 YES、NO、NULL のいずれかになります。 不明 (つまり NULL) の値は、"許可の許可" が適用されないデータ ソースを示します。 |
説明
sp_table_privileges ストアド プロシージャは、ODBC の SQLTablePrivileges に相当します。 返される結果は、TABLE_QUALIFIER、TABLE_OWNER、TABLE_NAME、PRIVILEGE の順に従って並べ替えられます。
権限
スキーマに対する SELECT 権限が必要です。
使用例
次の例では、単語 Contact で始まる名前が付いているすべてのテーブルに関する権限情報が返されます。
USE AdventureWorks2012;
GO
EXEC sp_table_privileges
@table_name = 'Contact%';