Usar Relational Migrator con un esquema de muestra

Acerca de esta tarea

Crear un proyecto con un esquema de muestra es la forma más rápida y sencilla de probar Relational Migrator.

Antes de finalizar la creación de su proyecto, tiene la opción de seleccionar los mapeos iniciales. Estas opciones incluyen comenzar con un esquema recomendado de MongoDB, que es sugerido automáticamente por Relational Migrator en función de tu base de datos relacional.

Antes de comenzar

Antes de que pueda ejecutar tareas de migración desde el esquema de muestra, debe:

1. Descargar Docker extraer y alojar un contenedor de base de datos PostgreSQL proporcionado. Este contenedor viene precargado con el esquema de muestra presentado en Relational Migrator.

2. Descargue y ejecute el script de configuración de la base de datos Northwind.sql en una instancia existente de PostgreSQL. Este script carga el esquema de muestra.

Pasos

Los siguientes pasos te guían a través del proceso de conexión a un contenedor Docker con el objetivo de migrar datos mediante trabajos de migración. Esto no es un requerimiento, puedes crear un Proyecto sin ejecutar las tareas de migración. Si no planeas ejecutar tareas de migración, omite el paso uno.

1. (Opcional) Desde una ventana de terminal, ejecuta el siguiente comando de Docker para iniciar una instancia de base de datos relacional PostgreSQL:

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

   Las credenciales de conexión de esta instancia de base de datos son:

   • nombre de usuario: postgres

   • Contraseña: postgres

   • Puerto: 5432

   Advertencia

   La base de datos PostgreSQL es solo para fines de demostración y no debe utilizarse para fines de producción.

2. En Relational Migrator, haz clic New Project en la esquina superior derecha de la pantalla de inicio de Relational Migrator.

3. Haga clic en el botón Create sample.

4. Desde la pantalla Select tables, indique las tablas que desea migrar y haga clic en Next.

   Las pestañas a continuación explican las diferentes formas en que puedes seleccionar las tablas para migrar:

   Selección manual

   Selección masiva

   1. Expande el árbol para ver bases de datos, esquemas y tablas.

   2. Utiliza las marcas de verificación para seleccionar artículos:

      • Todas las tablas dentro de una base de datos: Haz clic en la marca de verificación correspondiente a la base de datos.

      • Todas las tablas dentro de un esquema: expanda la base de datos y haga clic en la marca de verificación para el esquema.

      • Tablas específicas dentro de un esquema: Ampliar la base de datos y el esquema, luego seleccionar las tablas individualmente.

      • Nombres de tabla específicos: use la barra Filter sobre la lista Relational Schema.

   1. Cambiar a Bulk Selection.

   2. Pegue o capture una lista separada por comas de nombres de tablas totalmente calificados (por ejemplo, database.schema.table).

      A medida que escribes, Relational Migrator filtra la lista y te permite hacer clic en las tablas correspondientes para incluirlas o excluirlas.

5. Elige una opción Global casing para nombres de colecciones.

   Esta opción afecta los nombres de tus colecciones creadas a partir de las tablas en tu base de datos relacional:

   • Keep Original: Conserve el uso original de mayúsculas y minúsculas en el nombre de su tabla de base de datos relacional.

   • Override with Global Casing: Reemplaza el nombre original de la tabla con una convención global de uso de mayúsculas y minúsculas.

     • camelCase

     • TitleCase

     • kebab-case

     • snake_case

     • UPPER_SNAKE_CASE

6. Seleccione una opción Initial mappings para su esquema de MongoDB.

   • Start with a MongoDB schema that matches your relational schema

     Crea tu proyecto inicial con una nueva regla de asignación de documentos para cada tabla. Esta opción muestra una tabla de tablas relacionales importadas, agrupadas por base de datos y esquema, y listadas en orden alfabético. Cada colección se representa como una colección top-level. Puedes ver el nombre de la colección correspondiente en cada tabla. Para los nombres de las colecciones, Relational Migrator aplica un formato global al nombre original de la tabla.

   • Start with a recommended MongoDB schema

     Relational Migrator crea reglas de mapeo para una sugerencia de esquema de MongoDB. Cuando se selecciona esta opción, aparece una tabla que muestra las tablas relacionales importadas. Relational Migrator sugiere qué tablas deben representarse como colecciones top-level o embedded. Puede utilizar las casillas de verificación para modificar qué tablas se asignan a colecciones o se incrustan.

   • Start with an empty MongoDB schema

     Cree su proyecto inicial sin reglas de mapeo.

   Nota

   Independientemente de la opción que elijas al iniciar tu Proyecto, tienes la flexibilidad de agregar, remover o modificar manualmente las reglas de mapeo en cualquier momento. Esto te permite personalizar el esquema de MongoDB según los requisitos específicos de tu carga de trabajo.

7. Ingrese un nombre para su proyecto.

8. Haga clic en Done.

Próximos pasos

• Crear reglas de mapeo desde relacional

• Crear reglas de mapeo para MongoDB