Esta página contiene comandos generales que se pueden utilizar para configurar, actualizar y recuperar la configuración del almacenamiento de instancias de bases de datos federadas. Para configuraciones específicas de Data Store, como cifrado de AWS S3, consulte la documentación específica de Data Store.
Definir un almacén de datos para una instancia de base de datos federada
Para configurar una tienda de datos para una instancia federada de base de datos, debe crear un archivo JSON de configuración de almacenamiento que defina sus tiendas de datos y las asigne a colecciones que pueda query. MongoDB proporciona soporte para instancia federada de base de datos para los siguientes almacenes de datos:
Importante
La información en la configuración de tu almacenamiento es visible internamente en MongoDB y se almacena como datos operativos para supervisar y mejorar el rendimiento de Atlas Data Federation. Te recomendamos que no utilices PII en tus configuraciones.
Tipos de acceso a los datos
Cuando creas una instancia de base de datos federada, le concedes a Atlas uno de los siguientes tipos de acceso a los datos en los buckets AWS de tu cuenta AWS.
acceso de solo lectura: no puede realizar ningún cambio en los datos ni agregar nuevos datos.
acceso de lectura y guardado: Puede actualizar archivos existentes, borrar archivos o añadir nuevos datos al almacenamiento.
Para acceder a sus clústeres de Atlas, Atlas utiliza sus Controles de acceso basados en roles existentes. Puedes ver y editar el acceso de tu usuario siguiendo los pasos en Gestionar usuarios y roles en implementaciones autogestionadas.
Acciones de privilegio
Las acciones de privilegio son las operaciones que puede realizar en su instancia federada de base de datos. Puedes conceder el privilegio de acción a través de alguno de los siguientes métodos:
Cuando creas o modificas roles personalizados desde la Interfaz de Usuario de Atlas
En el parámetro del cuerpo de la solicitud
actions.actioncuando creas o actualizas un rol personalizado desde la APIde Atlas.
La siguiente tabla muestra las acciones de privilegio disponibles para las instancias federadas de base de datos:
Comando | Descripción |
|---|---|
Recupera el esquema almacenado para una colección o vista. Consulta Ver Esquema Usando mongosh para más detalles. | |
Establece o borra el esquema de una colección o vista, consulta Ver esquema usando mongosh para obtener detalles. | |
Recupera detalles sobre las consultas que se ejecutaron en el pasado usando $queryHistory. | |
Guarda datos desde cualquiera de las instancias federadas de base de datos compatibles o desde múltiples instancias federadas de base de datos compatibles en tu Azure Blob Storage contenedor utilizando $out. | |
Escribe datos desde cualquiera de las instancias federadas de base de datos compatibles o desde múltiples instancias federadas de base de datos compatibles en tu bucket S3 usando $out. | |
Escribe datos de cualquiera de las instancias de almacenes de base de datos federada compatibles o de varias instancias de almacenes de base de datos federada compatibles en tu bucket de Google Cloud Storage usando $out. | |
Recuperar la configuración de almacenamiento de su instancia federada de base de datos usando el comando storageGetConfig. | |
Establezca o actualice la configuración de almacenamiento de la instancia federada de base de datos mediante el comando storageSetConfig. |
Recuperar el archivo de configuración
Para recuperar tu Archivo de configuración de la instancia federada de base de datos, conéctate a tu instancia y usa el siguiente comando:
use admin db.runCommand( { "storageGetConfig" : 1 } )
El comando devuelve la configuración actual de la instancia federada de base de datos.
Validar el archivo de configuración
Para validar la configuración de tu instancia de base de datos federada, conéctate a tu instancia y utiliza el siguiente comando:
use admin db.runCommand( { "storageValidateConfig" : <config> } )
Reemplace <config> con la configuración de la instancia federada de base de datos.
Si la configuración es válida, el comando devuelve la siguiente respuesta:
{ "ok" : 1 }
Si la configuración no es válida, el comando devuelve la lista de errores en el campo errs:
{ "ok" : 1, "errs" : [ "<error>", "<error>", ... ] }
Actualiza la configuración de tu instancia federada de base de datos
Para actualizar la configuración de su instancia de base de datos federada, conéctese a su instancia y utilice el siguiente comando:
use admin db.runCommand( { "storageSetConfig" : <config> } )
Reemplace <config> con la configuración de la instancia federada de base de datos.
Tip
MongoDB recomienda que valide la configuración de su instancia de base de datos federada antes de aplicar cualquier cambio.
Para actualizar la configuración de tu instancia federada de base de datos: almacenes de datos, fuentes de datos, bases de datos, colecciones y vistas, sigue estos pasos:
Realiza tus cambios en la configuración de almacenamiento de la instancia de base de datos federada.
Gestionar fuentes de datos
Agregar una fuente de datos adicional
Corresponde a stores JSON configuración.
Haga clic en Add Data Store Sources.
Seleccione el proveedor de origen de datos que desea configurar: - Para AWS S3, continúe con el paso 5 de Implementar una instancia federada de base de datos. - Para Google Cloud, continúe con el paso 7 de Implementar un almacén de datos de instancia federada de base de datos. - Para Azure, continúa con el paso 7 de Implementar una instancia federada de base de datos Data Store. - Para Atlas, continúa en el paso 7 de Implementar un almacén de datos de instancia federada de base de datos. - Para el almacén de datos HTTP, continúa en el paso 7 de Implementar un almacén de datos de instancia federada de base de datos. - Para Atlas Online Archive, continúa con el paso 7 de Implementar una instancia federada de base de datos.
Edita el nombre de tu fuente de datos
Corresponde a stores.[n].name JSON configuración.
Selecciona tu fuente de almacenamiento de datos de la lista de la izquierda.
Haz clic en el icono Editar nombre de almacenar .
Cambia el nombre actual en el campo Nombre del Almacén de Datos.
Haz clic en Hecho.
Borrar una fuente de datos
Seleccione su fuente de Data Store de la lista a la izquierda
Haz clic en el icono Borrar este almacén
Haz clic en el botón borrar.
Gestionar bases de datos
Crear una nueva base de datos
Corresponde a databases JSON configuración.
Haz clic en el botón Agregar base de datos en la esquina superior derecha.
Rellena el campo Nombre de la base de datos
Completa el campo Nombre de la colección
Haz clic en el botón Crear
Editar el nombre de una base de datos
Corresponde a databases.[n].name JSON configuración.
Selecciona tu base de datos de la lista.
Haz clic en el icono Editar nombre de la base de datos .
Actualizar el Nombre de la Base de Datos.
Haz clic en el botón Listo.
Borrar una base de datos
Selecciona tu base de datos de la lista.
Haz clic en el icono Borrar esta base de datos .
Haz clic en el botón borrar.
Gestionar colecciones
Crear una nueva colección en una base de datos
Corresponde a databases.[n].collections JSON configuración.
Seleccione la base de datos desde la que desea crear una colección
Haz clic en el icono Añadir colección
Completa el campo Nombre de la colección
Haz clic en el botón Crear
Editar el nombre de una colección
Corresponde a databases.[n].collections.[n].name JSON configuración.
Seleccione su colección de la lista
Haz clic en el icono Editar nombre de colección
Cambia el nombre actual en el campo Nombre de colección por tu nuevo nombre
Haz clic en el botón Crear
Borrar una colección
Seleccione su colección de la lista
Haga clic en el icono borrar esta colección
Haz clic en el botón borrar.
Gestionar vistas
Crear una nueva vista en una colección
Corresponde a databases.[n].views JSON configuración.
Seleccione la colección desde donde desea crear una vista
Haz clic en el icono Agregar vista
Rellena el campo Nombre de la vista
Rellene el :manual:`pipeline </core/aggregation-pipeline/>` campo
Haz clic en el botón Crear
Editar el nombre de una Vista o pipeline
Corresponde a databases.[n].views.[n].name y a databases.[n].views.[n].pipeline ajustes de configuración JSON respectivamente.
Selecciona tu Vista de tu Colección
Haz clic en el icono Editar nombre de vista
Cambie el nombre actual en el campo View Name por su nuevo nombre
Cambie el pipeline actual en el campo Pipeline por su nuevo pipeline
Haz clic en el botón Guardar
Borrar una vista
Selecciona tu Vista de la lista
Haz clic en el icono Borrar esta vista
Haz clic en el botón borrar.
Edita los objetos del archivo de configuración JSON para añadir, crear o remover stores, databases o views.
Para obtener más información sobre la configuración de tu proveedor específico de Data Store, consulta su página de archivo de configuración:
Para aprender cómo establecer y gestionar la configuración de almacenamiento utilizando MongoDB Shell (mongosh), consulta la página Gestionar una Instancia Federada de Base de Datos.
Generar colecciones de comodines
Importante
La función de colecciones Wildcard está disponible solo para fuentes de datos provenientes de AWS S3 y clústeres de Atlas.
Cuando utilices fuentes de datos de AWS S3 o clústeres de Atlas, puedes establecer dinámicamente nombres de colecciones que se correspondan con los datos. Para generar un nombre de colección, especifica el símbolo wildcard * como valor para la opción de nombre de colección en la configuración de almacenamiento de tu instancia federada de base de datos.
Tip
Puedes usar el comando storageSetConfig para configurar los ajustes para generar colecciones con comodines (*).