mongosh で接続する

MongoDB 互換の Firestore データベースを作成し、mongosh ツールを使用して接続する方法を学習します。

始める前に

  1. Google Cloud コンソールで、プロジェクトの選択ページに移動します。

    プロジェクト セレクタに移動

  2. Google Cloud プロジェクトの選択または作成

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。ロールを付与する方法を確認する。

  3. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

  4. プロジェクトで次のロール（複数の場合あり）が割り当てられていることを確認します。 Cloud Datastore オーナー

    ロールを確認する

    1. Google Cloud コンソールで、[IAM] ページに移動します。

      IAM に移動
    2. プロジェクトを選択します。

    3. [プリンシパル] 列で、自分または自分が所属するグループの行をすべて確認します。所属するグループについては、管理者にお問い合わせください。

    4. 自分のメールアドレスを含む行の [ロール] 列で、ロールのリストに必要なロールが含まれているかどうか確認します。

    ロールを付与する

    1. Google Cloud コンソールで、[IAM] ページに移動します。

      IAM に移動
    2. プロジェクトを選択します。
    3. [ アクセスを許可] をクリックします。

    4. [新しいプリンシパル] フィールドに、ユーザー ID を入力します。 これは通常、Google アカウントのメールアドレスです。

    5. [ロールを選択] をクリックし、ロールを検索します。
    6. 追加のロールを付与するには、 [別のロールを追加] をクリックして各ロールを追加します。
    7. [保存] をクリックします。
  5. mongosh ツールをインストールします。

MongoDB 互換の Firestore データベースを作成して接続文字列を取得する

Google Cloud コンソールで、新しい Firestore Enterprise エディションのデータベースを作成します。MongoDB 互換の Firestore には Firestore Enterprise エディションが必要です。

  1. Google Cloud コンソールで、[データベース] ページに移動します。

    [データベース] に移動

  2. [Firestore データベースを作成] をクリックします。
  3. データベース ID を入力します。
  4. [Enterprise エディション] を選択します。
  5. データベースのロケーションを選択します。

  6. [データベースを作成] をクリックします。

    データベースの初期化が完了すると、コンソールでデータベースの Firestore Studio が開きます。

  7. 外部の MongoDB ツールを使用して Firestore に接続するセクションで、接続文字列をコピーします。

接続文字列は、データベースの UID（システム生成）とデータベースのロケーションによって異なります。

UID.LOCATION.firestore.goog

SCRAM 認証用のユーザーを作成する

Google Cloud コンソールで、新しいデータベース ユーザーを作成し、そのユーザーに Identity and Access Management の権限を割り当てます。

  1. Google Cloud コンソールで、[データベース] ページに移動します。

    [データベース] に移動

  2. データベースのリストから、必要なデータベースを選択します。
  3. ナビゲーション メニューで [セキュリティ] をクリックします。
  4. [ユーザーを追加] をクリックします。
  5. ユーザー名を入力します。
  6. そのユーザーに対して Identity and Access Management ロールを選択します。
  7. [作成] をクリックします。ユーザーがデータベースで作成され、生成されたユーザーのパスワードが表示されます。このパスワードをコピーして保存してください。このパスワードは後で取得できません。

mongosh を使用して接続

接続文字列、ユーザー名、パスワードを使用してデータベースに接続し、次の構成オプションを使用して mongosh をローカルで実行します。

mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'

以下を置き換えます。

  • USERNAME: 作成したデータベース ユーザーの名前。
  • PASSWORD: 作成したデータベース ユーザー用に生成されたパスワード。
  • CONNECTION_STRING: データベース接続文字列。
  • DATABASE_ID: データベース ID

接続すると、次のようにデータを作成して読み取ることができます。

db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

次のステップ