クイック スタート: Azure portal を使用して Azure DocumentDB クラスターを作成する

このクイック スタートでは、新しい Azure DocumentDB クラスターを作成します。 このクラスターには、データベース、コレクション、ドキュメントなど、一般的な MongoDB リソースがすべて含まれています。 クラスターは、さまざまなツールとドライバーが Azure DocumentDB に接続し、日常的な操作を実行するための固有のエンドポイントを提供します。

Prerequisites

• Azure サブスクリプション

  • Azure サブスクリプションがない場合は、無料アカウントを作成してください。

クラスターの作成

最初に、NoSQL データを格納および管理するための基盤として機能する Azure DocumentDB クラスターを作成する必要があります。

1. Azure portal にサインインします (https://portal.azure.com)。

2. Azure ポータル メニューまたは Home ページで、リソースの作成を選択します。

3. New ページで、Azure DocumentDB を検索して選択します。

   

4. [Azure DocumentDB クラスターの作成] ページと [基本] セクションで、[クラスター層] セクションで [構成] オプションを選択します。

   

5. [ スケール ] ページで、これらのオプションを構成し、[ 保存] を選択して変更をクラスター層に保持します。

   	Value
   クラスター レベル	M30 tier, 2 vCore, 8-GiB RAM
   シャードあたりのストレージ	128 GiB

   

6. [基本] セクションに戻り、次のオプションを構成します。

   	Value
   サブスクリプション	お使いの "Azure サブスクリプション" を選択します
   リソース グループ	新しいリソース グループを作成するか、既存のリソース グループを選択
   クラスター名	グローバルに一意の名前を指定
   場所	サブスクリプションでサポートされているAzure リージョンを選択する
   MongoDB バージョン	選択する 8.0
   管理者ユーザー名	ユーザー管理者としてクラスターにアクセスするためのユーザー名を作成する
   パスワード	ユーザー名に関連付けられている一意のパスワードを使用する

   

   Tip

   ユーザー名とパスワードに使用する値を記録します。 これらの値は、このガイドの後半で使用します。 有効な値の詳細については、 クラスターの制限事項を参照してください。

7. [次へ: ネットワーク] を選択します。

8. [ネットワーク] タブの [ ファイアウォール規則 ] セクションで、次のオプション を 構成します。

   	Value
   接続方法	Public access
   Azure 内の Azure サービスとリソースからこのクラスターへのパブリック アクセスを許可する	有効

9. [+ 現在のクライアント IP アドレスの追加] を選択して、クラスターへのアクセスを許可する現在のクライアント デバイスのファイアウォール規則を追加します。

   

   Tip

   多くの企業環境では、VPN やその他の企業ネットワーク設定により、開発者用コンピューターの IP アドレスが非表示になっています。 このような場合は、 0.0.0.0 - 255.255.255.255 IP アドレス範囲をファイアウォール規則として追加することで、すべての IP アドレスへのアクセスを一時的に許可できます。 このファイアウォール規則は、接続テストと開発の一環として一時的にのみ使用してください。

10. [Review + create](レビュー + 作成) を選択します。

11. 指定した設定を確認し、[作成] を選択します。 クラスターの作成には数分かかります。 リソースのデプロイが完了するまで待ちます。

12. 最後に、Go to resource を選択して、ポータルで Azure DocumentDB クラスターに移動します。

クラスターの資格情報を取得する

クラスターへの接続に使用する資格情報を取得します。

1. クラスター ページで、リソース メニューの [接続文字列 ] オプションを選択します。

2. [ 接続文字列 ] セクションで、[ 接続文字列 ] フィールドの値をコピーまたは記録します。

クイック スタートから MongoDB シェルを使用して接続する

MongoDB シェルを使用して Azure DocumentDB に直接接続するには、Azure portal のリソースのページで利用できるクイック スタート エクスペリエンスを使用します。

1. クラスター リソース ページで、ナビゲーション メニューから クイック スタート (プレビュー) を選択します。

2. 次に、[ MongoDB シェルを開く] を選択します。

3. MongoDB シェル環境が開始されるまで待ちます。

4. 環境の準備ができたら、「 Y 」と入力して通知を受け入れます。

   注

   通知を受け入れた後に MongoDB Shell を使用した接続で問題が発生する場合は、Azure Cloud Shell がクラスターにアクセスできることを確認してください。

5. 次に、Cloud Shell にクラスターを接続するためのパスワードを入力します。

テスト クエリの実行

一連のテスト コマンドとクエリを実行して、クラスターに正常に接続されていることを確認します。

1. connectionStatus コマンドを実行して、接続の状態を確認します。

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. クラスター内のデータベースを一覧表示します。

   show dbs
   

3. 特定のデータベースに切り替えます。 <database-name> プレースホルダーをクラスター内の任意のデータベースの名前に置き換えます。

   use <database-name>
   

   Tip

   たとえば、データベース名が inventoryされている場合、コマンドは use inventoryされます。

4. データベース内のコレクションを一覧表示します。

   show collections
   

5. 特定のコレクション内の最初の 5 つの項目を検索します。 <collection-name> プレースホルダーをクラスター内のコレクションの名前に置き換えます。

   db.<collection-name>.find().limit(5)
   

   Tip

   たとえば、コレクション名が equipmentされている場合、コマンドは db.equipment.find().limit(5)。

リソースをクリーンアップする

Azure DocumentDB クラスターの使用が完了したら、作成した Azure リソースを削除して、追加の料金が発生しないようにすることができます。

1. Azure portal の検索バーで、「リソース グループ」を検索して選択します。

   

2. 一覧で、このクイック スタートで使用したリソース グループを選択します。

   

3. [リソース グループ] ページで、 [リソース グループの削除] を選択します。

4. 削除の確認ダイアログで、リソース グループの名前を入力して、削除することを確認します。 最後に、[削除] を選択して、リソース グループを完全に削除します。

   

関連するコンテンツ

• MongoDB シェルから接続する
• Azure Cloud Shell から接続する
• Azure DocumentDB にデータを移行する