JSON-formátum a Data Factoryben a Microsoft Fabricben

Ez a cikk bemutatja, hogyan konfigurálhatja a JSON formátumot a Data Factory adatfolyamában a Microsoft Fabricben.

Támogatott képességek

A JSON formátum a következő tevékenységek és összekötők esetében támogatott forrásként és célként.

Kategória Csatlakozás or/tevékenység
Támogatott összekötő Amazon S3
Azure Blob Storage
1. generációs Azure Data Lake Storage
Azure Data Lake Storage Gen2
FTP
Google Cloud Storage
HTTP
SFTP
Támogatott tevékenység Copy tevékenység
Keresési tevékenység
GetMetadata-tevékenység
Tevékenység törlése

JSON formátum másolási tevékenységben

A JSON formátum konfigurálásához válassza ki a kapcsolatot az adatfolyam-másolási tevékenység forrásában vagy célhelyén, majd válassza ki a JSON-t a Fájlformátum legördülő listájában. Válassza a Gépház a formátum további konfigurálásához.

Screenshot showing file format settings.

JSON formátum forrásként

Miután kiválasztotta a Gépház a Fájlformátum szakaszban, a következő tulajdonságok jelennek meg az előugró Fájlformátum beállításai párbeszédpanelen.

Screenshot showing JSON file format source.

  • Tömörítés típusa: Válassza ki a JSON-fájlok olvasásához használt tömörítési kodeket a legördülő listában. Választhat a Nincs, a bzip2, a gzip, a deflát, a ZipDeflate, a TarGzip vagy a tar közül.

    Ha tömörítési típusként a ZipDeflate lehetőséget választja, a Zip-fájlnév megőrzése mappaként a Forrás lap Speciális beállításai alatt jelenik meg.

    • Zip-fájlnév megőrzése mappaként: Azt jelzi, hogy a másolás során meg kell-e őrizni a forrás zip-fájl nevét mappaszerkezetként.
      • Ha ez a jelölőnégyzet be van jelölve (alapértelmezett), a szolgáltatás kibontott fájlokat ír a fájlba <specified file path>/<folder named as source zip file>/.
      • Ha ez a jelölőnégyzet nincs bejelölve, a szolgáltatás a kibontott fájlokat közvetlenül a fájlba <specified file path>írja. Győződjön meg arról, hogy nincsenek ismétlődő fájlnevek a különböző forrás zip-fájlokban, hogy elkerülje a versenyzést vagy a váratlan viselkedést.

    Ha a TarGzip/tar formátumot választja tömörítési típusként, a Tömörítési fájlnév megőrzése mappaként a Forrás lap Speciális beállításai alatt jelenik meg.

    • A tömörítési fájl nevének megőrzése mappaként: Azt jelzi, hogy a forrásként tömörített fájlnevet mappaszerkezetként szeretné-e megőrizni a másolás során.
      • Ha ez a jelölőnégyzet be van jelölve (alapértelmezett), a szolgáltatás tömörített fájlokat ír a fájlba <specified file path>/<folder named as source compressed file>/.
      • Ha ez a jelölőnégyzet nincs bejelölve, a szolgáltatás közvetlenül <specified file path>ide írja a tömörített fájlokat. Győződjön meg arról, hogy nem duplikált fájlnevek szerepelnek a különböző forrásfájlokban, hogy elkerülje a versenyzést vagy a váratlan viselkedést.
  • Tömörítési szint: A tömörítési arány. Választhat a Leggyorsabb vagy az Optimális lehetőség közül.

    • Leggyorsabb: A tömörítési műveletnek a lehető leggyorsabban végre kell hajtania, még akkor is, ha az eredményül kapott fájl nincs optimálisan tömörítve.

    • Optimális: A tömörítési műveletet optimálisan kell tömöríteni, még akkor is, ha a művelet végrehajtása hosszabb időt vesz igénybe. További információt a Tömörítési szint című cikkben talál.

  • Kódolás: Adja meg a tesztfájlok olvasásához használt kódolási típust. Válasszon egy típust a legördülő listából. Az alapértelmezett érték az UTF-8.

JSON formátum célként

A Gépház kiválasztása után a következő tulajdonságok jelennek meg az előugró fájlformátum beállításai párbeszédpanelen.

Screenshot showing JSON file format destination.

  • Tömörítés típusa: Válassza ki a JSON-fájlok írásához használt tömörítési kodeket a legördülő listában. Választhat a Nincs, a bzip2, a gzip, a deflát, a ZipDeflate, a TarGzip vagy a tar közül.

  • Tömörítési szint: A tömörítési arány. Választhat az Optimális vagy a Leggyorsabb lehetőség közül.

    • Leggyorsabb: A tömörítési műveletnek a lehető leggyorsabban végre kell hajtania, még akkor is, ha az eredményül kapott fájl nincs optimálisan tömörítve.

    • Optimális: A tömörítési műveletet optimálisan kell tömöríteni, még akkor is, ha a művelet végrehajtása hosszabb időt vesz igénybe. További információt a Tömörítési szint című cikkben talál.

  • Kódolás: Adja meg a tesztfájlok írásához használt kódolási típust. Válasszon egy típust a legördülő listából. Az alapértelmezett érték az UTF-8.

A Cél lapon a Speciális beállítások területen a következő JSON-formátumhoz kapcsolódó tulajdonságok jelennek meg.

  • Fájlminta: Adja meg az egyes JSON-fájlokban tárolt adatok mintáját. Az engedélyezett értékek a következők: Objektumok halmaza (JSON-vonalak) és objektumtömbök. Az alapértelmezett érték az objektumkészlet. A mintákkal kapcsolatban lásd a JSON-fájlminták című szakaszt.

JSON-fájlminták

Az adatok JSON-fájlokból való másolásakor a másolási tevékenység automatikusan észleli és elemzi a JSON-fájlok alábbi mintáit. Amikor JSON-fájlokba ír adatokat, konfigurálhatja a fájlmintát a másolási tevékenység célhelyén.

  • I. típus: setOfObjects

    Minden fájl egyetlen objektumot, JSON-sort vagy összefűzött objektumot tartalmaz.

    • példa egy objektumot tartalmazó JSON-fájlra

      {
          "time": "2015-04-29T07:12:20.9100000Z",
          "callingimsi": "466920403025604",
          "callingnum1": "678948008",
          "callingnum2": "567834760",
          "switch1": "China",
          "switch2": "Germany"
      }
      
    • JSON-sorok (alapértelmezett cé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"}
      
    • példa összefűzött JSON-fájlra

      {
          "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. típus: arrayOfObjects

    Minden fájl objektumok egy tömbjét tartalmazza.

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

Táblázat összefoglalása

JSON mint forrás

A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak JSON-formátum használatakor.

Név Leírás Érték Szükséges JSON-szkripttulajdonság
Fájlformátum A használni kívánt fájlformátum. JSON Igen típus (alatt datasetSettings):
Json
Tömörítés típusa A JSON-fájlok olvasásához használt tömörítési kodek. Válasszon a következők közül:
Egyik sem
bzip2
Gzip
Deflate
ZipDeflate
TarGzip
Tar
Nem típus (alatt compression):

bzip2
gzip
Deflate
ZipDeflate
TarGzip
Tar
Tömörítési szint A tömörítési arány. Leggyorsabb
Optimális
Nem szint (alatt compression):
Leggyorsabb
Optimális
Kódolás A tesztfájlok olvasásához használt kódolási típus. "UTF-8" (alapértelmezés szerint),"UTF-8 BOM nélkül", "UTF-16LE", "UTF-16BE", "UTF-32LE", "UTF-32BE", "US-ASCII", "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", "IBM865"869", "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-4", "ISO-8859-5", "ISO-8859-6", "ISO-8859-7", "ISO-8859-8", "ISO-8859-9", "ISO-8859-13", "ISO-8859-15", "WINDOWS-874", "WINDOWS-1250", "WINDOWS-1251", "WINDOWS-125 2", "WINDOWS-1253", "WINDOWS-1254", "WINDOWS-1255", "WINDOWS-1256", "WINDOWS-1257", "WINDOWS-1258" Nem encodingName
Zip-fájlnév megőrzése mappaként Azt jelzi, hogy a másolás során meg kell-e őrizni a forrás zip-fájl nevét mappastruktúraként. Kiválasztva (alapértelmezett) vagy a kijelölés megszüntetése Nem preserveZipFileNameAsFolder
(alatt compressionProperties->type as ZipDeflateReadSettings):
igaz (alapértelmezett) vagy hamis
Tömörítési fájlnév megőrzése mappaként Azt jelzi, hogy a másolás során meg kell-e őrizni a forrás tömörített fájlnevét mappaszerkezetként. Kiválasztva (alapértelmezett) vagy a kijelölés megszüntetése Nem preserveCompressionFileNameAsFolder
(alatt compressionProperties->type mint vagy TarReadSettingsTarGZipReadSettings):
igaz (alapértelmezett) vagy hamis

JSON mint cél

A másolási tevékenység Cél szakaszában a következő tulajdonságok támogatottak JSON-formátum használata esetén.

Név Leírás Érték Szükséges JSON-szkripttulajdonság
Fájlformátum A használni kívánt fájlformátum. JSON Igen típus (alatt datasetSettings):
Json
Tömörítés típusa A JSON-fájlok írásához használt tömörítési kodek. Válasszon a következők közül:
Egyik sem
bzip2
Gzip
Deflate
ZipDeflate
TarGzip
Tar
Nem típus (alatt compression):

bzip2
gzip
Deflate
ZipDeflate
TarGzip
Tar
Tömörítési szint A tömörítési arány. Leggyorsabb
Optimális
Nem szint (alatt compression):
Leggyorsabb
Optimális
Kódolás A tesztfájlok írásához használt kódolási típus. "UTF-8" (alapértelmezés szerint),"UTF-8 BOM nélkül", "UTF-16LE", "UTF-16BE", "UTF-32LE", "UTF-32BE", "US-ASCII", "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", "IBM865"869", "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-4", "ISO-8859-5", "ISO-8859-6", "ISO-8859-7", "ISO-8859-8", "ISO-8859-9", "ISO-8859-13", "ISO-8859-15", "WINDOWS-874", "WINDOWS-1250", "WINDOWS-1251", "WINDOWS-125 2", "WINDOWS-1253", "WINDOWS-1254", "WINDOWS-1255", "WINDOWS-1256", "WINDOWS-1257", "WINDOWS-1258" Nem encodingName
Fájlminta Az egyes JSON-fájlokban tárolt adatok mintáját jelzi. Objektumok készlete
Objektumok tömbje
Nem filePattern:
setOfObjects
arrayOfObjects