在 Azure Cosmos DB for NoSQL 使用 JavaScript 建立資料庫

Azure Cosmos 資料庫中的資料庫是管理一個或多個容器的單位。 在你建立或管理容器之前，你必須先建立一個資料庫。

命名資料庫

在 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。

存取資料庫

資料庫可直接或透過 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();

依物件存取：

• 資料庫 （複數）：用於建立新資料庫，或查詢/讀取所有資料庫。
• 資料庫 （單數）：用於依 ID 讀取、更新或刪除現有資料庫，或存取屬於該資料庫的容器。

刪除資料庫

取得 資料庫 物件後，你可以用資料庫物件 刪除 該資料庫：

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

statusCode 是 HTTP 回應碼。 成功反應的比例約為200-299。

後續步驟

現在你已經建立了資料庫，請參考下一個指南來建立容器。