Format JSON di Data Factory di Microsoft Fabric

Artikel ini menguraikan cara mengonfigurasi format JSON dalam alur 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 Gen2
Azure Files
Sistem file
FTP
Google Cloud Storage
HTTP
File Lakehouse
Penyimpanan Cloud Oracle
SFTP
Aktivitas yang didukung Aktivitas Menyalin (sumber/tujuan)
Aktivitas pencarian
Aktivitas GetMetadata
Hapus aktivitas

Format JSON dalam aktivitas salin

Untuk mengonfigurasi format JSON, pilih koneksi Anda di sumber atau tujuan aktivitas salin alur, 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 berkas 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-properti berikut didukung di bagian Sumber aktivitas salin saat menggunakan format JSON.

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

bzip2
gzip
Memampatkan
ZipDeflate
TarGzip
tar
Tingkat pemadatan Rasio kompresi. Tercepat
Optimal
Tidak level (di bawah compression):
Tercepat
Optimum
Pengkodean Jenis pengodean yang digunakan untuk membaca file pengujian. "UTF-8" (sebagai 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", "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-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" Tidak namaEnkode
Pertahankan nama file zip sebagai folder Menunjukkan apakah akan mempertahankan nama file zip sumber sebagai struktur folder selama penyalinan. Dipilih (default) atau tidak dipilih Tidak preserveZipFileNameAsFolder
(di bawah compressionProperties->type sebagai ZipDeflateReadSettings):
benar (default) atau salah
Pertahankan nama file kompresi sebagai folder Menunjukkan apakah akan mempertahankan nama file terkompresi sumber sebagai struktur folder selama penyalinan. Dipilih (default) atau tidak dipilih Tidak preserveCompressionFileNameAsFolder
(di bawah compressionProperties->type sebagai TarGZipReadSettings atau TarReadSettings):
benar (default) atau salah

JSON sebagai tujuan

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

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

bzip2
gzip
Memampatkan
ZipDeflate
TarGzip
tar
Tingkat pemadatan Rasio kompresi. Tercepat
Optimal
Tidak level (di bawah compression):
Tercepat
Optimum
Pengkodean Jenis pengodean yang digunakan untuk menulis file pengujian. "UTF-8" (sebagai 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", "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-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" Tidak namaEnkode
Pola berkas Tunjukkan pola data yang disimpan di setiap file JSON. Set objek
Array objek
Tidak filePattern:
setOfObjects
arrayOfObjects