Pengikatan Tabel Azure untuk Azure Functions

  • Artikel
  • 3 menit untuk membaca

Azure Functions terintegrasi dengan Tabel Azure melalui pemicu dan pengikatan. Berintegrasi dengan Tabel Azure memungkinkan Anda membangun fungsi yang membaca dan menulis data menggunakan API Tables untuk Azure Storage dan Cosmos DB.

Catatan

Pengikatan Tabel secara historis hanya mendukung Azure Storage. Dukungan untuk Cosmos DB saat ini dalam pratinjau. Lihat Ekstensi API Tabel (pratinjau).

Tindakan Jenis
Membaca data tabel dalam fungsi Pengikatan masukan
Mengizinkan fungsi menulis data tabel Pengikatan output

Menginstal ekstensi

Paket NuGet ekstensi yang Anda instal bergantung pada mode C# yang digunakan di aplikasi fungsi:

Functions berjalan dalam proses yang sama dengan host Functions. Untuk mempelajari lebih lanjut, lihat Mengembangkan fungsi pustaka kelas C# dengan menggunakan Azure Functions.

Proses untuk menginstal ekstensi bervariasi tergantung pada versi ekstensi:

Versi ini memperkenalkan kemampuan untuk menyambungkan menggunakan identitas alih-alih rahasia. Untuk tutorial mengonfigurasi aplikasi fungsi Anda dengan identitas terkelola, lihat tutorial membuat aplikasi fungsi dengan tutorial koneksi berbasis identitas.

Versi ini memungkinkan Anda mengikat ke jenis dari Azure.Data.Tables. Versi ini juga memperkenalkan kemampuan untuk menggunakan Table API Cosmos DB.

Ekstensi ini tersedia dengan menginstal paket NuGet Microsoft.Azure.WebJobs.Extensions.Tables ke dalam proyek menggunakan versi 5.x atau yang lebih tinggi dari ekstensi untuk blob dan antrean.

Menggunakan CLI .NET:

# Install the Tables API extension
dotnet add package Microsoft.Azure.WebJobs.Extensions.Tables --version 1.0.0

# Update the combined Azure Storage extension (to a version which no longer includes Tables)
dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage --version 5.0.0

Catatan

Blob Storage, Queue Storage, dan Table Storage kini menggunakan ekstensi terpisah dan direferensikan secara individu. Misalnya, untuk menggunakan pemicu dan pengikatan untuk ketiga layanan di aplikasi dalam proses .NET, Anda harus menambahkan paket berikut ke proyek Anda:

Sebelumnya, ekstensi dikirim bersama-sama sebagai Microsoft.Azure.WebJobs.Extensions.Storage, versi 4.x. Paket yang sama ini juga memiliki versi 5.x, yang mereferensikan paket terpisah hanya untuk blob dan antrean. Saat meningkatkan referensi paket dari versi yang lebih lama, Anda mungkin juga perlu mereferensikan paket NuGet Microsoft.Azure.WebJobs.Extensions.Tables yang baru. Selain itu, saat mereferensikan paket terpisah yang lebih baru ini, pastikan Anda tidak mereferensikan versi lama dari paket penyimpanan gabungan, karena ini akan mengakibatkan konflik dari dua definisi pengikatan yang sama.

Menginstal bundel

Pengikatan Tabel Azure adalah bagian dari bundel ekstensi, yang ditentukan dalam file proyek host.json Anda. Anda mungkin perlu mengubah bundel ini untuk mengubah versi pengikatan, atau jika bundel belum terinstal. Untuk mempelajari lebih lanjut, lihat bundel ekstensi.

Bundel ekstensi versi 3.x saat ini tidak menyertakan pengikatan Tabel Azure. Anda perlu menggunakan bundel ekstensi versi 2.x sebagai gantinya.

Langkah berikutnya