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

BI ConnectorからSQL Interfaceへの移行

このガイドでは、MongoDB Connector for BI と Atlas BI Connector の両方から、新しい SQL Interface に移行する方法について説明します。

重要

MongoDB Connector for BI と Atlas BI Connector は、2026 年 9 月にサポート終了(EOL)に達しました。

BI Connectorと同様に、SQL Interfaceを使用すると、TableauやPower BIなどのさまざまなSQLベースのツールを使用して、MongoDB配置のデータを分析できます。

BI Connectorと比較して、SQL Interfaceには次の利点があります。

  • フェデレーティッドデータベースインスタンスを必要とせずに、Atlas専有クラスターに直接接続できます。これは、ほとんどのAtlas接続で推奨されるパスです。

  • Atlasフェデレーティッドデータベースインスタンスを使用すると、Atlasクラスター以外のソースからデータを読み取ることができます。単一のクエリで複数のデータソースにまたがる必要がある場合は、このパスを使用します。

  • スキーマは個別に永続化されるため、SQLクエリ機能に影響を与えることなく更新できます。

  • Tableau と Power BI ではカスタム MongoDB connector を使用できます。

2つのAtlas接続パスを比較するには、「MongoDB SQL Interface 概要」を参照してください。

  • SQL Interfaceは読み取り専用アクセスを提供します。

  • MongoSQLのみがサポートされている方言です。MongoSQLはSQL-92と互換性があります。他のSQL方言はサポートされていません。

  • フェデレーティッドデータベースインスタンス経由で接続する場合、Atlas Data Federationの制限も適用されます。これらは、専有クラスターへの直接接続には適用されません。

BI Connector から SQL Interface に移行する前に、配置が移行先の前提条件を満たしていることを確認してください。さらに、MongoDB では、移行を計画するために、移行準備状況レポートを生成することをお勧めします。

前提条件は、移行先によって異なります。Atlasの移行先を比較するには、MongoDB SQL Interface 概要をご覧ください。

  • Atlas専有クラスター: 接続に使用するMongoDBデータベースユーザー。SQLインターフェースを有効にするには、Project Cluster ManagerまたはProject Replica Set Managerロールを持つAtlasユーザーも必要です。

  • Atlasフェデレーティッドデータベースインスタンス: クエリ可能なデータと、接続に使用するMongoDBデータベースユーザーを含むフェデレーティッドデータベースインスタンス。

  • 自己管理型のEnterprise Advanced (EA) 配置: 必要なデータベース権限を持つMongoDBデータベースユーザー。Atlasプロジェクトのロールは必要ありません。

MongoDBは、BI ConnectorからSQL Interfaceへの移行を計画するのに役立つMongoSQL Transition Readiness Toolを提供しています。このツールは、過去のBI Connectorの使用状況に基づいてレポートを生成し、リアルタイムのスキーマ分析と提案を提供します。また、MongoSQLを使用して適切に実行するために構文の変更が必要なクエリを強調表示します。

レポートを生成するには、次の詳細の少なくとも 1 つを含むツールを提供する必要があります。

  • BI Connector のログ、クエリ分析用。

  • スキーマ分析用の クラスターURI 。

クエリ、スキーマ、またはその両方を分析できます。

1

以下のオペレーティング システムのタブを選択し、実行可能ファイルをダウンロードします。

2

ファイルに実行権限がまだない場合は、付与します。

chmod +x <executable-filename>
3

BI Connectorのログを提供することで、Readiness Report Toolは以下の情報をレポートできるようになります。

  • ボリュームや頻度などの過去のクエリ データ。

  • MongoSQL では失敗するクエリ構文。

  • 関係データベースでは不明なデータ型を持つコレクション フィールド。

オンプレミスの BI Connector の場合、ログは mongosqld ログパスとして構成した場所にあります。

Atlas BI Connector ログをダウンロードするには:

  1. AtlasUIGo Atlasで、分析対象のBI 接続を持つ クラスターに します。

  2. クラスターのオプション( )からDownload Logsを選択します。

  3. mongosql.gzをダウンロードします。

  4. 新しいディレクトリを作成し、 mongosql.gzをそのディレクトリに解凍します。

4

Atlas クラスターURIを指定すると、準備状況レポート ツールはコレクション スキーマを分析し、SQL ツールでは不明なデータ型を含むフィールドを識別できるようになります。

AtlasクラスターのURIを見つけるには、次の手順に従います。

  1. Atlas UI で、分析するコレクションを持つクラスターにGoします。

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

  3. 接続オプションのリストからShellを選択します。

  4. 接続URIのみをコピーします。

    接続 URI は mongodb+srv://bicluster.example.mongodb.net/ のようになります。shell 実行可能ファイル mongosh と、shell 固有のコマンドラインオプションは除外してください。

5

ターミナルで、 準備完了レポートツール 実行可能ファイルを実行し、ダウンロードしたログまたは クラスターURIを提供します。

  • データベースのユーザー名を含める必要があります。

  • --input 、 --uri 、または両方を含める必要があります。 URIを含めると、準備状況レポート ツールによってデータベースユーザーのパスワードの入力を求められます。

  • 生成されたレポートの--outputの宛先を指定できます。 停止しない場合、現在のディレクトリに生成されます。

  • --resolver を指定して、ネットワークリクエストの DNS リゾルバーを選択できます。指定できる値は、cloudflare、google、quad9 です。

  • --includeまたは--excludeを使用して、名前空間のリストを絞り込むことができます。 グローバル構文がサポートされています。 デフォルトでは 、すべての名前空間が含まれます。

--helpオプションは、準備完了レポートツールのオプションの完全なリストを返します。

<executable-filename> --helpOptions: -i, --input <INPUT> Sets the input file or directory to analyze BIC logs (optional). One of `--input` or `--uri` must be provided, or both -o, --output <OUTPUT> Sets the output directory (optional). If not specified, the current directory is used --uri <URI> The Atlas cluster URI to analyze schema (optional). One of `--input` or `--uri` must be provided, or both -u, --username <USERNAME> Username for authentication (optional). This is required if the username and password is not provided in the URI --quiet Enables quiet mode for less output --resolver <RESOLVER> The specified resolver (optional) [possible values: cloudflare, google, quad9] --include <INCLUDE> A list of namespaces to include (optional). If not provided, all namespaces are included. Glob syntax is supported --exclude <EXCLUDE> A list of namespaces to exclude (optional). If not provided, no namespaces are excluded -h, --help Print help (see more with '--help') -V, --version Print version

準備完了レポート ツールを使用すると、出力が整理され、クリック可能なインデックスファイルが生成されるため、レポートを簡単に操作できます。

SQL Interface の基礎のアーキテクチャは BI Connector とは異なるため、スキーマまたはクエリを適応させる必要がある可能性があります。

SQL Interfaceに移行するには、MongoSQLで失敗する既存のBI Connectorクエリを特定し、スキーマまたは構文を更新して修正します。

警告

本番環境に変更を加える前に、サンドボックス環境で移行プロセス全体をテストすることをお勧めします。スキーマやクエリを調整せずにBI ConnectorからSQL Interfaceに移行すると、重大な変更が発生する可能性があります。

1

ほとんどのAtlas配置では、専有クラスターで直接SQLインターフェースを有効にします。これは推奨される移行先であり、フェデレーティッドデータベースインスタンスは必要ありません。単一のSQLクエリが複数のデータソースにまたがる必要がある場合は、代わりにフェデレーティッドデータベースインスタンスを使用してください。

SQLインターフェースの有効化と使用の詳細については、「SQLインターフェースサーバーの設定」を参照してください。

2

SQLインターフェースへの接続の詳細については、「SQLツールをMongoDBに接続する」を参照してください。

3

新しいSQL Interface接続でクエリをテストし、期待どおりに実行され、結果が返されることを確認します。

MongoDB でクエリを実行する方法について詳しくは、「 MongoDB ステートメントを使用したクエリ 」を参照してください。

4

SQLインターフェースのスキーマの詳細については、「スキーママネジメント」を参照してください。

5

BI ConnectorからSQL Interfaceに移行する際、一部のクエリ構文の変更が必要になる場合があります。

MongoDB クエリ構文の詳細については、MongoDB 言語リファレンス を参照してください。

SQL Interfaceの設定のトラブルシューティングには、以下のMongoDBリソースが役立ちます。