Azure Cosmos DB for MongoDB 移行拡張機能は、MongoDB のワークロードを Azure Cosmos DB に移行するのに役立ちます。 この記事には、移行拡張機能についてよく寄せられる質問への回答が記載されています。
[検証の実行] 手順が失敗した場合に評価を実行するにはどうすればよいですか?
拡張機能に表示されるエラーを参照して、検証が失敗する理由を確認してください。 通常、問題点は MongoDB エンドポイントに接続できないことです。 また、この問題点は、評価を実行するために接続されたサーバーに対して十分な権限を持っていないユーザーである可能性もあります。
評価を実行するには、MongoDb に接続されているユーザーには、ソース インスタンスで readAnyDatabase と clusterMonitor のロールが割り当てられている必要があります。
現在接続されたユーザーに適切なロールを構成するために grantRolesToUser を使用します。
[機能の互換性] カテゴリで評価用のコレクション名とデータベース名を表示するには、どうすればよいですか？
評価では、serverStatus コマンドを使用して機能互換性評価を実行します。 このコマンドではデータベース名またはコレクション名の詳細が提供されないため、拡張機能ではリソース名をレポートできません。
より詳細な評価の情報を得るには、[ログ フォルダー パス] フィールドに、MongoDB プロファイラー ログが含まれているフォルダー パスに指定して、評価を再実行します。
ログ メッセージを収集するにはどうすればよいですか？
ログ ファイルはパス /var/log/mongodb/mongodb.log にあります。 ログ ファイルが見つからない場合は、MongoDB 構成ファイル内の場所を確認します。
詳細については、「MongoDB ログ メッセージ」を参照してください。
移行が開始されると、移行されたドキュメントの正確な数が表示されず、見積もりが与えられるのはなぜですか?
移行中のソースのリソース使用率を減らすために、拡張機能は、正確な数を取得するのではなく、ソースからターゲットに移動する各コレクション内のドキュメントの数を見積もります。
コレクション マッピング手順で一部のコレクションが見つからないか無効になっているのはなぜですか?
仮想コア ベースの Azure Cosmos DB for MongoDB は、時系列またはクラスター化コレクションをサポートしていません。 したがって、これらの種類のコレクションは、コレクション マッピング手順で見つからないか無効になります。
仮想コア ベースの Azure Cosmos DB for MongoDB でビューがサポートされている場合、コレクション マッピング手順でビューが見つからないか無効になっているのはなぜですか?
仮想コア ベースの Azure Cosmos DB for MongoDB では、新しいビューの作成がサポートされています。 ただし、移行拡張機能では、既存のビューの移行はサポートされていません。
移行が終了したら、いつでもビューを再作成できます。
移行後にターゲット アカウントでどの程度のストレージを使用する必要がありますか?
仮想コア ベースの Azure Cosmos DB for MongoDB では、ディスク上のデータは圧縮されません。 一般的な大まかな見積もりでは、ソース MongoDB インスタンスのコレクションによって消費されるストレージ サイズを 2 倍にして、ターゲットの仮想コア ベースの Azure Cosmos DB for MongoDB アカウント内のストレージを見積もります。
MongoDB から仮想コア ベースの Azure Cosmos DB for MongoDB に移行するときにスキップされるコレクションとデータベースはどれですか?
次のデータベースとコレクションは、MongoDB の内部と見なされます。
| リソース | |
|---|---|
| データベース | |
| コレクション | プレフィックス system を持つ任意のコレクション。 |
仮想コア ベースの Azure Cosmos DB for MongoDB では内部データベースとコレクションは必要ないため、拡張機能ではこれらのデータベースの移行は有効になりません。
名前が数字で始まるデータベースとコレクションを移行できますか?
これは既知の問題です。 移行では、名前が数字で始まるデータベースとコレクションはサポートされていません。
移行する複数のコレクションを選択した場合、それらは並列して移行されますか?
Azure Database Migration Service の各移行タスクには、移行用の 2 つのトレーニングが用意されています。 各トレーニングは、任意の時点で 1 つのコレクションを移行します。 そのため、通常、2 つのコレクションが並列して移行されます。 コレクションの移行が完了すると、次のコレクションが自動的に取得されます。 移行するコレクションが多数ある場合は、複数の移行タスクを作成します。 各タスクには、移行をより効率的にするために、スコープ指定された数のコレクションが必要です。
1 回の移行で移行できるデータベースとコレクションの数はいくつですか?
1 回の移行に含めることができるデータベースとコレクションの数に制限はありません。 ただし、選択したコレクションは、Azure Database Migration Service で移行タスクを作成するときに 50 のバッチに分割されます。 大量のコレクションについては、移行の一覧に複数の移行タスクが表示されます。
移行するコレクションの注文と数量を計画するにはどうすればよいですか?
移行する複数のコレクションを選択した場合、コレクションの移行順序は構成できません。 移行の順序を制御する場合は、目的のシーケンスに基づいて、より小さなバッチでコレクションを移行します。 最適なパフォーマンスを得る場合は、大きなコレクションと小さいコレクションをバッチで組み合わせないようにします。
接続の問題点を回避するために、仮想コア ベースの Azure Cosmos DB for MongoDB と MongoDB ファイアウォールを構成するにはどうすればよいですか?
仮想コア ベースの Azure Cosmos DB for MongoDB ターゲット アカウントにファイアウォールの例外を追加して、グローバル Azure データセンターからの接続を受け入れます。 詳細については、Azure Cosmos DB のファイアウォール構成に関する記事をご覧ください。
接続の問題を回避するためにソース サーバーファイアウォールを構成する方法
ソースの MongoDB インスタンスを構成して、グローバル Azure データセンターからの接続を許可します。 詳細については、「グローバル Azure の IP アドレスの範囲」を参照してください。
警告
この拡張機能では、プライベート エンドポイントが有効なソースまたはターゲットの MongoDB インスタンスはサポートされていません。 この拡張機能は、Azure Database Migration Service のセルフホステッド統合ランタイムをサポートしていません。
移行ジョブは自分のコンピューターでローカルに実行されますか?
データベース、コレクション、インデックスは、ローカルの Azure Data Studio クライアントからのコマンドを使用して直接作成されます。 この機能には、ソース環境とターゲット環境の両方で Azure Data Studio を実行しているクライアント間の接続が必要です。
データ移行タスクは、Azure Database Migration Service で実行されます。 移行サービスは、データ移動アクティビティを調整して実行する Azure サービス インスタンスです。 データ移行タスクが作成されたら、ソース環境とターゲット環境に接続する必要はありません。
同時に実行できる移行の数はいくつですか?
同時に作成できる移行の数に制限はありません。
移行中にデータベースとコレクションの名前の変更はできますか?
この拡張機能は、移行中のデータベースとコレクションの名前の変更をサポートしていません。
複数の移行イテレーションを使用してコレクションを移行できますか?
複数の移行ジョブを作成でき、それぞれにコレクションの数が限られています。 このアプローチは、移行の速度を最適化するためのベスト プラクティスです。
評価レポートには何が含まれていますか?
レポートの最初の部分には、ソース MongoDB 環境の概要など、評価の実行に関する重要な詳細が含まれています。 詳細には、ソース MongoDB のバージョン、ライセンスの種類、インスタンスの種類が含まれます。 また、この部分には評価されたデータベースとコレクションの一覧と、それぞれの評価の概要、および移行の準備状態が含まれています。
結果は、重大、警告、および情報のカテゴリにグループ化されます。 これらのカテゴリは、その重要度に従って結果に優先順位を付けるのに役立ちます。
評価チェックには次のものが含まれます。
| 説明 | |
|---|---|
| コレクション オプション | サポートされていないコレクション設定に関連する結果。 たとえば、時系列や照合順序などです。 |
| 機能 | 集計パイプライン クエリなど、サポートされていないデータベース コマンド、クエリ構文、または演算子に関連する結果。 追加の詳細列では、ソース エンドポイントで特定の機能が使用されていた頻度を確認できます。 |
| 制限とクォータ | 仮想コア ベースの Azure Cosmos DB for MongoDB 固有のクォータと制限に関連する結果。 |
| インデックス | サポートされていない MongoDB インデックスの種類またはプロパティに関連する結果。 |
| シャード キー | サポートされていないシャード キー構成に関連する結果。 |
拡張機能で作成されるログの種類は何ですか?
この拡張機能では、エラー、警告、その他の診断ログが既定のログ ディレクトリに格納されます。
- Windows -
C:\Users\<username>\.dmamongo\logs\ - Linux -
~/.dmamongo/logs - macOS -
/Users/<username>/.dmamongo/logs
Note
日ごとに個別のログ ファイルが作成されます。 既定では、この拡張機能によって、直近の 7 つのログ ファイルが格納されます。