Docs Menu
Docs Home

Implementar una instancia de base de datos federada con datos de clúster Atlas

Esta página describe cómo implementar una instancia de base de datos federada para acceder a los datos en un clúster Atlas.

Para implementar una instancia de base de datos federada, debe tener Project Owner acceso al proyecto.

Importante

Los usuarios con acceso deben agregarse Organization Owner como Project Owner al proyecto antes de implementar su instancia de base de datos federada.

Antes de comenzar, necesitarás:

  • Crear una CuentaMongoDB Atlas, si aún no tiene una.

  • Create an Atlas Cluster, if you do not have one already. Atlas Data Federation supports Atlas clusters deployed to AWS, Azure, or Google Cloud.

    Nota

    Para utilizar su clúster Atlas como almacén de datos, debe implementarlo en el mismo proyecto que su instancia de base de datos federada.

  • Agregue datos a al menos una colección en su clúster Atlas si aún no lo ha hecho.

Para crear una nueva base de datos de Federación de datos mediante la CLI de Atlas, ejecute el siguiente comando:

atlas dataFederation create <name> [options]

Para obtener más información sobre la sintaxis y los parámetros del comando, consulte la documentación de la CLI de Atlas para atlas dataFederation create.

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

  2. Seleccione Manual Setup.

4

You can select AWS, Azure, or Google Cloud. Once your federated database instance is created, you can't change the cloud provider where Atlas Data Federation processes your queries.

If you want to query data in an Atlas cluster, we recommend that you select that same cloud provider as the cloud provider for your cluster. To query data in object storage such as AWS S3 or Azure Blob Storage, you must select the same cloud for your federated database instance as the cloud for your object storage.

5

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

6
  • Para una experiencia guiada, haga clic en Visual Editor.

  • Para editar el JSON sin procesar, haga clic JSON Editor en.

7
  1. Seleccione el conjunto de datos para su instancia de base de datos federada en la sección Data Sources.

    Haga clic en Add Data Sources para seleccionar su almacén de datos.

  2. Especifique su fuente de datos.

    1. Elija Atlas Cluster para configurar una instancia de base de datos federada para los datos de su clúster Atlas.

      Corresponde a la stores.[n].provider configuración JSON.

    2. Seleccione el clúster Atlas que desea utilizar como almacén de datos en la sección Provide Namespaces in this project.

      Corresponde a la stores.[n].clusterName configuración JSON.

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

      Para filtrar las bases de datos y colecciones, introduzca texto en el campo Search database or collection. El cuadro de diálogo solo muestra las bases de datos y colecciones cuyos nombres coinciden con sus criterios de búsqueda.

      Corresponde a la configuracion de databases.[n].collections.[n].dataSources.[n].database y databases.[n].collections.[n].dataSources.[n].collection JSON.

    4. Opcional. Especifique la Cluster Read Preference configuración expandiendo la sección.

      Corresponde stores.[n].readPreference a.

      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

      IMPORTANTE: Si agrega un clúster Atlas como tienda, el valor predeterminado secondary es.

      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.

      Corresponde stores.[n].readPreference.mode a.

      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.

      Corresponde stores.[n].readPreference.tagSets a.

      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.

      Corresponde stores.[n].readPreference.maxStalenessSeconds a.

    5. Haga clic en Next.

  3. Cree bases de datos, colecciones y vistas virtuales y asigne las bases de datos, colecciones y vistas a su almacén de datos.

    1. (Opcional) Haga clic en el botón para:

      • Base de datos para editar el nombre de la base de datos. El valor predeterminado es VirtualDatabase[n].

        Corresponde a la databases.[n].name configuración JSON.

      • Colección para editar el nombre de la colección. El valor predeterminado es VirtualCollection[n].

        Corresponde a la databases.[n].collections.[n].name configuración JSON.

      • Ver para editar el nombre de la vista.

      Puedes hacer clic:

      • Add Database para agregar bases de datos y colecciones.

      • asociado con la base de datos para agregar colecciones a la base de datos.

      • Asociado a la colección para agregar vistas a la misma. Para crear una vista, debe especificar:

        • El nombre de la vista.

        • La tubería que se aplicará a la vista.

          La canalización de definición de vista no puede incluir las etapas $out ni $merge. Si la definición de vista incluye etapas de canalización anidadas, como $lookup o $facet, esta restricción también se aplica a dichas canalizaciones anidadas.

        Para obtener más información sobre las vistas, consulte:

      • asociado con la base de datos, colección o vista para eliminarlo.

    2. Seleccione Atlas Cluster del menú desplegable en la sección Data Sources.

    3. Arrastre y suelte el almacén de datos para mapearlo con la colección.

      Corresponde a la databases.[n].collections.[n].dataSources configuración JSON.

Su configuración para un almacén de datos de clúster Atlas debería verse similar a la siguiente:

1{
2 "stores" : [
3 {
4 "name" : "<string>",
5 "provider": "<string>",
6 "clusterName": "<string>",
7 "projectId": "<string>",
8 "readPreference": {
9 "mode": "<string>",
10 "tagSets": [
11 [{"name": "<string>", "value": "<string>"},...],
12 ...
13 ],
14 "maxStalenessSeconds": <int>
15 }
16 }
17 ],
18 "databases" : [
19 {
20 "name" : "<string>",
21 "collections" : [
22 {
23 "name" : "<string>",
24 "dataSources" : [
25 {
26 "storeName" : "<string>",
27 "database" : "<string>",
28 "databaseRegex": "<string>",
29 "collection" : "<string>",
30 "collectionRegex" : "<string>",
31 "provenanceFieldName": "<string>"
32 }
33 ]
34 }
35 ],
36 "views" : [
37 {
38 "name" : "<string>",
39 "source" : "<string>",
40 "pipeline" : "<string>"
41 }
42 ]
43 }
44 ]
45}

Para obtener más información sobre estos ajustes de configuración, consulte Configurar almacenes de datos para una instancia de base de datos federada.

  1. Define tu almacén de datos Atlas.

    Edite la configuración JSON que se muestra en la interfaz de usuario para.stores La stores configuración de debería ser similar a la siguiente:

    "stores" : [
    {
    "name" : "<string>",
    "provider" : "<string>",
    "clusterName" : "<string>",
    "projectId": "<string>"
    "readPreference": {
    "mode": "<string>",
    "tagSets": [
    [{"name": "<string>", "value": "<string>"},...],
    ...
    ],
    "maxStalenessSeconds": <int>
    },
    "readConcern": {
    "level": "<string>"
    }
    }
    ]

    Para obtener más información sobre estos ajustes de configuración,stores consulte.

  2. Defina las bases de datos virtuales, colecciones y vistas de su instancia de base de datos federada.

    Edite la configuración JSON que se muestra en la interfaz de usuario para.databases La databases configuración de debería ser similar a la siguiente:

    "databases" : [
    {
    "name" : "<string>",
    "collections" : [
    {
    "name" : "<string>",
    "dataSources" : [
    {
    "storeName" : "<string>",
    "database" : "<string>",
    "databaseRegex": "<string>",
    "collection" : "<string>",
    "collectionRegex" : "<string>",
    "provenanceFieldName": "<string>"
    }
    ]
    }
    ]
    }
    ]

    Para obtener más información sobre estos ajustes de configuración,databases consulte.

9