Buat Database

  • Artikel

Operasi membuat Create Database database baru di akun database.

Catatan

Artikel referensi API ini menunjukkan cara membuat sumber daya menggunakan API sarana data Azure Cosmos DB. Dengan API sarana data, Anda dapat mengonfigurasi opsi dasar seperti kebijakan pengindeksan, kunci partisi seperti yang Anda bisa dengan Cosmos DB SDK. Jika Anda memerlukan dukungan fitur lengkap untuk semua sumber daya Azure Cosmos DB, sebaiknya gunakan Penyedia Sumber Daya Cosmos DB.

Minta

Metode Meminta URI Deskripsi
POSTING https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} adalah nama akun Azure Cosmos DB yang Anda buat di bawah langganan Anda.

Header

Lihat Header permintaan Rest Azure Cosmos DB umum untuk header yang digunakan oleh semua permintaan Azure Cosmos DB.

Properti Diperlukan Jenis Deskripsi
x-ms-offer-throughput Opsional Telepon Throughput manual yang ditentukan pengguna (RU/s) untuk database yang dinyatakan dalam unit 100 unit permintaan per detik. Minimumnya adalah 400 hingga 1.000.000 (atau lebih tinggi dengan meminta kenaikan batas).

Hanya salah satu dari x-ms-offer-throughput atau x-ms-cosmos-offer-autopilot-settings yang harus ditentukan. Header ini tidak dapat ditentukan bersama-sama.
x-ms-cosmos-offer-autopilot-settings Opsional JSON Pengguna menentukan RU/dtk maksimum skala otomatis database. Nilainya adalah JSON dengan properti maxThroughput. Misalnya: {"maxThroughput": 4000}.

Hanya salah satu dari x-ms-offer-throughput atau x-ms-cosmos-offer-autopilot-settings yang harus ditentukan. Header ini tidak dapat ditentukan bersama-sama.

Catatan

Jika Anda mengatur throughput pada database, ini membuat database throughput bersama di mana semua koleksi di dalamnya berbagi throughput yang disediakan. Ada batas 25 kontainer dalam database throughput bersama. Jika Anda tidak berencana menggunakan database throughput bersama, buat database tanpa mengatur header throughput di atas. Pelajari lebih lanjut.

Isi

Properti Diperlukan Jenis Deskripsi
id Diperlukan String Nama unik yang dihasilkan pengguna untuk database. Ini adalah string yang tidak boleh lebih dari 255 karakter. 
{  
  "id": "volcanodb2"  
}

Respons

Header

Lihat Header respons Rest Azure Cosmos DB umum untuk header yang dikembalikan oleh semua respons Azure Cosmos DB.

Kode status

Tabel berikut mencantumkan kode status umum yang dikembalikan oleh operasi ini. Untuk daftar lengkap kode status, lihat Kode Status HTTP.

Kode status HTTP Deskripsi
201 Dibuat Dikembalikan ketika operasi berhasil.
400 Permintaan Buruk Dikembalikan ketika isi JSON tidak valid. Periksa tanda kurung keriting atau tanda kutipan yang hilang.
409 Konflik Dikembalikan ketika ID yang disediakan untuk database baru telah diambil oleh database yang sudah ada.

Isi

Properti Deskripsi
id Nama unik yang dihasilkan pengguna untuk database.
_rid Ini adalah properti yang dihasilkan sistem. ID sumber daya (_rid) adalah pengidentifikasi unik yang juga hierarkis per tumpukan sumber daya pada model sumber daya. Ini digunakan secara internal untuk penempatan dan navigasi ke sumber daya database.
_Ts Ini adalah properti yang dihasilkan sistem. Ini menentukan tanda waktu terakhir yang diperbarui dari sumber daya. Nilainya adalah tanda waktu.
_self Ini adalah properti yang dihasilkan sistem. Ini adalah URI unik yang dapat diatasi untuk sumber daya.
_etag Ini adalah properti yang dihasilkan sistem yang menentukan etag sumber daya yang diperlukan untuk kontrol konkurensi optimis.
_colls Ini adalah properti yang dihasilkan sistem yang menentukan jalur sumber daya koleksi yang dapat diatasi.
_Pengguna Ini adalah properti yang dihasilkan sistem yang menentukan jalur sumber daya pengguna yang dapat diatasi. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Contoh 1

Contoh berikut membuat database.

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

Contoh 2

Contoh berikut membuat database throughput bersama dengan throughput manual 400 RU/dtk. x-ms-offer-throughput header digunakan untuk mengatur nilai throughput (RU/s). Ini menerima angka dengan minimum 400 yang bertambah berdasarkan unit 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"}

Contoh: 3

Contoh berikut membuat database throughput bersama dengan throughput maks skala otomatis 4000 RU/dtk (skala antara 400 - 4000 RU/dtk). x-ms-cosmos-offer-autopilot-settings header digunakan untuk mengatur maxThroughput, yang merupakan nilai RU/s maks skala otomatis. Ini menerima angka dengan minimum 4000 yang bertambah berdasarkan unit 1000.

Catatan

Untuk mengaktifkan skala otomatis pada database atau kontainer yang sudah ada, atau beralih dari skala otomatis ke throughput manual, lihat artikel Mengganti Penawaran.

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

Lihat juga