Bagikan melalui

Mengonfigurasi kemampuan akun Azure Cosmos DB untuk MongoDB Anda

  • Artikel

BERLAKU UNTUK: MongoDB

Kemampuan adalah fitur yang dapat ditambahkan atau dihapus ke API Anda untuk akun MongoDB. Banyak dari fitur ini memengaruhi perilaku akun, jadi penting untuk sepenuhnya mengetahui efek yang dimiliki kemampuan sebelum Anda mengaktifkan atau menonaktifkannya. Beberapa kemampuan diatur pada API untuk akun MongoDB secara default dan tidak dapat diubah atau dihapus. Salah satu contohnya adalah kemampuannya EnableMongo . Artikel ini menunjukkan cara mengaktifkan dan menonaktifkan kemampuan.

Prasyarat

Kemampuan yang tersedia

Kemampuan Deskripsi Dapat dihapus
DisableRateLimitingResponses Memungkinkan Mongo API untuk mencoba kembali permintaan pembatasan laju di sisi server hingga nilai yang ditetapkan untuk max-request-timeout. Ya
EnableMongoRoleBasedAccessControl Aktifkan dukungan untuk membuat pengguna dan peran untuk kontrol akses berbasis peran MongoDB asli. No
EnableMongoRetryableWrites Memungkinkan dukungan untuk penulisan yang dapat diulang pada akun. Ya
EnableMongo16MBDocumentSupport Memungkinkan dukungan untuk menyisipkan dokumen hingga ukuran 16 MB. 1 No
EnableUniqueCompoundNestedDocs Mengaktifkan dukungan untuk indeks gabungan dan unik pada bidang berlapis jika bidang berlapis bukan array. No
EnableTtlOnCustomPath Menyediakan kemampuan untuk mengatur Time to Live (TTL) kustom pada satu bidang dalam koleksi. Mengatur TTL pada properti indeks unik parsial tidak didukung. 2 No
EnablePartialUniqueIndex Memungkinkan dukungan untuk indeks parsial yang unik, sehingga Anda memiliki lebih banyak fleksibilitas untuk menentukan bidang mana dalam dokumen yang ingin Anda indeks. No
EnableUniqueIndexReIndex Memungkinkan dukungan untuk pengindeksan ulang indeks unik untuk Cosmos DB untuk MongoDB RU. 2 No

Catatan

1 Kemampuan ini tidak dapat diaktifkan pada Azure Cosmos DB untuk akun MongoDB dengan Kunci Terkelola Pelanggan (CMK).

Catatan

2 Kemampuan ini tidak dapat diaktifkan pada Azure Cosmos DB untuk akun MongoDB dengan pencadangan berkelanjutan.

Penting

Mengubah kemampuan menggunakan Azure Resource Manager tidak tersedia untuk Azure Cosmos DB untuk akun MongoDB.

Mengaktifkan kapabilitas

  1. Ambil kemampuan akun yang ada dengan menggunakan az cosmosdb show:

    az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>

    Anda akan melihat bagian kemampuan yang mirip dengan contoh output ini:

    "capabilities": [
  {
    "name": "EnableMongo"
  }
]

    Tinjau kemampuan default. Dalam contoh ini, satu-satunya kemampuan yang ditetapkan adalah EnableMongo.

  2. Atur kapabilitas baru di akun database Anda. Daftar kemampuan harus menyertakan daftar kemampuan yang diaktifkan sebelumnya yang ingin Anda simpan.

    Hanya kemampuan bernama secara eksplisit yang diatur di akun Anda. Misalnya, jika Anda ingin menambahkan DisableRateLimitingResponses kemampuan ke contoh sebelumnya, gunakan perintah az cosmosdb update dengan --capabilities parameter , dan cantumkan semua kemampuan yang ingin Anda miliki di akun Anda:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo DisableRateLimitingResponses

    Penting

    Daftar kemampuan harus selalu menentukan semua kemampuan yang ingin Anda aktifkan, secara inklusif. Ini termasuk kemampuan yang sudah diaktifkan untuk akun yang ingin Anda simpan. Dalam contoh ini, EnableMongo kemampuan sudah diaktifkan, jadi Anda harus menentukan EnableMongo kemampuan dan kemampuannya DisableRateLimitingResponses .

    Tip

    Jika Anda menggunakan PowerShell dan pesan kesalahan muncul saat Anda menggunakan perintah sebelumnya, coba gunakan array PowerShell untuk mencantumkan kemampuan:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo","DisableRateLimitingResponses")

Menonaktifkan kapabilitas

  1. Ambil kemampuan akun yang ada dengan menggunakan az cosmosdb show:

    az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>

    Anda akan melihat bagian kemampuan yang mirip dengan contoh output ini:

    "capabilities": [
  {
    "name": "EnableMongo"
  },
  {
    "name": "DisableRateLimitingResponses"
  }
]

    Periksa semua kemampuan yang saat ini ditetapkan. Dalam contoh ini, dua kemampuan diatur: EnableMongo dan DisableRateLimitingResponses.

  2. Hapus salah satu kemampuan dari akun database Anda. Daftar kemampuan harus menyertakan daftar kemampuan yang diaktifkan sebelumnya yang ingin Anda simpan.

    Hanya kemampuan bernama secara eksplisit yang diatur di akun Anda. Misalnya, jika Anda ingin menghapus DisableRateLimitingResponses kemampuan, Anda akan menggunakan az cosmosdb update perintah , dan mencantumkan kemampuan yang ingin Anda simpan:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo

    Tip

    Jika Anda menggunakan PowerShell dan pesan kesalahan muncul saat Anda menggunakan perintah ini, coba gunakan array PowerShell untuk mencantumkan kemampuan:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo")

Langkah berikutnya