Azure Cosmos DB for NoSQL: esempi di Spring Data Azure Cosmos DB v5

  • Articolo

SI APPLICA A: NoSQL

Importante

Queste note sulla versione sono relative alla versione 5 di Spring Data Azure Cosmos DB. È possibile trovare le note sulla versione 3 qui e per la versione 2 qui.

Spring Data Azure Cosmos DB supporta solo l'API for NoSQL.

Per informazioni su Spring Data in altre API di Azure Cosmos DB, vedere questi articoli:

Importante

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

È possibile provare gratuitamente Azure Cosmos DB senza una sottoscrizione di Azure e senza impegno. In alternativa, è possibile creare un account di livello gratuito Azure Cosmos DB, con le prime 1.000 UR/sec e 25 GB di spazio di archiviazione gratuiti. È anche possibile usare l'Emulatore di Azure Cosmos DB con l'URI https://localhost:8081. Per la chiave da usare con l'emulatore, vedere Autenticazione delle richieste.

Le applicazioni di esempio più recenti che eseguono operazioni CRUD e altre operazioni di uso comune su risorse di Azure Cosmos DB sono disponibili nel repository azure-spring-boot-samples di GitHub. Questo articolo include:

  • Collegamenti alle attività in ogni file di progetto Spring Data Azure Cosmos DB di esempio.
  • Collegamenti al contenuto di riferimento sulle API correlato.

Prerequisiti

Per eseguire questa applicazione di esempio, occorre quanto segue:

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

È possibile usare facoltativamente Maven per ottenere i file binari più recenti di Spring Data Azure Cosmos DB v3 da usare nel progetto. Maven aggiunge automaticamente le dipendenze necessarie. In caso contrario, è possibile scaricare direttamente le dipendenze elencate nel file pom.xml e aggiungerle al percorso di compilazione.

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

Esecuzione delle applicazioni di esempio

Clonare il repository di esempio:

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

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

È possibile eseguire gli esempi tramite un IDE (Eclipse, IntelliJ o VS Code) o dalla riga di comando usando Maven.

In application.properties è necessario configurare queste variabili di ambiente

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

per concedere all'account, ai database e ai contenitori l'accesso in lettura/scrittura agli esempi.

È possibile che l'IDE consenta di eseguire il codice di esempio di Spring Data. In caso contrario, è possibile usare il comando seguente del terminale per eseguire l'esempio:

mvn spring-boot:run

Esempi CRUD del documento

Il file samples illustra come eseguire le attività seguenti. Per ottenere informazioni sui documenti di Azure Cosmos DB prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Creare un documento CosmosRepository.save
Leggere un documento in base all'ID CosmosRepository.derivedQueryMethod
Eliminare tutti i documenti CosmosRepository.deleteAll

Esempi di metodi di query derivati

Il file samples illustra come eseguire le attività seguenti. Per ottenere informazioni sulle query di Azure Cosmos DB prima di eseguire gli esempi seguenti, può risultare utile leggere l'articolo Metodi di query derivati in Spring di Baeldung.

| Query per i documenti | CosmosRepository.derivedQueryMethod |

Esempi di query personalizzate

Il file samples illustra come eseguire le attività seguenti usando la grammatica di query SQL. Per informazioni sulle query SQL in Azure Cosmos DB prima di passare agli esempi seguenti, vedere Esempi di query SQL per Azure Cosmos DB.

Attività Informazioni di riferimento sulle API
Eseguire query per tutti i documenti Annotazione @Query
Eseguire query relative all'uguaglianza con == Annotazione @Query
Eseguire query relative alla disuguaglianza con != e NOT Annotazione @Query
Eseguire query usando operatori di intervallo come >, <, >=, <= Annotazione @Query
Eseguire query usando operatori di intervallo su stringhe Annotazione @Query
Eseguire query con ORDER BY Annotazione @Query
Eseguire query con DISTINCT Annotazione @Query
Eseguire query con funzioni di aggregazione Annotazione @Query
Utilizzare i documenti secondari Annotazione @Query
Eseguire query con join all'interno del documento Annotazione @Query
Eseguire query con operatori di stringa, matematici e di matrice Annotazione @Query

Passaggi successivi

Si sta tentando di pianificare la capacità per una migrazione ad Azure Cosmos DB? È possibile usare le informazioni del cluster di database esistente per la pianificazione della capacità.