Importante
Característica no disponible en los clústeres Flex
Los clústeres flexibles no admiten esta funcionalidad en este momento. Para obtener más información, consulte Limitaciones de Atlas Flex.
Después de configurar un fichero en linea, se puede hacer lo siguiente:
Importante
El Archivo en línea elimina documentos del clúster utilizando únicamente el _id. Debes aplicar la unicidad de _id en todas las particiones de tu aplicación. Si hay documentos con duplicados _id presentes en el clúster durante una tarea de archivo, Atlas podría borrar todos los documentos con el mismo _id, incluso si solo uno de ellos cumplía con los criterios de archivo.
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 archivo en línea mediante la API
Para recuperar un archivo en línea mediante la API, envíe una GET solicitud al punto de conexión onlineArchives con el ID único del archivo en línea que desea recuperar. Para obtener más información sobre la sintaxis y las opciones de la API, consulte API.
Recuperar todos los ficheros en linea para un clúster usando la API
Para recuperar todos los ficheros en linea configurados para un clúster mediante la API, envía una solicitud GET al punto final 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 Clusters página para 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.
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 Online Archive. | ||||||||||||||
Archive Field | Campo de fecha en el que 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 archivo. Pase el cursor para ver el número de documentos en el archivo. Métrica disponible solo para nuevos Archivos 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 de base de datos federada 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 que deseas mantener los datos en el clúster de Atlas (el Age Limit) o la JSON custom query utilizada para seleccionar documentos para el archivado desde la Interfaz de Usuario de Atlas y API. No puedes cambiar los criterios de archivado de Date Match a Custom Filter, ni viceversa.
Editar una regla de archivado a través de la CLI de Atlas
Para actualizar un archivo en línea de un clúster mediante la CLI de Atlas, ejecute el siguiente comando:
atlas clusters onlineArchives update <archiveId> [options]
Para obtener más información sobre la sintaxis y los parámetros del comando, consulte la documentación de Atlas CLI para la actualización de Atlas Clusters OnlineArchives.
Editar una regla de archivado mediante la API
Para editar un fichero en línea a través de la API, envía una solicitud PATCH al endpoint onlineArchives con el ID único del fichero en línea a 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.
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 criterios Date Match, modifique la cantidad de días que Atlas almacena datos en el clúster Atlas activo en la sección Archival Age Limit.
Para editar,Custom Criteria ingrese un filtro JSON válido para seleccionar los documentos que desea 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 se puede modificar la estructura ni los campos de la partición 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 utilizando $merge, usar $merge para rehidratar los datos de vuelta al clúster de Atlas, borrar el archivo en línea y luego crear un nuevo archivo en línea para la colección con los campos de partición y la estructura 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:
Conectar al Fichero en línea y Clúster: esta cadena de conexión de solo lectura permite leer datos directamente del clúster en vivo. Esto afecta los recursos disponibles para IOPS y desde tu fichero en linea.
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 consultas de bloqueo, como las ordenaciones que consumen y procesan todos los documentos de entrada antes de devolver los resultados, presentan características de rendimiento asociadas con el almacenamiento más lento (el archivo) consultado. Las operaciones de ordenación requieren 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 consultas federadas y de solo archivo, incurrirá en costos por los siguientes elementos.
Análisis de datos
Durante el análisis de datos, Atlas procesa datos tanto del clúster como del archivo. Atlas ejecuta la mayor parte posible de la consulta en el clúster para minimizar la cantidad de datos que necesita analizar. Por ejemplo, para una consulta match que especifica un valor específico, Atlas solo recupera del clúster los documentos con dicho valor. A continuación, Atlas combina los documentos recuperados con los datos archivados 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 datos
MongoDB cobra una tarifa por cada partición consultada en el archivo. Si su consulta requiere consultar particiones específicas, MongoDB las descarga, 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 generan 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.
Puedes borrar un fichero en línea a través de la Atlas CLI, la Interfaz de Usuario de Atlas y la API. Cuando eliminas un fichero en línea, Atlas borra todos los archivos y metadatos en el almacenamiento de ficheros en línea después de un período de cinco días. Después de que borres estos datos, no puedes restaurarlos.
Si elimina una base de datos o colección configurada para el archivo en línea, los datos de la colección, si están archivados, seguirán estando disponibles en el almacenamiento de objetos en la nube. El almacenamiento en dicho almacenamiento generará costos. Por otro lado, si elimina el clúster, Atlas eliminará todos los archivos en línea configurados para él. Esto también eliminará los datos archivados 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 eliminar un archivo en línea de un clúster mediante la CLI de Atlas, ejecute 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.
Eliminar un archivo 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.
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 a través de la API, envía una solicitud DELETE al endpoint OnlineArchives con el ID único del fichero en línea a borrar. Para obtener más información sobre la sintaxis y las opciones, consulte API.