Подготовка стандартной (ручной) пропускной способности в контейнере Azure Cosmos DB — API для NoSQL

Статья
08/15/2024

ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL

В этой статье объясняется, как подготовить стандартную (ручную) пропускную способность в контейнере в Azure Cosmos DB для NoSQL. Вы можете подготовить пропускную способность для одного контейнера или базы данных и предоставить к ней общий доступ для контейнеров в пределах этой базы данных. Пропускную способность для контейнера можно подготовить с помощью портала Azure, Azure CLI или пакетов SDK Azure Cosmos DB.

Если вы используете другой API, ознакомьтесь с API для MongoDB, API для Cassandra, статьями API для Gremlin для подготовки пропускной способности.

Портал Azure

Войдите на портал Azure.
Создайте новую учетную запись Azure Cosmos DB или выберите существующую учетную запись Azure Cosmos DB.
Откройте панель Обозреватель данных и выберите Создать контейнер. После этого предоставьте следующие сведения.
- Укажите, создаете ли вы новую базу данных или используете существующую.
- Введите идентификатор контейнера.
- Введите значение ключа секции (например, /ItemID).
- Выберите способ установления пропускной способности Автомасштабирование или Вручную и введите необходимую пропускную способность контейнера (например, 1000 ЕЗ/с). Укажите подготавливаемую пропускную способность (например, 1000 ЕЗ/с).
- Нажмите ОК.

Azure CLI или Azure PowerShell

Чтобы создать контейнер с выделенной пропускной способностью, см. разделы:

Пакет SDK для .NET

Примечание.

Используйте пакеты SDK Azure Cosmos DB для API для NoSQL для подготовки пропускной способности для всех API Azure Cosmos DB, кроме Cassandra и API для MongoDB.

Пакет SDK для .NET версии 2
Пакет SDK для .NET версии 3

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

Пакет SDK для JavaScript

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

Следующие шаги

Чтобы узнать о подготовке пропускной способности в Cosmos DB, обратитесь к следующим статьям:

Поделиться через