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.
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 kotak ini dicentang (default), layanan menulis file yang tidak di-zip ke
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.
- Jika kotak ini dicentang (default), layanan menulis file yang didekompresi ke
- Mempertahankan nama file zip sebagai folder: Menunjukkan apakah akan mempertahankan nama file zip sumber sebagai struktur folder selama penyalinan.
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.
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 |