Esempi per Azure Cosmos DB for NoSQL SDK per JS

  • Articolo

SI APPLICA A: NoSQL

Le soluzioni di esempio che eseguono operazioni CRUD e altre operazioni di uso comune su risorse di Azure Cosmos DB sono disponibili nel repository JavaScript SDK per Azure Cosmos DB di GitHub. 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 Azure gratuito prima di iniziare.

È possibile provare gratuitamente Azure DB Cosmos 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.

È necessario anche JavaScript SDK.

Nota

Ogni esempio è indipendente e le operazioni di installazione e pulizia sono eseguite automaticamente. Di conseguenza, gli esempi effettuano più chiamate a Containers.create. A ogni chiamata, alla sottoscrizione viene addebitata 1 ora di utilizzo per ogni livello di prestazioni del contenitore creato.

Esempi di database

Il file DatabaseManagement illustra come eseguire operazioni CRUD sul database. 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
Creare un database se non esiste Databases.createIfNotExists
Elencare database per un account Databases.readAll
Leggere un database in base all'ID Database.read
Eliminare un database Database.delete

Esempi di contenitore

Il file ContainerManagement illustra come eseguire operazioni CRUD sul contenitore. 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 un contenitore se non esiste Containers.createIfNotExists
Elencare i contenitori per un account Containers.readAll
Leggere una definizione di contenitore Container.read
Eliminare un contenitore Container.delete

Esempi di elementi

Il file ItemManagement illustra come eseguire operazioni CRUD sull'elemento. 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.

Attività Informazioni di riferimento sulle API
Creare elementi Items.create
Leggere tutti gli elementi in un contenitore Items.readAll
Leggere un elemento in base all'ID Item.read
Leggere un elemento solo se è stato modificato Item.read - RequestOptions.accessCondition
Eseguire query per documenti Items.query
Sostituire un elemento Item.replace
Sostituire documenti con il controllo condizionale degli ETag Item.replace - RequestOptions.accessCondition
Eliminare un elemento Item.delete

Esempi di indicizzazione

Il file IndexManagement illustra come gestire l'indicizzazione. 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
Indicizzare manualmente un elemento specifico RequestOptions.indexingDirective: 'include'
Escludere manualmente un elemento specifico dall'indice RequestOptions.indexingDirective: 'exclude'
Escludere un percorso dall'indice IndexingPolicy.ExcludedPath
Creare un indice di intervallo su un percorso di stringa IndexKind.Range, IndexingPolicy, Items.query
Creare un contenitore con indexPolicy predefinito e quindi aggiornarlo online Containers.create

Esempi di programmazione lato server

Il file index.ts illustra come eseguire le attività seguenti. Per informazioni sulla programmazione lato server in Azure Cosmos DB prima di passare agli esempi seguenti, vedere l'articolo concettuale Stored procedure, trigger e funzioni definite dall'utente.

Attività Informazioni di riferimento sulle API
Creare una stored procedure StoredProcedures.create
Eseguire una stored procedure StoredProcedure.execute
Aggiornamento bulk con stored procedure StoredProcedure.execute

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 autenticazione di Azure Identity(AAD)

Il file AADAuth.ts illustra come eseguire le attività seguenti.

Attività Informazioni di riferimento sulle API
Create credential object from @azure/identity API
Passare le credenziali all'oggetto client con chiave aadCredentials API
Eseguire il client Cosmos con credenziali aad API

Esempi vari

Gli esempi curati seguenti illustrano scenari comuni.

Attività Informazioni di riferimento sulle API
Modificare la velocità effettiva delle query API
Ottenere la velocità effettiva delle query API
uso di SasTokens per concedere l'accesso con ambito alle risorse di Cosmos DB API

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