Zřízení standardní (ruční) propustnosti v kontejneru Azure Cosmos DB – ROZHRANÍ API pro NoSQL

Článek
08/15/2024

PLATÍ PRO: NoSQL

Tento článek vysvětluje, jak zřídit standardní (ruční) propustnost kontejneru ve službě Azure Cosmos DB for NoSQL. Propustnost můžete zřídit pro jeden kontejner nebo zřídit propustnost databáze a sdílet ji mezi kontejnery v databázi. Propustnost kontejneru můžete zřídit pomocí webu Azure Portal, Azure CLI nebo sad SDK služby Azure Cosmos DB.

Pokud používáte jiné rozhraní API, informace o zřízení propustnosti najdete v článcích api pro MongoDB, API for Cassandra, api pro Gremlin .

portál Azure

Přihlaste se k portálu Azure.
Vytvořte nový účet služby Azure Cosmos DB nebo vyberte existující účet služby Azure Cosmos DB.
Otevřete podokno Průzkumník dat a vyberte Nový kontejner. Dále zadejte následující podrobnosti:
- Určete, jestli vytváříte novou databázi nebo používáte existující databázi.
- Zadejte ID kontejneru.
- Zadejte hodnotu klíče oddílu (například /ItemID).
- Vyberte automatické škálování nebo ruční propustnost a zadejte požadovanou propustnost kontejneru (například 1000 RU/s). Zadejte propustnost, kterou chcete zřídit (například 1 000 RU).
- Vyberte OK.

Azure CLI nebo PowerShell

Pokud chcete vytvořit kontejner s vyhrazenou propustností, podívejte se na

.NET SDK

Poznámka:

Pomocí sad SDK služby Azure Cosmos DB pro rozhraní API for NoSQL zřiďte propustnost pro všechna rozhraní API služby Azure Cosmos DB s výjimkou Cassandra a rozhraní API pro MongoDB.

.NET SDK V2
.NET SDK V3

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

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

// Create a container with a partition key and provision throughput of 1000 RU/s
string containerName = "myContainerName";
string partitionKeyPath = "/myPartitionKey";

await this.cosmosClient.GetDatabase("myDatabase").CreateContainerAsync(
    id: containerName,
    partitionKeyPath: partitionKeyPath,
    throughput: 1000);

JavaScript SDK

// Create a new Client
const client = new CosmosClient({ endpoint, key });

// Create a database
const { database } = await client.databases.createIfNotExists({ id: "databaseId" });

// Create a container with the specified throughput
const { resource } = await database.containers.createIfNotExists({
id: "containerId",
throughput: 1000
});

// To update an existing container or databases throughput, you need to user the offers API
// Get all the offers
const { resources: offers } = await client.offers.readAll().fetchAll();

// Find the offer associated with your container or the database
const offer = offers.find((_offer) => _offer.offerResourceId === resource._rid);

// Change the throughput value
offer.content.offerThroughput = 2000;

// Replace the offer.
await client.offer(offer.id).replace(offer);

Další kroky

Informace o zřizování propustnosti ve službě Azure Cosmos DB najdete v následujících článcích:

Sdílet prostřednictvím