sp_helpdatatypemap (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

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 は ビットであり、既定値は 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 とターゲット DBMS の指定された組み合わせがサポートされていない場合、 sp_helpdatatypemap は空の結果セットを返します。

アクセス許可

ディストリビューターの sysadmin 固定サーバー ロールのメンバー、またはディストリビューション データベースの固定データベース ロール db_owner メンバーのみが sp_helpdatatypemap実行できます。

参照

sp_getdefaultdatatypemapping (Transact-SQL)
sp_setdefaultdatatypemapping (Transact-SQL)