Criar uma conta do Azure Cosmos DB para NoSQL

APLICA-SE A: NoSQL

Uma conta do Azure Cosmos DB para NoSQL contém todos os seus recursos do Azure Cosmos DB: bancos de dados, contêineres e itens. A conta fornece um ponto de extremidade exclusivo para várias ferramentas e SDKs se conectarem ao Azure Cosmos DB e executarem operações diárias. Para obter mais informações sobre os recursos no Azure Cosmos DB, consulte Modelo de recursos do Azure Cosmos DB.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

Criar uma conta

Crie uma única conta do Azure Cosmos DB usando a API para NoSQL.

CLI do Azure

1. Crie variáveis de shell para accountName, resourceGroupName e 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. Se ainda não o fez, entre na CLI do Azure usando o az login comando.

3. Use o az group create comando para criar um novo grupo de recursos em sua assinatura.

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

4. Use o az cosmosdb create comando para criar uma nova conta do Azure Cosmos DB para NoSQL com configurações padrão.

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

PowerShell

1. Crie variáveis de shell para ACCOUNT_NAME, RESOURCE_GROUP_NAME e 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. Se ainda não o fez, entre no Azure PowerShell usando o Connect-AzAccount cmdlet.

3. Use o New-AzResourceGroup cmdlet para criar um novo grupo de recursos em sua assinatura.

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

4. Use o New-AzCosmosDBAccount cmdlet para criar uma nova conta do Azure Cosmos DB para NoSQL com configurações padrão.

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

Portal

Gorjeta

Para este guia, recomendamos o uso do nome msdocs-cosmosdo grupo de recursos .

1. Inicie sessão no portal do Azure.

2. A partir do menu do portal do Azure ou a partir da Home page, selecione Criar um recurso.

3. Na página Novo, procure e selecione Azure Cosmos DB.

4. Na página Selecionar opção API, selecione a opção Criar na seção NoSQL - Recomendar. O Azure Cosmos DB tem cinco APIs: SQL, MongoDB, Gremlin, Table e Cassandra. Saiba mais sobre a API para NoSQL.

   

5. Na página Criar Conta do Azure Cosmos DB, insira as seguintes informações:

   Definição	valor	Description
   Subscrição	Nome da subscrição	Selecione a assinatura do Azure que você deseja usar para esta conta do Azure Cosmos DB.
   Grupo de Recursos	Nome do grupo de recursos	Selecione um grupo de recursos ou selecione Criar novo e, em seguida, introduza um nome exclusivo para o novo grupo de recursos.
   Nome da Conta	Um nome exclusivo	Insira um nome para identificar sua conta do Azure Cosmos DB. O nome será usado como parte de um nome de domínio totalmente qualificado (FQDN) com um sufixo de documents.azure.com, portanto, o nome deve ser globalmente exclusivo. O nome só pode conter letras minúsculas, números e o caráter de hífen (-). O nome também deve ter entre 3 e 44 caracteres.
   Location	A região mais próxima dos seus utilizadores	Selecione a localização geográfica para alojar a sua conta do Azure Cosmos DB. Utilize a localização mais próxima dos utilizadores para lhes dar o acesso mais rápido aos dados.
   Modo de capacidade	Taxa de transferência provisionada ou sem servidor	Selecione Taxa de transferência provisionada para criar uma conta no modo de taxa de transferência provisionada. Selecione Serverless para criar uma conta no modo serverless .
   Aplicar desconto de nível gratuito do Azure Cosmos DB	Candidatar-se ou Não aplicar	Com o nível gratuito do Azure Cosmos DB, você receberá os primeiros 1000 RU/s e 25 GB de armazenamento gratuitamente em uma conta. Saiba mais sobre o nível gratuito.

   Nota

   Você pode ter até uma conta gratuita do Azure Cosmos DB por assinatura do Azure e deve optar por participar ao criar a conta. Se você não vir a opção de aplicar o desconto de nível gratuito, isso significa que outra conta na assinatura já foi habilitada com o nível gratuito.

   

6. Selecione Rever + criar.

7. Reveja as definições fornecidas e, em seguida, selecione Criar. A criação da conta demora alguns minutos. Aguarde até que a página do portal seja exibida Sua implantação foi concluída antes de prosseguir.

8. Selecione Ir para recurso para aceder à página da conta do Azure Cosmos DB.

   

Próximos passos

Neste guia, você aprendeu como criar uma conta do Azure Cosmos DB para NoSQL. Agora você pode criar um aplicativo com sua conta do Azure Cosmos DB.

Criar um aplicativo de console .NET com o Azure Cosmos DB para NoSQL