BIツールを、Tableau、Power BI、DBeaverなどのMongoDB AtlasまたはEnterprise Advanced(EA)データベースに接続します。
注意
MongoDB は、Tableau (Desktop または サーバー) および Power BI Desktop (Desktop とサービス) を、その JDBC および ODBC ドライバーで公式にサポートしています。JDBC ドライバーと ODBC ドライバーは他のSQL-92 BIツールでも使用できますが、 MongoDB は互換性を保証できません。特定のSQL Interface 機能をテストして、サポートを確認します。
Tableau の接続
Tableau Connector for MongoDBを使用して、Atlasフェデレーティッドデータベースインスタンスまたはセルフホスト型Enterprise Advanced(EA)データベースのいずれかをTableau (Desktop またはサーバー)に接続します。
前提条件
SQL Interface 用に構成されたMongoDBデータベース 、 。
MongoDB JDBC ドライバー。インストールするには、JDBC ドライバーのインストールを参照してください。
Tableau Desktop または Server。Tableau Server では、現在サポートされている認証メカニズムは SCRAM認証 のみです。
手順
次の手順は、 Tableauを使用してMongoDBに接続する方法を示しています。
Tableau Connector for MongoDBをダウンロードします。
MongoDBダウンロード センター から最新のTableau Connector
tacoファイルをダウンロードします。tacoファイルをオペレーティング システムの適切なディレクトリに移動します。Windows:
C:\Users\<user>\Documents\My Tableau Repository\ConnectorsMacOS:
~/Documents/My Tableau Repository/ConnectorsLinux:
/opt/tableau/connectors
重要
Tableau Connector for MongoDBの新しいバージョンをダウンロードする場合は、Connectorsディレクトリから前の tacoファイルを削除して、 Tableau が最新バージョンを使用していることを確認します。
MongoDBデータベース接続情報を取得します。
接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。
プロジェクトの AtlasフェデレーティッドデータベースインスタンスにGo。
[Connect] ボタンをクリックします。
Atlas SQL Interface オプションを選択します。
Tableau Connector[1]Select your driver ドロップダウンで [] オプションを選択します。
ドロップダウンから [Tableau] を選択します。
Database ドロップダウンから接続するデータベースを選択します。
接続文字列と接続パラメーターをコピーします。
この情報を使用して、後のステップでTableauに接続します。
mongosh の接続文字列を使用します。
認証方法を選択します。
ドロップダウンから Authentication Mechanism を選択します。
Username: MongoDBユーザー名を入力します。
Password: MongoDBのパスワードを入力します。
次のいずれかの方法を使用して PEM 証明書を構成します。
PEM ファイル パスを使用します。
mongodb_jdbc.propertiesファイルで、x509pempathプロパティをPEM ファイルのパスに設定します。例、x509pempath=/certs/client-cert.pem。PEMファイルが暗号化されていない場合は、Provide PEM Contents を選択しないでください。これ以上のアクションは必要ありません。
PEMファイルが暗号化されている場合は、Provide PEM Contents を選択し、Passwordフィールドにファイルのパスフレーズを入力します。
PEM コンテンツを次のように入力します。
Provide PEM Contents の横にあるチェックボックスをオンにし、Passwordフィールドに証明書データを入力します。
暗号化されていないコンテンツ: 完全な証明書コンテンツをフィールドに直接貼り付けます。
暗号化されたコンテンツ: コンテンツとパスフレーズを含むJSONオブジェクトを貼り付けます。
{ "pem": "<PEM-CONTENT>", "passphrase": "<PEM-PASSPHRASE>" }
Usernameフィールドに Kerberos プリンシパル名を入力します。例、user@EXAMPLE.COM。
OIDC の接続ダイアログでは、追加のプロパティやフィールドは必要ありません。
Power BIの接続
Power BI Connector for MongoDBを使用して、Atlasフェデレーティッドデータベースインスタンスまたはセルフホスト型Enterprise Advanced(EA)データベースのいずれかを Power BIに接続します。
前提条件
SQL Interface 用に構成されたMongoDBデータベース。
MongoDB ODBC ドライバー。インストールするには、ODBC ドライバーのインストールを参照してください。Direct Query について、バージョン 1.2 以降をインストールする必要があります。
Power BI Desktop 64 ビット。Microsoft は Power BI を毎月更新およびリリースしています。Atlas では最新バージョンの Power BI Desktop のみをサポートしています。
Windowsオペレーティング システム。Power BI Desktop がサポートする Windows OS のバージョンについては、Microsoft のドキュメント を参照してください。
手順
次の手順は、 Power BIを使用してMongoDBに接続する方法を示しています。
Power BI Connector for MongoDBをダウンロードします。
MongoDBダウンロード センター から最新の Power BI Connector
pqxファイルをダウンロードします。注意
Power BI Connector for MongoDBは、Power BI Desktop に付属します。お使いの Power BI Desktop のバージョンに既にMongoDB Atlas SQL コネクタがある場合は、この手順をスキップします。Power BI Desktop にバンドルされているバージョンとは異なるバージョンを使用する場合に、この手順を完了します。
コネクタファイルを次のディレクトリパスに移動します。
C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.このフォルダが存在しない場合は作成します。
Power BI Desktop から接続します。
Power BI Desktop を開きます。
Home メニューから Get data を選択します。
MongoDB Atlas SQL connector を見つけて選択します。
新しいconnectorを見つけるには、検索バーに
mongoと入力します。MongoDB Atlas SQL を選択します。
[Connect] をクリックします。
URI とデータベース名を入力し、OK をクリックします。
MongoDB URI は、前の手順で取得された URL です。
Native query フィールドに SQL クエリを入力することもできます。Power BI は、SQL クエリを直接のデータソースとして使用します。
Atlas User name と Password を入力し、Connect をクリックします。
デフォルトでは 、ユーザーは アクセス権を持つプロジェクト内のすべてのクラスターとフェデレーティッドデータベースインスタンスにアクセスできます。特定のクラスターとフェデレーティッドデータベースインスタンスへのアクセスを制限した場合は、Edit User メニューで新しいフェデレーティッドデータベースインスタンスへのアクセスを許可できます。詳細については、 「データベースユーザーの設定」 を参照してください。
Direct Query について
Direct Query は、Power BI Connector for MongoDBバージョン 1.2 以降で使用可能な接続モードです。Direct Query を使用するには、バージョン 1.2 以降のMongoDB ODBC ドライバー をインストールする必要があります。
直接クエリは、標準のインポートモードの代わりに使用され、データベースを直接クエリできます。 これにより最新データが保証されますが、結果が返されるまでに時間がかかる可能性があります。
直接クエリは一部のアクションをサポートしていません。 サポートされていないアクションを実行しようとすると、Power BIImport Mode に切り替えるよう求めるメッセージが表示されます。
DBeaver の接続
MongoDB JDBC ドライバーを使用して、Atlasフェデレーティッドデータベースインスタンスを DBeaver に接続します。
前提条件
1 つ以上のデータ ストアにマッピングされた Atlasフェデレーティッドデータベースインスタンス。「フェデレーティッドデータベースインスタンスの配置」を参照してください。
注意
データの一部または全部が Atlas クラスターから取得されている場合、そのクラスターで MongoSQL を利用するには、 MongoDBバージョン 5.0 以降を使用する必要があります。
MongoDB JDBC ドライバー。インストールするには、JDBC ドライバーのインストールを参照してください。
手順
DBeaver からフェデレーティッドデータベースインスタンスに接続する手順は、次のとおりです。
Atlasで、プロジェクトのフェデレーティッドデータベースインスタンスにGoします。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Services見出しの下のData Federationをクリックします。
Data Federationページが表示されます。
DBeaverアプリケーションを開きます。
DBeaver にドライバーを追加します。
DBeaver で、Database をクリックし、ドロップダウン メニューから Driver Manager を選択します。
New をクリックすると Create new driver モーダルが開きます。
Settingsタブで、次の情報を指定します。
ドライバー名
MongoSQLクラス名
com.mongodb.jdbc.MongoDriverLibraries タブで、Add File をクリックし、JDBC ドライバー
all.jarファイルを追加します。[Find Class] をクリックします。
OK をクリックします。Create new driver モーダルが閉じます。
データベース接続を作成します。
DBeaver で、Database をクリックし、ドロップダウン メニューから New Database Connection を選択して、Connect to a database モーダルを開きます。
データベースのリストから、前の手順で作成した
MongoDBデータベース ドライバーを選択します。MongoDBが表示されない場合は、モーダル内で All カテゴリを選択してください。[Next] をクリックします。
Main タブで、次の情報を入力します。
JDBC URL
前のステップから取得された接続文字列。
ユーザー名
接続を許可されたMongoDBユーザー。
パスワード
MongoDBユーザーに関連付けられたパスワード
Driver properties タブで、User Properties を展開します。次のキーと値のプロパティを追加します。
database
仮想データベースの名前。
user
接続する MongoDB ユーザー。前の手順で
Usernameを入力した場合は不要です。
次のステップ
BIツールをMongoDBデータベースに接続したら、データをクエリできるようになります。詳しくは、以下を参照してください。
注意
プライベートエンドポイントを使用して接続するには、「フェデレーティッドデータベースインスタンスのプライベートエンドポイントを使用した MongoSQL への接続」を参照してください。MongoDB Shell を使用して接続するには、 「 MongoDB Shell からの接続 」を参照してください。