Exempel för Azure Cosmos DB för NoSQL SDK för JS

  • Artikel

GÄLLER FÖR: NoSQL

Exempellösningar som utför CRUD-åtgärder och andra vanliga åtgärder på Azure Cosmos DB-resurser ingår i JavaScript SDK för Azure Cosmos DB GitHub-lagringsplatsen. Den här artikeln innehåller:

  • Länkar till uppgifterna i var och en av Node.js-exempelprojektfilerna.
  • Länkar till det relaterade API-referensinnehållet.

Förutsättningar

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Du kan prova Azure Cosmos DB kostnadsfritt, utan en Azure-prenumeration och utan något åtagande. Du kan också skapa ett kostnadsfritt Azure Cosmos DB-konto med de första 1 000 RU/s och 25 GB lagringsutrymme utan kostnad. Du kan också använda Azure Cosmos DB-emulatorn med en URI för https://localhost:8081. Den nyckel som ska användas med emulatorn finns i Autentisera begäranden.

Du behöver även JavaScript SDK.

Kommentar

Varje exempel är självständigt. Det konfigurerar sig själv och rensar upp efter sig. Därmed gör exemplen flera anrop till Containers.create. Varje gång det sker faktureras din prenumeration för en timmes användning per prestandanivå för den container som skapas.

Databasexempel

Filen DatabaseManagement visar hur du utför CRUD-åtgärderna i databasen. Mer information om Azure Cosmos DB-databaserna innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Skapa en databas om den inte finns Databases.createIfNotExists
Lista databaser för ett konto Databases.readAll
Läsa en databas via ID Database.read
Ta bort en databas Database.delete

Containerexempel

ContainerManagement-filen visar hur du utför CRUD-åtgärderna på containern. Mer information om Azure Cosmos DB-samlingarna innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Skapa en container om den inte finns Containers.createIfNotExists
Lista containrar för ett konto Containers.readAll
Läsa en containerdefinition Container.read
Ta bort en container Container.delete

Objektexempel

Filen ItemManagement visar hur du utför CRUD-åtgärderna på objektet. Mer information om Azure Cosmos DB-dokumenten innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Skapa objekt Items.create
Läsa alla objekt i en container Items.readAll
Läsa ett objekt via ID Item.read
Läsa objekt bara om objektet har ändrats Item.read - RequestOptions.accessCondition
Fråga för dokument Items.query
Ersätta ett objekt Item.replace
Ersätta objekt med villkorlig ETag-kontroll Item.replace - RequestOptions.accessCondition
Ta bort ett objekt Item.delete

Indexeringsexempel

Filen IndexManagement visar hur du hanterar indexering. Mer information om indexering i Azure Cosmos DB innan du kör följande exempel finns i konceptuella artiklar om indexeringsprinciper, indexeringstyper och indexeringssökvägar.

Uppgift API-referens
Indexeras manuellt ett specifikt objekt RequestOptions.indexingDirective: 'include'
Undanta ett specifikt objekt från indexet manuellt RequestOptions.indexingDirective: 'exclude'
Undanta en sökväg från indexet IndexingPolicy.ExcludedPath
Skapa ett intervallindex i en strängsökväg IndexKind.Range, IndexingPolicy, Items.query
Skapa en container med standardindexPolicy och uppdatera sedan containern online Containers.create

Programmeringsexempel på serversidan

Filen index.ts visar hur du utför följande uppgifter. Mer information om programmering på serversidan i Azure Cosmos DB innan du kör följande exempel finns i konceptuell artikel om lagrade procedurer, utlösare och användardefinierade funktioner .

Uppgift API-referens
Skapa en lagrad procedur StoredProcedures.create
Köra en lagrad procedur StoredProcedure.execute
Massuppdatering med lagrad procedur StoredProcedure.execute

Mer information om programmering på serversidan finns på sidan om Azure Cosmos DB-programmering på serversidan: lagrade procedurer, databasutlösare och UDF:er.

Autentiseringsexempel för Azure Identity(AAD)

Filen AADAuth.ts visar hur du utför följande uppgifter.

Uppgift API-referens
Create credential object from @azure/identity API
Skicka autentiseringsuppgifter till klientobjekt med viktiga aadCredentials API
Köra Cosmos-klienten med aad-autentiseringsuppgifter API

Diverse exempel

Följande utvalda exempel illustrerar vanliga scenarier.

Uppgift API-referens
Ändra frågedataflöde API
Hämta dataflöde för frågor API
använda SasTokens för att bevilja begränsad åtkomst till Cosmos DB-resurser API

Nästa steg

Försöker du planera kapacitet för en migrering till Azure Cosmos DB? Du kan använda information om ditt befintliga databaskluster för kapacitetsplanering.