JavaScript を使用して Azure Cosmos DB for NoSQL の使用を開始する

適用対象: NoSQL

この記事では、JavaScript SDK を使用して Azure Cosmos DB for NoSQL に接続する方法を示します。 接続すると、データベース、コンテナー、および項目に対する操作を実行できます。

パッケージ (npm) | サンプル | API リファレンス | ライブラリ ソース コード | フィードバックを送る

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
• Azure Cosmos DB for NoSQL アカウント。 NoSQL 用 API アカウントを作成します。
• Node.js LTS
• Azure コマンド ライン インターフェイス (CLI) または Azure PowerShell

ローカル プロジェクトを設定する

1. Bash シェルで JavaScript プロジェクトの新しいディレクトリを作成します。

   mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples
   

2. npm init コマンドとコンソール テンプレートを使用して、新しい JavaScript アプリケーションを作成します。

   npm init -y
   

3. Azure Cosmos DB for NoSQL JavaScript SDK に必要な依存関係をインストールします。

   npm install @azure/cosmos
   

Azure Cosmos DB for NoSQL に接続する

Azure Cosmos DB の NoSQL 用 API に接続するには、CosmosClient クラスのインスタンスを作成します。 このクラスは、データベースに対するすべての操作を実行するための開始点です。

Microsoft Entra を使用して NoSQL 用 API アカウントに接続するには、セキュリティ プリンシパルを使用します。 プリンシパルの正確な種類は、アプリケーション コードをホストする場所によって異なります。 次の表は、クイック リファレンス ガイドとして機能します。

@azure/identity をインポートする

@azure/identity npm パッケージには、すべての Azure SDK ライブラリ間で共有されるコア認証機能が含まれています。

1. npm install コマンドを使用して、@azure/identity npm パッケージをインポートします。

   npm install @azure/identity
   

2. コード エディターで、依存関係を追加します。

   const { DefaultAzureCredential } = require("@azure/identity");
   

既定の資格情報の実装を使用して CosmosClient を作成する

ローカル コンピューター上でテストする場合、またはマネージド ID を直接サポートする Azure サービス上でアプリケーションを実行する場合は、DefaultAzureCredential インスタンスを作成して OAuth トークンを取得します。 次に、COSMOS_ENDPOINT 環境変数と TokenCredential オブジェクトをパラメーターとして使用して、CosmosClient クラスの新しいインスタンスを作成します。

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

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

アプリケーションをビルドする

アプリケーションをビルドすると、コードは主に 4 種類のリソースと対話します。

• NoSQL 用 API アカウント。これは、Azure Cosmos DB データに対する一意で最上位の名前空間です。

• アカウント内のコンテナーを整理するデータベース。

• データベース内の個々の項目のセットを含むコンテナー。

• コンテナー内の JSON ドキュメントを表す項目。

次の図に、これらのリソースの関係を示します。

各種類のリソースは、1 つまたは複数の関連付けられたクラスによって表されます。 以下に最も一般的なクラスの一覧を示します。

次のガイドでは、これらの各クラスを使ってアプリケーションをビルドする方法を示します。

関連項目

• NPM パッケージ
• サンプル
• API リファレンス
• ライブラリ ソース コード
• フィードバックを送る

次のステップ