次の方法で共有

sp_helpdatatypemap (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server Azure SQL Managed Instance

SQL Server と SQL Server 以外のデータベース管理システム (DBMS) との間の定義済みのデータ型マッピングに関する情報を返します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。

Transact-SQL 構文表記規則

構文

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 ]
[ ; ]

引数

[ @source_dbms = ] N'source_dbms'

データ型のマップ元となる DBMS の名前。 @source_dbms は sysname で、次のいずれかの値を指定できます。

Value 説明
MSSQLSERVER ソースは SQL Server データベースです。
ORACLE マップ元は Oracle データベース。

[ @source_version = ] 'source_version'

ソース DBMS の製品バージョン。 @source_version は varchar(10) で、既定値は % です。 指定しない場合は、ソース DBMS のすべてのバージョンのデータ型マッピングが返されます。 DBMS のソース バージョンによる結果セットのフィルター処理を有効にします。

[ @source_type = ] N'source_type'

ソース DBMS に一覧表示されているデータ型。 @source_type は sysname で、既定値は % です。 指定しない場合は、ソース DBMS 内のすべてのデータ型のマッピングが返されます。 ソース DBMS のデータ型で結果セットをフィルター処理できるようにします。

[ @destination_dbms = ] N'destination_dbms'

宛先 DBMS の名前。 @destination_dbms は sysname で、既定値は % で、次のいずれかの値を指定できます。

Value 説明
MSSQLSERVER 変換先は SQL Server データベースです。
ORACLE 変換先は Oracle データベースです。
DB2 マップ先は IBM DB2 データベース。
SYBASE 変換先は Sybase データベースです。

[ @destination_version = ] 'destination_version'

マップ先 DBMS の製品バージョンです。 @destination_version は varchar(10) で、既定値は % です。 指定しない場合は、すべてのバージョンの宛先 DBMS のマッピングが返されます。 DBMS の宛先バージョンによって結果セットのフィルター処理を有効にします。

[ @destination_type = ] N'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 と宛先 DBMS の指定された組み合わせがサポートされていない場合、 sp_helpdatatypemap は空の結果セットを返します。

アクセス許可

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

関連するコンテンツ