Dela via

Skapa databas

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

Anmärkning

De här API-referensartiklarna visar hur du skapar resurser med hjälp av Azure Cosmos DB-API:et för dataplanet. Med API:et för dataplanet kan du konfigurera grundläggande alternativ som indexeringsprincip, partitionsnycklar på samma sätt som du kan med Cosmos DB SDK:er (Software Development Kits). Om du behöver fullständigt funktionsstöd för alla Azure Cosmos DB-resurser rekommenderar vi att du använder Cosmos DB-resursprovidern.

Begäran

Metod Begäran om URI Beskrivning
Posten https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} är namnet på det Azure Cosmos DB-konto som du skapade under din prenumeration.

Rubriker

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

Fastighet Krävs Typ Beskrivning
x-ms-erbjudande-dataflöde Valfritt Nummer Användaren har angett manuellt dataflöde (RU/s) för databasen uttryckt i enheter om 100 enheter för programbegäran per sekund. Minimum ä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. Det går inte att ange dessa rubriker tillsammans.
x-ms-cosmos-offer-autopilot-settings x-ms-cosmos-offer-autopilot-settings Valfritt JSON Användaren har angett maximalt antal RU:er för autoskalning för databasen. Värdet är en JSON med egenskapen maxThroughput. Till exempel: {"maxThroughput": 4000}.

Endast en av x-ms-offer-throughput eller x-ms-cosmos-offer-autopilot-settings måste anges. Det går inte att ange dessa rubriker tillsammans.

Anmärkning

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 dataflödeshuvudena. Läs mer.

Kropp

Fastighet Krävs Typ Beskrivning
Id-nummer Krävs Sträng Det användargenererade unika namnet för databasen. Det är en sträng som inte får vara längre än 255 tecken. 
{  
  "id": "volcanodb2"  
}

Svar

Rubriker

Se vanliga Azure Cosmos DB REST-svarshuvuden 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 Skapat Returneras när åtgärden lyckas.
400 Felaktig begäran Returneras när JSON-brödtexten är ogiltig. Kontrollera om det saknas klammerparenteser eller citattecken.
409 – Konflikt Returneras när det ID som angetts för den nya databasen har tagits av en befintlig databas.

Kropp

Fastighet Beskrivning
ID Det användargenererade unika namnet för databasen.
_rid Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Den används internt för placering av och navigering till databasresursen.
_ts Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. 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 den resurs-etag 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 till 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 med delat dataflöde med ett manuellt dataflöde på 400 RU/s. x-ms-offer-throughput används för att ange värdet för dataflöde (RU/s). Den accepterar ett tal med minst 400 som ökar med enheter om 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 med delat dataflöde med maximalt dataflöde för autoskalning på 4000 RU/s (skalar mellan 400 och 4000 RU/s). x-ms-cosmos-offer-autopilot-settings Header används för att ange , vilket är det maximala RU/s-värdet för maxThroughputautoskalning. Den accepterar ett tal med minst 4000 som ökar med enheter på 1000.

Anmärkning

Om du vill aktivera autoskalning på en befintlig databas eller container, eller växla från autoskalning till manuellt dataflöde, kan du läsa artikeln Ersätta 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