Partilhar via


sys.ledger_column_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 colunas de tabelas do livro-livro: adição, renomeação e eliminação de colunas.

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.
column_id int O ID da coluna numa tabela do livro-maior.
column_name sysname O nome da coluna na tabela de registo. Se a operação alterou o nome da coluna, esta coluna capta o nome da nova coluna.
operation_type tinyint O valor numérico que indica o tipo da operação

0 = CRIAR – criar uma coluna como parte da criação da tabela que contém a coluna usando CREATE TABLE.
1 = ADD – adicionar uma coluna numa tabela de registo, usando ALTER TABLE/ADD COLUMN.
2 = RENOMEAR - renomear uma coluna numa tabela de registo.
3 = DROP - deixar cair uma coluna numa tabela de registo.
operation_type_desc nvarchar(60) Descrição textual do valor da operation_type.
transaction_id bigint Um ID de transação que é único para a base de dados (corresponde a um ID de transação no registo de transações da base de dados).
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 adiciona uma coluna à tabela do livro-compo.

    ALTER TABLE [Employees] ADD Lastname NVARCHAR(256) NULL;
    
  3. Um utilizador renomeia uma coluna da tabela de registo.

    EXEC sp_rename 'dbo.Employees.Lastname', 'Firstname', 'COLUMN';
    
  4. Um utilizador deixa cair uma coluna da tabela de registo.

    ALTER TABLE [Employees] DROP COLUMN Firstname;
    

A consulta abaixo junta sys.ledger_column_history e sys.database_ledger_transactions para produzir o histórico das alterações nas colunas da tabela do livro maior, incluindo a hora de cada alteração e o nome do utilizador que a ativou.

SELECT 
t.[principal_name]
, t.[commit_time]
, h.[column_name] AS [column_name]
, h.[operation_type_desc]
FROM sys.ledger_column_history h
JOIN sys.database_ledger_transactions t
ON h.transaction_id = t.transaction_id
ORDER BY t.[commit_time];

Consulte também