次の方法で共有

Azure Data Studio 用 Azure Cosmos DB for MongoDB 移行拡張機能 (プレビュー)

  • [アーティクル]

Azure Cosmos DB for MongoDB 移行拡張機能は、MongoDB のワークロードを Azure Cosmos DB に移行するのに役立ちます。 この拡張機能は、次のことに使用できます。

  • ワークロードに対してエンドツーエンドの評価を実行し、ワークロードを仮想コア ベースの Azure Cosmos DB for MongoDB に移行するために必要なアクションを確認できます。
  • 選択したデータベースとコレクションを使用して、仮想コア ベースの Azure Cosmos DB for MongoDB への移行操作を実行します。

重要

この拡張機能では現在、次のシナリオはサポートされていません。

  • ソースまたはターゲット アカウントがプライベート エンドポイントが有効になっている移行。
  • RU ベースの Azure Cosmos DB for MongoDB のオンラインとオフラインの移行オプション。

MongoDB 仮想コア用 API の代替ソリューションに関する詳細は、移行オプションを参照してください。

前提条件

準備

移行を開始する前に、実際にデータを動かす前の移行に関する計画と意思決定を前もって行いましょう。

サブスクリプションにリソース プロバイダー Microsoft.EdgeZones のサブスクリプションを登録する

Microsoft.DataMigration リソース プロバイダーがサブスクリプションに登録されていることを確認するには、次の手順に従います。

Azure portal:

  1. Azure portal にアクセスし、サブスクリプションに移動します。
  2. 左側のメニューで、[設定] の下にある [リソース プロバイダー] を選択します。
  3. 上部の検索ボックスで Microsoft.DataMigration を検索します。
  4. 登録されていない場合は、それを選択し、[登録] ボタンをクリックします。

Azure CLI:

  1. Azure Cloud Shell またはローカル ターミナルを開きます。
  2. リソース プロバイダーを登録する以下のコマンドを実行します。
az provider register --namespace Microsoft.DataMigration

PowerShell:

  1. Azure Cloud Shell またはローカル PowerShell を開きます。
  2. リソース プロバイダーを登録する以下のコマンドを実行します。
Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

拡張機能をインストールする

移行を開始する前に、Azure Data Studio に Azure Cosmos DB for MongoDB 移行用の拡張機能をインストールします。

  1. Azure Data Studio で拡張機能マネージャーを開きます。 拡張機能アイコンを選択するか、[表示] メニューの [拡張機能] を選択します。

  2. 検索バーの Cosmos を入力します。

  3. [Azure Cosmos DB Migration for MongoDB] 拡張機能を選択し、その詳細を表示します。

    Azure Cosmos DB for MongoDB 移行拡張機能のインストール ボタンを示すスクリーンショット。

  4. [インストール] を選択します。

拡張機能の設定を構成する

評価拡張機能をインストールしたら、拡張機能の一部の設定を構成できます。 この手順は省略可能です。 設定が明示的に構成されていない場合、拡張機能では既定の設定が使用されます。

  1. 拡張機能に移動し、[Azure Cosmos DB Migration for MongoDB] を選択して、[設定の管理] アイコンをクリックし、拡張機能の設定を選択します。

    拡張機能の設定での選択を示すスクリーンショット。

  2. この拡張機能の設定で Assessment path を指定して、評価メタデータが格納される場所を変更します。 空白のままにすると、既定の場所が使用されます。

MongoDB ソースに接続する

既存 MongoDB のソース インスタンスに初めて接続するには、拡張機能を使用します。 このセクションを開始する前に、ソースの接続資格情報を準備しておく必要があります。

  1. メニュー バーの接続アイコンに移動し、[新しい接続] を選択します。

    拡張機能の接続メニュー バーのスクリーンショット。

  2. [接続] ウィンドウで、次のフィールドに入力します。

    Value
    接続の種類 Azure Cosmos DB for MongoDB
    接続文字列/パラメーター 既存のソース MongoDB インスタンスの接続文字列またはパラメーターを使用します。
    サーバー グループ Default
    名前 (省略可能) この接続に一意の名前を指定します。

  3. [接続] を選択します。

  4. [接続] ウィンドウで、新しい接続のコンテキスト メニューを開きます。 次に、[管理] を選択します。

    [データベースの管理] 画面を示すスクリーンショット。

  5. [Azure Cosmos DB の移行] を選択 します。

    [データベースの移行評価] 画面のスクリーンショット。

評価を実行する

評価では、現在の MongoDB データ資産と使用率を調査します。 その後、評価機能により、Azure Cosmos DB for MongoDB にワークロードを移行する前に実行する必要があるアクションを特定するのに役立つ包括的なレポートが生成されます。

  1. [ダッシュボード] タブを見つけて移動します。次に、[データベースの評価と移行] を選択します。

    拡張機能の移行機能内の [ダッシュボード] タブのスクリーンショット。

  2. ウィザードを完了して拡張機能に詳細を入力し、評価を実行できるようにします。

    資格情報が検証される前の評価の詳細のスクリーンショット。

    1. [評価名] フィールドに、タイトルを入力します。

    2. [オファリング] ドロップダウンから、ターゲットの Azure Cosmos DB for MongoDB アカウントを選択します。

    3. MongoDB ログ へのパスを指定します。

      ヒント

      これは省略可能なフィールドですが、ログ パスを指定すると、コレクション レベルでより詳細な結果が得られます。 ログ フォルダーが指定されていない場合、ツールでは serverStatus コマンドの詳細を使用して評価が実行されます。

      serverStatus コマンドは、前回の再起動以降の機能の使用状況のみを返します。そのため、実際のワークロードを正確に反映している評価を取得するには、サーバーの前回の再起動から十分な時間が経過していることを確認する必要があります。

    4. データ評価ログへのパスを指定します。

      ヒント

      このフィールドは省略可能ですが、データ評価ログを提供すると、ワークロードに関するより詳細な分析情報が得られます。 これらのログは、データのスキャンと詳細ログの読み取りによって取得されます。 データ評価は、移行評価を開始する前に CLI として個別に実行され、結果の JSON がここで提供されます。 こちらで、データ評価 CLI をダウンロードします。

    5. [検証の実行] を選択して、評価の入力を検証します。

  3. 検証が成功したら、[評価の開始] を選択して評価を実行します。

    資格情報が検証された後の評価の詳細のスクリーンショット。

  4. ソース サーバーのサイズによっては、評価に数分かかります。 評価が完了するまで待ってから次に進みます。

    進行中の新しい評価のスクリーンショット。

  5. 評価が完了すると、評価レポートが作成されます。

    ソースとなる MongoDB インスタンスの新しい評価レポートのスクリーンショット。

  6. 評価レポートでインスタンス名を選択して、サーバー全体の問題の一覧を確認します。 特定のデータベースを選択すると、選択したデータベースにのみ適用される問題が表示されます。

    ソースとなる MongoDB インスタンスで選択されたデータベースの新しい評価レポートのスクリーンショット。

  7. [レポートのダウンロード] を選択して、ダウンロード可能な統合レポートを取得します。

  8. 評価レポートを調査して、Azure Cosmos DB for MongoDB でワークロードをシームレスに移行するために必要なアクションを特定します。 次の手順に進む前に、評価で報告されたすべての障害となっている問題に対応済みであることを確認します。 未解決の問題がある場合は、プロセスを終了し、後で処理することもできます。 問題が解決したら、戻って評価と移行プロセスを再開できます。

移行を実行する

次に、評価レポートを使用して、ソース MongoDB インスタンスからターゲットの仮想コア ベースの Azure Cosmos DB for MongoDB アカウントへのデータのオフライン移行を実行します。

  1. 評価レポート画面で、移行するデータベースを選択します (複数可)。 次に、 [次へ] を選択します。

    移行のために選択されたデータベースのスクリーンショット。

  2. サブスクリプションとリソース グループでフィルター処理して一覧を絞り込み、ターゲットの Azure Cosmos DB for MongoDB アカウントを選択します。 次に、アカウントに接続するために必要な接続資格情報を入力します。

    ターゲットの Azure Cosmos DB for MongoDB アカウントで選択していることを示すスクリーンショット。

  3. [接続のテスト] を選択して、Azure Cosmos DB for MongoDB アカウントの資格情報を検証します。 [次へ] を選択して、ソースからターゲットへのコレクションのマッピングに移動します。

  4. マッピングの一覧で、コレクションごとに [スキップ] または [移行] を選択します。 ターゲットに既に存在するコレクションは、自動的にアイコンでマークされ、既定では [スキップ] に設定されます。 [次へ] を選択肢、Azure Database Migration Service (DMS) を構成します。

    ソースからターゲットへのコレクションのマッピングのスクリーンショット。

    警告

    既存のコレクションを [移行] することを選択すると、コレクション全体が上書きされ、これによって失われたデータは回復できません。 このオプションを選択するときは注意が必要です。

  5. ドロップダウンから既存の Azure Database Migration Service インスタンスを選択するか、[新規作成] を選択して新しい移行サービスを作成します。 Azure Database Migration Service は、ローカル リソースに依存するのではなく、データ転送にクラウド インフラストラクチャを使用して Azure データ プラットフォームとの間でデータを移行するサービスです。

    移行サービスを選択するオプションのスクリーンショット。

  6. ユース ケースに対して最適な移行モードを選択します。

    • オンライン移行はコレクション データをコピーし、プロセス中に更新プログラムも確実にレプリケートされるようにします。 このメソッドは、ダウンタイムを最小限に抑え、ビジネス継続性のための継続的な運用を可能にするという利点があります。 進行中の操作が重要であり、ダウンタイムの削減が優先される場合は、このオプションを使用します。
    • オフライン移行は、最初にデータベースのスナップショットをキャプチャし、より簡単で予測可能なアプローチを提供します。 データベースの静的コピーを使用しても問題なく機能し、リアルタイムの更新は必須ではありません。

  7. [次へ] を選択肢て移行の概要を表示します。 詳細を確認して確認したら、[スキーマの作成] を選択してターゲット アカウントにリソースを作成します。

    移行の概要を表示するオプションのスクリーンショット。

  8. 選択した移行サービスを使用してデータ転送を開始するには、[移行の開始] を選択します。

    移行サービスを使用して移行を開始するオプションのスクリーンショット。

  9. [設定の確認] のポップアップで、ファイアウォール設定が要件を満たしていることを確認します。 OK を選択して確認します。

    ファイアウォール設定を確認するための [設定の確認] ポップアップのスクリーンショット。

データ移行タスクは Azure Database Migration Service で実行されるため、データ移行中にソース環境とターゲット環境に接続する必要はありません。 ダッシュボードの状態は頻繁に更新される

Note

移行対象として 50 を超えるコレクションを選択した場合、移行ジョブは移行サービス上の複数のジョブにバッチ処理され、それぞれには最大 50 個のコレクションが含まれます。

  1. ジョブが初期化されたら、ダッシュボード ページで移行の状態を監視します。

    移行の状態を示すダッシュボードのスクリーンショット。

  2. 詳細を表示するには、移行の一覧から特定の移行を選択します。

オフライン移行の監視

すべてのデータ移行タスクが完了すると、状態が自動更新されます。

移行の状態を示すコレクションのスクリーンショット。

ソースからターゲットにデータが正常にコピーされると、オフライン移行の状態は成功を示します。

移行状態の成功を示すスクリーンショット。

  • アプリケーションの接続文字列を、ターゲット アカウントを示すように変更します。

オンライン移行の監視

オンライン移行は、オフライン移行とは異なり、自動的には完了しません。 代わりに、[一括移行] を選択して手動で終了するまで、継続的に実行されます。

オンライン移行の状態のスクリーンショット。

オンライン移行を完了するには、指定された順序で次の手順に従います。

  1. [一括移行] ボタンは、すべてのコレクションの初期データ読み込みが完了すると有効になります。 移行は現在レプリケーション フェーズ中であり、ソース インスタンスからターゲット インスタンスに更新プログラムを継続的にコピーし、最新の変更を最新の状態に保ちます。

  2. 移行のカットオーバーを実行する準備ができたら、移行するソース コレクションへのすべての受信トランザクションを停止します。

  3. テーブル内のレプリケーションの変更を監視し、'Replication Changes Played' メトリックが安定するまで待ちます。 安定した "Replication Changes Played" メトリックは、ソースからのすべての更新がターゲットに正常にコピーされたことを示します。

  4. すべてのコレクションのレプリケーション ギャップが最小限で、'Replication Changes Played' メトリックが安定している場合は、[一括移行] を選択します。

  5. ソース コレクションとターゲット コレクションの間で行数が同じであることを手動で検証します。

  6. ポップアップ ダイアログ内。 [一括移行を完了] を選択します。
    オンライン移行の一括移行の ポップアップのスクリーンショット。

    Note

    ソースとターゲットが同期されていることを検証せずに一括移行操作を実行すると、データが失われる可能性があります。

  7. 状態が「成功」に変わるまで待ちます。

  8. ターゲット アカウントを指すように、アプリケーションの接続文字列を更新します。

過去の移行と評価を表示する

多くの場合、過去の評価と移行を確認すると便利です。 拡張機能は、過去の評価と移行の概要を確認するためのインターフェイスを提供します。 拡張機能には、詳細な過去の評価レポートを確認する機能も用意されています。

  1. 過去の移行を表示するには、ツール バーの [移行] タブを選択します。 移行の一覧には、現在のコンピューターで開始されたすべての移行が含まれています。 一覧で特定の移行を選択すると、詳細を取得できます。

    拡張機能を使用して作成されたすべての移行の一覧のスクリーンショット。

  2. 過去の評価を表示するには、ツール バーの [評価] タブを選択します。 評価の一覧には、現在のコンピューターで開始されたすべての評価が含まれています。

    拡張機能を使用して実行されたすべての評価の一覧のスクリーンショット。

次のステップ

Azure Cosmos DB Migration for MongoDB 移行拡張機能に関する FAQ を確認する