sys.ledger_table_history (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Captura o histórico de operações protegido criptograficamente em tabelas do razão: criação de tabelas do razão, renomeação de tabelas do razão ou exibições do razão e remoção de tabelas do razão.

Para obter mais informações sobre o razão do banco de dados, confira Razão

Nome da coluna Tipo de dados Descrição
object_id int A ID do objeto da tabela do razão.
schema_name sysname O nome do esquema que contém a tabela do razão. Se a operação tiver alterado o nome do esquema, essa coluna capturará o novo nome de esquema.
table_name sysname O nome da tabela do razão. Se a operação tiver alterado o nome da tabela, essa coluna capturará o novo nome da tabela.
ledger_view_schema_name sysname O nome do esquema que contém a exibição do razão para a tabela do razão. Se a operação tiver alterado o nome do esquema, essa coluna capturará o novo nome de esquema.
ledger_view_name sysname O nome da exibição do razão para a tabela do razão. Se a operação tiver alterado o nome da exibição, essa coluna capturará o novo nome de exibição.
operation_type tinyint O valor numérico que indica o tipo da operação

0 = CREATE – criação de uma tabela do razão.
1 = DROP – remoção de uma tabela do razão.
2 = RENAME – renomeação de uma tabela do razão.
3 = RENAME_VIEW – renomeação da exibição do razão para uma tabela do razão.
operation_type_desc nvarchar(60) Descrição textual do valor de operation_type.
transaction_id bigint A transação da ID que incluiu a operação na tabela do razão. Ele identifica uma linha em sys.database_ledger_transactions.
sequence_number bigint O número da sequência da operação dentro da transação.

Permissões

Exige a permissão VIEW LEDGER CONTENT.

Exemplos

Considere a sequência de operações a seguir nas tabelas do razão.

  1. Um usuário cria uma tabela do razão.

    CREATE TABLE [Employees]
    (
        EmployeeID INT NOT NULL,
        Salary Money NOT NULL
    )
    WITH (SYSTEM_VERSIONING = ON, LEDGER = ON);
    GO
    
  2. Um usuário renomeia a tabela do razão.

    EXEC sp_rename 'Employees', 'Employees_Copy';
    
  3. Um usuário renomeia a exibição do razão da tabela do razão.

    EXEC sp_rename 'Employees_Ledger', 'Employees_Ledger_Copy';
    
  4. Um usuário remove a tabela do razão.

    DROP TABLE [Employees];
    

A consulta abaixo une sys.ledger_table_history e sys.database_ledger_transactions para produzir o histórico de alterações nas tabelas do razão, incluindo o tempo de cada uma e a alteração e o nome do usuário que a disparou.

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

Confira também