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 attivare i benefici della sottoscrizione Visual Studio: con la sottoscrizione Visual Studio ogni mese si accumulano crediti che è possibile usare per i servizi di Azure a pagamento.
È 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-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.
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.
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à.
- Se si conosce solo il numero di vcore e server nel cluster di database esistente, leggere le informazioni sulla stima delle unità richieste usando vCore o vCPU
- Se si conosce la frequenza delle richieste tipiche per il carico di lavoro corrente del database, leggere le informazioni sulla stima delle unità richieste con lo strumento di pianificazione della capacità di Azure Cosmos DB