ファイル接続マネージャー
適用対象:
SQL Server Azure Data Factory の SSIS Integration Runtime
ファイル接続マネージャーを使用すると、パッケージで既存のファイルやフォルダーを参照したり、実行時にファイルやフォルダーを作成できます。 たとえば、Excel ファイルを参照できます。 Microsoft SQL Server Integration Services の特定のコンポーネントでは、ファイルの情報を使用して作業が実行されます。 たとえば、SQL 実行タスクでは、そのタスクで実行する SQL ステートメントが含まれるファイルを参照できます。 他のコンポーネントは、ファイルに対する操作を実行します。 たとえば、ファイル システム タスクは新しい場所にコピーするファイルを参照できます。
ファイル接続マネージャーの使用法の種類
ファイル接続マネージャーの FileUsageType プロパティでは、ファイル接続の使用方法を指定します。 ファイル接続マネージャーでは、ファイルの作成、フォルダーの作成、既存のファイルの使用、または既存のフォルダーの使用を実行できます。
次の表に FileUsageTypeの値を示します。
| 値 | 内容 |
|---|---|
| 0 | ファイル接続マネージャーは、既存のファイルを使用します。 |
| 1 | ファイル接続マネージャーは、ファイルを作成します。 |
| 2 | ファイル接続マネージャーは、既存のフォルダーを使用します。 |
| 3 | ファイル接続マネージャーは、フォルダーを作成します。 |
複数のファイルまたはフォルダーの接続
ファイル接続マネージャーが参照できるファイルまたはフォルダーは、1 つのみです。 複数のファイルまたはフォルダーを参照するには、ファイル接続マネージャーではなく、複数ファイル接続マネージャーを使用します。 詳細については、「 複数ファイル接続マネージャー」を参照してください。
ファイル接続マネージャーの構成
ファイル接続マネージャーをパッケージに追加するときは、 Integration Services によって、実行時にファイル接続を解決する接続マネージャーを作成し、ファイル接続プロパティを設定して、ファイル接続をパッケージの 接続 コレクションに追加します。
接続マネージャーの ConnectionManagerType プロパティは、 FILEに設定されます。
ファイル接続マネージャーは、次の方法で構成できます。
使用法の種類を指定します。
ファイルまたはフォルダーを指定します。
ファイル接続マネージャーの ConnectionString プロパティは、 SQL Server Data Tools (SSDT)の [プロパティ] ウィンドウで式を指定することで設定できます。 ただし、式を使用してファイルまたはフォルダーを指定するときの検証エラーを防ぐため、 [ファイル接続マネージャー エディター] で、 [ファイル]/[フォルダー] に、ファイル パスまたはフォルダー パスを追加してください。
プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。
SSIS デザイナーで設定できるプロパティの詳細については、「 [ファイル接続マネージャー エディター] ダイアログ ボックス」を参照してください。
プログラムによる接続マネージャーの構成については、「 ConnectionManager 」と「 プログラムによる接続の追加に設定されます。
[ファイル接続マネージャー エディター] ダイアログ ボックス
[ファイル接続マネージャー エディター] ダイアログ ボックスを使用すると、ファイルまたはフォルダーに接続するためのプロパティを指定できます。
注意
ファイル接続マネージャーの ConnectionString プロパティは、 SQL Server Data Tools (SSDT)の [プロパティ] ウィンドウで式を指定することで設定できます。 ただし、式を使用してファイルまたはフォルダーを指定するときの検証エラーを防ぐため、 [ファイル接続マネージャー エディター] で、 [ファイル]/[フォルダー] に、ファイル パスまたはフォルダー パスを追加してください。
ファイル接続マネージャーの詳細については、「 File Connection Manager」を参照してください。
オプション
[使用法の種類]
ファイル接続マネージャー が既存のファイルまたはフォルダーに接続するか、新しいファイルまたはフォルダーを作成するかを指定します。
| 値 | 説明 |
|---|---|
| [ファイルの作成] | 実行時に新しいファイルを作成します。 |
| [既存のファイル] | 既存のファイルを使用します。 |
| フォルダーの作成 | 実行時に新しいフォルダーを作成します。 |
| [既存のフォルダー] | 既存のフォルダーを使用します。 |
[ファイル]/[フォルダー]
[ファイル]の場合は、使用するファイルを指定します。
[フォルダー]の場合は、使用するファイルを指定します。
[参照]
[ファイルの選択] ダイアログ ボックスまたは [フォルダーの参照] ダイアログ ボックスを使用して、ファイルまたはフォルダーを選択します。
[ファイル接続マネージャーの追加] ダイアログ ボックスの UI リファレンス
[ファイル接続マネージャーの追加] ダイアログ ボックスを使用すると、ファイルまたはフォルダーのグループへの接続を定義できます。
複数のファイルの接続マネージャーの詳細については、「 Multiple Files Connection Manager」を参照してください。
Note
Integration Services の組み込みタスクとデータ フロー コンポーネントは、複数ファイル接続マネージャーを使用しません。 ただし、スクリプト タスクまたはスクリプト コンポーネントでは、この接続マネージャーを使用できます。
[ファイルの追加] 接続マネージャー用のダイアログ ボックス オプション
[使用法の種類]
複数のファイルの接続マネージャーに使用するファイルの種類を指定します。
| 値 | 説明 |
|---|---|
| ファイルを作成する | 接続マネージャーはファイルを作成します。 |
| [既存のファイル] | 接続マネージャーは既存のファイルを使用します。 |
| [フォルダーの作成] | 接続マネージャーはフォルダーを作成します。 |
| [既存のフォルダー] | 接続マネージャーは既存のフォルダーを使用します。 |
[ファイルまたはフォルダー]
次のボタンを使用して追加したファイルまたはフォルダーを表示します。
追加
[ファイルの選択] ダイアログ ボックスを使用してファイルを追加するか、 [フォルダーの参照] ダイアログ ボックスを使用してフォルダーを追加します。
[編集]
ファイルまたはフォルダーを選択し、 [ファイルの選択] または [フォルダーの参照] ダイアログ ボックスを使用して別のファイルまたはフォルダーで置き換えます。
Remove
ファイルまたはフォルダーを選択し、 [削除] ボタンを使用して一覧から削除します。
矢印ボタン
ファイルまたはフォルダーを選択し、矢印ボタンを使用して上または下に移動して、アクセスのシーケンスを指定します。
[列の型の推測] ダイアログ ボックスの UI リファレンス
[列の型の推測] ダイアログ ボックスを使用すると、フラット ファイル接続マネージャー内の列のデータ型および長さを、ファイルの内容のサンプリングに基づいて識別できます。
Integration Servicesで使用されるデータ型の詳細については、「 Integration Services のデータ型」を参照してください。
[列タイプの提案] のダイアログ ボックス オプション
[行数]
アルゴリズムで使用するサンプル内の行数を入力または選択します。
[最小の整数データ型を推測する]
評価をスキップする場合は、このチェック ボックスをオフにします。 オンにすると、整数の数値データを含む列で使用できる最小の整数データ型が決定されます。
[最小の実数データ型を推測する]
評価をスキップする場合は、このチェック ボックスをオフにします。 オンにすると、実数データを含む列で、より小さい実数データ型 DT_R4 を使用できるかどうかが決定されます。
[以下の値を使用してブール型の列を特定する]
ブール値 True および False として使用する 2 つの値を入力します。 値はコンマで区切る必要があり、最初の値が True を表すようにします。
[文字列型の列を埋め込む]
このチェック ボックスをオンにすると、文字列の埋め込みが有効になります。
[埋め込み率]
文字データ型の列の長さを増やすために使用する、列の長さに対する割合を入力または選択します。 割合は整数にする必要があります。
関連するコンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示