Esta página contiene comandos generales que puede usar para establecer, actualizar y recuperar la configuración de almacenamiento de instancias de bases de datos federadas. Para una configuración específica del almacén de datos, como AWS S3 Encryption, consulte la documentación específica del almacén de datos.
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 de su 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. Le recomendamos que no la utilice. PII en sus configuraciones.
Tipos de acceso a datos
Cuando crea una instancia de base de datos federada, le otorga a Atlas uno de los siguientes tipos de acceso a datos a los depósitos de AWS en su cuenta de AWS.
Acceso desolo lectura: no puede realizar cambios en los datos ni agregar datos nuevos.
Acceso de lectura y escritura: puede actualizar archivos existentes, eliminar archivos o agregar nuevos datos al almacenamiento.
Para acceder a sus clústeres Atlas, Atlas utiliza sus clústeres existentes Controles de acceso basados en roles. Puede ver y editar el acceso de sus usuarios siguiendo los pasos de "Administrar usuarios y roles en implementaciones autogestionadas".
Acciones de privilegio
Las acciones con privilegios son las operaciones que puede realizar en su instancia de base de datos federada. Puede otorgar la acción con privilegios mediante una de las siguientes opciones:
Al crear o modificar roles personalizados desde la interfaz de usuario de Atlas
En el
actions.actionParámetro del cuerpo de la solicitud cuando crea o actualiza un rol personalizado desde la API de Atlas
La siguiente tabla muestra las acciones de privilegios de instancia de base de datos federada disponibles:
Comando | Descripción |
|---|---|
Recupere el esquema almacenado para una colección o vista, consulte Ver esquema usando mongosh para obtener más detalles. | |
Establezca o elimine el esquema para una colección o vista; consulte Ver esquema usando mongosh para obtener más detalles. | |
Recupere 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 bucket S3 usando $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 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 archivo de configuración
Para validar la configuración de su instancia de base de datos federada, conéctese a su instancia y use el siguiente comando:
use admin db.runCommand( { "storageValidateConfig" : <config> } )
Reemplace <config> con la configuración de la instancia de base de datos federada.
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 use el siguiente comando:
use admin db.runCommand( { "storageSetConfig" : <config> } )
Reemplace <config> con la configuración de la instancia de base de datos federada.
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 su instancia de base de datos federada, almacenes de datos, fuentes de datos, bases de datos, colecciones y vistas, siga estos pasos:
Realice 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 origen de datos que desea configurar: - Para AWS S,3 5 continúe con el 7 7 paso 7 de Implementar un almacén de datos de instancia de base de datos federada. - Para Google Cloud, continúe con el paso de Implementar un almacén 7 de datos de instancia de base de datos federada. - Para Azure, continúe con el paso de Implementar un almacén de datos de instancia de base de datos federada. - Para Atlas Cluster, continúe con el paso de Implementar un almacén de datos de instancia de base de datos federada. - Para el almacén de datos HTTP, continúe con el paso de Implementar un almacén de datos de instancia de base de datos federada. - Para Atlas Online Archive, continúe con el paso 7 de Implementar un almacén de datos de instancia de base de datos federada.
Editar el nombre de su fuente de datos
Corresponde a la stores.[n].name configuración JSON.
Seleccione la fuente de su almacén de datos de la lista de la izquierda.
Haga clic en el icono Editar nombre de la tienda.
Cambie el nombre actual en el campo Nombre del almacén de datos.
Haga clic en Listo.
Eliminar una fuente de datos
Seleccione la fuente de su almacén de datos de la lista de la izquierda
Haga clic en el icono Eliminar esta tienda
Haga clic en el botón Eliminar.
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.
Complete el campo Nombre de la base de datos
Complete 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 .
Actualice 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.
Haga clic en el botón Eliminar.
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
Haga clic en el icono Agregar colección
Complete 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
Haga clic en el icono Editar nombre de la colección
Cambie el nombre actual en el campo Nombre de la colección por su 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
Haga clic en el botón Eliminar.
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
Complete el campo Nombre de la vista
Complete el campo:manual:`Pipeline </core/aggregation-pipeline/>`
Haga clic en el botón Crear
Editar un nombre de vista o canalización
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
Haga clic en el icono Editar nombre de vista
Cambie el nombre actual en el campo Ver nombre por su nuevo nombre
Cambie la tubería actual en el campo Tubería para su nueva tubería
Haz clic en el botón Guardar
Borrar una vista
Seleccione su vista de la lista
Haga clic en el icono Eliminar esta vista
Haga clic en el botón Eliminar.
Edite los objetos del archivo de configuración JSON para agregar, crear o stores eliminar, 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 a configurar y administrar la configuración de almacenamiento mediante MongoDB Shell (mongosh), consulte la página Administrar una instancia de base de datos federada.
Generar colecciones de comodines
Importante
La función de colecciones de comodines solo está disponible para fuentes de datos de AWS S3 y Atlas Clusters.
Al usar orígenes de datos de AWS S3 o clústeres de Atlas, puede configurar dinámicamente nombres de colección que se asignen a los datos. Para generar un nombre de colección, especifique el símbolo * comodín como valor para la configuración del nombre de colección en la configuración de almacenamiento de la instancia de base de datos federada.
Tip
Puede utilizar el comando storageSetConfig para configurar los ajustes para generar* colecciones de comodines ().