Beispiele für Azure Cosmos DB for NoSQL für Python

  • Artikel

GILT FÜR: NoSQL

Beispiellösungen, in denen CRUD-Vorgänge und andere gängige Vorgänge für Azure Cosmos DB-Ressourcen ausgeführt werden, finden Sie im Ordner main/sdk/cosmos im GitHub-Repository azure/azure-sdk-for-python. Dieser Artikel enthält Folgendes:

  • Links zu den Aufgaben in den einzelnen Python-Beispielprojektdateien.
  • Links zum zugehörigen API-Referenzinhalt.

Voraussetzungen

Datenbankbeispiele

Das Python-Beispiel database_management.py zeigt, wie die folgenden Aufgaben mithilfe von CosmosClient-Methoden ausgeführt werden. Um mehr über die Azure Cosmos DB-Datenbanken zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.

Aufgabe API-Referenz
Erstellen einer Datenbank CosmosClient.create_database
Lesen einer Datenbank nach ID CosmosClient.get_database_client
Abfragen der Datenbanken CosmosClient.query_databases
Auflisten von Datenbanken für ein Konto CosmosClient.list_databases
Löschen einer Datenbank CosmosClient.delete_database

Containerbeispiele

Das Python-Beispiel container_management.py zeigt, wie die folgenden Aufgaben mithilfe von DatabaseProxy-Methoden ausgeführt werden. Um mehr über die Azure Cosmos DB-Sammlungen zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.

Aufgabe API-Referenz
Abfrage nach einem Container database.query_containers
Container erstellen database.create_container
Auflisten aller Container in einer Datenbank database.list_containers
Abrufen eines Containers anhand seiner ID database.get_container_client
Verwalten des bereitgestellten Durchsatzes für einen Container container.replace_throughput
Löschen eines Containers database.delete_container

Elementbeispiele

Die Python-Beispiele document_management.py und change_feed_management.py zeigen, wie die folgenden Aufgaben mithilfe von ContainerProxy-Methoden ausgeführt werden. Um mehr über die Azure Cosmos DB-Elemente zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.

Aufgabe API-Referenz
Erstellen von Elementen in einem Container container.create_item
Lesen eines Elements anhand seiner ID container.read_item
Lesen aller Elemente in einem Container container.read_all_items
Abfragen eines Elements anhand seiner ID container.query_items
Ersetzen eines Elements container.replace_item
Aktualisieren/Einfügen (Upsert) eines Elements container.upsert_item
Löschen eines Elements container.delete_item
Abrufen des Änderungsfeeds von Elementen in einem Container container.query_items_change_feed

Indizierungsbeispiele

Das Python-Beispiel index_management.py zeigt, wie die folgenden Aufgaben ausgeführt werden. Um mehr über die Indizierung in Azure Cosmos DB zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele die Konzeptartikel Indizierungsrichtlinien, Indizierungstypen und Indizierungspfade.

Aufgabe API-Referenz
Ausschließen eines bestimmten Elements von der Indizierung documents.IndexingDirective.Exclude
Verwenden der manuellen Indizierung mit bestimmten indizierten Elementen documents.IndexingDirective.Include
Ausschließen von Pfaden von der Indizierung Definieren von Pfaden, die in der IndexingPolicy-Eigenschaft ausgeschlossen werden sollen
Verwenden von Bereichsindizes in Zeichenfolgen Definieren der Indizierungsrichtlinie mit Bereichsindizes für den Datentyp „String“. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Durchführen einer Indextransformation database.replace_container (Verwenden der aktualisierten Indizierungsrichtlinie)
Verwenden von Scans, wenn nur ein Hashindex im Pfad vorhanden ist Festlegen von enable_scan_in_query=True und enable_cross_partition_query=True beim Abfragen der Elemente

Nächste Schritte

Versuchen Sie, die Kapazitätsplanung für eine Migration zu Azure Cosmos DB durchzuführen? Sie können Informationen zu Ihrem vorhandenen Datenbankcluster für die Kapazitätsplanung verwenden.