Megosztás a következőn keresztül:

Példák az Azure Cosmos DB for NoSQL SDK for JS-hez

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Az Azure Cosmos DB GitHubhoz készült JavaScript SDK tartalmazza a CRUD-műveleteket és más gyakori műveleteket végző mintamegoldásokat az Azure Cosmos DB GitHub-adattárban. Ez a cikk a következő információkat tartalmazza:

  • Az egyes Node.js-példák projektfájljaiban a feladatokra mutató hivatkozások.
  • A kapcsolódó API-referenciatartalmak hivatkozásai.

Előfeltételek

Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.

Az Azure Cosmos DB ingyenesen, Azure-előfizetés nélkül és kötelezettségvállalás nélkül is kipróbálható. Másik lehetőségként létrehozhat egy ingyenes szintű Azure Cosmos DB-fiókot, amely az első 1000 RU/s és 25 GB tárterülettel rendelkezik ingyenesen. Az Azure Cosmos DB emulátort az URI-val is használhatja https://localhost:8081. Az emulátorhoz használandó kulcsról a kérelmek hitelesítése című témakörben olvashat.

A JavaScript SDK-ra is szüksége lesz.

Feljegyzés

Minden minta önálló, elvégzi a saját beállításait és eltávolítja a nyomait. Így a minták egyszerre több hívást intéznek a Containers.create felé. Minden ilyen hívás esetén az előfizetésére 1 órányi használat terhelődik a létrehozott tároló teljesítményszintjének megfelelően.

Adatbázis-példák

A DatabaseManagement fájl bemutatja, hogyan hajthatja végre a CRUD-műveleteket az adatbázisban. Az Alábbi minták futtatása előtt az Azure Cosmos DB-adatbázisokról további információt az adatbázisok, tárolók és elemek használata című témakörben talál.

Task API-referencia
Adatbázis létrehozása, ha az nem létezik Databases.createIfNotExists
Egy fiókhoz tartozó adatbázisok listázása Databases.readAll
Adatbázis beolvasása azonosító alapján Database.read
Adatbázis törlése Database.delete

Példák tárolókra

A ContainerManagement fájl bemutatja, hogyan hajthatja végre a CRUD-műveleteket a tárolón. Az Alábbi minták futtatása előtt az Azure Cosmos DB-gyűjteményekkel kapcsolatos további információkért tekintse meg az adatbázisok, tárolók és elemek használatának elméleti cikkét.

Task API-referencia
Tároló létrehozása, ha nem létezik Containers.createIfNotExists
Fiók tárolóinak felsorolása Containers.readAll
Tárolódefiníció olvasása Container.read
Tároló törlése Container.delete

Példák elemekre

Az ItemManagement fájl bemutatja, hogyan hajthatja végre a CRUD-műveleteket az elemen. Az Alábbi minták futtatása előtt az Azure Cosmos DB-dokumentumok megismeréséhez tekintse meg az adatbázisok, tárolók és elemek használatának elméleti cikkét.

Task API-referencia
Elemek létrehozása Items.create
A tároló összes elemének beolvasása Items.readAll
Elem beolvasása azonosító alapján Item.read
Az elem olvasása csak akkor, ha az elem megváltozott Item.read - RequestOptions.accessCondition
Dokumentumok lekérdezése Items.query
Elem cseréje Item.replace
Elem cseréje feltételes ETag-ellenőrzéssel Item.replace - RequestOptions.accessCondition
Elem törlése Item.delete

Indexelési példák

Az IndexManagement fájl az indexelés kezelését mutatja be. Az alábbi minták futtatása előtt az Azure Cosmos DB-ben történő indexelésről az indexelési szabályzatok, az indexelési típusok és az indexelési útvonalak elméleti cikkeiben olvashat.

Task API-referencia
Adott elem manuális indexelése RequestOptions.indexingDirective: 'include'
Adott elem manuális kizárása az indexből RequestOptions.indexingDirective: 'exclude'
Elérési út kizárása az indexből IndexingPolicy.ExcludedPath
Tartományindex létrehozása sztringútvonalon IndexKind.Range, IndexingPolicy, Items.query
Hozzon létre egy tárolót az alapértelmezett indexPolicy használatával, majd frissítse a tárolót online Containers.create

Kiszolgálóoldali programozási példák

A index.ts fájl a következő feladatok elvégzését mutatja be. Ha az alábbi minták futtatása előtt szeretne többet megtudni az Azure Cosmos DB kiszolgálóoldali programozásáról, tekintse meg a tárolt eljárásokat, az eseményindítókat és a felhasználó által definiált függvényeket ismertető elméleti cikket.

Task API-referencia
Tárolt eljárás létrehozása StoredProcedures.create
Tárolt eljárás végrehajtása StoredProcedure.execute
Tömeges frissítés tárolt eljárással StoredProcedure.execute

A kiszolgálóoldali programozásról további információt az Azure Cosmos DB kiszolgálóoldali programozás ismertetőjének tárolt eljárásokat, adatbázis-triggereket és UDF-eket leíró részében talál.

Microsoft Entra hitelesítési példák

A EntraAuth.ts fájl a következő feladatok elvégzését mutatja be.

Task API-referencia
Create credential object from @azure/identity API
Jogkivonat hitelesítő adatainak átadása az ügyfélkonstruktornak API
Cosmos-ügyfél végrehajtása aad-hitelesítő adatokkal API

Egyéb minták

Az alábbi válogatott minták a gyakori forgatókönyveket szemléltetik.

Task API-referencia
Lekérdezés átviteli sebességének módosítása API
Lekérdezés átviteli sebességének lekérése API
a SasTokens használata hatókörön belüli hozzáférés biztosításához Cosmos DB-erőforrásokhoz API

Következő lépések

Kapacitástervezést szeretne végezni az Azure Cosmos DB-be való migráláshoz? A kapacitástervezéshez használhatja a meglévő adatbázisfürt adatait.