Voorbeelden voor Azure Cosmos DB for NoSQL SDK voor JS

  • Artikel

VAN TOEPASSING OP: NoSQL

Voorbeeldoplossingen die CRUD-bewerkingen en andere algemene bewerkingen uitvoeren op Azure Cosmos DB-resources, zijn opgenomen in de JavaScript SDK voor Azure Cosmos DB GitHub-opslagplaats. Dit artikel bevat:

  • Koppelingen naar de taken in elk van de Node.js-voorbeeldprojectbestanden.
  • Koppelingen naar het bijbehorende API-referentiemateriaal.

Vereisten

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

U kunt Azure Cosmos DB gratis proberen, zonder een Azure-abonnement en zonder toezegging. U kunt ook een gratis Azure Cosmos DB-account maken met de eerste 1000 RU/s en 25 GB opslagruimte. U kunt ook de Azure Cosmos DB-emulator gebruiken met een URI van https://localhost:8081. Zie Aanvragen verifiëren voor de sleutel die u nodig hebt voor de emulator.

U hebt ook de JavaScript SDK nodig.

Notitie

Elk voorbeeld staat op zichzelf. Het stelt zichzelf in en aan het einde worden de gegevens automatisch opgeschoond. Als zodanig wordt in de voorbeelden Containers.create meerdere keren aangeroepen. Telkens wanneer dit wordt gedaan, wordt uw abonnement gefactureerd voor één uur gebruik per prestatielaag van de container die wordt gemaakt.

Voorbeelden voor databases

In het bestand DatabaseManagement ziet u hoe u de CRUD-bewerkingen op de database uitvoert. Zie het conceptuele artikel Werken met databases, containers en items voor meer informatie over de Azure Cosmos DB-databases voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Een database maken als deze niet bestaat Databases.createIfNotExists
Databases voor een account weergeven Databases.readAll
Een database lezen op id Database.read
Een database verwijderen Database.delete

Voorbeelden van containers

In het bestand ContainerManagement ziet u hoe u de CRUD-bewerkingen op de database uitvoert. Zie het conceptuele artikel Werken met databases, containers en items voor meer informatie over de Azure Cosmos DB-verzamelingen voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Een container maken als deze niet bestaat Containers.createIfNotExists
Containers voor een account weergeven Containers.readAll
Een containerdefinitie lezen Container.read
Container verwijderen Container.delete

Voorbeelden van items

In het bestand ItemManagement ziet u hoe u de CRUD-bewerkingen op het item uitvoert. Zie het conceptuele artikel Werken met databases, containers en items voor meer informatie over de Azure Cosmos DB-documenten voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Items maken Items.create
Alle items in een container lezen Items.readAll
Een item op id lezen Item.read
Item alleen lezen als het is gewijzigd Item.read - RequestOptions.accessCondition
Een query uitvoeren voor documenten Items.query
Item vervangen Item.replace
Item vervangen door voorwaardelijke ETag-controle Item.replace - RequestOptions.accessCondition
Item verwijderen Item.delete

Voorbeelden van indexen

In het IndexManagement-bestand ziet u hoe u de indexering beheert. Zie de conceptuele artikelen Indexeringsbeleid, Indexeringstypen en Indexeringspaden voor meer informatie over het indexeren in Azure Cosmos DB voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Handmatig een specifiek item indexeren RequestOptions.indexingDirective: 'include'
Handmatig een bepaald item uitsluiten van de index RequestOptions.indexingDirective: 'exclude'
Een pad uitsluiten van de index IndexingPolicy.ExcludedPath
Een bereikindex maken op een tekenreekspad IndexKind.Range, IndexingPolicy, Items.query
Maak een container met standaard indexPolicy en werk de container vervolgens online bij Containers.create

Voorbeelden van programmering op de server

Het bestand index.ts laat zien hoe u de volgende taken uitvoert. Zie het conceptuele artikel Opgeslagen procedures, triggers en door de gebruiker gedefinieerde functiesvoor meer informatie over het programmeren op de server in Azure Cosmos DB voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Een opgeslagen procedure maken StoredProcedures.create
Een opgeslagen procedure uitvoeren StoredProcedure.execute
Bulksgewijs bijwerken met opgeslagen procedure StoredProcedure.execute

Zie voor meer informatie over het programmeren op de server Programmeren op de server met Azure Cosmos DB: opgeslagen procedures, databasetriggers en UDF's.

Azure Identity(AAD)-verificatievoorbeelden

Het AADAuth.ts-bestand laat zien hoe u de volgende taken uitvoert.

Opdracht API-verwijzing
Create credential object from @azure/identity API
Referenties doorgeven aan clientobject met sleutel aadCredentials API
Cosmos-client uitvoeren met aad-referenties API

Diverse voorbeelden

Na gecureerde voorbeelden ziet u veelvoorkomende scenario's.

Opdracht API-verwijzing
Querydoorvoer wijzigen API
Querydoorvoer verkrijgen API
sasTokens gebruiken voor het verlenen van scoped toegang tot Cosmos DB-resources API

Volgende stappen

Wilt u capaciteitsplanning uitvoeren voor een migratie naar Azure Cosmos DB? U kunt informatie over uw bestaande databasecluster gebruiken voor capaciteitsplanning.