sp_datatype_info (Transact-SQL)
返回有关当前环境所支持的数据类型的信息。
适用范围：SQL Server（SQL Server 2008 至当前版本），Windows Azure SQL Database（初始版本至当前版本）。 |
.gif "主题链接图标")
语法
sp_datatype_info [ [ @data_type = ] data_type ]
[ , [ @ODBCVer = ] odbc_version ]
参数
[ @data_type= ] data_type
所指定的数据类型的代码号。 若要获得所有数据类型的列表，请省略此参数。 data_type 的数据类型为 int，默认值为 0。[ @ODBCVer= ] odbc_version
所使用的 ODBC 的版本。 odbc_version 的数据类型为 tinyint，默认值为 2。
返回代码值
无
结果集
列名 |
数据类型 |
说明 |
|---|---|---|
TYPE_NAME |
sysname |
与 DBMS 相关的数据类型。 |
DATA_TYPE |
smallint |
此类型的所有列所映射到的 ODBC 类型代码。 |
PRECISION |
int |
数据源中数据类型的最大精度。 数据类型的精度不适用时返回 NULL。 PRECISION 列的返回值以 10 为基数。 |
LITERAL_PREFIX |
varchar(32) |
常量前使用的一个或多个字符。 例如，字符类型使用单引号 (')，二进制类型使用 0x。 |
LITERAL_SUFFIX |
varchar(32) |
用于终止常量的一个或多个字符。 例如，字符类型使用单引号 (')，二进制类型不使用任何引号。 |
CREATE_PARAMS |
varchar(32) |
此数据类型的创建参数的说明。 例如，decimal 为 "precision, scale"，float 为 NULL，varchar 为 "max_length"。 |
NULLABLE |
smallint |
指定为 Null 性。 1 = 允许 Null 值。 0 = 不允许 Null 值。 |
CASE_SENSITIVE |
smallint |
指定是否区分大小写。 1 = 此类型的所有列都区分大小写（用于排序规则）。 0 = 此类型的所有列都不区分大小写。 |
SEARCHABLE |
smallint |
指定列类型的搜索能力： 1 = 不能搜索。 2 = 可以使用 LIKE 进行搜索。 3 = 可以使用 WHERE 进行搜索。 4 = 可以使用 WHERE 或 LIKE 进行搜索。 |
UNSIGNED_ATTRIBUTE |
smallint |
指定数据类型的符号。 1 = 数据类型没有符号。 0 = 数据类型有符号。 |
MONEY |
smallint |
指定 money 数据类型。 1 = money 数据类型。 0 = 非 money 数据类型。 |
AUTO_INCREMENT |
smallint |
指定自动递增。 1 = 自动递增。 0 = 不自动递增。 NULL = 属性不适用。 应用程序可以将值插入具有此属性的列中，但应用程序不能更新列中的值。 除了 bit 数据类型之外，AUTO_INCREMENT 仅对属于精确数字和近似数字数据类型类别的数据类型有效。 |
LOCAL_TYPE_NAME |
sysname |
与数据源相关的数据类型名称的本地化版本。 例如，DECIMAL 的法语版本是 DECIMALE。 如果是数据源不支持的本地化名称，则返回 NULL。 |
MINIMUM_SCALE |
smallint |
数据源中数据类型的最小小数位数。 如果数据类型的小数位数是固定的，则 MINIMUM_SCALE 和 MAXIMUM_SCALE 列将同时包含此值。 当小数位数不适用时，将返回 NULL。 |
MAXIMUM_SCALE |
smallint |
数据源中数据类型的最大小数位数。 如果在数据源中没有单独定义最大小数位数，而是将其定义为与最大精度相同，则此列的值与 PRECISION 列的值相同。 |
SQL_DATA_TYPE |
smallint |
SQL 数据类型在描述符的 TYPE 字段中显示的值。 此列与 DATA_TYPE 列相同，但 datetime 和 ANSI interval 数据类型除外。 此字段始终返回值。 |
SQL_DATETIME_SUB |
smallint |
如果 SQL_DATA_TYPE 的值为 SQL_DATETIME 或 SQL_INTERVAL，则为 datetime 或 ANSI interval 子代码。 对于 datetime 和 ANSI interval 以外的数据类型，此字段为 NULL。 |
NUM_PREC_RADIX |
int |
计算某列最大容纳数时所采用的位数或数字个数。 如果数据类型是近似数字数据类型，则此列包含的值为 2，以指示几个位。 对于精确数字类型，此列包含的值为 10，以指示几个十进制数字。 否则，此列为 NULL。 通过将精度和基数相结合，应用程序可以计算出列所能容纳的最大数。 |
INTERVAL_PRECISION |
smallint |
如果 data_type 为 interval，则为间隔起始精度的值；否则为 NULL。 |
USERTYPE |
smallint |
来自 systypes 表的 usertype 值。 |
注释
sp_datatype_info 等效于 ODBC 中的 SQLGetTypeInfo。 返回的结果按 DATA_TYPE 排序，再按数据类型映射到相应 ODBC SQL 数据类型的紧密程度进行排序。
权限
要求具有 public 角色的成员身份。
示例
下面的示例通过将 data_type 的值指定为 -9 来检索 sysname 和 nvarchar 数据类型的信息。
USE master;
GO
EXEC sp_datatype_info -9;
GO