Instantáneas de tablas

Cada vez que se escribe en una tabla, el lakehouse de PlaidCloud conserva una instantánea de la tabla en ese momento: una copia coherente de los datos en un punto concreto en el tiempo. Las instantáneas le permiten consultar lo que contenía una tabla anteriormente, recuperarse de una mala carga y auditar cómo cambió una tabla con el tiempo. Hasta dónde puede retroceder depende de la configuración de viaje en el tiempo de la tabla: 1 día de forma predeterminada y hasta 90 días para el valor predeterminado del proyecto o para una tabla que lo amplíe. Consulte Administración del almacenamiento.

El panel Instantáneas le permite examinar ese historial, abrir cualquier instantánea en modo de solo lectura en el Explorador de tablas y revertir o restaurar la tabla a una instantánea anterior.

Cada escritura registra una instantánea en un punto concreto en el tiempo. Examine el historial, abra cualquier instantánea en modo de solo lectura en el Explorador de tablas o revierta la tabla a ella; el historial se conserva durante el tiempo que indique la configuración de viaje en el tiempo de la tabla, 1 día de forma predeterminada.

Apertura del panel Instantáneas

En la lista Tablas del proyecto, haga clic en el botón de instantánea/flashback de la fila de una tabla. Se abre el panel Instantáneas, que enumera las instantáneas de la tabla de la más reciente a la más antigua:

• Cuándo: la fecha y la hora en que se tomó la instantánea.
• Filas: el recuento de filas de la tabla en esa instantánea.
• Δ Filas: el cambio en el recuento de filas respecto a la instantánea anterior, para que pueda ver qué agregó o eliminó cada escritura.
• Tamaño: el tamaño de almacenamiento comprimido de la instantánea.
• Etiqueta: un nombre, para las instantáneas que usted haya nombrado o fijado.
• Retenida: un marcador de fijación para las instantáneas que se retienen (se conservan más allá del período de retención normal).

Visualización de los datos en una instantánea

Hay dos formas de ver los datos de una tabla en un momento anterior. Ambas abren el Explorador de tablas en una vista histórica de solo lectura con un aviso que indica qué instantánea está viendo y un botón Volver a los datos actuales.

1. Desde el panel Instantáneas: seleccione una instantánea y haga clic en Ver en la instantánea.
2. Desde el Explorador de tablas: use el menú desplegable As of de la barra de herramientas. Enumera las instantáneas recientes de la tabla; elija una para cambiar la vista, o elija Actual (datos en vivo) para volver a los datos en vivo.

Nota

La vista histórica es de solo lectura: es una ventana al pasado, no una copia editable. Use Revertir o Restaurar (más abajo) si desea recuperar datos antiguos en una tabla.

Reversión o restauración de una instantánea

Seleccione una instantánea y haga clic en Revertir / Restaurar. El cuadro de diálogo ofrece dos opciones:

• Revertir esta tabla en el mismo lugar (predeterminado): sustituye los datos actuales de la tabla por los de la instantánea. Como esta acción es destructiva, debe escribir el nombre de la tabla para confirmar. Antes de sustituir los datos, PlaidCloud captura automáticamente una instantánea de seguridad previa a la reversión del estado actual (en los motores de almacenamiento que admiten la fijación), de modo que siempre pueda volver al punto en que estaba. En un lakehouse de Databend, si las columnas de la tabla han cambiado desde la instantánea, se rechaza una reversión en el mismo lugar, indicando las columnas que cambiaron; en ese caso, restaure en una tabla nueva.
• Restaurar la instantánea en una tabla nueva: deja intacta la tabla original y crea una tabla nueva en el proyecto (usted le asigna un nombre y una carpeta) rellenada a partir de la instantánea, con las mismas columnas que el origen. Mediante el asistente de IA o MCP, una restauración sin nombre indicado toma uno basado en la tabla de origen, por ejemplo Sales (restored 3f2a9c1d).

Precaución

Revertir en el mismo lugar sobrescribe los datos actuales de la tabla. La confirmación escrita y la instantánea de seguridad automática previa a la reversión están ahí para protegerle: lea el cuadro de diálogo antes de confirmar. La reversión se bloquea mientras el proyecto está bloqueado.

Nota

Mediante la API REST o MCP, restaure una instantánea en el mismo lugar omitiendo la tabla de destino o indicando la propia tabla. Una restauración en el mismo lugar recibe allí la misma protección que la reversión del cuadro de diálogo: una instantánea de seguridad previa a la reversión cuando el motor de almacenamiento admite una, y un registro de auditoría. Para que se rechace si la tabla se ha escrito desde que enumeró sus instantáneas, pase la instantánea más reciente que vio como expected_current_snapshot_id.

Nota

Si falla una restauración en una tabla nueva (por ejemplo, porque la instantánea ha caducado), no se agrega ninguna tabla nueva al proyecto.

Nombres, fijación y retención

Las instantáneas caducan según la configuración de viaje en el tiempo de la tabla (1 día de forma predeterminada, hasta 90 días) en la limpieza nocturna. La reversión o restauración funciona hasta el punto restaurable más antiguo que se muestra para la tabla. Para conservar una más tiempo:

• Crear instantánea toma una instantánea retenida de los datos actuales a petición, útil antes de una recarga arriesgada (por ejemplo, “antes de la recarga del 2.º trimestre”).
• Retener fija la instantánea seleccionada; Liberar quita la retención y la devuelve al ciclo de vida normal.

Precaución

Una retención conserva más que la única instantánea: conserva la instantánea retenida y todas las instantáneas escritas después de ella, por lo que el almacenamiento sigue creciendo hasta que libere la retención. Reemplazar una tabla por completo (un upsert o un reemplazo SCD-2) inicia un historial de instantáneas completamente nuevo, y cualquier retención sobre el anterior se pierde con él.

Restaurar todas las tablas de un proyecto a la vez, mediante la API REST, restaura cada tabla a su instantánea retenida más reciente y deja como están las tablas sin retención. Una instantánea de seguridad previa a la reversión no cuenta como retención, aunque el panel Instantáneas puede marcarla como retenida, a menos que usted también retenga esa instantánea, por ejemplo con Retener. Los nombres de instantánea que empiezan por pre-revert_ están reservados para las instantáneas de seguridad. Si alguna tabla no se puede restaurar, las demás se restauran igualmente y la solicitud falla indicando cada tabla que no se restauró y el motivo.

Nota

Nombrar una instantánea a petición está disponible en las tablas de Lakehouse (StarRocks). Retener y liberar una instantánea ahora funciona también en las tablas respaldadas por Databend; allí las instantáneas se siguen conservando durante el período de retención incluso sin retención.

Auditoría

Las reversiones en el mismo lugar, ya sea desde el cuadro de diálogo, la API REST o un asistente de IA, se registran en el registro de auditoría del lakehouse, incluidos quién realizó la reversión, cuándo, la instantánea a la que se revirtió y la instantánea de seguridad que se conservó, de modo que los cambios de tabla realizados mediante esta función son rastreables.