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

Создание базы данных

  • Статья

Операция Create Database создает новую базу данных в учетной записи базы данных.

Примечание

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

Запрос

Метод Универсальный код ресурса (URI) запроса Описание
POST https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в рамках подписки.

Заголовки

Заголовки, используемые всеми запросами Azure Cosmos DB, см. в статье Общие заголовки запросов REST Azure Cosmos DB .

Свойство Обязательно Тип Описание
Пропускная способность x-ms-offer-throughput Необязательно Число Пользователь указал пропускную способность вручную (ЕЗ/с) для базы данных, выраженную в единицах 100 единиц запросов в секунду. Минимальное значение — от 400 до 1 000 000 (или выше при запросе увеличения лимита).

Необходимо указать только один из x-ms-offer-throughput или x-ms-cosmos-offer-autopilot-settings . Эти заголовки нельзя указать вместе.
x-ms-cosmos-offer-autopilot-settings Необязательно JSON Пользователь указал максимальное значение ЕЗ/с автомасштабирования базы данных. Значением является JSON со свойством maxThroughput. Например: {"maxThroughput": 4000}.

Необходимо указать только один из x-ms-offer-throughput или x-ms-cosmos-offer-autopilot-settings . Эти заголовки нельзя указать вместе.

Примечание

Если вы задали пропускную способность для базы данных, создается база данных с общей пропускной способностью , в которой все коллекции в ней совместно используют подготовленную пропускную способность. В базе данных с общей пропускной способностью существует ограничение в 25 контейнеров. Если вы не планируете использовать базу данных с общей пропускной способностью, создайте базу данных, не задавая указанные выше заголовки пропускной способности. Подробнее.

Текст

Свойство Обязательно Тип Описание
идентификатор Обязательно Строка Созданное пользователем уникальное имя базы данных. Это строка, которая не должна содержать более 255 символов. 
{  
  "id": "volcanodb2"  
}

Ответ

Заголовки

Заголовки, возвращаемые всеми ответами Azure Cosmos DB, см. в статье Общие заголовки ответов REST Azure Cosmos DB .

Коды состояния

В таблице ниже указаны стандартные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.

Код состояния HTTP Описание
201 Создано Возвращается, если операция выполнена успешно.
400 — недопустимый запрос Возвращается, если текст JSON является недопустимым. Проверьте наличие фигурных скобок и кавычек.
409. Конфликт Возвращается, когда идентификатор, предоставленный для новой базы данных, был взят существующей базой данных.

Текст

Свойство Описание
идентификатор Созданное пользователем уникальное имя базы данных.
_rid Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения и перемещения к ресурсу базы данных.
_Ts Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени.
_Самостоятельно Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса.
_etag Это созданное системой свойство, указывающее тег ресурса, необходимый для управления оптимистическим параллелизмом.
_colls Это созданное системой свойство, указывающее адресуемый путь к ресурсу коллекций.
_Пользователей Это созданное системой свойство, указывающее адресуемый путь к ресурсу users. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Пример 1

В следующем примере создается база данных.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms.date: 04/20/2021
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}  
  

HTTP/1.1 201 Created  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:35.212 GMT  
etag: "00000a00-0000-0000-0000-56672f920000"  
x-ms-resource-quota: databases=100;  
x-ms-resource-usage: databases=15;  
x-ms-schemaversion: 1.1  
x-ms-quorum-acked-lsn: 859  
x-ms-session-token: 860  
x-ms-current-write-quorum: 3  
x-ms-current-replica-set-size: 4  
x-ms-request-charge: 4.95  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: f171e571-994e-4dc2-b443-7c3d5fa4a293  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:29:21 GMT  
Content-Length: 169  
  
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Пример 2

В следующем примере создается база данных с общей пропускной способностью с пропускной способностью 400 ЕЗ/с вручную. x-ms-offer-throughput Заголовок используется для задания значения пропускной способности (ЕЗ/с). Он принимает число не менее 400, которое увеличивается на единицы 100.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:29:22 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
x-ms-offer-throughput = 400
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}

Пример 3

В следующем примере создается база данных с общей пропускной способностью с автомасштабированием максимальной пропускной способности 4000 ЕЗ/с (масштабирование от 400 до 4000 ЕЗ/с). x-ms-cosmos-offer-autopilot-settings Заголовок используется для задания maxThroughputзначения , который является максимальным значением автомасштабирования ЕЗ/с. Он принимает число не менее 4000, которое увеличивается на единицы 1000.

Примечание

Чтобы включить автомасштабирование для существующей базы данных или контейнера или переключиться с автомасштабирования на пропускную способность вручную, см. статью Замена предложения.

POST https://contosomarketing.documents.azure.com:443/dbs HTTP/1.1 
x-ms-version: 2018-12-31
x-ms-date: Wed, 22 Jul 2020 20:09:50 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d 
Accept: application/json
x-ms-cosmos-offer-autopilot-settings: {"maxThroughput": 4000}
Content-Type: application/json
User-Agent: contoso/1.0
Postman-Token: 81c0a4ac-4b7c-4f98-8d46-8c662969bc7e
Host: contosomarketing.documents.azure.com:443
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 27

{"id":"volcanodb3"}

См. также: