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
Criar uma conta
Crie uma única conta do Azure Cosmos DB usando a API para NoSQL.
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"
Caso ainda não tenha feito isso, entre na CLI do Azure usando o comando az login.
Use o comando az group create para criar um grupo de recursos na assinatura.
az group create \
--name $resourceGroupName \
--___location $___location
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
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"
Se ainda não tiver feito isso, entre no Azure PowerShell usando o cmdlet Connect-AzAccount.
Use o cmdlet New-AzResourceGroup para criar um grupo de recursos na assinatura.
$parameters = @{
Name = $RESOURCE_GROUP_NAME
Location = $LOCATION
}
New-AzResourceGroup @parameters
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
Dica
Para este guia, é recomendável usar o nome do grupo de recursos msdocs-cosmos.
Entre no portal do Azure.
No menu do portal do Azure ou na Home page, selecione Criar um recurso.
Na página Novo, pesquise pelo Azure Cosmos DB e selecione-o.
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.
Na página Criar conta do Azure Cosmos DB, insira as seguintes informações:
| Configuração |
Valor |
Descrição |
| Assinatura |
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. |
| Localização |
A região mais próxima dos seus 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 camada gratuita 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 da camada gratuita 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 camada gratuita, significa que outra conta da assinatura já foi habilitada com a camada gratuita.
Selecione Examinar + criar.
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.
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.