ADO NET 変換先

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

ADO NET 変換先は、データベース テーブルまたはビューを使用する各種 ADO.NET 準拠データベースにデータをロードします。 このデータを既存のテーブルやビューに読み込むことができますが、新しいテーブルを作成して、そこにデータを読み込むこともできます。

ADO NET 変換先を使用して Microsoft Azure SQL データベース に接続できます。 OLE DB を使用した SQL Database への接続はサポートされていません。 SQL Database の詳細については、「一般的な制限事項とガイドライン (Azure SQL Database)」を参照してください。

ADO.NET デスティネーションのトラブルシューティング

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

ADO.NET Destination の構成

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

ADO NET 変換先には、入力列と変換先データ ソースの列との間のマッピングが含まれています。 入力列を変換先のすべての列にマップする必要はありません。 ただし、一部の対象列のプロパティによっては、入力列のマッピングが必要になることがあります。 そうしないと、エラーが発生する可能性があります。 たとえば、変換先列で NULL 値が許容されていない場合は、入力列をその変換先列にマップする必要があります。 また、マップされる列のデータ型には互換性がある必要があります。 たとえば、 ADO.NET プロバイダーで文字列データ型の入力列を数値データ型の変換先列にマップすることがサポートされていなければ、その操作はできません。

ADO NET の変換先には、通常入力が 1 つとエラー出力が 1 つあります。

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

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

• 共通プロパティ

• ADO NET カスタム プロパティ

プロパティの設定方法の詳細については、「 データ フロー コンポーネントのプロパティを設定する」を参照してください。

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

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

[接続マネージャー] ページを開くには

1. SQL Server Data Tools (SSDT)で、ADO NET 変換先を含む Integration Services パッケージを開きます。

2. [データ フロー] タブで、ADO NET 変換先をダブルクリックします。

3. [ADO NET 変換先エディター] で、 [接続マネージャー] をクリックします。

静的オプション

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

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

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

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

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

[使用可能な場合は一括挿入を使用する]
一括挿入操作のパフォーマンスを向上させるために SqlBulkCopy インターフェイスを使用するかどうかを指定します。

SqlConnection オブジェクトを返す ADO.NET プロバイダーのみが SqlBulkCopy インターフェイスの使用をサポートしています。 .NET Data Provider for SQL Server (SqlClient) は SqlConnection オブジェクトを返し、カスタム プロバイダーは SqlConnection オブジェクトを返す可能性があります。

.NET Data Provider for SQL Server (SqlClient) を使用して MicrosoftAzure SQL データベース に接続できます。

[使用可能な場合は一括挿入を使用する] を選択し、 [エラー] オプションを [行をリダイレクトする] に設定した場合、変換先によってエラー出力にリダイレクトされるデータのバッチに問題のない行が含まれる可能性があります。一括操作でのエラー処理の詳細については、「 データのエラー処理」を参照してください。

外部リソース

sqlcat.com の技術記事「Azure SQL Database へのデータの高速な読み込み」

ADO NET 出力先エディター (マッピング ページ)

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

[マッピング] ページを開くには

1. SQL Server Data Tools (SSDT)で、ADO NET 変換先を含む Integration Services パッケージを開きます。

2. [データ フロー] タブで、ADO NET 変換先をダブルクリックします。

3. [ADO NET 変換先エディター] で、 [マッピング] をクリックします。

オプション

使用できる入力列
使用できる入力列の一覧を表示します。 ドラッグ アンド ドロップ操作を使用して、テーブル内の使用可能な入力列を変換先の列に対応付けます。

利用可能な宛先列
利用可能な宛先列の一覧を表示します。 ドラッグ アンド ドロップ操作を使用して、テーブル内の使用可能な宛先列を入力列に対応付けます。

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

変換先列
マッピングされているかどうかにかかわらず、利用可能な各宛先列を表示します。

ADO.NET 変換先エディター (エラー出力ページ)

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

[エラー出力] ページを開くには

1. SQL Server Data Tools (SSDT)で、ADO NET 変換先を含む Integration Services パッケージを開きます。

2. [データ フロー] タブで、ADO NET 変換先をダブルクリックします。

3. [ADO NET 変換先エディター] で、 [エラー出力] をクリックします。

オプション

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

列
使用されていません。

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

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

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

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

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

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