Azure Cosmos kapsayıcısı oluşturmaCreate an Azure Cosmos container

Bu makalede, Azure Cosmos kapsayıcısı (koleksiyon, tablo veya grafik) oluşturmanın farklı yolları açıklanmaktadır.This article explains the different ways to create an Azure Cosmos container (collection, table, or graph). Bu için Azure portal, Azure CLı veya desteklenen SDK 'lar kullanabilirsiniz.You can use Azure portal, Azure CLI, or supported SDKs for this. Bu makalede bir kapsayıcı oluşturma, Bölüm anahtarını belirtme ve üretilen iş sağlama işlemlerinin nasıl yapılacağı gösterilir.This article demonstrates how to create a container, specify the partition key, and provision throughput.

Azure portal kullanarak kapsayıcı oluşturmaCreate a container using Azure portal

SQL APı 'SISQL API

  1. Azure Portaloturum açın.Sign in to the Azure portal.

  2. Yeni bir Azure Cosmos hesabı oluşturunveya var olan bir hesabı seçin.Create a new Azure Cosmos account, or select an existing account.

  3. Veri Gezgini bölmesini açın ve yeni kapsayıcı' yı seçin.Open the Data Explorer pane, and select New Container. Ardından, aşağıdaki ayrıntıları sağlayın:Next, provide the following details:

    • Yeni bir veritabanı mı yoksa var olan bir veritabanını mı kullandığınızı belirtin.Indicate whether you are creating a new database or using an existing one.
    • Bir kapsayıcı KIMLIĞI girin.Enter a container ID.
    • Bir bölüm anahtarı girin.Enter a partition key.
    • Sağlanacak bir üretilen iş (örneğin, 1000 ru) girin.Enter a throughput to be provisioned (for example, 1000 RUs).
    • Tamam ' ıseçin.Select OK.

    Yeni kapsayıcı vurgulanmış şekilde Veri Gezgini bölmesinin ekran görüntüsü

MongoDB için Azure Cosmos DB API 'SIAzure Cosmos DB API for MongoDB

  1. Azure Portaloturum açın.Sign in to the Azure portal.

  2. Yeni bir Azure Cosmos hesabı oluşturunveya var olan bir hesabı seçin.Create a new Azure Cosmos account, or select an existing account.

  3. Veri Gezgini bölmesini açın ve yeni kapsayıcı' yı seçin.Open the Data Explorer pane, and select New Container. Ardından, aşağıdaki ayrıntıları sağlayın:Next, provide the following details:

    • Yeni bir veritabanı mı yoksa var olan bir veritabanını mı kullandığınızı belirtin.Indicate whether you are creating a new database or using an existing one.
    • Bir kapsayıcı KIMLIĞI girin.Enter a container ID.
    • Parça anahtarı girin.Enter a shard key.
    • Sağlanacak bir üretilen iş (örneğin, 1000 ru) girin.Enter a throughput to be provisioned (for example, 1000 RUs).
    • Tamam ' ıseçin.Select OK.

    MongoDB için Azure Cosmos DB API 'nin ekran görüntüsü, kapsayıcı ekleme iletişim kutusu

Cassandra APICassandra API

  1. Azure Portaloturum açın.Sign in to the Azure portal.

  2. Yeni bir Azure Cosmos hesabı oluşturunveya var olan bir hesabı seçin.Create a new Azure Cosmos account, or select an existing account.

  3. Veri Gezgini bölmesini açın ve Yeni tablo' yı seçin.Open the Data Explorer pane, and select New Table. Ardından, aşağıdaki ayrıntıları sağlayın:Next, provide the following details:

    • Yeni bir keyspace mi, yoksa var olanı mi kullandığınızı belirtin.Indicate whether you are creating a new keyspace, or using an existing one.
    • Tablo adı girin.Enter a table name.
    • Özellikleri girin ve bir birincil anahtar belirtin.Enter the properties and specify a primary key.
    • Sağlanacak bir üretilen iş (örneğin, 1000 ru) girin.Enter a throughput to be provisioned (for example, 1000 RUs).
    • Tamam ' ıseçin.Select OK.

    Cassandra API, tablo Ekle iletişim kutusunun ekran görüntüsü

Not

Cassandra API için birincil anahtar, bölüm anahtarı olarak kullanılır.For Cassandra API, the primary key is used as the partition key.

Gremlin API 'SIGremlin API

  1. Azure Portaloturum açın.Sign in to the Azure portal.

  2. Yeni bir Azure Cosmos hesabı oluşturunveya var olan bir hesabı seçin.Create a new Azure Cosmos account, or select an existing account.

  3. Veri Gezgini bölmesini açın ve yeni grafik' i seçin.Open the Data Explorer pane, and select New Graph. Ardından, aşağıdaki ayrıntıları sağlayın:Next, provide the following details:

    • Yeni bir veritabanı mı yoksa var olan bir veritabanını mı kullandığınızı belirtin.Indicate whether you are creating a new database, or using an existing one.
    • Bir grafik KIMLIĞI girin.Enter a Graph ID.
    • Sınırsız depolama kapasitesi seçin.Select Unlimited storage capacity.
    • Köşeler için bir bölüm anahtarı girin.Enter a partition key for vertices.
    • Sağlanacak bir üretilen iş (örneğin, 1000 ru) girin.Enter a throughput to be provisioned (for example, 1000 RUs).
    • Tamam ' ıseçin.Select OK.

    Gremlin API ekran görüntüsü, Graf Ekle iletişim kutusu

Tablo API'siTable API

  1. Azure Portaloturum açın.Sign in to the Azure portal.

  2. Yeni bir Azure Cosmos hesabı oluşturunveya var olan bir hesabı seçin.Create a new Azure Cosmos account, or select an existing account.

  3. Veri Gezgini bölmesini açın ve Yeni tablo' yı seçin.Open the Data Explorer pane, and select New Table. Ardından, aşağıdaki ayrıntıları sağlayın:Next, provide the following details:

    • Tablo KIMLIĞI girin.Enter a Table ID.
    • Sağlanacak bir üretilen iş (örneğin, 1000 ru) girin.Enter a throughput to be provisioned (for example, 1000 RUs).
    • Tamam ' ıseçin.Select OK.

    Tablo API'si, tablo Ekle iletişim kutusunun ekran görüntüsü

Not

Tablo API'si için, her yeni satır eklediğiniz her seferinde bölüm anahtarı belirtilir.For Table API, the partition key is specified each time you add a new row.

Azure CLı kullanarak kapsayıcı oluşturmaCreate a container using Azure CLI

Aşağıdaki bağlantılar, Azure CLı kullanarak Azure Cosmos DB için kapsayıcı kaynakları oluşturmayı gösterir.The links below show how to create container resources for Azure Cosmos DB using Azure CLI.

Tüm Azure Cosmos DB API 'lerde tüm Azure CLı örneklerinin listesi için bkz. SQL API, Cassandra API, MongoDB API, Gremlin APIve tablo API'siFor a listing of all Azure CLI samples across all Azure Cosmos DB APIs see, SQL API, Cassandra API, MongoDB API, Gremlin API, and Table API

PowerShell@no__t kullanarak kapsayıcı oluşturma-1Create a container using PowerShell

Aşağıdaki bağlantılar, PowerShell kullanarak Azure Cosmos DB için kapsayıcı kaynaklarının nasıl oluşturulacağını gösterir.The links below show how to create container resources for Azure Cosmos DB using PowerShell.

Tüm Azure Cosmos DB API 'lerde tüm Azure CLı örneklerinin listesi için bkz. SQL API, Cassandra API, MongoDB API, Gremlin APIve tablo API'siFor a listing of all Azure CLI samples across all Azure Cosmos DB APIs see, SQL API, Cassandra API, MongoDB API, Gremlin API, and Table API

.NET SDK kullanarak kapsayıcı oluşturmaCreate a container using .NET SDK

SQL API ve Gremlin API 'SISQL API and Gremlin API

// Create a container with a partition key and provision 1000 RU/s throughput.
DocumentCollection myCollection = new DocumentCollection();
myCollection.Id = "myContainerName";
myCollection.PartitionKey.Paths.Add("/myPartitionKey");

await client.CreateDocumentCollectionAsync(
    UriFactory.CreateDatabaseUri("myDatabaseName"),
    myCollection,
    new RequestOptions { OfferThroughput = 1000 });

MongoDB için Azure Cosmos DB API 'SIAzure Cosmos DB API for MongoDB

// Create a collection with a partition key by using Mongo Shell:
db.runCommand( { shardCollection: "myDatabase.myCollection", key: { myShardKey: "hashed" } } )

Not

MongoDB tel protokolü, Istek birimikavramını anlamıyor.MongoDB wire protocol does not understand the concept of Request Units. Üzerinde üretilen işleme ile yeni bir koleksiyon oluşturmak için SQL API için Azure portal veya Cosmos DB SDK 'larını kullanın.To create a new collection with provisioned throughput on it, use the Azure portal or Cosmos DB SDKs for SQL API.

Cassandra APICassandra API

// Create a Cassandra table with a partition/primary key and provision 1000 RU/s throughput.
session.Execute(CREATE TABLE myKeySpace.myTable(
    user_id int PRIMARY KEY,
    firstName text,
    lastName text) WITH cosmosdb_provisioned_throughput=1000);

Sonraki adımlarNext steps