ODBC 入力元
適用対象: 
SQL Server Azure Data Factory の SSIS 統合ランタイム
ODBC ソースは、データベース テーブル、ビュー、または SQL ステートメントを使用して、ODBC でサポートされているデータベースからデータを抽出します。
ODBC 入力元には、データを抽出するために、次のデータ アクセス モードがあります。
テーブルまたはビュー。
SQL ステートメントの結果。
入力元は、使用するプロバイダーを指定する、ODBC 接続マネージャーを使用します。
ODBC 入力元には、ソース データ出力列があります。 出力列が ODBC 入力先で入力先列にマッピングされている場合に、入力先列にマッピングされている入力列がないときにはエラーが発生することがあります。 さまざまな種類の列をマッピングできますが、出力列と入力先との間に互換性がない場合は、実行時にエラーが発生します。 エラー動作設定に応じて、エラーが無視されるか、エラーが発生するか、エラー出力に行が送信されます。
ODBC 入力元には、1 つの標準出力と 1 つのエラー出力があります。
エラー処理
ODBC 入力元にはエラー出力があります。 コンポーネントのエラー出力には、次の出力列があります。
エラー コード: 現在のエラーに対応する数字です。 エラーの一覧については、使用している ODBC でサポートされているデータベースのドキュメントを参照してください。 SSIS エラー コードの一覧については、「SSIS のエラー コードおよびメッセージ リファレンス」を参照してください。
エラー列: (変換エラーの) エラーの原因となるソース列。
標準出力データ列。
ODBC 入力元は、エラー動作の設定に応じて、抽出処理中に発生したエラー (データ変換、切り捨て) をエラー出力に返します。 詳細については、「ODBC 変換先エディター ([接続マネージャー] ページ)」を参照してください。
データ型のサポート
ODBC 入力元でサポートされるデータ型については、「Connector for Open Database Connectivity (ODBC)」を参照してください。
抽出オプション
ODBC 入力元は、 バッチ または 行ごと のどちらかのモードで動作します。 使用するモードは、 FetchMethod プロパティによって決まります。 以下に、モードの説明を示します。
バッチ: コンポーネントは、把握した ODBC プロバイダーの機能に基づいて、最も効率的なフェッチ方法を使用します。 最新の ODBC プロバイダーの場合、これは配列バインドを使用する SQLFetchScroll です (このとき、配列のサイズは BatchSize プロパティによって決定します)。 [バッチ] を選択したが、この方法がプロバイダーでサポートされていない場合、ODBC 入力先は自動的に [行ごと] モードに切り替わります。
行ごと: コンポーネントは SQLFetch を使用して、一度に 1 行ずつ取得します。
FetchMethod プロパティの詳細については、「 ODBC 入力元のカスタム プロパティ」を参照してください。
Parallelism
並列実行できる ODBC 入力元コンポーネントの数に制限はありません。これは、同一テーブル上にある場合または異なるテーブル上にある場合、同一コンピューター上で実行する場合または異なるコンピューター上で実行する場合のいずれにも該当します (ただし、通常のグローバルなセッション制限を除きます)。
ただし、使用する ODBC プロバイダーの制限によって、プロバイダーを介するコンカレント接続数が制限される場合があります。 これらの制限によって、ODBC 入力元で使用できる並列インスタンス数のサポートが制限されます。 SSIS プロバイダーは、使用される ODBC プロバイダーの制限を把握し、SSIS パッケージを作成する際に考慮する必要があります。
ODBC 入力元のトラブルシューティング
ODBC 入力元による外部データ プロバイダーの呼び出しをログに記録できます。 このログ機能を使用すると、ODBC 入力元による外部データ ソースからのデータ読み込みに関するトラブルシューティングを行うことができます。 ODBC 入力元による外部データ プロバイダーの呼び出しをログに記録するには、ODBC ドライバー マネージャーによるトレースを有効にします。 詳細については、「 ODBC で ODBC トレースを生成する方法 (データ ソース管理者向け) 」の Microsoft のドキュメントを参照してください。
ODBC 入力元の構成
ODBC 入力元は、プログラムによって、または SSIS デザイナーを使用して構成できます。
[詳細エディター] ダイアログ ボックスには、プログラムによって設定できるプロパティが表示されます。
[詳細エディター] ダイアログ ボックスを開くには、次の操作を実行します。
- SQL Server 2019 Integration Services (SSIS) プロジェクトの [データ フロー] 画面で、ODBC ソースを右クリックし、[詳細エディターの表示] を選択します。
[詳細エディター] ダイアログ ボックスで設定できるプロパティの詳細については、「 ODBC 入力元のカスタム プロパティ」を参照してください。
このセクションの内容
[ODBC ソース エディター] ([接続マネージャー] ページ)
[ODBC 入力元エディター] ダイアログ ボックスの [接続マネージャー] ページを使用すると、入力元の ODBC 接続マネージャーを選択できます。 さらにこのページを使用して、データベースのテーブルやビューを選択できます。
タスク一覧
[ODBC 入力元エディター] の [接続マネージャー] ページを開くには
SQL Server Data Tools で、ODBC ソースを含む SQL Server 2019 Integration Services (SSIS) パッケージを開きます。
[データ フロー] タブで、ODBC 入力元をダブルクリックします。
オプション
[ODBC 入力元エディター]
既存の ODBC 接続マネージャーを一覧から選択するか、 [新規作成] をクリックして新しい接続を作成します。 ODBC でサポートされているデータベースへの接続を選択または入力できます。
新規
[新規作成] をクリックします。 新しい ODBC 接続マネージャーを作成できる [ODBC 接続マネージャーの構成エディター] ダイアログ ボックスが開きます。
[データ アクセス モード]
入力元のデータを選択する方法を選択します。 次の表に示すオプションがあります。
| オプション | 説明 |
|---|---|
| テーブル名 | ODBC データ ソースのテーブルまたはビューからデータを取得します。 このオプションを選択する場合は、以下の一覧から値を選択します。 |
| [テーブル名またはビュー名]: 使用できるテーブルまたはビューを一覧から選択するか、正規表現を入力してテーブルを特定します。 | |
| この一覧には、最初の 1,000 個のテーブルのみが含まれます。 データベースに 1,000 を超えるテーブルがある場合、テーブル名の最初の文字を入力するか、名前の一部の入力にワイルドカード (*) を使用すると、目的のテーブルが表示されます。 | |
| [SQL コマンド] | SQL クエリを使用して ODBC データ ソースからデータを取得します。 使用しているソース データベースの構文でクエリを記述してください。 このオプションを選択する場合は、以下のいずれかの方法でクエリを入力します。 |
| [SQL コマンド テキスト] フィールドに SQL クエリのテキストを入力します。 | |
| [参照] をクリックして、テキスト ファイルから SQL クエリを読み込みます。 | |
| [クエリの解析] をクリックして、クエリ テキストの構文を検証します。 |
プレビュー
[プレビュー] をクリックすると、選択したテーブルまたはビューから抽出されたデータを先頭から最大で 200 行表示できます。
[ODBC ソース エディター] ([列] ページ)
[ODBC ソース エディター] ダイアログ ボックスの [列] ページを使用すると、出力列をそれぞれの外部 (入力元) 列にマップできます。
タスク一覧
[ODBC 入力元エディター] の [列] ページを開くには
SQL Server Data Tools で、ODBC ソースを含む SQL Server 2019 Integration Services (SSIS) パッケージを開きます。
[データ フロー] タブで、ODBC 入力元をダブルクリックします。
[ODBC 入力元エディター]で、 [列]をクリックします。
オプション
使用できる外部列
データ ソース内の使用できる外部列の一覧です。 このテーブルを使用して列を追加または削除することはできません。 入力元から使用する列を選択します。 選択した列は、選択した順序で [外部列] の一覧に追加されます。
[すべて選択] チェック ボックスをオンにすると、すべての列が選択されます。
外部列
外部 (入力元) 列のビューです。ODBC 入力元のデータを使用するコンポーネントを構成するときの表示順になります。
出力列
各出力列の一意の名前を入力します。 既定では選択された外部 (変換元) 列の名前になりますが、一意でわかりやすい名前を付けることもできます。 入力した名前は、SSIS デザイナーで表示されます。
[ODBC ソース エディター] ([エラー出力] ページ)
[ODBC 入力元エディター] ダイアログ ボックスの [エラー出力] ページを使用すると、エラー処理オプションを選択できます。
タスク一覧
[ODBC 入力元エディター] の [エラー出力] ページを開くには
SQL Server Data Tools で、ODBC ソースを含む SQL Server 2019 Integration Services (SSIS) パッケージを開きます。
[データ フロー] タブで、ODBC 入力元をダブルクリックします。
[ODBC 入力元エディター]で、 [エラー出力]をクリックします。
オプション
[入力または出力]
データ ソースの名前を表示します。
列
使用されていません。
エラー
ODBC 入力元でフローのエラーを処理する方法 (エラーを無視する、行をリダイレクトする、またはコンポーネントを失敗させる) を選択します。
切り捨て
ODBC 入力元でフローの切り捨てを処理する方法 (エラーを無視する、行をリダイレクトする、またはコンポーネントを失敗させる) を選択します。
説明
使用しません。
[選択したセルに設定する値]
エラーまたは切り捨てが発生した場合に、選択したすべてのセルを ODBC 入力元でどのように処理するか (エラーを無視する、行をリダイレクトする、またはコンポーネントを失敗させる) を選択します。
適用
選択したセルにエラー処理オプションを適用します。
エラー処理オプション
ODBC 入力元でのエラーと切り捨ての処理方法を構成するには、次のオプションを使用します。
エラー コンポーネント
エラーまたは切り捨てが発生すると、データ フロー タスクは失敗します。 これは既定の動作です。
エラーを無視する
エラーまたは切り捨ては無視されます。
[フローのリダイレクト]
エラーまたは切り捨てが ODBC 入力元のエラー出力に送られる原因となった行。