sys.ledger_column_history （Transact-SQL）

  • 發行項

適用於： SQL Server 2022 (16.x) Azure SQL DatabaseAzure SQL 受控執行個體

擷取總帳資料表資料行上作業的密碼編譯保護歷程記錄：新增、重新命名和卸載資料行。

如需資料庫總帳的詳細資訊，請參閱 總帳

資料行名稱 資料類型 描述
object_id int 總帳資料表的物件識別碼。
column_id int 總帳資料表中資料行的資料行識別碼。
column_name sysname 總帳資料表中資料行的名稱。 如果作業已變更資料行名稱，此資料行會擷取新的資料行名稱。
operation_type tinyint 數值，表示作業的類型

0 = CREATE – 使用 CREATE TABLE 建立包含資料行之資料表的一部分來建立資料行。
1 = ADD – 使用 ALTER TABLE/ADD COLUMN 在總帳資料表中新增資料行。
2 = RENAME - 重新命名總帳資料表中的資料行。
3 = DROP - 卸載總帳資料表中的資料行。
operation_type_desc nvarchar(60) operation_type 值的文字描述。
transaction_id bigint 資料庫唯一的交易識別碼（它對應至資料庫交易記錄中的交易識別碼）。
sequence_number bigint 交易中作業的序號。

權限

需要 VIEW LEDGER CONTENT 許可權。

範例

請考慮總帳資料表上的下列作業順序。

  1. 使用者建立總帳資料表。

    CREATE TABLE [Employees]
(
    EmployeeID INT NOT NULL,
    Salary Money NOT NULL
)
WITH (SYSTEM_VERSIONING = ON, LEDGER = ON);
GO

  2. 使用者會將資料行新增至總帳資料表。

    ALTER TABLE [Employees] ADD Lastname NVARCHAR(256) NULL;

  3. 使用者重新命名總帳資料表的資料行。

    EXEC sp_rename 'dbo.Employees.Lastname', 'Firstname', 'COLUMN';

  4. 使用者卸載總帳資料表的資料行。

    ALTER TABLE [Employees] DROP COLUMN Firstname;

下列查詢會聯結sys.ledger_column_history和sys.database_ledger_transactions，以產生總帳資料表資料行變更的歷程記錄，包括每次變更的時間，以及觸發變更的使用者名稱。

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];

另請參閱