Tableau、 Power BI 、 DBeaver などのSQLツールをMongoDB Atlasまたは Enterprise Advanced（EA）データベースに接続します。
3 つのSQL Interface 配置オプションはすべて同じ JDBC ドライバーと ODBC ドライバーを使用するため、Atlas専有クラスター、Atlasフェデレーティッドデータベースインスタンス、または自己管理型Enterprise Advanced（EA）配置に接続しても、このページの手順は同じになります。最初にSQL接続を受け入れるように配置を構成します。その方法については、 「 SQLインターフェイスサーバーの設定 」を参照してください。
注意
MongoDB は、JDBC ドライバーと ODBC ドライバーでTableau （ディスクトップ、サーバー、またはクラウド）および Power BI Desktop（ディスクとサービス）を公式にサポートしています。 JDBC ドライバーと ODBC ドライバーは他のSQL-92 互換ツールでも使用できますが、 MongoDB は互換性を保証できません。特定のSQL Interface 機能をテストして、サポートを確認します。
Tableau の接続
Tableau Connector for MongoDBを使用して、 Atlas専有クラスター、 Atlasフェデレーティッドデータベースインスタンス、またはセルフホスト型 Enterprise Advanced（EA）データベースをTableau （Desktop またはサーバー）に接続します。
前提条件
SQL Interface 用に構成されたMongoDBデータベース :
Atlas専有クラスターまたは自己管理型Enterprise Advanced（EA）配置では、 MongoDB6.0 以降を実行する必要があります。
Atlasフェデレーティッドデータベースインスタンスは1 つ以上のデータ5.0 ストアにマッピングする必要があり、読み取り元の各 Atlas クラスターではMongoDB 以降を実行する必要があります。詳細については、「 フェデレーティッドデータベースインスタンスの配置 」を参照してください。
MongoDB JDBC ドライバー。をインストールするには、 「 SQLインターフェイスドライバーの設定 」を参照してください。
Tableau Desktop、サーバー、またはクラウド。 Tableau Server では SCRAM認証が優先され、X.509 認証もサポートされています。 Tableau Cloud は SCRAM認証のみをサポートしています。サポートされている認証メカニズムの詳細については、 「 SQLインターフェイス認証 」を参照してください。
手順
次の手順は、 Tableauを使用してMongoDBに接続する方法を示しています。
Tableau Connector for MongoDBをダウンロードします。
注意
Tableau Desktop およびTableau Server バージョン 2025 以降は、 MongoDB用のTableau Connector をバンドルしています。お使いのTableauのバージョンにコネクタが既に含まれている場合は、この手順をスキップします。 Tableauにバンドルされているバージョンとは異なるバージョンを使用する場合に、この手順を完了します。
Tableau Desktop の場合は、 Tableauからコネクタをインストールすることもできます。 Tableau Change で MongoDB SQL interface by MongoDB を検索し、Install and restart Tableau をクリックします。
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に接続します。
MongoDB Javaドライバーと互換性のある接続文字列を使用します。詳細については、「 接続 URI 」を参照してください。
データベース接続情報を入力します。
前の手順で保存したSQL Interface接続文字列を入力します。
次の接続文字列を入力します。
mongodb://localhost:<port>/?authSource=admin
<port> を、 SQLインターフェイスサーバーがリッスンするように構成されたポート番号に置き換えます。
authSource パラメーターは、 MongoDBユーザーの認証に使用されるデータベースを指定します。 authSource を省略すると、Databaseフィールドに指定されたデータベースが認証に使用されます。
Databaseフィールドに、クエリするMongoDBデータベースの名前を入力します。
認証方法を選択します。
ドロップダウンから Authentication Mechanism を選択します。
サポートされているすべての認証メカニズムの詳細については、 SQLインターフェイス認証 を参照してください。
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 の接続ダイアログでは、追加のプロパティやフィールドは必要ありません。
Tableauログの構成
MongoDB JDBC ドライバーのログ構成を変更するには、mongodb_jdbc.properties ファイルにログ プロパティを追加します。このファイルのロケーションは、プラットフォームによって異なります。
プラットフォーム | パス |
|---|---|
MacOS |
|
Windows |
|
Tableau Server（RHEL） |
このファイルをすべてのサーバーノードにコピーします。 |
ログ記録を構成するには、次のプロパティをファイルに追加します。
loglevel=INFO logdir=<path-to-log-directory>
loglevelプロパティは、ドライバー ログの冗長を設定します。冗長の増加順に、OFF、SEVERE、WARNING、INFO、FINE、FINER の値を受け入れます。デフォルトは OFF です。
logdirプロパティは、ドライバーがログファイルを書き込むディレクトリを設定します。ディレクトリがすでに存在している必要があります。 logdir を省略するか、console に設定すると、ドライバーはファイルではなくコンソールにログを書き込みます。
重要
本番環境では、 SEVERE のログレベルから を開始します。各レベルにより大量の出力が追加されるため、問題を診断する必要がある場合にのみレベルを上げてください。 FINER レベルでは、ドライバーは各結果セットの各セルのデータを取得するすべての呼び出しをログに記録します。
Tableau でのプロパティ ファイルについて詳しく学ぶには、Tableau ドキュメントを参照してください。
Power BIの接続
Power BI Connector for MongoDBを使用して、 Atlas専有クラスター、 Atlasフェデレーティッドデータベースインスタンス、またはセルフホスト型 Enterprise Advanced（EA）データベースを Power BIに接続します。
前提条件
SQL Interface 用に構成されたMongoDBデータベース :
Atlas専有クラスターまたは自己管理型Enterprise Advanced（EA）配置では、 MongoDB6.0 以降を実行する必要があります。
Atlasフェデレーティッドデータベースインスタンスは1 つ以上のデータ5.0 ストアにマッピングする必要があり、読み取り元の各 Atlas クラスターではMongoDB 以降を実行する必要があります。詳細については、「 フェデレーティッドデータベースインスタンスの配置 」を参照してください。
MongoDB ODBC ドライバー。をインストールするには、 「 SQLインターフェイスドライバーの設定 」を参照してください。 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.このフォルダが存在しない場合は作成します。
MongoDBデータベース接続情報を取得します。
接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。
プロジェクトの Atlas専有クラスターまたはフェデレーティッドデータベースインスタンスにGo。
Connectボタンをクリックします。
Atlas SQL Interface オプションを選択します。
Power BI Connector[1]Select your driver ドロップダウンで [] オプションを選択します。
接続文字列をコピーします。
この情報を使用して、後の手順で Power BIに接続します。
MongoDBデプロイURI を使用します。詳細については、「 接続文字列 」を参照してください。
Power BI Desktop から接続します。
Power BI Desktop を開きます。
Home メニューから Get data を選択します。
MongoDB Atlas SQL connector を見つけて選択します。
新しいconnectorを見つけるには、検索バーに
mongoと入力します。MongoDB Atlas SQL を選択します。
[Connect] をクリックします。
URI とデータベース名を入力し、OK をクリックします。
MongoDB URI は、前の手順でコピーした接続文字列です。
Native queryフィールドには、任意でSQLクエリを入力できます。 Power BI は、 SQLクエリを直接のデータソースとして使用します。接続後に Power Query エディターでSQLクエリを追加または変更することもできます。
Atlas User name と Password を入力し、Connect をクリックします。
デフォルトでは 、ユーザーはロールと接続 URI で許可されているすべての名前空間にアクセスできます。カスタムロールを使用してアクセスを制限する場合は、Edit User メニューの追加の名前空間へのアクセスをユーザーに許可できます。詳細については、 「データベースユーザーの設定」 を参照してください。
サポートされている他の認証メカニズムの詳細については、 SQLインターフェイス認証 を参照してください。
Direct Query
Direct Query は、Power BI Connector for MongoDBバージョン1.2 以降で使用可能な接続モードです。 Direct Query を使用するには、バージョン 以降のMongoDB ODBC ドライバー 1.2をインストールする必要があります。 DSN を設定する必要はありません。
Direct Query を、標準の Import Mode の代わりに使用すると、データベースを直接クエリできます。これにより最新データが保証されますが、結果が返されるまでに時間がかかる可能性があります。
直接クエリは一部のアクションをサポートしていません。 サポートされていないアクションを実行しようとすると、Power BIImport Mode に切り替えるよう求めるメッセージが表示されます。
DBeaver の接続
MongoDB JDBC ドライバー を使用して、 Atlas専有クラスター、 Atlasフェデレーティッドデータベースインスタンス、または自己管理型Enterprise Advanced（EA）配置を DBeaver に接続します。
前提条件
SQL Interface 用に構成されたMongoDBデータベース :
Atlas専有クラスターまたは自己管理型Enterprise Advanced（EA）配置では、 MongoDB6.0 以降を実行する必要があります。
Atlasフェデレーティッドデータベースインスタンスは1 つ以上のデータ5.0 ストアにマッピングする必要があり、読み取り元の各 Atlas クラスターではMongoDB 以降を実行する必要があります。詳細については、「 フェデレーティッドデータベースインスタンスの配置 」を参照してください。
MongoDB JDBC ドライバー。をインストールするには、 「 SQLインターフェイスドライバーの設定 」を参照してください。
手順
DBeaver から接続するには次の手順に従います。
MongoDBデータベース接続情報を取得します。
接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。
プロジェクトの Atlas専有クラスターまたはフェデレーティッドデータベースインスタンスにGo。
Connectボタンをクリックします。
Atlas SQL Interface オプションを選択します。
JDBC Driver[1]Select your driver ドロップダウンで [] オプションを選択します。
Database ドロップダウンから接続するデータベースを選択します。
接続文字列をコピーします。
この情報を使用して、後のステップで DBeaver に接続します。
MongoDB Javaドライバーと互換性のある接続文字列を使用します。詳細については、「 接続 URI 」を参照してください。
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を入力した場合は不要です。
次のステップ
SQLツールをMongoDBデータベースに接続したら、データをクエリできます。詳しくは、以下を参照してください。
注意
プライベートエンドポイントを使用して接続するには、「 プライベートエンドポイントを使用してMongoDB SQLインターフェイスに接続する 」を参照してください。