Mengonfigurasi REST dalam aktivitas salin
Artikel ini menguraikan cara menggunakan aktivitas salin dalam alur data untuk menyalin data dari dan ke titik akhir REST.
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.
Tiga properti pertama berikut diperlukan:
- Jenis penyimpanan data: Pilih Eksternal.
- Koneksi ion: Pilih koneksi REST dari daftar koneksi. Jika tidak ada koneksi, buat koneksi REST baru dengan memilih Baru.
- jenis Koneksi ion: Pilih REST.
- URL Relatif: URL relatif ke 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].
Di bawah Tingkat Lanjut, Anda bisa menentukan bidang berikut ini:
Metode permintaan: Metode HTTP. Nilai yang diizinkan adalah GET (default) dan POST.
Batas waktu permintaan: Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini adalah batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Nilai defaultnya 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.
Aturan penomoran halaman: Aturan penomoran halaman untuk menyusun permintaan halaman berikutnya. Lihat bagian dukungan penomoran halaman untuk detailnya.
Kolom tambahan: Tambahkan lebih banyak kolom data untuk menyimpan jalur relatif file sumber atau nilai statis. Jika Anda menggunakan nilai statis, Anda dapat menggunakan ekspresi kustom untuk menghasilkannya.
Tujuan
Properti berikut ini didukung untuk REST di bawah tab Tujuan aktivitas salin.
Tiga properti pertama berikut diperlukan:
- Jenis penyimpanan data: Pilih Eksternal.
- Koneksi ion: Pilih koneksi REST dari daftar koneksi. Jika tidak ada koneksi, buat koneksi REST baru dengan memilih Baru.
- jenis Koneksi ion: Pilih REST.
- URL Relatif: URL relatif ke 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].
Di bawah Tingkat Lanjut, Anda bisa menentukan bidang berikut ini:
Metode permintaan: Metode HTTP. Nilai yang diizinkan adalah POST (default), PUT, dan PATCH.
Batas waktu permintaan: 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 defaultnya 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].
Menulis ukuran batch: 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 Kompresi Optimal. Nilai yang diizinkan adalah None dan GZip.
Header tambahan: Header permintaan HTTP 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 berisi informasi selengkapnya tentang aktivitas salin di REST.
Informasi sumber
| Nama | Deskripsi | Nilai | Wajib | 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 tabel. 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> | No | relativeUrl |
| Metode permintaan | Metode HTTP. Nilai yang diizinkan adalah GET (default) dan POST. | • GET • POST |
No | requestMethod |
| Batas waktu permintaan | Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini adalah batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Nilai defaultnya adalah 00:01:40. | timespan | No | httpRequestTimeout |
| Interval permintaan (ms) | Waktu interval antara permintaan yang berbeda untuk beberapa halaman dalam milidetik. Nilai interval permintaan harus angka antara [10, 60000]. | [10, 60000] | No | requestInterval |
| Header tambahan | Header permintaan HTTP tambahan. | <header tambahan Anda> | No | additionalHeaders |
| Aturan penomoran halaman | Aturan penomoran halaman untuk menyusun permintaan halaman berikutnya. Lihat bagian dukungan penomoran halaman untuk detailnya. | Buka penomoran halaman | No | paginationRules |
| Kolom tambahan | Tambahkan lebih banyak kolom data ke jalur relatif file sumber penyimpanan atau nilai statis. Ekspresi didukung untuk yang terakhir. | •Nama •Nilai |
No | additionalColumns: •Nama •Nilai |
Informasi tujuan
| Nama | Deskripsi | Nilai | Wajib | 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 tabel. 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> | No | relativeUrl |
| Metode permintaan | Metode HTTP. Nilai yang diizinkan adalah POST (default), PUT, dan PATCH. | • POST • GET • PATCH |
No | requestMethod |
| Batas waktu permintaan | Batas waktu (nilai rentang waktu) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini adalah batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Nilai defaultnya adalah 00:01:40. | timespan | No | httpRequestTimeout |
| Interval permintaan (ms) | Waktu interval antara permintaan yang berbeda untuk beberapa halaman dalam milidetik. Nilai interval permintaan harus angka antara [10, 60000]. | [10, 60000] | No | requestInterval |
| Menulis ukuran batch | Jumlah rekaman yang akan ditulis ke tujuan REST per batch. Nilai default adalah 10000. | <jumlah baris> (bilangan bulat) |
No | 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 |
No | httpCompressionType |
| Header tambahan | Header permintaan HTTP tambahan. | <header tambahan Anda> | No | additionalHeaders |
Konten terkait
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk