Veritabanı Oluşturma
İşlem, Create Database
veritabanı hesabında yeni bir veritabanı oluşturur.
Not
Bu API başvuru makalelerinde Azure Cosmos DB veri düzlemi API'sini kullanarak kaynak oluşturma adımları gösterilmektedir. Veri düzlemi API'siyle dizin oluşturma ilkesi, bölüm anahtarları gibi temel seçenekleri Cosmos DB SDK'ları ile yapılandırabilirsiniz. Tüm Azure Cosmos DB kaynakları için tam özellik desteğine ihtiyacınız varsa Cosmos DB Kaynak Sağlayıcısı'nı kullanmanızı öneririz.
İstek
Yöntem | İstek URI'si | Description |
---|---|---|
POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount}, aboneliğiniz altında oluşturduğunuz Azure Cosmos DB hesabının adıdır. |
Üst Bilgiler
Tüm Azure Cosmos DB istekleri tarafından kullanılan üst bilgiler için bkz. Yaygın Azure Cosmos DB REST istek üst bilgileri.
Özellik | Gerekli | Tür | Description |
---|---|---|---|
x-ms-offer-throughput | İsteğe Bağlı | Sayı | Kullanıcı, veritabanı için el ile aktarım hızını (RU/sn) saniyede 100 istek birimi cinsinden ifade etti. En az 400 en fazla 1.000.000 'dir (veya sınır artışı isteyerek daha yüksektir). Veya'nın x-ms-offer-throughput x-ms-cosmos-offer-autopilot-settings yalnızca biri belirtilmelidir. Bu üst bilgiler birlikte belirtilemez. |
x-ms-cosmos-offer-autopilot-settings | İsteğe Bağlı | JSON | Kullanıcı, veritabanının en yüksek RU/sn değerini otomatik ölçeklendirmeyi belirtti. değeri özelliğine maxThroughput sahip bir JSON değeridir. Örneğin: {"maxThroughput": 4000} .Veya'nın x-ms-offer-throughput x-ms-cosmos-offer-autopilot-settings yalnızca biri belirtilmelidir. Bu üst bilgiler birlikte belirtilemez. |
Not
Bir veritabanında aktarım hızı ayarlarsanız bu, içindeki tüm koleksiyonların sağlanan aktarım hızını paylaştığı paylaşılan bir aktarım hızı veritabanı oluşturur. Paylaşılan aktarım hızı veritabanında 25 kapsayıcı sınırı vardır. Paylaşılan aktarım hızı veritabanı kullanmayı planlamıyorsanız, yukarıdaki aktarım hızı üst bilgilerini ayarlamadan bir veritabanı oluşturun. Daha fazla bilgi edinin.
Gövde
Özellik | Gerekli | Tür | Description |
---|---|---|---|
kimlik | Gerekli | Dize | Veritabanı için kullanıcı tarafından oluşturulan benzersiz ad. 255 karakterden uzun olmaması gereken bir dizedir. |
{
"id": "volcanodb2"
}
Yanıt
Üst Bilgiler
Tüm Azure Cosmos DB yanıtları tarafından döndürülen üst bilgiler için bkz. Yaygın Azure Cosmos DB REST yanıt üst bilgileri.
Durum kodları
Aşağıdaki tabloda bu işlem tarafından döndürülen genel durum kodları listelenmektedir. Durum kodlarının tam listesi için bkz. HTTP Durum Kodları.
HTTP durum kodu | Açıklama |
---|---|
201 Oluşturuldu | İşlem başarılı olduğunda döndürülür. |
400 Hatalı İstek | JSON gövdesi geçersiz olduğunda döndürülür. Eksik küme ayraçlarını veya tırnakları denetleyin. |
409 Çakışma | Yeni veritabanı için sağlanan kimlik mevcut bir veritabanı tarafından alındığında döndürülür. |
Gövde
Özellik | Açıklama |
---|---|
id | Veritabanı için kullanıcı tarafından oluşturulan benzersiz ad. |
_Kurtulmak | Sistem tarafından oluşturulan bir özelliktir. Kaynak kimliği (_rid), kaynak modelinde kaynak yığını başına da hiyerarşik olan benzersiz bir tanımlayıcıdır. Veritabanı kaynağının yerleşimi ve veritabanı kaynağında gezinme için dahili olarak kullanılır. |
_Ts | Sistem tarafından oluşturulan bir özelliktir. Kaynağın son güncelleştirilen zaman damgasını belirtir. Değer bir zaman damgasıdır. |
_Kendini | Sistem tarafından oluşturulan bir özelliktir. Kaynak için benzersiz adreslenebilir URI'dir. |
_Etag | İyimser eşzamanlılık denetimi için gereken kaynak etiketini belirten sistem tarafından oluşturulan bir özelliktir. |
_colls | Koleksiyon kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan bir özelliktir. |
_Kullanıcı | Kullanıcı kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan bir özelliktir. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Örnek 1
Aşağıdaki örnek bir veritabanı oluşturur.
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\/"
}
Örnek 2
Aşağıdaki örnek, el ile 400 RU/sn aktarım hızına sahip bir paylaşılan aktarım hızı veritabanı oluşturur.
x-ms-offer-throughput
header, aktarım hızı (RU/sn) değerini ayarlamak için kullanılır. En az 400 olan ve 100'lü birimlere göre artan bir sayı kabul eder.
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"}
Örnek 3
Aşağıdaki örnek, 4000 RU/sn (400 - 4000 RU/sn arasında ölçeklendirilir) maksimum aktarım hızına sahip bir paylaşılan aktarım hızı veritabanı oluşturur.
x-ms-cosmos-offer-autopilot-settings
üst bilgisi, otomatik ölçeklendirme maksimum RU/sn değeri olan değerini ayarlamak maxThroughput
için kullanılır. En az 4000 olan ve 1000 birimlik bir sayı kabul eder.
Not
Mevcut bir veritabanı veya kapsayıcıda otomatik ölçeklendirmeyi etkinleştirmek veya otomatik ölçeklendirmeden el ile aktarım hızına geçmek için Teklifi Değiştirme makalesine bakın.
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"}