Time Travel en el Lakehouse de Microsoft Fabric: paso a paso

João Barros 25 de July de 2026 4 min de lectura

Time Travel en el Lakehouse de Microsoft Fabric permite ver y recuperar versiones anteriores de datos Delta. Esta funcionalidad es útil para auditoría, recuperación de datos tras cambios accidentales o comparar estados históricos de una tabla.

Requisitos previos

Cuenta Microsoft Fabric con permisos de Writer en el Lakehouse.
Un Lakehouse con al menos una tabla Delta (p. ej.: nome_da_tabela).
Acceso a un SQL query endpoint del Warehouse o un Notebook con soporte para SQL.
Permiso para ejecutar operaciones de administración en la tabla (RESTORE/SELECT).

Paso 1: Verificar el historial de la tabla

El primer paso es ver el historial de commits de la tabla para identificar la versión o timestamp que quieres recuperar. Usa DESCRIBE HISTORY para obtener las versiones, con autor, timestamp y mensaje.

DESCRIBE HISTORY nome_da_tabela;

Analiza las columnas version y timestamp para elegir la versión objetivo. Anota el número de versión (p. ej.: 5) o el timestamp.

Paso 2: Consultar una versión específica (Time Travel read)

Antes de cualquier cambio, puedes inspeccionar la versión antigua sin modificarla. Usa VERSION AS OF en una SELECT para leer los datos en esa versión.

SELECT *
FROM nome_da_tabela VERSION AS OF 5
LIMIT 100;

Esto crea una lectura consistente de la versión 5. Útil para validar que los datos que quieres recuperar son los correctos.

Paso 3: Exportar o crear una copia de la versión antigua

Es recomendable crear una copia antes de restaurar. Puedes crear una tabla nueva con el contenido de la versión antigua o exportar a un archivo en OneLake.

-- Criar uma tabela temporária com a versão antiga
CREATE TABLE nome_da_tabela_backup_v5 AS
SELECT * FROM nome_da_tabela VERSION AS OF 5;

-- Ou exportar para CSV em OneLake (ajusta o caminho conforme o teu OneLake)
COPY INTO 'OneLake:////nome_da_tabela_v5.csv'
FROM (SELECT * FROM nome_da_tabela VERSION AS OF 5)
WITH (FILE_TYPE='CSV', HEADER=TRUE);

Tener una copia evita pérdida de datos si algo sale mal durante el proceso de restauración.

Paso 4: Restaurar la tabla a la versión anterior

Cuando ya has confirmado la versión correcta y tienes una copia, puedes restaurar la tabla a la versión deseada. El comando siguiente ajusta la tabla al estado de la versión 5.

RESTORE TABLE nome_da_tabela TO VERSION AS OF 5;

Después de ejecutarlo, la tabla pasa a reflejar el contenido de la versión especificada. Dependiendo de los permisos y de la política de la organización, este comando puede requerir permisos administrativos.

Paso 5: Validar la restauración y buenas prácticas

Tras la restauración, confirma que la tabla está en el estado esperado y registra los cambios para auditoría. Evita ejecutar procesos que eliminen históricos (p. ej.: VACUUM) sin acuerdo, porque borran meta-información necesaria para Time Travel.

-- Verificar a versão actual
SELECT MAX(version) AS versao_actual
FROM (DESCRIBE HISTORY nome_da_tabela);

-- Ler os dados restaurados
SELECT TOP 100 * FROM nome_da_tabela;

Registra en los logs quién hizo la restauración, la versión objetivo y el motivo. Mantén backups (copias en OneLake) para recuperación alternativa.

Verificar el resultado

Confirma el éxito con estos pasos: 1) DESCRIBE HISTORY nome_da_tabela debe mostrar un nuevo commit de restauración o el apuntador a la versión restaurada; 2) ejecuta una SELECT simple para validar datos; 3) compara fila a fila con la tabla de backup creada en el Paso 3.

-- Comparação simples
SELECT COUNT(*) AS total_original
FROM nome_da_tabela_backup_v5;

SELECT COUNT(*) AS total_restaurado
FROM nome_da_tabela;

Conclusión

Time Travel en el Lakehouse de Microsoft Fabric facilita recuperar estados anteriores de tablas Delta para auditoría y recuperación de errores. Próximos pasos: automatizar checkpoints antes de cambios críticos, integrar checks en el CI/CD y definir políticas de retención del historial. Consejo: antes de usar VACUUM o políticas de limpieza, asegúrate de que no vas a perder la capacidad de restaurar versiones importantes — ¿cuál es la versión más crítica que debes poder recuperar en tu organización?