このページでは、 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 機能をテストして、サポートを確認します。
JDBC ドライバーをインストール
MongoDB JDBC ドライバーは、 Tableau 、DBeaver、DataGrid、および JDBC API を受け入れるその他のJavaアプリケーションを使用してデータベースに接続するために必要です。例えば、 Maven プロジェクトなどです。
JDBC ドライバーの互換性
MongoDB JDBC ドライバーは以下と互換性があります。
Windows x86_64
macOS x86_64 および macOS aarch64 アーキテクチャ
Linux x86_64 および Linux arm64 アーキテクチャ
安全な接続には OpenSSL 3.0 以上が必要です。
SCRAM-SHA-1、SCRAM-SHA-256、MONGODB-X509、AWSによるMongoDBパスワードレス認証 を使用して認証できます。
手順
MongoDB JDBC ドライバーをダウンロードします。
MongoDBダウンロード センター から最新の JDBC ドライバーをダウンロードします。
注意
JDBC ドライバーは、次の 2 つの jar 形式で利用できます。
mongodb-jdbc-<version>-all.jarには、ドライバーと必要なすべての依存関係が含まれています。Tableauおよび DBeaver に必要です。mongodb-jdbc-<version>.jarには、依存関係がバンドルされていないドライバーが含まれています。[] ツールに必要です。
ダウンロードしたパッケージの整合性を確認します。
MongoDB リリースチームは、特定の MongoDB パッケージが有効で、改変されていない MongoDB リリースであることを証明するために、すべてのソフトウェア パッケージにデジタル署名しています。 MongoDB は、各リリース ブランチに、 .asc形式の異なる PGP キーで署名します。
次のコマンドを実行して、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 次のコマンドを実行して、キー ファイルをダウンロードし、インポートします。
<serverUrl>を Maven でサポートされている現在の GPG キー サーバーの 1 つに置き換えます。keyserver.ubuntu.comkeys.openpgp.orgpgp.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 次のコマンドを実行して、 MongoDB JDBC ドライバーのインストールファイルを確認します。
<detachedSignatureFile>と<artifactToVerify>をダウンロードしたファイルの名前に置き換えます。gpg --verify <detachedSignatureFile> <artifactToVerify> たとえば、
mongodb-jdbc-2.2.3-all.jarとmongodb-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
Maven プロジェクトとの統合
Atlas Data Federation を使用する場合は、 MongoDB JDBC ドライバーを Mavenアプリケーションに接続できます。
Maven アプリケーションのドライバーを構成します。
Maven Central リポジトリ から依存関係スニペットをコピーします。依存関係スニペットのバージョン番号を、JDBC ドライバーのバージョンに合わせて編集します。
以下に例を挙げます。
<dependency> <groupId>org.mongodb</groupId> <artifactId>mongodb-jdbc</artifactId> <version>2.1.0</version> </dependency>
フェデレーティッドデータベースインスタンスに接続します。
フェデレーティッドデータベースインスタンスに接続するには、接続文字列を作成し、アプリケーションから接続を開きます。JDBC ドライバーの接続文字列は、jdbc: プレフィックスを除いて、標準のMongoDB接続文字列の形式に従います。
jdbc:mongodb://[username:password]@[host].a.query.mongodb.net/<databaseName>[?option1=value1[&option2=value2]...]
Atlas UI から接続文字列を取得するには、次の手順を実行します。
AtlasUI で、{0 ページに し、接続するフェデレーティッドデータベースインスタンスのGo Data FederationConnect[ ] をクリックします。
Access your data through tools で Atlas SQL を選択します。
[ Select your driverの下で、ドロップダウンから [ JDBC Driver ] を選択します。
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エンコードする必要があります。
ODBC ドライバーをインストール
Power BI、Excel、またはその他の ODBC サポート BI ツールを使用してデータベースに接続するには、 MongoDB ODBC ドライバーが必要です。
開始するには配置タイプを選択します。
次のステップ
BIツールに適切なドライバーをインストールしたら、BIツールをデータベースに接続します。