この記事では、ローカルのWindows環境にあるStudio 3Tを使用し、EC2(踏み台)を経由してAWSのDocumentDBに接続する方法について詳しく説明します。
Studio 3Tは、NoSQLを使うデータベースエンジニアや開発者にとって非常に便利なツールであり、MongoDBと互換性があるDocumentDBへの接続も簡単に行うことができます。
目標
今回の目標は、プライベートサブネットにいるDocumentDBに対して、パブリックサブネットにいる踏み台のEC2を経由して、ローカルにあるStudio 3Tから接続します。
なお、接続するVPCやDocument DB、EC2は構築済みであることを前提とし、Studio 3Tの設定に焦点を当てて説明しますので、まだAWSの環境を構築済みでない場合はこちらを参考にしてください。
それでは以下のステップに従って、効果的に設定しましょう。
接続するサーバーやユーザ、パスワード、DB名等は適宜置き換えてください。
DocumentDBの接続情報を確認
DocumentDBへの接続には、いくつかの情報が必要です。
まずはAWSコンソールにログインし、DocumentDBのクラスター情報やエンドポイント、ユーザー名などを確認しましょう。
これらの情報は後でStudio 3Tの設定で使用します。
接続情報は、DocumentDBのクラスター情報から確認することができます。
クラスターの「接続」を確認
以下のコマンドで、認証に必要なAmazon DocumentDB 認証機関 (CA) 証明書をダウンロードできます。
まだ持っていない場合はダウンロードしておきましょう。
wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem
こちらは、mongoシェルでクラスターに接続する方法です。
mongo --ssl --host docdb-db.cluster-xxxxxxxxxxxx.ap-northeast-1.docdb.amazonaws.com:27017 --sslCAFile global-bundle.pem --username master --password <insertYourPassword>
そして、アプリケーションでクラスターに接続方法です。
mongodb://master:********@docdb-db.cluster-xxxxxxxxxxxx.ap-northeast-1.docdb.amazonaws.com:27017/?ssl=true&ssl_ca_certs=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false
できれば事前に、EC2のmongoシェルかアップリケーションから接続できることを確認しておいてください。
Studio 3Tの設定
ここから、上記で確認したDocumentDBとEC2の接続情報を基に、Studio 3Tの接続設定をしていきます。
Studio 3Tを開き、左から順に以下の4つのタブについて設定していきます。
Serverタブ
項目 | 設定値 |
---|---|
Connection Type: | Standalone |
Server: | docdb-db.cluster-xxxxxxxxxxxx.ap-northeast-1.docdb.amazonaws.com |
Port: | 27017(←変更してなければデフォルト) |
Authenticationタブ
項目 | 設定値 |
---|---|
Authentication Model: | Legacy (SCRAM-SHA-1) |
User name: | master(DocumentDBのユーザー名) |
Password: | ********(DocumentDBのパスワード) |
Authentication DB: | admin |
SSLタブ
項目 | 設定値 |
---|---|
Use SSL protocol to connect | チェックする |
Use own Root CA file (–sslCAFile) | チェックする Document DBの.pemのファイルパスを指定する |
SSHタブ
項目 | 設定値 |
---|---|
Use SSH tunnel to connect | チェックする |
SSH Address: | ec2-XXX-XXX-XXX-XXX.ap-northeast-1.compute.amazonaws.com |
Port: | 22(EC2のSSHポートを指定) |
SSH User name: | ec2-user(EC2のログインユーザー) |
SSH Auth Mode: | Private Key |
Private Key: | EC2の.pemのファイルパスを指定する |
これで設定が完了しました。設定情報が正確であることを確認し、接続をテストしてみましょう。
接続が成功すると、Studio 3Tを使用してDocumentDBにアクセスできるようになります。
引用・出典は以下のAWS公式サイトより。
まとめ
この方法を使用することで、Studio 3Tを通じてEC2を経由してDocumentDBに安全かつ効率的に接続できます。
データベースのクエリやデータの操作がスムーズに行えるようになり、効率的な開発やデータ解析が可能になります。
DocumentDBのデータベースユーザーについての記事も書いていますので、併せて参考にしてみてください。
お疲れ様でした!
- Original:https://minory.org/studio3t-documentdb.html
- Source:minory
- Author:管理者
Amazonベストセラー
Now loading...