Создание коллекции в Azure Cosmos DB для MongoDB
Область применения: MongoDB
В этой статье описаны различные способы создания коллекции в Azure Cosmos DB для MongoDB. В нем показано, как создать коллекцию с помощью портала Azure, Azure CLI, PowerShell или поддерживаемых пакетов SDK. В этой статье показано, как создать коллекцию, указать ключ секции и подготовить пропускную способность.
Примечание.
Контейнеры и коллекции похожи на таблицу в реляционной базе данных. Мы ссылаемся на контейнеры в Azure Cosmos DB для NoSQL и на протяжении портал Azure, а коллекции используются в контексте Azure Cosmos DB для MongoDB, чтобы соответствовать терминологии, используемой в MongoDB.
В этой статье описаны различные способы создания коллекции в Azure Cosmos DB для MongoDB. Если вы используете другой API, ознакомьтесь с API noSQL, API для Cassandra, API для Gremlin и API для таблиц, чтобы создать коллекцию.
Примечание.
При создании коллекций следите за тем, чтобы не создать две коллекции с одинаковыми именами, но в разных регистрах. Причина в том, что некоторые компоненты платформы Azure не учитывают регистр. Это может привести к путанице или конфликтам в данных телеметрии и действиях с коллекциями с такими именами.
Создание с помощью портала Azure
Войдите на портал Azure.
Создайте новую учетную запись Azure Cosmos DB или выберите существующую учетную запись.
Откройте панель Обозреватель данных и выберите Создать контейнер. После этого предоставьте следующие сведения.
- Укажите, создаете ли вы новую базу данных или используете существующую.
- Введите идентификатор контейнера.
- Введите ключ сегмента.
- Укажите подготавливаемую пропускную способность (например, 1000 ЕЗ/с).
- Нажмите ОК.
Создание с помощью пакета SDK для .NET
var bson = new BsonDocument
{
{ "customAction", "CreateCollection" },
{ "collection", "<CollectionName>" },//update CollectionName
{ "shardKey", "<ShardKeyName>" }, //update ShardKey
{ "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);
При возникновении исключения об истечении времени ожидания при создании коллекции выполните операцию чтения, чтобы проверить, была ли успешно создана коллекция. Операция чтения создает исключение до тех пор, пока операция создания коллекции не будет выполнена успешно. Список кодов состояния, поддерживаемых операцией создания, см. в статье Коды состояния HTTP для Azure Cosmos DB.
Создание с помощью Azure CLI
Создайте коллекцию для Azure Cosmos DB для API для MongoDB с помощью Azure CLI. Список всех примеров Azure CLI для всех программных интерфейсов Azure Cosmos DB см. в статье Примеры Azure CLI для Azure Cosmos DB.
Создание с помощью PowerShell
Создайте коллекцию для Azure Cosmos DB для API для MongoDB с помощью PowerShell. Список всех примеров PowerShell для всех программных интерфейсов Azure Cosmos DB см. в статье Примеры PowerShell.
Создание коллекции с помощью шаблонов Azure Resource Manager
Создайте коллекцию для Azure Cosmos DB для API для MongoDB с помощью шаблона Resource Manager.
Следующие шаги
- Секционирование в Azure Cosmos DB
- Единицы запросов в Azure Cosmos DB
- Обеспечение необходимой пропускной способности для контейнеров и баз данных
- Работа с учетной записью Azure Cosmos DB
- Если вы планируете ресурсы для миграции в Azure Cosmos DB, Для планирования ресурсов можно использовать сведения об имеющемся кластере базы данных.
- Если вам известно только количество виртуальных ядер и серверов в существующем кластере баз данных, прочитайте об оценке единиц запроса на основе этих данных.
- Если вам известна стандартная частота запросов для текущей рабочей нагрузки базы данных, ознакомьтесь со статьей о расчете единиц запросов с помощью планировщика ресурсов Azure Cosmos DB