sp_columns_ex (Transact-SQL)
适用范围：
SQL Server
返回指定链接服务器表的列信息，每列一行。 sp_columns_ex 如果 指定了@column_name ，则仅返回特定列的列信息。
语法
sp_columns_ex
[ @table_server = ] N'table_server'
[ , [ @table_name = ] N'table_name' ]
[ , [ @table_schema = ] N'table_schema' ]
[ , [ @table_catalog = ] N'table_catalog' ]
[ , [ @column_name = ] N'column_name' ]
[ , [ @ODBCVer = ] ODBCVer ]
[ ; ]
参数
[ @table_server = ] N'table_server'
要为其返回列信息的链接服务器的名称。 @table_server为 sysname，没有默认值。
[ @table_name = ] N'table_name'
要为其返回列信息的表的名称。 @table_name为 sysname，默认值为 NULL.
[ @table_schema = ] N'table_schema'
要为其返回列信息的表的架构名称。 @table_schema为 sysname，默认值为 NULL.
[ @table_catalog = ] N'table_catalog'
要为其返回列信息的表的目录名称。 @table_catalog为 sysname，默认值为 NULL.
[ @column_name = ] N'column_name'
要为其提供信息的数据库列的名称。 @column_name为 sysname，默认值为 NULL.
[ @ODBCVer = ] ODBCVer
正在使用的 ODBC 版本。 @ODBCVer为 int，默认值为 2. 这指示 ODBC 版本 2。 有效值为 2 or 3进行求值的基于 SQL 语言的筛选器表达式。 有关版本 2 和 3 之间的行为差异的信息，请参阅 ODBC SQLColumns 规范。
返回代码值
无。
结果集
| 列名称 | 数据类型 | 描述 |
|---|---|---|
TABLE_CAT |
sysname | 表或视图限定符的名称。 各种 DBMS 产品支持表的三部分命名（<qualifier>.<owner>.<name>）。 在 SQL Server 中，此列表示数据库名称。 在某些产品中，该列表示表所在的数据库环境的服务器名。 此字段可以是 NULL. |
TABLE_SCHEM |
sysname | 表或视图所有者的名称。 在 SQL Server 中，此列表示创建表的数据库用户的名称。 此字段始终返回值。 |
TABLE_NAME |
sysname | 表或视图名称。 此字段始终返回值。 |
COLUMN_NAME |
sysname | 列名称，针对返回的每个 TABLE_NAME 列。 此字段始终返回值。 |
DATA_TYPE |
smallint | 对应于 ODBC 类型指示器的 int 值。 如果这是无法映射到 ODBC 类型的数据类型，则此值为 NULL。 本机数据类型名称在 TYPE_NAME 列中返回。 |
TYPE_NAME |
varchar（13） | 表示数据类型的字符串。 基础 DBMS 提供此数据类型的名称。 |
COLUMN_SIZE |
int | 有效数字位数。 该列的 PRECISION 返回值在 base 10 中。 |
BUFFER_LENGTH |
int | 数据的传输大小。1 |
DECIMAL_DIGITS |
smallint | 小数点右边的数字位数。 |
NUM_PREC_RADIX |
smallint | 数值数据类型的基数。 |
NULLABLE |
smallint | 指定为 Null 性。1 = NULL 是可能的。0 = NOT NULL。 |
REMARKS |
varchar(254) | 此字段始终返回 NULL。 |
COLUMN_DEF |
varchar(254) | 列的默认值。 |
SQL_DATA_TYPE |
smallint | 在描述符的字段中显示 TYPE SQL 数据类型的值。 此列与 DATA_TYPE 列相同，但 日期/时间 和 SQL-92 间隔 数据类型除外。 该列始终返回值。 |
SQL_DATETIME_SUB |
smallint | datetime 及 SQL-92 interval 数据类型的子类型代码。 对于其他数据类型，此列返回 NULL。 |
CHAR_OCTET_LENGTH |
int | 字符或整数数据类型的列的最大长度（字节）。 对于所有其他数据类型，此列返回 NULL。 |
ORDINAL_POSITION |
int | 列在表中的序号位置。 表中的第一列为 1。 该列始终返回值。 |
IS_NULLABLE |
varchar(254) | 表中的列的为 Null 性。 根据 ISO 规则确定为 Null 性。 符合 ISO SQL 的 DBMS 无法返回空字符串。YES = 列可以包含 NULL。NO = 列不能包含 NULL。如果为 Null 性为未知，该列将返回零长度字符串。 为此列返回的值不同于为 NULLABLE 该列返回的值。 |
SS_DATA_TYPE |
tinyint | SQL Server 数据类型，由扩展存储过程使用。 |
有关详细信息，请参阅 ODBC 概述。
注解
sp_columns_ex通过查询COLUMNS对应于@table_server的 OLE DB 访问接口的IDBSchemaRowset接口的行集来执行。 @table_name、@table_schema、@table_catalog 和@column_name参数将传递给此接口以限制返回的行。sp_columns_ex如果指定的链接服务器的 OLE DB 提供程序不支持COLUMNS接口的行集，则返回空结果集IDBSchemaRowset。sp_columns_ex遵循分隔标识符的要求。 有关详细信息，请参阅 数据库标识符。
权限
需要对架构的 SELECT 权限。
示例
以下示例返回链接服务器 JobTitle 上的 AdventureWorks2022 数据库中的 HumanResources.Employee 表的 Seattle1 列的数据类型。
EXEC sp_columns_ex 'Seattle1',
'Employee',
'HumanResources',
'AdventureWorks2022',
'JobTitle';