IBM Cloud Docs
Databases for MongoDB の概要

Databases for MongoDB の概要

このチュートリアルでは、Databases for MongoDB を素早く使い始めるための手順を説明します。インスタンスのプロビジョニング、管理者パスワードの設定、接続、そして簡単なドキュメントの書き込みと読み込みを行います。

チュートリアルを完了するには、以下の手順に従ってください：

チュートリアルを完了するには、以下の手順に従ってください：

チュートリアルを完了するには、以下の手順に従ってください：

チュートリアルを完了するには、以下の手順に従ってください：

開始前に

ステップ 1: プランの選択

Databases for MongoDBは2つの異なるプランを提供しています：

API の使用

Cloud Databases API を使用して、 Databases for MongoDB インスタンスを操作します。 リソース・コントローラー API は、 インスタンスをプロビジョンする ために使用されます。

API経由でアクションを実行するには、APIキーが必要です。 以下の手順に従い、IBM Cloud API キーを作成します。この API キーを使用すると、API を使用してアカウントにインフラストラクチャーをプロビジョニングできるようになります。 最大 20 個の API キーを作成できます。

安全上の理由により、API キーをコピーまたはダウンロードできるのは作成時のみになります。 API キーを紛失した場合は、新しい API キーを作成する必要があります。

ステップ 2: コンソールを使用したプロビジョン

  1. IBM Cloud コンソールにログインします。

  2. Databases for MongoDB サービスをカタログでクリックします。

  3. 以下の手順 に従い、Databases for MongoDBインスタンスをプロビジョニングします。

  4. インスタンスがプロビジョニングされたら、インスタンス名をクリックして詳細情報を表示します。

ステップ 2: CLI を使用したプロビジョン

CLI を使用して Databases for MongoDB インスタンスをプロビジョンできます。 まだインストールしていない場合は、 IBM Cloud CLIをインストールする必要があります。

Databases for MongoDBインスタンスをプロビジョニングするには、以下の手順 に従います。

ステップ 2: リソース・コントローラー API を使用したプロビジョン

以下の手順 に従い、Databases for MongoDB インスタンスを Resource Controller API を使ってプロビジョニングします。

ステップ 2: Terraform を使用したプロビジョン

Terraformでアクションを実行するにはAPIキーが必要です。 以下の手順に従って、IBM Cloud API キーを作成し、Terraform があなたのアカウントにインフラストラクチャをプロビジョニングできるようにします。 最大 20 個の API キーを作成できます。

安全上の理由により、API キーをコピーまたはダウンロードできるのは作成時のみになります。 API キーを紛失した場合は、新しい API キーを作成する必要があります。

APIキーを取得したら、以下の手順 に従い、Databases for MongoDBインスタンスをTerraformを使ってプロビジョニングします。

ステップ3：管理者パスワードの設定

管理者ユーザー

Databases for MongoDB デプロイメントをプロビジョニングすると、admin ユーザーが自動的に作成されます。

接続に使用する前に、管理者パスワードを設定してください。

UIから管理者パスワードを設定する

IBM Cloud Resource listからインスタンスを選択し、UIから管理者パスワードを設定します。 次に、 「設定」 を選択します。 次に、 *「データベース管理者パスワードの変更」*を選択します。

CLIで管理者パスワードを設定する

IBM Cloud CLI Cloud Databases プラグインから cdb user-password コマンドを使用して、管理パスワードを設定します。

たとえば、配置の管理者パスワードを設定するには、次のコマンドを使用します：

ibmcloud cdb user-password <INSTANCE_NAME_OR_CRN> admin <NEWPASSWORD>

APIを通じて管理者パスワードを設定する

上記のステップ2のレスポンスで得られた id パラメータを、指定したユーザーのパスワードを設定するエンドポイントで使用することで、管理者パスワードを設定することができます。

curl -X PATCH -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
     -d '{"password":"newrootpasswordsupersecure21"}' \
      "https://api.<REGION>.databases.cloud.ibm.com/v5/ibm/deployments/<DEPLOYMENT_ID>/users/database/admin"

上記のAPIコールが機能するためには、 id パラメーターが URL-encoded である必要がある。

Terraformで管理者パスワードを設定する

管理者パスワードは、Terraformスクリプトのデータベースリソースパラメータの1つとして渡される。 これ以上のアクションは必要ない。

ステップ 4: Databases for MongoDB インスタンスに接続します

インスタンスへの接続は、Mongo Shell (コマンドラインインターフェイス) または Mongo Compass (データを照会・分析するための強力な GUI) を使って簡単に行えます。 これらのツールはどちらもMongoDBで提供されています。

Mongo シェルを使う

以下の手順 に従い、Mongo Shellをダウンロードして接続します。

その後、ドキュメントをコレクションに挿入して、配備をテストできます：

use sample_mflix

db.movies.insertOne(
  {
    title: "The Favourite",
    genres: [ "Drama", "History" ],
    runtime: 121,
    rated: "R",
    year: 2018,
    directors: [ "Yorgos Lanthimos" ],
    cast: [ "Olivia Colman", "Emma Stone", "Rachel Weisz" ],
    type: "movie"
  }
)

上のコマンドは、sample_mflix というデータベースに切り替え（まだ存在しなければ作成します）、movies コレクションに文書を挿入します（これもまだ存在しなければ作成します）。

その文書を取り出すには

db.movies.find( { title: "The Favourite" } )

これでデータベースに接続し、Mongo Shell を使ってデータを読み書きできるようになりました。

MongoDB Compass を使用する

この指示 に従って MongoDB Compass をダウンロードし、それを使用して Databases for MongoDB インスタンスに接続します。 MongoDB Compass documentation を使用して、データを書き込んだり読み込んだりすることができます。

次のステップ