Een database maken in Azure Cosmos DB for NoSQL met behulp van JavaScript

Artikel
10/04/2024

VAN TOEPASSING OP: NoSQL

Databases in Azure Cosmos DB zijn beheereenheden voor een of meer containers. Voordat u containers kunt maken of beheren, moet u eerst een database maken.

Een database een naam opgeven

In Azure Cosmos DB is een database vergelijkbaar met een naamruimte. Wanneer u een database maakt, vormt de databasenaam een segment van de URI die wordt gebruikt voor toegang tot de databaseresource en eventuele onderliggende resources.

Zodra de URI voor een database is gemaakt, heeft deze indeling:

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

Een -database maken

Zodra u CosmosClient hebt gemaakt, gebruikt u de client om een database te maken op basis van twee verschillende aanroepen:

createIfNotExists - Hiermee maakt u een database als deze niet bestaat. Als deze bestaat, retourneert u de database.
maken - Hiermee maakt u een database. Als deze bestaat, retourneert u de foutstatusCode.

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 });

De statusCode is een HTTP-antwoordcode. Een geslaagd antwoord valt binnen het bereik van 200-299.

Een database openen

Een database wordt rechtstreeks vanuit het databaseobject geopend of via een queryresultaat van 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();

Toegang per object:

Databases (meervoud): wordt gebruikt voor het maken van nieuwe databases of het opvragen/lezen van alle databases.
Database (singular): Wordt gebruikt voor het lezen, bijwerken of verwijderen van een bestaande database door id of toegang tot containers die tot die database behoren.

Een database verwijderen

Zodra u het databaseobject hebt opgehaald, kunt u het databaseobject gebruiken om de database te verwijderen :

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

De statusCode is een HTTP-antwoordcode. Een geslaagd antwoord valt binnen het bereik van 200-299.

Volgende stappen

Nu u een database hebt gemaakt, gebruikt u de volgende handleiding om containers te maken.

Een container maken

Delen via