次の方法で共有


分散クエリでのデータ型のマッピング

OLE DB プロバイダは、DBTYPE という OLE DB の型識別子によってデータの型を公開します。データ型は、次のデータ マッピングにより OLE DB データ型と SQL Server システム データ型間で変換されます。

  • OLE DB データ型から SQL Server システム データ型へのマッピング。この変換は SQL Server が OLE DB データ ソースからデータを読み取るとき、SELECT ステートメント、または UPDATE、INSERT、DELETE ステートメントの読み取り側のいずれかで行われます。

  • SQL Server システム データ型から OLE DB データ型へのマッピング。この変換は、多くの場合 INSERT ステートメントまたは UPDATE ステートメントの中で、変更されたテーブルがリモート テーブルである OLE DB データ ソースに SQL Server がデータを書き込むときに行われます。

OLE DB プロバイダから SQL Server へのデータ型マッピング

OLE DB プロバイダから SQL Server へのデータ型マッピングは、使用できる比較と式、およびリモート データが関係する明示的で有効な変換を定義します。このマッピングを下記の表に示します。

式の中にあるリモート テーブルの列に関する型の妥当性は、データ型マッピング テーブルでその値に対応している SQL Server データ型が、同じコンテキストの中で有効な場合に、リモート列の値が Transact-SQL 式の中で有効になる、という規則に集約されます。

たとえば、local_column OPERATOR remote_column という式について考えてみましょう。この式では、local_column はローカル テーブルの列を、remote_column はリモート テーブルの列を表します。この式が有効になるのは、OPERATOR がローカル列のデータ型、および remote_column の DBTYPE のマップ先であるデータ型に有効な演算子である場合です。

同様に、CAST(remote_column AS data_type_1) は、remote_column の DBTYPE が SQL Server システム データ型 data_type_2 にマップされていて、data_type_2 から data_type_1 への明示的な変換が許可される場合は、有効です。たとえば、プロバイダ側で DBTYPE_DATE 型の列は、SQL Server では datetime 列に変換できます。しかし、DBTYPE_DATE データを直接 varchar に変換することはできません。

次の表は、データ型マッピング テーブルを示しています。列の DBTYPE インジケータとその DBCOLUMNFLAG 値を使用して、対応する SQL Server データ型を特定できます。

DBTYPE

DBCOLUMNFLAGS

SQL Server データ型

DBTYPE_I1

numeric(3, 0)1

DBTYPE_I2

smallint

DBTYPE_I4

int

DBTYPE_I8

bigint

DBTYPE_UI1

tinyint

DBTYPE_UI1

numeric(5,0)

DBTYPE_UI1

numeric(10,0)

DBTYPE_UI1

numeric(20,0)

DBTYPE_R4

float

DBTYPE_R8

real

DBTYPE_NUMERIC

numeric

DBTYPE_DECIMAL

decimal

DBTYPE_CY

money

DBTYPE_BSTR

DBCOLUMNFLAGS_ISLONG = true

ntext

DBTYPE_BSTR

DBCOLUMNFLAGS_ISFIXEDLENGTH = true

nchar

DBTYPE_BSTR

DBCOLUMNFLAGS_ISFIXEDLENGTH = false

nvarchar

DBTYPE_IDISPATCH

エラー

DBTYPE_ERROR

エラー

DBTYPE_BOOL

bit

DBTYPE_VARIANT

nvarchar(4000)

DBTYPE_IUNKNOWN

エラー

DBTYPE_GUID

uniqueidentifier

DBTYPE_BYTES

DBCOLUMNFLAGS_ISLONG = true または最大列サイズ > 8,000 バイト

image

DBTYPE_BYTES

DBCOLUMNFLAGS_ISLONG = true かつ列サイズの制限なし

varbinary(max)

DBTYPE_BYTES

DBCOLUMNFLAGS_ISROWVER = true、DBCOLUMNFLAGS_ISFIXEDLENGTH = true、かつ列サイズ = 8

timestamp

DBTYPE_BYTES

DBCOLUMNFLAGS_ISFIXEDLENGTH = true

binary

DBTYPE_BYTES

DBCOLUMNFLAGS_ISFIXEDLENGTH = false

varbinary

DBTYPE_STR

DBCOLUMNFLAGS_ISFIXEDLENGTH = true

char

DBTYPE_ STR

DBCOLUMNFLAGS_ISFIXEDLENGTH = false

varchar

DBTYPE_STR

DBCOLUMNFLAGS_ISLONG = true または最大列サイズ > 8,000 文字

text

DBTYPE_STR

DBCOLUMNFLAGS_ISLONG = true かつ列サイズの制限なし

varchar(max)

DBTYPE_WSTR

DBCOLUMNFLAGS_ISFIXED

nchar

DBTYPE_WSTR

DBCOLUMNFLAGS_ISFIXEDLENGTH = false

nvarchar

DBTYPE_WSTR

DBCOLUMNFLAGS_ISLONG = true または最大列サイズ > 4,000 文字

ntext

DBTYPE_WSTR

DBCOLUMNFLAGS_ISLONG = true かつ列サイズの制限なし

nvarchar(max)

DBTYPE_UDT

同等の SQL Server ユーザー定義型 (登録されている場合)

DBTYPE_DATE

date, datetime, datetime2, datetimeoffset

DBTYPE_DBDATE

date, datetime, datetime2, datetimeoffset (互換性レベルは 9.0 未満)

DBTYPE_DBTIME

time, datetime, datetime2, datetimeoffset

DBTYPE_DBTIME_EX

time, datetime2, datetimeoffset

DBTYPE_DBTIMESTAMP

time, date, datetime2, datetimeoffset, datetime

DBTYPE_DBTIMESTAMP

time, date, datetime2, datetimeoffset

DBTYPE_DBTIMESTAMP

time, date, datetime2, datetimeoffset

DBTYPE_ARRAY

エラー

DBTYPE_BYREF

無視

DBTYPE_VECTOR

エラー

DBTYPE_RESERVED

エラー

DBTYPE_XML

xml (パススルー クエリでのみ可)

1numeric(p,s) は、精度が p で小数点以下桁数が s の SQL Server データ型 numeric を示しています。

注意注意

ここに示した既定値と異なる SQL Server データ型にデータを変換する必要がある場合は、CAST 関数や CONVERT 関数を使用した明示的な変換が必要です。詳細については、「CAST および CONVERT (Transact-SQL)」を参照してください。

DBTYPE インジケータと DBCOLUMNFLAGS 値の情報は、COLUMNS スキーマ行セットまたは IColumnsInfo インターフェイスを通じてプロバイダから提供されます。COLUMNS スキーマ行セットの場合は、DATA_TYPE 列と COLUMN_FLAGS 列が DBTYPE および DBCOLUMNFLAGS の値を表しています。IColumnsInfo::GetColumnInfo インターフェイスの場合は、DBCOLUMNINFO 構造体の wType メンバと dwFlags メンバがこの値を表しています。

SQL Server から OLE DB プロバイダへのデータ型マッピング

SQL Server システム データ型は、上記のテーブルのマッピングを使用して OLE DB 型にマップされます。次のいずれかの条件に該当する場合には、SQL Server 型の S1 から特定の OLE DB 型の T へのマッピングが可能です。

  • 対応するマッピングがデータ型マッピング テーブルに存在する。

  • データ型 S1 から別の SQL Server データ型 S2 への有効な暗黙的な変換が存在し、S2 から T へのマッピングがデータ型マッピング テーブルに定義されている。

リモート サーバーから受信する日付データと時刻データの SQL Server 2008 のマッピング

次の表は、OLE DB データ ソースから SQL Server 2008 のインスタンスに送信されるデータの date データ型と time データ型のマッピングを示しています。この変換は SQL Server 2008 が OLE DB データ ソースからデータを読み取るとき、SELECT ステートメント、または UPDATE、INSERT、DELETE ステートメントの読み取り側のいずれかで行われます。リモート列のデータ型が、date、time、dateime2、または datetimeoffset の場合は、データベース互換性レベルが 100 以上であればその型が返されます。互換性レベルが 100 未満の場合は、SQL Server 2008 で datetime への暗黙の変換が行われます。

OLE DB 型

リモート サーバーが SQL Server 2008 の場合に

返されるデータ型

リモート サーバーが SQL Server 2005 または SQL Server 2000 の場合に返されるデータ型

リモート サーバーが SQL Server ではなく、ローカル SQL Server 2008 データベースの互換性レベルが 90 の場合に返されるデータ型

リモート サーバーが SQL Server ではなく、ローカル SQL Server 2008 データベースの互換性レベルが 100 の場合に返されるデータ型

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

datetime (リモート列は datetime か smalldatetime)

datetime (リモート列は datetime か smalldatetime)

datetime

datetime2(7)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されている)

datetime2

N/A

N/A

N/A

DBTYPE_DBDATE

date

N/A

datetime

date

DBTYPE_DBTIME

time(0)

N/A

datetime

time(0)

DBTYPE_DBTIME2

time(n)

N/A

N/A

N/A

DBTYPE_DBTIMESTAMPOFFSET

datetimeoffset

N/A

N/A

N/A

リモート サーバーに送信する日付データと時刻データの SQL Server 2008 のマッピング

次の表は、SQL Server 2008 のインスタンスから OLE DB データの送信先に送信されるデータの date データ型と time データ型のマッピングを示しています。この変換は、多くの場合 INSERT ステートメントまたは UPDATE ステートメントの中で、変更されたテーブルがリモート テーブルである OLE DB データ ソースに SQL Server 2008 がデータを書き込むときに行われます。

SQL Server 2008 のデータ型

リモート サーバーが SQL Server 2008 の場合に

バインドされるデータ型

リモート サーバーが SQL Server 2005 または SQL Server 2000 の場合にバインドされるデータ型

リモート サーバーが SQL Server ではない場合にバインドされるデータ型

datetime, smalldatetime

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

datetime2(n)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されている)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

date

DBTYPE_DBDATE

DBTYPE_DBDATE

DBTYPE_DBDATE

time(0)

DBTYPE_DBTIME

DBTYPE_DBTIME

DBTYPE_DBTIME

time(n) (0 < n <= 7)

DBTYPE_DBTIMESTAMP (日付部分は保留)

(dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されている)

DBTYPE_DBTIMESTAMP (dwFlags が DBPARAMFLAGS_SS_ISVARIABLESCALE に設定されていない)

DBTYPE_DBTIMESTAMP (日付部分は保留)

datetimeoffset

DBTYPE_DBTIMESTAMPOFFSET

N/A

N/A

SQL Server 2008 の date データ型と time データ型のリモート クエリの実行

SQL Server 2008 では、クエリが time、date、datetime2、または datetimoffset のいずれかのデータ型のリモート オブジェクトを参照している場合、そのクエリはローカルまたはリモート サーバーのいずれかで実行されます。どちらで実行されるかは、リモート サーバーのバージョンまたはプロバイダと、参照の型によって決まります。考慮される参照の型は、リモート列または定数、変数、またはローカルの列です。

SQL Server 以外のプロバイダ

time、date、および datetime2 の各データ型は、SQL Server 以外のプロバイダのリモート サーバーに同様の型が存在する場合、完全にはサポートされません。これらのプロバイダで、それらの型のサポートを宣言する方法はありません。

次の表は、リモート サーバーとローカル サーバーのどちらでクエリが実行されるかを示しています。最初の列は、ローカル サーバー上のデータ型を示しています。2 番目の列は、SQL Server 2008 のローカル インスタンスがリモート サーバーに対して使用する、対応する OLE DB データ型を示しています。最後の 3 つの列は、クエリがリモート サーバーとローカル サーバーのどちらで実行されるかを示しています。クエリが実行される場所は、リモート サーバーのバージョンや種類によって決まります。

ローカル サーバーのデータ型

ローカル SQL Server 2008 によって使用されるリモート サーバーの OLE DB データ型

SQL Server 2008 以降のバージョンのリモート サーバー

SQL Server 2005 のリモート サーバー

MSSQL 以外のリモート サーバー

datetime

DBTYPE_DBTIMESTAMP

リモート

リモート

リモート

smalldatetime

DBTYPE_DBTIMESTAMP

リモート

リモート

リモート

datetime2

DBTYPE_DBTIMESTAMP

リモート

ローカル

リモート

datetimeoffset

DBTYPE_DBTIMESTAMPOFFSET

リモート

ローカル

ローカル

date

DBTYPE_DBDATE

リモート

ローカル

リモート

time(>0)

DBTYPE_DBTIME2

リモート

ローカル

ローカル

time(0)

DBTYPE_DBTIME2

リモート

ローカル

リモート