Creare una funzione di Azure che si connette a un database Azure Cosmos DB | Documentazione MicrosoftCreate an Azure Function that connects to an Azure Cosmos DB

Questo script di esempio di Funzioni di Azure crea un'app per le funzioni e connette la funzione a un database di Azure Cosmos DB.This Azure Functions sample script creates a function app and connects the function to an Azure Cosmos DB database. L'impostazione dell'app creata che contiene la connessione può essere usata con un trigger o un binding di Azure Cosmos DB.The created app setting that contains the connection can be used with an Azure Cosmos DB trigger or binding.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Aprire Azure Cloud ShellOpen Azure Cloud Shell

Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo.Azure Cloud Shell is a free, interactive shell that you can use to run the steps in this article. Gli strumenti comuni di Azure sono preinstallati e configurati in Cloud Shell per l'uso con l'account.Common Azure tools are preinstalled and configured in Cloud Shell for you to use with your account. È sufficiente selezionare il pulsante Copia per copiare il codice, incollarlo in Cloud Shell e quindi premere INVIO per eseguirlo.Just select the Copy button to copy the code, paste it in Cloud Shell, and then press Enter to run it. Esistono alcuni modi per aprire Cloud Shell:There are a few ways to open Cloud Shell:

Selezionare Prova nell'angolo superiore destro di un blocco di codice.Select Try It in the upper-right corner of a code block. Cloud Shell in questo articolo
Aprire Cloud Shell nel browser.Open Cloud Shell in your browser. https://shell.azure.com/bash
Selezionare il pulsante Cloud Shell nel menu nell'angolo superiore destro del portale di Azure.Select the Cloud Shell button on the menu in the upper-right corner of the Azure portal. Cloud Shell nel portale

Se si usa l'interfaccia della riga di comando in locale, assicurarsi di eseguire l'interfaccia della riga di comando di Azure versione 2.0 o successiva.If you use the CLI locally, make sure that you are running the Azure CLI version 2.0 or later. Per trovare la versione, eseguire az --version.To find the version, run az --version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure 2.0.If you need to install or upgrade, see Install Azure CLI 2.0.

Script di esempioSample script

In questo esempio si crea un'app per le funzioni di Azure e si aggiunge un endpoint Cosmos DB e la chiave di accesso alle impostazioni dell'app.This sample creates an Azure Function app and adds a Cosmos DB endpoint and access key to app settings.

#!/bin/bash

# create a resource group with location
az group create \
  --name myResourceGroup \
  --location westeurope

# create a storage account 
az storage account create \
  --name funccosmosdbstore \
  --location westeurope \
  --resource-group myResourceGroup \
  --sku Standard_LRS

# create a new function app, assign it to the resource group you have just created
az functionapp create \
  --name myfunccosmosdb \
  --resource-group myResourceGroup \
  --storage-account funccosmosdbstore \
  --consumption-plan-location westeurope

# create cosmosdb database, name must be lowercase.
az cosmosdb create \
  --name myfunccosmosdb \
  --resource-group myResourceGroup

# Retrieve cosmosdb connection string
endpoint=$(az cosmosdb show \
  --name myfunccosmosdb \
  --resource-group myResourceGroup \
  --query documentEndpoint \
  --output tsv)

key=$(az cosmosdb list-keys \
  --name myfunccosmosdb \
  --resource-group myResourceGroup \
  --query primaryMasterKey \
  --output tsv)

# configure function app settings to use cosmosdb connection string
az functionapp config appsettings set \
  --name myfunccosmosdb \
  --resource-group myResourceGroup \
  --setting CosmosDB_Endpoint=$endpoint CosmosDB_Key=$key

Pulire la distribuzioneClean up deployment

Dopo l'esecuzione dello script di esempio, è possibile usare il comando seguente per rimuovere il gruppo di risorse e tutte le risorse ad esso associate.After the sample script has been run, the following command can be used to remove the resource group and all resources associated with it.

az group delete --name myResourceGroup

Spiegazione dello scriptScript explanation

Lo script usa i seguenti comandi: ogni comando della tabella include collegamenti alla documentazione specifica del comando.This script uses the following commands: Each command in the table links to command specific documentation.

ComandoCommand NoteNotes
az loginaz login Accedere ad Azure.Log in to Azure.
az group createaz group create Creare un gruppo di risorse con una posizioneCreate a resource group with location
az storage accounts createaz storage accounts create Creare un account di archiviazioneCreate a storage account
az functionapp createaz functionapp create Creare una nuova app per le funzioniCreate a new function app
az cosmosdb createaz cosmosdb create Creare un database cosmosdbCreate cosmosdb database
az group deleteaz group delete Eseguire la puliziaClean up

Passaggi successiviNext steps

Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.For more information on the Azure CLI, see Azure CLI documentation.

Altri esempi di script dell'interfaccia della riga di comando di Funzioni di Azure sono disponibili nella documentazione di Funzioni di Azure.Additional Azure Functions CLI script samples can be found in the Azure Functions documentation.