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

PLATÍ PRO: ROZHRANÍ SQL API

Tento článek vysvětluje, jak zřídit standardní (ruční) propustnost kontejneru v rozhraní SQL API služby Azure Cosmos DB. Propustnost můžete zřídit v jednom kontejneru nebo zřídit propustnost databáze a sdílet ji mezi kontejnery v databázi. Propustnost pro kontejner 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, projděte si články rozhraní API pro MongoDB, Rozhraní API Cassandra, články rozhraní Gremlin API pro zřízení propustnosti.

portál Azure

  1. Přihlaste se k webu Azure Portal.

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

  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 automatickou š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 1000 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

Sady SDK cosmos pro rozhraní SQL API můžete použít k zřízení propustnosti pro všechna rozhraní API služby Cosmos DB kromě Cassandra a rozhraní MongoDB API.

// 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

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