Excel 変換先

  • [アーティクル]

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

Excel 変換先は、 Microsoft Excel ブックのワークシートまたは範囲にデータを読み込みます。

重要

Excel ファイルへの接続、および Excel から、または Excel へのデータの読み込みに関する制限事項と既知の問題については、「Load data from or to Excel with SQL Server Integration Services (SSIS)」 (SQL Server Integration Services (SSIS) を使用して Excel から、または Excel にデータを読み込む) を参照してください。

アクセス モード

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

  • テーブルまたはビュー。

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

  • SQL ステートメントの結果。 クエリにはパラメーター化クエリを使用できます。

Excel 変換先の構成

Excel 変換先は、Excel 接続マネージャーを使用してデータ ソースに接続します。Excel 接続マネージャーでは、使用する Excel ブック ファイルを指定します。 詳しくは、「 Excel Connection Manager」をご覧ください。

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

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

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

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

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

[Excel 変換先エディター] ダイアログ ボックスの [接続マネージャー] ページを使用すると、データ ソース情報を指定したり、結果をプレビューしたりできます。 Excel 変換先では、 Microsoft Excel ブックのワークシートまたは名前付き範囲にデータが読み込まれます。

Note

Excel 変換先の CommandTimeout プロパティは、 [Excel 変換先エディター]ではアクセスできませんが、 [詳細エディター]を使用して設定できます。 また、一部の高速読み込みオプションは [詳細エディター] でしか使用できません。 これらのプロパティの詳細については、「 Excel Custom Properties」の「Excel 変換先」を参照してください。

静的オプション

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

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

[データ アクセス モード]
ソースからデータを選択する方法を指定します。

オプション 説明
[テーブルまたはビュー] Excel データ ソースのワークシートまたは名前付き範囲にデータを読み込みます。
[テーブル名またはビュー名の変数] ワークシートまたは範囲の名前を変数に指定します。

関連情報: パッケージで変数を使用する
[SQL コマンド] SQL クエリを使用して、Excel 変換先にデータを読み込みます。

[Excel シートの名前]
ドロップダウン リストから Excel 変換先を選択します。 一覧が空の場合は [新規]をクリックします。

[新規作成]
[新規] をクリックすると、 [テーブルの作成] ダイアログ ボックスが表示されます。 [OK]をクリックすると、 Excel 接続マネージャー の参照先の Excel ファイルが作成されます。

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

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

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

[Excel シートの名前]
データ ソースで使用できるワークシートまたは名前付き範囲の名前を一覧から選択します。

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

[変数名]
ワークシートまたは名前付き範囲の名前が含まれている変数を選択します。

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

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

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

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

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

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

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

Options

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

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

入力列
上の表で選択された入力列が表示されます。 [使用できる入力列] ボックスの一覧を使用して、マッピングを変更できます。

変換先列
マップされているかどうかに関係なく、使用できる変換先列を表示します。

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

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

Options

入力または出力
データ ソースの名前を表示します。

列
[Excel ソース エディター] ダイアログ ボックスの [接続マネージャー]ノードで選択されている外部 (ソース) 列を表示します。

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

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

切り捨て
切り捨てが発生したときの処理方法 (エラーを無視する、行をリダイレクトする、またはコンポーネントを失敗させる) を指定します。

説明
エラーの説明を表示します。

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

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

参照

SQL Server Integration Services (SSIS) を使用して Excel から、または Excel にデータを読み込む
Excel ソース
Excel 接続マネージャー