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

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

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

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

1. Войдите на портал Azure.

2. Создайте новую учетную запись Azure Cosmos DB или выберите существующую учетную запись Azure Cosmos DB.

3. Откройте панель Обозреватель данных и выберите Создать контейнер. После этого предоставьте следующие сведения.

   • Укажите, создаете ли вы новую базу данных или используете существующую.
   • Введите идентификатор контейнера.
   • Введите значение ключа раздела (например, /ItemID).
   • Выберите Автомасштабирование или Вручную и введите необходимую пропускную способность контейнера (например, 1000 RU/с). Укажите пропускную способность, которую хотите выделить (например, 1000 RUs).
   • Нажмите ОК.

   

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

• Создание контейнера с помощью Azure CLI
• Создание контейнера с помощью PowerShell

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

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

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

• Как подготовить стандартную (вручную настраиваемую) пропускную способность в базе данных
• Подготовка автомасштабируемой пропускной способности в базе данных
• Пропускная способность и единицы запросов в Azure Cosmos DB