Crear recursos

  • 4 minutos

Al administrar las cuentas de Azure Cosmos DB for NoSQL mediante la CLI de Azure, la mayoría de los comandos se dividirán en dos grupos de comandos principales de la CLI:

  • az cosmosdb: este grupo contiene los comandos necesarios para crear y administrar una nueva cuenta de Azure Cosmos DB.
  • az cosmosdb sql: este subgrupo del grupo az cosmosdb contiene los comandos para administrar recursos específicos de la API NoSQL, como bases de datos y contenedores.

Comandos de grupos de cuentas de Azure Cosmos DB

Para crear una nueva cuenta, deberá usar el comando az cosmosdb create. Este comando solo requiere, como mínimo, el nombre de la nueva cuenta que se va a crear y el grupo de recursos de destino para el recurso de cuenta. Al crear la nueva cuenta, debe asegurarse de que el nombre que usa es único globalmente para evitar errores en el comando debido a un conflicto de nombres con otra instancia de servicio.

Sugerencia

De manera predeterminada, este comando creará una cuenta mediante la API NoSQL.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>'

Al crear una nueva cuenta, también puede especificar parámetros adicionales para controlar las características de la cuenta recién creada. Por ejemplo, este comando habilita el nivel gratis y establece el nivel de coherencia predeterminado en Fuerte.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --default-consistency-level 'strong' \
    --enable-free-tier 'true'

En la mayoría de los casos, querrá especificar la región en la que desea implementar la cuenta de Azure Cosmos DB. Puede usar el argumento --locations para especificar una o varias ubicaciones de destino para su cuenta.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --locations regionName='eastus'

Más adelante, obtendrá información sobre cómo especificar varias ubicaciones de destino al establecer las prioridades de conmutación por error adecuadas para cada ubicación.

Nota:

En caso de duda, siempre puede consultar la documentación de ayuda de los comandos mediante el argumento --help en estos ejemplos: az cosmosdb --help y az cosmosdb create --help.

Comandos de subgrupos de Azure Cosmos DB for NoSQL

El grupo de comandos az cosmosdb sql contiene varios comandos y subgrupos para administrar recursos individuales en la API NoSQL. Por ejemplo, puede usar el comando az cosmosdb sql database create para crear una nueva base de datos dentro de una cuenta existente. En este ejemplo, el argumento --name hace referencia al nombre de la nueva base de datos y el argumento --account-name, al nombre de la cuenta creada anteriormente.

az cosmosdb sql database create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --name '<database-name>'

El comando az cosmosdb sql container create crea un nuevo contenedor dentro de una base de datos existente. El argumento --name en este contexto hace referencia al nombre del nuevo contenedor, mientras que el argumento --database-name hace referencia al nombre de la base de datos creada anteriormente.

Este comando de creación también requiere, como mínimo, un valor para el argumento --partition-key-path,, ya que este argumento es obligatorio para todos los contenedores de Azure Cosmos DB for NoSQL.

az cosmosdb sql container create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --database-name '<database-name>' \
    --name '<container-name>' \
    --throughput '400' \
    --partition-key-path '<partition-key-path-string>'

Nota:

En caso de duda, siempre puede consultar la documentación de ayuda de los comandos mediante el argumento --help en estos ejemplos: az cosmosdb sql --help, az cosmosdb sql database --help y az cosmosdb sql container --help.