sp_columns (Transact-SQL)sp_columns (Transact-SQL)

• 10/17/2016
• • m
  • o

適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse

現在の環境でクエリを実行できる、指定されたオブジェクトの列情報を返します。Returns column information for the specified objects that can be queried in the current environment.

Transact-SQL 構文表記規則 Transact-SQL Syntax Conventions

構文Syntax

-- Syntax for SQL Server, Azure SQL Database, Azure Synapse Analytics, Parallel Data Warehouse  
  
sp_columns [ @table_name = ] object  
     [ , [ @table_owner = ] owner ]   
     [ , [ @table_qualifier = ] qualifier ]   
     [ , [ @column_name = ] column ]   
     [ , [ @ODBCVer = ] ODBCVer ]  

引数Arguments

[ \@table_name = ] object カタログ情報を返すために使用するオブジェクトの名前を指定します。[ \@table_name = ] object Is the name of the object that is used to return catalog information. オブジェクト には、テーブル、ビュー、またはテーブル値関数などの列を持つその他のオブジェクトを指定できます。object can be a table, view, or other object that has columns such as table-valued functions. オブジェクト は nvarchar (384),、既定値はありません。object is nvarchar(384), with no default. ワイルドカードパターンマッチングがサポートされています。Wildcard pattern matching is supported.

[ \@table_owner = ] owner カタログ情報を返すために使用されるオブジェクトの所有者を示します。[ \@table_owner = ] owner Is the object owner of the object that is used to return catalog information. owner は nvarchar (384),、既定値は NULL です。owner is nvarchar(384), with a default of NULL. ワイルドカードパターンマッチングがサポートされています。Wildcard pattern matching is supported. Owner が指定されていない場合、基になる DBMS の既定のオブジェクト可視性ルールが適用されます。If owner is not specified, the default object visibility rules of the underlying DBMS apply.

指定した名前のオブジェクトを現在のユーザーが所有している場合は、そのオブジェクトの列が返されます。If the current user owns an object with the specified name, the columns of that object are returned. Owner が指定されておらず、現在のユーザーが指定された オブジェクト を持つオブジェクトを所有していない場合、 sp_columns は、データベース所有者が所有する、指定された オブジェクト を持つオブジェクトを検索します。If owner is not specified and the current user does not own an object with the specified object, sp_columns looks for an object with the specified object owned by the database owner. 存在する場合は、そのオブジェクトの列が返されます。If one exists, that object's columns are returned.

[ \@table_qualifier = ] qualifier オブジェクト修飾子の名前を指定します。[ \@table_qualifier = ] qualifier Is the name of the object qualifier. 修飾子 は sysname,、既定値は NULL です。qualifier is sysname, with a default of NULL. さまざまな DBMS 製品では、3つの要素で構成するオブジェクト (修飾子) がサポート しています。所有者。名前)。Various DBMS products support three-part naming for objects (qualifier.owner.name). では SQL ServerSQL Server 、この列はデータベース名を表します。In SQL ServerSQL Server, this column represents the database name. 一部の製品では、オブジェクトのデータベース環境のサーバー名を表します。In some products, it represents the server name of the object's database environment.

[ \@column_name = ] column は1つの列であり、カタログ情報の列が1つだけ必要な場合に使用します。[ \@column_name = ] column Is a single column and is used when only one column of catalog information is wanted. 列 は nvarchar (384),、既定値は NULL です。column is nvarchar(384), with a default of NULL. 列 が指定されていない場合は、すべての列が返されます。If column is not specified, all columns are returned. では SQL ServerSQL Server 、 列 は syscolumns テーブルに示されている列名を表します。In SQL ServerSQL Server, column represents the column name as listed in the syscolumns table. ワイルドカードパターンマッチングがサポートされています。Wildcard pattern matching is supported. 相互運用性を最大にするために、ゲートウェイクライアントでは、SQL-92 標準のパターン照合 (% と _ ワイルドカード文字) のみを想定する必要があります。For maximum interoperability, the gateway client should assume only SQL-92 standard pattern matching (the % and _ wildcard characters).

[ \@ODBCVer = ] ODBCVer 使用されている ODBC のバージョンを示します。[ \@ODBCVer = ] ODBCVer Is the version of ODBC that is being used. Odbcver は int,、既定値は2です。ODBCVer is int, with a default of 2. これは、ODBC バージョン2を示します。This indicates ODBC Version 2. 有効な値は2または3です。Valid values are 2 or 3. バージョン2とバージョン3の動作の違いについては、ODBC Sqlcolumns の仕様を参照してください。For the behavior differences between versions 2 and 3, see the ODBC SQLColumns specification.

リターン コードの値Return Code Values

なしNone

結果セットResult Sets

Sp_columns カタログストアドプロシージャは、ODBC の sqlcolumns に相当します。The sp_columns catalog stored procedure is equivalent to SQLColumns in ODBC. 返される結果は、 TABLE_QUALIFIER、 TABLE_OWNER、および TABLE_NAME 順に並べ替えられます。The results returned are ordered by TABLE_QUALIFIER, TABLE_OWNER, and TABLE_NAME.

¹ 詳細については、Microsoft ODBC のドキュメントを参照してください。¹ For more information, see the Microsoft ODBC documentation.

アクセス許可Permissions

スキーマに対する SELECT および VIEW DEFINITION 権限が必要です。Requires SELECT and VIEW DEFINITION permissions on the schema.

コメントRemarks

sp_columns は、区切られた識別子の要件に従います。sp_columns follows the requirements for delimited identifiers. 詳細については、「データベース識別子」を参照してください。For more information, see Database Identifiers.

例Examples

次の例では、指定されたテーブルの列情報を返します。The following example returns column information for a specified table.

USE AdventureWorks2012;  
GO  
EXEC sp_columns @table_name = N'Department',  
   @table_owner = N'HumanResources';  

例: Azure Synapse AnalyticsAzure Synapse Analytics、Parallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Parallel Data WarehouseParallel Data Warehouse

次の例では、指定されたテーブルの列情報を返します。The following example returns column information for a specified table.

-- Uses AdventureWorks  
  
EXEC sp_columns @table_name = N'DimEmployee',  
   @table_owner = N'dbo';  

参照See Also

sp_tables (Transact-sql) sp_tables (Transact-SQL)
Transact-sql)(のカタログストアドプロシージャ Catalog Stored Procedures (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)