Compartir a través de

Uso de la CLI de Azure para crear una cuenta y una tabla de Azure Cosmos DB for Table con escalabilidad automática

  • Artículo

SE APLICA A: Table

El uso del script de este artículo crea una cuenta y una tabla de Azure Cosmos DB for Table con escalabilidad automática.

Requisitos previos

  • Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

  • Este script requiere la versión 2.12.1 de la CLI de Azure, o cualquier versión posterior.

    • Puede ejecutar el script en el entorno de Bash en Azure Cloud Shell. Cuando se abra Cloud Shell, asegúrese de que Bash aparezca en el campo de entorno, ubicado en la parte superior izquierda de la ventana de shell. El servicio Cloud Shell siempre dispone de la versión más reciente de la CLI de Azure.

      Cloud Shell se autenticará automáticamente con la cuenta que haya utilizado para iniciar sesión en Azure Portal. No obstante, puede usar el comando az account set para iniciar sesión con otra suscripción, reemplazando el valor <subscriptionId> por el id. de suscripción de Azure.

      subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

    • Si lo prefiere, puede instalar la CLI de Azure para ejecutar el script localmente. Ejecute el comando az version para visualizar la versión de la CLI de Azure y las librerías dependientes de esta que tiene instaladas y, después, ejecute az upgrade si necesita actualizarlas. Si se le solicita, instale las extensiones de la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker.

      Si está usando una instalación local, ejecute el comando az login y siga las solicitudes que se mostrarán para iniciar sesión en Azure. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

Script de ejemplo

Ejecute el siguiente script para crear un grupo de recursos de Azure, una cuenta de Azure Cosmos DB for Table y una tabla de API para Table con capacidades de escalabilidad automática. Los recursos pueden tardar un tiempo en crearse.

# 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

Este script usa los siguientes comandos:

  • az group create crea un grupo de recursos para almacenar todos los recursos.
  • az cosmosdb create con el argumento --capabilities EnableTable, que crea una cuenta de Azure Cosmos DB para API para Table.
  • az cosmosdb table create con el argumento --max-throughput 1000, que crea una tabla de Azure Cosmos DB for Table con capacidades de escalabilidad automática.

Limpieza de recursos

Si ya no necesita los recursos que creó, use el comando az group delete para eliminar el grupo de recursos y todos los recursos que este contiene. Entre estos recursos se incluyen la cuenta y la tabla de Azure Cosmos DB. Los recursos pueden tardar un tiempo en eliminarse.

az group delete --name $resourceGroup

Pasos siguientes