Mulai cepat: Merespons perubahan database di Azure Cosmos DB menggunakan Azure Functions

Di Panduan Cepat ini, Anda menggunakan Visual Studio Code untuk membuat aplikasi yang merespons perubahan dalam NoSQL database di Azure Cosmos DB. Setelah menguji kode secara lokal, Anda menyebarkannya ke aplikasi fungsi tanpa server baru yang Anda buat berjalan dalam paket Konsumsi Flex di Azure Functions.

Sumber proyek menggunakan ekstensi Azure Developer CLI (azd) dengan Visual Studio Code untuk menyederhanakan inisialisasi dan verifikasi kode proyek Anda secara lokal, serta dan menyebarkan kode Anda ke Azure. Penyebaran ini mengikuti praktik terbaik saat ini untuk penyebaran Azure Functions yang aman dan dapat diskalakan.

Penting

Saat menanggapi perubahan dalam database Azure Cosmos DB No SQL didukung untuk semua bahasa, skenario mulai cepat ini saat ini hanya memiliki contoh untuk C#, Python, dan TypeScript. Untuk menyelesaikan panduan cepat ini, di bagian atas artikel, pilih salah satu bahasa yang didukung.

Prasyarat

Sebuah akun Azure dengan langganan aktif. Buat akun secara gratis.
Visual Studio Code di salah satu platform yang didukung.
Ekstensi Azure Functions untuk Visual Studio Code. Ekstensi ini memerlukan Azure Functions Core Tools. Ketika alat ini tidak tersedia secara lokal, ekstensi mencoba menginstalnya dengan menggunakan alat penginstal berbasis paket. Anda juga dapat menginstal atau memperbarui paket Core Tools dengan menjalankan Azure Functions: Install or Update Azure Functions Core Tools dari palet perintah. Jika Anda tidak menginstal npm atau Homebrew di komputer lokal, Anda harus menginstal atau memperbarui Core Tools secara manual.

.NET 8.0 SDK
Ekstensi C# untuk Visual Studio Code.

Node.js 18.x atau lebih tinggi. Gunakan perintah node --version untuk memeriksa versi Anda.

Versi Python yang didukung oleh Azure Functions. Untuk informasi selengkapnya, lihat Cara memasang Phyton.
Ekstensi Python untuk Visual Studio Code.

Ekstensi Azure Developer CLI untuk Visual Studio Code.

Menginisialisasi proyek

Anda dapat menggunakan azd init perintah dari palet perintah untuk membuat proyek kode Azure Functions lokal dari templat.

Di Visual Studio Code, buka folder atau ruang kerja tempat Anda ingin membuat proyek.
Tekan F1 untuk membuka palet perintah, cari dan jalankan perintah Azure Developer CLI (azd): Initialize App (init), lalu pilih Pilih templat.

Mungkin ada sedikit penundaan saat azd menginisialisasi folder atau ruang kerja saat ini.

Saat diminta, pilih Pilih templat, lalu cari dan pilih Azure Functions with Cosmos DB Bindings (.NET).
Saat diminta, masukkan nama lingkungan yang unik, seperti cosmosdbchanges-dotnet.

Perintah ini menarik file proyek dari repositori templat dan menginisialisasi proyek di folder atau ruang kerja saat ini. Di azd, lingkungan digunakan untuk mempertahankan konteks penyebaran unik untuk aplikasi Anda, dan Anda dapat menentukan lebih dari satu. Ini juga bagian dari nama grup sumber daya yang Anda buat di Azure.

Saat diminta, pilih Pilih templat, lalu cari dan pilih Azure Functions TypeScript CosmosDB trigger.
Saat diminta, masukkan nama lingkungan yang unik, seperti cosmosdbchanges-ts.

Perintah ini menarik file proyek dari repositori templat dan menginisialisasi proyek di folder atau ruang kerja saat ini. Di azd, lingkungan digunakan untuk mempertahankan konteks penyebaran unik untuk aplikasi Anda, dan Anda dapat menentukan lebih dari satu. Ini juga bagian dari nama grup sumber daya yang Anda buat di Azure.

Saat diminta, pilih Pilih templat, lalu cari dan pilih Azure Functions Python with CosmosDB triggers and bindings....
Saat diminta, masukkan nama lingkungan yang unik, seperti cosmosdbchanges-py.

Perintah ini menarik file proyek dari repositori templat dan menginisialisasi proyek di folder atau ruang kerja saat ini. Di azd, lingkungan digunakan untuk mempertahankan konteks penyebaran unik untuk aplikasi Anda, dan Anda dapat menentukan lebih dari satu. Ini juga bagian dari nama grup sumber daya yang Anda buat di Azure.

Jalankan perintah ini, tergantung pada sistem operasi lokal Anda, untuk memberikan skrip konfigurasi izin yang diperlukan:
- Linux/macOS
- Windows
Jalankan perintah ini dengan hak istimewa yang memadai:
```
chmod +x ./infra/scripts/*.sh
```
Jalankan perintah ini dari prompt perintah Windows:
```
pwsh -Command "Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser"
```
Jika diminta, pilih Ya untuk menyetujui perubahan kebijakan.

Sebelum dapat menjalankan aplikasi secara lokal, Anda harus membuat sumber daya di Azure. Proyek ini tidak menggunakan emulasi lokal untuk Azure Cosmos DB.

Buat sumber daya Azure

Proyek ini dikonfigurasi untuk menggunakan azd provision perintah untuk membuat aplikasi fungsi dalam paket Konsumsi Flex, bersama dengan sumber daya Azure lain yang diperlukan yang mengikuti praktik terbaik saat ini.

Di Visual Studio Code, tekan F1 untuk membuka palet perintah, cari dan jalankan perintah Azure Developer CLI (azd): Sign In with Azure Developer CLI, lalu masuk menggunakan akun Azure Anda.
Tekan F1 untuk membuka palet perintah, cari dan jalankan perintah Azure Developer CLI (azd): Provision Azure resources (provision) untuk membuat sumber daya Azure yang diperlukan:

Ketika diminta di jendela Terminal, berikan parameter penyebaran yang diperlukan ini:

Cepat	Description
Pilih Langganan Azure yang akan digunakan	Pilih langganan di mana Anda ingin sumber daya dibuat.
parameter lokasi penyebaran	Wilayah Azure untuk membuat grup sumber daya yang berisi sumber daya Azure baru. Hanya wilayah yang saat ini mendukung paket Konsumsi Flex yang ditampilkan.
Parameter penyebaran vnetEnabled	Sementara templat mendukung pembuatan sumber daya di dalam jaringan virtual, untuk menyederhanakan penyebaran dan pengujian, pilih `False`.

Perintah azd provision menggunakan respons Anda terhadap prompt ini bersama dengan file konfigurasi Bicep untuk membuat dan mengonfigurasi sumber daya Azure yang diperlukan, mengikuti praktik terbaru terbaik.

Paket Konsumsi Flex dan aplikasi fungsi
Akun Azure Cosmos DB
Azure Storage (wajib) dan Application Insights (disarankan)
Mengakses kebijakan dan peran untuk akun Anda
Koneksi layanan ke layanan menggunakan identitas terkelola (bukan string koneksi tersimpan)

Hook pascaprovisi juga menghasilkan file local.settings.json yang diperlukan saat berjalan secara lokal. File ini juga berisi pengaturan yang diperlukan untuk menyambungkan ke database Azure Cosmos DB Anda di Azure.

Petunjuk / Saran

Jika ada langkah yang gagal selama provisi, Anda dapat menjalankan kembali perintah azd provision setelah menyelesaikan masalah apa pun.

Setelah perintah berhasil diselesaikan, Anda dapat menjalankan kode proyek secara lokal dan memicu pada database Azure Cosmos DB di Azure.

Jalankan fungsi secara lokal

Visual Studio Code terintegrasi dengan alat Azure Functions Core untuk memungkinkan Anda menjalankan proyek ini di komputer pengembangan lokal anda sebelum menerbitkan ke aplikasi fungsi baru di Azure.

Tekan F1 dan di palet perintah cari dan jalankan perintah Azurite: Start.
Untuk memulai fungsi secara lokal, tekan F5 atau ikon Jalankan dan Debug di bilah Aktivitas sisi kiri. Panel Terminal menampilkan output dari Core Tools. Aplikasi Anda dimulai di panel Terminal , dan Anda dapat melihat nama fungsi yang berjalan secara lokal.

Jika Anda mengalami masalah saat menjalankan fungsi di Windows, pastikan bahwa terminal default untuk Visual Studio Code tidak diatur ke WSL Bash.
Dengan Core Tools masih berjalan di Terminal, tekan F1 dan di palet perintah cari dan jalankan perintah NoSQL: Create Item... dan pilih document-db database dan documents kontainer.
Ganti konten file New Item.json dengan data JSON ini dan pilih Simpan:
```
{
    "id": "doc1", 
    "title": "Sample document", 
    "content": "This is a sample document for testing my Azure Cosmos DB trigger in Azure Functions."
} 
```
Setelah Memilih Simpan, Anda akan melihat eksekusi fungsi di terminal dan dokumen lokal diperbarui untuk menyertakan metadata yang ditambahkan oleh layanan.
Setelah selesai, tekan Ctrl+C di jendela terminal untuk menghentikan func.exe proses host.

Meninjau kode (opsional)

Fungsi ini dipicu berdasarkan umpan perubahan dalam database NoSQL Azure Cosmos DB. Variabel lingkungan ini mengonfigurasi cara pemicu memantau umpan perubahan:

COSMOS_CONNECTION__accountEndpoint: Titik akhir akun Cosmos DB
COSMOS_DATABASE_NAME: Nama database yang akan dipantau
COSMOS_CONTAINER_NAME: Nama kontainer yang akan dipantau

Variabel lingkungan ini dibuat untuk Anda baik di Azure (pengaturan aplikasi fungsi) dan secara lokal (local.settings.json) selama azd provision operasi.

Anda dapat meninjau kode yang menentukan pemicu Azure Cosmos DB dalam file proyek CosmosTrigger.cs.

Anda dapat meninjau kode yang menentukan pemicu Azure Cosmos DB dalam file proyek cosmos_trigger.ts.

Anda dapat meninjau kode yang menentukan pemicu Azure Cosmos DB dalam file proyek function_app.py.

Setelah Anda meninjau dan memverifikasi kode fungsi Anda secara lokal, saatnya untuk menerbitkan proyek ke Azure.

Sebarkan ke Azure

Anda dapat menjalankan azd deploy perintah dari Visual Studio Code untuk menyebarkan kode proyek ke sumber daya yang sudah disediakan di Azure.

Tekan F1 untuk membuka palet perintah, cari dan jalankan perintah Azure Developer CLI (azd): Deploy to Azure (deploy).

Perintah azd deploy mengemas dan menyebarkan kode Anda ke kontainer penyebaran. Aplikasi kemudian dimulai dan berjalan dalam paket yang disebarkan.

Setelah perintah berhasil diselesaikan, aplikasi Anda berjalan di Azure.

Menggunakan fungsi pada Azure

Di Visual Studio Code, tekan F1 dan di palet perintah cari dan jalankan perintah Azure: Open in portal, pilih Function app, dan pilih aplikasi baru Anda. Masuk dengan akun Azure Anda, jika perlu.

Perintah ini membuka aplikasi fungsi baru Anda di portal Microsoft Azure.
Di tab Gambaran Umum di halaman utama, pilih nama aplikasi fungsi Anda lalu tab Log .
NoSQL: Create Item Gunakan perintah di Visual Studio Code untuk menambahkan dokumen lagi ke kontainer seperti sebelumnya.
Verifikasi lagi bahwa fungsi dipicu oleh pembaruan dalam kontainer yang dipantau.

Menyebarkan ulang kode Anda

Anda dapat menjalankan azd deploy perintah sebanyak yang Anda butuhkan untuk menyebarkan pembaruan kode ke aplikasi fungsi Anda.

Nota

File kode yang disebarkan selalu ditimpa oleh paket penyebaran terbaru.

Respons awal Anda terhadap azd perintah dan variabel lingkungan apa pun yang dihasilkan oleh azd disimpan secara lokal di lingkungan bernama Anda. azd env get-values Gunakan perintah untuk meninjau semua variabel di lingkungan Anda yang digunakan saat membuat sumber daya Azure.

Membersihkan sumber daya

Setelah selesai bekerja dengan aplikasi fungsi dan sumber daya terkait, Anda dapat menggunakan perintah ini untuk menghapus aplikasi fungsi dan sumber daya terkait dari Azure dan menghindari timbulnya biaya lebih lanjut:

azd down --no-prompt

Nota

Opsi ini --no-prompt menginstruksikan azd untuk menghapus grup sumber daya Anda tanpa konfirmasi dari Anda.

Perintah ini tidak memengaruhi proyek kode lokal Anda.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-12-01