Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs Menu
Docs Home
/
Atlas
/ / /

Atlas BI Connector から MongoSQL への移行

MongoDB、 Atlas BI Connector から新しいSQL Interface に移行することを推奨しています。

注意

Atlas BI Connector とオンプレミスBI Connector は別々のツールです。このガイドでは、 MongoDBがフェーズアウトする Atlas BI Connector からの移行について説明します。

Atlas BI Connector と同様に、MongoSQL では、 Tableauや Power BIなどのさまざまなSQLベースのツールを使用して、Atlas クラスターのデータを分析できます。

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

  • Atlas Data Federation インフラストラクチャを使用して、Atlas クラスター以外のソースからデータを読み取ることができます。

  • スキーマを設定できます。

  • 使用した分だけ料金を支払います。サブスクライブは必要ありません。

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

MongoSQL の詳細については、 「 SQLインターフェイスによるクエリ 」を参照してください。

  • MongoSQL は読み取り専用です。

  • MongoSQL はSQL 92 のダイアレクトのみと互換性があります。他のSQL のダイアレクトはサポートされていません。

  • MongoSQL は Atlas Data Federation の機能であるため、すべての Atlas Data Federation の制限が適用されます。

MongoSQL では、Atlas Data Federation のクエリコストと AWS転送コストのみが発生します。 SQLインターフェイス自体は無料で使用できます。フェデレーティッドデータベースインスタンス のクエリのコストの詳細については、「 Data Federation のコスト 」を参照してください。

注意

MongoDB クエリによって発生したコストは、クエリしたフェデレーティッドデータベースインスタンスの下の請求書に「処理されたデータ」または「返されたデータおよび転送されたデータ」のいずれかとして表示されます。

Atlas BI Connector から MongoSQL に移行するには、配置が次の前提条件を満たしていることを確認してください。

さらに、MongoDB では、移行を計画するために、 移行準備状況レポートを生成することをお勧めします。

  • クエリ可能なデータを含むフェデレーティッドデータベースインスタンス。

  • フェデレーティッドデータベースインスタンスに接続する MongoDB database ユーザー。

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

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

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

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

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

1

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

2

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

chmod +x <executable-filename>
chmod +x <executable-filename>
chmod +x <executable-filename>
3

Atlas BI Connector ログを提供すると、準備状況レポート ツールは次の情報をレポートできるようになります。

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

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

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

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

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

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

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

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

4

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

クラスター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の宛先を指定できます。 停止しない場合、現在のディレクトリに生成されます。

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

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

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

<executable-filename> --help
Options:
-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

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

MongoSQL の基礎となるアーキテクチャは Atlas BI Connector とは異なるため、スキーマまたはクエリを調整する必要がある場合があります。

MongoSQL に移行するには、MongoSQL で失敗する既存の Atlas BI Connector クエリを識別し、それを修正するためにスキーマまたはその構文を更新します。

警告

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

1

MongoDB を有効にして使用する方法の詳細については、 「 SQLインターフェイスの有効化 」を参照してください。

2

MongoSQL との接続の詳細については、「 Atlas SQLインターフェイスを使用した接続 」を参照してください。

3

新しい MongoDB 接続でクエリをテストして、クエリが実行され、期待した結果が返されることを確認します。

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

4

MongoDB のスキーマの詳細については、「「 スキーマ管理 」を参照してください。

5

Atlas BI Connector から MongoSQL に移行するときに一部のクエリ構文を変更する必要がある場合があります。

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

次のMongoDBリソースは、MongoSQL 構成のトラブルシューティングに役立ちます。

戻る

SQLアクセスの有効化

項目一覧