Azure Queue Storage-trigger en bindingen voor Azure Functions-overzichtAzure Queue storage trigger and bindings for Azure Functions overview

Azure Functions kunnen worden uitgevoerd als nieuwe Azure Queue-opslag berichten worden gemaakt en kunnen wachtrij berichten binnen een functie worden geschreven.Azure Functions can run as new Azure Queue storage messages are created and can write queue messages within a function.

BewerkingAction TypeType
Een functie uitvoeren als gegevens wijzigingen in de wachtrij-opslagRun a function as queue storage data changes TriggerTrigger
Wachtrij opslag berichten schrijvenWrite queue storage messages Uitvoer bindingOutput binding

Toevoegen aan uw functions-appAdd to your Functions app

Functions 2.x en hogerFunctions 2.x and higher

Voor het werken met de trigger en bindingen moet u verwijzen naar het juiste pakket.Working with the trigger and bindings requires that you reference the appropriate package. Het NuGet-pakket wordt gebruikt voor .NET-klassen bibliotheken terwijl de uitbreidings bundel wordt gebruikt voor alle andere toepassings typen.The NuGet package is used for .NET class libraries while the extension bundle is used for all other application types.

TaalLanguage Toevoegen door...Add by... OpmerkingenRemarks
C#C# Het NuGet-pakketinstalleren, versie 3. xInstalling the NuGet package, version 3.x
C#-script, Java, java script, Python, Power shellC# Script, Java, JavaScript, Python, PowerShell De uitbreidings bundel registrerenRegistering the extension bundle De extensie voor Azure-Hulpprogram ma's wordt aanbevolen voor gebruik met Visual Studio code.The Azure Tools extension is recommended to use with Visual Studio Code.
C#-script (alleen online in Azure Portal)C# Script (online-only in Azure portal) Een binding toevoegenAdding a binding Zie uw extensies bijwerkenom bestaande bindings extensies bij te werken zonder uw functie-app opnieuw te publiceren.To update existing binding extensions without having to republish your function app, see Update your extensions.

Opslag extensie 5. x en hogerStorage extension 5.x and higher

Er is een nieuwe versie van de opslag bindingen uitbrei ding beschikbaar als Preview-NuGet-pakket.A new version of the Storage bindings extension is available as a preview NuGet package. Deze preview introduceert de mogelijkheid om verbinding te maken met een identiteit in plaats van een geheim.This preview introduces the ability to connect using an identity instead of a secret. Voor .NET-toepassingen worden ook de typen gewijzigd waarmee u een binding kunt maken, waarbij de typen van WindowsAzure.Storage en Microsoft.Azure.Storage met nieuwere typen van Azure. storage. queuesworden vervangen.For .NET applications, it also changes the types that you can bind to, replacing the types from WindowsAzure.Storage and Microsoft.Azure.Storage with newer types from Azure.Storage.Queues.

Notitie

Het preview-pakket is niet opgenomen in een uitbreidings bundel en moet hand matig worden geïnstalleerd.The preview package is not included in an extension bundle and must be installed manually. Voor .NET-Apps voegt u een verwijzing naar het pakket toe.For .NET apps, add a reference to the package. Voor alle andere typen apps raadpleegt [u uw extensies bijwerken].For all other app types, see Update your extensions.

Functions 1.xFunctions 1.x

Functions 1. x apps hebben automatisch een verwijzing naar het pakket micro soft. Azure. webjobs , versie 2. x.Functions 1.x apps automatically have a reference the Microsoft.Azure.WebJobs NuGet package, version 2.x.

Azure Storage SDK-versie in Functions 1.xAzure Storage SDK version in Functions 1.x

In Functions 1.x maken de Storage-triggers en -bindingen gebruik van versie 7.2.1 van de Azure Storage-SDK (WindowsAzure.Storage NuGet-pakket).In Functions 1.x, the Storage triggers and bindings use version 7.2.1 of the Azure Storage SDK (WindowsAzure.Storage NuGet package). Als u naar een andere versie van de Storage-SDK verwijst en een aan Storage-SDK-type bindt in uw functiehandtekening, rapporteert de Function-runtime mogelijk dat het niet kan binden met dat yype.If you reference a different version of the Storage SDK, and you bind to a Storage SDK type in your function signature, the Functions runtime may report that it can't bind to that type. De oplossing is om ervoor te zorgen dat uw project verwijst naar WindowsAzure.Storage 7.2.1.The solution is to make sure your project references WindowsAzure.Storage 7.2.1.

host.jsop instellingenhost.json settings

In deze sectie worden de algemene configuratie-instellingen beschreven die beschikbaar zijn voor deze binding in versie 2. x en hoger.This section describes the global configuration settings available for this binding in versions 2.x and higher. In het volgende voor beeld host.jsin het onderstaande bestand bevat alleen de instellingen van versie 2. x + voor deze binding.The example host.json file below contains only the version 2.x+ settings for this binding. Zie voor meer informatie over globale configuratie-instellingen in versie 2. x en verder host.jsop referentie voor Azure functions.For more information about global configuration settings in versions 2.x and beyond, see host.json reference for Azure Functions.

Notitie

Zie host.jsbij verwijzing voor Azure functions 1. xvoor een referentie van host.jsin in functions 1. x.For a reference of host.json in Functions 1.x, see host.json reference for Azure Functions 1.x.

{
    "version": "2.0",
    "extensions": {
        "queues": {
            "maxPollingInterval": "00:00:02",
            "visibilityTimeout" : "00:00:30",
            "batchSize": 16,
            "maxDequeueCount": 5,
            "newBatchThreshold": 8,
            "messageEncoding": "base64"
        }
    }
}
EigenschapProperty StandaardDefault BeschrijvingDescription
maxPollingIntervalmaxPollingInterval 00:00:0100:00:01 Het maximum interval tussen de polls van de wachtrij.The maximum interval between queue polls. Minimum is 00:00:00.100 (100 MS) en wordt verhoogd naar 00:01:00 (1 min.).Minimum is 00:00:00.100 (100 ms) and increments up to 00:01:00 (1 min). In functions 2. x en hoger is het gegevens type a TimeSpan , terwijl u in versie 1. x in milliseconden.In Functions 2.x and higher the data type is a TimeSpan, while in version 1.x it is in milliseconds.
visibilityTimeoutvisibilityTimeout 00:00:0000:00:00 Het tijds interval tussen nieuwe pogingen wanneer het verwerken van een bericht mislukt.The time interval between retries when processing of a message fails.
batchSizebatchSize 1616 Het aantal wachtrij berichten dat door de functions-runtime gelijktijdig wordt opgehaald en processen parallel.The number of queue messages that the Functions runtime retrieves simultaneously and processes in parallel. Wanneer het nummer dat wordt verwerkt, naar de wordt verwerk newBatchThreshold , wordt er door de runtime een andere batch opgehaald en worden deze berichten verwerkt.When the number being processed gets down to the newBatchThreshold, the runtime gets another batch and starts processing those messages. Het maximum aantal gelijktijdige berichten dat per functie wordt verwerkt, is batchSize plus newBatchThreshold .So the maximum number of concurrent messages being processed per function is batchSize plus newBatchThreshold. Deze limiet geldt afzonderlijk voor elke door de wachtrij geactiveerde functie.This limit applies separately to each queue-triggered function.

Als u een parallelle uitvoering wilt voor komen voor berichten die worden ontvangen op één wachtrij, kunt u instellen batchSize op 1.If you want to avoid parallel execution for messages received on one queue, you can set batchSize to 1. Met deze instelling wordt de gelijktijdigheid echter geëlimineerd, zolang uw functie-app alleen op één virtuele machine (VM) wordt uitgevoerd.However, this setting eliminates concurrency as long as your function app runs only on a single virtual machine (VM). Als de functie-app wordt geschaald naar meerdere Vm's, kan elke virtuele machine één exemplaar van elke door de wachtrij geactiveerde functie uitvoeren.If the function app scales out to multiple VMs, each VM could run one instance of each queue-triggered function.

De maximum waarde batchSize is 32.The maximum batchSize is 32.
maxDequeueCountmaxDequeueCount 55 Het aantal keren dat een bericht moet worden verwerkt voordat het naar de verontreinigde wachtrij wordt verplaatst.The number of times to try processing a message before moving it to the poison queue.
newBatchThresholdnewBatchThreshold batchSize/2batchSize/2 Telkens wanneer het aantal berichten dat gelijktijdig wordt verwerkt, naar dit nummer wordt opgehaald, haalt de runtime een andere batch op.Whenever the number of messages being processed concurrently gets down to this number, the runtime retrieves another batch.
messageEncodingmessageEncoding base64base64 Deze instelling is alleen beschikbaar in extensie versie 5.0.0 en hoger.This setting is only available in extension version 5.0.0 and higher. Het vertegenwoordigt de coderings indeling voor berichten.It represents the encoding format for messages. Geldige waarden zijn base64 en none .Valid values are base64 and none.

Volgende stappenNext steps