Criar e usar tabelas do razão somente de acréscimo

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores daInstância Gerenciada de SQL do Banco de Dados SQL do Azure

Este artigo mostra como criar uma tabela do razão somente de acréscimo. Em seguida, você inserirá valores em sua tabela do razão somente de acréscimo e, em seguida, tentará fazer atualizações nos dados. Por fim, você exibirá os resultados usando o modo de exibição do razão. Usaremos um exemplo de um sistema de acesso de chave de cartão para um estabelecimento, que é um padrão de sistema somente de acréscimo. Nosso exemplo irá fornecer uma visão prática da relação entre a tabela do razão somente de acréscimo e a exibição do razão correspondente.

Para obter mais informações, consulte Tabelas do razão somente de acréscimo.

Pré-requisitos

• SQL Server Management Studio.

Criar tabela do razão somente de acréscimo

Vamos criar uma tabela KeyCardEvents com o esquema a seguir.

1. Use o SQL Server Management Studio para criar um novo esquema e uma tabela chamada [AccessControl].[KeyCardEvents].

   CREATE SCHEMA [AccessControl];
   GO
   CREATE TABLE [AccessControl].[KeyCardEvents]
      (
         [EmployeeID] INT NOT NULL,
         [AccessOperationDescription] NVARCHAR (1024) NOT NULL,
         [Timestamp] Datetime2 NOT NULL
      )
      WITH (LEDGER = ON (APPEND_ONLY = ON));
   

2. Adicione um novo evento de acesso ao estabelecimento à tabela [AccessControl].[KeyCardEvents] com os valores a seguir.

   INSERT INTO [AccessControl].[KeyCardEvents]
   VALUES ('43869', 'Building42', '2020-05-02T19:58:47.1234567');
   

3. Exiba o conteúdo da tabela KeyCardEvents, e especifique as colunas GENERATED ALWAYS que são adicionadas à tabela do razão somente de acréscimo.

   SELECT *
        ,[ledger_start_transaction_id]
        ,[ledger_start_sequence_number]
   FROM [AccessControl].[KeyCardEvents];
   

4. Exiba o conteúdo da exibição do razão KeyCardEvents junto com o modo de exibição do sistema de transações do razão para identificar quem adicionou registros à tabela.

    SELECT
    t.[commit_time] AS [CommitTime] 
    , t.[principal_name] AS [UserName]
    , l.[EmployeeID]
    , l.[AccessOperationDescription]
    , l.[Timestamp]
    , l.[ledger_operation_type_desc] AS Operation
    FROM [AccessControl].[KeyCardEvents_Ledger] l
    JOIN sys.database_ledger_transactions t
    ON t.transaction_id = l.ledger_transaction_id
    ORDER BY t.commit_time DESC;
   

5. Tente atualizar a tabela KeyCardEvents alterando o EmployeeID de 43869 para 34184.

   UPDATE [AccessControl].[KeyCardEvents] SET [EmployeeID] = 34184;
   

   Você receberá uma mensagem de erro informando que as atualizações não são permitidas para sua tabela do razão somente de acréscimo.

   

Permissões

A criação de tabelas do razão somente de acréscimo requer a permissão ENABLE LEDGER. Para obter mais informações sobre as permissões relacionadas às tabelas do razão, confira Permissões.

Conteúdo relacionado

• Tabelas do razão somente de acréscimo
• Como migrar dados de tabelas regulares para tabelas do razão