列サイズ

数値データ型の列 (またはパラメーター) サイズは、列またはパラメーターのデータ型で使用される最大桁数、またはデータの有効桁数として定義されます。 文字型の場合、これはデータの文字数です。バイナリ データ型の場合、列サイズはデータの長さ (バイト単位) として定義されます。 時刻、タイムスタンプ、およびすべての間隔データ型の場合、これは、このデータの文字表現の文字数です。 各簡潔な SQL データ型に定義されている列サイズを次の表に示します。

SQL 型識別子	列のサイズ
すべての文字型 [a],[b]	列またはパラメーターの定義済みまたは最大列サイズ (SQL_DESC_LENGTH記述子フィールドに含まれる)。 たとえば、CHAR(10) として定義されている 1 バイト文字列の列サイズは 10 です。
SQL_DECIMAL SQL_NUMERIC	定義された桁数。 たとえば、NUMERIC(10,3) として定義された列の有効桁数は 10 です。
SQL_BIT[c]	1
SQL_TINYINT[c]	3
SQL_SMALLINT[c]	5
SQL_INTEGER[c]	10
SQL_BIGINT[c]	19 (署名されている場合) または 20 (符号なしの場合)
SQL_REAL[c]	7
SQL_FLOAT[c]	15
SQL_DOUBLE[c]	15
すべてのバイナリ型[a],[b]	列またはパラメーターの定義済みまたは最大長 (バイト単位)。 たとえば、BINARY(10) として定義されている列の長さは 10 です。
SQL_TYPE_DATE[c]	10 ( yyyy-mm-dd 形式の文字数)。
SQL_TYPE_TIME[c]	8 (h-mm-ss 形式の文字数)、または 9 + (h:mm:ss[.fff...] 形式の文字数。ここで、は秒の有効桁数です)。
SQL_TYPE_TIMESTAMP	16 ( yyyy-mm-dd hh:mm 形式の文字数) 19 ( yyyy-mm-dd hh:mm:ss 形式の文字数) または 20 + (yyyy-mm-dd hh:mm:ss[.fff...] 形式の文字数。ここで、s は秒の有効桁数です)。
SQL_INTERVAL_SECOND	ここで p は、有効桁数と の間隔です 秒の有効桁数、 p ( s=0 の場合) または p+s+1 ( s>0)。d]
SQL_INTERVAL_DAY_TO_SECOND	ここでpは、有効桁数との間隔です秒の有効桁数、9 +p (s=0 の場合) または 10 +p+s (>0)。d]
SQL_INTERVAL_HOUR_TO_SECOND	ここでpは、有効桁数との間隔です秒の有効桁数、6 +p (s=0 の場合) または 7 +p+s (>0)。d]
SQL_INTERVAL_MINUTE_TO_SECOND	ここで p は、有効桁数と の間隔です 秒の有効桁数、3 +p ( s=0 の場合) または 4 +p+s ( s>0)。d]
SQL_INTERVAL_YEAR SQL_INTERVAL_MONTH SQL_INTERVAL_DAY SQL_INTERVAL_HOUR SQL_INTERVAL_MINUTE	p。ここで、 p は間隔の先頭の有効桁数です。[d]
SQL_INTERVAL_YEAR_TO_MONTH SQL_INTERVAL_DAY_TO_HOUR	3 + p。ここで、 p は間隔の先頭の有効桁数です。[d]
SQL_INTERVAL_DAY_TO_MINUTE	6 + p。ここで、 p は間隔の先頭の有効桁数です。[d]
SQL_INTERVAL_HOUR_TO_MINUTE	3 + p。ここで、 p は間隔の先頭の有効桁数です。[d]
SQL_GUID	36 ( aaaaaa-bbbb-cccc-dddd-eeeeeeeee 形式の文字数)

[a] ODBC 2.0 ドライバーで SQLSetParam を呼び出す ODBC 1.0 アプリケーションの場合、 ODBC 1.0 ドライバーで SQLBindParameter を呼び出す ODBC 2.0 アプリケーションの場合、*StrLen_or_IndPtr がSQL_LONGVARCHARまたはSQL_LONGVARBINARY型にSQL_DATA_AT_EXECされている場合は、 ColumnSize 送信するデータの合計長に設定する必要があります。 は、この表で定義されている有効桁数ではありません。

[b] ドライバーが変数型の列またはパラメーターの長さを判断できない場合は、SQL_NO_TOTALを返します。

[c] このデータ型では、SQLBindParameter の ColumnSize 引数は無視されます。

[d] 間隔データ型の列長に関する一般的な規則については、この付録の「 Interval データ型の長さ」を参照してください。

列 (またはパラメーター) のサイズに対して返される値は、1 つの記述子フィールドの値に対応していません。 値は、次の表に示すように、データの種類に応じて、SQL_DESC_PRECISIONまたはSQL_DESC_LENGTHフィールドから取得できます。

SQL 型	に対応する記述子フィールド 列またはパラメーターのサイズ
すべての文字型とバイナリ型	LENGTH
すべての数値型	PRECISION
すべての datetime 型と interval 型	LENGTH
SQL_BIT	LENGTH