sp_datatype_info (Transact-SQL)

返回有关当前环境所支持的数据类型的信息。

主题链接图标Transact-SQL 语法约定

语法

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