Microsoft Fabric の Data Factory 用のバイナリ形式

この記事では、Data Factory でバイナリ形式を構成する方法について説明します。

サポートされる機能

バイナリ形式は、次のアクティビティとコネクタでソースとコピー先としてサポートされています。

カテゴリ	コネクタ/アクティビティ
サポートされているコネクタ	Amazon S3
	Amazon S3 互換
	Azure Blob Storage
	Azure Data Lake Storage Gen1
	Azure Data Lake Storage Gen2
	Azure Files
	ファイル システム
	FTP
	Google Cloud Storage
	HTTP
	レイクハウス ファイル
	Oracle Cloud Storage
	SFTP
サポートされているアクティビティ	Copy アクティビティ (コピー元/コピー先)
	GetMetadata アクティビティ
	アクティビティを削除する

Copy アクティビティのバイナリ形式

バイナリ形式を構成するには、データ パイプラインの Copy アクティビティのソースまたはコピー先で接続を選択し、[ファイル形式] のドロップダウン リストで [バイナリ] を選択します。 この形式をさらに構成するには、[設定] を選択します。

Note

Copy アクティビティでバイナリ形式を使用する場合、ソースとコピー先の両方でバイナリ形式を使用する必要があります。

ソースとしてのバイナリ

[ソース] タブの [ファイル形式] セクションで [設定] を選択すると、ポップアップの [File format settings] (ファイル形式設定) ダイアログ ボックスに以下のプロパティが表示されます。

• [圧縮の種類]: バイナリ ファイルの読み取りに使用する圧縮コーデック。 ドロップダウン リストでは、[なし]、[bzip2]、[gzip]、[deflate]、[ZipDeflate]、[TarGzip]、[tar] の種類から選択できます。

  圧縮の種類として [ZipDeflate] を選択した場合、[ソース] タブの [詳細設定] に [Preserve zip file name as folder] (ZIP ファイル名をフォルダーとして保持する) が表示されます。

  • [Preserve zip file name as folder] (ZIP ファイル名をフォルダーとして保持する): コピー時にソースの ZIP ファイル名をフォルダー構造として保持するかどうかを指定します。
    • このボックスがオン (既定値) の場合、解凍されたファイルはサービスによって <specified file path>/<folder named as source zip file>/ に書き込まれます。
    • このボックスがオフの場合、解凍されたファイルはサービスによって <specified file path> に直接書き込まれます。 競合または予期しない動作を避けるために、異なるソース ZIP ファイルに重複したファイル名がないことを確認します。

  圧縮の種類として [TarGzip/tar] を選択した場合、[ソース] タブの [詳細設定] に [Preserve compression file name as folder] (圧縮ファイル名をフォルダーとして保持する) が表示されます。

  • [Preserve compression file name as folder] (圧縮ファイル名をフォルダーとして保持する): コピー時にソースの圧縮ファイル名をフォルダー構造として保持するかどうかを指定します。
    • このボックスがオン (既定値) の場合、圧縮解除されたファイルがサービスによって <specified file path>/<folder named as source compressed file>/ に書き込まれます。
    • このボックスがオフの場合、圧縮解除されたファイルがサービスによって <specified file path> に直接書き込まれます。 競合または予期しない動作を避けるために、異なるソース ZIP ファイルに重複したファイル名がないことを確認します。

• 圧縮レベル: 圧縮率です。 [最適] または [最速] から選択できます。

  • 最速: 圧縮操作は可能な限り短時間で完了しますが、生成ファイルが最適に圧縮されない場合があります。
  • Optimal:圧縮操作で最適に圧縮されますが、操作が完了するまでに時間がかかる場合があります。 詳細については、圧縮率に関する記事を参照してください。

[ソース] タブの [詳細設定] に、バイナリ形式に関連するプロパティがさらに表示されます。

• [完了後にファイルを削除]: コピー先ストアに正常に移動した後、バイナリ ファイルをソース ストアから削除するかどうかを示します。 ファイルの削除はファイルごとに行われます。 そのため、Copy アクティビティが失敗した場合、既にコピー先にコピーされて、ソースから削除されているファイルがある一方で、ソース ストアにまだ残されているものもあります。

コピー先としてのバイナリ

[Destination] (コピー先) タブの [ファイル形式] セクションで [設定] を選択すると、ポップアップの [File format settings] (ファイル形式設定) ダイアログ ボックスに以下のプロパティが表示されます。

• [圧縮の種類]: バイナリ ファイルの書き込みに使用する圧縮コーデック。 ドロップダウン リストでは、[なし]、[bzip2]、[gzip]、[deflate]、[ZipDeflate]、[TarGzip]、[tar] の種類から選択できます。

• 圧縮レベル: 圧縮率です。 [最適] または [最速] から選択できます。

  • 最速: 圧縮操作は可能な限り短時間で完了しますが、生成ファイルが最適に圧縮されない場合があります。
  • Optimal:圧縮操作で最適に圧縮されますが、操作が完了するまでに時間がかかる場合があります。 詳細については、圧縮率に関する記事を参照してください。

テーブルの概要

ソースとしてのバイナリ

バイナリ形式を使用する場合、Copy アクティビティの [ソース] セクションでは、次のプロパティがサポートされます。

名前	Description	Value	必須	JSON スクリプト プロパティ
ファイル形式	使用するファイル形式。	Binary	はい	type ("datasetSettings の下"): バイナリ
[圧縮の種類]	バイナリ ファイルの読み取りに使用される圧縮コーデックです。	次から選択してください。 なし bzip2 gzip deflate ZipDeflate TarGzip tar	いいえ	type ("compression の下"): bzip2 gzip deflate ZipDeflate TarGzip tar
圧縮レベル	圧縮率です。 使用できる値は、Optimal または Fastest です。	最適 または 最速	いいえ	level ("compression の下"): Fastest 最適
Preserve zip file name as folder (ZIP ファイル名をフォルダーとして保持する)	コピー時にソースの ZIP ファイル名をフォルダー構造として保持するかどうかを指定します。	選択または選択解除	いいえ	preserveZipFileNameAsFolder ("compressionProperties>type の下に ZipDeflateReadSettings として")
Preserve compression file name as folder (圧縮ファイル名をフォルダーとして保持する)	コピー時にソースの圧縮ファイル名をフォルダー構造として保持するかどうかを指定します。	選択または選択解除	いいえ	preserveCompressionFileNameAsFolder ("compressionProperties>type の下に TarGZipReadSettings または TarReadSettings として")
完了後にファイルを削除	バイナリ ファイルをコピー先ストアに正常に移動した後、ソース ストアから削除するかどうかを示します。	選択または選択解除	いいえ	deleteFilesAfterCompletion: true または false

コピー先としてのバイナリ

バイナリ形式を使用する場合、Copy アクティビティの [Destination] (コピー先) セクションでは、次のプロパティがサポートされます。

名前	Description	Value	必須	JSON スクリプト プロパティ
ファイル形式	使用するファイル形式。	Binary	はい	type ("datasetSettings の下"): バイナリ
[圧縮の種類]	バイナリ ファイルの書き込みに使用される圧縮コーデック。	次から選択してください。 なし bzip2 gzip deflate ZipDeflate TarGzip tar	いいえ	type ("compression の下"): bzip2 gzip deflate ZipDeflate TarGzip tar
圧縮レベル	圧縮率です。 使用できる値は、Optimal または Fastest です。	最適 または 最速	いいえ	level ("compression の下"): Fastest Optimal

関連するコンテンツ

• コネクタの概要
• データフローでバイナリ形式に接続する