sp_helpdatatypemap (T-SQL)

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Mengembalikan informasi tentang pemetaan jenis data yang ditentukan antara SQL Server dan sistem manajemen database (DBMS) non-SQL Server. Prosedur tersimpan ini dijalankan di Distributor pada database apa pun.

Konvensi sintaks transact-SQL

Sintaks

sp_helpdatatypemap
    [ @source_dbms = ] N'source_dbms'
    [ , [ @source_version = ] 'source_version' ]
    [ , [ @source_type = ] N'source_type' ]
    [ , [ @destination_dbms = ] N'destination_dbms' ]
    [ , [ @destination_version = ] 'destination_version' ]
    [ , [ @destination_type = ] N'destination_type' ]
    [ , [ @defaults_only = ] defaults_only ]
[ ; ]

Argumen

[ @source_dbms = ] N'source_dbms'

Nama DBMS tempat tipe data dipetakan. @source_dbms adalah sysname, dan bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
MSSQLSERVER Sumbernya adalah database SQL Server.
ORACLE Sumbernya adalah database Oracle.

[ @source_version = ] 'source_version'

Versi produk dari DBMS sumber. @source_version adalah varchar(10), dengan default %. Jika tidak ditentukan, pemetaan jenis data untuk semua versi DBMS sumber dikembalikan. Memungkinkan pemfilteran hasil yang ditetapkan oleh versi sumber DBMS.

[ @source_type = ] N'source_type'

Jenis data yang tercantum dalam DBMS sumber. @source_type adalah sysname, dengan default %. Jika tidak ditentukan, pemetaan untuk semua jenis data di DBMS sumber dikembalikan. Memungkinkan pemfilteran hasil yang ditetapkan berdasarkan jenis data di DBMS sumber.

[ @destination_dbms = ] N'destination_dbms'

Nama DBMS tujuan. @destination_dbms adalah sysname, dengan default %, dan bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
MSSQLSERVER Tujuannya adalah database SQL Server.
ORACLE Tujuannya adalah database Oracle.
DB2 Tujuannya adalah database IBM DB2.
SYBASE Tujuannya adalah database Sybase.

[ @destination_version = ] 'destination_version'

Versi produk dari DBMS tujuan. @destination_version adalah varchar(10), dengan default %. Jika tidak ditentukan, pemetaan untuk semua versi DBMS tujuan dikembalikan. Memungkinkan pemfilteran hasil yang ditetapkan oleh versi tujuan DBMS.

[ @destination_type = ] N'destination_type'

Jenis data yang tercantum dalam DBMS tujuan. @destination_type adalah sysname, dengan default %. Jika tidak ditentukan, pemetaan untuk semua jenis data di DBMS tujuan dikembalikan. Memungkinkan pemfilteran hasil yang ditetapkan berdasarkan jenis data di DBMS tujuan.

[ @defaults_only = ] defaults_only

Jika hanya pemetaan jenis data default yang dikembalikan. @defaults_only adalah bit, dengan default 0.

  • 1 berarti bahwa hanya pemetaan jenis data default yang dikembalikan.
  • 0 berarti bahwa pemetaan jenis data default dan yang ditentukan pengguna dikembalikan.

Tataan hasil

Nama kolom Deskripsi
mapping_id Mengidentifikasi pemetaan jenis data.
source_dbms Nama dan nomor versi DBMS sumber.
source_type Jenis data di DBMS sumber.
destination_dbms Nama DBMS tujuan.
destination_type Jenis data di DBMS tujuan.
is_default Menentukan apakah pemetaan adalah pemetaan default atau alternatif. Nilai 0 menunjukkan bahwa pemetaan ini ditentukan pengguna.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_helpdatatypemap menentukan pemetaan jenis data baik dari Penerbit non-SQL Server maupun dari Penerbit SQL Server ke Pelanggan non-SQL Server.

Ketika kombinasi DBMS sumber dan tujuan yang ditentukan tidak didukung, sp_helpdatatypemap mengembalikan tataan hasil kosong.

Izin

Hanya anggota peran server tetap sysadmin di Distributor atau anggota peran database tetap db_owner pada database distribusi yang dapat menjalankan sp_helpdatatypemap.