Bagikan melalui

Membuat kontainer di Azure Cosmos DB untuk NoSQL

  • Artikel

BERLAKU UNTUK: NoSQL

Artikel ini menjelaskan berbagai cara untuk membuat kontainer di Azure Cosmos DB for NoSQL. Ini menunjukkan cara membuat kontainer menggunakan portal Microsoft Azure, Azure CLI, PowerShell, atau SDK yang didukung. Artikel ini menunjukkan cara membuat kontainer, menentukan kunci partisi, dan throughput penyediaan.

Artikel ini menjelaskan berbagai cara untuk membuat kontainer di Azure Cosmos DB for NoSQL. Jika Anda menggunakan API yang berbeda, lihat artikel API untuk MongoDB, API untuk Cassandra, API untuk Gremlin, dan API untuk Tabel untuk membuat kontainer.

Catatan

Saat membuat kontainer, pastikan Anda tidak membuat dua kontainer dengan nama yang sama tetapi casing yang berbeda. Itu karena beberapa bagian dari platform Azure tidak peka huruf besar/kecil, dan ini dapat mengakibatkan kebingungan/benturan telemetri dan tindakan pada kontainer dengan nama tersebut.

Membuat kontainer menggunakan portal Azure

  1. Masuk ke portal Azure.

  2. Buat akun Azure Cosmos DB baru, atau pilih akun yang sudah ada.

  3. Buka panel Azure Data Explorer, dan pilih Kontainer Baru. Selanjutnya, harap berikan detail berikut:

    • Menunjukkan apakah Anda membuat database baru atau menggunakan database yang sudah ada.
    • Masukkan ID Kontainer.
    • Masukkan nilai kunci Partisi (misalnya, /ItemID).
    • Pilih throughput Autoscale atau Manual dan masukkan throughput Kontainer yang diperlukan (misalnya, 1000 RU/dtk). Masukkan throughput yang ingin Anda provisikan (misalnya, 1000 RU).
    • Pilih OK.

    Cuplikan layar Data Explorer, dengan Koleksi baru disorot

Membuat kontainer menggunakan Azure CLI

Buat kontainer dengan Azure CLI. Untuk daftar semua sampel Azure CLI di semua Azure Cosmos DB API, lihat sampel Azure CLI untuk Azure Cosmos DB.

Buat kontainer dengan PowerShell

Buat kontainer dengan PowerShell. Untuk daftar semua sampel PowerShell di semua API DB Azure Cosmos, lihat Sampel PowerShell

Membuat kontainer menggunakan .NET SDK

Jika Anda menemukan pengecualian waktu habis saat membuat koleksi, lakukan operasi baca untuk memvalidasi apakah koleksi berhasil dibuat. Operasi baca melontarkan pengecualian hingga operasi pembuatan koleksi berhasil. Untuk daftar kode status yang didukung oleh operasi buat, lihat artikel Kode Status HTTP untuk Azure Cosmos DB.

TokenCredential credential = new DefaultAzureCredential();

CosmosClient client = new (
    accountEndpoint: "<nosql-account-endpoint>",
    tokenCredential: credential
);

// Create a container with a partition key and provision 400 RU/s manual throughput.
Database database = await client.CreateDatabaseIfNotExistsAsync(databaseId);

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = containerId,
    PartitionKeyPath = "/myPartitionKey"
};

var throughput = ThroughputProperties.CreateManualThroughput(400);
Container container = await database.CreateContainerIfNotExistsAsync(containerProperties, throughput);

Langkah berikutnya