Azure İşlevleri için Azure Kuyruk depolama çıkış bağlamaları

Azure İşlevleri bir çıkış bağlaması ayarlayarak yeni Azure Kuyruk depolama iletileri oluşturabilir.

Kurulum ve yapılandırma ayrıntıları hakkında bilgi için genel bakışa bakın.

Önemli

Bu makalede, Node.js programlama modelinin birden çok sürümünü desteklemek için sekmeler kullanılır. Genel kullanıma sunulan v4 modeli, JavaScript ve TypeScript geliştiricileri için daha esnek ve sezgisel bir deneyime sahip olacak şekilde tasarlanmıştır. v4 modelinin nasıl çalıştığı hakkında daha fazla bilgi için Azure İşlevleri Node.js geliştirici kılavuzuna bakın. v3 ile v4 arasındaki farklar hakkında daha fazla bilgi edinmek için geçiş kılavuzuna bakın.

Azure İşlevleri, Python için iki programlama modelini destekler. Bağlamalarınızı tanımlama şekliniz seçtiğiniz programlama modeline bağlıdır.

Python v2 programlama modeli, doğrudan Python işlev kodunuzda dekoratörleri kullanarak bağlamaları tanımlamanıza olanak tanır. Daha fazla bilgi için bkz . Python geliştirici kılavuzu.

Bu makale her iki programlama modelini de destekler.

Örnek

Go desteği şu anda bu bağlama için mevcut değil.

C# işlevi aşağıdaki C# modlarından biri kullanılarak oluşturulabilir:

  • Yalıtılmış çalışan modeli: Çalışma zamanından yalıtılmış bir çalışan işleminde çalışan derlenmiş C# işlevi. LTS ve .NET ve .NET Framework dışındaki sürümlerde çalışan C# işlevlerini desteklemek için yalıtılmış çalışan işlemi gereklidir. Yalıtılmış çalışan işlemi işlevleri için uzantılar ad alanlarını kullanır Microsoft.Azure.Functions.Worker.Extensions.* .
  • İşlem içi model: İşlevler çalışma zamanıyla aynı işlemde çalışan derlenmiş C# işlevi. Bu modelin bir varyasyonunda, İşlevler öncelikle C# portalı düzenleme için desteklenen C# betiği kullanılarak çalıştırılabilir. İşlem içi işlevlerin uzantıları ad alanlarını kullanır Microsoft.Azure.WebJobs.Extensions.* .

Önemli

İşlem içi model desteği 10 Kasım 2026'da sona erecektir. Tam destek için uygulamalarınızı yalıtılmış çalışan modeline geçirmenizi kesinlikle öneririz.

[Function(nameof(QueueInputOutputFunction))]
[QueueOutput("output-queue")]
public string[] QueueInputOutputFunction([QueueTrigger("input-queue")] Album myQueueItem, FunctionContext context)
{
    // Use a string array to return more than one message.
    string[] messages = {
        $"Album name = {myQueueItem.Name}",
        $"Album songs = {myQueueItem.Songs}"};

    _logger.LogInformation("{msg1},{msg2}", messages[0], messages[1]);

    // Queue Output messages
    return messages;
}

Kuyruk depolamaya çıkış bağlamasını yapılandırmaya ilişkin uçtan uca bir örnek için şu makalelerden birine bakın:

Aşağıdaki örnekte, bir HTTP isteği tarafından tetiklendiğinde için kuyruk iletisi oluşturan bir Java işlevi gösterilmektedir.

@FunctionName("httpToQueue")
@QueueOutput(name = "item", queueName = "myqueue-items", connection = "MyStorageConnectionAppSetting")
 public String pushToQueue(
     @HttpTrigger(name = "request", methods = {HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS)
     final String message,
     @HttpOutput(name = "response") final OutputBinding<String> result) {
       result.setValue(message + " has been added.");
       return message;
 }

Java işlevleri çalışma zamanı kitaplığında, değeri Kuyruk depolamaya @QueueOutput yazılacak parametrelerde ek açıklamayı kullanın. Parametre türü olmalıdır OutputBinding<T>, burada T POJO'nun herhangi bir yerel Java türüdür.

Kuyruk depolamaya çıkış bağlamasını yapılandırmaya ilişkin uçtan uca bir örnek için şu makalelerden birine bakın:

Aşağıdaki örnekte, alınan her HTTP isteği için bir kuyruk öğesi oluşturan HTTP ile tetiklenen TypeScript işlevi gösterilmektedir.

import { app, HttpRequest, HttpResponseInit, InvocationContext, output } from '@azure/functions';

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

export async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    const body = await request.text();
    context.extraOutputs.set(queueOutput, body);
    return { body: 'Created queue item.' };
}

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: httpTrigger1,
});

Birden çok iletinin çıktısını almak için tek bir nesne yerine bir dizi döndürebilirsiniz. Örneğin:

context.extraOutputs.set(queueOutput, ['message 1', 'message 2']);

Aşağıdaki örnekte, alınan her HTTP isteği için bir kuyruk öğesi oluşturan HTTP ile tetiklenen JavaScript işlevi gösterilmektedir.

const { app, output } = require('@azure/functions');

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: async (request, context) => {
        const body = await request.text();
        context.extraOutputs.set(queueOutput, body);
        return { body: 'Created queue item.' };
    },
});

Birden çok iletinin çıktısını almak için tek bir nesne yerine bir dizi döndürebilirsiniz. Örneğin:

context.extraOutputs.set(queueOutput, ['message 1', 'message 2']);

Kuyruk depolamaya çıkış bağlamasını yapılandırmaya ilişkin uçtan uca bir örnek için şu makalelerden birine bakın:

Aşağıdaki kod örnekleri, HTTP ile tetiklenen bir işlevden kuyruk iletisinin nasıl çıkarıldığı gösterilmektedir. ile yapılandırma bölümü typequeue çıkış bağlamasını tanımlar.

{
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "Msg",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

PowerShell işlevi bu bağlama yapılandırmasını kullanarak Push-OutputBindingbir kuyruk iletisi oluşturabilir. Bu örnekte, bir sorgu dizesinden veya gövde parametresinden bir ileti oluşturulur.

using namespace System.Net

# Input bindings are passed in via param block.
param($Request, $TriggerMetadata)

# Write to the Azure Functions log stream.
Write-Host "PowerShell HTTP trigger function processed a request."

# Interact with query parameters or the body of the request.
$message = $Request.Query.Message
Push-OutputBinding -Name Msg -Value $message
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = 200
    Body = "OK"
})

Aynı anda birden çok ileti göndermek için bir ileti dizisi tanımlayın ve kuyruk çıkış bağlamasına ileti göndermek için kullanın Push-OutputBinding .

using namespace System.Net

# Input bindings are passed in via param block.
param($Request, $TriggerMetadata)

# Write to the Azure Functions log stream.
Write-Host "PowerShell HTTP trigger function processed a request."

# Interact with query parameters or the body of the request.
$message = @("message1", "message2")
Push-OutputBinding -Name Msg -Value $message
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = 200
    Body = "OK"
})

Kuyruk depolamaya çıkış bağlamasını yapılandırmaya ilişkin uçtan uca bir örnek için şu makalelerden birine bakın:

Aşağıdaki örnek, depolama kuyruklarına tek ve birden çok değerin nasıl çıkış yapılacağını gösterir. function.json için gereken yapılandırma her iki şekilde de aynıdır. Örnek, v1 veya v2 Python programlama modelini kullanıp kullanmadığınıza bağlıdır.

import logging
import azure.functions as func

app = func.FunctionApp()

@app.function_name(name="QueueOutput1")
@app.route(route="message")
@app.queue_output(arg_name="msg", 
                  queue_name="<QUEUE_NAME>", 
                  connection="<CONNECTION_SETTING>")
def main(req: func.HttpRequest, msg: func.Out[str]) -> func.HttpResponse:
    input_msg = req.params.get('name')
    logging.info(input_msg)

    msg.set(input_msg)

    logging.info(f'name: {name}')
    return 'OK'

Kuyruk depolamaya çıkış bağlamasını yapılandırmaya ilişkin uçtan uca bir örnek için şu makalelerden birine bakın:

Özellikler

C# kitaplıklarında çıkış bağlamasını tanımlayan öznitelik, C# sınıf kitaplığının çalıştığı moda bağlıdır.

Yalıtılmış bir çalışan işleminde çalışırken, aşağıdaki örnekte gösterildiği gibi kuyruğun adını alan QueueOutputAttribute'u kullanırsınız:

[Function(nameof(QueueInputOutputFunction))]
[QueueOutput("output-queue")]
public string[] QueueInputOutputFunction([QueueTrigger("input-queue")] Album myQueueItem, FunctionContext context)

Yalıtılmış bir çalışan işleminde çalıştırılırken yalnızca döndürülen değişkenler desteklenir. Çıkış parametreleri kullanılamaz.

Dekoratörler

Yalnızca Python v2 programlama modeli için geçerlidir.

Bir dekoratör kullanılarak tanımlanan Python v2 işlevleri için, üzerinde aşağıdaki özellikler:queue_output

Özellik Açıklama
arg_name İşlev kodundaki kuyruğu temsil eden değişkenin adı.
queue_name Kuyruğun adı.
connection Azure Kuyruklarına nasıl bağlanıldığını belirten bir uygulama ayarının veya ayar koleksiyonunun adı. Bkz. Bağlantılar.

function.json kullanılarak tanımlanan Python işlevleri için Yapılandırma bölümüne bakın.

Ek Açıklamalar

QueueOutput ek açıklaması, bir işlevin çıkışı olarak bir ileti yazmanızı sağlar. Aşağıdaki örnekte kuyruk iletisi oluşturan HTTP ile tetiklenen bir işlev gösterilmektedir.

package com.function;
import java.util.*;
import com.microsoft.azure.functions.annotation.*;
import com.microsoft.azure.functions.*;

public class HttpTriggerQueueOutput {
    @FunctionName("HttpTriggerQueueOutput")
    public HttpResponseMessage run(
            @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.FUNCTION) HttpRequestMessage<Optional<String>> request,
            @QueueOutput(name = "message", queueName = "messages", connection = "MyStorageConnectionAppSetting") OutputBinding<String> message,
            final ExecutionContext context) {

        message.setValue(request.getQueryParameters().get("name"));
        return request.createResponseBuilder(HttpStatus.OK).body("Done").build();
    }
}
Özellik Açıklama
name İşlev imzasında parametre adını bildirir. İşlev tetiklendiğinde, bu parametrenin değeri kuyruk iletisinin içeriğine sahiptir.
queueName Depolama hesabında kuyruk adını bildirir.
connection Depolama hesabı bağlantı dizesi gösterir.

QueueOutput ek açıklamasıyla

Yapılandırma

Yalnızca Python v1 programlama modeli için geçerlidir.

Aşağıdaki tabloda, yöntemine geçirilen options nesnede output.storageQueue() ayarlayabileceğiniz özellikler açıklanmaktadır.

Özellik Açıklama
queueName Kuyruğun adı.
bağlantı Azure Kuyruklarına nasıl bağlanıldığını belirten bir uygulama ayarının veya ayar koleksiyonunun adı. Bkz. Bağlantılar.

Yerel olarak geliştirme yaparken uygulama ayarlarınızı koleksiyondaki local.settings.json dosyasınaValues ekleyin.

Aşağıdaki tabloda, function.json dosyasında ayarladığınız bağlama yapılandırma özellikleri açıklanmaktadır.

function.json özelliği Açıklama
türü olarak ayarlanmalıdır queue. Bu özellik, Tetikleyiciyi Azure portalında oluşturduğunuzda otomatik olarak ayarlanır.
yön olarak ayarlanmalıdır out. Bu özellik, Tetikleyiciyi Azure portalında oluşturduğunuzda otomatik olarak ayarlanır.
ad İşlev kodundaki kuyruğu temsil eden değişkenin adı. İşlev dönüş değerine başvurmak $return için olarak ayarlayın.
queueName Kuyruğun adı.
bağlantı Azure Kuyruklarına nasıl bağlanıldığını belirten bir uygulama ayarının veya ayar koleksiyonunun adı. Bkz. Bağlantılar.

Yerel olarak geliştirme yaparken uygulama ayarlarınızı koleksiyondaki local.settings.json dosyasınaValues ekleyin.

Tam örnekler için Örnek bölümüne bakın.

Kullanım

Kuyruk çıkış bağlamasının kullanımı uzantı paketi sürümüne ve işlev uygulamanızda kullanılan C# modalitesine bağlıdır ve bu da aşağıdakilerden biri olabilir:

Yalıtılmış çalışan işlem sınıfı kitaplığı derlenmiş C# işlevi çalışma zamanından yalıtılmış bir işlemde çalışır.

Modun ve sürümün kullanım ayrıntılarını görmek için bir sürüm seçin.

İşlevin tek bir ileti yazmasını istediğinizde, kuyruk çıkış bağlaması aşağıdaki türlere bağlanabilir:

Türü Açıklama
string dize olarak ileti içeriği. İleti basit bir metin olduğunda kullanın.
byte[] İletinin baytları.
JSON serileştirilebilir türler JSON iletisinin içeriğini temsil eden nesne. İşlevler, düz eski bir CLR nesnesi (POCO) türünü JSON verilerine seri hale getirmeye çalışır.

İşlevin birden çok ileti yazmasını istediğinizde, kuyruk çıkış bağlaması aşağıdaki türlere bağlanabilir:

Türü Açıklama
T[] burada T tek ileti türlerinden biridir Birden çok ileti için içerik içeren bir dizi. Her girdi bir iletiyi temsil eder.

Diğer çıkış senaryoları için, doğrudan Azure.Storage.Queues'tanbaşka türlerle queueclient oluşturun ve kullanın. Azure SDK'dan bir istemci türü oluşturmak için bağımlılık ekleme kullanma örneği için bkz . Azure istemcilerini kaydetme.

QueueOutput ek açıklamasını kullanarak bir işlevden kuyruğa yazmak için iki seçenek vardır:

  • Dönüş değeri: Ek açıklama işlevin kendisine uygulanarak işlevin dönüş değeri kuyruğa yazılır.

  • Kesinlik: İleti değerini açıkça ayarlamak için ek açıklamayı, pojo veya herhangi bir yerel Java türü olan OutputBinding<T> türündeki Tbelirli bir parametreye uygulayın. Bu yapılandırmayla, yöntemine setValue bir değer geçirerek değeri kuyruğa yazar.

Değeri doğrudan döndürerek veya kullanarak context.extraOutputs.set()çıkış kuyruğu öğesine erişin. Kuyruk öğesi yükü için bir dize veya JSON serileştirilebilir nesnesi kullanabilirsiniz.

Kuyruk iletisinin çıktısı, bağlamanın parametresi Push-OutputBinding dosyasında geçirdiğiniz name yerde kullanılabilir.

İşlevinizden yapılandırılan kuyruğa yazmak için iki seçenek vardır:

  • Dönüş değeri: function.jsonnameolarak ayarlayın$return. Bu yapılandırmayla işlevin dönüş değeri Kuyruk depolama iletisi olarak kalıcı hale getirilir.

  • Kesinlik: Out türü olarak bildirilen parametrenin set yöntemine bir değer geçirin. 'a set geçirilen değer Kuyruk depolama iletisi olarak kalıcıdır.

Çıkış işlevi parametresi , func.Out[func.QueueMessage]veya func.Out[str]olarak func.Out[bytes]tanımlanmalıdır. Ayrıntılar için çıkış örneğine bakın.

Bağlantılar

Bu özellik, connection uygulama ayarlarında Functions çalışma zamanında uzantının kullandığı depolama hesabına bağlanmak için kullanılan bir değeri döndüren bir anahtara ayarlanmıştır. Bağlantı özellik ayarının değeri, bağlantı türüne bağlıdır:

  • Yönetilen kimlik bağlantısı: Özellik, connection<CONNECTION_NAME_PREFIX> depolama hesabına kimlik tabanlı bir bağlantı tanımlayan bir grup ayar tarafından paylaşılan bir özelliktir. Daha fazla bilgi için bkz. Kimlik bağlantılarını tanımlar.
  • Key Vault referansı: Özellik connection ayarı, bağlantı dizesi'in merkezi olarak korunduğu konuma Azure Key Vault referansı döner. Daha fazla bilgi için Define Key Vault bağlantılarını tanımla.
  • App Configuration referansı: Özellik connection ayarı, bağlantı dizesi veya Key Vault referansı döndüren bir Azure Uygulama Yapılandırması referansı döndürür. Daha fazla bilgi için connections makalesindeki Azure Uygulama Yapılandırması'a bakınız.
  • Connection string: Özellik connection ayarı gerçek depolama hesabı bağlantı dizesi'i döndürür. Çünkü bağlantı dizesi paylaşılan gizli anahtarlar içerir, mümkün olduğunda yönetilen bir kimlik bağlantısı kullanmayı düşünmelisiniz. Daha fazla bilgi için bkz. Bağlantıları tanımlar.

Bağlama bağlantıları hakkında daha fazla bilgi edinmek için Azure İşlevleri'te bağlantıyı yönet bölümüne bakınız. bağlantı dizesi almak için Depolama hesabı erişim anahtarlarını yönetme bölümünde gösterilen adımları izleyin.

Bir anahtar veya anahtar öneki ya da connection boş bir diziye ayarladığınızdaAzureWebJobsStorage, bağlama uzantısı varsayılan host depolama hesabını kullanır. Daha fazla bilgi için bkz. Depolama performansını optimize et.

Özel durumlar ve dönüş kodları

Bağlama Başvuru
Sıra Kuyruk Hata Kodları
Blob, Tablo, Kuyruk Depolama Hata Kodları
Blob, Tablo, Kuyruk Sorun giderme

Sonraki adımlar

  • Last updated on