sys.ledger_table_history (Transact-SQL)
適用対象: SQL Server 2022 (16.x) Azure SQL データベース Azure 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 権限が必要です。
例
台帳テーブルに対する次の一連の操作を考慮してください。
ユーザーが台帳テーブルを作成します。
CREATE TABLE [Employees] ( EmployeeID INT NOT NULL, Salary Money NOT NULL ) WITH (SYSTEM_VERSIONING = ON, LEDGER = ON); GO
ユーザーが台帳テーブルの名前を変更します。
EXEC sp_rename 'Employees', 'Employees_Copy';
ユーザーが台帳テーブルの台帳ビューの名前を変更します。
EXEC sp_rename 'Employees_Ledger', 'Employees_Ledger_Copy';
ユーザーが台帳テーブルを削除します。
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