Skapa en databas i Azure Cosmos DB för NoSQL med JavaScript

Artikel
10/04/2024

GÄLLER FÖR: NoSQL

Databaser i Azure Cosmos DB är hanteringsenheter för en eller flera containrar. Innan du kan skapa eller hantera containrar måste du först skapa en databas.

Namnge en databas

I Azure Cosmos DB motsvarar en databas ett namnområde. När du skapar en databas utgör databasnamnet ett segment av den URI som används för att komma åt databasresursen och eventuella underordnade resurser.

När den har skapats är URI:n för en databas i det här formatet:

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

Skapa en -databas

När du har skapat CosmosClient använder du klienten för att skapa en databas från två olika anrop:

createIfNotExists – Skapar en databas om den inte finns. Om den finns returnerar du databasen.
create – Skapar en databas. Om den finns returnerar du felstatusKod.

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 är en HTTP-svarskod. Ett lyckat svar är inom intervallet 200–299.

Få åtkomst till en databas

En databas nås från databasobjektet antingen direkt eller via ett frågeresultat från 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();

Åtkomst efter objekt:

Databaser (plural): Används för att skapa nya databaser eller för att fråga/läsa alla databaser.
Databas (singular): Används för att läsa, uppdatera eller ta bort en befintlig databas med ID eller komma åt containrar som tillhör databasen.

Ta bort en databas

När du har hämtat databasobjektet kan du använda databasobjektet för att ta bort databasen:

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

StatusCode är en HTTP-svarskod. Ett lyckat svar är inom intervallet 200–299.

Nästa steg

Nu när du har skapat en databas använder du nästa guide för att skapa containrar.

Skapa en container

Dela via