JSON-format i Data Factory i Microsoft Fabric

Den här artikeln beskriver hur du konfigurerar JSON-format i datapipelinen för Data Factory i Microsoft Fabric.

Funktioner som stöds

JSON-format stöds för följande aktiviteter och anslutningsappar som källa och mål.

Kategori Anslut eller/aktivitet
Anslutningsprogram som stöds Amazon S3
Azure Blob Storage
Azure Data Lake Storage Gen1
Azure Data Lake Storage Gen2
FTP
Google Cloud Storage
HTTP
SFTP
Aktivitet som stöds aktiviteten Kopiera
Sökningsaktivitet
GetMetadata-aktivitet
Ta bort aktivitet

JSON-format i kopieringsaktivitet

Om du vill konfigurera JSON-format väljer du din anslutning i källan eller målet för kopieringsaktiviteten för datapipelinen och väljer sedan JSON i listrutan i Filformat. Välj Inställningar för ytterligare konfiguration av det här formatet.

Screenshot showing file format settings.

JSON-format som källa

När du har valt Inställningar i avsnittet Filformat visas följande egenskaper i dialogrutan Inställningar för filformat i popup-fönstret.

Screenshot showing JSON file format source.

  • Komprimeringstyp: Välj den komprimeringskodc som används för att läsa JSON-filer i listrutan. Du kan välja mellan None, bzip2, gzip, deflate, ZipDeflate, TarGzip eller tar.

    Om du väljer ZipDeflate som komprimeringstyp visas Spara zip-filnamn som mapp under de avancerade inställningarna på fliken Källa .

    • Bevara zip-filnamnet som mapp: Anger om du vill behålla namnet på zip-källfilen som en mappstruktur under kopiering.
      • Om den här rutan är markerad (standard) skriver tjänsten uppackade filer till <specified file path>/<folder named as source zip file>/.
      • Om den här rutan är avmarkerad skriver tjänsten uppackade filer direkt till <specified file path>. Kontrollera att du inte har duplicerade filnamn i olika zip-källfiler för att undvika racing eller oväntat beteende.

    Om du väljer TarGzip/tjära som komprimeringstyp visas Bevara komprimeringsfilens namn som mapp under avancerade inställningar på fliken Källa.

    • Bevara komprimeringsfilens namn som mapp: Anger om det komprimerade källfilnamnet ska behållas som en mappstruktur under kopieringen.
      • Om den här rutan är markerad (standard) skriver tjänsten dekomprimerade filer till <specified file path>/<folder named as source compressed file>/.
      • Om den här rutan är avmarkerad skriver tjänsten dekomprimerade filer direkt till <specified file path>. Kontrollera att du inte har duplicerade filnamn i olika källfiler för att undvika racing eller oväntat beteende.
  • Komprimeringsnivå: Komprimeringsförhållandet. Du kan välja mellan Snabbaste eller Optimal.

    • Snabbast: Komprimeringsåtgärden bör slutföras så snabbt som möjligt, även om den resulterande filen inte komprimeras optimalt.

    • Optimal: Komprimeringsåtgärden bör komprimeras optimalt, även om åtgärden tar längre tid att slutföra. Mer information finns i artikeln Komprimeringsnivå .

  • Kodning: Ange den kodningstyp som används för att läsa testfiler. Välj en typ i listrutan. Standardvärdet är UTF-8.

JSON-format som mål

När du har valt Inställningar visas följande egenskaper i dialogrutan Inställningar för filformat i popup-fönstret.

Screenshot showing JSON file format destination.

  • Komprimeringstyp: Välj den komprimeringskodc som används för att skriva JSON-filer i listrutan. Du kan välja mellan None, bzip2, gzip, deflate, ZipDeflate, TarGzip eller tar.

  • Komprimeringsnivå: Komprimeringsförhållandet. Du kan välja mellan Optimal eller Snabbaste.

    • Snabbast: Komprimeringsåtgärden bör slutföras så snabbt som möjligt, även om den resulterande filen inte komprimeras optimalt.

    • Optimal: Komprimeringsåtgärden bör komprimeras optimalt, även om åtgärden tar längre tid att slutföra. Mer information finns i artikeln Komprimeringsnivå .

  • Kodning: Ange den kodningstyp som används för att skriva testfiler. Välj en typ i listrutan. Standardvärdet är UTF-8.

Under Avancerade inställningar på fliken Mål visas följande JSON-formatrelaterade egenskaper.

  • Filmönster: Ange mönstret för data som lagras i varje JSON-fil. Tillåtna värden är: Uppsättning objekt (JSON-linjer) och matris med objekt. Standardvärdet är Uppsättning av objekt. Detaljerad information om dessa mönster finns i avsnittet om JSON-filmönster.

JSON-filmönster

När du kopierar data från JSON-filer kan kopieringsaktivitet automatiskt identifiera och parsa följande mönster för JSON-filer. När du skriver data till JSON-filer kan du konfigurera filmönstret på målet för kopieringsaktiviteten.

  • Typ I: setOfObjects

    Varje fil innehåller enskilda objekt, JSON-rader eller sammanfogade objekt.

    • Exempel på JSON med enskilda objekt

      {
          "time": "2015-04-29T07:12:20.9100000Z",
          "callingimsi": "466920403025604",
          "callingnum1": "678948008",
          "callingnum2": "567834760",
          "switch1": "China",
          "switch2": "Germany"
      }
      
    • JSON-rader (standard för mål)

      {"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"}
      
    • Exempel med sammanfogad 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"
      }
      
  • Typ II: arrayOfObjects

    Varje fil innehåller en matris med objekt.

    [
        {
            "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"
        }
    ]
    

Tabellsammanfattning

JSON som källa

Följande egenskaper stöds i avsnittet Käll för kopieringsaktivitet när du använder JSON-formatet.

Name Beskrivning Värde Obligatoriskt JSON-skriptegenskap
Filformat Det filformat som du vill använda. JSON Ja typ (under datasetSettings):
Json
Komprimeringstyp Komprimeringskodcen som används för att läsa JSON-filer. Välj mellan:
None
bzip2
Gzip
Tömma
ZipDeflate
TarGzip
tjära
Nej typ (under compression):

bzip2
gzip
Tömma
ZipDeflate
TarGzip
tjära
Komprimeringsnivå Komprimeringsförhållandet. Snabbaste
Optimal
Nej nivå (under compression):
Snabbaste
Optimal
Kodning Kodningstypen som används för att läsa testfiler. "UTF-8" (som standard),"UTF-8 utan BOM", "UTF-16LE", "UTF-16BE", "UTF-32LE", "UTF-32BE", "US-ASCII", "UTF-7", "UTF-32LE", "UTF-32BE", "US-ASCII", "UTF-7", "UTF-7", "BIG5", "EUC-JP", "EUC-KR", "GB2312", "GB18030", "JOHAB", "SHIFT-JIS", "CP875", "CP866", "IBM00858", "IBM037", "IBM273", "IBM437", "IBM500", "IBM737", "IBM775", "IBM850", "IBM852", "IBM855", "IBM857", "IBM860", "IBM861", "IBM863", "IBM864 ", "IBM865", "IBM869", "IBM870", "IBM01140", "IBM01141", "IBM01142", "IBM01143", "IBM01144", "IBM01145", "IBM01146", "IBM01147", "IBM01148", "IBM01149", "ISO-2022-JP", "ISO-2022-KR", "ISO-8859-1", "ISO-8859-2", "ISO-8859-3", ""ISO-8859-2", "ISO-8859-3", "ISO-8859-4", "ISO-8859-5", "ISO-8859-6", "ISO-8859-7", "ISO-8859-8", "ISO--8859-7", "ISO-8859-8" 8859-9", "ISO-8859-13", "ISO-8859-15", "WINDOWS-874", "WINDOWS-1250", "WINDOWS-1251", "WINDOWS -1252", "WINDOWS-1253", "WINDOWS-1254", "WINDOWS-1255", "WINDOWS-1256", "WINDOWS-1257", "WINDOWS-1258" Nej encodingName
Bevara zip-filnamnet som mapp Anger om käll-zip-filnamnet ska bevaras som en mappstruktur under kopiering. Markerad (standard) eller avmarkera Nej preserveZipFileNameAsFolder
(under compressionProperties->type som ZipDeflateReadSettings):
sant (standard) eller falskt
Bevara komprimeringsfilens namn som mapp Anger om källans komprimerade filnamn ska bevaras som en mappstruktur under kopieringen. Markerad (standard) eller avmarkera Nej preserveCompressionFileNameAsFolder
(under compressionProperties->type som TarGZipReadSettings eller TarReadSettings):
sant (standard) eller falskt

JSON som mål

Följande egenskaper stöds i avsnittet Mål för kopieringsaktivitet när du använder JSON-formatet.

Name Beskrivning Värde Obligatoriskt JSON-skriptegenskap
Filformat Det filformat som du vill använda. JSON Ja typ (under datasetSettings):
Json
Komprimeringstyp Komprimeringskodcen som används för att skriva JSON-filer. Välj mellan:
None
bzip2
Gzip
Tömma
ZipDeflate
TarGzip
tjära
Nej typ (under compression):

bzip2
gzip
Tömma
ZipDeflate
TarGzip
tjära
Komprimeringsnivå Komprimeringsförhållandet. Snabbaste
Optimal
Nej nivå (under compression):
Snabbaste
Optimal
Kodning Kodningstypen som används för att skriva testfiler. "UTF-8" (som standard),"UTF-8 utan BOM", "UTF-16LE", "UTF-16BE", "UTF-32LE", "UTF-32BE", "US-ASCII", "UTF-7", "UTF-32LE", "UTF-32BE", "US-ASCII", "UTF-7", "UTF-7", "BIG5", "EUC-JP", "EUC-KR", "GB2312", "GB18030", "JOHAB", "SHIFT-JIS", "CP875", "CP866", "IBM00858", "IBM037", "IBM273", "IBM437", "IBM500", "IBM737", "IBM775", "IBM850", "IBM852", "IBM855", "IBM857", "IBM860", "IBM861", "IBM863", "IBM864 ", "IBM865", "IBM869", "IBM870", "IBM01140", "IBM01141", "IBM01142", "IBM01143", "IBM01144", "IBM01145", "IBM01146", "IBM01147", "IBM01148", "IBM01149", "ISO-2022-JP", "ISO-2022-KR", "ISO-8859-1", "ISO-8859-2", "ISO-8859-3", ""ISO-8859-2", "ISO-8859-3", "ISO-8859-4", "ISO-8859-5", "ISO-8859-6", "ISO-8859-7", "ISO-8859-8", "ISO--8859-7", "ISO-8859-8" 8859-9", "ISO-8859-13", "ISO-8859-15", "WINDOWS-874", "WINDOWS-1250", "WINDOWS-1251", "WINDOWS -1252", "WINDOWS-1253", "WINDOWS-1254", "WINDOWS-1255", "WINDOWS-1256", "WINDOWS-1257", "WINDOWS-1258" Nej encodingName
Filmönster Ange mönstret för de data som lagras i varje JSON-fil. Uppsättning objekt
Matris med objekt
Nej filePattern:
setOfObjects
arrayOfObjects