Learn the "why" behind slow queries and how to fix them in our 2-Part Webinar.
Register now >
Docs Menu
Docs Home
/ /

SQLドライバーの設定

このページでは、 BIツールを Atlas または自己管理型の Enterprise Advanced(EA)データベースに接続するために、 MongoDB JDBC または ODBC ドライバーをインストールして構成する方法について説明します。

BIツールに適したドライバーを見つけるには、以下の表を参照してください。

ドライバー
BI ツール

JDBC ドライバー

Tableau Desktop または サーバー またはその他の JDBC でサポートされているツール(例: DBeaver、DataGrip、Mavenプロジェクト )。

ODBC ドライバー

Power BI Desktop または Excel などのその他の ODBC サポート ツール。

注意

MongoDB officially supports Tableau (Desktop または サーバー)および Power BI Desktop (Desktop および Service)を、その JDBC ドライバーと ODBC ドライバーで公式にサポートしています。JDBC ドライバーと ODBC ドライバーは他のSQL-92 BIツールでも使用できますが、 MongoDB は互換性を保証できません。特定のSQL Interface 機能をテストして、サポートを確認します。

MongoDB JDBC ドライバーは、 Tableau 、DBeaver、DataGrid、および JDBC API を受け入れるその他のJavaアプリケーションを使用してデータベースに接続するために必要です。例えば、 Maven プロジェクトなどです。

  • MongoDB JDBC ドライバーは以下と互換性があります。

    • Windows x86_64

    • macOS x86_64 および macOS aarch64 アーキテクチャ

    • Linux x86_64 および Linux arm64 アーキテクチャ

  • 安全な接続には OpenSSL 3.0 以上が必要です。

  • SCRAM-SHA-1、SCRAM-SHA-256MONGODB-X509AWSによるMongoDBパスワードレス認証 を使用して認証できます。

1

MongoDBダウンロード センター から最新の JDBC ドライバーをダウンロードします。

注意

JDBC ドライバーは、次の 2 つの jar 形式で利用できます。

  • mongodb-jdbc-<version>-all.jar には、ドライバーと必要なすべての依存関係が含まれています。Tableauおよび DBeaver に必要です。

  • mongodb-jdbc-<version>.jar には、依存関係がバンドルされていないドライバーが含まれています。[] ツールに必要です。

2

jarファイルをBIツールの適切なディレクトリにコピーします。例、 Tableau用の JDBC ドライバーをインストールしている場合は、次のようになります。

  • Windows: C:\Program Files\Tableau\Drivers

  • macOS: ~/Library/Tableau/Drivers

  • Linux: /opt/tableau/tableau_driver/jdbc

3

MongoDB リリースチームは、特定の MongoDB パッケージが有効で、改変されていない MongoDB リリースであることを証明するために、すべてのソフトウェア パッケージにデジタル署名しています。 MongoDB は、各リリース ブランチに、 .asc形式の異なる PGP キーで署名します。

  1. 次のコマンドを実行して、Maven Central Repository から .ascファイルをダウンロードします。<versionNumber> をダウンロードしたドライバーのバージョンに置き換え、<artifactToVerify> をダウンロードしたファイルの名前に置き換えます。

    curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/<versionNumber>/<artifactToVerify>.asc

    たとえば、mongodb-jdbc-2.2.3-all.jar をダウンロードした場合は、次のコマンドを実行します。

    curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.2.3/mongodb-jdbc-2.2.3-all.jar.asc
  2. 次のコマンドを実行して、キー ファイルをダウンロードし、インポートします。 <serverUrl>を Maven でサポートされている現在の GPG キー サーバーの 1 つに置き換えます。

    • keyserver.ubuntu.com

    • keys.openpgp.org

    • pgp.mit.edu

    gpg --keyserver <serverUrl> --recv-keys BDDC8671F1BE6F4D5464096624A4A8409351E954
    gpg: key BDDC8671F1BE6F4D5464096624A4A8409351E954: public key "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>" imported
    gpg: Total number processed: 1
    gpg: imported: 1
  3. 次のコマンドを実行して、 MongoDB JDBC ドライバーのインストールファイルを確認します。<detachedSignatureFile><artifactToVerify> をダウンロードしたファイルの名前に置き換えます。

    gpg --verify <detachedSignatureFile> <artifactToVerify>

    たとえば、mongodb-jdbc-2.2.3-all.jarmongodb-jdbc-2.2.3-all.jar.asc を現在のディレクトリに保存した場合は、次のコマンドを実行します。

    gpg --verify mongodb-jdbc-2.2.3-all.jar.asc mongodb-jdbc-2.2.3-all.jar

    GPG は次のような応答を返す必要があります。

    gpg: Signature made Wed May 22 13:24:36 2024 MDT
    gpg: using RSA key BDDC8671F1BE6F4D5464096624A4A8409351E954
    gpg: Good signature from "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>"

    パッケージが適切に署名されているが、ローカルtrustdbの署名キーをまだ信頼していない場合、 gpgは次のメッセージも返します。

    gpg: WARNING: This key is not certified with a trusted signature!
    gpg: There is no indication that the signature belongs to the owner.
    Primary key fingerprint: D2C4 5B7E 66A5 DCA1 8B76 57A8 91A2 1577 3066 6110

    次のエラー メッセージが表示される場合は、正しい公開キーをインポートしたことを確認してください。

    gpg: Can't check signature: public key not found

Atlas Data Federation を使用する場合は、 MongoDB JDBC ドライバーを Mavenアプリケーションに接続できます。

1

Maven Central リポジトリ から依存関係スニペットをコピーします。依存関係スニペットのバージョン番号を、JDBC ドライバーのバージョンに合わせて編集します。

以下に例を挙げます。

<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongodb-jdbc</artifactId>
<version>2.1.0</version>
</dependency>
2

プロジェクトの pom.xml ファイルで、次のようにスニペットを依存関係リストに貼り付けます。

<dependencies>
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongodb-jdbc</artifactId>
<version>2.1.0</version>
</dependency>
</dependencies>
3

フェデレーティッドデータベースインスタンスに接続するには、接続文字列を作成し、アプリケーションから接続を開きます。JDBC ドライバーの接続文字列は、jdbc: プレフィックスを除いて、標準のMongoDB接続文字列の形式に従います。

jdbc:mongodb://[username:password]@[host].a.query.mongodb.net/<databaseName>[?option1=value1[&option2=value2]...]

Atlas UI から接続文字列を取得するには、次の手順を実行します。

  1. AtlasUI で、{0 ページに し、接続するフェデレーティッドデータベースインスタンスのGo Data FederationConnect[ ] をクリックします。

  2. Access your data through toolsAtlas SQL を選択します。

  3. [ Select your driverの下で、ドロップダウンから [ JDBC Driver ] を選択します。

  4. Get Connection String[0}] で、接続するデータベースを選択し、接続文字列をコピーします。

次の例は、接続を開く方法を示しています。接続文字列に加えて、 Propertiesオブジェクト パラメーターを通じて使用するデータベースも指定する必要があります。詳細については、「 接続文字列接続プロパティ」を参照してください。

java.util.Properties p = new java.util.Properties();
p.setProperty("database", "<databaseName>");
Connection conn = DriverManager.getConnection("<connectionString>", p);

注意

ドライバーは Atlas にのみ接続でき、フェデレーティッドデータベースインスタンスには接続できません。JDBC ドライバーの接続文字列内の特殊文字は、URLエンコードする必要があります。

Power BI、Excel、またはその他の ODBC サポート BI ツールを使用してデータベースに接続するには、 MongoDB ODBC ドライバーが必要です。

開始するには配置タイプを選択します。

BIツールに適切なドライバーをインストールしたら、BIツールをデータベースに接続します。

戻る

サーバーを設定する

項目一覧