シャードクラスターの一方向同期 - ApsaraDB for MongoDB - Alibaba Cloud ドキュメントセンター

Data Transmission Service (DTS) を使用すると、MongoDB シャードクラスターからレプリカセットまたはシャードクラスターにデータを同期できます。このトピックでは、ApsaraDB for MongoDB インスタンス間でデータを同期する方法について説明します。

前提条件

ターゲットの ApsaraDB for MongoDB インスタンス (レプリカセットまたはシャードクラスター) を作成します。詳細については、「レプリカセットインスタンスの作成」または「シャードクラスターインスタンスの作成」をご参照ください。
重要
- ターゲットの ApsaraDB for MongoDB インスタンスのストレージ容量は、ソースの ApsaraDB for MongoDB インスタンスよりも 10% 以上大きくする必要があります。
- サポートされているバージョンについては、「データ同期シナリオ」をご参照ください。
ソースの ApsaraDB for MongoDB シャードクラスターインスタンスの場合、各シャードノードのエンドポイントを申請し、すべてのシャードノードが同じアカウントとパスワードを使用するようにします。詳細については、「シャードエンドポイントの申請」をご参照ください。
ターゲットがシャードクラスターインスタンスの場合、ターゲットの ApsaraDB for MongoDB (シャードクラスター) インスタンスでシャーディングするデータベースとコレクションを作成し、データシャーディングを設定し、バランサーを有効にし、ビジネス要件に基づいて事前シャーディングを実行する必要があります。詳細については、「シャーディングを設定してシャードのパフォーマンスを最大化する」および「シャード化された MongoDB クラスターでのデータ分散の不均衡に対処する方法」をご参照ください。
説明
- データシャーディングを設定すると、すべてのデータが単一のシャードに同期されるのを防ぎ、パフォーマンスのボトルネックを回避できます。バランサーを有効にして事前シャーディングを実行すると、データスキューを防ぐのに役立ちます。
- このトピックでは、購入前に DTS タスクを設定する例を示します。このシナリオでは、ソースの ApsaraDB for MongoDB (シャードクラスター) インスタンスのシャード数を指定する必要はありません。
  
  DTS タスクを設定する前に購入する場合は、購入時に正しいシャード数を指定する必要があります。

注意事項

タイプ	説明
ソースデータベースとターゲットデータベースの制限	帯域幅要件：ソースデータベースが存在するサーバーには、十分なアウトバウンド帯域幅が必要です。そうでない場合、同期速度に影響が出る可能性があります。同期するコレクションには、プライマリキーまたは UNIQUE 制約が必要であり、フィールド値は一意である必要があります。そうでない場合、ターゲットデータベースに重複データが表示される可能性があります。データのフィールド名に「.」(ドット) 文字を含めることはできません。含めると、データの不整合が発生する可能性があります。同期するコレクションの _id フィールドには、一意の値が必要です。そうでない場合、データの不整合が発生する可能性があります。コレクションレベルで同期し、オブジェクトを編集 (コレクション名の変更など) する必要がある場合、1 つの同期タスクでサポートされるコレクションは最大 1,000 です。この制限を超えると、送信後にタスクがエラーで失敗します。これを解決するには、コレクションをバッチに分割し、複数のタスクを設定します。または、データベース全体の同期タスクを設定します。ソースデータベース内の単一のドキュメントは 16 MB を超えることはできません。超えた場合、タスクは失敗します。ソースデータベースは Azure Cosmos DB for MongoDB または Amazon DocumentDB (エラスティッククラスター) であってはなりません。ソースデータベースは Oplog を有効にし、Oplog を少なくとも 7 日間保持する必要があります。または、Change Streams を有効にし、DTS が Change Streams を通じて過去 7 日間のデータ変更をサブスクライブできるようにする必要があります。そうでない場合、DTS はデータ変更をキャプチャできず、タスクの失敗を引き起こす可能性があります。極端な場合、これによりデータの不整合や損失が発生する可能性があります。これらの問題は、DTS のサービスレベルアグリーメント (SLA) の対象外です。重要データ変更をキャプチャするには、Oplog を使用することを推奨します。 Change Streams は MongoDB 4.0 以降でのみサポートされます。Change Streams は双方向同期をサポートしていません。ソースデータベースが Amazon DocumentDB (非エラスティッククラスター) の場合は、手動で Change Streams を有効にします。タスクを設定する際、移行方法を ChangeStream に、アーキテクチャをシャードクラスターに設定します。 DTS が増分同期に Oplog を使用する場合、ソースの MongoDB シャードクラスターのシャード数のスケーリングはサポートされていません。そうしないと、DTS タスクが失敗し、データの不整合が発生する可能性があります。ソースインスタンスが自主管理 MongoDB シャードクラスターの場合：アクセス方法は、 Express Connect、VPN Gateway、または Smart Access Gateway および Cloud Enterprise Network (CEN) のみをサポートします。 MongoDB のバージョンが 8.0 以降で、移行方法が Oplog の場合、同期タスクで使用されるシャードアカウントに `directShardOperations` 権限があることを確認してください。この権限は、コマンド `db.adminCommand({ grantRolesToUser: "username", roles: [{ role: "directShardOperations", db: "admin"}]})` を使用して追加します。説明コマンド内の `username` を、同期タスクで使用されるシャードアカウントに置き換えてください。移行方法が Oplog で、タスクに完全データ同期が含まれる場合、ソース MongoDB シャードクラスターの Mongos アカウントに `db.runCommand({"balancerStatus":1})` コマンドを実行する権限があることを確認してください。DTS は、事前チェック中にこのコマンドを使用してバランサーが無効になっているかどうかを確認します。ソース MongoDB シャードクラスターインスタンスの Mongos ノードの数は 10 を超えることはできません。同期するコレクションに TTL インデックスが含まれている場合、データの不整合や遅延が発生する可能性があります。ソースインスタンスとターゲットインスタンスに孤立ドキュメントが存在しないことを確認してください。存在する場合、データの不整合やタスクの失敗が発生する可能性があります。詳細については、「孤立ドキュメント」および「MongoDB (シャードクラスターアーキテクチャ) で孤立ドキュメントをクリーンアップする方法」をご参照ください。ソースデータベースの操作制限：スキーマ同期および完全データ同期中は、データベースまたはコレクションのスキーマ (配列型データの更新を含む) を変更しないでください。変更すると、同期タスクが失敗したり、ソースデータベースとターゲットデータベース間でデータの不整合が発生したりする可能性があります。完全データ同期のみを実行する場合は、ソースインスタンスに新しいデータを書き込まないでください。書き込むと、ソースデータベースとターゲットデータベース間でデータの不整合が発生する可能性があります。同期インスタンスの実行中は、ソースデータベースの同期対象オブジェクトでデータ分散を変更するコマンド (shardCollection、reshardCollection、unshardCollection、moveCollection、movePrimary など) を実行しないでください。実行すると、データの不整合が発生する可能性があります。ソースデータベースのバランサーがデータを分散する場合、遅延が発生する可能性があります。 DTS は SRV アドレスを使用した MongoDB データベースへの接続をサポートしていません。ソースデータベースが MongoDB 5.0 以降で、ターゲットデータベースのバージョンが 5.0 より前の場合、`capped collection` を同期することはできません。同期しようとすると、タスクが失敗するか、ソースデータベースとターゲットデータベース間でデータの不整合が発生します。これは、MongoDB 5.0 以降、`capped collection` の動作が変更され、明示的な削除や更新時のドキュメントサイズの増加などの操作が許可されるようになったためであり、以前のバージョンのデータベースカーネルではこれらの新機能をサポートできないためです。
その他の制限	タスクを開始する前に、ターゲットで使用されるシャードキーをソースのデータに追加します。タスクを開始した後、同期するデータの INSERT 文にはシャードキーを含める必要があります。UPDATE 文はシャードキーを変更できません。ソースデータベースとターゲットデータベースには同じ MongoDB バージョンを使用することを推奨します。または、互換性を確保するためにターゲットに新しいバージョンを使用します。新しいバージョンから古いバージョンへの同期は、互換性の問題を引き起こす可能性があります。 DTS は、admin、config、および local データベースからのデータ同期をサポートしていません。トランザクション情報は保持されません。ソースデータベースのトランザクションは、ターゲットデータベースでは個別のレコードになります。 DTS がターゲットコレクションにデータを書き込む際に、プライマリキーまたは一意キーの競合が発生した場合、DTS は書き込みステートメントをスキップし、ターゲットコレクションの既存のデータを保持します。ソース MongoDB のバージョンが 3.6 より前で、ターゲット MongoDB のバージョンが 3.6 以降の場合、実行計画の違いにより、同期されたデータのフィールドの順序が一致しない場合があります。フィールドと値の関係は変わりません。ビジネスでネストされた構造に対してテキストマッチングクエリを使用している場合は、フィールドの順序が一致しないことによる影響を評価してください。同期前に、ソースデータベースとターゲットデータベースの両方のパフォーマンスを評価してください。同期はオフピーク時間に実行してください。そうしないと、完全データ初期化によって読み取りおよび書き込みリソースが消費され、データベースの負荷が増加します。完全初期化は INSERT 操作を同時に実行します。これにより、ターゲットデータベースのコレクションに断片化が生じます。完全初期化後、ターゲットインスタンスのコレクションスペースはソースインスタンスよりも大きくなります。ターゲットコレクションに一意なインデックスがあるか、その `capped` プロパティが `true` に設定されている場合、増分同期中の同時リプレイはサポートされません。シングルスレッド書き込みのみが許可されます。これにより、タスクのレイテンシが増加する可能性があります。 DTS はデータを同時に書き込むため、ターゲットが使用するストレージ容量はソースより 5% から 10% 大きくなります。ターゲット MongoDB のドキュメント数を取得するには、構文 `db.$table_name.aggregate([{ $count:"myCount"}])` を使用します。ターゲット MongoDB にソースと同じプライマリキー (デフォルトは _id) がないことを確認してください。そうでない場合、データ損失が発生する可能性があります。ターゲットに同じプライマリキーがある場合は、ビジネスに影響を与えずにターゲットの関連データをクリアしてください (ターゲットで同じ _id 値を持つドキュメントを削除します)。完全同期中は、ソース MongoDB データベースのバランサーを無効にしてください。すべてのサブタスクが増分フェーズに達するまで無効のままにしてください。そうしないと、データの不整合が発生する可能性があります。バランサーの管理の詳細については、「MongoDB バランサーの管理」をご参照ください。 DTS が提供するスキーマ同期機能が不要な場合 (たとえば、データパーティショニングがすでに送信先で設定されている場合など) は、オブジェクト設定を選択せず、同期タイプとスキーマ同期を選択しないでください。そうしないと、シャーディングの競合によりデータの不整合やタスクの失敗につながる可能性があります。トラフィックをターゲット MongoDB データベースに切り替える場合は、ビジネスの動作が MongoDB のシャードコレクションの要件を満たしていることを確認してください。 DTS は、MongoDB 5.0 以降で導入された時系列コレクションの同期をサポートしていません。タスクが失敗した場合、DTS サポートスタッフは 8 時間以内に復旧を試みます。復旧中、タスクを再起動したり、パラメーターを調整したりすることがあります。説明変更されるのは DTS タスクのパラメーターのみで、データベースのパラメーターは変更されません。調整される可能性のあるパラメーターには、「インスタンスパラメーターの変更」に記載されているものが含まれます。

課金

同期タイプ	料金
スキーマ同期と完全データ同期	無料です。
増分データ同期	課金対象です。詳細については、「課金概要」をご参照ください。

一方向同期トポロジ

DTS は、2 つの ApsaraDB for MongoDB シャードクラスターインスタンス間の一方向データ同期のみをサポートします。複数の ApsaraDB for MongoDB インスタンス間の同期はサポートされていません。

同期タイプ

タイプ	説明
スキーマ同期	ソース ApsaraDB for MongoDB の同期オブジェクトのスキーマをターゲット ApsaraDB for MongoDB に同期します。
完全データ同期	ソース ApsaraDB for MongoDB の同期オブジェクトのすべての既存データを、送信先の ApsaraDB for MongoDB に同期します。説明完全データ同期は、データベースとコレクションでサポートされています。
増分データ同期	完全データ同期に基づいて、ソース ApsaraDB for MongoDB からの増分更新がターゲット ApsaraDB for MongoDB に同期されます。 Oplog 増分データ同期では、タスク開始後に作成されたデータベースはレプリケートされません。以下の変更がレプリケートされます： CREATE COLLECTION および CREATE INDEX DROP DATABASE、DROP COLLECTION、および DROP INDEX RENAME COLLECTION 説明 `dropTarget` オプションが `true` に設定されている場合、RENAME COLLECTION 操作はレプリケートされません。コレクション内のドキュメントの挿入、更新、削除。説明ドキュメントの更新については、`$set` コマンドを使用する操作のみをレプリケートします。 Change stream 以下の変更がレプリケートされます： DROP DATABASE および DROP COLLECTION RENAME COLLECTION 説明 `dropTarget` オプションが `true` に設定されている場合、RENAME COLLECTION 操作はレプリケートされません。コレクション内のドキュメントの挿入、更新、削除。説明ドキュメントの更新については、`$set` コマンドを使用する操作のみをレプリケートします。

孤立ドキュメントのクリーンアップ

データを移行する前に、ソース MongoDB データベースから孤立ドキュメントをクリーンアップします。

重要

孤立ドキュメントのクリーンアップを怠ると、移行性能に影響を与え、_id の競合によるデータ移行エラーを引き起こす可能性があります。

ApsaraDB for MongoDB

説明

メジャーバージョンが MongoDB 4.2 より前、またはマイナーバージョンが 4.0.6 より前のインスタンスでクリーンアップスクリプトを実行すると、エラーが発生します。インスタンスの現在のバージョンを表示するには、「MongoDB マイナーバージョン」をご参照ください。メジャーまたはマイナーバージョンをアップグレードするには、「データベースのメジャーバージョンのアップグレード」および「データベースのマイナーバージョンのアップグレード」をご参照ください。

cleanupOrphaned コマンドを使用して孤立ドキュメントをクリーンアップします。手順は MongoDB 4.4 以降と MongoDB 4.2 以前で若干異なります。

MongoDB 4.4 以降

シャードクラスターインスタンスに接続できるサーバーで、cleanupOrphaned.js という名前の JavaScript (JS) スクリプトを作成します。

説明

このスクリプトは、複数のシャードにまたがる複数のデータベースのすべてのコレクションから孤立ドキュメントをクリーンアップします。特定のコレクションから孤立ドキュメントをクリーンアップする必要がある場合は、JS スクリプトを変更できます。

// シャード名のリスト
var shardNames = ["shardName1", "shardName2"];
// データベースのリスト
var databasesToProcess = ["database1", "database2", "database3"];
shardNames.forEach(function(shardName) {
    // 指定されたデータベースのリストを反復処理します
    databasesToProcess.forEach(function(dbName) {
        var dbInstance = db.getSiblingDB(dbName);
        // データベースインスタンス内のすべてのコレクションの名前を取得します
        var collectionNames = dbInstance.getCollectionNames();
        // 各コレクションを反復処理します
        collectionNames.forEach(function(collectionName) {
            // 完全なコレクション名
            var fullCollectionName = dbName + "." + collectionName;
            // cleanupOrphaned コマンドを構築します
            var command = {
                runCommandOnShard: shardName,
                command: { cleanupOrphaned: fullCollectionName }
            };
            // コマンドを実行します
            var result = db.adminCommand(command); 
            if (result.ok) {
                print("Cleaned up orphaned documents for collection " + fullCollectionName + " on shard " + shardName);
                printjson(result);
            } else {
                print("Failed to clean up orphaned documents for collection " + fullCollectionName + " on shard " + shardName);
            }
        });
    });
});

スクリプトで、shardNames および databasesToProcess パラメーターの値を変更します：

shardNames：孤立ドキュメントをクリーンアップするシャードの ID の配列。シャード ID は、インスタンスの基本情報ページのシャードリストから取得できます。例：d-bp15a3796d3a****。
databasesToProcess：孤立ドキュメントをクリーンアップするデータベース名の配列。

cleanupOrphaned.js スクリプトがあるディレクトリで、次のコマンドを実行して孤立ドキュメントをクリーンアップします。

mongo --host <Mongoshost> --port <Primaryport>  --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js > output.txt

パラメーター	説明
`<Mongoshost>`	シャードクラスターインスタンスの mongos ノードのエンドポイント。例：`s-bp14423a2a51****.mongodb.rds.aliyuncs.com`。
`<Primaryport>`	シャードクラスターインスタンスの mongos ノードのポート番号。デフォルト値は 3717 です。
`<database>`	認証データベースの名前。これは、データベースアカウントが属するデータベースです。
`<username>`	データベースアカウント。
`<password>`	データベースアカウントのパスワード。
`output.txt`	実行結果の出力ファイル。

MongoDB 4.2 以前

シャードクラスターインスタンスに接続できるサーバーで、cleanupOrphaned.js という名前の JS スクリプトを作成します。

説明
このスクリプトは、複数のシャードにまたがる指定されたデータベースの指定されたコレクションから孤立ドキュメントをクリーンアップします。複数のコレクションから孤立ドキュメントをクリーンアップするには、fullCollectionName パラメーターを変更してスクリプトを複数回実行するか、コレクションを反復処理するようにスクリプトを変更します。
```
function cleanupOrphanedOnShard(shardName, fullCollectionName) {
    var nextKey = { };
    var result;
    while ( nextKey != null ) {
        var command = {
            runCommandOnShard: shardName,
            command: { cleanupOrphaned: fullCollectionName, startingFromKey: nextKey }
        };
        result = db.adminCommand(command);
        printjson(result);
        if (result.ok != 1 || !(result.results.hasOwnProperty(shardName)) || result.results[shardName].ok != 1 ) {
            print("Unable to complete at this time: failure or timeout.")
            break
        }
        nextKey = result.results[shardName].stoppedAtKey;
    }
    print("cleanupOrphaned done for coll: " + fullCollectionName + " on shard: " + shardName)
}
var shardNames = ["shardName1", "shardName2", "shardName3"]
var fullCollectionName = "database.collection"
shardNames.forEach(function(shardName) {
    cleanupOrphanedOnShard(shardName, fullCollectionName);
});
```
スクリプトで、shardNames および fullCollectionName パラメーターの値を変更します：
- shardNames：孤立ドキュメントをクリーンアップするシャードの ID の配列。シャード ID は、インスタンスの基本情報ページのシャードリストから取得できます。例：d-bp15a3796d3a****。
- fullCollectionName：孤立ドキュメントをクリーンアップするコレクションの名前。database.collection の形式で指定します。

cleanupOrphaned.js スクリプトがあるディレクトリで、次のコマンドを実行して孤立ドキュメントをクリーンアップします。

mongo --host <Mongoshost> --port <Primaryport>  --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js > output.txt

パラメーター	説明
`<Mongoshost>`	シャードクラスターインスタンスの mongos ノードのエンドポイント。例：`s-bp14423a2a51****.mongodb.rds.aliyuncs.com`。
`<Primaryport>`	シャードクラスターインスタンスの mongos ノードのポート番号。デフォルト値は 3717 です。
`<database>`	認証データベースの名前。これは、データベースアカウントが属するデータベースです。
`<username>`	データベースアカウント。
`<password>`	データベースアカウントのパスワード。
`output.txt`	実行結果の出力ファイル。

自主管理 MongoDB

自主管理 MongoDB データベースに接続できるサーバーで、cleanupOrphaned.js スクリプトファイルをダウンロードします。
```
wget "https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/120562/cn_zh/1564451237979/cleanupOrphaned.js"
```

cleanupOrphaned.js スクリプトファイルを変更します。test を、孤立ドキュメントをクリーンアップしたいデータベースの名前に置き換えます。

重要

複数のデータベースがある場合は、データベースごとにステップ 2 とステップ 3 を繰り返す必要があります。

function cleanupOrphaned(coll) {
  var nextKey = { };
  var result;
  while ( nextKey != null ) {
    result = db.adminCommand( { cleanupOrphaned: coll, startingFromKey: nextKey } );
    if (result.ok != 1)
       print("Unable to complete at this time: failure or timeout.")
    printjson(result);
    nextKey = result.stoppedAtKey;
  }
}
var dbName = "test"
db = db.getSiblingDB(dbName)
db.getCollectionNames().forEach(function(collName) {
        cleanupOrphaned(dbName + "." + collName);
});

次のコマンドを実行して、シャード上の指定されたデータベースのすべてのコレクションから孤立ドキュメントをクリーンアップします。

説明
このステップは、シャードごとに繰り返す必要があります。
```
mongo --host <Shardhost> --port <Primaryport>  --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js
```
説明
- <Shardhost>：シャードの IP アドレス。
- <Primaryport>：シャード内のプライマリノードのサービスポート。
- <database>：認証データベースの名前。これは、データベースアカウントが属するデータベースです。
- <username>：データベースアカウント。
- <password>：アカウントのパスワード。
例：

この例では、自主管理 MongoDB データベースに 3 つのシャードがあります。孤立ドキュメントをクリーンアップするには、シャードごとにコマンドを実行する必要があります。
```
mongo --host 172.16.1.10 --port 27018  --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
```
```
mongo --host 172.16.1.11 --port 27021 --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
```
```
mongo --host 172.16.1.12 --port 27024  --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
```

操作手順

重要

このトピックでは、購入前に DTS タスクを設定する例を使用します。この場合、ソース ApsaraDB for MongoDB シャードクラスターのシャード数を指定する必要はありません。

DTS タスクを設定する前に購入する場合は、購入時に正しいシャード数を指定する必要があります。

次のいずれかの方法で、ターゲットリージョンの移行タスクリストページに移動します。
DTS コンソールから
1. Data Transmission Service (DTS) コンソールにログインします。
2. 左側のナビゲーションウィンドウで、データの移行 をクリックします。
3. ページ左上で、移行インスタンスが配置されているリージョンを選択します。
DMS コンソールから

説明
実際の操作は、DMS コンソールのモードとレイアウトによって異なる場合があります。詳細については、「シンプルモードコンソール」および「DMS コンソールのレイアウトとスタイルをカスタマイズする」をご参照ください。
1. Data Management (DMS) コンソールにログインします。
2. トップメニューバーで、[データ + AI] > [データ伝送 (DTS)] > [データ移行] を選択します。
3. データ移行タスク の右側で、移行インスタンスが配置されているリージョンを選択します。

タスクの作成 をクリックし、ソースデータベースとターゲットデータベースを設定します。

セクション	パラメーター	説明
N/A	タスク名	DTS は自動的にタスク名を生成します。簡単に識別できるように、わかりやすい名前を指定することを推奨します。名前は一意である必要はありません。
移行元データベース	既存の DMS データベースインスタンスを選択します。(任意です。DMS データベースインスタンスが未登録の場合は、このオプションを無視して、以下のセクションでデータベース設定を行ってください。) (オプション。接続を作成していない場合は、これをスキップして、以下で直接データベース情報を設定できます。)	必要に応じて既存のインスタンスを選択します。既存のインスタンスを使用する場合、データベース情報は自動的に入力されます。再度入力する必要はありません。既存のインスタンスを使用しない場合は、次のデータベース情報を入力します。
	データベースタイプ	MongoDB を選択します。
	アクセス方法	Alibaba Cloud インスタンスを選択します。
	インスタンスのリージョン	ソース ApsaraDB for MongoDB インスタンスが配置されているリージョンを選択します。
	Alibaba Cloud アカウント間でデータを複製	この例では、同じ Alibaba Cloud アカウント内でデータを同期する方法を示します。× を選択します。
	アーキテクチャ	シャードクラスターを選択します。
	移行方法	要件に基づいて、増分データ同期の方法を選択します。 Oplog (推奨)：このオプションは、ソースデータベースで Oplog が有効になっている場合に使用できます。説明 Oplog は、自主管理 MongoDB データベースおよび ApsaraDB for MongoDB インスタンスでデフォルトで有効になっています。この方法では、ログの取得が高速なため、増分同期タスクのレイテンシが低くなります。Oplog を選択することを推奨します。 ChangeStream：このオプションは、ソースデータベースで Change Streams が有効になっている場合に使用できます。説明ソースデータベースが Amazon DocumentDB (非エラスティッククラスター) インスタンスの場合、ChangeStream のみを選択できます。ソースデータベースのアーキテクチャをシャードクラスターに設定した場合、Shardアカウントと Shardパスワードを指定する必要はありません。
	インスタンス ID	ソース ApsaraDB for MongoDB インスタンスのインスタンス ID を選択します。
	データベース名	ソース ApsaraDB for MongoDB インスタンスのデータベースアカウントが属するデータベースの名前を入力します。デフォルト値は admin です。
	データベースアカウント	ソース ApsaraDB for MongoDB インスタンスのデータベースアカウントを入力します。このアカウントには、同期するデータベース、および config、admin、local データベースに対する読み取り権限が必要です。説明増分同期方法として ChangeStream を使用する場合、ソースデータベースアカウントにはインスタンス全体の Change Streams 読み取り権限 (例：`readAnyDatabase`) が必要です。ソースがカスタムアカウントを持つ ApsaraDB for MongoDB インスタンスの場合、`admin` データベースに対する読み取り権限もアカウントに付与する必要があります。詳細については、「インスタンス作成時に指定されたルートアカウントの権限」をご参照ください。
	データベースのパスワード	データベースアカウントに対応するパスワードを入力します。
	Shardアカウント	ソース ApsaraDB for MongoDB インスタンスのシャードアカウントを入力します。説明ソースが自主管理 MongoDB データベースの場合、シャードノードのシャード接続情報も入力する必要があります。
	Shardパスワード	ソース ApsaraDB for MongoDB インスタンスのシャードパスワードを入力します。
移行先データベース	既存の DMS データベースインスタンスを選択します。(任意です。DMS データベースインスタンスが未登録の場合は、このオプションを無視して、以下のセクションでデータベース設定を行ってください。) (オプション。接続を作成していない場合は、これをスキップして、以下で直接データベース情報を設定できます。)	必要に応じて既存のインスタンスを選択します。既存のインスタンスを使用する場合、データベース情報は自動的に入力されます。再度入力する必要はありません。既存のインスタンスを使用しない場合は、次のデータベース情報を入力します。
	データベースタイプ	MongoDB を選択します。
	アクセス方法	Alibaba Cloud インスタンスを選択します。
	インスタンスのリージョン	ターゲット ApsaraDB for MongoDB インスタンスが配置されているリージョンを選択します。
	アーキテクチャ	ターゲット ApsaraDB for MongoDB インスタンスのアーキテクチャタイプを選択します。
	インスタンス ID	ターゲット ApsaraDB for MongoDB インスタンスのインスタンス ID を選択します。
	データベース名	ターゲット ApsaraDB for MongoDB インスタンスのデータベースアカウントが属するデータベースの名前を入力します。デフォルト値は admin です。
	データベースアカウント	ターゲット ApsaraDB for MongoDB インスタンスのデータベースアカウントを入力します。このアカウントには、dbAdminAnyDatabase 権限、ターゲットデータベースに対する読み書き権限、および local データベースに対する読み取り権限が必要です。
	データベースのパスワード	データベースアカウントに対応するパスワードを入力します。
	暗号化	DTS は、非暗号化、SSL 暗号化、Mongo Atlas SSL の 3 つの接続方法をサポートしています。暗号化のオプションは、選択したアクセス方法とアーキテクチャによって異なります。コンソールに表示されるオプションが優先されます。説明アーキテクチャがシャードクラスターの MongoDB データベースは、SSL 暗号化をサポートしていません。送信先が、アクセス方法が Alibaba Cloud インスタンスではないレプリカセット構成の自主管理 MongoDB データベースであり、SSL 暗号化を選択した場合、DTS では、接続を検証するために CA 証明書をアップロードすることもできます。

ページ下部で、[接続テストと次へ] をクリックします。

ソースまたはターゲットデータベースが ApsaraDB RDS for MySQL や ApsaraDB for MongoDB インスタンスなどの Alibaba Cloud データベースインスタンスである場合、DTS は自動的に DTS サーバーの CIDR ブロックをインスタンスのホワイトリストに追加します。ソースまたはターゲットデータベースが Elastic Compute Service (ECS) インスタンスでホストされている自己管理データベースである場合、DTS は自動的に DTS サーバーの CIDR ブロックを ECS インスタンスのセキュリティグループルールに追加し、ECS インスタンスがデータベースにアクセスできることを確認する必要があります。ソースまたはターゲットデータベースがデータセンターにデプロイされているか、サードパーティのクラウドサービスプロバイダーによって提供されている自己管理データベースである場合、DTS がデータベースにアクセスできるように、手動で DTS サーバーの CIDR ブロックをデータベースのホワイトリストに追加する必要があります。詳細については、「DTS サーバーの IP アドレスをホワイトリストに追加する」をご参照ください。
警告
DTS サーバーの CIDR ブロックがデータベースまたはインスタンスのホワイトリスト、または ECS セキュリティグループルールに自動または手動で追加されると、セキュリティリスクが発生する可能性があります。したがって、DTS を使用してデータを同期する前に、潜在的なリスクを理解し、認識し、ユーザー名とパスワードのセキュリティ強化、公開されるポートの制限、API 呼び出しの認証、ホワイトリストまたは ECS セキュリティグループルールの定期的な確認と不正な CIDR ブロックの禁止、または Express Connect、VPN Gateway、Smart Access Gateway を使用してデータベースを DTS に接続するなど、予防措置を講じる必要があります。

同期オブジェクトと詳細設定を構成します。

パラメーター	説明
同期タイプ	増分データ同期が選択されています。デフォルトでは、スキーマ同期と完全データ同期も選択する必要があります。事前チェックが完了すると、DTS は選択したオブジェクトの完全データ同期をソースインスタンスからターゲットクラスターに実行します。これは、後続の増分データ同期のベースラインデータとして機能します。
同期トポロジ	一方向同期を選択します。
競合するテーブルの処理モード	エラーの事前チェックと報告：ターゲットデータベースに同じ名前のコレクションがあるか確認します。同じ名前のコレクションが見つかった場合、エラーが報告され、データ同期タスクは開始されません。それ以外の場合、事前チェックは成功します。説明ターゲットデータベースで同じ名前のコレクションを削除または名前変更できない場合は、ターゲットデータベースのコレクションの名前を変更できます。詳細については、「ターゲットインスタンスでの同期オブジェクトの名前を設定する」をご参照ください。エラーを無視して続行：ターゲットデータベースで同じ名前のコレクションのチェックをバイパスします。警告エラーを無視して続行を選択すると、データの不整合が発生し、ビジネスにリスクをもたらす可能性があります。例：ターゲットデータベースのレコードがソースデータベースのレコードと同じプライマリキーまたは一意キーの値を持つ場合、ターゲットデータベースのレコードが保持されます。ソースデータベースのレコードはターゲットデータベースに同期されません。これにより、データ初期化が失敗したり、一部のデータのみが同期されたり、同期全体が失敗したりする可能性があります。
移行先インスタンスでのオブジェクト名の大文字化	ターゲットインスタンスに同期されるデータベース、テーブル、および列オブジェクト名の大文字/小文字の区別ポリシーを設定できます。デフォルトでは、DTS のデフォルトポリシーが選択されています。ソースおよびターゲットデータベースのデフォルトポリシーを使用することもできます。詳細については、「ターゲットオブジェクト名の大文字/小文字の区別ポリシー」をご参照ください。
ソースオブジェクト	ソースオブジェクトボックスで、同期するオブジェクトをクリックし、をクリックして選択中のオブジェクトボックスに移動します。説明同期は、DATABASE および COLLECTION レベルで実行できます。
選択中のオブジェクト	ターゲットインスタンスで単一の同期オブジェクトの名前を変更するには、選択中のオブジェクトボックスでオブジェクトを右クリックします。オブジェクトの名前変更の詳細については、「単一のデータベース、テーブル、または列をマッピングする」をご参照ください。ターゲットインスタンスで複数の同期オブジェクトの名前を一括で変更するには、選択中のオブジェクトボックスの右上隅にある一括編集をクリックします。詳細については、「データベース、テーブル、および列を一括でマッピングする」をご参照ください。

詳細設定へ をクリックして、詳細設定を構成します。

データ検証設定

データ検証を構成するには、「データ検証の構成」をご参照ください。

詳細設定

パラメーター	説明
タスクのスケジュールに使用する専用クラスターの選択	デフォルトでは、DTS は共有クラスターでタスクをスケジュールするため、クラスターを選択する必要はありません。より安定したパフォーマンスを得るには、専用クラスターを購入して DTS 同期タスクを実行できます。詳細については、「DTS 専用クラスターとは」をご参照ください。
失敗した接続の再試行時間	同期タスクの開始後、ソースまたはターゲットデータベースへの接続が失敗した場合、DTS はエラーを報告し、すぐに接続の再試行を開始します。デフォルトの再試行時間は 720 分です。10 分から 1,440 分の範囲でカスタムの再試行時間を指定することもできます。30 分以上に設定することを推奨します。指定された時間内に DTS がデータベースに正常に再接続した場合、同期タスクは自動的に再開されます。それ以外の場合、タスクは失敗します。説明同じソースまたはターゲットを共有する複数の DTS インスタンス (インスタンス A とインスタンス B など) があり、インスタンス A のネットワーク再試行時間を 30 分、インスタンス B を 60 分に設定した場合、両方に短い方の 30 分が使用されます。 DTS は接続再試行期間中のタスク実行時間に対して課金するため、ビジネスニーズに基づいて再試行時間をカスタマイズするか、ソースおよびターゲットデータベースインスタンスがリリースされた後、できるだけ早く DTS インスタンスをリリースすることを推奨します。
移行元データベースと移行先データベースで他の問題が発生した場合の、再試行までの待機時間です。	同期タスクの開始後、ソースまたはターゲットデータベースで接続以外の問題 (DDL または DML 実行例外など) が発生した場合、DTS はエラーを報告し、すぐに連続的な再試行操作を開始します。デフォルトの再試行時間は 10 分です。1 分から 1,440 分の範囲でカスタムの再試行時間を指定することもできます。10 分以上に設定することを推奨します。設定された再試行時間内に関連する操作が成功した場合、同期タスクは自動的に再開されます。それ以外の場合、タスクは失敗します。重要移行元データベースと移行先データベースで他の問題が発生した場合の、再試行までの待機時間です。の値は、失敗した接続の再試行時間の値より小さくする必要があります。
完全同期レートを制限するかどうか	完全同期段階では、DTS はソースおよびターゲットデータベースの読み取りおよび書き込みリソースを消費し、データベースの負荷を増加させる可能性があります。ソースおよびターゲットデータベースの負荷を軽減するために、1 秒あたりのソースデータベースのクエリ率 QPS、1 秒あたりの完全移行の行数 RPS、および 1 秒あたりの完全移行データ量 (MB) BPS パラメーターを設定することで、完全同期タスクのレート制限を設定できます。説明この設定項目は、同期タイプが完全データ同期に設定されている場合にのみ使用できます。同期インスタンスの実行後に完全同期レートを調整することもできます。
増分同期率を制限するかどうか	増分同期タスクのレート制限も設定できます。ターゲットデータベースの圧力を軽減するために、1 秒あたりの増分同期の行数 RPS と 1 秒あたりの増分同期データ量 (MB) BPS を設定します。
環境タグ	ビジネスニーズに基づいてインスタンスを識別するために環境タグを選択できます。この例では、タグを選択する必要はありません。
ETL 機能の設定	抽出・変換・書き出し (ETL) 機能を有効にするかどうかを選択します。詳細については、「ETL とは」をご参照ください。有効な値： ○：ETL 機能を有効にします。コードエディタにデータ処理ステートメントを入力します。詳細については、「データ移行またはデータ同期タスクで ETL を設定する」をご参照ください。 ×：ETL 機能を無効にします。
監視アラート	アラートを構成するかどうかを指定します。同期が失敗した場合、またはレイテンシが指定されたしきい値を超えた場合、アラート連絡先に通知が送信されます。 ×：アラートは構成されません。 ○：アラートのしきい値を設定し、アラート通知を指定してアラートを構成します。詳細については、「タスク構成中のモニタリングとアラートの構成」をご参照ください。

タスクを保存し、事前チェックを実行します。
- このインスタンスを構成するための API パラメーターを表示するには、次：タスク設定の保存と事前チェック ボタンにカーソルを合わせ、バブル内の OpenAPI パラメーターのプレビュー をクリックします。
- API パラメーターの表示が完了したら、ページ下部の 次：タスク設定の保存と事前チェック をクリックします。
説明
- 同期ジョブが開始される前に、DTS は事前チェックを実行します。ジョブは、すべての事前チェック項目に合格した後にのみ開始できます。
- 事前チェックが失敗した場合は、失敗した項目の 詳細を表示 をクリックします。プロンプトに従って問題を修正し、再度事前チェックを実行します。
- 事前チェックで警告が返された場合：
  
  チェック項目が失敗し、無視できない場合は、項目の横にある 詳細を表示 をクリックします。指示に従って問題を修正し、再度事前チェックを実行します。
  
  無視できるチェック項目については、アラートの詳細を確認、無視、OK、再度事前チェックを実行 を順にクリックして、警告をスキップし、事前チェックを再実行できます。警告項目をシールドすることを選択した場合、データの不整合などの問題が発生し、ビジネスにリスクをもたらす可能性があります。
成功率 が 100% になったら、次：インスタンスの購入 をクリックします。

購入ページで、データ同期インスタンスの課金方法とリンク仕様を選択します。次の表で、これらのパラメーターについて詳しく説明します。

カテゴリ	パラメーター	説明
新しいインスタンスクラス	課金方法	サブスクリプション：インスタンス作成時にお支払いいただきます。長期的なニーズに適しており、従量課金よりもコスト効率が高くなります。サブスクリプション期間が長いほど、割引率が高くなります。従量課金：時間単位で課金されます。短期的なニーズに適しています。使用後すぐにインスタンスをリリースしてコストを節約できます。
	リソースグループ設定	インスタンスが属するリソースグループ。デフォルトはデフォルトのリソースグループです。詳細については、「Resource Management とは」をご参照ください。
	リンク仕様	DTS は、さまざまなパフォーマンスレベルの同期仕様を提供します。同期リンク仕様は同期レートに影響します。ビジネスシナリオに基づいて仕様を選択できます。詳細については、「データ同期リンク仕様」をご参照ください。
	サブスクリプション期間	サブスクリプションモードでは、サブスクリプションインスタンスの期間と数量を選択します。1 か月から 9 か月までの月額サブスクリプション、または 1、2、3、5 年の年額サブスクリプションを選択できます。説明このオプションは、課金方法がサブスクリプションの場合にのみ使用できます。

設定が完了したら、Data Transmission Service (従量課金) 利用規約 を読んで選択します。
購入して起動 をクリックします。OK ダイアログボックスで、[OK] をクリックします。

データ同期ページでタスクの進捗状況を確認できます。