Contoh untuk Azure Cosmos DB untuk NoSQL SDK untuk Python

  • Artikel

BERLAKU UNTUK: NoSQL

Solusi sampel yang melakukan operasi CRUD dan operasi umum lainnya pada sumber daya Azure Cosmos DB disertakan dalam main/sdk/cosmos folder repositori GitHub azure/azure-sdk-for-python . Artikel ini menyediakan:

  • Tautan ke tugas di setiap file proyek contoh Python.
  • Tautan ke konten referensi API terkait.

Prasyarat

Contoh database

Sampel Python database_management.py menunjukkan cara melakukan tugas berikut menggunakan metode CosmosClient. Untuk mempelajari tentang database Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual bekerja dengan database, kontainer, dan item .

Task Referensi API
Membuat database CosmosClient.create_database
Membaca database menurut ID CosmosClient.get_database_client
Mengkueri database CosmosClient.query_databases
Mencantumkan database untuk akun CosmosClient.list_databases
Menghapus database CosmosClient.delete_database

Contoh kontainer

Sampel Python container_management.py memperlihatkan cara melakukan tugas berikut menggunakan metode DatabaseProxy. Untuk mempelajari tentang koleksi Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual Bekerja dengan database, kontainer, dan item .

Task Referensi API
Mengkueri kontainer database.query_containers
Membuat kontainer database.create_container
Membaca semua kontainer dalam database database.list_containers
Mendapatkan kontainer menurut ID database.get_container_client
Mengelola throughput kontainer yang disediakan container.replace_throughput
Menghapus kontainer database.delete_container

Contoh item

Sampel Python document_management.py dan change_feed_management.py menunjukkan cara melakukan tugas berikut menggunakan metode ContainerProxy. Untuk mempelajari tentang item Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual bekerja dengan database, kontainer, dan item .

Task Referensi API
Membaca item dalam kontainer container.create_item
Membaca item menurut ID container.read_item
Membaca semua item dalam kontainer container.read_all_items
Mengkueri item menurut ID-nya container.query_items
Mengganti item container.replace_item
Menyisipkan item container.upsert_item
Menghapus item container.delete_item
Mendapatkan umpan perubahan item dalam kontainer container.query_items_change_feed

Contoh pengindeksan

Sampel Python index_management.py memperlihatkan cara melakukan tugas berikut. Untuk mempelajari tentang pengindeksan di Azure Cosmos DB sebelum menjalankan sampel berikut, lihat artikel konseptual kebijakan pengindeksan, jenis pengindeksan, dan jalur pengindeksan.

Task Referensi API
Mengecualikan item tertentu dari pengindeksan Dokumen.IndexingDirective. Mengecualikan
Menggunakan pengindeksan manual dengan item tertentu yang diindeks documents.IndexingDirective.Include
Mengecualikan jalur dari pengindeksan Tentukan jalur yang akan dikecualikan dalam properti IndexingPolicy
Menggunakan indeks rentang pada string Menetapkan kebijakan pengindeksan dengan indeks rentang pada jenis data string. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Melakukan transformasi indeks Database. replace_container (gunakan kebijakan pengindeksan yang diperbarui)
Menggunakan pemindaian ketika hanya indeks hash yang ada pada jalur mengatur enable_scan_in_query=True dan enable_cross_partition_query=True saat mengkueri item

Langkah berikutnya

Mencoba melakukan perencanaan kapasitas untuk migrasi ke Azure Cosmos DB? Anda dapat menggunakan informasi tentang kluster database Anda yang ada saat ini untuk membuat perencanaan kapasitas.