Esempi di Node.js per Azure Cosmos DB

Il repository azure-documentdb-nodejs di GitHub include soluzioni di esempio che eseguono operazioni CRUD e altre operazioni comuni su risorse di Azure Cosmos DB. Questo articolo include:

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

Prerequisiti

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

È inoltre possibile provare gratuitamente Microsoft Azure Cosmos DB senza una sottoscrizione di Azure e senza impegno. Oppure usare l'emulatore di Azure Cosmos DB per questa esercitazione con l'URI https://localhost:8081 e la chiave

C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==

È anche necessario Node.js SDK.

Nota

Ogni esempio è indipendente e le operazioni di installazione e pulizia sono eseguite automaticamente. Di conseguenza, gli esempi eseguono più chiamate a DocumentClient.createCollection. A ogni chiamata, viene addebitata alla sottoscrizione 1 ora di utilizzo per ogni livello di prestazioni della raccolta in fase di creazione.

Esempi di database

Il file app.js del progetto DatabaseManagement illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Creare un database DocumentClient.createDatabase
Eseguire query in un account per un database DocumentClient.queryDatabases
Leggere un database in base all'ID DocumentClient.readDatabase
Elencare database per un account DocumentClient.readDatabases
Eliminare un database DocumentClient.deleteDatabase

Esempi di raccolta

Il file app.js del progetto CollectionManagement illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Creare una raccolta DocumentClient.createCollection
Leggere un elenco di raccolte in un database DocumentClient.readCollections
Ottenere una raccolta in base a _self DocumentClient.readCollection
Ottenere una raccolta in base all'ID DocumentClient.readCollection
Ottenere il livello di prestazioni di una raccolta DocumentQueryable.QueryOffers
Cambiare il livello di prestazioni di una raccolta DocumentClient.replaceOffer
Eliminare una raccolta DocumentClient.deleteCollection

Esempi di documento

Il file app.js del progetto DocumentManagement illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Creare i documenti DocumentClient.createDocument
Leggere un feed di documenti per una raccolta DocumentClient.readDocument
Leggere un documento in base all'ID DocumentClient.readDocument
Leggere il documento solo se è stato modificato DocumentClient.readDocument
RequestOptions.accessCondition
Eseguire query per documenti DocumentClient.queryDocuments
Sostituire un documento DocumentClient.replaceDocument
Sostituire documenti con verifica degli ETag condizionale DocumentClient.replaceDocument
RequestOptions.accessCondition
Eliminare un documento DocumentClient.deleteDocument

Esempi di indicizzazione

Il file app.js del progetto IndexManagement illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Creare una raccolta con indicizzazione predefinita DocumentClient.createCollection
Indicizzare manualmente un documento specifico RequestOptions.indexingDirective: 'include'
Escludere manualmente un documento specifico dall'indice RequestOptions.indexingDirective: 'exclude'
Usare l'indicizzazione differita per l'importazione in massa o raccolte con operazioni di lettura intense IndexingMode.Lazy
Includere percorsi specifici di un documento nell'indicizzazione IndexingPolicy.IncludedPaths
Escludere determinati percorsi dall'indicizzazione IndexingPolicy.ExcludedPath
Consentire un'analisi su un percorso di stringa durante un'operazione di intervallo FeedOptions.EnableScanInQuery
Creare un indice di intervallo su un percorso di stringa IndexKind.Range, IndexingPolicy, DocumentClient.queryDocument
Creare una raccolta con indexPolicy predefinito e quindi aggiornarla online DocumentClient.createCollection
DocumentClient.replaceCollection#replaceCollection

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

Esempi di programmazione lato server

Il file app.js del progetto ServerSideScripts illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Creare una stored procedure DocumentClient.createStoredProcedure
Eseguire una stored procedure DocumentClient.executeStoredProcedure

Per altre informazioni sulla programmazione lato server, vedere Programmazione lato server per Azure Cosmos DB: stored procedure, trigger del database e funzioni definite dall'utente.

Esempi di partizionamento

Il file app.js del progetto Partitioning illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Usare un'attività HashPartitionResolver HashPartitionResolver

Per altre informazioni sul partizionamento dei dati in Azure Cosmos DB, vedere Come eseguire il partizionamento e il ridimensionamento in Azure Cosmos DB.