Jelajahi jenis pengikatan input dan output

10 menit

Mengakses dan memproses data merupakan tugas utama dalam banyak solusi perangkat lunak. Pertimbangkan beberapa skenario berikut ini:

Anda telah diminta untuk menerapkan cara memindahkan data yang masuk dari Azure Blob Storage ke Azure Cosmos DB.
Anda ingin mem-posting pesan masuk ke antrean untuk diproses oleh komponen lain di perusahaan Anda.
Layanan Anda perlu mengambil skor gamer dari antrean dan memperbarui papan skor online.

Semua contoh ini merupakan tentang memindahkan data. Sumber data dan tujuan akan berbeda dari skenario ke skenario, tetapi polanya mirip. Anda tersambung ke sumber data dan Anda membaca serta menulis data. Azure Functions membantu Anda berintegrasi dengan data serta layanan dengan menggunakan pengikatan.

Apa itu pengikatan?

Di Azure Functions, pengikatan menyediakan cara deklaratif untuk menyambungkan ke data dari dalam kode Anda. Mereka membuatnya lebih mudah untuk diintegrasikan bersama dengan aliran data secara konsisten dalam sebuah fungsi. Anda dapat mempunyai beberapa pengikatan yang menyediakan akses ke elemen data yang berbeda. Integrasi ini canggih karena Anda dapat terhubung ke sumber data tanpa harus mengodekan logika koneksi tertentu (seperti koneksi database atau antarmuka API web).

Jenis pengikatan

Terdapat dua jenis pengikatan yang dapat Anda gunakan dengan fungsi:

Pengikatan input - Menyambungkan ke sumber data. Fungsi kami dapat membaca data dari sumber input ini.
Pengikatan output - Menyambungkan ke tujuan data. Fungsi kami dapat menulis data ke tujuan output ini.

Ada juga pemicu, yang merupakan jenis pengikatan input khusus sehingga membuat fungsi berjalan. Contohnya, pemberitahuan Azure Event Grid dapat dikonfigurasi sebagai pemicu. Ketika peristiwa terjadi, fungsi berjalan.

Jenis pengikatan yang didukung

Jenis pengikatan menentukan tempat kita membaca atau mengirim data. Ada pengikatan untuk menanggapi permintaan web, dan banyak pilihan pengikatan untuk berinteraksi langsung dengan berbagai layanan Azure dan layanan pihak ketiga.

Satu jenis pengikatan dapat digunakan sebagai input, output, atau keduanya. Misalnya, fungsi dapat menulis ke pengikatan output Blob Storage, namun pembaruan Blob Storage dapat memicu fungsi lain.

Jenis pengikatan yang umum meliputi:

Penyimpanan Blob
Azure Service Bus Queues
Azure Cosmos DB
Azure Event Hubs
File eksternal
Tabel eksternal
Titik akhir HTTP

Jenis-jenis ini hanyalah merupakan sampel. Terdapat lebih banyak lagi, ditambah fungsi memiliki model ekstensibilitas untuk menambahkan lebih banyak pengikatan.

Properti pengikatan

Tiga properti diperlukan di semua pengikatan, meskipun Anda mungkin harus menyediakan lebih banyak properti berdasarkan jenis pengikatan dan penyimpanan yang Anda gunakan.

Nama - Mendefinisikan parameter fungsi yang Anda gunakan untuk mengakses data. Misalnya, dalam pengikatan input antrean, properti ini adalah nama parameter fungsi yang menerima konten pesan antrean.
Jenis - Mengidentifikasi jenis pengikatan. Misalnya, jenis data atau layanan yang ingin Anda berinteraksi.
Arah - Menunjukkan arah data mengalir. Misalnya, apakah itu pengikatan input atau output?

Selain itu, sebagian besar jenis pengikatan juga membutuhkan properti keempat:

Koneksi - Menyediakan nama sebuah kunci pengaturan aplikasi yang berisi string koneksi. Pengikatan menggunakan string koneksi yang disimpan dalam pengaturan aplikasi untuk menjaga rahasia dari kode fungsi. string Koneksi ion membuat kode Anda lebih dapat dikonfigurasi dan aman.

Membuat pengikatan

Pengikatan didefinisikan dalam bahasa pemrograman JSON. Pengikatan dikonfigurasi dalam file konfigurasi fungsi Anda, yang diberi nama function.json dan berada di folder yang sama dengan kode fungsi Anda.

Mari kita periksa sampel pengikatan input:

    ...
    {
      "name": "headshotBlob",
      "type": "blob",
      "path": "thumbnail-images/{filename}",
      "connection": "HeadshotStorageConnection",
      "direction": "in"
    },
    ...

Untuk membuat pengikatan ini, kita akan:

Buat pengikatan di file function.json kita.
Berikan nilai untuk variabel name. Dalam contoh ini, variabel memegang data blob.
Sediakan penyimpanan type. Pada contoh sebelumnya, kita menggunakan Blob Storage.
Berikan path, yang menentukan kontainer dan nama item yang masuk ke dalamnya. Properti path diperlukan saat menggunakan pemicu blob, serta harus disediakan dalam gaya yang ditunjukkan di sini, dengan tanda kurung kurawal di sekitar bagian nama file dari jalur. Sintaks ini membuat ekspresi pengikatan yang memungkinkan Anda mereferensikan nama blob di pengikatan lain, dan dalam kode fungsi Anda. Dalam contoh ini, parameter pada fungsi bernama filename akan diisi dengan nama file dari blob yang memicu fungsi tersebut.
Berikan nama pengaturan string connection yang didefinisikan dalam file pengaturan aplikasi. Ini digunakan sebagai sebuah kunci untuk menemukan string koneksi untuk terhubung ke akun penyimpanan Anda.
Tentukan direction sebagai in. Ia membaca data dari blob.

Pengikatan digunakan untuk terhubung ke data dalam fungsi Anda. Dalam contoh ini, kami menggunakan pengikatan input untuk menghubungkan gambar pengguna untuk diproses oleh fungsi kami sebagai gambar mini.

Lanjutkan