Cara mengonfigurasi REST dalam aktivitas salin

  • Artikel

Artikel ini menguraikan cara menggunakan aktivitas salin dalam alur data untuk menyalin data dari dan ke titik akhir REST.

Penting

Microsoft Fabric saat ini dalam PRATINJAU. Informasi ini berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis. Microsoft tidak memberikan jaminan, dinyatakan atau tersirat, sehubungan dengan informasi yang diberikan di sini. Lihat dokumentasi Azure Data Factory untuk layanan di Azure.

Secara khusus, konektor REST umum ini mendukung:

  • Menyalin data dari titik akhir REST menggunakan metode GET atau POST dan menyalin data ke titik akhir REST menggunakan metode POST, PUT, atau PATCH.
  • Penomoran Halaman di REST API.
  • Untuk REST sebagai sumber, salin respons REST JSON apa adanya atau uraikan dengan menggunakan pemetaan skema. Hanya payload respons di JSON yang didukung.

Konfigurasi yang didukung

Untuk konfigurasi setiap tab di bawah aktivitas salin, buka bagian berikut masing-masing.

Umum

Untuk konfigurasi tab Umum , buka Umum.

Sumber

Properti berikut ini didukung untuk REST di bawah tab Sumber aktivitas salin.

Cuplikan layar memperlihatkan tab sumber dan daftar properti.

Tiga properti pertama berikut diperlukan:

  • Jenis penyimpanan data: Pilih Eksternal.
  • Koneksi: Pilih koneksi REST dari daftar koneksi. Jika tidak ada koneksi, buat koneksi REST baru dengan memilih Baru.
  • Jenis koneksi: Pilih REST.
  • URL Relatif: URL relatif ke sumber daya yang berisi data. Saat properti ini tidak ditentukan, hanya URL yang ditentukan dalam definisi koneksi yang digunakan. Konektor HTTP menyalin data dari URL gabungan: [URL specified in connection]/[relative URL specified].

Di bawah Tingkat Lanjut, Anda bisa menentukan bidang berikut ini:

  • Metode permintaan: Metode HTTP. Nilai yang diizinkan adalah GET (default) dan POST.

    Cuplikan layar memperlihatkan metode permintaan.

  • Waktu permintaan habis: Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini merupakan batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Nilai default adalah 00:01:40.

  • Interval permintaan (ms): Waktu interval antara permintaan yang berbeda untuk beberapa halaman dalam milidetik. Nilai interval permintaan harus angka antara [10, 60000].

  • Header tambahan: Header permintaan HTTP tambahan.

    Cuplikan layar memperlihatkan header tambahan.

  • Aturan penomoran halaman: Aturan penomoran halaman untuk menyusun permintaan halaman berikutnya. Lihat bagian dukungan penomoran halaman untuk detailnya.

    Cuplikan layar memperlihatkan aturan penomoran halaman.

  • Kolom tambahan: Tambahkan lebih banyak kolom data untuk menyimpan jalur relatif atau nilai statis file sumber. Ekspresi didukung untuk yang terakhir.

    Cuplikan layar memperlihatkan kolom tambahan.

Tujuan

Properti berikut ini didukung untuk REST di bawah tab Tujuan aktivitas salin.

Cuplikan layar memperlihatkan tab tujuan.

Tiga properti pertama berikut diperlukan:

  • Jenis penyimpanan data: Pilih Eksternal.
  • Koneksi: Pilih koneksi REST dari daftar koneksi. Jika tidak ada koneksi, buat koneksi REST baru dengan memilih Baru.
  • Jenis koneksi: Pilih REST.
  • URL Relatif: URL relatif ke sumber daya yang berisi data. Saat properti ini tidak ditentukan, hanya URL yang ditentukan dalam definisi koneksi yang digunakan. Konektor HTTP menyalin data dari URL gabungan: [URL specified in connection]/[relative URL specified].

Di bawah Tingkat Lanjut, Anda bisa menentukan bidang berikut ini:

  • Metode permintaan: Metode HTTP. Nilai yang diizinkan adalah POST (default), PUT, dan PATCH.

  • Waktu permintaan habis: Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini adalah waktu habis untuk mendapatkan respons, bukan waktu habis untuk menulis data. Nilai default adalah 00:01:40.

  • Interval permintaan (ms): Waktu interval antara permintaan yang berbeda untuk beberapa halaman dalam milidetik. Nilai interval permintaan harus angka antara [10, 60000].

  • Ukuran batch tulis: Jumlah rekaman yang akan ditulis ke tujuan REST per batch. Nilai default adalah 10000.

  • Jenis Kompresi Http: Jenis kompresi HTTP untuk digunakan saat mengirim data dengan Tingkat Pemadatan Optimal. Nilai yang diizinkan adalah None dan GZip.

  • Header tambahan: Header permintaan HTTP tambahan.

    Cuplikan layar memperlihatkan header tambahan.

Pemetaan

Untuk konfigurasi tab Pemetaan , buka Mengonfigurasi pemetaan Anda di bawah tab pemetaan. Pemetaan tidak didukung ketika sumber dan tujuan adalah data hierarkis.

Pengaturan

Untuk konfigurasi tab Pengaturan , buka Mengonfigurasi pengaturan Anda yang lain di bawah tab pengaturan.

Ringkasan tabel

Tabel berikut ini berisi informasi selengkapnya tentang aktivitas salin di REST.

Informasi sumber

Nama Deskripsi Nilai Diperlukan Properti skrip JSON
Jenis penyimpanan data Jenis penyimpanan data Anda. • Ruang kerja
• Eksternal
• Himpunan data sampel
 Ya jenis
Koneksi Koneksi Anda ke penyimpanan data sumber. <koneksi Anda> Ya koneksi
Tipe sambungan Jenis koneksi Anda. Pilih REST. REST Ya Jenis:
RestResource
URL Relatif URL relatif terhadap sumber daya yang berisi data. Ketika properti ini tidak ditentukan, hanya URL yang ditentukan dalam definisi koneksi yang digunakan. Konektor HTTP menyalin data dari URL gabungan: [URL specified in connection]/[relative URL specified]. <url relatif Anda> Tidak relativeUrl
Metode permintaan Metode HTTP. Nilai yang diizinkan adalah GET (default) dan POST. • GET
• POST		 Tidak requestMethod
Waktu permintaan habis Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini merupakan batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Nilai default adalah 00:01:40. rentangwaktu Tidak httpRequestTimeout
Interval permintaan (md) Waktu interval antara permintaan yang berbeda untuk beberapa halaman dalam milidetik. Nilai interval permintaan harus angka antara [10, 60000]. [10, 60000] Tidak requestInterval
Header tambahan Header permintaan HTTP tambahan. <header tambahan Anda> Tidak additionalHeaders
Aturan penomoran halaman Aturan penomoran halaman untuk menyusun permintaan halaman berikutnya. Lihat bagian dukungan penomoran halaman untuk detailnya. Buka penomoran halaman Tidak paginationRules
Kolom tambahan Tambahkan lebih banyak kolom data ke jalur relatif atau nilai statis file sumber penyimpanan. Ekspresi didukung untuk yang terakhir. •Nama
•Nilai		 Tidak additionalColumns:
•Nama
•Nilai

Informasi tujuan

Nama Deskripsi Nilai Diperlukan Properti skrip JSON
Jenis penyimpanan data Jenis penyimpanan data Anda. • Ruang kerja
• Eksternal		 Ya jenis
Koneksi Koneksi Anda ke penyimpanan data sumber. <koneksi Anda> Ya koneksi
Tipe sambungan Jenis koneksi Anda. Pilih REST. REST Ya Jenis:
RestResource
URL Relatif URL relatif terhadap sumber daya yang berisi data. Ketika properti ini tidak ditentukan, hanya URL yang ditentukan dalam definisi koneksi yang digunakan. Konektor HTTP menyalin data dari URL gabungan: [URL specified in connection]/[relative URL specified]. <url relatif Anda> Tidak relativeUrl
Metode permintaan Metode HTTP. Nilai yang diizinkan adalah POST (default), PUT, dan PATCH. • POST
• GET
• PATCH		 Tidak requestMethod
Waktu permintaan habis Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini merupakan batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Nilai default adalah 00:01:40. rentangwaktu Tidak httpRequestTimeout
Interval permintaan (md) Waktu interval antara permintaan yang berbeda untuk beberapa halaman dalam milidetik. Nilai interval permintaan harus angka antara [10, 60000]. [10, 60000] Tidak requestInterval
Menulis ukuran batch Jumlah rekaman yang akan ditulis ke tujuan REST per batch. Nilai default adalah 10000. <jumlah baris>
(bilangan bulat)		 Tidak writeBatchSize
Jenis Kompresi Http Jenis kompresi HTTP untuk digunakan saat mengirim data dengan Tingkat Kompresi Optimal. Nilai yang diizinkan adalah None dan GZip. • Tidak ada
• GZip		 Tidak httpCompressionType
Header tambahan Header permintaan HTTP tambahan. <header tambahan Anda> Tidak additionalHeaders

Langkah berikutnya