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 tu configuración de almacenamiento es visible internamente en MongoDB y se almacena como datos operativos para supervisar y mejorar el rendimiento de Atlas Data Federation. recomendamos que no use PII en sus configuraciones.
Tipos de acceso a los datos
Cuando creas una instancia federada de base de datos, concedes a Atlas uno de los siguientes tipos de acceso a los datos a los buckets de AWS en tu cuenta de 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 tus clústeres de Atlas, Atlas usa tus Controles de acceso basados en roles. 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
actions.actionel parámetro del cuerpo de la solicitud cuando 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 |
|---|---|
Recupere el esquema almacenado para una colección o vista, consulte Ver esquema usando mongosh para obtener 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. | |
Escriba datos desde cualquiera de los almacenes de instancias de base de datos federada compatibles o desde varios almacenes de instancias de base de datos federada compatibles en su contenedor de Azure Blob Storage mediante $out. | |
Escriba datos desde cualquiera de los almacenes de instancias de bases de datos federadas compatibles o desde varios almacenes de instancias de bases de datos federadas compatibles en su depósito de Google Cloud Storage mediante $out. | |
Recupere la configuración de almacenamiento de su instancia de base de datos federada mediante el comando storageGetConfig. | |
Establezca o actualice la configuración de almacenamiento de su instancia de base de datos federada mediante el comando storageSetConfig. |
Recuperar el archivo de configuración
Para recuperar su archivo de configuración de instancia de base de datos federada, conéctese a su instancia y use el siguiente comando:
use admin db.runCommand( { "storageGetConfig" : 1 } )
El comando devuelve la configuración actual de la instancia de base de datos federada.
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>", ... ] }
Actualice la configuración de su instancia de base de datos federada
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 validar la configuración de la instancia federada de base de datos antes de aplicar cualquier cambio.
Para actualizar la configuración de su instancia de base de datos federada, almacenes de datos, fuentes de datos, bases de datos, colecciones y vistas, siga 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 la stores configuración JSON.
Haga clic en Add Data Store Sources.
Seleccione el proveedor de fuente de datos que desea configurar: - Para AWS S3, continúe con el paso 5 de Implementar un almacenar de datos de instancia federada de base de datos. - Para Google Cloud, continúe con el paso 7 de Implementar una instancia federada de base de datos. - Para Azure, continúe al paso 7 de Implementar una instancia federada de base de datos. - Para el clúster de Atlas, continúa con el paso 7 de Implementar un almacén de datos de instancia federada de base de datos. - Para HTTP como almacén de datos, continúa con el paso 7 de Implementar una instancia federada de base de datos. - Para el archivo en línea de Atlas, 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 la stores.[n].name configuración JSON.
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.
Haga clic en Listo.
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 la databases configuración JSON.
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
Haga clic en el botón Crear
Editar el nombre de una base de datos
Corresponde a la databases.[n].name configuración JSON.
Seleccione su 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
Seleccione su base de datos de la lista.
Haga clic en el icono Eliminar 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 la databases.[n].collections configuración JSON.
Seleccione la base de datos desde donde desea crear una colección
Haz clic en el icono Añadir colección
Completa el campo Nombre de la colección
Haga clic en el botón Crear
Editar el nombre de una colección
Corresponde a la databases.[n].collections.[n].name configuración JSON.
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
Haga 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
Crea una nueva Vista en una Colección
Corresponde a la databases.[n].views configuración JSON.
Seleccione la colección desde donde desea crear una vista
Haga clic en el icono Agregar vista
Rellena el campo Nombre de la vista
Complete el campo:manual:`Pipeline </core/aggregation-pipeline/>`
Haga clic en el botón Crear
Editar el nombre de una Vista o pipeline
Corresponde a databases.[n].views.[n].name databases.[n].views.[n].pipeline la configuración JSON y 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 de archivos de configuración JSON para agregar, crear o remover stores, databases o views
Para obtener más información sobre la configuración de su proveedor de almacén de datos específico, consulte 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 comodín está disponible solo para fuentes de datos de AWS S3 y Atlas Clusters.
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 utilizar el comando storageSetConfig para configurar los parámetros para generar colecciones comodín (*).