Vytvoření databáze ve službě Azure Cosmos DB for NoSQL pomocí JavaScriptu

Článek
10/04/2024

PLATÍ PRO: NoSQL

Databáze ve službě Azure Cosmos DB jsou jednotky správy pro jeden nebo více kontejnerů. Než budete moct vytvářet nebo spravovat kontejnery, musíte nejprve vytvořit databázi.

Pojmenování databáze

Ve službě Azure Cosmos DB je databáze analogická k oboru názvů. Při vytváření databáze tvoří název databáze segment identifikátoru URI, který se používá pro přístup k databázovému prostředku a všem podřízeným prostředkům.

Po vytvoření je identifikátor URI databáze v tomto formátu:

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

Vytvořit databázi

Jakmile vytvoříte CosmosClient, pomocí klienta vytvořte databázi ze dvou různých volání:

createIfNotExists – Vytvoří databázi, pokud neexistuje. Pokud existuje, vraťte databázi.
create – vytvoří databázi. Pokud existuje, vraťte kód stavu chyby.

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 je kód odpovědi HTTP. Úspěšná odpověď je v rozsahu 200–299.

Přístup k databázi

K databázi se přistupuje z databázového objektu buď přímo, nebo prostřednictvím výsledku dotazu z 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();

Přístup podle objektu:

Databáze (množné číslo): Slouží k vytváření nových databází nebo dotazování/čtení všech databází.
Databáze (jednotné číslo): Používá se ke čtení, aktualizaci nebo odstraňování existující databáze pomocí ID nebo přístupu ke kontejnerům patřícím do této databáze.

Odstranění databáze

Jakmile získáte databázový objekt, můžete databázi odstranit pomocí databázového objektu:

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

StatusCode je kód odpovědi HTTP. Úspěšná odpověď je v rozsahu 200–299.

Další kroky

Teď, když jste vytvořili databázi, použijte další příručku k vytvoření kontejnerů.

Vytvoření kontejneru

Sdílet prostřednictvím