Bagikan melalui

Tutorial: Fungsi Python dengan Azure Queue Storage sebagai pemicu

  • Artikel

Dalam tutorial ini, Anda mempelajari cara mengonfigurasi fungsi Python dengan Antrean Penyimpanan sebagai pemicu dengan menyelesaikan tugas berikut.

  • Gunakan Visual Studio Code untuk membuat proyek fungsi Python.
  • Gunakan Visual Studio Code untuk menjalankan fungsi secara lokal.
  • Gunakan Azure CLI untuk membuat koneksi antara Azure Function dan Storage Queue dengan Service Koneksi or.
  • Gunakan Visual Studio untuk menyebarkan fungsi Anda.

Gambaran umum komponen proyek fungsi dalam tutorial ini:

Komponen Proyek Pilihan / Solusi
Layanan Sumber Fungsi Azure
Layanan Target Antrean Penyimpanan Azure
Pengikatan Fungsi Antrean Penyimpanan sebagai Pemicu
Jenis Autentikasi Proyek Lokal String Koneksi
Jenis Autentikasi Fungsi Cloud String Koneksi

Prasyarat

Membuat proyek fungsi Python

Ikuti tutorial untuk membuat proyek Azure Functions lokal, dan berikan informasi berikut pada perintah:

Prompt Pilihan
Pilih Bahasa Pilih Python. (model bahasa pemrograman v1)
Pilih interpreter Python untuk membuat lingkungan virtual Pilih interpreter Python pilihan Anda. Jika opsi tidak ditampilkan, ketik jalur lengkap ke biner Python Anda.
Pilih templat untuk fungsi pertama proyek Anda Pilih Azure Queue Storage trigger.
Berikan nama fungsi Memasuki QueueStorageTriggerFunc.
Pilih pengaturan dari "local.setting.json" Pilih Create new local app settings, yang memungkinkan Anda memilih Akun Penyimpanan dan memberikan nama antrean yang berfungsi sebagai pemicu.

Anda telah membuat proyek fungsi Python dengan Azure Storage Queue sebagai pemicu. Proyek lokal tersambung ke Azure Storage menggunakan string koneksi disimpan ke local.settings.json dalam file. Terakhir, main fungsi dalam __init__.py file fungsi dapat menggunakan string koneksi dengan bantuan Pengikatan Fungsi yang ditentukan dalam function.json file.

Jalankan fungsi secara lokal

Ikuti tutorial untuk menjalankan fungsi secara lokal dan memverifikasi pemicunya.

  1. Pilih akun penyimpanan seperti yang Anda pilih saat membuat sumber daya Azure Function jika Anda diminta untuk menyambungkan ke penyimpanan. Nilai ini digunakan untuk runtime Azure Function, dan tidak selalu sama dengan akun penyimpanan yang Anda gunakan untuk pemicu.
  2. Untuk memulai fungsi secara lokal, tekan <kbd>F5 </kbd> atau pilih ikon Jalankan dan Debug di bilah Aktivitas sisi kiri.
  3. Untuk memverifikasi bahwa pemicu berfungsi dengan baik, jaga agar fungsi tetap berjalan secara lokal dan buka bilah Antrean Penyimpanan di portal Azure, pilih Tambahkan pesan dan berikan pesan pengujian. Anda akan melihat fungsi dipicu dan diproses sebagai item antrean di terminal Visual Studio Code Anda.

Membuat koneksi menggunakan Koneksi or Layanan

Pada langkah terakhir, Anda memverifikasi proyek fungsi secara lokal. Sekarang Anda akan mempelajari cara mengonfigurasi koneksi antara Azure Function dan Azure Storage Queue di cloud, sehingga fungsi Anda dapat dipicu oleh antrean penyimpanan setelah disebarkan ke cloud.

  1. function.json Buka file di proyek lokal Anda, ubah nilai connection properti bindings menjadi AZURE_STORAGEQUEUE_CONNECTIONSTRING.
  2. Jalankan perintah Azure CLI berikut untuk membuat koneksi antara Azure Function dan akun penyimpanan Azure Anda.
az functionapp connection create storage-queue --source-id "<your-function-resource-id>" --target-id "<your-storage-queue-resource-id>" --secret
  • --source-id Format: /subscriptions/{subscription}/resourceG roups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
  • --target-id Format: /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default

Langkah ini membuat sumber daya Service Koneksi or yang mengonfigurasi AZURE_STORAGEQUEUE_CONNECTIONSTRING variabel di app Pengaturan fungsi. Runtime pengikatan fungsi menggunakannya untuk terhubung ke penyimpanan, sehingga fungsi dapat menerima pemicu dari antrean penyimpanan. Untuk informasi selengkapnya, buka bagaimana Service Koneksi or membantu Azure Functions terhubung ke layanan.

Menyebarkan fungsi Anda ke Azure

Sekarang Anda dapat menyebarkan fungsi Anda ke Azure dan memverifikasi bahwa pemicu antrean penyimpanan berfungsi.

  1. Ikuti tutorial Azure Functions ini untuk menyebarkan fungsi Anda ke Azure.
  2. Buka bilah Antrean Penyimpanan di portal Azure, pilih Tambahkan pesan dan berikan pesan pengujian. Anda akan melihat fungsi dipicu dan diproses sebagai item antrean di log fungsi Anda.

Pemecahan Masalah

Jika ada kesalahan yang terkait dengan host penyimpanan, seperti No such host is known (<acount-name>.queue.core.windows.net:443), periksa apakah string koneksi yang Anda gunakan untuk menyambungkan ke Azure Storage berisi titik akhir antrean atau tidak. Jika tidak, buka Azure Storage di portal Azure, salin string koneksi dari Access keys bilah, dan ganti nilai.

Jika kesalahan ini terjadi saat Anda memulai proyek secara lokal, periksa local.settings.json file.

Jika kesalahan ini terjadi saat Anda menyebarkan fungsi Anda ke cloud (dalam hal ini, penyebaran Fungsi biasanya gagal Syncing triggers ), periksa Pengaturan Aplikasi Fungsi Anda.

Membersihkan sumber daya

Jika Anda tidak akan terus menggunakan proyek ini, hapus sumber daya Aplikasi Fungsi yang Anda buat sebelumnya.

  1. Di portal Azure, buka sumber daya Aplikasi Fungsi dan pilih Hapus.
  2. Masukkan nama aplikasi dan pilih Hapus untuk mengonfirmasi.

Langkah berikutnya

Baca artikel di bawah ini untuk mempelajari selengkapnya tentang konsep Service Koneksi or dan caranya membantu Azure Functions terhubung ke layanan.

Mempelajari tentang konsep Konektor Layanan

Menggunakan Service Koneksi or untuk menyambungkan Azure Functions ke layanan cloud lainnya