sp_special_columns (Transact-SQL)

構文

sp_special_columns [@table_name =] 'table_name'   
     [,[@table_owner =] 'table_owner'] 
     [,[@qualifier =] 'qualifier'] 
     [,[@col_type =] 'col_type'] 
     [,[@scope =] 'scope']
     [,[@nullable =] 'nullable'] 
     [,[@ODBCVer =] 'ODBCVer'] ;

引数

• [ @table_name =] 'table_name'
  カタログ情報を返すために使用するテーブル名を指定します。name のデータ型は sysname で、既定値はありません。ワイルドカードによるパターン照合はサポートされていません。

• [ @table_owner =] 'table_owner'
  カタログ情報を返すために使用するテーブルのテーブル所有者です。owner は sysname であり、既定値は NULL です。ワイルドカードによるパターン照合はサポートされていません。owner を指定しない場合は、基になる DBMS の既定のテーブル可視性規則が適用されます。

  SQL Server では、指定した名前のテーブルを現在のユーザーが所有している場合、そのテーブルの列が返されます。owner を指定せず、また指定した name のテーブルを現在のユーザーが所有していない場合、このプロシージャでは、データベース所有者が所有する name のテーブルが検索されます。テーブルが存在する場合は、その列が返されます。

• [ @qualifier =] 'qualifier'
  テーブル修飾子の名前です。qualifier は sysname であり、既定値は NULL です。さまざまな DBMS 製品において、テーブル名には 3 つの要素から成る名前 (qualifier.owner.name) がサポートされています。SQL Server では、この列はデータベース名を表します。製品によっては、テーブルのデータベース環境のサーバー名を表す場合があります。

• [ @col_type =] 'col_type'
  列の種類を指定します。col_type のデータ型は char(1) で、既定値は R です。種類 R は、列から値を取得することによって、指定したテーブル内にある任意の行を一意に識別できる、最適な列または列のセットを返します。列は、この目的のために特別に設計された疑似列、または、テーブルでインデックスが一意な 1 つ以上の列になります。種類 V は、指定したテーブルに自動更新される列が 1 つ以上存在する場合、該当する列または列のセットを返します。この列は、トランザクションによって行の値が更新されると、データ ソースによって自動的に更新される列です。

• [ @scope =] 'scope'
  ROWID の最低限必要な範囲です。scope のデータ型は char(1) で、既定値は T です。範囲 C は、ROWID がその行に位置している場合にのみ有効であることを指定します。範囲 T は、ROWID がトランザクションに対して有効であることを指定します。

• [ @nullable =] 'nullable'
  特別列に NULL 値を認めるかどうかを示します。nullable のデータ型はchar(1) で、既定値は U です。O は、NULL を許容しない特別列を指定します。U は部分的に NULL を許容する列を指定します。

• [ @ODBCVer =] 'ODBCVer'
  使用する ODBC のバージョンです。ODBCVer のデータ型は int(4) で、既定値は 2 です。既定値は ODBC Version 2.0 を示します。ODBC Version 2.0 と ODBC Version 3.0 の違いについては、ODBC Version 3.0 の ODBC SQLSpecialColumns の仕様を参照してください。

リターン コードの値

なし

結果セット

説明

sp_special_columns は ODBC の SQLSpecialColumns に相当します。返される結果は、SCOPE の順序に従って並べ替えられます。

権限

スキーマに対する SELECT 権限が必要です。

例

次の例では、HumanResources.Department テーブルの行を一意に識別する列に関する情報が返されます。

USE AdventureWorks;
GO
EXEC sp_special_columns @table_name = 'Department' 
    ,@table_owner = 'HumanResources';

関連項目

参照