sys.ledger_table_history (Transact-SQL)

適用対象: SQL Server 2022 (16.x) Azure SQL DatabaseAzure SQL Managed Instance

台帳テーブルでの暗号化で保護された操作 (台帳テーブルの作成、台帳テーブルまたは台帳ビューの名前の変更、台帳テーブルの) の履歴をキャプチャします。

データベース台帳の詳細については、台帳に関する記事を参照してください

列名 データ型 説明
object_id int 台帳テーブルのオブジェクト ID。
schema_name sysname 台帳テーブルを含むスキーマの名前。 操作を行うとスキーマ名が変更される場合、この列によって、新しいスキーマ名がキャプチャされます。
table_name sysname 台帳テーブルの名前。 操作を行うとテーブル名が変更される場合、この列によって、新しいテーブル名がキャプチャされます。
ledger_view_schema_name sysname 台帳テーブルの台帳ビューを含むスキーマの名前。 操作を行うとスキーマ名が変更される場合、この列によって、新しいスキーマ名がキャプチャされます。
ledger_view_name sysname 台帳テーブルの台帳ビューを含む名前。 操作を行うとビュー名が変更される場合、この列によって、新しいビュー名がキャプチャされます。
operation_type tinyint 操作の種類を示す数値

0 = CREATE – 台帳テーブルの作成。
1 = DROP – 台帳テーブルの削除。
2 = RENAME - 台帳テーブル名の変更。
3 = RENAME_VIEW - 台帳テーブルの台帳ビュー名の変更。
operation_type_desc nvarchar(60) operation_type の値のテキスト説明。
transaction_id bigint 台帳テーブルでの操作を含めた ID のトランザクション。 これにより、sys.database_ledger_transactions 内の行が識別されます。
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. ユーザーが台帳テーブルの名前を変更します。

    EXEC sp_rename 'Employees', 'Employees_Copy';
    
  3. ユーザーが台帳テーブルの台帳ビューの名前を変更します。

    EXEC sp_rename 'Employees_Ledger', 'Employees_Ledger_Copy';
    
  4. ユーザーが台帳テーブルを削除します。

    DROP TABLE [Employees];
    

以下のクエリを実行すると、sys.ledger_table_history と sys.database_ledger_transactions が結合され、各変更の時刻や変更をトリガーしたユーザーの名前を含む、台帳テーブルに対する変更の履歴が作成されます。

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

関連項目