Partilhar via


sys.ledger_table_history (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores Azure SQL DatabaseAzure SQL Managed Instance

Captura o histórico criptograficamente protegido das operações em tabelas de livro-razão: criação de tabelas-livro-caixa, renomeação de tabelas ou vistas do livro-razão e eliminação de tabelas de registo.

Para mais informações sobre livro-razão de base de dados, consulte Livro Razão

Nome da coluna Tipo de dados Description
object_id int O ID do objeto da tabela do livro-registo.
schema_name sysname O nome do esquema que contém a tabela do livro. Se a operação tiver alterado o nome do esquema, esta coluna capta o novo nome do esquema.
table_name sysname O nome da tabela de registos. Se a operação alterou o nome da tabela, esta coluna capta o novo nome da tabela.
ledger_view_schema_name sysname O nome do esquema que contém a vista do livro razão para a tabela do livro. Se a operação tiver alterado o nome do esquema, esta coluna capta o novo nome do esquema.
ledger_view_name sysname O nome da vista do registo para a tabela do registo. Se a operação alterou o nome da vista, esta coluna capta o novo nome da vista.
operation_type tinyint O valor numérico que indica o tipo da operação

0 = CRIAR – criar uma tabela de registo.
1 = DROP – deixar cair uma tabela de registo.
2 = RENOMEAR - renomear uma tabela de registo.
3 = RENAME_VIEW - renomear a vista do livro razão para uma tabela do livro.
operation_type_desc Nvarchar(60) Descrição textual do valor da operation_type.
transaction_id bigint A transação do ID que incluía a operação na tabela do livro-registo. Identifica uma linha em sys.database_ledger_transactions.
sequence_number bigint O número de sequência da operação dentro da transação.

Permissions

Requer a permissão VIEW LEDGER CONTENT .

Examples

Considere a seguinte sequência de operações em tabelas de registo.

  1. Um utilizador cria uma tabela de registo.

    CREATE TABLE [Employees]
    (
        EmployeeID INT NOT NULL,
        Salary Money NOT NULL
    )
    WITH (SYSTEM_VERSIONING = ON, LEDGER = ON);
    GO
    
  2. Um utilizador renomeia a tabela de registo.

    EXEC sp_rename 'Employees', 'Employees_Copy';
    
  3. Um utilizador renomeia a vista do livro razão da tabela do livro.

    EXEC sp_rename 'Employees_Ledger', 'Employees_Ledger_Copy';
    
  4. Um utilizador deixa cair a tabela do livro-compo.

    DROP TABLE [Employees];
    

A consulta abaixo junta sys.ledger_table_history e sys.database_ledger_transactions para produzir o histórico das alterações nas tabelas do livro-maior, incluindo a hora de cada alteração e o nome do utilizador que a desencadeou.

SELECT 
t.[principal_name]
, t.[commit_time]
, h.[schema_name] + '.' + h.[table_name] AS [table_name]
, h.[ledger_view_schema_name] + '.' + h.[ledger_view_name] AS [view_name]
, h.[operation_type_desc]
FROM sys.ledger_table_history h
JOIN sys.database_ledger_transactions t
ON h.transaction_id = t.transaction_id

Consulte também