Atlas BI Connector から Atlas SQL への移行
MongoDB では、 Atlas BI Connectorから新しいAtlas SQL Interface に移行することを推奨しています。
注意
Atlas BI Connector とオンプレミス BI Connector は別々のツールです。 このガイドでは、MongoDB がフェーズアウトする Atlas BI Connector からの移行について説明します。
Atlas SQL
Atlas BI Connector と同様に、Atlas SQL を使用すると、 Tableau や Power BI などのさまざまな SQL ベースのツールを使用して Atlas クラスターのデータを分析できます。
Atlas BI Connector と比較すると、Atlas SQL には次の利点があります。
Atlas Data Federation インフラストラクチャを使用して、Atlas クラスター以外のソースからデータを読み取ることができます。
スキーマを設定できます。
使用した分だけ料金を支払います。サブスクライブは必要ありません。
Tableau と Power BI ではカスタム MongoDB connector を使用できます。
Atlas SQL の詳細については、「 Atlas SQL によるクエリ 」を参照してください。
Atlas SQL の制限
Atlas SQL は読み取り専用です。
Atlas SQL は SQL 92のダイアレクトのみと互換性があります。他の SQL のダイアレクトはサポートされていません。
Atlas SQL は Atlas Data Federation の機能であるため、すべてのAtlas Data Federation の制限が適用されます。
Atlas SQLの価格
Atlas SQL 、 Atlas Data Federationのクエリコストと Amazon Web Servicesの転送コストのみが発生します。 Atlas SQL Interface 自体は無料で使用できます。 フェデレーティッドデータベースインスタンスのクエリにかかるコストの詳細については、「 Data Federation のコスト 」を参照してください。
注意
Atlas SQL クエリによって発生したコストは、クエリしたフェデレーティッドデータベースインスタンスの下の請求書に「処理されたデータ」または「返されたデータおよび転送されたデータ」のいずれかとして表示されます。
Atlas SQL への移行を準備する
Atlas BI Connector から Atlas SQL に移行するには、配置が次の前提条件を満たしていることを確認してください。
さらに、MongoDB では、移行を計画するために、 移行準備状況レポートを生成することをお勧めします。
前提条件
クエリ可能なデータを含むフェデレーティッドデータベースインスタンス。
フェデレーティッドデータベースインスタンスに接続する MongoDB database ユーザー。
移行準備状況レポートの生成
MongoDBは、Atlas BI Connector から Atlas SQL Interface への移行を計画するために、 Atlas SQL Transition 準備完了 ツールを提供します。 このツールは、過去の Atlas BI Connector の使用状況に基づいてレポートを生成し、リアルタイムのスキーマ分析と提案を提供し、Atlas SQLを使用して適切に実行するために構文の変更が必要なクエリを強調表示します。
レポートを生成するには、次の詳細の少なくとも 1 つを含むツールを提供する必要があります。
クエリ分析用の Atlas BI Connector ログ。
スキーマ分析用の クラスターURI 。
クエリ、スキーマ、またはその両方を分析できます。
(任意)Atlas BI Connector ログをダウンロードして解凍します。
Atlas BI Connector ログを提供すると、準備状況レポート ツールは次の情報をレポートできるようになります。
ボリュームや頻度などの過去のクエリ データ。
Atlas SQL では失敗するクエリ構文。
関係データベースでは不明なデータ型を持つコレクション フィールド。
Atlas BI Connector ログをダウンロードするには:
AtlasUIGo Atlasで、分析対象のBI 接続を持つ クラスターに します。
クラスターのオプション( )から Download Logsを選択します。
mongosql.gz
をダウンロードします。新しいディレクトリを作成し、
mongosql.gz
をそのディレクトリに解凍します。
(任意)クラスター URI をコピーします。
Atlas クラスターURIを指定すると、準備状況レポート ツールはコレクション スキーマを分析し、SQL ツールでは不明なデータ型を含むフィールドを識別できるようになります。
クラスターURIを見つけるには、次の手順に従います。
Atlas UI で、分析するコレクションを持つクラスターにGoします。
[Connect] をクリックします。
接続オプションのリストからShellを選択します。
接続URIのみをコピーします。
接続URIは次のようになります:
mongodb+srv://bicluster.example.mongodb.net/
。 shell 実行可能ファイル、mongosh
、および shell 固有のコマンドライン オプションを除外します。
レポートを生成します。
ターミナルで、 準備完了レポートツール 実行可能ファイルを実行し、ダウンロードしたログまたは クラスターURIを提供します。
データベースのユーザー名を含める必要があります。
--input
、--uri
、または両方を含める必要があります。 URIを含めると、準備状況レポート ツールによってデータベースユーザーのパスワードの入力を求められます。生成されたレポートの
--output
の宛先を指定できます。 停止しない場合、現在のディレクトリに生成されます。ネットワーク リクエストのDNSリゾルバを選択するには、
--resolver
を指定します。 指定できる値は、cloudflare
、google
、quad9
です。--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
準備完了レポート ツールを使用すると、出力が整理され、クリック可能なインデックスファイルが生成されるため、レポートを簡単に操作できます。
Atlas SQL への移行
Atlas SQL の基礎となるアーキテクチャは Atlas BI Connector とは異なるため、スキーマまたはクエリを調整する必要がある場合があります。
Atlas SQL に移行するには、Atlas SQL で失敗する既存の Atlas BI Connector クエリを識別し、それを修正するためにスキーマまたはその構文を更新します。
警告
MongoDB では、本番環境に変更を加える前に、サンドボックス環境で完全な移行プロセスをテストすることをお勧めします。 スキーマまたはクエリを変更せずに Atlas BI Connector から Atlas SQL に移行すると、重大な変更が発生する可能性があります。
フェデレーティッドデータベースインスタンスで Atlas SQL を有効にします。
Atlas SQL の有効化と Atlas SQL の使用の詳細については、 「 Atlas SQL インターフェイスの有効化 」を参照してください。
Atlas SQL Interface を使用してデータに接続します。
Atlas SQL との接続の詳細については、「 Atlas SQL インターフェイスを使用した接続 」を参照してください。
クエリをテストします。
新しい Atlas SQL 接続でクエリをテストして、クエリが実行され、期待した結果が返されることを確認します。
Atlas SQL によるクエリの詳細については、「 Atlas SQL ステートメントによるクエリ 」を参照してください。
スキーマを表示し、必要に応じて調整します。
Atlas SQL のスキーマの詳細については、「スキーマ管理 」を参照してください。
失敗するクエリを調整します。
Atlas BI Connector から Atlas SQL に移行するときに一部のクエリ構文を変更する必要がある場合があります。
Atlas SQL クエリ構文の詳細については、「 Atlas SQL 言語リファレンス 」を参照してください。
Atlas SQL のトラブルシューティング
次の MongoDB リソースは、Atlas SQL 構成のトラブルシューティングに役立ちます。