サンプル スキーマでRelational Migratorを使用する

このタスクについて

サンプル スキーマを使用してプロジェクトを作成することは、Relational Migrator を起動するのに最も速くて簡単な方法です。

プロジェクトの作成を終了する前に、初期マッピングを選択できます。 これらのオプションには、リレーショナルデータベースに基づいて Relational Migrator によって自動的に提案される推奨 MongoDB スキーマを使用して を開始することが含まれます。

手順

これらの手順では、サンプルスキーマからプロジェクトを作成します。これらを完了するには、リレーショナルデータベース接続は必要ありません。

1. Relational Migrator で、Relational Migrator ホーム画面の右上にあるNew Projectをクリックします。

2. Create sampleボタンをクリックします。

3. Select tables画面から、移行するテーブルを指定し、 [ Next ] をクリックします。

   以下のタブでは、移行するテーブルを選択するさまざまな方法について説明しています。

   手動選択

   一括選択

   1. ツリーを展開すると、データベース、スキーマ、テーブルが表示されます。

   2. チェックマークを使用して項目を選択します。

      • データベース内のすべてのテーブル:データベースのチェックマークをクリックします。

      • スキーマ内のすべてのテーブル:データベースを展開し、スキーマのチェックマークをクリックします。

      • スキーマ内の特定のテーブル:データベースとスキーマを展開し、テーブルを個別に選択します。

      • 特定のテーブル名: Relational Schema リストの上にある Filter バーを使用します。

   1. Bulk Selection に切り替えます。

   2. 完全修飾テーブル名のカンマ区切りリストを貼り付けまたは入力します（例: 、database.schema.table）。

      入力時に、 Relational Migrator はリストをフィルターし、一致するテーブルをクリックして追加または除外します。

4. コレクション名にはGlobal casingオプションを選択します。

   このオプションは、関係データベースのテーブルから作成されたコレクションの名前に影響します。

   • Keep Original: 関係データベースのテーブル名には、使用している大文字と小文字を区別しないでください。

   • Override with Global Casing: 元のテーブル名をグローバル大文字と小文字規則で上書きします。

     • camelCase

     • TitleCase

     • kebab-case

     • snake_case

     • UPPER_SNAKE_CASE

5. MongoDB スキーマのInitial mappingsオプションを選択します。

   • Start with a MongoDB schema that matches your relational schema

     各テーブルに対して新しいドキュメントマッピング ルールを使用して初期プロジェクトを作成します。このオプションは、インポートされた関係テーブルの表を表示します。これらはデータベースとスキーマごとにグループ化され、アルファベット順にリストされています。各コレクションは top-levelコレクションとして表されます。各表で、対応するコレクション名を表示できます。コレクション名では、 Relational Migrator は元のテーブル名にグローバル ケースを適用します。

   • Start with a recommended MongoDB schema

     Relational Migrator は、推奨される MongoDB スキーマのマッピング ルールを作成します。 このオプションを選択すると、インポートされた関係テーブルを示すテーブルが表示されます。 Relational Migrator は、どのテーブルをtop-level embeddedコレクションまたは コレクションとして表すかを提案します。チェックボックスを使用して、どのテーブルをコレクションまたは埋め込みにマッピングするかを変更できます。

   • Start with an empty MongoDB schema

     マッピング ルールなしで初期プロジェクトを作成します。

   注意

   プロジェクトを開始するときに選択したオプションに関係なく、マッピング ルールを手動で追加、削除、または変更することができます。 これにより、ワークロードの特定の要件に応じて MongoDB スキーマをカスタマイズできます。

6. プロジェクトの名前を入力します。

7. [Done] をクリックします。

サンプル データの追加（任意）

移行ジョブやその他の機能には、リレーショナルデータベースへのライブ接続が必要です。 MongoDB はサンプルリレーショナルデータベースを提供し、作成したプロジェクトでそれらの機能をテストできます。サンプルデータベースは、 Dockerコンテナとしてパッケージ化された Northwind の PostgreSQLインスタンスです。

コンテナを起動するには、次のコマンドを実行します。

docker run -p 5432:5432 public.ecr.aws/v4d7k6c9/relational-migrator-sample-database

データベースはポート5432 でリッスンします。ユーザー名とパスワードは両方ともpostgres です。これらの認証情報を使用して、コンテナを接続としてプロジェクトに追加します。詳細については、「 PostgreSQL への接続 」を参照してください。

次のステップ

• リレーショナルからマッピング ルールを作成

• MongoDB へのマッピング ルールを作成

• 移行ジョブの作成