Implementar una instancia federada de base de datos

Inicie sesión en MongoDB Atlas.

Selecciona la opción Data Federation en la navegación de la izquierda.

Crear una instancia de base de datos federada.

1. Haz clic en el menú desplegable Create New Federated Database.

2. Seleccione Feed Downstream Systems.

Haz clic Get Starteden.

Escriba un nombre para su instancia de base de datos federada en el campo Federated Database Instance Name y haga clic en Continue.

Por defecto es FederatedDatabaseInstance[n]. Una vez que se crea tu instancia de base de datos federada, no puedes cambiar su nombre.

Especifique sus fuentes de datos.

1. Seleccione un clúster de Atlas para usar como fuente de datos desde el desplegable. Por defecto, Atlas Data Federation añade todas las colecciones en este clúster. Para usar un subconjunto de los datos, haz clic en Specific Collections, expande las bases de datos y luego selecciona las colecciones que deseas añadir a tu instancia federada de base de datos.

   Tip

   Para filtrar las bases de datos y colecciones, escribe texto en el campo Specific Collections. El cuadro de diálogo muestra únicamente bases de datos y colecciones cuyos nombres coinciden con tus criterios de búsqueda.

2. Haga clic en Continue.

Seleccione un rol de AWS IAM para Atlas.

Puedes seleccionar un rol IAM de AWS existente para el cual Atlas esté autorizado desde la lista desplegable de selección de roles o escoger Authorize an AWS IAM Role para autorizar un nuevo rol.

Si seleccionó un rol existente para el que Atlas está autorizado, proceda al siguiente paso para mostrar los buckets de AWS S3.

Si está autorizando Atlas para un rol existente o está creando un nuevo rol, complete los siguientes pasos antes de proceder al siguiente paso:

1. Desde el menú desplegable, selecciona Authorize an AWS IAM Role para autorizar un nuevo rol o selecciona un rol existente.

2. Utiliza el AWS ARN y el ID Externo único en la sección Role Authorization para agregar Atlas a las relaciones de confianza de un rol IAM AWS existente o nuevo.

   En la interfaz de usuario de Atlas, haz clic en uno de los siguientes:

   • El Create new AWS IAM role muestra cómo usar el ARN y el ID externo único para agregar Atlas a las relaciones de confianza de un nuevo rol AWS IAM. Siga los pasos en la interfaz de usuario de Atlas para crear un nuevo rol. Para obtener más información, consulte Cómo crear un nuevo rol con la CLI de AWS.

     Al autorizar un nuevo rol, si salís del flujo de trabajo:

     • Antes de validar el rol, Atlas no creará la instancia de base de datos federada. Puede ir a la Integrations página Atlas para autorizar un nuevo rol y, a continuación, iniciar el procedimiento de implementación de una instancia de base de datos federada de nuevo cuando tenga el ARN del rol de AWS IAM.

     • Luego de validar el rol, Atlas no creará la instancia federada de base de datos. Sin embargo, el rol está disponible en el menú desplegable de selección de rol y puede utilizarse para crear una instancia de base de datos federada. No necesitas autorizar el rol nuevamente.

   • El Use existing AWS IAM role muestra cómo usar el ARN y el ID externo único para añadir Atlas a las relaciones de confianza de un AWS IAM rol existente. Siga los pasos en la interfaz de usuario de Atlas para añadir Atlas a la relación de confianza de un rol existente. Para obtener más información, consulta Agregar relaciones de confianza a un rol existente .

   Importante

   Si en el futuro modifica su rol personalizado de AWS ARN, asegúrese de que la política de acceso del rol incluya el acceso apropiado a los recursos de S3 para la instancia federada de base de datos.

   Para obtener más información, consulta Configurar Acceso Unificado a AWS y Crear un Rol de Acceso de Proveedor Cloud.

3. Haga clic en Validate AWS IAM role.

Asigne una política de acceso a su rol de AWS IAM.

1. Introduce el nombre de tu bucket de S3.

2. Sigue los pasos en la IU de Atlas para asignar una directiva de acceso a tu rol IAM AWS.

3. Haga clic en Validate AWS S3 bucket access.

4. Haga clic en Continue.

Programa tus extracciones de datos.

Programa un activador para copiar datos continuamente desde tu clúster Atlas a tu bucket S3 utilizando $out en la sección Schedule Queries.

1. Especifique la frecuencia con la que desea extraer datos de su clúster de Atlas utilizando los menús desplegables Repeat Once By.

2. opcional. Especifica si Atlas Data Federation debe volver a ejecutar la misma query si la ha pasado por alto por alguna razón. Por defecto, esto está desactivado para permitir que Atlas Data Federation vuelva a ejecutar las consultas que se hayan omitido. Como alternativa, para omitir consultas que se hayan saltado y no ponerse al día, activa Skip Catch Up Events.

3. Opcional. Elige el formato que deseas para tus datos cuando Atlas Data Federation los guardar en tu bucket S3. Atlas Data Federation admite Parquet, CSV , BSON y MongoDB JSON extendido.

4. Especifique el Max File Size para limitar el tamaño de cada archivo que Atlas Data Federation guarde en su cubo S3. Por ejemplo, si se establece Max File Size en 100 MB y una query devuelve 1 GB de datos, Atlas Data Federation guarda la query en su bucket S3 en 10 archivos, cada uno de 100 MBs.

5. Ingrese el prefijo de AWS para el bucket de destino S3.

6. Introduce el nombre del campo de fecha indexado en Date Field y especifica el formato de su valor usando el menú desplegable. Cada colección que desees copiar posteriormente debe tener un campo indexado que almacene una marca de tiempo como su valor.

7. Haga clic en Continue.

Haz clic Createen.

Inicie sesión en MongoDB Atlas.

Selecciona la opción Data Federation en la navegación de la izquierda.

Crear una instancia de base de datos federada.

1. Haz clic en el menú desplegable Create New Federated Database.

2. Seleccione Explore with Sample Data.

Haz clic Get Starteden.

Haz clic Createen.

Inicie sesión en MongoDB Atlas.

Selecciona la opción Data Federation en la navegación de la izquierda.

Crear una instancia de base de datos federada.

1. Haz clic en el menú desplegable Create New Federated Database.

2. Seleccione Query Data Across Clusters.

Haz clic Get Starteden.

Escriba un nombre para su instancia de base de datos federada en el campo Federated Database Instance Name y haga clic en Continue.

Por defecto es FederatedDatabaseInstance[n]. Una vez que se crea tu instancia de base de datos federada, no puedes cambiar su nombre.

Especifica los clústeres de Atlas a utilizar como fuentes de datos.

1. Selecciona un clúster de Atlas para usar como fuente de datos del menú desplegable. Atlas sólo muestra los clústeres del proyecto actual de Atlas en este menú desplegable.

2. Expande las bases de datos y selecciona las colecciones que desees agregar a tu instancia federada de base de datos.

   Tip

   Para filtrar las bases de datos y colecciones, escribe texto en el campo Specific collections. El cuadro de diálogo muestra únicamente bases de datos y colecciones cuyos nombres coinciden con tus criterios de búsqueda.

3. opcional. Expande la configuración de Cluster Read Preference para configurar los siguientes campos.

   Nombre de campo	Descripción
   Read Preference Mode	Especifica el miembro del conjunto de réplicas al que se desea dirigir las solicitudes de lectura. Puedes elegir uno de los siguientes en el menú desplegable: primary - para encaminar todas las solicitudes de lectura al set de réplicas primario primaryPreferred - para enrutar todas las solicitudes de lectura al set de réplicas primario y solo a los miembros secundarios si primary no está disponible secondary - para dirigir todas las solicitudes de lectura a los miembros secundarios del set de réplicas secondaryPreferred - para dirigir todas las solicitudes de lectura a los miembros secundarios del set de réplicas y solo al principal en clústeres particionados si los miembros secondary no están disponibles nearest - para derivar todas las solicitudes de lectura a un nodo aleatorio elegible del set de réplicas, independientemente de si ese nodo es un primario o un secundario Si añade un clúster de Atlas como almacén, el valor por defecto es secondary. Si no configuras nada en la configuración de almacenamiento de tu instancia de base de datos federada, el valor por defecto es nearest. Para obtener más información, consulte Modo de preferencia de lectura. IMPORTANTE: Impacto en la Data Federation y el nodo primario. Cuando las consultas de Data Federation se configuran con una preferencia de lectura que apunta a nodos secundarios, no se espera que generen carga en el primario del clúster de Atlas de respaldo. Las queries iniciadas en un secundario mantienen la afinidad del cursor con ese nodo durante toda su vida útil. En algunos registros, las operaciones getMore pueden aparecer con una preferencia de lectura de primaryPreferred. Este es el comportamiento esperado y no indica que el cursor haya cambiado al principal. La primaryPreferred moda es válida tanto en los nodos primarios como en los secundarios y permite a los drivers gestionar cambios de rol poco frecuentes (como que un nodo secundario se convierta en primario) sin volver a emitir la query. La ejecución del cursor continúa en el nodo original a menos que ese nodo cambie de rol. Data Federation aísla sus cargas de trabajo del primario sin requerir ninguna configuración adicional. El uso del modo primaryPreferred asegura la compatibilidad con nodos primarios y secundarios, permitiendo que los drivers gestionen cambios de rol poco comunes, como cuando un nodo secundario se convierte en primario, sin necesidad de volver a emitir la query. La ejecución del cursor continúa en el nodo original a menos que ese nodo cambie de rol.
   TagSets	Especifica la lista de etiquetas o documentos de especificación de etiquetas que contienen pares de nombre y valor para el miembro del set de réplicas al que desea enrutar las solicitudes de lectura. Para obtener más información, consulta Conjuntos de etiquetas de preferencias de lectura.
   Maxstaleness Seconds	Especifica el máximo atraso de la replicación, o "obsolescencia", para la lectura desde secundarias. Para obtener más información, consulte preferencia de lectura maxStalenessSeconds.

4. Haz clic en Add Atlas cluster and collection y repite estos pasos para todos los clústeres de Atlas que desees usar como fuentes de datos.

5. Una vez que hayas terminado de añadir clústeres, haz clic en Continue.

Haz clic Createen.