Criar uma conta do Azure Cosmos DB for NoSQL

APLICA-SE A: NoSQL

Uma conta do Azure Cosmos DB for NoSQL contém todos os 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 executar operações diárias. Para obter mais informações sobre os recursos no Azure Cosmos DB, consulte o modelo de recursos do Azure Cosmos DB.

Pré-requisitos

• Uma conta do Azure com uma assinatura 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 em shell para accountName, resourceGroupName e localização.

   # 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. Caso ainda não tenha feito isso, entre na CLI do Azure usando o comando az login.

3. Use o comando az group create para criar um grupo de recursos na assinatura.

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

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

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

PowerShell

1. Crie variáveis em 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 tiver feito isso, entre no Azure PowerShell usando o cmdlet Connect-AzAccount.

3. Use o cmdlet New-AzResourceGroup para criar um grupo de recursos na assinatura.

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

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

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

Portal

Dica

Para este guia, é recomendável usar o nome do grupo de recursos msdocs-cosmos.

1. Entre no portal do Azure.

2. No menu do portal do Azure ou na Home page, selecione Criar um recurso.

3. Na página Novo, pesquise pelo Azure Cosmos DB e selecione-o.

4. Na página Selecionar uma opção de API, clique na opção Criar da seção NoSQL – Recomendado. 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:

   Configuração	Valor	Descrição
   Subscription	Nome da assinatura	Selecione a assinatura do Azure que você quer usar para essa conta do Azure Cosmos DB.
   Grupo de recursos	Nome do grupo de recursos	Selecione um grupo de recursos ou selecione Criar novo, então insira um nome exclusivo para o novo grupo de recursos.
   Nome da Conta	Um nome exclusivo	Insira um nome para identificar a 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 pode conter apenas letras minúsculas, números e o caractere de hífen (-). O nome também deve ter entre 3 e 44 caracteres.
   Location	A região mais próxima dos usuários	Selecione uma localização geográfica para hospedar a sua conta do Azure Cosmos DB. Use a localização mais próxima dos usuários para fornecer a eles 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 taxa de transferência provisionada. Selecione Sem servidor para criar uma conta no modo sem servidor.
   Aplicar o desconto por nível gratuito do Azure Cosmos DB	Aplicar ou Não aplicar	Com a camada gratuita do Azure Cosmos DB, você recebe os primeiros 1000 RU/s e 25 GB de armazenamento gratuitamente em uma conta. Saiba mais sobre o nível gratuito.

   Observação

   Você pode ter no máximo uma conta do nível gratuito do Azure Cosmos DB por assinatura do Azure e deve aceitar ao criar a conta. Se você não vir a opção de aplicar o desconto por nível gratuito, significa que outra conta da assinatura já foi habilitada com o nível gratuito.

   

6. Selecione Examinar + criar.

7. Examine as configurações fornecidas e selecione Criar. São necessários alguns minutos para criar a conta. Aguarde até que a página do portal exiba Sua implantação está concluída antes de continuar.

8. Selecione Ir para recurso para ir para a página da conta do Azure Cosmos DB.

   

Próximas etapas

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

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