柔軟なファイル ソース

  • [アーティクル]

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

柔軟なファイル ソース コンポーネントにより、SSIS パッケージがサポートされているさまざまなストレージ サービスからデータを読み取れるようになります。 現在サポートされているストレージ サービスは次のとおりです。

柔軟なファイル ソースのエディターを表示するには、データ フロー デザイナー上に柔軟なファイル ソースをドラッグ アンド ドロップし、これをダブルクリックしてエディターを開きます。

柔軟なファイル ソースは、SQL Server Integration Services (SSIS) Feature Pack for Azure のコンポーネントです。

次のプロパティは、柔軟なファイル ソース エディターで利用できます。

  • [File Connection Manager Type](ファイル接続マネージャーの種類): ソース接続マネージャーの種類を指定します。 そして、指定された種類の既存のものを選択するか、新しいものを作成します。
  • [フォルダー パス]: ソース フォルダーのパスを指定します。
  • ファイル名: ソース ファイル名を指定します。
  • [ファイル形式]: ソース ファイル形式を指定します。 サポートされている形式は、テキスト、Avro、ORC、Parquet です。 ORC/Parquet の場合は Java が必要です。 詳細については、こちらを参照してください。
  • [列区切り文字]: 列区切り記号として使用される文字を指定します (複数文字の区切り記号はサポートされていません)。
  • [First row as the column name](先頭行を列名にする): 先頭行を列名として扱うかどうかを指定します。
  • [Decompress the file](ファイル圧縮の解除): ソース ファイルの圧縮を解除するかどうかを指定します。
  • [圧縮の種類]: ソース ファイルの圧縮形式を指定します。 サポートされている形式は GZIP、DEFLATE、BZIP2 です。

次のプロパティは、詳細エディターで利用できます。

  • rowDelimiter: ファイルの行を区切るための文字。 許可される文字は 1 つだけです。 既定値は \r\n です。
  • escapeChar: 入力ファイルの列区切り記号をエスケープするための特殊文字。 escapeChar と quoteChar の両方をテーブルに指定することはできません。 許可される文字は 1 つだけです。 既定値はありません。
  • quoteChar: 文字列値を引用符で囲むための文字。 引用符文字内の列区切り記号と行区切り記号は文字列値の一部として扱われます。 このプロパティは、入力と出力の両方のデータセットに適用できます。 escapeChar と quoteChar の両方をテーブルに指定することはできません。 許可される文字は 1 つだけです。 既定値はありません。
  • nullValue: null 値を表すための 1 つまたは複数の文字。 既定値は \N です。
  • encodingName: エンコーディング名を指定します。 Encoding.EncodingName プロパティを参照してください。
  • skipLineCount: 入力ファイルからデータを読むとき、スキップする空ではない行の数を示します。 skipLineCount と firstRowAsHeader の両方が指定されている場合、行が最初にスキップされ、次に、入力ファイルからヘッダー情報が読まれます。
  • treatEmptyAsNull: 入力ファイルからデータを読むとき、null 値として null または空の文字列を扱うことを指定します。 既定値は True です。

接続情報を指定した後、[列] ページで、SSIS データ フローのマップ元の列をマップ先の列にマップします。

サービス プリンシパルのアクセス許可の構成に関する注意事項

テスト接続が機能するためには (BLOB ストレージまたは Data Lake Storage Gen2)、サービス プリンシパルには少なくともストレージ アカウントに対するストレージ BLOB データ閲覧者の役割を割り当てる必要があります。 これは、RBAC を使用して行います。

BLOB ストレージの場合、少なくともストレージ BLOB データ閲覧者の役割を割り当てることにより、読み取りのアクセス許可が付与されます。

Data Lake Storage Gen2 の場合、アクセス許可は RBAC と ACL の両方によって決定されます。 こちらに説明されているように、アプリ登録に対応するサービス プリンシパルのオブジェクト ID (OID) を使用して ACL を構成することに注意してください。 これは、RBAC 構成で使用されるアプリケーション (クライアント) ID とは異なります。 組み込みロールまたはカスタム ロールを使用してセキュリティ プリンシパルに RBAC データ アクセス許可が付与されると、これらのアクセス許可は、要求の認可時に最初に評価されます。 要求された操作がセキュリティ プリンシパルの RBAC 割り当てによって認可された場合、認可はすぐに解決され、追加の ACL チェックは実行されません。 また、セキュリティ プリンシパルに RBAC 割り当てがない場合、または要求の操作が割り当てられたアクセス許可と一致しない場合、ACL チェックが実行され、要求された操作を実行する権限がセキュリティ プリンシパルに付与されているかどうかが判断されます。 読み取りアクセス許可の場合、少なくともソース ファイル システムから開始する実行アクセス許可を、読み取るファイルに対する読み取りアクセス許可と共に付与します。 または、少なくともストレージ BLOB データ閲覧者の役割を RBAC を使用して付与します。 詳細については、この記事を参照してください。