Dela via

Skapa databas

  • Artikel

Åtgärden Create Database skapar en ny databas i databaskontot.

Anteckning

Dessa API-referensartiklar visar hur du skapar resurser med hjälp av Azure Cosmos DB-dataplans-API:et. Med API:et för dataplanet kan du konfigurera grundläggande alternativ, till exempel indexeringsprincip, partitionsnycklar ungefär som du kan med Cosmos DB-SDK:er. Om du behöver fullständigt funktionsstöd för alla Azure Cosmos DB-resurser rekommenderar vi att du använder Cosmos DB-resursprovidern.

Förfrågan

Metod URI för förfrågan Description
POST https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} är namnet på det Azure Cosmos DB-konto som du skapade under din prenumeration.

Sidhuvuden

Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Azure Cosmos DB-begäranden.

Egenskap Krävs Typ Description
x-ms-offer-throughput Valfritt Tal Användaren angav manuellt dataflöde (RU/s) för databasen uttryckt i enheter med 100 enheter för programbegäran per sekund. Minimivärdet är 400 upp till 1 000 000 (eller högre genom att begära en gränsökning).

Endast en av x-ms-offer-throughput eller x-ms-cosmos-offer-autopilot-settings måste anges. Dessa rubriker kan inte anges tillsammans.
x-ms-cosmos-offer-autopilot-settings Valfritt JSON Användaren har angett maximalt antal RU/s för databasen för autoskalning. Värdet är en JSON med egenskapen maxThroughput. Exempel: {"maxThroughput": 4000}.

Endast en av x-ms-offer-throughput eller x-ms-cosmos-offer-autopilot-settings måste anges. Dessa rubriker kan inte anges tillsammans.

Anteckning

Om du anger dataflöde för en databas skapas en databas med delat dataflöde där alla samlingar i den delar det etablerade dataflödet. Det finns en gräns på 25 containrar i en databas med delat dataflöde. Om du inte planerar att använda en databas med delat dataflöde skapar du en databas utan att ange ovanstående dataflödesrubriker. Läs mer.

Brödtext

Egenskap Krävs Typ Description
id Obligatorisk Sträng Det användargenererade unika namnet för databasen. Det är en sträng som inte får innehålla fler än 255 tecken. 
{  
  "id": "volcanodb2"  
}

Svarsåtgärder

Sidhuvuden

Se Vanliga REST-svarshuvuden för Azure Cosmos DB för rubriker som returneras av alla Azure Cosmos DB-svar.

Statuskoder

I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.

HTTP-statuskod Beskrivning
201 Skapad Returneras när åtgärden lyckas.
400 Felaktig begäran Returneras när JSON-brödtexten är ogiltig. Sök efter saknade klammerparenteser eller citattecken.
409 – Konflikt Returneras när det ID som angetts för den nya databasen har tagits av en befintlig databas.

Brödtext

Egenskap Beskrivning
id Det användargenererade unika namnet för databasen.
_Bli Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Det används internt för placering av och navigering till databasresursen.
_Ts Det är en systemgenererad egenskap. Den anger den senast uppdaterade tidsstämpeln för resursen. Värdet är en tidsstämpel.
_Själv Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen.
_Etag Det är en systemgenererad egenskap som anger resursetaggen som krävs för optimistisk samtidighetskontroll.
_colls Det är en systemgenererad egenskap som anger den adresserbara sökvägen för samlingsresursen.
_Användare Det är en systemgenererad egenskap som anger den adresserbara sökvägen för användarresursen. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Exempel 1

I följande exempel skapas en databas.

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\/"  
}

Exempel 2

I följande exempel skapas en databas för delat dataflöde med ett manuellt dataflöde på 400 RU/s. x-ms-offer-throughput -huvudet används för att ange dataflödesvärdet (RU/s). Den accepterar ett tal med minst 400 som ökar med enheter på 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"}

Exempel 3

I följande exempel skapas en databas för delat dataflöde med maximalt dataflöde för autoskalning på 4 000 RU/s (skalar mellan 400 och 4 000 RU/s). x-ms-cosmos-offer-autopilot-settings -huvudet används för att ange maxThroughput, vilket är max-RU/s-värdet för autoskalning. Den accepterar ett tal med minst 4 000 som ökar med enheter på 1 000.

Anteckning

Om du vill aktivera autoskalning för en befintlig databas eller container, eller växla från autoskalning till manuellt dataflöde, kan du läsa artikeln Ersätt ett erbjudande.

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"}

Se även