sp_helpdatatypemap (Transact-SQL)
適用対象: SQL Server Azure SQL Managed Instance
SQL Server と SQL Server 以外のデータベース管理システム (DBMS) との間の定義済みのデータ型マッピングに関する情報を返します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。
構文
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
を実行できます。
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示