Introdução
Fala, pessoal! Na Parte 2 vimos que a temporal table guarda o histórico. Mas e se um sysadmin mal-intencionado desligar o versionamento, editar o histórico e religar? A temporal table não tem como provar nada. As ledger tables, que chegaram no SQL Server 2022 e seguem no 2025, resolvem exatamente isso: cada transação entra numa cadeia de hashes SHA-256 (uma estrutura tipo blockchain), e qualquer adulteração é detectada na verificação.
Como funciona
O ledger não impede a alteração de dados: ele torna a adulteração evidente (tamper-evidence).
- Updatable ledger table: aceita INSERT, UPDATE e DELETE. Usa uma history table (como a temporal) e uma ledger view que junta tudo.
- Append-only ledger table: só INSERT. Ideal para logs de auditoria, registros de acesso, eventos.
- Colunas ocultas adicionadas automaticamente: ledger_start_transaction_id, ledger_end_transaction_id, ledger_start_sequence_number e ledger_end_sequence_number.
- Database digest: o hash do último bloco. Guardado fora do banco (Azure Blob imutável ou Azure Confidential Ledger), serve de âncora confiável para a verificação.
- Ledger database: criado com LEDGER = ON, faz com que todas as tabelas do banco sejam ledger.
Mão na massa
USE DP800_Lab;
GO
-- A verificação do ledger exige snapshot isolation habilitado no banco
ALTER DATABASE DP800_Lab SET ALLOW_SNAPSHOT_ISOLATION ON;
GO
-- 1. Updatable ledger table: saldo de contas
CREATE TABLE dbo.ContaSaldo
(
ContaId INT NOT NULL PRIMARY KEY,
Titular NVARCHAR(100) NOT NULL,
Saldo DECIMAL(12,2) NOT NULL
)
WITH
(
SYSTEM_VERSIONING = ON (HISTORY_TABLE = dbo.ContaSaldoHistorico),
LEDGER = ON
);
GO
-- 2. Append-only ledger table: trilha de auditoria
CREATE TABLE dbo.LogAcesso
(
Usuario SYSNAME NOT NULL DEFAULT SUSER_SNAME(),
Acao NVARCHAR(50) NOT NULL,
DataHora DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME()
)
WITH (LEDGER = ON (APPEND_ONLY = ON));
GO
-- 3. Movimentando dados
INSERT INTO dbo.ContaSaldo VALUES (1, N'Ana', 1000), (2, N'Bruno', 500);
UPDATE dbo.ContaSaldo SET Saldo = Saldo - 200 WHERE ContaId = 1;
UPDATE dbo.ContaSaldo SET Saldo = Saldo + 200 WHERE ContaId = 2;
DELETE FROM dbo.ContaSaldo WHERE ContaId = 2;
INSERT INTO dbo.LogAcesso (Acao) VALUES (N'LOGIN'), (N'CONSULTA_SALDO');
GO
-- 4. Append-only não aceita UPDATE: este comando gera erro (é o esperado)
BEGIN TRY
UPDATE dbo.LogAcesso SET Acao = N'ADULTERADO';
END TRY
BEGIN CATCH
SELECT ERROR_NUMBER() AS Erro, ERROR_MESSAGE() AS Mensagem;
END CATCH;
GO
-- 5. As colunas ocultas aparecem quando nomeadas explicitamente
SELECT ContaId, Titular, Saldo,
ledger_start_transaction_id,
ledger_start_sequence_number
FROM dbo.ContaSaldo;
-- 6. A ledger view mostra cada operação (INSERT/DELETE) com a transação que a fez
SELECT *
FROM dbo.ContaSaldo_Ledger
ORDER BY ledger_transaction_id, ledger_sequence_number;
-- 7. Quem fez cada transação e quando
SELECT t.transaction_id, t.commit_time, t.principal_name, t.table_hashes
FROM sys.database_ledger_transactions AS t
ORDER BY t.commit_time;
-- Tabelas ledger do banco e seus tipos
SELECT name, ledger_type_desc, ledger_view_id
FROM sys.tables
WHERE ledger_type <> 0;
GO
-- 8. Gerando o digest e verificando a integridade
CREATE TABLE #Digest (latest_digest NVARCHAR(MAX));
INSERT INTO #Digest EXEC sys.sp_generate_database_ledger_digest;
DECLARE @digest NVARCHAR(MAX) = (SELECT latest_digest FROM #Digest);
SELECT @digest AS DigestJSON; -- em produção, guarde este JSON fora do banco
-- Retorna sucesso se nada foi adulterado; erro se houver inconsistência
EXEC sys.sp_verify_database_ledger @digest;
DROP TABLE #Digest;
GO
Em produção, em vez de gerar o digest manualmente, configure o armazenamento automático:
-- Envia o digest automaticamente para um container imutável (exemplo)
ALTER DATABASE SCOPED CONFIGURATION
SET LEDGER_DIGEST_STORAGE_ENDPOINT = 'https://<conta>.blob.core.windows.net';
-- Verificação usando todos os digests armazenados automaticamente
EXEC sys.sp_verify_database_ledger_from_digest_storage;
Pegadinhas
- Não dá para converter uma tabela existente em ledger, nem desligar o ledger depois. A migração é criar a tabela ledger nova e copiar os dados (por exemplo com sys.sp_copy_data_in_batches).
- Ao fazer DROP de uma ledger table, ela é renomeada e mantida como dropped ledger table (veja sys.tables com is_dropped_ledger_table = 1). O histórico não some.
- Append-only não aceita UPDATE nem DELETE, e nenhuma ledger table aceita TRUNCATE.
- Updatable ledger table não precisa de colunas de período; ela usa os IDs de transação no lugar das datas.
- O ledger detecta, não impede: quem tem acesso ainda consegue alterar dados, mas a verificação vai acusar.
Conclusão
Ledger tables trazem confiança verificável para dentro do SQL Server sem precisar de uma blockchain externa: o custo é algum overhead de armazenamento e decisões de design que não têm volta. Para a DP-800, saiba escolher entre os dois tipos, diferenciar de temporal e conhecer o fluxo de digest e verificação. No último post da série vamos modelar relacionamentos de um jeito diferente com as graph tables.
Link para os scripts no GitHub
-- Limpeza opcional: o DROP mantém as tabelas como "dropped ledger tables"
DROP TABLE IF EXISTS dbo.ContaSaldo;
DROP TABLE IF EXISTS dbo.LogAcesso;
