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

Создание контейнера в Azure Cosmos DB для NoSQL

  • Статья

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

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

В этой статье описаны различные способы создания контейнера в Azure Cosmos DB для NoSQL. Если вы используете другой API, ознакомьтесь с API для MongoDB, API для Cassandra, API для Gremlin и API для таблиц, чтобы создать контейнер.

Примечание.

При создании контейнеров следите за тем, чтобы не создать два контейнера с одинаковыми именами, но в разных регистрах. Причина в том, что некоторые компоненты платформы Azure не учитывают регистр. Это может привести к путанице или конфликтам в данных телеметрии и действиях с контейнерами с такими именами.

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

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

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

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

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

    Снимок экрана: обозреватель данных с выделенным элементом

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

Создайте контейнер с помощью Azure CLI. Список всех примеров Azure CLI для всех программных интерфейсов Azure Cosmos DB см. в статье Примеры Azure CLI для Azure Cosmos DB.

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

Создайте контейнер с помощью PowerShell. Список всех примеров PowerShell для всех программных интерфейсов Azure Cosmos DB см. в статье Примеры PowerShell.

Создайте контейнер с помощью .NET SDK

При возникновении исключения об истечении времени ожидания при создании коллекции выполните операцию чтения, чтобы проверить, была ли успешно создана коллекция. Операция чтения создает исключение до тех пор, пока операция создания коллекции не будет выполнена успешно. Список кодов состояния, поддерживаемых операцией создания, см. в статье Коды состояния HTTP для Azure Cosmos DB.

TokenCredential credential = new DefaultAzureCredential();

CosmosClient client = new (
    accountEndpoint: "<nosql-account-endpoint>",
    tokenCredential: credential
);

// Create a container with a partition key and provision 400 RU/s manual throughput.
Database database = await client.CreateDatabaseIfNotExistsAsync(databaseId);

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = containerId,
    PartitionKeyPath = "/myPartitionKey"
};

var throughput = ThroughputProperties.CreateManualThroughput(400);
Container container = await database.CreateContainerIfNotExistsAsync(containerProperties, throughput);

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