Importante
Característica no disponible en los clústeres Flex
Los clústeres Flex no admiten esta característica en este momento. Para obtener más información, se debe consultar Limitaciones de Atlas Flex.
Después de configurar un fichero en linea, se puede hacer lo siguiente:
Ver tu fichero en linea
Editar tu fichero en línea
Query tu archivo en línea
Borra tu fichero en linea
Importante
El fichero en línea elimina los documentos del clúster utilizando el _id y las claves de partición, si las hay. Para garantizar que no se pierdan datos, pausa el fichero antes de realizar operaciones de particionado, evita actualizar los documentos una vez que cumplan los requisitos para archivarse y asegura la unicidad de _id en todos los documentos de la aplicación.
Acceso requerido
Para visualizar o query un fichero en línea, debe tener Project Read Only acceso o superior al proyecto.
Para editar o borrar un fichero en linea, deberás tener acceso a Project Data Access Admin o superior al Proyecto.
Ver ficheros en linea
Importante
Característica no disponible en los clústeres Flex
Los clústeres Flex no admiten esta característica en este momento. Para obtener más información, se debe consultar Limitaciones de Atlas Flex.
Puedes ver la lista de archivos en línea de un clúster a través de Atlas CLI, Atlas Interfaz de Usuario y API.
Recuperar un fichero en línea utilizando la CLI de Atlas
Para listar todo el fichero en línea de un clúster usando el Atlas CLI, ejecutar el siguiente comando:
atlas clusters onlineArchives list [options]
Para devolver los detalles del fichero en linea que especificas mediante Atlas CLI, ejecuta el siguiente comando:
atlas clusters onlineArchives describe <archiveId> [options]
Para obtener más información sobre la sintaxis y los parámetros de los comandos anteriores, consulta la documentación de Atlas CLI para atlas clusters onlineArchives list y atlas clusters onlineArchives describe.
Recuperar un fichero en linea Usando la API
Para recuperar un fichero en línea a través de la API, envíe una solicitud GET al endpoint ficherosEnLínea con el ID único del fichero en línea que desea recuperar. Para aprender más sobre la sintaxis y las opciones de la API, consulta API.
Recuperar todos los ficheros en linea para un clúster usando la API
Para recuperar todos los archivos en línea configurados para un clúster usando la API, envíe una solicitud GET al endpoint onlineArchives para el clúster. Para obtener más información sobre la sintaxis y las opciones, consulte API.
Consultar los ficheros en línea en la interfaz de usuario
Para ver la lista de ficheros en línea:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Go a la página Online Archive de su clúster.
En la barra lateral, haga clic en Online Archive.
La página fichero en linea se muestra.
La página muestra los ficheros en línea para el clúster. Para cada fichero en línea, puede ver la siguiente información:
Nota
Los valores de las nuevas métricas disponibles con el lanzamiento del 7 de junio de 2023 se muestran en la Interfaz de Usuario de Atlas sólo para ficheros en línea creados después del lanzamiento, en el campo Date Match. Si creas un fichero en línea de serie de tiempo, o si dispones de un fichero en línea preexistente después de la fecha de lanzamiento, Atlas muestra N/A en lugar del valor de las métricas.
Nombre de columna | Descripción | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | Estado del fichero en línea. El valor puede ser uno de los siguientes:
| ||||||||||||||
Actions | Operaciones que puedes realizar en el Online Archive. | ||||||||||||||
Archive Field | Campo de fecha a partir del cual se archivan los documentos. | ||||||||||||||
Custom Criteria | Custom JSON filter. Puede desplazarse en este componente de código. Haciendo clic en el ícono para expandir la vista y ver los criterios personalizados completos. | ||||||||||||||
Age Limit | Número de días utilizados para calificar los documentos para su fichero. | ||||||||||||||
Deletion Age Limit | Número de días después de los cuales se borrarán los datos en el fichero. | ||||||||||||||
Total Data Archived | Tamaño de los datos sin comprimir almacenados en el fichero. Desplácese sobre el icono para ver el número de documentos en el fichero. Métricas disponible solo para nuevos ficheros en línea. | ||||||||||||||
Last Archived Run | Fecha de inicio y marca de tiempo de la última vez que se ejecutó el fichero. Desplácese hacia arriba para ver las últimas cinco tareas. Cada tarea aparece listada con su fecha de inicio, hora de inicio, duración del tiempo para archivar, número de documentos y tamaño. | ||||||||||||||
Partition Fields | Otros campos de query comúnmente utilizados para el particionamiento de datos en el almacenamiento de objetos en la nube. | ||||||||||||||
Schedule | Cadencia de la ventana de fichero. Los valores incluyen: - | ||||||||||||||
Min Date Field | Valor mínimo de fecha de todos los documentos en el fichero. Métrica disponible solo para nuevos ficheros en linea en Atlas Data Federation. | ||||||||||||||
Max Date Field | Valor de fecha máximo de todos los documentos en el fichero. La métrica está disponible solo para nuevos archivos en línea en Atlas Data Federation. |
Ver métricas de rendimiento del fichero en linea
Para ver las métricas de los Archivos en linea en la Interfaz de Usuario de Atlas:
En Atlas, ve a tu instancia federada de base de datos para tu proyecto.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Data Federation en la sección Services.
Se muestra la página Data Federation.
Revisa las métricas.
La página muestra las siguientes métricas para cada instancia federada de base de datos en la sección Online Archive Federated Database Instances:
Consultas ejecutadas al mes | Número de consultas ejecutadas (acumulativo) en el mes calendario actual. Atlas actualiza este valor cada 5 minutos. |
Datos procesados / mes | Cantidad de datos procesados en el mes calendario actual. Atlas actualiza este valor cada 5 minutos. |
Datos devueltos / Mes | Cantidad de datos devueltos en el mes natural en curso. Atlas actualiza este valor cada 5 minutos. |
Última ejecución del fichero | Fecha y hora en que Atlas ejecutó por última vez la tarea de fichero para archivar datos. |
Editar una regla de fichero
Importante
Característica no disponible en los clústeres Flex
Los clústeres Flex no admiten esta característica en este momento. Para obtener más información, se debe consultar Limitaciones de Atlas Flex.
Puedes modificar el número de días para mantener los datos en el clúster de Atlas (el Age Limit) o la consulta personalizada JSON utilizada para seleccionar documentos para archivar desde la Interfaz de Usuario de Atlas y la API. No puedes cambiar el criterio de fichero de Date Match a Custom Filter, o viceversa.
Editar una regla de archivado a través de Atlas CLI
Para actualizar un fichero en línea para un clúster usando el Atlas CLI, ejecuta el siguiente comando:
atlas clusters onlineArchives update <archiveId> [options]
Para obtener más información sobre la sintaxis del comando y los parámetros, consulta la documentación de Atlas CLI para atlas clusters onlineArchives actualizar.
Editar una regla de archivado mediante la API
Para editar un fichero en línea a través de la API, envíe una solicitud PATCH al punto final onlineArchives con el ID único del fichero en línea para actualizar. Para obtener más información sobre la sintaxis y las opciones de la API, consulte API.
Edita una regla de archivado desde la IU
Para editar un fichero en línea, en tu Atlas Interfaz de Usuario:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Go a la página Online Archive de su clúster.
En la barra lateral, haga clic en Online Archive.
La página fichero en linea se muestra.
Haz clic en elipsis (...) en la columna Actions para mostrar la lista de acciones permitidas del fichero en línea. Puedes:
Pause Archiving (solo si el estado es Active)
Edit Archive
Delete Archive
Resume Archiving (solo si el estado es Paused)
Selecciona Edit Archive del menú desplegable para realizar cambios en tu regla de archivado, el número de días para mantener los datos archivados y la ventana de tiempo para ejecutar tareas de archivado de datos.
Puede cambiar los criterios de archivo y el número de días después de los cuales borrar los datos archivados.
Para editar los Date Match criterios, modifica el número de días que Atlas almacena datos en el clúster activo de Atlas en la sección Archival Age Limit.
Para editar Custom Criteria, introduce un filtro JSON válido para seleccionar los documentos que deseas archivar.
Nota
Atlas utiliza la consulta especificada con la db.collection.find(query) orden. Las consultas personalizadas no admiten expresiones de JavaScript. Además, no puedes pasar un documento vacío
{}para devolver todos los documentos.Para modificar el número de días tras los cuales Atlas elimina los datos archivados, introduce o modifica el número de días en la sección Deletion Age Limit. Puedes especificar entre
7y9125días, o dejar el campo vacío para desactivar la regla de expiración de datos. Se requieren 24 horas para que este cambio surta efecto.Para modificar la hora programada de las tareas de archivado de datos, realiza cambios en cualquiera de los siguientes:
Frecuencia. Puedes elegir ejecutar la tarea todos los días, en un día específico de la semana o en una fecha específica de cada mes. Si desea archivar el día 29, 30 o 31 de cada mes, Atlas no ejecuta la tarea de archivo en los meses que no incluyen esas fechas.
Ventana de tiempo. Selecciona el periodo de tiempo durante el cual quieras que Atlas ejecute la tarea de archivado de datos. Debes especificar un mínimo de dos horas.
También puedes desactivar el cronograma desactivando Schedule Archive Window. Si desactivar el cronograma, Atlas revierte al plan por defecto y ejecutará periódicamente la tarea de archivado.
Atlas comienza a utilizar el nuevo cronograma de almacenamiento de datos inmediatamente después de que lo cambies. Sin embargo, si actualmente se está ejecutando una tarea de archivado, Atlas no interrumpe la tarea en curso y la configuración entra en vigor después de que se complete la tarea.
Editar la partición en el almacén de objetos en la nube
No puedes modificar los campos de partición ni la estructura desde la interfaz de usuario de Atlas ni desde la API. Sin embargo, puedes migrar manualmente los datos desde el almacenamiento de objetos en la nube usando $merge, usa $merge para rehidratar datos al clúster de Atlas, borrar el fichero en línea y luego crear un nuevo fichero en línea para la colección con los campos y estructuras de partición deseados.
query fichero Archive en línea
Puede ejecutar queries contra sus datos archivados.
Nota
Atlas Data Federation utiliza almacenamiento en columnas que no conserva el orden de los campos dentro de los documentos. Por lo tanto, Atlas Data Federation no admite consultas que sean sensibles al orden de los campos en tus datos archivados.
Cadena de conexión
Para ejecutar consultas, primero debes conectarte a tu fichero en linea. Tu cadena de conexión del clúster te permite realizar consultas exclusivamente sobre los datos de tu clúster Atlas. Para consultar su Online fichero, debe usar una de las siguientes opciones:
Conéctate a fichero en linea y clúster - esta cadena de conexión de solo lectura permite leer datos directamente desde el clúster en vivo. Esto afecta los recursos disponibles para IOPS, y desde tu en linea fichero.
Conectar al fichero en linea - esta cadena de conexión de solo lectura permite leer datos únicamente del fichero en linea y no afecta los recursos del clúster.
Consideraciones sobre el rendimiento
En general, tus consultas sobre los datos archivados son mucho más lentas que tus consultas sobre los datos en el clúster Atlas. Cuando consultas datos en tu clúster y en el Archivo en línea a través de la cadena de conexión federada:
Las queries de bloqueo, como las ordenaciones que consumen y procesan todos los documentos de entrada en la operación de ordenación antes de devolver los resultados, presentan características de rendimiento asociadas con el almacenamiento más lento, el fichero, que está siendo consultado. Las operaciones de ordenación requieren que se recopilen todos los datos de las fuentes consultadas antes de devolver los resultados.
Las queries en transmisión, como las de búsqueda, tienen características de rendimiento asociadas con el almacenamiento de mayor rendimiento, el clúster de Atlas, que se consulta. Atlas devuelve los resultados tan pronto como están disponibles, lo que significa que recuperar resultados del fichero toma más tiempo que recuperar resultados del clúster de Atlas.
Query Price
Para sus queries federadas y solo de fichero, se incurren en costos por los siguientes elementos.
Análisis de datos
Durante el escaneo de datos, Atlas procesa datos tanto del clúster como del fichero. Atlas ejecuta la mayor parte posible de la query en el clúster para minimizar la cantidad de datos que necesita escanear. Por ejemplo, para una match query que especifica un valor específico, Atlas solo recupera del clúster los documentos con el valor especificado. Luego, Atlas combina los documentos recuperados con los datos de fichero y los devuelve.
Para queries bloqueantes que necesiten acceder a todos los datos almacenados en el clúster subyacente, Atlas recupera todos los datos. Por ejemplo, para un sort (sin match), Atlas recupera todos los datos del clúster y fichero para ser ordenados.
Acceso a los datos
MongoDB cobra una tarifa por cada partición que consultas en el fichero. Si tu query requiere consultar particiones concretas, MongoDB descarga las particiones y cada partición descargada corresponde a un único acceso.
Búsqueda de datos
Para encontrar particiones basadas en la consulta y los campos de la consulta, Atlas realiza operaciones en el fichero. Cada una de estas operaciones que ejecuta Atlas encuentra hasta 1000 particiones. Atlas ejecuta el número mínimo de operaciones requeridas para encontrar las particiones necesarias que satisfagan la query. Por ejemplo, si tu query requiere 100 particiones que están cubiertas en tus campos de query, Atlas ejecuta solo una operación para satisfacer la query.
Transferencia de datos
Los datos que se transfieren a la infraestructura federada incurren en costos de transferencia de datos.
Eliminar un fichero en línea
Importante
Característica no disponible en los clústeres Flex
Los clústeres Flex no admiten esta característica en este momento. Para obtener más información, se debe consultar Limitaciones de Atlas Flex.
Puede borrar un fichero en linea a través de Atlas CLI, Atlas UI y API. Cuando remueve un fichero en línea, Atlas borra todos los ficheros y metadatos en el almacenamiento después de un periodo de cinco días. Una vez que hayas eliminado estos datos, no podrás restaurarlos.
Si se elimina una base de datos o una colección configurada para el archivo en línea, los datos de la colección, si han sido archivados, seguirán estando disponibles en el almacenamiento de objetos en la nube. Incurres costos por almacenamiento en el almacenamiento de objetos en la nube. Como alternativa, si borra el clúster, Atlas borra todos los ficheros en línea configurados para el clúster. Esto también elimina cualquier dato archivado del almacenamiento de objetos en la nube.
Si borras todos los ficheros en línea, también borras la instancia federada de base de datos y creas una nueva instancia federada de base de datos cuando creas un nuevo fichero en línea.
Después de borrar un fichero en linea, su estado pasa a Deleted. Puedes crear otro fichero en linea para la misma base de datos, colección y campos que el fichero en linea borrado si no hay otro fichero en linea para la misma base de datos, colección y campos en el estado Active.
Borrar un fichero en linea mediante la Atlas CLI
Para borrar un fichero en linea de un clúster usando Atlas CLI, ejecutar el siguiente comando:
atlas clusters onlineArchives delete <archiveId> [options]
Para obtener más información sobre la sintaxis y los parámetros del comando, consulta la documentación de Atlas CLI para borrar archivos en línea de clústeres de Atlas.
Borrar un fichero en línea desde la Interfaz de Usuario
Para borrar un fichero en linea, en tu Interfaz de Usuario de Atlas:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Go a la página Online Archive de su clúster.
En la barra lateral, haga clic en Online Archive.
La página fichero en linea se muestra.
Haz clic en elipsis (...) en la columna Actions para mostrar la lista de acciones permitidas del fichero en línea. Puedes:
Pause Archiving (solo si el estado es Active)
Edit Archive
Delete Archive
Resume Archiving (solo si el estado es Paused)
Borrar un fichero en línea a través de la API
Para borrar un fichero en línea mediante la API, envía una solicitud DELETE al onlineArchives punto final con la ID única del fichero en línea que deseas borrar. Para obtener más información sobre la sintaxis y las opciones, consulta API.