# Azure Cosmos DBでNode.jsから接続・操作するサンプルコード

## 1-1. 目次

1. はじめに

2. Azure Cosmos DBとは？

3. 前提条件

4. 環境設定

    1. Azure Cosmos DBアカウントの作成

    2. Node.jsプロジェクトのセットアップ

5. Azure Cosmos DB SDKのインストール

6. Node.jsによるAzure Cosmos DBへの接続

7. データベースとコンテナの作成

8. データの挿入

9. データのクエリ

10. データの更新

11. データの削除

12. まとめ

## 1-2. はじめに

Azure Cosmos DBは、グローバルに分散されたマルチモデルデータベースサービスで、多様なデータモデルをサポートします。今回は、Node.jsを使ってAzure Cosmos DBに接続し、データを管理する方法を具体的なコード例を交えて説明します。

## 1-3. Azure Cosmos DBとは？

Azure Cosmos DBは、マイクロソフトのクラウドプラットフォーム上で提供されるNoSQLデータベースです。以下のような特長があります。

- グローバルに分散

- マルチモデルのサポート

- スケーラブルなパフォーマンス

- 高い可用性

## 1-4. 前提条件

Azure Cosmos DBへ接続するためには以下が必要です。

- Azureアカウント

- Node.jsとnpmがインストールされた環境

## 1-5. 環境設定

### 1-5-1. Azure Cosmos DBアカウントの作成

1. Azureポータルにサインインし、「Azure Cosmos DB」を検索します。

2. 新しいアカウントを作成し、適切なリージョンと設定を選択します。

### 1-5-2. Node.jsプロジェクトのセットアップ

```bash

mkdir my-cosmos-app

cd my-cosmos-app

npm init -y

```

## 1-6. Azure Cosmos DB SDKのインストール

Node.jsからAzure Cosmos DBに接続するためには、`@azure/cosmos` npmパッケージを使用します。

```bash

npm install @azure/cosmos

```

## 1-7. Node.jsによるAzure Cosmos DBへの接続

以下に、Node.jsでAzure Cosmos DBに接続するサンプルコードを示します。

```javascript

const { CosmosClient } = require("@azure/cosmos");

const endpoint = "https://your-cosmos-db-account.documents.azure.com:443/";

const key = "your-cosmos-db-key"; // セキュリティ確保のため、本番環境ではKey Vault等を使用

const client = new CosmosClient({ endpoint, key });

(async () => {

  try {

    const { database } = await client.databases.createIfNotExists({ id: "YourDatabase" });

    console.log(`Database created: ${database.id}`);

  } catch (error) {

    console.error(error);

  }

})();

```

## 1-8. データベースとコンテナの作成

データベースとコンテナ（コレクション）は以下のコードで作成します。

```javascript

(async () => {

  const { database } = await client.databases.createIfNotExists({ id: "YourDatabase" });

  const { container } = await client.database(database.id).containers.createIfNotExists({ id: "YourContainer" });

  console.log(`Container created: ${container.id}`);

})();

```

## 1-9. データの挿入

Azure Cosmos DBにデータを挿入する方法は以下のとおりです。

```javascript

(async () => {

  const item = { id: "1", name: "John Doe", city: "New York" };

  const { resource: createdItem } = await client.database("YourDatabase").container("YourContainer").items.create(item);

  console.log(`Item created: ${createdItem.id}`);

})();

```

## 1-10. データのクエリ

特定の条件でデータをクエリするには、`SQL query`を使用します。

```javascript

(async () => {

  const querySpec = {

    query: "SELECT * FROM c WHERE c.city = @city",

    parameters: [

      { name: "@city", value: "New York" }

    ]

  };

  

  const { resources: items } = await client.database("YourDatabase").container("YourContainer").items.query(querySpec).fetchAll();

  items.forEach(item => console.log(`Fetched item: ${item.name}`));

})();

```

## 1-11. データの更新

Azure Cosmos DB上のデータを更新するには、まずアイテムを取得してから変更を加えます。

```javascript

(async () => {

  const { resource: item } = await client.database("YourDatabase").container("YourContainer").item("1").read();

  item.city = "Los Angeles";

  const { resource: updatedItem } = await client.database("YourDatabase").container("YourContainer").item(item.id).replace(item);

  console.log(`Item updated: ${updatedItem.city}`);

})();

```

## 1-12. データの削除

データの削除は、項目IDを指定して行います。

```javascript

(async () => {

  await client.database("YourDatabase").container("YourContainer").item("1").delete();

  console.log("Item deleted");

})();

```

## 1-13. まとめ

この記事では、Node.jsを用いたAzure Cosmos DBへの接続方法とデータ操作について具体的に解説しました。Azure Cosmos DBは、スケーラブルで高度に分散したNoSQLサービスで、グローバル展開やスケーリングが必要なアプリケーションに非常に適しています。この記事を基に、自分自身のアプリケーションを拡張したり、より複雑なデータ操作を試みたりしてみてください。

これにより、Azureプロジェクトでの操作がよりシームレスに行えるようになります。

Azure Cosmos DBでNode.jsから接続・操作するサンプルコード

1-1. 目次

続きを読むには単価診断を受けてください（30秒）