Aggiungere messaggi a una coda di archiviazione di Azure tramite FunzioniAdd messages to an Azure Storage queue using Functions

In Funzioni di Azure, i binding di input e di output forniscono una modalità dichiarativa per connettersi a dati di servizio esterni dalla funzione.In Azure Functions, input and output bindings provide a declarative way to connect to external service data from your function. Questo argomento illustra come aggiornare una funzione esistente mediante l'aggiunta di un binding di output che invia messaggi all'archiviazione code di Azure.In this topic, learn how to update an existing function by adding an output binding that sends messages to Azure Queue storage.

Visualizzare il messaggio nei log.

PrerequisitiPrerequisites

Questo argomento usa per iniziare le risorse create in Creare la prima funzione nel portale di Azure.This topic uses as its starting point the resources created in Create your first function from the Azure portal. Se queste procedure non sono state ancora completate, completarle ora per creare l'app per le funzioni.If you haven't already done so, please complete these steps now to create your function app.

Aggiungere un binding di outputAdd an output binding

  1. Espandere sia l'app per le funzioni sia la funzione.Expand both your function app and your function.

  2. Selezionare Integrazione, + Nuovo output e quindi scegliere Archiviazione code di Azure e Seleziona.Select Integrate and + New output, then choose Azure Queue storage and choose Select.

    Aggiungere un binding di output di Archiviazione code a una funzione nel portale di Azure.

  3. Usare le impostazioni specificate nella tabella:Use the settings as specified in the table:

    Aggiungere un binding di output di Archiviazione code a una funzione nel portale di Azure.

    ImpostazioneSetting Valore consigliatoSuggested value DescrizioneDescription
    Nome codaQueue name myqueue-itemsmyqueue-items Nome della coda a cui connettersi nell'account di archiviazione.The name of the queue to connect to in your Storage account.
    Connessione dell'account di archiviazioneStorage account connection AzureWebJobStorageAzureWebJobStorage È possibile usare la connessione dell'account di archiviazione già usata dall'app per le funzioni oppure crearne una nuova.You can use the storage account connection already being used by your function app, or create a new one.
    Nome del parametro del messaggioMessage parameter name outputQueueItemoutputQueueItem Nome del parametro di binding di output.The name of the output binding parameter.
  4. Fare clic su Salva per aggiungere il binding.Click Save to add the binding.

Dopo aver definito un binding di output, è necessario ora aggiornare il codice in modo da usare il binding per aggiungere messaggi a una coda.Now that you have an output binding defined, you need to update the code to use the binding to add messages to a queue.

Aggiornare il codice funzioneUpdate the function code

  1. Selezionare la funzione per visualizzare il codice funzione nell'editor.Select your function to display the function code in the editor.

  2. Per una funzione C#, aggiornare la definizione di funzione come illustrato di seguito per aggiungere il parametro di binding di archiviazione outputQueueItem.For a C# function, update your function definition as follows to add the outputQueueItem storage binding parameter. Ignorare questo passaggio per le funzioni JavaScript.Skip this step for a JavaScript function.

    public static async Task<HttpResponseMessage> Run(HttpRequestMessage req, 
        ICollector<string> outputQueueItem, TraceWriter log)
    {
        ....
    }
    
  3. Aggiungere il codice seguente alla funzione poco prima che venga restituito il metodo.Add the following code to the function just before the method returns. Usare il frammento appropriato per il linguaggio della funzione.Use the appropriate snippet for the language of your function.

    context.bindings.outputQueueItem = "Name passed to the function: " + 
                (req.query.name || req.body.name);
    
    outputQueueItem.Add("Name passed to the function: " + name);     
    
  4. Selezionare Salva per salvare le modifiche.Select Save to save changes.

Il valore passato al trigger HTTP è incluso in un messaggio aggiunto alla coda.The value passed to the HTTP trigger is included in a message added to the queue.

Testare la funzioneTest the function

  1. Dopo aver salvato le modifiche al codice, selezionare Esegui.After the code changes are saved, select Run.

    Aggiungere un binding di output di Archiviazione code a una funzione nel portale di Azure.

  2. Controllare i log per assicurarsi che la funzione abbia avuto esito positivo.Check the logs to make sure that the function succeeded. Quando il binding di output viene usato per la prima volta, nell'account di archiviazione viene creata dal runtime Funzioni una nuova coda denominata outqueue.A new queue named outqueue is created in your Storage account by the Functions runtime when the output binding is first used.

È possibile quindi connettersi all'account di archiviazione per verificare la nuova coda e il messaggio aggiunto.Next, you can connect to your storage account to verify the new queue and the message you added to it.

Connettersi alla codaConnect to the queue

Ignorare i primi tre passaggi se Esplora archivi è già stato installato e connesso all'account di archiviazione.Skip the first three steps if you have already installed Storage Explorer and connected it to your storage account.

  1. Nella funzione scegliere Integrazione e il nuovo binding di output Archiviazione code di Azure e quindi espandere Documentazione.In your function, choose Integrate and the new Azure Queue storage output binding, then expand Documentation. Copiare sia Nome account sia Chiave account.Copy both Account name and Account key. Usare queste credenziali per connettersi all'account di archiviazione.You use these credentials to connect to the storage account.

    Ottenere le credenziali per la connessione all'account di archiviazione.

  2. Eseguire lo strumento Microsoft Azure Storage Explorer, selezionare l'icona di connessione a sinistra, scegliere Use a storage account name and key (Usare il nome e la chiave di un account di archiviazione) e selezionare Avanti.Run the Microsoft Azure Storage Explorer tool, select the connect icon on the left, choose Use a storage account name and key, and select Next.

    Eseguire lo strumento di esplorazione dell'account di archiviazione.

  3. Incollare il Nome account e la Chiave dell'account dal Passaggio 1 nei rispettivi campi corrispondenti, quindi selezionare Avanti e infine Connetti.Paste the Account name and Account key from step 1 into their corresponding fields, then select Next, and Connect.

    Incollare le credenziali di archiviazione ed eseguire la connessione.

  4. Espandere l'account di archiviazione associato e Code e quindi verificare che esista una coda denominata myqueue-items.Expand the attached storage account, expand Queues and verify that a queue named myqueue-items exists. Dovrebbe anche essere presente un messaggio nella coda.You should also see a message already in the queue.

    Creare una coda di archiviazione.

Pulire le risorseClean up resources

Altre guide introduttive di questa raccolta si basano sui valori di questa guida introduttiva.Other quick starts in this collection build upon this quick start. Se si prevede di continuare a usare le guide introduttive successive o le esercitazioni, non eliminare le risorse create in questa guida introduttiva.If you plan to continue on to work with subsequent quick starts or with the tutorials, do not clean up the resources created in this quick start.

Se non si prevede di continuare, fare clic su Gruppo di risorse per l'app per le funzioni nel portale e quindi fare clic su Elimina.If you do not plan to continue, click the Resource group for the function app in the portal, and then click Delete.

Selezionare il gruppo di risorse da eliminare dall'app per le funzioni.

Passaggi successiviNext steps

È stato aggiunto un binding di output a una funzione esistente.You have added an output binding to an existing function.

Informazioni su come creare funzioni con altri tipi di trigger o come integrare funzioni con altri servizi di Azure.Learn how to create functions with other kinds of triggers or how to integrate functions with other Azure services.

Per altre informazioni sul binding all'archiviazione code, vedere Associazioni della coda dell'archiviazione di Funzioni di Azure.For more information about binding to Queue storage, see Azure Functions Storage queue bindings.