Importante
Característica no disponible en los clústeres Flex
Los clústeres flexibles no admiten esta función actualmente. Para obtener más información, consulte Limitaciones de Atlas Flex.
Después de configurar un archivo en línea, puede hacer lo siguiente:
Ver su archivo en línea
Edite su archivo en línea
Consulta tu archivo en línea
Eliminar su archivo en línea
Importante
El Archivo en línea elimina documentos del clúster utilizando únicamente el _idDebe aplicar la unicidad _id en todos los fragmentos de su aplicación. Si hay documentos con _id duplicado en el clúster durante una tarea de archivado, Atlas podría eliminar todos los documentos con el mismo _id, incluso si solo uno de ellos cumple los criterios de archivado.
Acceso requerido
Para ver o consultar un archivo en línea, debe tener acceso o superior al Project Read Only proyecto.
Para editar o eliminar un archivo en línea, debe tener acceso o superior al Project Data Access Admin proyecto.
Ver archivos 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 ver la lista de archivos en línea de un clúster a través de la CLI de Atlas, la UI de Atlas y API.
Recuperar un archivo en línea mediante la CLI de Atlas
Para enumerar todos los archivos en línea de un clúster mediante la CLI de Atlas, ejecute el siguiente comando:
atlas clusters onlineArchives list [options]
Para devolver los detalles del archivo en línea que especifique mediante la CLI de Atlas, ejecute 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, consulte 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 archivos en línea de un clúster mediante la API
Para recuperar todos los archivos en línea configurados para un clúster mediante la API, envíe una GET solicitud al punto de conexión onlineArchives del clúster. Para obtener más información sobre la sintaxis y las opciones, consulte la API.
Ver archivos en línea en la interfaz de usuario
Para ver la lista de Archivos en línea:
En Atlas, vaya a la Clusters Página para su 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 la publicación del 7 de junio de 2023 se muestran en la interfaz de usuario de Atlas solo para los archivos en línea creados después de la publicación en el campo Date Match. Si crea un archivo en línea de series temporales o ya tiene un archivo en línea después de la fecha de publicación, Atlas muestra N/A en lugar del valor de la métrica.
Nombre de columna | Descripción | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | Estado del archivo 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 | Filtro JSON personalizado. Puede desplazarse por este componente de código. Haga clic en el icono para ampliar la vista y ver todos los criterios personalizados. | ||||||||||||||
Age Limit | Número de días utilizados para calificar los documentos para su archivo. | ||||||||||||||
Deletion Age Limit | Número de días después de los cuales se eliminarán los datos del archivo. | ||||||||||||||
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 ejecución del archivo. Pase el cursor para ver los últimos cinco trabajos. Cada trabajo aparece listado con su fecha y hora de inicio, el tiempo de archivado, el número de documentos y el tamaño. | ||||||||||||||
Partition Fields | Otros campos de consulta de uso común se utilizan para particionar datos en el almacenamiento de objetos en la nube. | ||||||||||||||
Schedule | Cadencia de la ventana de archivado. Valores: - | ||||||||||||||
Min Date Field | Valor mínimo de fecha de todos los documentos del archivo. Métrica disponible solo para nuevos archivos en línea 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 archivo en línea
Para ver las métricas de los Archivos en línea en la interfaz de usuario de Atlas:
En Atlas, vaya a la instancia de base de datos federada para su 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 Federación de datos.
Revisar 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 / Mes | Número de consultas ejecutadas (acumuladas) en el mes 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 calendario actual. Atlas actualiza este valor cada 5 minutos. |
Última ejecución del fichero | Fecha y hora en que Atlas ejecutó por última vez el trabajo de archivo para archivar datos. |
Editar una regla de archivado
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 modificar el número de días que se conservan los datos en el clúster de Atlas Age Limit () o la consulta JSON personalizada que se usa para seleccionar documentos para archivar desde la interfaz de usuario y la API de Atlas. No puede cambiar los criterios de archivado Date Match de Custom Filter a, 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 a través de la API
Para editar un archivo en línea mediante la API, envíe una PATCH solicitud al punto de conexión onlineArchives con el ID único del archivo en línea que desea actualizar. Para obtener más información sobre la sintaxis y las opciones de la API, consulte API.
Editar una regla de archivado a través de la interfaz de usuario
Para editar un archivo en línea, en la 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 (sólo si el estado es Active)
Edit Archive
Delete Archive
Resume Archiving (sólo si el estado es Paused)
Seleccione Edit Archive en el menú desplegable para realizar cambios en su regla de archivado, la cantidad de días para conservar los datos archivados y la ventana de tiempo para ejecutar trabajos de archivado de datos.
Puede cambiar los criterios de archivado y el número de días después de los cuales desea eliminar 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 usa la consulta especificada con el comando db.collection.find(query). Las consultas personalizadas no admiten expresiones JavaScript. Además, no se puede 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, introduzca o modifique el número de días en la sección Deletion Age Limit. Puede especificar entre
7y9125días, o dejar el campo vacío para desactivar la regla de caducidad de datos. Este cambio tarda 24 horas en surtir efecto.Para modificar el tiempo programado para los trabajos de archivado de datos, realice cambios en cualquiera de los siguientes:
Frecuencia. Puede elegir ejecutar el trabajo todos los días, un día específico de la semana o una fecha específica del mes. Si desea archivar los días 29, 30o 31de cada mes, Atlas no ejecuta el trabajo de archivado en los meses que no incluyan esas fechas.
Ventana de tiempo. Seleccione el periodo durante el cual desea que Atlas ejecute el trabajo de archivado de datos. Debe especificar un mínimo de dos horas.
También puede desactivar la programación Schedule Archive Window alternando. Si desactiva la programación, Atlas vuelve a la programación predeterminada y ejecuta la tarea de archivado periódicamente.
Atlas empieza a usar la nueva programación de archivado de datos inmediatamente después de modificarla. Sin embargo, si hay un trabajo de archivado en ejecución, Atlas no lo interrumpe y la configuración se aplica una vez finalizado.
Editar la partición en el almacén de objetos en la nube
No se pueden modificar los campos ni la estructura de la partición desde la interfaz de usuario ni la API de Atlas. Sin embargo, se pueden migrar manualmente los datos desde el almacenamiento de objetos en $merge la nube con, usar $merge para rehidratar los datos de vuelta al clúster deAtlas, eliminar el archivo en línea y, a continuación, crear un nuevo archivo en línea para la colección con los campos y la estructura de la 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, no admite consultas que distingan el orden de los campos en los datos archivados.
Cadena de conexión
Para ejecutar consultas, primero debe conectarse a su Archivo en línea. La cadena de conexión de su clúster le permite consultar únicamente los datos de su clúster Atlas. Para consultar su Archivo en línea, debe usar una de las siguientes opciones:
Conectarse al Archivo en Línea y al Clúster: esta cadena de conexión de solo lectura le permite leer datos directamente desde el clúster activo. Esto afecta los recursos disponibles para IOPS y desde su Archivo en Línea.
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, las consultas a datos archivados son mucho más lentas que las consultas a datos del clúster Atlas. Al consultar datos en el clúster y en el Archivo en línea mediante 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 consultas de streaming, como las búsquedas, tienen características de rendimiento asociadas con el almacenamiento de mayor rendimiento, el clúster Atlas, que se consulta. Atlas devuelve los resultados en cuanto están disponibles, lo que significa que devolver los resultados del archivo tarda más que devolver los resultados del clúster Atlas.
Consulta de precio
Para sus consultas federadas y de solo archivo, incurrirá en costos por los siguientes elementos.
Escaneo 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 las consultas de bloqueo que necesitan 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 del archivo para ordenarlos.
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 según la consulta y sus campos, Atlas ejecuta operaciones en el archivo. Cada operación encuentra hasta 1000 particiones. Atlas ejecuta el número mínimo de operaciones necesarias para encontrar las particiones necesarias para satisfacer la consulta. Por ejemplo, si la consulta requiere 100 particiones cubiertas por los campos de consulta, Atlas solo ejecuta una operación para satisfacer la consulta.
Transferencia de datos
Los datos que se transfieren a la infraestructura federada generan costos de transferencia de datos.
Eliminar un archivo 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 eliminar un archivo en línea mediante la CLI de Atlas, la interfaz de usuario de Atlas y la API. Al eliminar un archivo en línea, Atlas elimina todos los archivos y metadatos del almacenamiento del archivo en línea después de cinco días. Una vez eliminados, no podrá 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.
Tras eliminar un archivo en línea, su estado cambia a Deleted. Puede crear otro archivo en línea para la misma base de datos, colección y campos que el archivo en línea eliminado si no existe otro archivo en línea para la misma base de datos, colección y campos en el estado Active.
Eliminar un archivo en línea a través de la CLI de Atlas
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, consulte la documentación de la CLI de Atlas para atlas clusters onlineArchives delete.
Eliminar un archivo en línea desde la interfaz de usuario
Para eliminar un archivo en línea, en la 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 (sólo si el estado es Active)
Edit Archive
Delete Archive
Resume Archiving (sólo si el estado es Paused)
Eliminar un archivo en línea a través de la API
Para eliminar un archivo en línea mediante la API, envíe una DELETE solicitud al punto de conexión onlineArchives con el ID único del archivo en línea que desea eliminar. Para obtener más información sobre la sintaxis y las opciones, consulte la API.