Menghubungkan ke Azure Synapse Link untuk Azure Cosmos DB

Artikel ini menjelaskan cara mengakses database Azure Cosmos DB dari studio Azure Synapse Analytics dengan Synapse Link.

Prasyarat

Sebelum Anda menghubungkan akun Azure Cosmos DB ke ruang kerja Anda, ada beberapa hal yang Anda butuhkan.

  • Akun DB Azure Cosmos yang sudah ada atau buat akun baru setelah mulai cepat ini
  • Ruang kerja Synapse yang ada atau buat ruang kerja baru mengikuti mulai cepat ini

Azure Cosmos DB Analytical Store

Untuk menjalankan analitik skala besar ke Azure Cosmos DB tanpa memengaruhi kinerja operasional Anda, sebaiknya mengaktifkan Synapse Link for Azure Cosmos DB. Fungsi ini membawa kemampuan HTAP ke kontainer dan dukungan bawaan di Azure Synapse. Ikuti mulai cepat ini untuk mengaktifkan Synapse Link untuk kontainer Azure Cosmos DB.

Dari ruang kerja Synapse Anda, pilih Luncurkan Studio Synapse. Pada halaman beranda Synapse Studio, pilih **Data, yang akan membawa Anda ke Data Object Explorer.

Menyambungkan database Azure Cosmos DB Anda ke ruang kerja Synapse

Menghubungkan database Azure Cosmos DB dilakukan sebagai layanan tertaut. Layanan tertaut Azure Cosmos DB memungkinkan pengguna menelusuri dan menjelajahi data, membaca, dan menulis dari Apache Spark untuk Azure Synapse Analytics atau SQL ke Azure Cosmos DB.

Dari Data Object Explorer, Anda bisa langsung menyambungkan database Azure Cosmos DB dengan melakukan langkah-langkah berikut:

  1. Pilih + ikon di dekat Data
  2. Pilih Sambungkan ke data eksternal
  3. Pilih API yang ingin Anda sambungkan: SQL atau MongoDB
  4. Pilih Lanjutkan
  5. Nama layanan yang ditautkan. Nama akan ditampilkan di Object Explorer dan digunakan oleh run-times Synapse untuk menyambungkan ke database dan kontainer. Sebaiknya gunakan nama yang ramah.
  6. Pilih nama akun dan nama databaseCosmos DB
  7. (Opsional) Jika tidak ada wilayah yang ditentukan, operasi run-time Synapse akan dialihkan ke wilayah terdekat tempat penyimpanan analitik diaktifkan. Namun, Anda dapat mengatur secara manual wilayah tempat Anda ingin pengguna mengakses penyimpanan analitik Azure Cosmos DB. Pilih Properti koneksi tambahan lalu Baru. Pada bagian Nama Properti, tulis PreferredRegions dan atur Nilai ke wilayah yang Anda inginkan (contoh: WestUS2, tidak ada spasi antara kata dan angka)
  8. Pilih Buat

Database DB Azure Cosmos terlihat di bawah tab Tertaut di bagian Azure Cosmos DB. Anda dapat membedakan kontainer DB Azure Cosmos yang diaktifkan HTAP dari kontainer hanya OLTP dengan ikon berikut:

Wadah synapse:

Kontainer HTAP

Kontainer hanya OLTP:

Kontainer OLTP

Berinteraksi dengan cepat dengan tindakan yang dihasilkan kode

Saat mengeklik kanan ke dalam wadah, Anda akan memiliki daftar gerakan yang akan memicu run-time Spark atau SQL. Menulis ke dalam wadah akan terjadi melalui Toko Transaksional Azure Cosmos DB dan akan mengkonsumsi Unit Permintaan.

Langkah berikutnya