Создание базы данных в Azure Cosmos DB для NoSQL с помощью JavaScript

Статья
10/04/2024

ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL

Базы данных в Azure Cosmos DB — это единицы управления для одного или нескольких контейнеров. Прежде чем создавать контейнеры или управлять ими, необходимо сначала создать базу данных.

Имя базы данных

В Azure Cosmos DB база данных аналогична пространству имен. При создании базы данных ее имя формирует сегмент URI, используемого для доступа к ресурсу базы данных и любым дочерним ресурсам.

После создания URI базы данных имеет следующий формат:

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

Создание базы данных

После создания CosmosClient используйте клиент для создания базы данных из двух разных вызовов:

createIfNotExists — создает базу данных, если она не существует. Если она существует, верните базу данных.
create — создает базу данных. Если он существует, верните код состояния ошибки.

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 — это код ответа HTTP. Успешный ответ находится в диапазоне от 200 до 299.

Доступ к базе данных

Доступ к базе данных осуществляется из объекта Database напрямую или через результат запроса из 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();

Доступ по объекту:

Базы данных (множественное число): используется для создания новых баз данных или запроса и чтения всех баз данных.
База данных (сингулярная): используется для чтения, обновления или удаления существующей базы данных по идентификатору или доступу к контейнерам, принадлежащим этой базе данных.

Удаление базы данных

После получения объекта Database можно использовать объект Database для удаления базы данных:

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

StatusCode — это код ответа HTTP. Успешный ответ находится в диапазоне от 200 до 299.

Следующие шаги

Теперь, когда вы создали базу данных, воспользуйтесь следующим руководством по созданию контейнеров.

Создание контейнера

Поделиться через