Esta página describe cómo implementar una instancia de base de datos federada para acceder a los datos en un clúster Atlas.
Acceso requerido
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.
Requisitos previos
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.
Procedimiento
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.
Seleccione el proveedor de la nube donde Atlas Data Federation procesará sus consultas contra su instancia de base de datos federada.
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.
Especifique su almacén de datos.
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.
Especifique su fuente de datos.
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].providerconfiguración JSON.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].clusterNameconfiguración JSON.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].databaseydatabases.[n].collections.[n].dataSources.[n].collectionJSON.Opcional. Especifique la Cluster Read Preference configuración expandiendo la sección.
Corresponde
stores.[n].readPreferencea.Nombre de campoDescripciónRead 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 principalprimaryPreferred- para enrutar todas las solicitudes de lectura al conjunto de réplicas principal y a los miembros secundarios solo siprimaryno está disponiblesecondary- para dirigir todas las solicitudes de lectura a los miembros secundarios del set de réplicassecondaryPreferred- 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 miembrossecondaryno están disponiblesnearest- 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
secondaryes.Si no configura nada en la configuración de almacenamiento de su instancia de base de datos federada, el valor predeterminado
nearestes. Para obtener más información, consulte Modo de preferencia de lectura.Corresponde
stores.[n].readPreference.modea.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.tagSetsa.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.maxStalenessSecondsa.Haga clic en Next.
Cree bases de datos, colecciones y vistas virtuales y asigne las bases de datos, colecciones y vistas a su almacén de datos.
(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].nameconfiguració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].nameconfiguració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
$outni$merge. Si la definición de vista incluye etapas de canalización anidadas, como$lookupo$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.
Seleccione Atlas Cluster del menú desplegable en la sección Data Sources.
Arrastre y suelte el almacén de datos para mapearlo con la colección.
Corresponde a la
databases.[n].collections.[n].dataSourcesconfiguració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.
Define tu almacén de datos Atlas.
Edite la configuración JSON que se muestra en la interfaz de usuario para.
storesLastoresconfiguració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,
storesconsulte.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.
databasesLadatabasesconfiguració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,
databasesconsulte.