sp_getdefaultdatatypemapping (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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 であり、次のいずれかの値を指定できます。

値 説明
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 であり、次のいずれかの値を指定できます。

値 説明
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 は ビットであり、既定値は NULL です。 1 は、NULL 値がサポートされていることを意味します。

[ @dataloss = ] dataloss OUTPUT

マッピングにデータ損失の可能性があるかどうかを指定します。 @dataloss は ビットであり、既定値は NULL です。 1 は、データ損失の可能性があることを意味します。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

sp_getdefaultdatatypemappingは、SQL Server と非SQL Server DBMS の間のすべての種類のレプリケーションで使用されます。

sp_getdefaultdatatypemapping は、指定したソース データ型に最も近い既定の変換先データ型を返します。

アクセス許可

sysadmin 固定サーバー ロールのメンバーのみが を実行sp_getdefaultdatatypemappingできます。

関連項目