Parte 4 — Specialized Tables no SQL Server 2025: Ledger Tables

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;

Deixe um comentário

Este site utiliza o Akismet para reduzir spam. Saiba como seus dados em comentários são processados.