AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

SQLツールをMongoDBに接続する

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

3 つの SQL Interface 配置オプションは、同じ JDBC ドライバーと ODBC ドライバーを使用します。したがって、接続先が Atlas 専有クラスター、Atlas フェデレーティッドデータベースインスタンス、または自己管理型 Enterprise Advanced (EA) 配置のどの場合でも、このページの手順は同じです。まず、SQL 接続を受け入れるように配置を構成します。その方法については、 「SQLインターフェイスサーバーの設定 」を参照してください。

注意

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

GrafanaやMetabaseなどのツールは独自のMongoDBコネクタやプラグインを提供していますが、MongoDBはこれらの統合を公式にはサポートしていません。設定の詳細については、Grafana MongoDBデータソースおよびMetabase MongoDBのドキュメントを参照してください。

Tableau の接続

Tableau Connector for MongoDBを使用して、Atlas 専有クラスター、Atlas フェデレーティッドデータベースインスタンス、またはセルフホスト型Enterprise Advanced（EA）データベースのいずれかをTableau（Desktop またはサーバー）に接続します。

前提条件

  • MongoDB JDBC ドライバー。インストールするには、SQL インターフェース ドライバー設定を参照してください。

  • Tableau Desktop、サーバー、またはクラウド。SCRAM認証はTableau サーバーで推奨されており、X.509認証もサポートされています。Tableau クラウドはSCRAM認証のみをサポートしています。サポートされている認証メカニズムの詳細については、「SQLインターフェース認証」を参照してください。

手順

次の手順は、 Tableauを使用してMongoDBに接続する方法を示しています。

1

Tableau Connector for MongoDBをダウンロードします。

注意

Tableau Desktop および Tableau サーバー バージョン 2025 以降には、MongoDB 用の Connector がバンドルされています。お使いの Tableau のバージョンに既に Connector が含まれている場合は、この手順をスキップしてください。Tableau にバンドルされているバージョンとは異なるバージョンを使用する場合は、この手順を完了してください。

Tableau Desktopの場合は、Tableauからコネクタをインストールすることもできます。Tableau ExchangeでMongoDB SQL interface by MongoDBを検索し、Install and restart Tableauをクリックします。

  1. MongoDBダウンロード センター から最新のTableau Connector tacoファイルをダウンロードします。

  2. 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 が最新バージョンを使用していることを確認します。

2

MongoDBデータベース接続情報を取得します。

接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。

  1. Go to プロジェクトのAtlas専有クラスターまたはフェデレーティッドデータベースインスタンス。

  2. [Connect] をクリックします。

  3. Atlas SQL Interface オプションを選択します。

  4. Tableau Connector[1]Select your driver ドロップダウンで [] オプションを選択します。

  5. ドロップダウンから [Tableau] を選択します。

  6. Database ドロップダウンから接続するデータベースを選択します。

  7. 接続文字列と接続パラメーターをコピーします。

    この情報を使用して、後のステップでTableauに接続します。

3

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

4

Connect メニューにGo。

5

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

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

6

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

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

7

認証方法を選択します。

ドロップダウンから Authentication Mechanism を選択します。

サポートされているすべての認証メカニズムの詳細については、 SQLインターフェイス認証 を参照してください。

  • Username: MongoDBユーザー名を入力します。

  • Password: MongoDBのパスワードを入力します。

8

[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 サーバー (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

このファイルをすべてのサーバーノードにコピーします。

ロギングを構成するには、次のプロパティをファイルに追加してください。

loglevel=INFOlogdir=<path-to-log-directory>

loglevel プロパティは、ドライバーログの冗長を設定します。冗長性が高い順に、OFF、SEVERE、WARNING、INFO、FINE、FINER の値を受け入れます。デフォルトは OFF です。

logdir プロパティは、ドライバーがログファイルを書き込み (write)するディレクトリを設定します。ディレクトリは既に存在している必要があります。logdir を省略するか、console に設定すると、ドライバーはファイルではなくコンソールにログを書き込み (write)ます。

重要

本番環境では、SEVERE ログレベルから開始してください。各レベルで大量の出力が追加されるため、問題を診断する必要がある場合にのみレベルを上げてください。FINER レベルでは、ドライバーは各結果セットの各セルのデータを検索するすべての呼び出しをログに記録します。

Tableau でのプロパティ ファイルについて詳しく学ぶには、Tableau ドキュメントを参照してください。

Power BIの接続

Power BI Connector for MongoDBを使用して、Atlas専有クラスター、Atlasフェデレーティッドデータベースインスタンス、またはセルフホストするEnterprise Advanced（EA）データベースをPower BIに接続します。

前提条件

  • 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に接続する方法を示しています。

1

Power BI Connector for MongoDBをダウンロードします。

  1. MongoDBダウンロード センター から最新の Power BI Connector pqxファイルをダウンロードします。

    注意

    Power BI Connector for MongoDBは、Power BI Desktop に付属します。お使いの Power BI Desktop のバージョンに既にMongoDB Atlas SQL コネクタがある場合は、この手順をスキップします。Power BI Desktop にバンドルされているバージョンとは異なるバージョンを使用する場合に、この手順を完了します。

  2. コネクタファイルを次のディレクトリパスに移動します。

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    このフォルダが存在しない場合は作成します。

2

MongoDBデータベース接続情報を取得します。

接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。

  1. Go to プロジェクトのAtlas専有クラスターまたはフェデレーティッドデータベースインスタンス。

  2. Connectボタンをクリックします。

  3. Atlas SQL Interface オプションを選択します。

  4. Power BI Connector[1]Select your driver ドロップダウンで [] オプションを選択します。

  5. 接続文字列をコピーします。

    この情報は、後のステップでPower BIに接続する際に使用します。

3

Power BI Desktop から接続します。

  1. Power BI Desktop を開きます。

  2. Home メニューから Get data を選択します。

  3. MongoDB Atlas SQL connector を見つけて選択します。

    1. 新しいconnectorを見つけるには、検索バーに mongo と入力します。

    2. MongoDB Atlas SQL を選択します。

    3. [Connect] をクリックします。

  4. URI とデータベース名を入力し、OK をクリックします。

    MongoDB URI は、前のステップでコピーした接続文字列です。

    Native query フィールドには、オプションで SQL クエリを入力できます。Power BI は、SQL クエリを直接のデータソースとして使用します。接続後に Power Query エディターで SQL クエリを追加または変更することもできます。

  5. Atlas User name と Password を入力し、Connect をクリックします。

    デフォルトでは、ユーザーはロールと接続URIで許可されているすべての名前空間にアクセスできます。カスタムロールを使用してアクセスを制限している場合は、Edit Userメニューでユーザーに追加の名前空間へのアクセス権を付与できます。より詳しく学ぶには、「データベースユーザーの設定」を参照してください。

    サポートされている他の認証メカニズムの詳細については、 SQLインターフェイス認証 を参照してください。

Direct Query

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

Direct Query は、標準の Import モード の代わりに使用でき、データベースに直接クエリを実行できます。これにより、最新のデータが保証されますが、結果が返されるまでに時間がかかる場合があります。

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

DBeaver の接続

MongoDB JDBC ドライバーを使用して、Atlas専有クラスター、Atlasフェデレーティッドデータベースインスタンス、または自己管理型の Enterprise Advanced (EA) 配置を DBeaver に接続します。

前提条件

手順

DBeaver から接続するには、次の手順に従います。

1

MongoDBデータベース接続情報を取得します。

接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。

  1. Go to プロジェクトのAtlas専有クラスターまたはフェデレーティッドデータベースインスタンス。

  2. Connectボタンをクリックします。

  3. Atlas SQL Interface オプションを選択します。

  4. JDBC Driver[1]Select your driver ドロップダウンで [] オプションを選択します。

  5. Database ドロップダウンから接続するデータベースを選択します。

  6. 接続文字列をコピーします。

    この情報は、後のステップでDBeaverに接続する際に使用します。

2

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

3

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

  1. DBeaver で、Database をクリックし、ドロップダウン メニューから Driver Manager を選択します。

  2. New をクリックすると Create new driver モーダルが開きます。

  3. Settingsタブで、次の情報を指定します。

    ドライバー名

    MongoSQL

    クラス名

    com.mongodb.jdbc.MongoDriver

  4. Libraries タブで、Add File をクリックし、JDBC ドライバー all.jar ファイルを追加します。

    [Find Class] をクリックします。

  5. OK をクリックします。Create new driver モーダルが閉じます。

4

データベース接続を作成します。

  1. DBeaver で、Database をクリックし、ドロップダウン メニューから New Database Connection を選択して、Connect to a database モーダルを開きます。

  2. データベースのリストから、前の手順で作成した MongoDB データベース ドライバーを選択します。

    MongoDB が表示されない場合は、モーダル内で All カテゴリを選択してください。

    [Next] をクリックします。

  3. Main タブで、次の情報を入力します。

    JDBC URL

    前のステップから取得された接続文字列。

    ユーザー名

    接続を許可されたMongoDBユーザー。

    パスワード

    MongoDBユーザーに関連付けられたパスワード

  4. Driver properties タブで、User Properties を展開します。次のキーと値のプロパティを追加します。

    database

    仮想データベースの名前。

    user

    接続する MongoDB ユーザー。前の手順で Username を入力した場合は不要です。

次のステップ

SQLツールをMongoDBデータベースに接続したら、データをクエリできるようになります。より多くを学ぶには、以下を参照してください。

注意

プライベートエンドポイントを使用して接続するには、「プライベートエンドポイントを使用したMongoDB SQLインターフェースへの接続」を参照してください。

戻る
ドライバーを設定する
次へ
クエリ
このページを評価

項目一覧