Veritabanı Oluşturma

  • Makale

İş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-throughputx-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 maxThroughputsahip bir JSON değeridir. Örneğin: {"maxThroughput": 4000}.

Veya'nın x-ms-offer-throughputx-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 maxThroughputiç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"}

Ayrıca Bkz.