sp_getdefaultdatatypemapping (Transact-SQL)
適用対象: SQL Server
SQL Server と SQL Server 以外のデータベース管理システム (DBMS) との間の、指定されたデータ型の既定のマッピングに関する情報を返します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。
構文
sp_getdefaultdatatypemapping [ @source_dbms = ] 'source_dbms'
[ , [ @source_version = ] 'source_version' ]
, [ @source_type = ] 'source_type'
[ , [ @source_length = ] source_length ]
[ , [ @source_precision = ] source_precision ]
[ , [ @source_scale = ] source_scale ]
[ , [ @source_nullable = ] source_nullable ]
, [ @destination_dbms = ] 'destination_dbms'
[ , [ @destination_version = ] 'destination_version' ]
[ , [ @destination_type = ] 'destination_type' OUTPUT ]
[ , [ @destination_length = ] destination_length OUTPUT ]
[ , [ @destination_precision = ] destination_precision OUTPUT ]
[ , [ @destination_scale = ] destination_scale OUTPUT ]
[ , [ @destination_nullable = ] source_nullable OUTPUT ]
[ , [ @dataloss = ] dataloss OUTPUT ]
[ ; ]
引数
[ @source_dbms = ] 'source_dbms'
データ型のマップ元となる DBMS の名前。 @source_dbms は sysname で、次のいずれかの値を指定できます。
Value | 説明 |
---|---|
MSSQLSERVER |
ソースは SQL Server データベースです。 |
ORACLE |
マップ元は Oracle データベース。 |
このパラメーターを指定する必要があります。
[ @source_version = ] 'source_version'
ソース DBMS のバージョン番号。 @source_version は varchar(10) で、既定値は NULL
です。
[ @source_type = ] 'source_type'
ソース DBMS のデータ型。 @source_type は sysname で、既定値はありません。
[ @source_length = ] source_length
ソース DBMS のデータ型の長さ。 @source_length は bigint で、既定値は NULL
です。
[ @source_precision = ] source_precision
ソース DBMS のデータ型の有効桁数。 @source_precision は bigint で、既定値は NULL
です。
[ @source_scale = ] source_scale
ソース DBMS のデータ型のスケール。 @source_scale は int で、既定値は NULL
です。
[ @source_nullable = ] source_nullable
ソース DBMS のデータ型が NULL
の値をサポートするかどうかを指定します。 @source_nullable は ビットで、既定値は 1
であり、 NULL
値がサポートされていることを意味します。
[ @destination_dbms = ] '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) で、既定値は NULL
です。
[ @destination_type = ] 'destination_type' OUTPUT
宛先 DBMS に一覧表示されているデータ型。 @destination_type は sysname で、既定値は NULL
です。
[ @destination_length = ] destination_length OUTPUT
マップ先 DBMS のデータ型の長さです。 @destination_length は bigint で、既定値は NULL
です。
[ @destination_precision = ] destination_precision OUTPUT
宛先 DBMS のデータ型の有効桁数。 @destination_precision は bigint で、既定値は NULL
です。
[ @destination_scale = ] destination_scale OUTPUT
マップ先 DBMS のデータ型の小数点以下桁数です。 @destination_scale は int で、既定値は NULL
です。
[ @destination_nullable = ] destination_nullable OUTPUT
変換先 DBMS のデータ型が NULL
の値をサポートするかどうかを指定します。 @destination_nullable は bit で、既定値は NULL
です。 1
は、 NULL
値がサポートされていることを意味します。
[ @dataloss = ] dataloss OUTPUT
マッピングにデータ損失の可能性があるかどうかを指定します。 @dataloss は ビットで、既定値は NULL
です。 1
は、データ損失の可能性があることを意味します。
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_getdefaultdatatypemapping
は、SQL Server と SQL Server 以外の DBMS 間のすべての種類のレプリケーションで使用されます。
sp_getdefaultdatatypemapping
は、指定したソース データ型に最も近い既定の変換先データ型を返します。
アクセス許可
sysadmin固定サーバー ロールのメンバーのみがsp_getdefaultdatatypemapping
を実行できます。