Bagikan melalui


Format JSON di Data Factory di Microsoft Fabric

Artikel ini menguraikan cara mengonfigurasi format JSON dalam alur data Data Factory di Microsoft Fabric.

Kemampuan yang didukung

Format JSON didukung untuk aktivitas dan konektor berikut sebagai sumber dan tujuan.

Kategori Konektor/Aktivitas
Konektor yang didukung Amazon S3
Kompatibel dengan Amazon S3
Azure Blob Storage
Azure Data Lake Storage Gen1
Azure Data Lake Storage Gen2
Azure Files
Sistem file
FTP
Penyimpanan Cloud Google
HTTP
File Lakehouse
Penyimpanan Cloud Oracle
SFTP
Aktivitas yang didukung Aktivitas salin (sumber/tujuan)
Aktivitas pencarian
Aktivitas GetMetadata
Aktivitas penghapusan

Format JSON dalam aktivitas salin

Untuk mengonfigurasi format JSON, pilih koneksi Anda di sumber atau tujuan aktivitas salin alur data, lalu pilih JSON di daftar drop-down format File. Pilih Pengaturan untuk konfigurasi lebih lanjut dari format ini.

Cuplikan layar memperlihatkan pengaturan format file.

Format JSON sebagai sumber

Setelah Anda memilih Pengaturan di bagian Format file, properti berikut ini diperlihatkan dalam kotak dialog pengaturan format file pop-up.

Cuplikan layar memperlihatkan sumber format file JSON.

  • Jenis kompresi: Pilih codec kompresi yang digunakan untuk membaca file JSON di daftar drop-down. Anda dapat memilih dari None, bzip2, gzip, deflate, ZipDeflate, TarGzip, atau tar.

    Jika Anda memilih ZipDeflate sebagai jenis kompresi, Pertahankan nama file zip sebagai folder ditampilkan di bawah pengaturan Tingkat Lanjut di tab Sumber .

    • Mempertahankan nama file zip sebagai folder: Menunjukkan apakah akan mempertahankan nama file zip sumber sebagai struktur folder selama penyalinan.
      • Jika kotak ini dicentang (default), layanan menulis file yang tidak di-zip ke <specified file path>/<folder named as source zip file>/.
      • Jika kotak ini tidak dicentang, layanan menulis file yang tidak di-zip langsung ke <specified file path>. Pastikan Anda tidak memiliki nama file duplikat dalam file zip sumber yang berbeda untuk menghindari persaingan atau perilaku tak terduga.

    Jika Anda memilih TarGzip/tar sebagai jenis kompresi, Pertahankan nama file kompresi sebagai folder ditampilkan di bawah pengaturan Tingkat Lanjut di tab Sumber .

    • Mempertahankan nama file kompresi sebagai folder: Menunjukkan apakah akan mempertahankan nama file terkompresi sumber sebagai struktur folder selama penyalinan.
      • Jika kotak ini dicentang (default), layanan menulis file yang didekompresi ke <specified file path>/<folder named as source compressed file>/.
      • Jika kotak ini tidak dicentang, layanan menulis file yang didekompresi langsung ke <specified file path>. Pastikan Anda tidak memiliki nama file duplikat di file sumber yang berbeda untuk menghindari persaingan atau perilaku yang tidak terduga.
  • Tingkat kompresi: Rasio kompresi. Anda dapat memilih dari Tercepat atau Optimal.

    • Tercepat: Operasi kompresi harus selesai secepat mungkin, bahkan jika file yang dihasilkan tidak dikompresi secara optimal.

    • Optimal: Operasi pemadatan akan dipadatkan secara optimal, bahkan jika operasi membutuhkan waktu lebih lama untuk menyelesaikannya. Untuk informasi selengkapnya, buka artikel Tingkat Kompresi.

  • Pengodean: Tentukan jenis pengodean yang digunakan untuk membaca file pengujian. Pilih satu jenis dari daftar drop-down. Nilai defaultnya adalah UTF-8.

Format JSON sebagai tujuan

Setelah Anda memilih Pengaturan, properti berikut diperlihatkan dalam kotak dialog pengaturan format file pop-up.

Cuplikan layar memperlihatkan tujuan format file JSON.

  • Jenis kompresi: Pilih codec kompresi yang digunakan untuk menulis file JSON di daftar drop-down. Anda dapat memilih dari None, bzip2, gzip, deflate, ZipDeflate, TarGzip, atau tar.

  • Tingkat kompresi: Rasio kompresi. Anda dapat memilih dari Optimal atau Tercepat.

    • Tercepat: Operasi kompresi harus selesai secepat mungkin, bahkan jika file yang dihasilkan tidak dikompresi secara optimal.

    • Optimal: Operasi pemadatan akan dipadatkan secara optimal, bahkan jika operasi membutuhkan waktu lebih lama untuk menyelesaikannya. Untuk informasi selengkapnya, buka artikel Tingkat Kompresi.

  • Pengodean: Tentukan jenis pengodean yang digunakan untuk menulis file pengujian. Pilih satu jenis dari daftar drop-down. Nilai defaultnya adalah UTF-8.

Di bawah Pengaturan tingkat lanjut di tab Tujuan , properti terkait format JSON berikut ditampilkan.

  • Pola file: Tentukan pola data yang disimpan di setiap file JSON. Nilai yang diizinkan adalah: Sekumpulan objek (Garis JSON) dan Array objek. Nilai defaultnya adalah Sekumpulan objek. Lihat bagian Pola file JSON untuk detail tentang pola ini.

Pola file JSON

Saat menyalin data dari file JSON, aktivitas salin dapat secara otomatis mendeteksi dan memilah pola file JSON berikut. Saat menulis data ke file JSON, Anda dapat mengonfigurasi pola file pada tujuan aktivitas salin.

  • Jenis I: setOfObjects

    Setiap file berisi objek tunggal, baris JSON, atau objek gabungan.

    • contoh JSON objek tunggal

      {
          "time": "2015-04-29T07:12:20.9100000Z",
          "callingimsi": "466920403025604",
          "callingnum1": "678948008",
          "callingnum2": "567834760",
          "switch1": "China",
          "switch2": "Germany"
      }
      
    • Baris JSON (default untuk tujuan)

      {"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"}
      
    • contoh JSON yang digabungkan

      {
          "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"
      }
      
  • Jenis II: arrayOfObjects

    Setiap file berisi array objek.

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

Ringkasan tabel

JSON sebagai sumber

Properti berikut ini didukung di bagian Sumber aktivitas salin saat menggunakan format JSON.

Nama Deskripsi Nilai Wajib Properti skrip JSON
Format file Format file yang ingin Anda gunakan. JSON Ya type (di bawah datasetSettings):
Json
Jenis pemadatan Codec kompresi yang digunakan untuk membaca file JSON. Pilih dari:
Tidak
bzip2
gzip
Mengempis
ZipDeflate
TarGzip
ter
No type (di bawah compression):

bzip2
gzip
Mengempis
ZipDeflate
TarGzip
tar
Tingkat pemadatan Rasio pemadatan. Tercepat
Optimal
No level (di bawah compression):
Tercepat
Optimal
Pengodean Jenis pengodean yang digunakan untuk membaca file pengujian. "UTF-8" (secara default),"UTF-8 tanpa BOM", "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", "IBM860", "IBM861", "IBM863", "IBM864", "IBM860"M865", "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-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-1252", "WINDOWS-1253", "WINDOWS-1254", "WINDOWS-1255", "WINDOWS-1256", "WINDOWS-1257", "WINDOWS-1258" Tanpa encodingName
Pertahankan nama file zip sebagai folder Menunjukkan apakah akan mempertahankan nama file zip sumber sebagai struktur folder selama penyalinan. Dipilih (default) atau batal pilih No preserveZipFileNameAsFolder
(di bawah compressionProperties->type sebagai ZipDeflateReadSettings):
true (default) atau false
Pertahankan nama file kompresi sebagai folder Menunjukkan apakah akan mempertahankan nama file terkompresi sumber sebagai struktur folder selama penyalinan. Dipilih (default) atau batal pilih No preserveCompressionFileNameAsFolder
(di bawah compressionProperties->type sebagai TarGZipReadSettings atau TarReadSettings):
true (default) atau false

JSON sebagai tujuan

Properti berikut ini didukung di bagian Tujuan aktivitas salin saat menggunakan format JSON.

Nama Deskripsi Nilai Wajib Properti skrip JSON
Format file Format file yang ingin Anda gunakan. JSON Ya type (di bawah datasetSettings):
Json
Jenis pemadatan Codec kompresi yang digunakan untuk menulis file JSON. Pilih dari:
Tidak
bzip2
gzip
Mengempis
ZipDeflate
TarGzip
ter
No type (di bawah compression):

bzip2
gzip
Mengempis
ZipDeflate
TarGzip
tar
Tingkat pemadatan Rasio pemadatan. Tercepat
Optimal
No level (di bawah compression):
Tercepat
Optimal
Pengodean Jenis pengodean yang digunakan untuk menulis file pengujian. "UTF-8" (secara default),"UTF-8 tanpa BOM", "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", "IBM860", "IBM861", "IBM863", "IBM864", "IBM860"M865", "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-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-1252", "WINDOWS-1253", "WINDOWS-1254", "WINDOWS-1255", "WINDOWS-1256", "WINDOWS-1257", "WINDOWS-1258" Tanpa encodingName
Pola file Tunjukkan pola data yang disimpan di setiap file JSON. Set objek
Array objek
No filePattern:
setOfObjects
arrayOfObjects