Cree una cuenta, una base de datos y un contenedor de Azure Cosmos DB for NoSQL con escalabilidad automática.

  • Artículo

SE APLICA A: NoSQL

El uso del script que se muestra en este artículo resulta en la creación de una cuenta, una base de datos y un contenedor de Azure Cosmos DB for NoSQL con escalabilidad automática.

Prerrequisitos

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

  • Para usar este script, se requiere la versión 2.0.73 o posterior de la CLI de Azure.

    • 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, además de una cuenta, una base de datos y un contenedor con escalabilidad automática de Azure Cosmos DB for NoSQL. Los recursos pueden tardar un tiempo en crearse.

# Create a SQL API database and container with autoscale

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier"
tag="autoscale-sql-cosmosdb"
account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case
database="msdocs-db-sql-cosmos"
container="container1"
partitionKey="/partitionKey"
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 SQL API
echo "Creating $account"
az cosmosdb create --name $account --resource-group $resourceGroup --default-consistency-level Eventual --locations regionName="$location" failoverPriority=0 isZoneRedundant=False

# Create a SQL API database
echo "Creating $database"
az cosmosdb sql database create --account-name $account --resource-group $resourceGroup --name $database

# Create a SQL API container with autoscale
echo "Creating $container with $maxThroughput"
az cosmosdb sql container create --account-name $account --resource-group $resourceGroup --database-name $database --name $container --partition-key-path $partitionKey --max-throughput $maxThroughput

Este script usa los siguientes comandos:

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, la base de datos y el contenedor de Azure Cosmos DB. Los recursos pueden tardar un tiempo en eliminarse.

az group delete --name $resourceGroup

Pasos siguientes