Membuat kontainer di Azure Cosmos DB SQL API

  • Artikel
  • 2 menit untuk membaca

BERLAKU UNTUK: SQL API

Artikel ini menjelaskan berbagai cara untuk membuat kontainer di Azure Cosmos DB SQL API. 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 SQL API. Jika Anda menggunakan API yang berbeda, lihat artikel API untuk MongoDB, Cassandra API, SQL API, dan Table API untuk menemukan biaya RU.

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 Microsoft Azure

  1. Masuk ke portal Azure.

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

  3. Buka panel 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 sediakan (misalnya, 1000 RU).
    • PilihOK.

    Screenshot of Data Explorer, with New Collection highlighted

Membuat kontainer dengan TTL 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.

Membuat kontainer menggunakan 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.

// Create a container with a partition key and provision 400 RU/s manual throughput.
CosmosClient client = new CosmosClient(connectionString, clientOptions);
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