Bagikan melalui

Buat Database

Operasi ini Create Database membuat database baru di akun database.

Nota

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

Permohonan

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

Headers

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

Harta benda Diperlukan Tipe Deskripsi
throughput penawaran x-ms Fakultatif Angka Pengguna menentukan throughput manual (RU/s) untuk database dinyatakan dalam satuan 100 unit permintaan per detik. Minimumnya adalah 400 hingga 1.000.000 (atau lebih tinggi dengan meminta kenaikan batas).

Hanya 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-menawarkan-pengaturan-autopilot Fakultatif JSON Pengguna menentukan skala otomatis RU/s maksimum database. Nilainya adalah JSON dengan properti maxThroughput. Misalnya: {"maxThroughput": 4000}.

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

Nota

Jika Anda mengatur throughput pada database, ini akan 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 untuk menggunakan database throughput bersama, buat database tanpa mengatur header throughput. Pelajari selengkapnya.

Tubuh

Harta benda Diperlukan Tipe Deskripsi
id Diperlukan string Nama unik yang dibuat pengguna untuk database. Ini adalah string yang tidak boleh lebih dari 255 karakter. 
{  
  "id": "volcanodb2"  
}

Jawaban

Headers

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 saat operasi berhasil.
400 Permintaan Tidak Valid Dikembalikan saat 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 ada.

Tubuh

Harta benda Deskripsi
id Nama unik yang dibuat pengguna untuk database.
_Membersihkan 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.
_diri 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 dialamatkan.
_Pengguna Ini adalah properti yang dihasilkan sistem yang menentukan jalur sumber daya pengguna yang dapat dialamatkan. 
{  
    "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/s. x-ms-offer-throughput digunakan untuk mengatur nilai throughput (RU/s). Ini menerima angka dengan minimum 400 yang bertambah dengan satuan 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 maksimum skala otomatis 4000 RU/s (menskalakan antara 400 - 4000 RU/s). x-ms-cosmos-offer-autopilot-settings digunakan untuk mengatur maxThroughput, yang merupakan nilai RU/s maks skala otomatis. Ini menerima angka dengan minimum 4000 yang bertambah dengan satuan 1000.

Nota

Untuk mengaktifkan skala otomatis pada database atau kontainer yang 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

  • Last updated on