Tworzenie bazy danych w usłudze Azure Cosmos DB for NoSQL przy użyciu języka JavaScript

DOTYCZY: NoSQL

Bazy danych w usłudze Azure Cosmos DB to jednostki zarządzania dla co najmniej jednego kontenera. Przed utworzeniem kontenerów lub zarządzaniem nimi należy najpierw utworzyć bazę danych.

Nazwij bazę danych

W usłudze Azure Cosmos DB baza danych jest analogiczna do przestrzeni nazw. Podczas tworzenia bazy danych nazwa bazy danych tworzy segment identyfikatora URI używanego do uzyskiwania dostępu do zasobu bazy danych i wszystkich zasobów podrzędnych.

Po utworzeniu identyfikator URI bazy danych ma następujący format:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>

Utwórz bazę danych

Po utworzeniu obiektu CosmosClient użyj klienta, aby utworzyć bazę danych na podstawie dwóch różnych wywołań:

• createIfNotExists — tworzy bazę danych, jeśli nie istnieje. Jeśli istnieje, zwróć bazę danych.
• create — tworzy bazę danych. Jeśli tak się stanie, zwróć stan błęduCode.

const databaseName = 'myDb';

// Possible results:
// Create then return database
// Return existing database
// Return error statusCode
const {statusCode, database } = await client.databases.createIfNotExists({ id: databaseName });

// Possible results: 
// Create then return database
// Return error statusCode, reason includes database already exists
const {statusCode, database } = await client.databases.create({ id: databaseName });

StatusCode to kod odpowiedzi HTTP. Pomyślna odpowiedź znajduje się w zakresie od 200 do 299.

Uzyskiwanie dostępu do bazy danych

Dostęp do bazy danych jest uzyskiwany z obiektu Database bezpośrednio lub za pośrednictwem wyniku zapytania z obiektu CosmosClient.

const databaseName = 'myDb';

// Direct - assumes database already exists
const { database, statusCode } = await client.database(databaseName);

// Query - assumes database already exists   
const { resources } = await client.databases
.query({
    query: `SELECT * FROM root r where r.id =@dbId`,
    parameters: [
    {
        name: '@dbId',
        value: databaseName
    }
    ]
})
.fetchAll();

Dostęp według obiektu:

• Bazy danych (liczba mnoga): służy do tworzenia nowych baz danych lub wykonywania zapytań/odczytywania wszystkich baz danych.
• Baza danych (pojedyncza): służy do odczytywania, aktualizowania lub usuwania istniejącej bazy danych według identyfikatora lub uzyskiwania dostępu do kontenerów należących do tej bazy danych.

Usuwanie bazy danych

Po pobraniu obiektu Database możesz użyć obiektu Database , aby usunąć bazę danych:

const {statusCode } = await database.delete();

StatusCode to kod odpowiedzi HTTP. Pomyślna odpowiedź znajduje się w zakresie od 200 do 299.

Następne kroki

Po utworzeniu bazy danych użyj następnego przewodnika, aby utworzyć kontenery.