Microsoft Fabric の Data Factory での JSON 形式

この記事では、Microsoft Fabric で Data Factory のデータ パイプラインでの JSON 形式を構成する方法の概要を示します。

サポートされる機能

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

Copy アクティビティでの JSON 形式

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

ソースとしての JSON 形式

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

• [圧縮の種類]: JSON ファイルの読み取りに使う圧縮コーデックをドロップダウン リストで選びます。 [なし]、[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> に直接書き込まれます。 競合または予期しない動作を避けるために、異なるソース ファイルに重複したファイル名がないことを確認します。

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

  • 最速: 圧縮操作は可能な限り短時間で完了しますが、生成ファイルが最適に圧縮されない場合があります。

  • Optimal:圧縮操作で最適に圧縮されますが、操作が完了するまでに時間がかかる場合があります。 詳細については、圧縮率に関する記事を参照してください。

• [エンコード]: テスト ファイルの読み取りに使うエンコードの種類を指定します。 ドロップダウン リストから種類を 1 つ選びます。 既定値は UTF-8です。

コピー先としての JSON 形式

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

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

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

  • 最速: 圧縮操作は可能な限り短時間で完了しますが、生成ファイルが最適に圧縮されない場合があります。

  • Optimal:圧縮操作で最適に圧縮されますが、操作が完了するまでに時間がかかる場合があります。 詳細については、圧縮率に関する記事を参照してください。

• [エンコード]: テスト ファイルの書き込みに使うエンコードの種類を指定します。 ドロップダウン リストから種類を 1 つ選びます。 既定値は UTF-8です。

[コピー先] タブの [詳細] 設定に、次の JSON 形式の関連プロパティが表示されます。

• [ファイルのパターン]: 各 JSON ファイルに格納されるデータのパターンを指定します。 指定できる値は、[Set of objects] (オブジェクトのセット) (JSON 行) と [Array of objects] (オブジェクトの配列) です。 既定値は [Set of objects] (オブジェクトのセット) です。 これらのパターンの詳細については、「JSON ファイルのパターン」セクションを参照してください。

JSON ファイルのパターン

JSON ファイルからデータをコピーする場合、コピー アクティビティでは、JSON ファイルの以下のパターンを自動的に検出および解析することができます。 データを JSON ファイルに書き込むときに、Copy アクティビティのコピー先でファイル パターンを構成できます。

• タイプ I: setOfObjects

  各ファイルには、単一のオブジェクト、JSON 行、または連結されたオブジェクトが含まれます。

  • 単一オブジェクトの JSON の例

    {
        "time": "2015-04-29T07:12:20.9100000Z",
        "callingimsi": "466920403025604",
        "callingnum1": "678948008",
        "callingnum2": "567834760",
        "switch1": "China",
        "switch2": "Germany"
    }
    

  • JSON 行 (コピー先の既定値)

    {"time":"2015-04-29T07:12:20.9100000Z","callingimsi":"466920403025604","callingnum1":"678948008","callingnum2":"567834760","switch1":"China","switch2":"Germany"}
    {"time":"2015-04-29T07:13:21.0220000Z","callingimsi":"466922202613463","callingnum1":"123436380","callingnum2":"789037573","switch1":"US","switch2":"UK"}
    {"time":"2015-04-29T07:13:21.4370000Z","callingimsi":"466923101048691","callingnum1":"678901578","callingnum2":"345626404","switch1":"Germany","switch2":"UK"}
    

  • 連結 JSON の例

    {
        "time": "2015-04-29T07:12:20.9100000Z",
        "callingimsi": "466920403025604",
        "callingnum1": "678948008",
        "callingnum2": "567834760",
        "switch1": "China",
        "switch2": "Germany"
    }
    {
        "time": "2015-04-29T07:13:21.0220000Z",
        "callingimsi": "466922202613463",
        "callingnum1": "123436380",
        "callingnum2": "789037573",
        "switch1": "US",
        "switch2": "UK"
    }
    {
        "time": "2015-04-29T07:13:21.4370000Z",
        "callingimsi": "466923101048691",
        "callingnum1": "678901578",
        "callingnum2": "345626404",
        "switch1": "Germany",
        "switch2": "UK"
    }
    

• タイプ II: arrayOfObjects

  各ファイルにはオブジェクトの配列が含まれます。

  [
      {
          "time": "2015-04-29T07:12:20.9100000Z",
          "callingimsi": "466920403025604",
          "callingnum1": "678948008",
          "callingnum2": "567834760",
          "switch1": "China",
          "switch2": "Germany"
      },
      {
          "time": "2015-04-29T07:13:21.0220000Z",
          "callingimsi": "466922202613463",
          "callingnum1": "123436380",
          "callingnum2": "789037573",
          "switch1": "US",
          "switch2": "UK"
      },
      {
          "time": "2015-04-29T07:13:21.4370000Z",
          "callingimsi": "466923101048691",
          "callingnum1": "678901578",
          "callingnum2": "345626404",
          "switch1": "Germany",
          "switch2": "UK"
      }
  ]
  

表の概要

ソースとしての JSON

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

コピー先としての JSON

JSON 形式を使う場合、Copy アクティビティの [コピー先] セクションでは、次のプロパティがサポートされます。

関連するコンテンツ

• コネクタの概要