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

  • Článek

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

  1. Přihlaste se k portálu Azure.

  2. Vytvořte nový účet služby Azure Cosmos DB nebo vyberte existující účet služby Azure Cosmos DB.

  3. 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.

    Screenshot of Data Explorer, with New Collection highlighted

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.

// 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 });

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: