Példák a Pythonhoz készült NoSQL SDK-hoz készült Azure Cosmos DB-hez
A KÖVETKEZŐRE VONATKOZIK: NoSQL
A CRUD-műveleteket és az Azure Cosmos DB-erőforrásokon végzett egyéb gyakori műveleteket tartalmazó mintamegoldások az main/sdk/cosmos
azure/azure-sdk-for-python GitHub-adattár mappájába kerülnek. Ez a cikk a következő információkat tartalmazza:
- A például szolgáló Python-projektfájlokban található feladatok hivatkozásai.
- A kapcsolódó API-referenciatartalmak hivatkozásai.
Előfeltételek
- Egy Azure Cosmos DB-fiók. A lehetőségek a következők:
- Egy Azure-beli aktív előfizetésen belül:
- Ingyenes Azure-fiók létrehozása vagy meglévő előfizetés használata
- Visual Studio Havi kreditek
- Ingyenes Azure Cosmos DB-szint
- Azure-beli aktív előfizetés nélkül:
- Próbálja ki ingyenesen az Azure Cosmos DB-t, amely egy 30 napig tartó tesztkörnyezet.
- Azure Cosmos DB Emulator
- Egy Azure-beli aktív előfizetésen belül:
- Python 3.7+, a
python
végrehajthatóPATH
fájllal. (További információ: Az Azure SDKs Python-verzió támogatási szabályzata.) - Visual Studio Code.
- Python-bővítmény a Visual Studio Code-hoz.
- Git.
- Azure Cosmos DB for NoSQL SDK for Python
Adatbázis-példák
A database_management.py Python-minta bemutatja, hogyan végezheti el a következő feladatokat CosmosClient-metódusokkal. 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 | CosmosClient.create_database |
Adatbázis beolvasása azonosító alapján | CosmosClient.get_database_client |
Adatbázisok lekérdezése | CosmosClient.query_databases |
Egy fiókhoz tartozó adatbázisok listázása | CosmosClient.list_databases |
Adatbázis törlése | CosmosClient.delete_database |
Példák tárolókra
A container_management.py Python-minta bemutatja, hogyan végezheti el a következő feladatokat DatabaseProxy metódusokkal. 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ó lekérdezése | database.query_containers |
Tároló létrehozása | database.create_container |
Adatbázis összes tárolójának listázása | database.list_containers |
Tároló lekérése az azonosító alapján | database.get_container_client |
Tároló kiosztott átviteli sebességének kezelése | container.replace_throughput |
Tároló törlése | database.delete_container |
Példák elemekre
A document_management.py és change_feed_management.py Python-minták bemutatják, hogyan végezheti el a következő feladatokat a ContainerProxy metódusokkal. Az Azure Cosmos DB-elemekről az alábbi minták futtatása előtt az adatbázisok, tárolók és elemek használatáról szóló elméleti cikk nyújt tájékoztatást.
Task | API-referencia |
---|---|
Elemek létrehozása tárolóban | container.create_item |
Elem beolvasása az azonosító alapján | container.read_item |
A tároló összes elemének beolvasása | container.read_all_items |
Elem lekérdezése az azonosító alapján | container.query_items |
Elem cseréje | container.replace_item |
Elem beszúrása | container.upsert_item |
Elem törlése | container.delete_item |
A tároló elemeinek változáscsatornájának lekérése | container.query_items_change_feed |
Indexelési példák
A index_management.py Python-minta bemutatja, hogyan végezheti el a következő feladatokat. 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 kizárása az indexelésből | Dokumentumok.IndexingDirective. Kizár |
Manuális indexelés használata adott indexelt elemekkel | Dokumentumok. IndexingDirective.Include |
Elérési utak kizárása az indexelésből | Kizárandó útvonalak definiálása az IndexingPolicy tulajdonságban |
Tartományindexek használata sztringeken | Indexelési szabályzat definiálása tartományindexekkel sztring adattípuson. 'kind': documents.IndexKind.Range , 'dataType': documents.DataType.String |
Indexátalakítás végrehajtása | adatbázis. replace_container (használja a frissített indexelési szabályzatot) |
Keresések használata, ha csak kivonatindex létezik az elérési úton | az enable_scan_in_query=True elemek lekérdezéséhez és enable_cross_partition_query=True beállításához |
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.
- Ha csak annyit tud, hogy hány virtuális mag és kiszolgáló található a meglévő adatbázisfürtben, olvassa el a kérelemegységek becslését virtuális magok vagy vCPU-k használatával
- Ha ismeri az aktuális adatbázis számítási feladataira vonatkozó tipikus kérési arányokat, olvassa el a kérelemegységek becslését az Azure Cosmos DB kapacitástervezővel