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 crea un'app per le funzioni di Azure e si connette a un database Azure Cosmos DB.This sample script creates an Azure Function App and connects to an Azure Cosmos DB database.

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.

Avviare Azure Cloud ShellLaunch Azure Cloud Shell

Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo.The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. Include strumenti comuni di Azure preinstallati e configurati per l'uso con l'account.It has common Azure tools preinstalled and configured to use with your account. È sufficiente fare clic su Copia per copiare il codice, incollarlo in Cloud Shell e quindi premere INVIO per eseguirlo.Just click the Copy to copy the code, paste it into the Cloud Shell, and then press enter to run it. Esistono due modi per avviare Cloud Shell:There are two ways to launch the Cloud Shell:

Fare clic su Prova nell'angolo superiore destro di un blocco di codice.Click Try It in the upper right corner of a code block. Cloud Shell in questo articolo
Fare clic sul pulsante Cloud Shell nel menu in alto a destra nel portale di Azure.Click the Cloud Shell button on the menu in the upper right 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, eseguire il comando seguente per rimuovere il gruppo di risorse e tutte le risorse correlate.After the script sample has been run, the follow command can be used to remove the resource group and all related resources.

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.