sp_special_columns (Transact-SQL)

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance

テーブル内の行を一意に識別する最適な列セットを返します。 また、行の値がトランザクションによって更新されると、自動的に更新される列も返されます。

Transact-SQL 構文表記規則

構文

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

引数

[ @table_name = ] N'table_name'

カタログ情報を返すために使用するテーブルの名前。 @table_name は sysname で、既定値はありません。 ワイルドカード パターン マッチングはサポートされていません。

[ @table_owner = ] N'table_owner'

カタログ情報を返すために使用されるテーブルのテーブル所有者。 @table_owner は sysname で、既定値は NULL です。 ワイルドカード パターン マッチングはサポートされていません。 @table_ownerが指定されていない場合は、基になるデータベース管理システム (DBMS) の既定のテーブル可視性ルールが適用されます。

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

[ @table_qualifier = ] N'table_qualifier'

テーブル修飾子の名前。 @table_qualifier は sysname で、既定値は NULL です。 さまざまな DBMS 製品では、テーブルの 3 部構成の名前付け (<qualifier>.<owner>.<name>) がサポートされています。 SQL Server では、この列はデータベース名を表します。 一部の製品では、テーブルのデータベース環境のサーバー名を表します。

[ @col_type = ] 'col_type'

列の種類。 @col_type は char(1) で、既定値は R です。

• 型 R は、列または列から値を取得することで、指定したテーブル内の任意の行を一意に識別できる最適な列または列のセットを返します。 列には、この目的のために設計された疑似列、またはテーブルの一意のインデックスの列または列を指定できます。

• type V は、指定したテーブルの列 (存在する場合) を返します。この列は、行の値がトランザクションによって更新されたときにデータ ソースによって自動的に更新されます。

[ @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 で、既定値は 2 です。 この値は、ODBC バージョン 2.0 を示します。 ODBC バージョン 2.0 と ODBC バージョン 3.0 の違いの詳細については、ODBC バージョン 3.0 の ODBC SQLSpecialColumns 仕様を参照してください。

リターン コードの値

なし。

結果セット

解説

sp_special_columns は ODBC の SQLSpecialColumns と同じです。 返される結果は、 SCOPE順に並べ替えます。

アクセス許可

スキーマに対する SELECT アクセス許可が必要です。

例

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

USE AdventureWorks2022;
GO

EXEC sp_special_columns @table_name = 'Department',
    @table_owner = 'HumanResources';

関連するコンテンツ

• カタログ ストアド プロシージャ (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)