/ /

BIツールの接続

BIツールを、Tableau、 Power BI 、 DBeaver などのMongoDB AtlasまたはEnterprise Advanced（EA）データベースに接続します。

注意

MongoDB は、JDBC ドライバーと ODBC ドライバーでTableau （Desktop または Server）および Power BI Desktop（Desktop とサービス）を公式にサポートしています。 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\Connectors
- MacOS: ~/Documents/My Tableau Repository/Connectors
- Linux: /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の接続文字列を使用します。

Tableau Desktop または Tableau Server を開きます。

Connect メニューにGo。

MongoDB SQL Interface by MongoDB を選択します。

接続モーダルが表示されます。

データベース接続情報を入力します。

前の手順で保存したSQL Interface接続文字列を入力します。

認証方法を選択します。

ドロップダウンから 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 の接続ダイアログでは、追加のプロパティやフィールドは必要ありません。

[Sign In] をクリックします。

Tableauログの構成

MongoDB JDBC ドライバーのログ構成を変更するには、mongodb_jdbc.propertiesファイルにログプロパティを追加します。このファイルのロケーションは、プラットフォームによって異なります。

プラットフォーム	パス
MacOS	`~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties` `~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties`
Windows	`C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties` `C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties`
Tableau Server（RHEL）	`/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties` このファイルをすべてのサーバーノードにコピーします。

ログ記録を構成するには、次のプロパティをファイルに追加します。

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フェデレーティッドデータベースインスタンスまたはセルフホスト型Enterprise Advanced（EA）データベースのいずれかを Power BIに接続します。

前提条件

SQL Interface 用に構成されたMongoDBデータベース。
The MongoDB ODBC driver. To install, see Install the ODBC Driver. To use About Direct Query, you must install version 1.2 or later.
Power BI Desktop64 ビット。 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 を見つけて選択します。
1. 新しいconnectorを見つけるには、検索バーに mongo と入力します。
2. MongoDB Atlas SQL を選択します。
3. [Connect] をクリックします。
URI とデータベース名を入力し、OK をクリックします。
MongoDB URI は、前の手順で取得された URL です。
Native query フィールドに SQL クエリを入力することもできます。Power BI は、SQL クエリを直接のデータソースとして使用します。
Atlas User name と Password を入力し、Connect をクリックします。
デフォルトでは、ユーザーはアクセス権を持つプロジェクト内のすべてのクラスターとフェデレーティッドデータベースインスタンスにアクセスできます。特定のクラスターとフェデレーティッドデータベースインスタンスへのアクセスを制限した場合は、Edit User メニューで新しいフェデレーティッドデータベースインスタンスへのアクセスを許可できます。詳細については、「データベースユーザーの設定」を参照してください。
サポートされている他の認証メカニズムの詳細については、 SQLインターフェイス認証を参照してください。

Direct Query について

Direct Query は、Power BI Connector for MongoDBバージョン1.2 以降で使用可能な接続モードです。 Direct Query を使用するには、バージョン. 以降のMongoDB ODBC 1ドライバー2 をインストールする必要があります。

直接クエリは、標準のインポートモードの代わりに使用され、データベースを直接クエリできます。これにより最新データが保証されますが、結果が返されるまでに時間がかかる可能性があります。

直接クエリは一部のアクションをサポートしていません。サポートされていないアクションを実行しようとすると、Power BIImport Mode に切り替えるよう求めるメッセージが表示されます。

DBeaver の接続

MongoDB JDBC ドライバーを使用して、AtlasフェデレーティッドデータベースインスタンスをDBeaver に接続します。

前提条件

1 つ以上のデータストアにマッピングされた Atlasフェデレーティッドデータベースインスタンス。「フェデレーティッドデータベースインスタンスの配置」を参照してください。

注意
データの一部または全部が Atlas クラスターから取得されている場合、そのクラスターで MongoSQL を利用するには、 MongoDBバージョン 5.0 以降を使用する必要があります。
DBeaver（コミュニティエディション）。
MongoDB JDBC ドライバー。インストールするには、JDBC ドライバーのインストールを参照してください。

手順

DBeaver からフェデレーティッドデータベースインスタンスに接続する手順は、次のとおりです。

Atlasで、プロジェクトのフェデレーティッドデータベースインスタンスにGoします。

まだ表示されていない場合は、プロジェクトを含む組織をナビゲーションバーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーションバーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Services見出しの下のData Federationをクリックします。

Data Federationページが表示されます。

Connect をクリックすると、フェデレーティッドデータベースインスタンス接続モーダルが開きます。

MongoSQL を選択します。

JDBC Driver を選択します。

接続情報をコピーします。

Atlas Data Federation は、フェデレーティッドデータベースインスタンスに接続するための接続文字列を提供します。これは後の手順で必要になります。

DBeaverアプリケーションを開きます。

DBeaver にドライバーを追加します。

DBeaver で、Database をクリックし、ドロップダウンメニューから Driver Manager を選択します。
New をクリックすると Create new driver モーダルが開きます。
Settingsタブで、次の情報を指定します。
ドライバー名
MongoSQL
クラス名
com.mongodb.jdbc.MongoDriver
Libraries タブで、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 からの接続」を参照してください。

戻る

ドライバーを設定する

クエリ

ドライバー名	`MongoSQL`
クラス名	`com.mongodb.jdbc.MongoDriver`

JDBC URL	前のステップから取得された接続文字列。
ユーザー名	接続を許可されたMongoDBユーザー。
パスワード	MongoDBユーザーに関連付けられたパスワード

database	仮想データベースの名前。
user	接続する MongoDB ユーザー。前の手順で `Username` を入力した場合は不要です。