次の方法で共有

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 アクティビティのバイナリ形式

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

ファイルの設定ボタンを示すスクリーンショット。

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
最適

関連するコンテンツ