Implementar una instancia federada de base de datos

Inicie sesión en MongoDB Atlas.

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

Crear una instancia de base de datos federada.

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

2. Seleccione Feed Downstream Systems.

Haga clic en Get Started.

Escriba un nombre para su instancia federada de base de datos 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.

Selecciona un rol IAM de AWS para Atlas.

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

Si seleccionó un rol existente para el cual Atlas está autorizado, continúe con el siguiente paso para enumerar sus buckets de AWS S3.

Si está autorizando a Atlas para un rol existente o está creando un rol nuevo, complete los siguientes pasos antes de continuar con el siguiente paso:

1. En el menú desplegable, seleccione Authorize an AWS IAM Role para autorizar un nuevo rol o seleccionar 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 de 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 la ID externa única para agregar Atlas a las relaciones de confianza de un nuevo rol IAM en AWS. Sigue los pasos en la Interfaz de Usuario de Atlas para crear un nuevo rol. Para aprender más, consulta Crear un nuevo rol con la CLI de AWS.

     Al autorizar un nuevo rol, si abandona el flujo de trabajo:

     • Antes de validar el rol, Atlas no creará la instancia federada de base de datos. Puedes ir a la página de Atlas Integrations para autorizar un nuevo rol y luego iniciar el procedimiento para implementar una instancia federada de base de datos nuevamente cuando tengas el rol de IAM de AWS y ARN.

     • 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 único ID externo para agregar Atlas a las relaciones de confianza de un AWS IAM 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, consulte Agregar relaciones de confianza a un rol existente .

   Importante

   Si modificas tu AWS ARN de rol personalizado en el futuro, asegúrate de que la política de acceso del rol incluya el acceso adecuado a los S3 recursos para la instancia federada de base de datos.

   Para obtener más información,consulte Configurar el acceso unificado a AWS y Crear un rol de acceso de proveedor de nube.

3. Haga clic en Validate AWS IAM role.

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

1. Introduzca el nombre de su bucket S3.

2. Siga los pasos en la interfaz de usuario de Atlas para asignar una política de acceso a su rol IAM de 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 continuamente datos desde tu clúster de Atlas en tu S3 bucket usando $out en la sección de 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 guarde en tu bucket S3. Atlas Data Federation admite Parquet, CSV , BSON , y MongoDB Extended JSON.

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

5. Introduzca el prefijo de AWS para su S3 bucket de destino.

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

7. Haga clic en Continue.

Haga clic en Create.

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. Haga clic en el menú desplegable Create New Federated Database.

2. Seleccione Explore with Sample Data.

Haga clic en Get Started.

Haga clic en Create.

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. Haga clic en el menú desplegable Create New Federated Database.

2. Seleccione Query Data Across Clusters.

Haga clic en Get Started.

Escriba un nombre para su instancia federada de base de datos 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. Expanda la Cluster Read Preference configuración 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 agrega un clúster Atlas como tienda, el valor predeterminado 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: Federación de datos e impacto en el nodo principal 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 conjunto de réplicas al que se desean enrutar las solicitudes de lectura. Para obtener más información, consulte Conjuntos de etiquetas de preferencia de lectura.
   Maxstaleness Seconds	Especifica el retardo máximo de replicación, o "obsolescencia", para las lecturas de los secundarios. 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.

Haga clic en Create.