Condividi tramite

Creare un database

L'operazione Create Database crea un nuovo database nell'account del database.

Annotazioni

Questi articoli di riferimento sulle API illustrano come creare risorse usando l'API del piano dati di Azure Cosmos DB. Con l'API del piano dati è possibile configurare opzioni di base, ad esempio criteri di indicizzazione e chiavi di partizione, in modo molto simile ai kit di sviluppo software (SDK) di Cosmos DB. Se è necessario il supporto completo delle funzionalità per tutte le risorse di Azure Cosmos DB, è consigliabile usare il provider di risorse di Cosmos DB.

Richiesta

Metodo URI della richiesta Descrizione
POST https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione.

Intestazioni

Vedere Intestazioni comuni delle richieste REST di Azure Cosmos DB per le intestazioni usate da tutte le richieste di Azure Cosmos DB.

Proprietà Obbligatorio TIPO Descrizione
x-ms-offerta-throughput Opzionale Numero Velocità effettiva manuale (UR/sec) specificata dall'utente per il database, espressa in unità di 100 unità richiesta al secondo. Il minimo è da 400 a 1.000.000 (o superiore richiedendo un aumento del limite).

È necessario specificare solo uno dei x-ms-offer-throughput o x-ms-cosmos-offer-autopilot-settings . Queste intestazioni non possono essere specificate insieme.
x-ms-cosmos-offerta-autopilota-impostazioni Opzionale JSON (JavaScript Object Notation) L'utente ha specificato il numero massimo di UR/sec di scalabilità automatica del database. Il valore è un JSON con la proprietà maxThroughput. Ad esempio: {"maxThroughput": 4000}.

È necessario specificare solo uno dei x-ms-offer-throughput o x-ms-cosmos-offer-autopilot-settings . Queste intestazioni non possono essere specificate insieme.

Annotazioni

Se si imposta la velocità effettiva in un database, viene creato un database con velocità effettiva condivisa in cui tutte le raccolte al suo interno condividono la velocità effettiva di cui è stato effettuato il provisioning. Esiste un limite di 25 contenitori in un database con velocità effettiva condivisa. Se non si prevede di utilizzare un database con velocità effettiva condivisa, creare un database senza impostare le intestazioni della velocità effettiva. Ulteriori informazioni.

Corpo

Proprietà Obbligatorio TIPO Descrizione
id Obbligatorio Stringa Nome univoco generato dall'utente per il database. Si tratta di una stringa che non deve superare i 255 caratteri. 
{  
  "id": "volcanodb2"  
}

Risposta

Intestazioni

Vedere Intestazioni di risposta REST comuni di Azure Cosmos DB per le intestazioni restituite da tutte le risposte di Azure Cosmos DB.

Codici di stato

Nella tabella seguente sono elencati i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.

Codice di stato HTTP Descrizione
201 Creato Restituito quando l'operazione ha esito positivo.
400 Richiesta non valida Restituito quando il corpo JSON non è valido. Controllare le parentesi graffe o le virgolette mancanti.
409 - Conflitto Restituito quando l'ID fornito per il nuovo database è stato utilizzato da un database esistente.

Corpo

Proprietà Descrizione
ID Nome univoco generato dall'utente per il database.
_liberarsi Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorse. Viene utilizzato internamente per il posizionamento e la navigazione nella risorsa del database.
_Ts Si tratta di una proprietà generata dal sistema. Specifica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp.
_stesso Si tratta di una proprietà generata dal sistema. È l'URI indirizzabile univoco per la risorsa.
_etag Si tratta di una proprietà generata dal sistema che specifica l'etag della risorsa necessario per il controllo della concorrenza ottimistica.
_colls Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa di raccolta.
_Gli utenti Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa utente. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

Esempio 1

Nell'esempio seguente viene creato un 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\/"  
}

Esempio 2

Nell'esempio seguente viene creato un database con velocità effettiva condivisa con velocità effettiva manuale di 400 UR/s. x-ms-offer-throughput header viene usato per impostare il valore della velocità effettiva (UR/s). Accetta un numero con un minimo di 400 che incrementa di unità di 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"}

Esempio 3

Nell'esempio seguente viene creato un database con velocità effettiva condivisa con scalabilità automatica di 4000 UR/s (scalabilità compresa tra 400 e 4000 UR/s). x-ms-cosmos-offer-autopilot-settings viene usata per impostare , maxThroughputovvero il valore massimo di UR/s della scalabilità automatica. Accetta un numero con un minimo di 4000 che incrementa di unità di 1000.

Annotazioni

Per abilitare la scalabilità automatica in un database o in un contenitore esistente o passare dalla scalabilità automatica alla velocità effettiva manuale, vedere l'articolo Sostituire un'offerta.

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

Vedere anche

  • Last updated on