Mengonfigurasi Azure Cosmos DB untuk NoSQL dalam aktivitas salin

Artikel ini menguraikan cara menggunakan aktivitas salin dalam alur data untuk menyalin data dari dan ke Azure Cosmos DB untuk NoSQL.

Konfigurasi yang didukung

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

• Umum
• Sumber
• Tujuan
• Pemetaan
• Pengaturan

Umum

Lihat panduan Pengaturan umum untuk mengonfigurasi tab Pengaturan umum.

Sumber

Properti berikut ini didukung untuk Azure Cosmos DB untuk NoSQL di bawah tab Sumber aktivitas salin.

Tiga properti berikut diperlukan:

• Jenis penyimpanan data: Pilih Eksternal.
• Koneksi ion: Pilih azure Cosmos DB untuk koneksi NoSQL dari daftar koneksi. Jika tidak ada koneksi, buat Azure Cosmos DB baru untuk koneksi NoSQL dengan memilih Baru.
• Kontainer: Pilih kontainer yang ingin Anda gunakan. Pilih Edit untuk memasukkan nama kontainer secara manual.

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

• Gunakan kueri: Anda bisa memilih Tabel atau Kueri sebagai kueri penggunaan Anda. Daftar berikut menjelaskan konfigurasi setiap pengaturan.

  • Tabel: Membaca data dari tabel yang Anda tentukan dalam Tabel.

  • Kueri: Menentukan kueri Azure Cosmos DB untuk membaca data.

    

• Ukuran halaman: Jumlah dokumen per halaman hasil kueri. Defaultnya adalah "-1", yang berarti menggunakan ukuran halaman dinamis sisi layanan hingga 1000.

• Mendeteksi tanggalwaktu: Apakah akan mendeteksi tanggalwaktu dari nilai string dalam dokumen. Nilai yang diizinkan adalah: benar (default), salah.

• Wilayah pilihan: Daftar wilayah pilihan untuk disambungkan saat mengambil data dari Azure Cosmos DB. Pilih satu wilayah pilihan dari daftar drop-down setelah memilih Baru.

  

• Kolom tambahan: Tambahkan kolom data tambahan untuk menyimpan jalur relatif file sumber atau nilai statis. Ekspresi didukung untuk yang terakhir. Untuk informasi selengkapnya, buka Menambahkan kolom tambahan selama penyalinan.

  

Tujuan

Properti berikut ini didukung untuk Azure Cosmos DB untuk NoSQL di bawah tab Tujuan dari aktivitas salin.

Tiga properti berikut diperlukan:

• Jenis penyimpanan data: Pilih Eksternal.
• Koneksi ion: Pilih azure Cosmos DB untuk koneksi NoSQL dari daftar koneksi.
• Kontainer: Pilih Telusuri untuk memilih file yang ingin Anda salin, atau isi jalur secara manual.

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

• Perilaku tulis: Menentukan perilaku tulis saat tujuan adalah file dari penyimpanan data berbasis file. Anda dapat memilih Tambahkan konten dinamis, Sisipkan, atau Upsert dari daftar drop-down.

  • Menambahkan konten dinamis: Buka panel Tambahkan konten dinamis. Ini membuka penyusun ekspresi tempat Anda dapat membangun ekspresi dari variabel sistem yang didukung, output aktivitas, fungsi, dan variabel atau parameter yang ditentukan pengguna. Untuk informasi tentang bahasa ekspresi, buka Ekspresi dan fungsi.

  • Sisipkan: Pilih opsi ini jika data sumber Anda memiliki sisipan.

  • Upsert: Perilaku upsert adalah mengganti dokumen jika dokumen dengan ID yang sama sudah ada; jika tidak, sisipkan dokumen.

    

• Tulis batas waktu batch: Waktu tunggu hingga operasi penyisipan batch selesai sebelum waktu habis. Nilai yang diizinkan adalah Timespan. Contohnya adalah 00:30:00 (30 menit).

• Menulis ukuran batch: Tentukan jumlah baris yang akan disisipkan ke dalam tabel SQL per batch. Nilai yang diizinkan adalah bilangan bulat (jumlah baris). Secara default, layanan secara dinamis menentukan ukuran batch yang sesuai berdasarkan ukuran baris.

• Koneksi bersamaan maksimum: Batas atas koneksi bersamaan yang dibuat ke penyimpanan data selama aktivitas berjalan. Menentukan nilai hanya saat Anda ingin membatasi koneksi bersamaan.

• Nonaktifkan analitik metrik performa: Pengaturan ini mengontrol pengumpulan metrik, seperti DTU, DWU, RU, dan sebagainya untuk pengoptimalan dan rekomendasi performa salin. Jika Anda khawatir dengan perilaku ini, nonaktifkan fitur ini.

Pemetaan

Untuk konfigurasi tab Pemetaan, buka Mengonfigurasi pemetaan Anda di bawah tab pemetaan.

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 Azure Cosmos DB for NoSQL.

Tabel sumber

Nama	Deskripsi	Nilai	Wajib	Properti skrip JSON
Jenis penyimpanan data	Jenis penyimpanan data Anda.	Eksternal	Ya	/
Koneksi	Koneksi Anda ke penyimpanan data sumber.	<koneksi Anda>	Ya	koneksi
Kontainer	Kontainer data sumber Anda.	<kontainer sumber Anda>	Ya	Wadah fileName
Menggunakan kueri	Anda bisa memilih Tabel atau Kueri sebagai kueri penggunaan Anda.	• Tabel • Kueri	No	jenis
Ukuran halaman	Jumlah dokumen per halaman hasil kueri. Defaultnya adalah "-1", yang berarti menggunakan ukuran halaman dinamis sisi layanan hingga 1000.	<Ukuran Halaman Anda>	No	pageSize
Menghapus tanggalwaktu	File pada penyimpanan data sumber akan dihapus tepat setelah dipindahkan ke penyimpanan tujuan. Penghapusan file adalah per file, jadi ketika aktivitas penyalinan gagal, Anda akan mencatat bahwa beberapa file telah disalin ke tujuan dan dihapus dari sumber sementara yang lain masih berada di penyimpanan sumber.	Dipilih atau tidak dipilih	No	detectDatetime
Wilayah pilihan	Daftar wilayah pilihan untuk disambungkan saat mengambil data dari Azure Cosmos DB. Pilih satu wilayah pilihan dari daftar drop-down setelah memilih Baru.	<wilayah pilihan Anda>	No	preferredRegions
Kolom tambahan	Tambahkan kolom data tambahan untuk menyimpan jalur relatif file sumber atau nilai statis. Ekspresi didukung untuk yang terakhir. Untuk informasi selengkapnya, buka Menambahkan kolom tambahan selama penyalinan.	<koneksi bersamaan maks>	No	additionalColumns

Tabel tujuan

Nama	Deskripsi	Nilai	Wajib	Properti skrip JSON
Jenis penyimpanan data	Jenis penyimpanan data Anda.	Eksternal	Ya	/
Koneksi	Koneksi Anda ke penyimpanan data tujuan.	<koneksi Anda>	Ya	koneksi
Kontainer	Kontainer data tujuan Anda.	<kontainer sumber>	Ya	Wadah fileName
Perilaku tulis	Menjelaskan cara menulis data ke Azure Cosmos DB. Nilai yang diperbolehkan sisipkan dan upsert. Perilaku upsert bertujuan mengganti dokumen jika dokumen dengan ID yang sama sudah ada; jika tidak, sisipkan dokumen.	• Tambahkan konten dinamis • Sisipkan • Upsert	No	writeBehavior
Menulis batas waktu batch	Waktu tunggu hingga operasi penyisipan batch selesai sebelum waktu habis. Nilai yang diizinkan adalah Timespan. Contohnya adalah 00:30:00 (30 menit).	timespan	No	writeBatchTimeout
Menulis ukuran batch	Jumlah baris yang akan disisipkan ke dalam tabel SQL per batch. Nilai yang diizinkan adalah bilangan bulat (jumlah baris). Secara default, layanan secara dinamis menentukan ukuran batch yang sesuai berdasarkan ukuran baris.	<jumlah baris > (bilangan bulat)	No	writeBatchSize
Koneksi bersamaan maks	Batas atas koneksi bersamaan yang ditetapkan ke penyimpanan data selama eksekusi aktivitas. Menentukan nilai hanya saat Anda ingin membatasi koneksi bersamaan.	<koneksi bersamaan maks>	No	maxConcurrentConnections
Menonaktifkan analitik metrik performa	Pengaturan ini mengontrol pengumpulan metrik seperti DTU, DWU, RU, dan sebagainya untuk pengoptimalan dan rekomendasi performa salin. Jika Anda khawatir dengan perilaku ini, nonaktifkan fitur ini.	Dipilih atau tidak dipilih	No	disableMetricsCollection

Konten terkait

• Menyiapkan Azure Cosmos DB anda untuk koneksi NoSQL