Pengikatan penyimpanan Azure Blob untuk pratinjau Azure Functions

Artikel
11/21/2023

Azure Functions terintegrasi dengan Azure Storage melalui pemicu dan pengikatan. Mengintegrasikan dengan penyimpanan Blob memungkinkan Anda untuk membangun fungsi yang bereaksi terhadap perubahan data gumpalan serta membaca dan menulis nilai.

Perbuatan	Jenis
Jalankan fungsi saat data penyimpanan gumpalan berubah	Pemicu
Baca data penyimpanan gumpalan dalam suatu fungsi	Pengikatan masukan
Izinkan fungsi untuk menulis data penyimpanan gumpalan	Pengikatan output

Menginstal ekstensi

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

Model pekerja terisolasi
Model dalam proses

Functions dijalankan dalam proses pekerja C# yang terisolasi. Untuk mempelajari selengkapnya, lihat Panduan untuk menjalankan C# Azure Functions dalam proses pekerja yang terisolasi.

Fungsionalitas ekstensi tersebut bervariasi tergantung pada versi ekstensi:

Bagian ini menjelaskan penggunaan pustaka kelas. Untuk pembuatan skrip C#, Anda harus menginstal bundel ekstensi, versi 4.x.

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

Versi ini memungkinkan Anda untuk mengikat jenis dari Azure.Storage.Blobs. Pelajari lebih lanjut tentang perbedaan jenis baru ini dari WindowsAzure.Storage dan Microsoft.Azure.Storage serta cara bermigrasi ke jenis baru ini dari Panduan Migrasi Azure.Storage.Blobs.

Ekstensi ini tersedia dengan memasang paket Microsoft.Azure.WebJobs.Extensions.Storage.Blobs NuGet, versi 5.x.

Menggunakan CLI .NET:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.0.0

Catatan

Azure Blobs, Azure Queues, dan Azure Tables sekarang menggunakan ekstensi terpisah dan direferensikan satu per satu. Misalnya, untuk menggunakan pemicu dan pengikatan untuk ketiga layanan di aplikasi dalam proses .NET, Anda harus menambahkan paket berikut ke proyek Anda:

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

Tambahkan ekstensi ke proyek Anda dengan menginstal paket NuGet Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs, versi 5.x atau yang lebih baru.

Menggunakan CLI .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs

Catatan

Azure Blobs, Azure Queues, dan Azure Tables sekarang menggunakan ekstensi terpisah dan direferensikan satu per satu. Misalnya, untuk menggunakan pemicu dan pengikatan untuk ketiga layanan di aplikasi proses terisolasi .NET, Anda harus menambahkan paket berikut ke proyek Anda:

Sebelumnya, ekstensi dikirim bersama-sama sebagai Microsoft.Azure.Functions.Worker.Extensions.Storage, versi 4.x. Paket yang sama ini juga memiliki versi 5.x, yang merujuk pada paket terpisah untuk blob dan antrean saja. Saat memutakhirkan referensi paket dari versi yang lebih lama, Anda mungkin perlu juga mereferensikan paket NuGet Microsoft.Azure.Functions.Worker.Extensions.Tables baru. Juga, saat mereferensikan paket terpisah yang lebih baru ini, pastikan Anda tidak merujuk versi yang lebih lama dari paket penyimpanan gabungan, karena ini akan mengakibatkan konflik dari dua definisi dari ikatan yang sama.

Jika Anda menulis aplikasi menggunakan F#, Anda juga harus mengonfigurasi ekstensi ini sebagai bagian dari konfigurasi startup aplikasi. Dalam panggilan ke ConfigureFunctionsWorkerDefaults() atau ConfigureFunctionsWebApplication(), tambahkan delegasi yang mengambil IFunctionsWorkerApplication parameter. Kemudian dalam isi delegasi tersebut, panggil ConfigureBlobStorageExtension() pada objek:

let hostBuilder = new HostBuilder()
hostBuilder.ConfigureFunctionsWorkerDefaults(fun (context: HostBuilderContext) (appBuilder: IFunctionsWorkerApplicationBuilder) ->
    appBuilder.ConfigureBlobStorageExtension() |> ignore
) |> ignore

Memasang bundel

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

Anda dapat menambahkan versi ekstensi ini dari bundel ekstensi v3 dengan menambahkan atau mengganti kode berikut dalam file host.json:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[3.3.0, 4.0.0)"
    }
}

Untuk mempelajari selengkapnya, lihat Perbarui ekstensi Anda.

Jenis pengikatan

Jenis pengikatan yang didukung untuk .NET bergantung pada versi ekstensi dan mode eksekusi C#, yang dapat menjadi salah satu hal berikut:

Model pekerja terisolasi
Model dalam proses

Pustaka kelas proses pekerja terisolasi yang dikompilasi fungsi C# berjalan dalam proses yang diisolasi dari runtime.

Pilih versi untuk melihat detail jenis pengikatan untuk mode dan versi.

Ekstensi Azure Blobs mendukung jenis parameter sesuai dengan tabel di bawah ini.

Skenario pengikatan	Jenis parameter
Pemicu blob	Stream `TextReader` `string` `byte[]` BinaryData BlobClient¹ BlockBlobClient¹ PageBlobClient¹ AppendBlobClient¹ BlobBaseClient¹
Input blob (blob tunggal)	Stream `TextReader` `string` `byte[]` BinaryData BlobClient¹ BlockBlobClient¹ PageBlobClient¹ AppendBlobClient¹ BlobBaseClient¹
Input blob (beberapa blob dari kontainer)	`IEnumerable<T>` di mana `T` adalah salah satu jenis pengikatan input blob tunggal
Output blob (blob tunggal)	Stream `TextWriter` `string` `byte[]`
Output blob (beberapa blob)	`ICollector<T>` atau `IAsyncCollector<T>` di mana `T` adalah salah satu jenis pengikatan output blob tunggal

¹ Jenis klien memerlukan Access properti atribut untuk diatur ke FileAccess.ReadWrite.

Untuk contoh penggunaan jenis ini, lihat repositori GitHub untuk ekstensi. Pelajari selengkapnya tentang jenis dari Azure SDK, perbedaannya dengan versi sebelumnya, dan cara bermigrasi ke jenis tersebut dari Panduan Migrasi Azure.Storage.Blobs.

Versi ekstensi yang lebih lama mengekspos jenis yang diekspos dari namespace Microsoft.Azure.Storage.Blob yang sekarang tidak digunakan lagi. Jenis yang lebih baru dari Azure.Storage.Blobs eksklusif untuk ekstensi 5.x dan yang lebih tinggi.

Versi ekstensi Azure Blobs ini mendukung jenis parameter sesuai dengan tabel di bawah ini.

Pengikatan	Jenis parameter
Pemicu blob	Stream `TextReader` `string` `byte[]` ICloudBlob¹ CloudBlockBlob¹ CloudPageBlob¹ CloudAppendBlob¹
Input blob	Stream `TextReader` `string` `byte[]` ICloudBlob¹ CloudBlockBlob¹ CloudPageBlob¹ CloudAppendBlob¹
Output blob	Stream `TextWriter` `string` `byte[]`

¹ Jenis ini mengharuskan Access properti atribut diatur ke FileAccess.ReadWrite.

²IEnumerable<T> menyediakan enumerasi blob dalam kontainer. Di sini, T bisa menjadi salah satu jenis lain yang didukung.

Proses pekerja yang terisolasi mendukung jenis parameter sesuai dengan tabel di bawah ini.

Pemicu blob

Pemicu blob dapat mengikat ke jenis berikut:

Tipe	Deskripsi
`string`	Konten blob sebagai string. Gunakan saat konten blob adalah teks sederhana.
`byte[]`	Byte konten blob.
Jenis yang bisa diserialisasikan JSON	Saat blob berisi data JSON, Functions mencoba mendeserialisasi data JSON ke dalam jenis objek CLR (POCO) yang berusia biasa.
Aliran¹	Aliran input konten blob.
BlobClient¹, BlockBlobClient¹, PageBlobClient¹, TambahkanBlobClient¹, BlobBaseClient¹	Klien yang terhubung ke blob. Set jenis ini menawarkan kontrol paling besar untuk memproses blob dan dapat digunakan untuk menulis kembali ke blob jika koneksi memiliki izin yang memadai.

¹ Untuk menggunakan jenis ini, Anda perlu mereferensikan Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs 6.0.0 atau yang lebih baru dan dependensi umum untuk pengikatan jenis SDK.

Pengikatan input blob

Saat Anda ingin fungsi memproses satu blob, pengikatan input blob dapat mengikat ke jenis berikut:

Tipe	Deskripsi
`string`	Konten blob sebagai string. Gunakan saat konten blob adalah teks sederhana.
`byte[]`	Byte konten blob.
Jenis yang bisa diserialisasikan JSON	Saat blob berisi data JSON, Functions mencoba mendeserialisasi data JSON ke dalam jenis objek CLR (POCO) yang berusia biasa.
Aliran¹	Aliran input konten blob.
BlobClient¹, BlockBlobClient¹, PageBlobClient¹, TambahkanBlobClient¹, BlobBaseClient¹	Klien yang terhubung ke blob. Set jenis ini menawarkan kontrol paling besar untuk memproses blob dan dapat digunakan untuk menulis kembali jika koneksi memiliki izin yang memadai.

Saat Anda ingin fungsi memproses beberapa blob dari kontainer, pengikatan input blob dapat mengikat ke jenis berikut:

Tipe	Deskripsi
`T[]` atau `List<T>` di mana `T` adalah salah satu jenis pengikatan input blob tunggal	Array atau daftar beberapa blob. Setiap entri mewakili satu blob dari kontainer. Anda juga dapat mengikat antarmuka apa pun yang diterapkan oleh jenis ini, seperti `IEnumerable<T>`.
BlobContainerClient¹	Klien yang terhubung ke kontainer. Jenis ini menawarkan kontrol paling besar untuk memproses kontainer dan dapat digunakan untuk menulis ke kontainer jika koneksi memiliki izin yang memadai.

¹ Untuk menggunakan jenis ini, Anda perlu mereferensikan Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs 6.0.0 atau yang lebih baru dan dependensi umum untuk pengikatan jenis SDK.

Pengikatan output blob

Saat Anda ingin fungsi menulis ke satu blob, pengikatan output blob dapat mengikat ke jenis berikut:

Tipe	Deskripsi
`string`	Konten blob sebagai string. Gunakan saat konten blob adalah teks sederhana.
`byte[]`	Byte konten blob.
Jenis yang bisa diserialisasikan JSON	Objek yang mewakili konten blob JSON. Fungsi mencoba menserialisasikan jenis objek CLR (POCO) lama biasa ke dalam data JSON.

Saat Anda ingin fungsi menulis ke beberapa blob, pengikatan output blob dapat mengikat ke jenis berikut:

Tipe	Deskripsi
`T[]` di mana `T` adalah salah satu jenis pengikatan output blob tunggal	Array yang berisi konten untuk beberapa blob. Setiap entri mewakili konten satu blob.

Untuk skenario output lainnya, buat dan gunakan jenis dari Azure.Storage.Blobs secara langsung.

Pengaturan host.json

Bagian ini menjelaskan pengaturan konfigurasi aplikasi fungsi yang tersedia untuk fungsi yang diikatnya. Pengaturan ini hanya berlaku saat menggunakan ekstensi versi 5.0.0 dan lebih tinggi. Contohnya file host.json di bawah ini hanya berisi pengaturan versi 2.x+ untuk pengikatan ini. Untuk informasi selengkapnya tentang pengaturan konfigurasi aplikasi fungsi dalam versi 2.x dan seterusnya, lihat referensi host.json untuk Azure Functions.

Catatan

Bagian ini tidak berlaku untuk versi ekstensi sebelum 5.0.0. Untuk versi yang lebih lama, tidak ada pengaturan konfigurasi seluruh aplikasi fungsi untuk blob.

{
    "version": "2.0",
    "extensions": {
        "blobs": {
            "maxDegreeOfParallelism": 4,
            "poisonBlobThreshold": 1
        }
    }
}

Properti	Default	Deskripsi
maxDegreeOfParallelism	8 * (jumlah inti yang tersedia)	Jumlah bilangan bulat pemanggilan bersamaan yang diizinkan untuk semua fungsi yang dipicu blob dalam aplikasi fungsi tertentu. Nilai minimum yang diizinkan adalah 1.
poisonBlobThreshold	5	Bilangan bulat berkali-kali untuk mencoba memproses pesan sebelum memindahkannya ke antrean racun. Nilai minimum yang diizinkan adalah 1.

Pengikatan penyimpanan Azure Blob untuk pratinjau Azure Functions

Menginstal ekstensi

Memasang bundel

Jenis pengikatan

Pengaturan host.json

Langkah berikutnya

Sumber Daya Tambahan: