Öğretici: Azure İşlevleri ve Blob Depolama ile bir dosyayı karşıya yükleme ve analiz etme

Bu öğreticide, Azure İşlevleri ve Görüntü İşleme kullanarak bir görüntüyü karşıya yükleyip Azure Blob Depolama ve işlemeyi öğreneceksiniz. Ayrıca bu işlemin bir parçası olarak Azure İşlevi tetikleyicilerini ve bağlamalarını uygulamayı da öğreneceksiniz. Bu hizmetler birlikte, metin içeren karşıya yüklenen bir görüntüyü analiz eder, içindeki metni ayıklar ve daha sonra analiz etmek veya başka amaçlarla metni bir veritabanı satırında depolar.

Azure Blob Depolama, Microsoft'un bulut için yüksek düzeyde ölçeklenebilir nesne depolama çözümüdür. Blob Depolama görüntüleri ve belgeleri depolamak, medya dosyalarını akışla aktarmak, yedekleme ve arşiv verilerini yönetmek ve çok daha fazlası için tasarlanmıştır. Blob Depolama hakkında daha fazla bilgiyi genel bakış sayfasından okuyabilirsiniz.

Azure İşlevleri, küçük kod bloklarını yüksek oranda ölçeklenebilir, sunucusuz ve olay odaklı işlevler olarak yazmanızı ve çalıştırmanızı sağlayan sunucusuz bir bilgisayar çözümüdür. genel bakış sayfasında Azure İşlevleri hakkında daha fazla bilgi edinebilirsiniz.

Bu öğreticide şunların nasıl yapıldığını öğrenirsiniz:

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Visual Studio 2022 yüklü.

Depolama hesabını ve kapsayıcıyı oluşturma

İlk adım, karşıya yüklenen blob verilerini barındıracak depolama hesabını oluşturmaktır ve bu senaryoda metin içeren görüntüler olacaktır. Depolama hesabı birkaç farklı hizmet sunar, ancak bu öğreticide Blob Depolama ve Tablo Depolama kullanılır.

az group create --location eastus --name msdocs-storage-function \

az storage account create --name msdocsstorageaccount --resource-group msdocs-storage-function -l eastus --sku Standard_LRS \

az storage container create --name imageanalysis --account-name msdocsstorageaccount --resource-group msdocs-storage-function

az storage account show-connection-string -g msdocs-storage-function -n msdocsstorageaccount

Görüntü İşleme hizmetini oluşturma

Ardından, karşıya yüklenen dosyalarımızı işleyecek Görüntü İşleme hizmet hesabını oluşturun. Görüntü İşleme, Azure yapay zeka hizmetlerinin bir parçasıdır ve görüntülerden veri ayıklamaya yönelik çeşitli özellikler sunar. genel bakış sayfasında Görüntü İşleme hakkında daha fazla bilgi edinebilirsiniz.

az cognitiveservices account create \
    --name msdocs-process-image \
    --resource-group msdocs-storage-function \
    --kind ComputerVision \
    --sku F1 \
    --location eastus2 \
    --yes

az cognitiveservices account keys list \
    --name msdocs-process-image \
    --resource-group msdocs-storage-function  \ 
    
az cognitiveservices account list \
--name msdocs-process-image \
    --resource-group msdocs-storage-function --query "[].properties.endpoint"   

Örnek projeyi indirme ve yapılandırma

Bu öğreticide kullanılan Azure İşlevinin kodu bu GitHub deposunda bulunabilir. Aşağıdaki komutu kullanarak projeyi de kopyalayabilirsiniz.

git clone https://github.com/Azure-Samples/msdocs-storage-bind-function-service.git \
cd msdocs-storage-bind-function-service/dotnet

Örnek proje kodu aşağıdaki görevleri gerçekleştirir:

• Depolama hesabına ve Görüntü İşleme hizmetine bağlanmak için ortam değişkenlerini alır
• Karşıya yüklenen dosyayı blob parametresi olarak kabul eder
• Görüntü İşleme hizmetini kullanarak blobu analiz eder
• Çıkış bağlamalarını kullanarak çözümlenen görüntü metnini yeni bir tablo satırına gönderir

Projeyi indirip açtıktan sonra, aşağıda gösterilen ana Run yöntemde anlamanız gereken birkaç temel kavram vardır. Azure işlevi, yöntem imzasının Run öznitelikleri kullanılarak uygulanan Tetikleyici ve Çıkış bağlamalarını kullanır.

Table özniteliği iki parametre kullanır. İlk parametre, işlev tarafından döndürülen ayrıştırılmış görüntü metin değerini yazmak için tablonun adını belirtir. İkinci Connection parametre, Azure işlevimizin buna erişebilmesi için ortam değişkenlerinden bir Tablo Depolama bağlantı dizesi çeker.

BlobTrigger özniteliği, işlevimizi Blob Depolama'daki karşıya yükleme olayına bağlamak için kullanılır ve blobu işleve Run yükleyen kaynakları sağlar. Blob tetikleyicisinin kendi iki parametresi vardır: biri karşıya yüklemeleri izlemek için blob kapsayıcısının adı, diğeri de depolama hesabımızın bağlantı dizesi için.

// Azure Function name and output Binding to Table Storage
[FunctionName("ProcessImageUpload")]
[return: Table("ImageText", Connection = "StorageConnection")]
// Trigger binding runs when an image is uploaded to the blob container below
public async Task<ImageContent> Run([BlobTrigger("imageanalysis/{name}", 
        Connection = "StorageConnection")]Stream myBlob, string name, ILogger log)
{
    // Get connection configurations
    string subscriptionKey = Environment.GetEnvironmentVariable("ComputerVisionKey");
    string endpoint = Environment.GetEnvironmentVariable("ComputerVisionEndpoint");
    string imgUrl = $"https://{ Environment.GetEnvironmentVariable("StorageAccountName")}
                        .blob.core.windows.net/imageanalysis/{name}";

    ComputerVisionClient client = new ComputerVisionClient(
        new ApiKeyServiceClientCredentials(subscriptionKey)) { Endpoint = endpoint };

    // Get the analyzed image contents
    var textContext = await AnalyzeImageContent(client, imgUrl);

    return new ImageContent { 
        PartitionKey = "Images",
        RowKey = Guid.NewGuid().ToString(), Text = textContext 
    };
}

public class ImageContent
{
    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    public string Text { get; set; }
}

Bu kod, depolama hesabı bağlantı dizesi ve Görüntü İşleme anahtarı gibi ortam değişkenlerinden temel yapılandırma değerlerini de alır. Bu ortam değişkenlerini dağıtıldıktan sonra Azure İşlevi ortamımıza ekleyeceğiz.

ProcessImage işlevi, aşağıda görülen adlı AnalyzeImageikinci bir yöntemi de kullanır. Bu kod, Görüntü İşleme hesabımızın URL Uç Noktasını ve Anahtarını kullanarak bu sunucuya görüntümüzü işleme isteğinde bulunur. İstek, görüntüde bulunan metnin tümünü döndürür ve ardından yöntemdeki çıkış bağlaması Run kullanılarak Tablo Depolama'ya yazılır.

static async Task<string> ReadFileUrl(ComputerVisionClient client, string urlFile)
{
    // Analyze the file using Computer Vision Client
    var textHeaders = await client.ReadAsync(urlFile);
    string operationLocation = textHeaders.OperationLocation;
    Thread.Sleep(2000);
    
    // Complete code omitted for brevity, view in sample project
    
    return text.ToString();
}

Yerel olarak çalıştırılıyor

Projeyi yerel olarak çalıştırmak isterseniz, local.settings.json dosyasını kullanarak ortam değişkenlerini doldurabilirsiniz. Bu dosyanın içinde yer tutucu değerlerini Azure kaynaklarını oluştururken daha önce kaydettiğiniz değerlerle doldurun.

Azure İşlevi kodu yerel olarak çalışacak olsa da, herhangi bir yerel öykünücü kullanmak yerine Azure'da canlı hizmetlere bağlanmaya devam eder.

{
    "IsEncrypted": false,
    "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "StorageConnection": "your-storage-account-connection-string",
      "StorageAccountName": "your-storage-account-name",
      "ComputerVisionKey": "your-computer-vision-key",
      "ComputerVisionEndPoint":  "your-computer-vision-endpoint"
    }
}

Kodu Azure İşlevleri dağıtma

Artık Visual Studio kullanarak uygulamamızı Azure'a dağıtmaya hazırsınız. Azure İşlevleri uygulamasını Azure'da dağıtım işleminin bir parçası olarak aynı anda da oluşturabilirsiniz.

1. Başlamak için ProcessImage proje düğümünü sağ seçip Yayımla'yı seçin.

2. Yayımla iletişim kutusunda Azure'ı ve ardından İleri'yi seçin.

   

3. Sonraki ekranda Azure İşlev Uygulaması (Windows) veya Azure İşlev Uygulaması (Linux) seçeneğini belirleyin ve sonra yeniden İleri'yi seçin.

   

4. İşlevler örneği adımında, dağıtmak istediğiniz aboneliği seçtiğinizden emin olun. Ardından, iletişim kutusunun sağ tarafındaki yeşil + simgeyi seçin.

5. Yeni bir iletişim kutusu açılır. Yeni İşlev Uygulamanız için aşağıdaki değerleri girin.

   • Ad: msdocsprocessimage veya benzer bir şey girin.
   • Abonelik Adı: Kullanmak istediğiniz aboneliği seçin.
   • Kaynak Grubu: Daha önce oluşturduğunuz kaynak grubunu seçin msdocs-storage-function .
   • Plan Türü: Tüketim'i seçin.
   • Konum: Size en yakın bölgeyi seçin.
   • Azure Depolama: Daha önce oluşturduğunuz depolama hesabını seçin.

   

6. Bu değerlerin tümünü doldurduktan sonra Oluştur'u seçin. Visual Studio ve Azure istenen kaynakları sağlamaya başlar ve tamamlanması birkaç dakika sürer.

7. İşlem tamamlandıktan sonra, iletişim kutusu iş akışını kapatmak için Son'u seçin.

8. Azure İşlevi'ni dağıtmanın son adımı, ekranın sağ üst kısmındaki Yayımla'yı seçmektir. İşlevin yayımlanması da birkaç dakika sürebilir. İşlem tamamlandıktan sonra uygulamanız Azure'da çalışır duruma gelecek.

Hizmetleri bağlama

Azure İşlevi başarıyla dağıtıldı, ancak henüz depolama hesabımıza ve Görüntü İşleme hizmetlerine bağlanamıyor. Doğru anahtarların ve bağlantı dizesi önce Azure İşlevleri uygulamasının yapılandırma ayarlarına eklenmesi gerekir.

1. Azure portalının üst kısmında işlev araması yapın ve sonuçlardan İşlev Uygulaması'nı seçin.

2. İşlev Uygulaması ekranında Visual Studio'da oluşturduğunuz İşlev Uygulamasını seçin.

3. İşlev Uygulamasına genel bakış sayfasında sol gezinti bölmesinde Yapılandırma'yı seçin. Bu, uygulamamız için çeşitli yapılandırma ayarları türlerini yönetebileceğimiz bir sayfa açar. Şimdilik Uygulama Ayarları bölümüyle ilgileniyoruz.

4. Sonraki adım depolama hesabı adı ve bağlantı dizesi, Görüntü İşleme gizli anahtarı ve Görüntü İşleme uç noktası için ayarlar eklemektir.

5. Uygulama ayarları sekmesinde + Yeni uygulama ayarı'nı seçin. Görüntülenen açılır öğeye aşağıdaki değerleri girin:

   • Ad: ComputerVisionKey değerini girin.
   • Değer: Daha önce kaydettiğiniz Görüntü İşleme anahtarını yapıştırın.

6. Bu ayarı uygulamanıza eklemek için Tamam'a tıklayın.

   

7. Şimdi aşağıdaki değerleri kullanarak bu işlemi Görüntü İşleme hizmetimizin uç noktası için yineleyelim:

   • Ad: ComputerVisionEndpoint değerini girin.
   • Değer: Daha önce kaydettiğiniz uç nokta URL'sini yapıştırın.

8. Aşağıdaki değerleri kullanarak depolama hesabı bağlantısı için bu adımı tekrarlayın:

   • Ad: StorageConnection değerini girin.
   • Değer: Daha önce kaydettiğiniz bağlantı dizesi yapıştırın.

9. Son olarak, aşağıdaki değerleri kullanarak depolama hesabı adı için bu işlemi bir kez daha yineleyin:

   • Ad: StorageAccountName değerini girin.
   • Değer: Oluşturduğunuz depolama hesabının adını girin.

10. Bu uygulama ayarlarını ekledikten sonra yapılandırma sayfasının üst kısmındaki Kaydet'i seçtiğinizden emin olun. Kaydetme tamamlandığında, ayarların alındığından emin olmak için Yenile'ye de basabilirsiniz.

Azure işlevimizi farklı hizmetlere bağlamak için gerekli tüm ortam değişkenleri artık yerinde.

Blob Depolama'ya görüntü yükleme

Artık uygulamamızı test etmeye hazırsınız! Kapsayıcıya bir blob yükleyebilir ve ardından görüntüdeki metnin Tablo Depolama'ya kaydedildiğini doğrulayabilirsiniz.

1. İlk olarak, Azure portalının üst kısmında Depolama'yı arayın ve depolama hesabı'nı seçin. Depolama hesabı sayfasında, daha önce oluşturduğunuz hesabı seçin.

2. Ardından, sol gezinti bölmesinde Kapsayıcılar'ı seçin ve daha önce oluşturduğunuz ImageAnalysis kapsayıcısına gidin. Buradan doğrudan tarayıcının içine bir test görüntüsü yükleyebilirsiniz.

   

3. İndirilebilir örnek projenin kökünde images klasörüne dahil edilen birkaç örnek görüntü bulabilir veya kendi resimlerinizden birini kullanabilirsiniz.

4. ImageAnalysis sayfasının üst kısmında Karşıya Yükle'yi seçin. Açılan açılır öğede, sağ taraftaki klasör simgesini seçerek bir dosya tarayıcısı açın. Karşıya yüklemek istediğiniz görüntüyü seçin ve ardından Karşıya Yükle'yi seçin.

   

5. Dosya blob kapsayıcınızın içinde görünmelidir. Ardından, karşıya yüklemenin Azure İşlevi'ni tetiklediğini ve görüntüdeki metnin çözümlenip Tablo Depolama'ya düzgün şekilde kaydedildiğini doğrulayabilirsiniz.

6. Sayfanın üst kısmındaki içerik haritalarını kullanarak depolama hesabınızda bir düzey yukarı gidin. Sol gezinti bölmesinde Depolama tarayıcısı'nı bulup seçin ve ardından Tablolar'ı seçin.

7. ImageText tablosu artık kullanılabilir olmalıdır. İçindeki veri satırlarının önizlemesini görüntülemek için tabloya tıklayın. Karşıya yüklememizin işlenen görüntü metni için bir girdi görmeniz gerekir. Zaman damgasını kullanarak veya Metin sütununun içeriğini görüntüleyerek bunu doğrulayabilirsiniz.

   

Tebrikler! Azure İşlevleri ve Görüntü İşleme kullanarak Blob Depolama'ya yüklenen bir görüntüyü işlemeyi başardınız.

Kaynakları temizleme

Bu uygulamayı kullanmaya devam etmeyecekseniz, kaynak grubunu kaldırarak oluşturduğunuz kaynakları silebilirsiniz.

1. Ana gezintiden Kaynak grupları'nı seçin
2. Listeden msdocs-storage-function kaynak grubunu seçin.
3. Kaynak grubuna genel bakış sayfasının üst kısmındaki Kaynak grubunu sil düğmesini seçin.
4. Onay iletişim kutusuna msdocs-storage-function kaynak grubu adını girin.
5. Sil seçeneğini belirleme. Kaynak grubunu silme işleminin tamamlanması birkaç dakika sürebilir.