Usare l'interfaccia della riga di comando di Azure per creare un account e una tabella con scalabilità automatica di Azure Cosmos DB for Table
SI APPLICA A: Tabella
Lo script di questo articolo crea un account e una tabella con scalabilità automatica di Azure Cosmos DB for Table.
Prerequisiti
-
Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
Questo script richiede l'interfaccia della riga di comando di Azure 2.12.1 o versione successiva.
È possibile eseguire lo script nell'ambiente Bash in Azure Cloud Shell. Quando si apre Cloud Shell, assicurarsi che Bash venga visualizzato nel campo ambiente in alto a sinistra della finestra della shell. Cloud Shell include già la versione più recente dell'interfaccia della riga di comando di Azure.
L'autenticazione di Cloud Shell viene eseguita automaticamente con l'account usato per accedere al portale di Azure. È possibile usare az account set per accedere con una sottoscrizione diversa, sostituendo
<subscriptionId>
con l'ID sottoscrizione di Azure.subscription="<subscriptionId>" # add subscription here az account set -s $subscription # ...or use 'az login'
Se si preferisce, è possibile installare l'interfaccia della riga di comando di Azure per eseguire lo script in locale. Eseguire az version per trovare la versione dell'interfaccia della riga di comando di Azure e le librerie dipendenti installate ed eseguire az upgrade se è necessario eseguire l'aggiornamento. Se richiesto, installare le estensioni dell'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere ad Azure eseguendo az login e seguendo le istruzioni. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.
Script di esempio
Eseguire lo script seguente per creare un gruppo di risorse di Azure, un account di Azure Cosmos DB for Table e una tabella con scalabilità automatica dell'API per Table. La creazione delle risorse potrebbe richiedere alcuni minuti.
# Create a Table API table with autoscale
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier"
tag="autoscale-table-cosmosdb"
account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case
table="msdocs-table-cosmos-$randomIdentifier"
maxThroughput=1000 #minimum = 1000
# Create a resource group
echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag
# Create a Cosmos account for Table API
echo "Creating $account"
az cosmosdb create --name $account --resource-group $resourceGroup --capabilities EnableTable --default-consistency-level Eventual --locations regionName="$location" failoverPriority=0 isZoneRedundant=False
# Create a Table API Table with autoscale
echo "Create $table with $maxThroughput"
az cosmosdb table create --account-name $account --resource-group $resourceGroup --name $table --max-throughput $maxThroughput
Questo script usa i comandi seguenti:
- az group create crea un gruppo di risorse per archiviare tutte le risorse.
- az cosmosdb create con
--capabilities EnableTable
crea un account di Azure Cosmos DB per l'API per Table. - az cosmosdb table create con
--max-throughput 1000
crea una tabella con funzionalità di scalabilità automatica di Azure Cosmos DB for Table.
Pulire le risorse
Se le risorse create non sono più necessarie, usare il comando az group delete per eliminare il gruppo di risorse e tutte le risorse in esso contenute. Queste risorse includono l'account e la tabella di Azure Cosmos DB. L'eliminazione delle risorse potrebbe richiedere alcuni minuti.
az group delete --name $resourceGroup