Creare una funzione di Azure che si connette a un database Azure Cosmos DB | Documentazione Microsoft

Questo script di esempio crea un'app per le funzioni di Azure e si connette a un database Azure Cosmos DB.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Avviare Azure Cloud Shell

Azure Cloud Shell è una shell Bash gratuita che può essere eseguita direttamente nel portale di Azure. Include l'interfaccia della riga di comando di Azure preinstallata e configurata per l'uso con l'account. Fare clic sul pulsante Cloud Shell nel menu nel riquadro in alto a destra nel portale di Azure.

Cloud Shell

Il pulsante avvia una shell interattiva che è possibile usare per eseguire tutti i passaggi in questo argomento:

Screenshot che mostra la finestra di Cloud Shell nel portale

Se si sceglie di installare e usare l'interfaccia della riga di comando in locale, per questo argomento è necessario eseguire la versione 2.0 o successiva dell'interfaccia della riga di comando di Azure. Eseguire az --version per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure 2.0.

Script di esempio

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.

#!/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 distribuzione

Dopo l'esecuzione dello script di esempio, eseguire il comando seguente per rimuovere il gruppo di risorse e tutte le risorse correlate.

Pulire la distribuzione

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.

az group delete --name myResourceGroup

Spiegazione dello script

Questo script usa i comandi seguenti. Ogni comando della tabella include collegamenti alla documentazione specifica del comando.

Comando Note
az login Accedere ad Azure.
az group create Creare un gruppo di risorse con una posizione
az storage account create Creare un account di archiviazione
az functionapp create Creare una nuova app per le funzioni
az documentdb create Crea un database DocumentDB
az group delete Eseguire la pulizia

Passaggi successivi

Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.

Altri esempi di script dell'interfaccia della riga di comando di Funzioni di Azure sono disponibili nella documentazione di Funzioni di Azure.