OLE DB 変換先

適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime

OLE DB 変換先は、データベースのテーブルやビュー、または SQL コマンドを使用して、OLE DB に準拠するさまざまなデータベースにデータを読み込みます。 たとえば、OLE DB ソースにより、Microsoft Office Access および SQL Server のデータベースのテーブルにデータを読み込むことができます。

OLE DB 変換先には、データを読み込むために、次の 5 つの異なるデータ アクセス モードが用意されています。

• テーブルまたはビュー。 既存のテーブルまたはビューを指定できます。または、新しいテーブルを作成できます。

• テーブルまたはビュー (高速読み込みオプションを使用)。 既存のテーブルを指定できます。または新しいテーブルを作成できます。

• 変数で指定されたテーブルまたはビュー。

• 変数で指定されたテーブルまたはビュー (高速読み込みオプションを使用)。

• SQL ステートメントの結果。

OLE DB 変換先で 2 バイト文字セット (DBCS) を使用するデータを読み込む際に、データ アクセス モードで高速読み込みオプションを使用せず、OLE DB 接続マネージャーが Microsoft OLE DB Provider for SQL Server (SQLOLEDB) を使用している場合、そのデータは破損する可能性があります。 DBCS データの整合性を保持するには、OLE DB 接続マネージャーで SQL Server Native Client を使用するように構成するか、[テーブルまたはビュー - 高速読み込み] または [テーブル名またはビュー名の変数 - 高速読み込み]のうちいずれかの高速読み込みモードを使用する必要があります。 どちらのオプションも、 [OLE DB 変換先エディター] ダイアログ ボックスから使用できます。 SSIS オブジェクト モデルをプログラミングするときは、AccessMode プロパティを [OpenRowset での FastLoad の使用] または [Variable から FastLoad を使用して OpenRowset] に設定する必要があります。

OLE DB 変換先は、OLE DB 接続マネージャーを使用してデータ ソースに接続します。OLE DB 接続マネージャーでは、使用する OLE DB プロバイダーを指定します。 詳細については、「 OLE DB 接続マネージャー」を参照してください。

Integration Services プロジェクトでは、OLE DB 接続マネージャーを作成できるデータ ソース オブジェクトも用意されています。このオブジェクトは、データ ソースとデータ ソース ビューを OLE DB 変換先で使用できるようにします。

OLE DB 変換先には、入力列と変換先データ ソースの列との間のマッピングが含まれています。 入力列をすべての変換先列にマップする必要はありませんが、変換先列のプロパティによっては、変換先列にマップされる入力列がない場合、エラーが発生することがあります。 たとえば、入力先列で NULL 値が許容されていない場合は、入力列をその列にマップする必要があります。 また、マップされる列のデータ型には互換性がある必要があります。 たとえば、文字列データ型の入力列を数値データ型の変換先列にマップすることはできません。

OLE DB 変換先は、1 つの標準入力と 1 つのエラー出力をとります。

データ型について詳しくは、「 Integration Services のデータ型」をご覧ください。

高速読み込みオプション

OLE DB 変換先で高速読み込みデータ アクセス モードが使用される場合、 [OLE DB 変換先エディター] のユーザー インターフェイスで、変換先に対して次の高速読み込みオプションを指定できます。

• インポートしたデータ ファイルの ID 値を保持します。または、 SQL Serverによって割り当てられた一意の値を使用します。

• 一括読み込み操作中に、NULL 値を保持します。

• 一括インポート操作中に、インポート先のテーブルまたはビューに対して CHECK 制約を実行します。

• 一括読み込み操作中に、テーブルレベルのロックを取得します。

• バッチの行数およびコミット サイズを指定します。

一部の高速読み込みオプションは、OLE DB 変換先の特定のプロパティに格納されています。 たとえば、ID 値を保持するかどうかを指定する FastLoadKeepIdentity、NULL 値を保持するかどうかを指定する FastLoadKeepNulls、バッチとしてコミットする行数を指定する FastLoadMaxInsertCommitSize などがあります。 その他の高速読み込みオプションは、FastLoadOptions プロパティのコンマ区切りリストで格納されます。 OLE DB 変換先で、FastLoadOptions に格納されている高速読み込みオプションと [OLE DB 変換先エディター] ダイアログ ボックスに一覧表示されている高速読み込みオプションをすべて使用する場合は、このプロパティの値を TABLOCK, CHECK_CONSTRAINTS, ROWS_PER_BATCH=1000に設定します。 値 1000 を設定すると、1,000 行のバッチを使用するように変換先が構成されます。

[OLE DB 変換先エディター] ダイアログ ボックスで公開される高速読み込みオプションに加えて、 [詳細エディター] ダイアログ ボックスで、FastLoadOptions プロパティに次の一括読み込みオプションを入力することにより、それらのオプションを使用するように OLE DB 変換先を構成できます。

高速読み込みオプション	説明
KILOBYTES_PER_BATCH	挿入するサイズを KB 単位で指定します。 このオプションの形式は、KILOBYTES_PER_BATCH = <正の整数> です。
FIRE_TRIGGERS	挿入テーブルでトリガーを起動するかどうかを指定します。 このオプションの形式は、 FIRE_TRIGGERSです。 このオプションが指定されている場合は、トリガーが起動されます。
ORDER	入力データの並べ替え方法を指定します。 このオプションの形式は、ORDER <列名> ASC|DESC です。 並べ替える列のリストには任意の数列を指定できます。並べ替え順序の指定は省略することもできます。 並べ替え順序を指定しなかった場合は、データを並べ替えないと見なして挿入操作が実行されます。 注:ORDER オプションを使用してテーブル上のクラスター化インデックスに従って入力データを並べ替えると、パフォーマンスが向上する可能性があります。

Transact-SQL キーワードは慣例として通常は大文字で入力しますが、これらのキーワードの大文字小文字は区別されません。

高速読み込みオプションの詳細については、「BULK INSERT (Transact-SQL)」を参照してください。

OLE DB 変換先のトラブルシューティング

OLE DB 変換先による外部データ プロバイダーの呼び出しをログに記録できます。 このログ機能を使用すると、OLE DB 変換先による外部データ ソースへのデータ保存に関するトラブルシューティングを行うことができます。 OLE DB 変換先による外部データ プロバイダーの呼び出しのログを記録するには、パッケージ ログ記録を有効にして、パッケージ レベルで Diagnostic イベントを選択します。 詳細については、「 パッケージ実行のトラブルシューティング ツール」を参照してください。

OLE DB 変換先の構成

プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。

[詳細エディター] ダイアログ ボックスには、プログラムによって設定できるプロパティが反映されます。 [詳細エディター] ダイアログ ボックスまたはプログラムで設定できるプロパティの詳細については、次のトピックのいずれかを参照してください。

• Common Properties

• OLE DB カスタム プロパティ

プロパティの設定方法の詳細については、次のトピックのいずれかを参照してください。

• OLE DB 変換先を使用してデータを読み込む

• データ フロー コンポーネントのプロパティを設定する

[OLE DB 変換先エディター] ([接続マネージャー] ページ)

[OLE DB 変換先エディター] ダイアログ ボックスの [接続マネージャー] ページを使用すると、変換先の OLE DB 接続を選択できます。 さらにこのページを使用して、データベースのテーブルやビューを選択できます。

静的オプション

[キャッシュなし]
既存の接続マネージャーを一覧から選択するか、 [新規作成] をクリックして新しい接続を作成します。

[新規作成]
[OLE DB 接続マネージャーの構成] ダイアログ ボックスを使用して、新しい接続マネージャーを作成します。

[データ アクセス モード]
データを変換先に読み込む方法を指定します。 2 バイト文字セット (DBCS) データを読み込むには、高速読み込みオプションのいずれかを使用する必要があります。 一括挿入用に最適化された高速読み込みデータ アクセス モードの詳細については、「 OLE DB 変換先」を参照してください。

オプション	説明
[テーブルまたはビュー]	データを OLE DB 変換先のテーブルまたはビューに読み込みます。
[テーブルまたはビュー - 高速読み込み]	高速読み込みオプションを使用し、データを OLE DB 変換先のテーブルまたはビューに読み込みます。 一括挿入用に最適化された高速読み込みデータ アクセス モードの詳細については、「 OLE DB 変換先」を参照してください。
[テーブル名またはビュー名の変数]	テーブル名またはビュー名を変数で指定します。 関連情報: パッケージで変数を使用する
[テーブル名またはビュー名の変数 - 高速読み込み]	高速読み込みオプションを使用し、テーブル名またはビュー名を変数で指定します。 一括挿入用に最適化された高速読み込みデータ アクセス モードの詳細については、「 OLE DB 変換先」を参照してください。
[SQL コマンド]	SQL クエリを使用し、データを OLE DB 変換先に読み込みます。

プレビュー
[クエリ結果のプレビュー] ダイアログ ボックスを使用して、結果をプレビューします。 プレビューでは、最大で 200 行を表示できます。

データ アクセス モードの動的オプション

[データ アクセス モード] の各設定には、その設定に固有のオプションの動的なセットが表示されます。 次のセクションでは、各 [データ アクセス モード] 設定で使用可能な各動的オプションについて説明します。

[データ アクセス モード] = [テーブルまたはビュー]

[テーブル名またはビュー名]
データ ソースで使用できるテーブルまたはビューの一覧から、テーブルまたはビューの名前を選択します。

[新規作成]
[テーブルの作成] ダイアログ ボックスを使用して新しいテーブルを作成します。

[データ アクセス モード] = [テーブルまたはビュー - 高速読み込み]

[テーブル名またはビュー名]
この一覧を使用してデータベースからテーブルまたはビューを選択するか、 [新規作成] をクリックして新しいテーブルを作成します。

[新規作成]
[テーブルの作成] ダイアログ ボックスを使用して新しいテーブルを作成します。

[ID を保持する]
データが読み込まれるときに ID 値をコピーするかどうかを指定します。 このプロパティは、高速読み取りオプションを指定した場合にのみ使用できます。 このプロパティの既定値は falseです。

[NULL を保持する]
データが読み込まれるときに NULL 値をコピーするかどうかを指定します。 このプロパティは、高速読み取りオプションを指定した場合にのみ使用できます。 このプロパティの既定値は falseです。

[テーブル ロック]
読み込み中にテーブルをロックするかどうかを指定します。 このプロパティの既定値は trueです。

CHECK 制約
データの読み込み中に変換先で制約をチェックするかどうかを指定します。 このプロパティの既定値は trueです。

[バッチごとの行数]
バッチ内の行数を指定します。 このプロパティの既定値は、 -1です。これは、割り当てられた値がないことを示します。

[挿入コミット サイズの最大値]
高速読み込み操作の実行中に OLE DB 変換先でコミットを試行するバッチ サイズを指定します。 値 0 は、すべての行が処理された後、すべてのデータを 1 つのバッチでコミットすることを示します。

このプロパティに値を指定すると、変換先で [挿入コミット サイズの最大値] 未満の行数のバッチがコミットされます。値を指定しない場合は、現在処理されているバッファー内の残りの行数がコミットされます。

[データ アクセス モード] = [テーブル名またはビュー名の変数]

[変数名]
テーブル名またはビュー名を含む変数を選択します。

[データ アクセス モード] = [テーブル名またはビュー名の変数 - 高速読み込み]

[変数名]
テーブル名またはビュー名を含む変数を選択します。

[新規作成]
[テーブルの作成] ダイアログ ボックスを使用して新しいテーブルを作成します。

[ID を保持する]
データが読み込まれるときに ID 値をコピーするかどうかを指定します。 このプロパティは、高速読み取りオプションを指定した場合にのみ使用できます。 このプロパティの既定値は falseです。

[NULL を保持する]
データが読み込まれるときに NULL 値をコピーするかどうかを指定します。 このプロパティは、高速読み取りオプションを指定した場合にのみ使用できます。 このプロパティの既定値は falseです。

[テーブル ロック]
読み込み中にテーブルをロックするかどうかを指定します。 このプロパティの既定値は falseです。

CHECK 制約
タスクで制約をチェックするかどうかを指定します。 このプロパティの既定値は falseです。

[バッチごとの行数]
バッチ内の行数を指定します。 このプロパティの既定値は、 -1です。これは、割り当てられた値がないことを示します。

[挿入コミット サイズの最大値]
高速読み込み操作の実行中に OLE DB 変換先でコミットを試行するバッチ サイズを指定します。 既定値の 2147483647 は、すべての行が処理された後、すべてのデータを 1 つのバッチでコミットすることを示します。

[データ アクセス モード] = [SQL コマンド]

[SQL コマンド テキスト]
SQL クエリのテキストを入力し、 [クエリの作成] をクリックしてクエリを作成するか、 [参照] をクリックしてクエリ テキストを含むファイルを指定します。

[クエリの作成]
SQL クエリを視覚的に作成するには、 [クエリ ビルダー] ダイアログ ボックスを使用します。

[参照]
[開く] ダイアログ ボックスを使用して、SQL クエリのテキストが含まれているファイルを指定します。

[クエリの解析]
クエリ テキストの構文を検査します。

[OLE DB 変換先エディター] ([マッピング] ページ)

[OLE DB 変換先エディター] ダイアログ ボックスの [マッピング] ページを使用すると、入力列を変換先列にマップできます。

Options

使用できる入力列
使用できる入力列の一覧を表示します。 ドラッグ アンド ドロップ操作により、テーブル内の使用できる入力列を変換先列にマップします。

使用できる変換先列
使用できる変換先列の一覧を表示します。 ドラッグ アンド ドロップ操作により、テーブル内の使用できる変換先列を入力列にマップします。

入力列
選択した入力列を表示します。 <無視> を選択して出力から列を除外することで、マッピングを削除できます。

変換先列
マップするかどうかにかかわらず、使用できる変換先列を表示します。

[OLE DB 変換先エディター] ([エラー出力] ページ)

[OLE DB 変換先エディター] ダイアログ ボックスの [エラー出力] ページを使用すると、エラー処理オプションを指定できます。

Options

[入力または出力]
入力の名前を表示します。

列
使用されていません。

Error
エラーが発生した場合に、障害を無視するか、行をリダイレクトするか、コンポーネントを失敗させるかを指定します。

関連項目:データのエラー処理

切り捨て
使用されていません。

説明
操作の説明を表示します。

[選択したセルに設定する値]
エラーまたは切り捨てが発生した場合に、選択したすべてのセルに対して障害を無視するか、行をリダイレクトするか、コンポーネントを失敗させるかを指定します。

[適用]
選択したセルにエラー処理オプションを適用します。

関連コンテンツ

OLE DB 変換元

Integration Services (SSIS) の変数

データ フロー