Creación de una cuenta de Azure Cosmos DB for NoSQL

SE APLICA A: NoSQL

Una cuenta de Azure Cosmos DB for NoSQL contiene todos los recursos de base de datos de Azure Cosmos DB: bases de datos, contenedores y elementos. La cuenta ofrece un punto de conexión único para que varias herramientas y SDK se conecten a Azure Cosmos DB y realicen operaciones diarias. Para más información sobre los recursos de Azure Cosmos DB, consulte Modelo de recursos de Azure Cosmos DB.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

Crear una cuenta

Cree una única cuenta de Azure Cosmos DB mediante la API para NoSQL.

CLI de Azure

1. Cree variables de shell para accountName, resourceGroupName y location.

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. Si aún no lo ha hecho, inicie sesión en la CLI de Azure con el comando az login.

3. Use el comando az group create para crear un nuevo grupo de recursos en la suscripción.

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. Use el comando az cosmosdb create para crear una nueva cuenta de Azure Cosmos DB for NoSQL con la configuración predeterminada.

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --locations regionName=$location
   

PowerShell

1. Cree variables de shell para ACCOUNT_NAME, RESOURCE_GROUP_NAME y LOCATION.

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. Si aún no lo ha hecho, inicie sesión en Azure PowerShell con el cmdlet Connect-AzAccount.

3. Use el cmdlet New-AzResourceGroup para crear un nuevo grupo de recursos en la suscripción.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. Use el cmdlet New-AzCosmosDBAccount para crear una nueva cuenta de Azure Cosmos DB for NoSQL con la configuración predeterminada.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

Portal

Sugerencia

Para esta guía, se recomienda usar el nombre del grupo de recursos msdocs-cosmos.

1. Inicie sesión en Azure Portal.

2. En el menú de Azure Portal o en la página principal, seleccione Crear un recurso.

3. En la página Nuevos, busque y seleccione Azure Cosmos DB.

4. En la página Selección de la opción de API, seleccione la opción Crear en la sección NoSQL: opción recomendada. Azure Cosmos DB tiene cinco API: SQL, MongoDB, Gremlin, Table y Cassandra. Más información acerca de la API para NoSQL.

   

5. En la página Creación de una cuenta de Azure Cosmos DB, incluya la siguiente información:

   Configuración	Value	Descripción
   Subscription	Nombre de suscripción	Seleccione la suscripción de Azure que quiera usar para esta cuenta de Azure Cosmos DB.
   Grupo de recursos	Definición de un nombre de grupo de recursos	Seleccione un grupo de recursos o seleccione Crear nuevo y escriba un nombre único para el grupo de recursos nuevo.
   Nombre de cuenta	Un nombre único	Escriba un nombre para identificar la cuenta de Azure Cosmos DB. El nombre se usará como parte de un nombre de dominio completo (FQDN) con el sufijo documents.azure.com, por lo que el nombre debe ser único a nivel global. El nombre solo puede contener letras minúsculas, números y el carácter de guion (-). Además, el nombre debe tener una longitud comprendida entre 3 y 44 caracteres.
   Location	Región más cercana a los usuarios	Seleccione una ubicación geográfica para hospedar la cuenta de Azure Cosmos DB. Use la ubicación más cercana a los usuarios para que puedan acceder de la forma más rápida posible a los datos.
   Capacity mode (Modo de capacidad)	Rendimiento aprovisionado o sin servidor	Seleccione Provisioned throughput (Rendimiento aprovisionado) para crear una cuenta en modo de rendimiento aprovisionado. Seleccione Serverless (Sin servidor) para crear una cuenta en modo sin servidor.
   Aplicar el descuento del nivel Gratis de Azure Cosmos DB	Aplicar o No aplicar	Con el nivel Gratis de Azure Cosmos DB, recibirá los primeros 1000 RU/s y 25 GB de almacenamiento gratis en una cuenta. Más información acerca del nivel Gratis.

   Nota

   Puede tener una cuenta de Azure Cosmos DB de nivel Gratis por cada suscripción de Azure y debe optar por tenerla al crear la cuenta. Si no ve la opción para aplicar el descuento por nivel Gratis, significará que en otra cuenta de la suscripción ya se ha habilitado el nivel Gratis.

   

6. Seleccione Revisar + crear.

7. Revise la configuración que proporcione y, a continuación, seleccione Crear. La operación de creación de la cuenta tarda unos minutos. Antes de avanzar, espere a que la página del portal muestre Se completó la implementación.

8. Seleccione Ir al recurso para ir a la página de la cuenta de Azure Cosmos DB.

   

Pasos siguientes

En esta guía, ha aprendido a crear una cuenta de Azure Cosmos DB for NoSQL. Ahora puede crear una aplicación con su cuenta de Azure Cosmos DB.

Creación de una aplicación de consola de .NET con Azure Cosmos DB for NoSQL