Azure Cosmos DB para NoSQL: Spring Data Exemplos do Azure Cosmos DB v5

  • Artigo

APLICA-SE A: NoSQL

Importante

Estas notas de versão são para a versão 5 do Spring Data Azure Cosmos DB. Você pode encontrar as notas de lançamento para a versão 3 aqui e a versão 2 aqui.

Spring Data O Azure Cosmos DB suporta apenas a API para NoSQL.

Consulte estes artigos para obter informações sobre o Spring Data em outras APIs do Azure Cosmos DB:

Importante

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Você pode experimentar o Azure Cosmos DB gratuitamente, sem uma assinatura do Azure e sem necessidade de compromisso. Como alternativa, você pode criar uma conta de camada gratuita do Azure Cosmos DB, com os primeiros 1000 RU/s e 25 GB de armazenamento gratuitamente. Você também pode usar o emulador do Azure Cosmos DB com um URI de https://localhost:8081. Para obter a chave a ser usada com o emulador, consulte Autenticando solicitações.

Os aplicativos de exemplo mais recentes que executam operações CRUD e outras operações comuns nos recursos do Azure Cosmos DB estão incluídos no repositório do GitHub azure-spring-boot-samples . Este artigo fornece:

  • Links para as tarefas em cada um dos arquivos de projeto de exemplo do Spring Data Azure Cosmos DB.
  • Ligações para o conteúdo relacionado de referência da API.

Pré-requisitos

Precisa do seguinte apra executar esta aplicação de exemplo:

  • Java Development Kit 8
  • Spring Data Azure Cosmos DB v5

Opcionalmente, você pode usar o Maven para obter os binários mais recentes do Spring Data Azure Cosmos DB v3 para uso em seu projeto. O Maven adiciona automaticamente quaisquer dependências necessárias. Caso contrário, você pode baixar diretamente as dependências listadas no arquivo pom.xml e adicioná-las ao seu caminho de compilação.

<dependency>
	<groupId>com.azure</groupId>
	<artifactId>azure-spring-data-cosmos</artifactId>
	<version>LATEST</version>
</dependency>

Executar os exemplos de aplicações

Clonar o repositório de exemplo:

$ git clone https://github.com/Azure-Samples/azure-spring-boot-samples

$ cd cosmos/azure-spring-data-cosmos/spring3-samples/cosmos-quickstart-samples

Você pode executar os exemplos usando um IDE (Eclipse, IntelliJ ou VS Code) ou a partir da linha de comando usando o Maven.

Em application.properties , essas variáveis de ambiente devem ser definidas:

cosmos.uri=${ACCOUNT_HOST}
cosmos.key=${ACCOUNT_KEY}
cosmos.secondaryKey=${SECONDARY_ACCOUNT_KEY}

dynamic.collection.name=spel-property-collection
# Populate query metrics
cosmos.queryMetricsEnabled=true

para dar às amostras acesso de leitura/gravação à sua conta, bancos de dados e contêineres.

Seu IDE pode fornecer a capacidade de executar o código de exemplo do Spring Data. Caso contrário, você pode usar o seguinte comando de terminal para executar o exemplo:

mvn spring-boot:run

Exemplos de documentos CRUD

O arquivo de exemplos mostra como executar as seguintes tarefas. Para saber mais sobre documentos do Azure Cosmos DB antes de executar os exemplos a seguir, consulte o artigo conceitual Trabalhando com bancos de dados, contêineres e itens .

Tarefa Referência da API
Criar um documento CosmosRepository.save
Ler um documento por ID CosmosRepository.derivedQueryMethod
Eliminar todos os documentos CosmosRepository.deleteAll

Exemplos de métodos de consulta derivados

O arquivo de exemplos mostra como executar as seguintes tarefas. Para saber mais sobre as consultas do Azure Cosmos DB antes de executar os exemplos a seguir, você pode achar útil ler o artigo Métodos de consulta derivados no Spring de Baeldung.

| Consulta de documentos | Método CosmosRepository.derivedQueryMethod |

Exemplos de consulta personalizados

O arquivo de exemplos mostra como executar as seguintes tarefas usando a gramática de consulta SQL. Para saber mais sobre a referência de consulta SQL no Azure Cosmos DB antes de executar os exemplos a seguir, consulte Exemplos de consulta SQL para o Azure Cosmos DB.

Tarefa Referência da API
Consultar todos os documentos @Query anotação
Consultar igualdade com == @Query anotação
Consultar desigualdade com != e NOT @Query anotação
Consulta usando operadores de intervalo como >, , ><=, <= @Query anotação
Consultar com operadores de intervalo em relação a cadeias @Query anotação
Consulta com ORDER BY @Query anotação
Consulta com DISTINCT @Query anotação
Consulta com funções agregadas @Query anotação
Trabalhar com subdocumentos @Query anotação
Consultar com Associações dentro de documentos @Query anotação
Consulta com operadores de cadeia de caracteres, matemática e matriz @Query anotação

Próximos passos

Tentando fazer o planejamento de capacidade para uma migração para o Azure Cosmos DB? Você pode usar informações sobre seu cluster de banco de dados existente para planejamento de capacidade.