Creare una funzione attivata dall'archiviazione code di AzureCreate a function triggered by Azure Queue storage

Informazioni su come creare una funzione attivata nel momento in cui vengono inviati messaggi a una coda di archiviazione di Azure.Learn how to create a function triggered when messages are submitted to an Azure Storage queue.

Visualizzare il messaggio nei log.

PrerequisitiPrerequisites

Funzioni preferite nel portaleFavorite Functions in the portal

Se non è già stato fatto, aggiungere App per le funzioni ai Preferiti del portale di Azure,If you haven't already done so, add Function Apps to your favorites in the Azure portal. in modo da trovare più facilmente le app per le funzioni.This makes it easier to find your function apps. Se è stato già fatto, passare alla sezione successiva.If you have already done this, skip to the next section.

  1. Accedere al Portale di Azure.Log in to the Azure portal.

  2. Fare clic sulla freccia in basso a sinistra per espandere tutti i servizi, digitare Functions nel campo Filtro e quindi fare clic sulla stella accanto a App per le funzioni.Click the arrow at the bottom left to expand all services, type Functions in the Filter field, and then click the star next to Function Apps.

    Creare un'app per le funzioni nel portale di Azure

    L'icona Funzioni viene aggiunta al menu disponibile nella parte sinistra del portale.This adds the Functions icon to the menu on the left of the portal.

  3. Chiudere il menu e scorrere verso il basso fino a trovare l'icona Funzioni.Close the menu, then scroll down to the bottom to see the Functions icon. Fare clic sull'icona per visualizzare l'elenco di tutte le app per le funzioni.Click this icon to see a list of all your function apps. Fare clic sull'app per le funzioni per eseguire operazioni sulle funzioni all'interno dell'app.Click your function app to work with functions in this app.

    App per le funzioni nei Preferiti

Creare un'app per le funzioni di AzureCreate an Azure Function app

  1. Fare clic sul pulsante Nuovo nell'angolo superiore sinistro del portale di Azure e quindi selezionare Calcolo > App per le funzioni.Click the New button found on the upper left-hand corner of the Azure portal, then select Compute > Function App.

    Creare un'app per le funzioni nel portale di Azure

  2. Usare le impostazioni dell'app per le funzioni come indicato nella tabella sottostante l'immagine.Use the function app settings as specified in the table below the image.

    Definire nuove impostazioni dell'app per le funzioni

    ImpostazioneSetting Valore consigliatoSuggested value DescrizioneDescription
    Nome appApp name Nome globalmente univocoGlobally unique name Nome che identifica la nuova app per le funzioni.Name that identifies your new function app. I caratteri validi sono a-z, 0-9 e -.Valid characters are a-z, 0-9, and -.
    SottoscrizioneSubscription Sottoscrizione in usoYour subscription La sottoscrizione in cui verrà creata questa nuova app per le funzioni.The subscription under which this new function app will be created.
    Gruppo di risorseResource Group myResourceGroupmyResourceGroup Nome del nuovo gruppo di risorse in cui creare l'app per le funzioni.Name for the new resource group in which to create your function app.
    Sistema operativoOS WindowsWindows L'hosting senza server attualmente è disponibile solo in un ambiente di esecuzione su Windows.Serverless hosting is currently only available when running on Windows. Per l'hosting su Linux, vedere Creare la prima funzione eseguita in Linux usando l'interfaccia della riga di comando di Azure.For Linux hosting, see Create your first function running on Linux using the Azure CLI.
    Piano di hostingHosting plan Piano a consumoConsumption plan Piano di hosting che definisce come vengono allocate le risorse all'app per le funzioni.Hosting plan that defines how resources are allocated to your function app. Nel piano a consumo predefinito le risorse vengono aggiunte dinamicamente in base alle esigenze delle funzioni.In the default Consumption Plan, resources are added dynamically as required by your functions. In questo hosting senza server si paga solo per il periodo in cui le funzioni sono in esecuzione.In this serverless hosting, you only pay for the time your functions run.
    PosizioneLocation Europa occidentaleWest Europe Scegliere una località nelle vicinanze o vicino ad altri servizi a cui accederanno le funzioni.Choose a location near you or near other services your functions will access.
    Account di archiviazioneStorage account Nome globalmente univocoGlobally unique name Nome del nuovo account di archiviazione usato dall'app per le funzioni.Name of the new storage account used by your function app. I nomi degli account di archiviazione devono avere una lunghezza compresa tra 3 e 24 caratteri e possono contenere solo numeri e lettere minuscole.Storage account names must be between 3 and 24 characters in length and may contain numbers and lowercase letters only. È possibile anche usare un account esistente.You can also use an existing account.
  3. Fare clic su Crea per effettuare il provisioning della nuova app per le funzioni e distribuirla.Click Create to provision and deploy the new function app.

App per le funzioni creata correttamente.

Si creerà ora una funzione nella nuova app per le funzioni.Next, you create a function in the new function app.

Creare una funzione attivata da una codaCreate a Queue triggered function

  1. Espandere l'app per le funzioni e fare clic sul pulsante + accanto a Funzioni.Expand your function app and click the + button next to Functions. Se questa è la prima funzione nell'app per le funzioni, selezionare Funzione personalizzata.If this is the first function in your function app, select Custom function. Verrà visualizzato il set completo di modelli di funzione.This displays the complete set of function templates.

    Pagina della guida introduttiva di Funzioni nel portale di Azure

  2. Selezionare il modello QueueTrigger per la lingua desiderata e usare le impostazioni specificate nella tabella.Select the QueueTrigger template for your desired language, and use the settings as specified in the table.

    Creare una funzione attivata da una coda di archiviazione.

    ImpostazioneSetting Valore consigliatoSuggested value DescrizioneDescription
    Dare un nome alla funzioneName your function Univoco nell'app per le funzioniUnique in your function app Nome della funzione attivata dalla coda.Name of this queue triggered function.
    Nome codaQueue name myqueue-itemsmyqueue-items Nome della coda a cui connettersi nell'account di archiviazione.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.
  3. Fare clic su Crea per creare la funzione.Click Create to create your function.

Connettersi quindi all'account di archiviazione di Azure e creare la coda di archiviazione myqueue-items.Next, you connect to your Azure Storage account and create the myqueue-items storage queue.

Creare la codaCreate the queue

  1. Nella funzione fare clic su Integrazione, espandere Documentazione e copiare sia Nome account sia Chiave account.In your function, click Integrate, expand Documentation, and copy both Account name and Account key. Usare queste credenziali per connettersi all'account di archiviazione in Azure Storage Explorer.You use these credentials to connect to the storage account in Azure Storage Explorer. Se si è già connessi all'account di archiviazione, andare al passaggio 4.If you have already connected your storage account, skip to step 4.

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

  2. Eseguire lo strumento Microsoft Azure Storage Explorer, fare clic sull'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 fare clic su Avanti.Run the Microsoft Azure Storage Explorer tool, click the connect icon on the left, choose Use a storage account name and key, and click Next.

    Eseguire lo strumento di esplorazione dell'account di archiviazione.

  3. Immettere i valori Nome account e Chiave account definiti nel passaggio 1, fare clic su Avanti e quindi su Connetti.Enter the Account name and Account key from step 1, click Next and then Connect.

    Immettere le credenziali di archiviazione ed eseguire la connessione.

  4. Espandere l'account di archiviazione associato, fare doppio clic su Code, fare clic su Crea coda, digitare myqueue-items e quindi premere INVIO.Expand the attached storage account, right-click Queues, click Create Queue, type myqueue-items, and then press enter.

    Creare una coda di archiviazione.

È possibile ora testare la funzione aggiungendo un messaggio alla coda.Now that you have a storage queue, you can test the function by adding a message to the queue.

Testare la funzioneTest the function

  1. Tornare al portale di Azure, selezionare la funzione, espandere i log nella parte inferiore della pagina e assicurarsi che lo streaming dei log non sia stato interrotto.Back in the Azure portal, browse to your function, expand the Logs at the bottom of the page, and make sure that log streaming isn't paused.

  2. In Esplora archivi espandere l'account di archiviazione, Code e myqueue-items e quindi fare clic su Aggiungi messaggio.In Storage Explorer, expand your storage account, Queues, and myqueue-items, then click Add message.

    Aggiungere un messaggio alla coda.

  3. Digitare il proprio messaggio di benvenutoType your "Hello World!" nel campo Testo del messaggio e fare clic su OK.message in Message text and click OK.

  4. Attendere alcuni secondi, tornare ai log di funzione e verificare che il nuovo messaggio sia stato letto dalla coda.Wait for a few seconds, then go back to your function logs and verify that the new message has been read from the queue.

    Visualizzare il messaggio nei log.

  5. Tornare a Esplora archivi, fare clic su Aggiorna e verificare che il messaggio sia stato elaborato e non sia più in coda.Back in Storage Explorer, click Refresh and verify that the message has been processed and is no longer in the queue.

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

È stata creata una funzione che viene eseguita nel momento in cui un messaggio viene aggiunto a una coda di archiviazione.You have created a function that runs when a message is added to a storage queue.

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 sui trigger dell'archiviazione code, vedere Associazioni della coda dell'archiviazione di Funzioni di Azure.For more information about Queue storage triggers, see Azure Functions Storage queue bindings.