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

  • Č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í main/sdk/cosmos složky úložiště GitHub azure /azure-sdk-for-python . Tento článek obsahuje:

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

Požadavky

Příklady pro databáze

Ukázka pythonu database_management.py ukazuje, jak provádět následující úlohy pomocí metod CosmosClient. 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 CosmosClient.create_database
Čtení databáze podle ID CosmosClient.get_database_client
Dotazování databází CosmosClient.query_databases
Výpis databází pro účet CosmosClient.list_databases
Odstranění databáze CosmosClient.delete_database

Příklady pro kontejnery

Ukázka pythonu container_management.py ukazuje, jak provádět následující úlohy pomocí metod DatabaseProxy. 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
Dotaz na kontejner database.query_containers
Vytvoření kontejneru database.create_container
Výpis všech kontejnerů v databázi database.list_containers
Získání kontejneru podle ID database.get_container_client
Správa zřízené propustnosti kontejneru container.replace_throughput
Odstranění kontejneru database.delete_container

Příklady pro položky

Ukázky pythonu document_management.py a change_feed_management.py ukazují, jak provádět následující úlohy pomocí metod ContainerProxy. Další informace o položkách 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 v kontejneru container.create_item
Čtení položky podle ID container.read_item
Čtení všech položek v kontejneru container.read_all_items
Dotazování položky podle ID container.query_items
Nahrazení položky container.replace_item
Přenesení položky container.upsert_item
Odstranění položky container.delete_item
Získání kanálu změn položek v kontejneru container.query_items_change_feed

Příklady indexování

Ukázka pythonu index_management.py ukazuje, jak provádět následující úlohy. 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
Vyloučení konkrétní položky z indexování Dokumenty.IndexingDirective. Vyloučit
Použití ručního indexování s konkrétními položkami indexovanými Dokumenty. IndexingDirective.Include
Vyloučení cest z indexování Definování cest pro vyloučení ve vlastnosti IndexingPolicy
Použití indexů rozsahu na řetězce Definujte zásadu indexování s indexy rozsahu u datového typu řetězce. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Provedení transformace indexu Databáze. replace_container (použijte aktualizované zásady indexování).
Kontrola použijte, pokud v cestě existuje pouze index hash. enable_scan_in_query=True nastavení a enable_cross_partition_query=True při dotazování položek

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.