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
Online Archive deletes documents from the cluster by only using the _id. You must enforce _id uniqueness across all shards in your application. If documents with duplicate _id are present in the cluster during an archival job, Atlas might delete all documents with the same _id, even if only one of them satisfied the archival criteria.
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.
You can view the list of online archives for a cluster through the Atlas CLI, Atlas UI, and 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
To retrieve an online archive through the API, send a GET request to the onlineArchives endpoint with the unique ID of the online archive to retrieve. To learn more about the API syntax and options, see API.
Recuperar todos los archivos en línea de un clúster mediante la API
To retrieve all the online archives configured for a cluster using the API, send a GET request to the onlineArchives endpoint for the cluster. To learn more about the syntax and options, see 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 | Custom JSON filter. You can scroll in this code component. Click the icon to expand the view to see the complete custom criteria. | ||||||||||||||
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.
You can modify the number of days to keep data on the Atlas cluster (the Age Limit) or the custom JSON query used to select documents for archiving from the Atlas UI and API. You can't change the archiving criteria from Date Match to Custom Filter, or vice versa.
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
To edit an online archive through the API, send a PATCH request to the onlineArchives endpoint with the unique ID of the online archive to update. To learn more about the API syntax and options, see 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)
Select Edit Archive from the dropdown to make changes to your archiving rule, the number of days to keep archived data, and the time window for running data archiving jobs.
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.
To edit Custom Criteria, enter a valid JSON filter to select the documents for archiving.
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
You can't modify the partition fields or structure from the Atlas UI or API. However, you can manually migrate the data from the cloud object storage using $merge, use $merge to rehydrate data back to Atlas cluster, delete the online archive, and then create a new online archive for the collection with the desired partition fields and structure.
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:
Connect to Online Archive and Cluster - this read-only connection string allows you to read data directly from the live cluster. This impacts available resources for IOPS, and from your Online Archive.
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.
You can delete an online archive through the Atlas CLI, Atlas UI, and API. When you remove an online archive, Atlas deletes all the files and metadata on the online archive storage after a period of five days. After you delete this data, you can't restore it.
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
To delete an online archive through the API, send a DELETE request to the onlineArchives endpoint with the unique ID of the online archive to delete. To learn more about the syntax and options, see API.