Amazon DocumentDB の開始方法 - Amazon DocumentDB

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

Amazon DocumentDB の開始方法

では、さまざまな方法で接続し、開始できます。 Amazon DocumentDB. このガイドは、ユーザーが当社の強力なドキュメントデータベースを使い始めるための最も迅速、簡単、簡単な方法であると考え、作成しました。このガイドでは AWS Cloud9は、Web ベースの端末で、 Amazon DocumentDB 直接、 AWS マネジメントコンソール. AWS 無料利用枠の対象である新規の AWS のお客様は、AWS Cloud9 を無料でご利用いただけます。あなたの AWS Cloud9 環境は、空き階層以外のリソースを利用する場合、それらのリソースに対する通常のAWS料金が請求されます。このガイドでは、 Amazon DocumentDB 15分未満で、想定コストが1時間あたり0.10ドル未満

注記

Amazon DocumentDB は無料階層を持っていません。価格の詳細については、 Amazon DocumentDB(MongoDB互換)価格.

もっとあなたの Amazon DocumentDB SSH 接続を作成して、 Amazon EC2 参照するには、 EC2の指示と接続する

Prerequisites

最初の Amazon DocumentDB クラスターを作成する前に、以下の操作を行う必要があります。

Amazon Web Services (AWS) アカウントを作成する

Amazon DocumentDB の使用を開始する前に、Amazon Web Services (AWS) アカウントが必要です。AWS アカウントは無料です。使用しているサービスとリソースに対してのみ料金をお支払いいただきます。

AWS アカウントをお持ちでない場合は、次に説明する手順に従ってアカウントを作成してください。

AWS にサインアップするには

  1. https://aws.amazon.com/ を開き、[AWS アカウントの作成] を選択します。

  2. オンラインの手順に従います。

必要な AWS Identity and Access Management (IAM) アクセス許可を設定します。

クラスター、インスタンス、クラスターパラメータグループなどの Amazon DocumentDB リソースを管理するためのアクセスでは、リクエストの認証に AWS が使用できる認証情報が必要です。詳細については、Amazon DocumentDB での Identity and Access Management を参照してください。

  1. AWS Management Consoleの検索バーに「 IAM 選択して IAM 表示されます。

  2. 一度ログインすると、 IAM コンソール、選択 ユーザー クリックします。

  3. ユーザー名を選択します。

  4. ボタンをクリックします。 権限の追加.

  5. [Attach existing policies directly (既存のポリシーを直接アタッチ)] を選択します。

  6. タイプ AmazonDocDBFullAccess 検索結果が表示されたら、それを選択します。

  7. 下の青いボタンをクリックします。 次へ: 確認

  8. 下の青いボタンをクリックします。 権限の追加.

Amazon Virtual Private Cloud (Amazon VPC) を作成する

このステップは、デフォルトの Amazon VPC. そうでない場合は、 を使ってみる Amazon VPCAmazon VPC ユーザーガイド. 所要時間は5分未満です。

ステップ1: AWS Cloud9 環境の作成

AWS Cloud9 では、Webベースの端末を使用して、 Amazon DocumentDB モンゴシェルを使用するクラスタです。

  1. から AWS マネジメントコンソール _に移動します。 AWS Cloud9 コンソールを選択し、 環境の作成.

  2. 環境名と説明 セクション内の 名前 ]フィールドに「 DocumentDBCloud9.

  3. 選択 次のステップ.

  4. 設定セクションを構成する、選択 次のステップ.

  5. レビュー セクションを選択し、 環境の作成.

注記

のプロビジョニング AWS Cloud9 最大3分かかることがあります。

ステップ2: セキュリティグループの作成

このセキュリティグループを使用すると、 Amazon DocumentDB クラスターを AWS Cloud9 環境です。

  1. Amazon EC2 管理コンソール、以下 ネットワークとセキュリティ、選択 セキュリティグループ.

  2. 選択 セキュリティグループの作成.

  3. 基本的な詳細 ボックスの各フィールドに以下を入力します。

    • For セキュリティグループ名, enter demoDocDB デモDocDB.
    • For 説明:, enter a description.
    • For VPC, accept the usage of your default VPC.
  4. 受信ルール セクションを選択し、 ルールの追加.

  5. 対象: タイプ、選択 カスタムTCPルール.

  6. 対象: ポート範囲、入力 27017.

  7. ソースは、 AWS Cloud9 作成しました。使用可能なセキュリティ グループのリストを表示するには、次のように入力します。 cloud9 [destination]フィールドに表示されます。という名前のセキュリティグループを選択します aws-cloud9-<environment name>.

  8. 他のすべてのデフォルトを受け入れて、 セキュリティグループの作成.

注記

ポート27017は、 Amazon DocumentDB.

ステップ3: Amazon DocumentDB クラスターを作成する

このステップでは、 Amazon DocumentDB 前のステップで作成したセキュリティグループを使用してクラスタを作成します。

  1. の Amazon DocumentDB 管理コンソールの下 クラスタ、選択 作成.

  2. [Amazon DocumentDB の作成]クラスタ ページで、 構成 セクションを選択し、 1インスタンス数. 1つのインスタンスを選択すると、コストを最小限に抑えることができます。これが本番システムの場合、高可用性のために3つのインスタンスをプロビジョニングすることをお勧めします。その他の設定は、 構成 セクションをデフォルトに設定します。

  3. 認証 セクションで、ユーザー名とパスワードを入力します。

  4. 電源を入れる 詳細設定を表示.

  5. ネットワーク設定 セクション、対象: VPCセキュリティグループ、選択 demoDocDB デモDocDB.

  6. 選択 クラスタの作成.

Amazon DocumentDB がクラスタをプロビジョニングしています。完了するまでに数分かかる場合があります。クラスタとインスタンスの両方のステータスが次のように表示されると、クラスタに接続できます。 Available.

ステップ4: mongo シェルをインストールする

mongoシェルを AWS Cloud9 環境を、ステップ1で作成したファイルで管理できます。mongoシェルは、 Amazon DocumentDB クラスタ。

  1. お客様の AWS Cloud9 環境はステップ1からまだ開いています。その環境に戻り、手順3に進んでください。離れて移動した場合 AWS Cloud9 環境、 AWS Cloud9 管理コンソールの下 環境、というラベルの付いた環境を見つけます。ドキュメントDBクラウド9. 選択 IDEを開く.

  2. コマンド プロンプトで、次のコマンドを使用してリポジトリ ファイルを作成します。

    echo -e "[mongodb-org-3.6] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/3.6/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc" | sudo tee /etc/yum.repos.d/mongodb-org-3.6.repo
  3. 完了したら、次のコマンドを使用して Mongo シェルをインストールします。

    sudo yum install -y mongodb-org-shell
  4. 転送中のデータを暗号化するには、 Amazon DocumentDB から https://s3.amazonaws.com/rds-downloads/rds-combined-ca-bundle.pem. このオペレーションにより、 という名前のファイルがダウンロードされます。rds-combined-ca-bundle.pem.

    wget https://s3.amazonaws.com/rds-downloads/rds-combined-ca-bundle.pem
    注記

    転送中の暗号化は、Amazon DocumentDBでデフォルトで有効になっています。オプションでTLSを無効にできます。詳細については、以下を参照してください。 Amazon DocumentDB Cluster TLS設定の管理.

ステップ5: _に接続 Amazon DocumentDB クラスター

ここからは、 Amazon DocumentDB 手順 4 でインストールしたモンゴシェルを使用して、クラスタを作成します。

  1. の Amazon DocumentDB 管理コンソールの下 クラスタ、クラスタを探します。クラスタ識別子をクリックして、作成したクラスタを選択します。

  2. 接続性とセキュリティ タブ、下 Mongo シェルでこのクラスタに接続します。、提供された接続文字列をコピーします。コピーを省略 <insertYourPassword> 接続時に Mongo シェルでパスワードの入力を求めるプロンプトが表示されます。

  3. _に戻る AWS Cloud9 接続文字列を貼り付けます。

パスワードを入力すると、 rs0:PRIMARY> というプロンプトが表示されたら、 Amazon DocumentDB クラスタ。

注記

トラブルシューティングの詳細については、以下を参照してください。 トラブルシューティング Amazon DocumentDB.

ステップ6: データの挿入とクエリ

クラスターに接続されましたので、ドキュメント データベースの使用に慣れるためのいくつかのクエリを実行できます。

  1. 単一のドキュメントを挿入するには、次のように入力します。

    db.collection.insert({"hello":"DocumentDB"})
  2. 次の出力が返ります。

    WriteResult({ "nInserted" : 1 })

  3. で書いた文書を読むことができます。 findOne() コマンド(単一のドキュメントのみを返すため)。以下を入力します。

    db.collection.findOne()
  4. 次の出力が返ります。

    { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

  5. さらにいくつかのクエリを実行するには、ゲーミングプロファイルの使用例を検討してください。まず、 profiles。 以下を入力します。

    db.profiles.insertMany([ { "_id" : 1, "name" : "Matt", "status": "active", "level": 12, "score":202}, { "_id" : 2, "name" : "Frank", "status": "inactive", "level": 2, "score":9}, { "_id" : 3, "name" : "Karen", "status": "active", "level": 7, "score":87}, { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} ])
  6. 次のコマンドをコピーして、 AWS Cloud9 環境に貼り付けて AWS Cloud9 ターミナル。

    db.profiles.insertMany([ { "_id" : 1, "name" : "Matt", "status": "active", "level": 12, "score":202}, { "_id" : 2, "name" : "Frank", "status": "inactive", "level": 2, "score":9}, { "_id" : 3, "name" : "Karen", "status": "active", "level": 7, "score":87}, { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} ])
  7. 次の出力が返ります。

    { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

  8. _を使用 find() コマンドを使用して、プロファイルコレクション内のすべてのドキュメントを返します。以下を入力します。

    db.profiles.find()
  9. ステップ5で入力したデータと一致する出力が得られます。

  10. フィルターを使用して、1 つのドキュメントのクエリを使用します。以下を入力します。

    db.profiles.find({name: "Katie"})
  11. この出力に戻る必要があります。

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

  12. 次に、プロファイルを検索し、 findAndModify コマンド。Mattには、次のコードでさらに10ポイントを与えます。

    db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } })
  13. 次の出力が表示されます(彼のスコアはまだ上昇していません)。

    { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 202 }
  14. 次のクエリを使用して、彼のスコアが変更されたことを確認できます。

    db.profiles.find({name: "Matt"})

  15. 次の出力が返ります。

    { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }

ステップ7: 探索する

おめでとうございます。のスタートガイドが無事に完了しました。 Amazon DocumentDB.

次に何をしますか? 次のような一般的な機能でこのデータベースをフルに活用する方法を学びます。

注記

この開始演習から作成したクラスタは、削除しない限り、引き続きコストが発生します。手順については、 削除 Amazon DocumentDB クラスター.