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.

Category	Koneksi/Aktivitas
Konektor yang didukung	Amazon S3
	Azure Blob Storage
	Azure Data Lake Storage Gen1
	Azure Data Lake Storage Gen2
	FTP
	Penyimpanan Cloud Google
	HTTP
	SFTP
Aktivitas yang didukung	Aktivitas Salin
	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.

Format JSON sebagai sumber

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

• 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 ini diperlihatkan dalam kotak dialog pengaturan format file pop-up.

• 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 Tar	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 Tar	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

Konten terkait

• Gambaran umum Koneksi ors