Pemetaan Tipe Data Klien Asli SQL Server di ITableDefinition

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Saat membuat tabel dengan menggunakan fungsi ITableDefinition::CreateTable , konsumen penyedia SQL Server Native Client OLE DB dapat menentukan jenis data SQL Server di anggota pwszTypeName dari array DBCOLUMNDESC yang diteruskan. Jika konsumen menentukan jenis data kolom berdasarkan nama, pemetaan jenis data OLE DB, yang diwakili oleh anggota wType dari struktur DBCOLUMNDESC, diabaikan.

Saat menentukan jenis data kolom baru dengan jenis data OLE DB menggunakan anggota wType struktur DBCOLUMNDESC, penyedia SQL Server Native Client OLE DB memetakan jenis data OLE DB sebagai berikut.

Jenis data OLE DB SQL Server

jenis data
Informasi Tambahan
DBTYPE_BOOL bit
DBTYPE_BYTES biner, varbinary, image, atau varbinary(max) Penyedia SQL Server Native Client OLE DB memeriksa anggota ulColumnSize dari struktur DBCOLUMNDESC. Berdasarkan nilai, dan versi instans SQL Server, penyedia SQL Server Native Client OLE DB memetakan jenis ke gambar.

Jika nilai ulColumnSize lebih kecil dari panjang maksimum kolom jenis data biner , penyedia SQL Server Native Client OLE DB memeriksa anggota DBCOLUMNDESC rgPropertySets . Jika DBPROP_COL_FIXEDLENGTH VARIANT_TRUE, penyedia SQL Server Native Client OLE DB memetakan jenis ke biner. Jika nilai properti VARIANT_FALSE, penyedia SQL Server Native Client OLE DB memetakan jenis ke varbinary. Dalam kedua kasus, anggota DBCOLUMNDESC ulColumnSize menentukan lebar kolom SQL Server yang dibuat.
DBTYPE_CY Uang
DBTYPE_DBTIMESTAMP datetime
DBTYPE_GUID pengidentifikasi unik
DBTYPE_I2 smallint
DBTYPE_I4 int
DBTYPE_NUMERIC numerik Penyedia SQL Server Native Client OLE DB memeriksa bPresisi DBCOLUMDESC dan anggota bScale untuk menentukan presisi dan skala untuk kolom numerik.
DBTYPE_R4 real
DBTYPE_R8 float
DBTYPE_STR karakter, varchar, teks, atau varchar(maks) Penyedia SQL Server Native Client OLE DB memeriksa anggota ulColumnSize dari struktur DBCOLUMNDESC. Berdasarkan nilai dan versi instans SQL Server, penyedia SQL Server Native Client OLE DB memetakan jenis ke teks.

Jika nilai ulColumnSize lebih kecil dari panjang maksimum kolom jenis data karakter multibyte, penyedia SQL Server Native Client OLE DB memeriksa anggota DBCOLUMNDESC rgPropertySets . Jika DBPROP_COL_FIXEDLENGTH VARIANT_TRUE, penyedia SQL Server Native Client OLE DB memetakan jenis ke karakter. Jika nilai properti VARIANT_FALSE, penyedia SQL Server Native Client OLE DB memetakan jenis ke varchar. Dalam kedua kasus, anggota DBCOLUMNDESC ulColumnSize menentukan lebar kolom SQL Server yang dibuat.
DBTYPE_UDT UDT Informasi berikut digunakan dalam struktur DBCOLUMNDESC oleh ITableDefinition::CreateTable saat kolom UDT diperlukan:

pwSzTypeName diabaikan.

rgPropertySets harus menyertakan properti DBPROPSET_SQLSERVERCOLUMN yang ditetapkan seperti yang dijelaskan di bagian pada DBPROPSET_SQLSERVERCOLUMN, dalam Menggunakan Jenis yang Ditentukan Pengguna.
DBTYPE_UI1 kecil
DBTYPE_WSTR nchar, nvarchar, ntext, atau nvarchar(max) Penyedia SQL Server Native Client OLE DB memeriksa anggota ulColumnSize dari struktur DBCOLUMNDESC. Berdasarkan nilainya, penyedia SQL Server Native Client OLE DB memetakan jenis ke ntext.

Jika nilai ulColumnSize lebih kecil dari panjang maksimum kolom jenis data karakter Unicode, penyedia SQL Server Native Client OLE DB memeriksa anggota DBCOLUMNDESC rgPropertySets . Jika DBPROP_COL_FIXEDLENGTH VARIANT_TRUE, penyedia SQL Server Native Client OLE DB memetakan jenis ke nchar. Jika nilai properti VARIANT_FALSE, penyedia SQL Server Native Client OLE DB memetakan jenis ke nvarchar. Dalam kedua kasus, anggota DBCOLUMNDESC ulColumnSize menentukan lebar kolom SQL Server yang dibuat.
DBTYPE_XML XML

Catatan

Saat membuat tabel baru, penyedia SQL Server Native Client OLE DB hanya memetakan nilai enumerasi jenis data OLE DB yang ditentukan dalam tabel sebelumnya. Mencoba membuat tabel dengan kolom jenis data OLE DB lainnya menghasilkan kesalahan.

Lihat Juga

Tipe Data (OLE DB)