Condividi tramite


Azure Cosmos DB for NoSQL: esempi di Java SDK v4

SI APPLICA A: NoSQL

Importante

Per altre informazioni su Java SDK v4, vedere le note sulla versione di Java SDK v4 per Azure Cosmos DB, il repository Maven, i suggerimenti sulle prestazioni di Java SDK v4 per Azure Cosmos DB e la guida alla risoluzione dei problemi di Java SDK v4 per Azure Cosmos DB. Se attualmente si usa una versione precedente a v4, vedere l'articolo Eseguire la migrazione a Java SDK v4 per Azure Cosmos DB per informazioni sull'aggiornamento a v4.

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 di Azure Cosmos DB, con i primi 1.000 UR/s 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-cosmos-java-sql-api-samples di GitHub. Questo articolo include:

  • Collegamenti alle attività in ogni file di progetto Java di esempio.
  • Collegamenti al contenuto di riferimento sulle API correlato.

Prerequisiti

Per eseguire questa applicazione di esempio, occorre quanto segue:

  • Java Development Kit 8
  • Java SDK v4 per Azure Cosmos DB

È possibile usare facoltativamente Maven per ottenere i file binari più recenti di Java SDK v4 per Azure Cosmos DB 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-cosmos</artifactId>
	<version>LATEST</version>
</dependency>

Esecuzione delle applicazioni di esempio

Clonare il repository di esempio:

$ git clone https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples.git

$ cd azure-cosmos-java-sql-api-samples

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

Queste variabili di ambiente devono essere impostate

ACCOUNT_HOST=your account hostname;ACCOUNT_KEY=your account primary key

per concedere all'account l'accesso in lettura/scrittura agli esempi.

Per eseguire un esempio, specificare la relativa classe Main

com.azure.cosmos.examples.sample.synchronicity.MainClass

dove sample.synchronicity.MainClass può essere

  • crudquickstart.sync.SampleCRUDQuickstart
  • crudquickstart.async.SampleCRUDQuickstartAsync
  • indexmanagement.sync.SampleIndexManagement
  • indexmanagement.async.SampleIndexManagementAsync
  • storedprocedure.sync.SampleStoredProcedure
  • storedprocedure.async.SampleStoredProcedureAsync
  • changefeed.SampleChangeFeedProcessor (Changefeed include solo un esempio asincrono, non sincrono) e così via.

Nota

Ogni esempio è indipendente e le operazioni di installazione e pulizia sono eseguite automaticamente. Gli esempi eseguono più chiamate per la creazione di CosmosContainer o CosmosAsyncContainer. A ogni chiamata, viene addebitata alla sottoscrizione 1 ora di utilizzo per il livello di prestazioni della raccolta creata.

Esempi di database

I file di esempio CRUD di database per sincrona e asincrona illustrano come eseguire le attività seguenti. Per saperne di più sui database 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
Creazione di un database CosmosClient.createDatabaseIfNotExists
CosmosAsyncClient.createDatabaseIfNotExists
Leggere un database in base all'ID CosmosClient.getDatabase
CosmosAsyncClient.getDatabase
Leggere tutti i database CosmosClient.readAllDatabases
CosmosAsyncClient.readAllDatabases
Eliminare un database CosmosDatabase.delete
CosmosAsyncDatabase.delete

Esempi di raccolta

I file di esempio CRUD di raccolta per sincrona e asincrona illustrano come eseguire le attività seguenti. Per informazioni sulle raccolte 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 una raccolta CosmosDatabase.createContainerIfNotExists
CosmosAsyncDatabase.createContainerIfNotExists
Modificare le prestazioni configurate di una raccolta CosmosContainer.replaceThroughput
CosmosAsyncContainer.replaceProvisionedThroughput
Ottenere una raccolta in base all'ID CosmosDatabase.getContainer
CosmosAsyncDatabase.getContainer
Leggere tutte le raccolte in un database CosmosDatabase.readAllContainers
CosmosAsyncDatabase.readAllContainers
Eliminare una raccolta CosmosContainer.delete
CosmosAsyncContainer.delete

Esempi di raccolta con scalabilità automatica

Per altre informazioni prima di eseguire questi esempi, vedere queste istruzioni per abilitare la scalabilità automatica nell'account e nei database e contenitori.

I file di esempio CRUD di scalabilità automatica per sincrona e asincrona illustrano come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Creare un database con la velocità effettiva massima a scalabilità automatica specificata CosmosClient.createDatabase
CosmosAsyncClient.createDatabase

I file di esempio di raccolta di scalabilità automatica per sincrona e asincrona illustrano come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Crea una raccolta con la velocità effettiva massima a scalabilità automatica specificata CosmosDatabase.createContainerIfNotExists
CosmosAsyncDatabase.createContainerIfNotExists
Cambiare la velocità effettiva massima a scalabilità automatica configurata di una raccolta CosmosContainer.replaceThroughput
CosmosAsyncContainer.replaceThroughput
Leggere la configurazione della velocità effettiva a scalabilità automatica di una raccolta CosmosContainer.readThroughput
CosmosAsyncContainer.readThroughput

Esempi di raccolta di archiviazione analitica

I file di esempio CRUD di raccolta archiviazione analitica per sincrona e asincrona illustrano come eseguire le attività seguenti. Per informazioni sulle raccolte di Azure Cosmos DB prima di eseguire gli esempi seguenti, vedere Azure Cosmos DB Synapse e archivio analitico.

Attività Informazioni di riferimento sulle API
Creare una raccolta CosmosDatabase.createContainerIfNotExists
CosmosAsyncDatabase.createContainerIfNotExists

Esempi di elementi

I file di esempio CRUD di documento per sincrona e asincrona illustrano come eseguire le attività seguenti. Per saperne di più sui documenti di Azure Cosmos DB prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.

Nota

È necessario specificare una chiave di partizione quando si eseguono operazioni su un elemento specifico.

Attività Informazioni di riferimento sulle API
Creare un documento CosmosContainer.createItem
CosmosAsyncContainer.createItem
Leggere un documento in base all'ID CosmosContainer.readItem
CosmosAsyncContainer.readItem
Eseguire query per documenti CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Sostituire un documento CosmosContainer.replaceItem
CosmosAsyncContainer.replaceItem
Upsert per un documento CosmosContainer.upsertItem
CosmosAsyncContainer.upsertItem
Eliminazione di un documento CosmosContainer.deleteItem
CosmosAsyncContainer.deleteItem
Sostituire documenti con verifica degli ETag condizionale CosmosItemRequestOptions.setIfMatchETag (sincrono)
CosmosItemRequestOptions.setIfMatchETag (asincrono)
Leggere il documento solo se è stato modificato CosmosItemRequestOptions.setIfNoneMatchETag (sincrono)
CosmosItemRequestOptions.setIfNoneMatchETag (asincrono)
Aggiornamento parziale dei documenti CosmosContainer.patchItem
Aggiornamento in blocco dei documenti Esempi in blocco
Batch transazionale esempi di batch

Esempi di indicizzazione

Il file Collection CRUD Samples illustra come eseguire le attività seguenti. Per saperne di più sull'indicizzazione in Azure Cosmos DB prima di passare agli esempi seguenti, vedere gli articoli concettuali su criteri di indicizzazione, tipi di indicizzazione e percorsi di indicizzazione.

Attività Informazioni di riferimento sulle API
Includere percorsi di documenti specificati nell'indice IndexingPolicy.IncludedPaths
Escludere percorsi di documenti specificati dall'indice IndexingPolicy.ExcludedPaths
Creare un indice composto IndexingPolicy.setCompositeIndexes
CompositePath
Creare un indice geospaziale IndexingPolicy.setSpatialIndexes
SpatialSpec
SpatialType

Per altre informazioni sull'indicizzazione, vedere Criteri di indicizzazione di Azure Cosmos DB.

Esempi di query

Il file Query Samples per sincrona e asincrona illustrano 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 CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query relative all'uguaglianza con == CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query relative alla disuguaglianza con != e NOT CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query usando operatori di intervallo come >, <, >=, <= CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query usando operatori di intervallo su stringhe CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query con ORDER BY CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query con DISTINCT CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query con funzioni di aggregazione CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Usare i documenti secondari CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query con join all'interno del documento CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query con operatori di stringa, matematici e di matrice CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Eseguire query con SQL con parametri tramite SqlQuerySpec CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Query con paging esplicito CosmosContainer.queryItems
CosmosAsyncContainer.queryItems
Raccolte partizionate di query in parallelo CosmosContainer.queryItems
CosmosAsyncContainer.queryItems

Esempi di feed di modifiche

Il file Change Feed Processor Sample illustra come eseguire le operazioni seguenti. Per informazioni sul feed di modifiche in Azure Cosmos DB prima di passare agli esempi seguenti, vedere Lettura del feed di modifiche in Azure Cosmos DB e Processore dei feed di modifiche.

Attività Informazioni di riferimento sulle API
Funzionalità di base del feed di modifiche ChangeFeedProcessor.changeFeedProcessorBuilder
Leggere il feed di modifiche dall'inizio ChangeFeedProcessorOptions.setStartFromBeginning()

Esempi di programmazione lato server

Il file Stored Procedure Sample illustra come eseguire le operazioni seguenti. Per informazioni sulla programmazione lato server in Azure Cosmos DB prima di passare agli esempi seguenti, vedere Stored procedure, trigger e funzioni definite dall'utente.

Attività Informazioni di riferimento sulle API
Creare una stored procedure CosmosScripts.createStoredProcedure
Eseguire una stored procedure CosmosStoredProcedure.execute
Eliminare un stored procedure CosmosStoredProcedure.delete

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à.