Sdílet prostřednictvím

Příklady pro sadu Azure Cosmos DB for NoSQL SDK pro JS

  • Článek

PLATÍ PRO: NoSQL

Ukázková řešení, která provádějí operace CRUD a další běžné operace s prostředky azure Cosmos DB, jsou součástí javascriptové sady SDK pro úložiště GitHub služby Azure Cosmos DB . Tento článek obsahuje:

  • Odkazy na úlohy v jednotlivých ukázkových souborech projektů v Node.js.
  • Odkazy na související referenční obsah rozhraní API

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Službu Azure Cosmos DB můžete vyzkoušet zdarma bez předplatného Azure a bez nutnosti závazku. Alternativně můžete vytvořit účet úrovně Free služby Azure Cosmos DB s prvních 1 000 RU/s a 25 GB úložiště zdarma. Emulátor služby Azure Cosmos DB můžete také použít s identifikátorem URI https://localhost:8081služby . Klíč, který se má použít s emulátorem, najdete v tématu Ověřování požadavků.

Potřebujete také sadu JavaScript SDK.

Poznámka:

Každá ukázka je samostatná, sama se nastaví a po ukončení příkladu vyčistí svoje prostředky. Ukázky provedou několik volání metody Containers.create. Pokaždé, když k tomu dojde, se bude pro vaše předplatné účtovat 1 hodina využití pro úroveň výkonu vytvářeného kontejneru.

Příklady pro databáze

Soubor DatabaseManagement ukazuje, jak provádět operace CRUD v databázi. Další informace o databázích Azure Cosmos DB před spuštěním následujících ukázek najdete v koncepčním článku Práce s databázemi, kontejnery a položkami .

Úloha Reference rozhraní API
Vytvoření databáze, pokud neexistuje Databases.createIfNotExists
Výpis databází pro účet Databases.readAll
Čtení databáze podle ID Database.read
Odstranění databáze Database.delete

Příklady pro kontejnery

Soubor ContainerManagement ukazuje, jak provádět operace CRUD v kontejneru. Další informace o kolekcích Azure Cosmos DB před spuštěním následujících ukázek najdete v koncepčním článku Práce s databázemi, kontejnery a položkami .

Úloha Reference rozhraní API
Vytvoření kontejneru, pokud neexistuje Containers.createIfNotExists
Výpis kontejnerů pro účet Containers.readAll
Čtení definice kontejneru Container.read
Odstranění kontejneru Container.delete

Příklady pro položky

Soubor ItemManagement ukazuje, jak provádět operace CRUD s položkou. Další informace o dokumentech služby Azure Cosmos DB před spuštěním následujících ukázek najdete v koncepčním článku Práce s databázemi, kontejnery a položkami .

Úloha Reference rozhraní API
Vytvoření položek Items.create
Čtení všech položek v kontejneru Items.readAll
Čtení položky podle ID Item.read
Čtení položky pouze v případě, že se změnila Item.read - RequestOptions.accessCondition
Dotazování dokumentů Items.query
Nahrazení položky Item.replace
Nahrazení položky pomocí podmíněné kontroly ETag Item.replace - RequestOptions.accessCondition
Odstranění položky Item.delete

Příklady indexování

Soubor IndexManagement ukazuje, jak spravovat indexování. Další informace o indexování ve službě Azure Cosmos DB před spuštěním následujících ukázek najdete v koncepčních článcích o zásadách indexování, typech indexování a cest indexování.

Úloha Reference rozhraní API
Ruční indexování konkrétní položky RequestOptions.indexingDirective: 'include'
Ruční vyloučení konkrétní položky z indexu RequestOptions.indexingDirective: 'exclude'
Vyloučení cesty z indexu IndexingPolicy.ExcludedPath
Vytvoření indexu rozsahu v cestě řetězce IndexKind.Range, IndexingPolicy, Items.query
Vytvořte kontejner s výchozím indexPolicy a pak aktualizujte kontejner online. Containers.create

Příklady programování na straně serveru

Soubor index.ts ukazuje, jak provádět následující úlohy. Pokud se chcete seznámit s programováním na straně serveru ve službě Azure Cosmos DB před spuštěním následujících ukázek, přečtěte si článek o uložených procedurách, triggerech a uživatelem definovaných funkcích .

Úloha Reference rozhraní API
Vytvoření uložené procedury StoredProcedures.create
Spuštění uložené procedury StoredProcedure.execute
Hromadná aktualizace pomocí uložené procedury StoredProcedure.execute

Další informace o programování na straně serveru najdete v tématu o programování na straně serveru pro Azure Cosmos DB: uložené procedury, aktivační události databáze a UDF.

Příklady ověřování Azure Identity (AAD)

Soubor AADAuth.ts ukazuje, jak provádět následující úlohy.

Úloha Reference rozhraní API
Create credential object from @azure/identity Rozhraní API
Předání přihlašovacích údajů do objektu klienta s klíčem aadCredentials Rozhraní API
Spuštění klienta cosmos s přihlašovacími údaji aad Rozhraní API

Různé vzorky

Následující kurátorované ukázky ilustrují běžné scénáře.

Úloha Reference rozhraní API
Změna propustnosti dotazu Rozhraní API
Získání propustnosti dotazů Rozhraní API
Použití SasTokens pro udělení omezeného přístupu k prostředkům Cosmos DB Rozhraní API

Další kroky

Pokoušíte se naplánovat kapacitu migrace do služby Azure Cosmos DB? Informace o stávajícím databázovém clusteru můžete použít k plánování kapacity.