共用方式為

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

  • 發行項

適用於：NoSQL

Azure Cosmos DB 中的資料庫是一或多個容器的管理單位。 您必須先建立資料庫，才能建立或管理容器。

命名資料庫

在 Azure Cosmos DB 中，資料庫類似於命名空間。 當您建立資料庫時，資料庫名稱會成為存取資料庫資源和任何子資源的 URI 區段。

以下是命名資料庫時的一些快速規則：

  • 資料庫名稱長度應為 3 到 63 個字元
  • 資料庫名稱只能包含小寫字母、數字或虛線 (-) 字元。
  • 資料庫名稱必須以小寫字母或數字開頭。

建立之後，資料庫的 URI 格式如下：

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

建立資料庫

在您建立 CosmosClient 之後，請使用用戶端以從兩個不同的呼叫建立 Database：

  • createIfNotExists - 如果資料庫不存在，則建立資料庫。 如果確實存在，則傳回資料庫。
  • create - 建立資料庫。 如果確實存在，則傳回錯誤 statusCode。
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();

透過物件存取：

  • Databases (複數)：用於建立新的資料庫，或查詢/讀取所有資料庫。
  • Database (單數)：用於依識別碼來讀取、更新或刪除現有資料庫，或存取屬於該資料庫的容器。

刪除資料庫

在您取得 Database 物件之後，可以使用 Database 物件來刪除資料庫：

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

statusCode 是 HTTP 回應碼。 成功的回應是在 200-299 範圍內。

下一步

現在您已建立了資料庫，請使用下一個指南來建立容器。

建立容器