sp_helpdatatypemap (Transact-SQL)

傳回 Microsoft SQL Server 和非 SQL Server 資料庫管理系統 (DBMS) 之間所定義之資料類型對應的相關資訊。 這個預存程序執行於任何資料庫中的散發者端。

Transact-SQL 語法慣例

語法

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

引數

• [ @source_dbms= ] 'source_dbms'
  這是對應資料類型的來源 DBMS 名稱。 source_dbms 是 sysname，它可以是下列其中一個值。

  值	說明
  MSSQLSERVER	來源是一個 SQL Server 資料庫。
  ORACLE	來源是一個 Oracle 資料庫。

• [ @source_version= ] 'source_version'
  這是來源 DBMS 的產品版本。 source_version 是 varchar(10)，如果未指定的話，會傳回來源 DBMS 所有版本的資料類型對應。 啟用 DBMS 來源版本所要篩選的結果集。

• [ @source_type= ] 'source_type'
  這是來源 DBMS 中列出的資料類型。 source_type 是 sysname，如果未指定的話，會傳回來源 DBMS 中之所有資料類型的對應。 啟用來源 DBMS 中的資料類型所要篩選的結果集。

• [ @destination_dbms = ] 'destination_dbms'
  這是目的地 DBMS 的名稱。 destination_dbms 是 sysname，它可以是下列值之一。

  值	說明
  MSSQLSERVER	目的地是一個 SQL Server 資料庫。
  ORACLE	目的地是一個 Oracle 資料庫。
  DB2	目的地是一個 IBM DB2 資料庫。
  SYBASE	目的地是一個 Sybase 資料庫。

• [ @destination_version= ] 'destination_version'
  這是目的地 DBMS 的產品版本。 destination_version 是 varchar(10)，如果未指定的話，會傳回目的地 DBMS 所有版本的對應。 啟用 DBMS 目的地版本所要篩選的結果集。

• [ @destination_type= ] 'destination_type'
  這是目的地 DBMS 中列出的資料類型。 destination_type 是 sysname，如果未指定的話，會傳回目的地 DBMS 中之所有資料類型的對應。 啟用目的地 DBMS 中的資料類型所要篩選的結果集。

• [ @defaults_only= ] defaults_only
  這是指是否只傳回預設資料類型對應。 defaults_only 是 bit，預設值是 0。 1 表示只傳回預設資料類型對應。 0 表示傳回預設資料類型對應及任何使用者自訂資料類型對應。

結果集

資料行名稱	說明
mapping_id	識別資料類型對應。
source_dbms	這是來源 DBMS 的名稱和版本號碼。
source_type	這是來源 DBMS 中的資料類型。
destination_dbms	這是目的地 DBMS 的名稱。
destination_type	這是目的地 DBMS 中的資料類型。
is_default	這是指對應是預設對應或替代對應。 0 值表示這個對應是使用者自訂的對應。

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_helpdatatypemap 定義從非 SQL Server 發行者和 SQL Server 發行者到非 SQL Server 發行者的資料類型對應。

當不支援指定的來源和目的地 DBMS 組合時，sp_helpdatatypemap 會傳回空的結果集。

權限

只有在散發者端的系統管理員 (sysadmin) 固定伺服器角色成員，或散發資料庫的 db_owner 固定資料庫角色成員，才能夠執行 sp_helpdatatypemap。

請參閱

參考

sp_getdefaultdatatypemapping (Transact-SQL)

sp_setdefaultdatatypemapping (Transact-SQL)