Implementar una instancia de base de datos federada

Inicie sesión en MongoDB Atlas.

Seleccione 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.

El valor predeterminado es FederatedDatabaseInstance[n]. Una vez creada la instancia de base de datos federada, no se puede 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, introduzca texto en el campo Specific Collections. El cuadro de diálogo solo muestra las bases de datos y colecciones cuyos nombres coinciden con sus criterios de búsqueda.

2. Haga clic en Continue.

Selecciona un rol IAM de AWS para Atlas.

Puede seleccionar un rol de AWS IAM existente para el cual Atlas esté autorizado desde la lista desplegable de selección de roles 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 S.3

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, haga clic en una de las siguientes opciones:

   • 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 de AWS IAM. Siga los pasos de la interfaz de usuario de Atlas para crear un nuevo rol. Para obtener más información, consulte 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 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.

     • Tras validar el rol, Atlas no creará la instancia de base de datos federada. Sin embargo, el rol está disponible en el menú desplegable de selección de roles y puede usarse para crear una instancia de base de datos federada. No es necesario volver a autorizar el rol.

   • El Use existing AWS IAM role muestra cómo usar el ARN y el ID externo único para agregar Atlas a las relaciones de confianza de un rol de AWS IAM existente. Siga los pasos de la interfaz de usuario de Atlas para agregar 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 modifica su ARN de rol de AWS personalizado en el futuro, asegúrese de que la política de acceso del rol incluya el acceso apropiado a los recursos S para la instancia de base de datos federada.3

   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 AWS IAM.

1. Introduzca el nombre de su depósito S.3

2. Siga los pasos en la interfaz de usuario de Atlas para asignar una política de acceso a su rol de AWS IAM.

3. Haga clic en Validate AWS S3 bucket access.

4. Haga clic en Continue.

Programe sus extracciones de datos.

Programe un disparador para copiar continuamente datos desde su clúster Atlas a su bucket S3 usando $out en la Schedule Queries sección.

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

2. Opcional. Especifique si Atlas Data Federation debe volver a ejecutar la misma consulta si no se pudo realizar por algún motivo. De forma predeterminada, esta opción está deshabilitada para permitir que Atlas Data Federation vuelva a ejecutar las consultas no realizadas. Como alternativa, para omitir las consultas no realizadas y no recuperarlas,Skip Catch Up Events active.

3. Opcional. Elija el formato que desee para sus datos cuando Atlas Data Federation los escriba en su bucket S.Atlas Data3 Federation admite Parquet, CSV, BSON y MongoDB Extended JSON.

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

5. Ingrese el prefijo de AWS para su depósito S3 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.

Seleccione la 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 Explore with Sample Data.

Haga clic en Get Started.

Haga clic en Create.

Inicie sesión en MongoDB Atlas.

Seleccione la 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 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.

El valor predeterminado es FederatedDatabaseInstance[n]. Una vez creada la instancia de base de datos federada, no se puede cambiar su nombre.

Especifique los clústeres Atlas que se utilizarán como fuentes de datos.

1. Seleccione un clúster de Atlas para usarlo como fuente de datos en el menú desplegable. Atlas solo muestra los clústeres de su proyecto actual en este menú desplegable.

2. Expanda las bases de datos y seleccione las colecciones que desea agregar a su instancia de base de datos federada.

   Tip

   Para filtrar las bases de datos y colecciones, introduzca texto en el campo Specific collections. El cuadro de diálogo solo muestra las bases de datos y colecciones cuyos nombres coinciden con sus 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 dirigen las solicitudes de lectura. Puede elegir una de las siguientes opciones en el menú desplegable: primary - para enrutar todas las solicitudes de lectura al conjunto de réplicas principal primaryPreferred - para enrutar todas las solicitudes de lectura al conjunto de réplicas principal y a los miembros secundarios solo 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 enrutar todas las solicitudes de lectura a un miembro aleatorio del conjunto de réplicas elegible, independientemente de si ese miembro es primario o secundario Si agrega un clúster Atlas como tienda, el valor predeterminado es secondary. Si no configura nada en la configuración de almacenamiento de su instancia de base de datos federada, el valor predeterminado nearest es. 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 federación de datos se configuran con una preferencia de lectura dirigida a nodos secundarios, no se espera que generen carga en el nodo principal del clúster Atlas de respaldo. Las consultas iniciadas en un nodo secundario mantienen la afinidad del cursor con ese nodo durante su ciclo de vida. En algunos registros, pueden aparecer operaciones getMore con una preferencia de lectura primaryPreferred. Este comportamiento es normal y no indica que el cursor haya cambiado al nodo principal. El modo primaryPreferred es válido tanto en los nodos principal como secundario y permite a los controladores gestionar cambios de rol poco frecuentes (como que un nodo secundario se convierta en principal) sin tener que volver a ejecutar la consulta. La ejecución del cursor continúa en el nodo original a menos que este cambie de rol. La Federación de Datos aísla sus cargas de trabajo del nodo principal sin necesidad de configuración adicional. El modo primaryPreferred garantiza la compatibilidad con los nodos principal y secundario, lo que permite a los controladores gestionar cambios de rol poco frecuentes (como que un nodo secundario se convierta en principal) sin tener que volver a ejecutar la consulta. La ejecución del cursor continúa en el nodo original a menos que este 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. Haga clic en Add Atlas cluster and collection y repita estos pasos para todos los clústeres Atlas que desee utilizar como fuentes de datos.

5. Una vez que haya terminado de agregar clústeres, haga clic en Continue.

Haga clic en Create.