sp_datatype_info (Transact-SQL)

適用対象: SQL Server Azure Synapse Analytics

現在の環境でサポートされているデータ型に関する情報を返します。

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 = この属性は適用できません。 アプリケーションは、この属性を持つ列に値を挿入することはできますが、その列の値を更新することはできません。 ビット データ型を除き、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	記述子の TYPE フィールドでの SQL データ型の値です。 この列は、 datetime データ型と ANSI 間隔 データ型を除き、DATA_TYPE列と同じです。 このフィールドは常に値を返します。
SQL_DATETIME_SUB	smallint	datetime または ANSI interval サブコード (SQL_DATA_TYPEの値がSQL_DATETIMEまたはSQL_INTERVALの場合)。 datetime および ANSI 間隔以外のデータ型の場合、このフィールドは NULL です。
NUM_PREC_RADIX	int	列が保持できる最大数を計算するためのビット数または桁数。 データ型が概数型である場合、この列に含まれる値は 2 で、複数のビットを示します。 正確な数値型の場合、この列には数桁の 10 進数を示す値 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値を指定して、sysname データ型と nvarchar データ型の-9情報を取得します。

USE master;  
GO  
EXEC sp_datatype_info -9;  
GO  

参照

データベース エンジン ストアド プロシージャ (Transact-SQL)
データ型 (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)