Introdução ao envio de logs no Linux

Artigo
01/18/2024

Aplica-se a: SQL Server - Linux

O envio de logs é uma configuração de HA (alta disponibilidade) do SQL Server em que um banco de dados de um servidor primário é replicado em um ou mais servidores secundários. O envio de logs permite que os arquivos de backup do banco de dados de origem sejam restaurados no servidor secundário. Em seguida, o servidor primário cria backups de log de transações periodicamente e os servidores secundários os restauram, atualizando a cópia secundária do banco de dados.

Diagrama mostrando o fluxo de trabalho de envio de logs.

Conforme descrito no diagrama anterior, uma sessão de envio de log envolve as seguintes etapas:

Fazer backup do arquivo de log de transações na Instância primária do SQL Server
Copiar o arquivo de backup de log de transações na rede para uma ou mais Instâncias secundárias do SQL Server
Restaurar o arquivo de backup de log de transações nas Instâncias secundárias do SQL Server

Prerequisites

Instalar o SQL Server Agent no Linux

Observação

Este tutorial usa o CIFS e o Samba para configurar o compartilhamento de rede.

Configurar o servidor primário

Instale o Samba com o seguinte comando:
- Para o Red Hat Enterprise Linux (RHEL):
```
sudo yum -y install samba
```
- Para o Ubuntu:
```
sudo apt-get install samba
```
Crie um diretório para armazenar os logs para envio de logs e conceda ao usuário as permissões necessárias:
```
mkdir /var/opt/mssql/tlogs
chown mssql:mssql /var/opt/mssql/tlogs
chmod 0700 /var/opt/mssql/tlogs
```
Edite o arquivo /etc/samba/smb.conf (você precisa de permissões de root) e adicione a seguinte seção:
```
[tlogs]
path=/var/opt/mssql/tlogs
available=yes
read only=yes
browsable=yes
public=yes
writable=no
```
Crie um usuário mssql para o Samba:
```
sudo smbpasswd -a mssql
```

Reinicie os serviços do Samba:

sudo systemctl restart smbd.service nmbd.service

Configure o servidor secundário

Instale o cliente CIFS com o seguinte comando:
- Para o RHEL:
```
sudo yum -y install cifs-utils
```
- Para o Ubuntu:
```
sudo apt-get install cifs-utils
```
Crie um arquivo para armazenar suas credenciais. Neste exemplo, usamos /var/opt/mssql/.tlogcreds. Use a senha que você definiu recentemente para sua conta do Samba mssql e substitua <domain>:
```
username=mssql
domain=<domain>
password=<password>
```

Execute os comandos a seguir para criar um diretório vazio para montar e definir a permissão e a propriedade corretamente

mkdir /var/opt/mssql/tlogs
sudo chown root:root /var/opt/mssql/tlogs
sudo chmod 0550 /var/opt/mssql/tlogs
sudo chown root:root /var/opt/mssql/.tlogcreds
sudo chmod 0660 /var/opt/mssql/.tlogcreds

Adicione a linha a etc/fstab para persistir o compartilhamento. Substitua <ip_address_of_primary_server> pelo valor apropriado:

//<ip_address_of_primary_server>/tlogs /var/opt/mssql/tlogs cifs credentials=/var/opt/mssql/.tlogcreds,ro,uid=mssql,gid=mssql 0 0

Monte os compartilhamentos:
```
sudo mount -a
```

Configurar o envio de logs usando o Transact-SQL

Faça o backup do banco de dados no servidor primário:

BACKUP DATABASE SampleDB TO DISK = '/var/opt/mssql/tlogs/SampleDB.bak'
GO

Configure o envio de logs no servidor primário:

DECLARE @LS_BackupJobId AS UNIQUEIDENTIFIER;
DECLARE @LS_PrimaryId AS UNIQUEIDENTIFIER;
DECLARE @SP_Add_RetCode AS INT;

EXECUTE @SP_Add_RetCode = master.dbo.sp_add_log_shipping_primary_database
    @database = N'SampleDB',
    @backup_directory = N'/var/opt/mssql/tlogs',
    @backup_share = N'/var/opt/mssql/tlogs',
    @backup_job_name = N'LSBackup_SampleDB',
    @backup_retention_period = 4320,
    @backup_compression = 2,
    @backup_threshold = 60,
    @threshold_alert_enabled = 1,
    @history_retention_period = 5760,
    @backup_job_id = @LS_BackupJobId OUTPUT,
    @primary_id = @LS_PrimaryId OUTPUT,
    @overwrite = 1;

IF (@@ERROR = 0 AND @SP_Add_RetCode = 0)
BEGIN
    DECLARE @LS_BackUpScheduleUID AS UNIQUEIDENTIFIER;
    DECLARE @LS_BackUpScheduleID AS INT;

    EXECUTE msdb.dbo.sp_add_schedule
        @schedule_name = N'LSBackupSchedule',
        @enabled = 1,
        @freq_type = 4,
        @freq_interval = 1,
        @freq_subday_type = 4,
        @freq_subday_interval = 15,
        @freq_recurrence_factor = 0,
        @active_start_date = 20170418,
        @active_end_date = 99991231,
        @active_start_time = 0,
        @active_end_time = 235900,
        @schedule_uid = @LS_BackUpScheduleUID OUTPUT,
        @schedule_id = @LS_BackUpScheduleID OUTPUT;

    EXECUTE msdb.dbo.sp_attach_schedule
        @job_id = @LS_BackupJobId,
        @schedule_id = @LS_BackUpScheduleID;

    EXECUTE msdb.dbo.sp_update_job @job_id = @LS_BackupJobId, @enabled = 1;
END

EXECUTE master.dbo.sp_add_log_shipping_alert_job;

EXECUTE master.dbo.sp_add_log_shipping_primary_secondary
    @primary_database = N'SampleDB',
    @secondary_server = N'<ip_address_of_secondary_server>',
    @secondary_database = N'SampleDB',
    @overwrite = 1;

Restaure o banco de dados no servidor secundário:

RESTORE DATABASE SampleDB
FROM DISK = '/var/opt/mssql/tlogs/SampleDB.bak'
WITH NORECOVERY;

Configure o envio de logs no servidor secundário:

DECLARE @LS_Secondary__CopyJobId AS UNIQUEIDENTIFIER;
DECLARE @LS_Secondary__RestoreJobId AS UNIQUEIDENTIFIER;
DECLARE @LS_Secondary__SecondaryId AS UNIQUEIDENTIFIER;
DECLARE @LS_Add_RetCode AS INT;

EXECUTE @LS_Add_RetCode = master.dbo.sp_add_log_shipping_secondary_primary
    @primary_server = N'<ip_address_of_primary_server>',
    @primary_database = N'SampleDB',
    @backup_source_directory = N'/var/opt/mssql/tlogs/',
    @backup_destination_directory = N'/var/opt/mssql/tlogs/',
    @copy_job_name = N'LSCopy_SampleDB',
    @restore_job_name = N'LSRestore_SampleDB',
    @file_retention_period = 4320,
    @overwrite = 1,
    @copy_job_id = @LS_Secondary__CopyJobId OUTPUT,
    @restore_job_id = @LS_Secondary__RestoreJobId OUTPUT,
    @secondary_id = @LS_Secondary__SecondaryId OUTPUT

IF (@@ERROR = 0 AND @LS_Add_RetCode = 0)
BEGIN
    DECLARE @LS_SecondaryCopyJobScheduleUID AS UNIQUEIDENTIFIER;
    DECLARE @LS_SecondaryCopyJobScheduleID AS INT;

    EXECUTE msdb.dbo.sp_add_schedule
        @schedule_name = N'DefaultCopyJobSchedule',
        @enabled = 1,
        @freq_type = 4,
        @freq_interval = 1,
        @freq_subday_type = 4,
        @freq_subday_interval = 15,
        @freq_recurrence_factor = 0,
        @active_start_date = 20170418,
        @active_end_date = 99991231,
        @active_start_time = 0,
        @active_end_time = 235900,
        @schedule_uid = @LS_SecondaryCopyJobScheduleUID OUTPUT,
        @schedule_id = @LS_SecondaryCopyJobScheduleID OUTPUT;

    EXECUTE msdb.dbo.sp_attach_schedule
        @job_id = @LS_Secondary__CopyJobId,
        @schedule_id = @LS_SecondaryCopyJobScheduleID;

    DECLARE @LS_SecondaryRestoreJobScheduleUID AS UNIQUEIDENTIFIER;
    DECLARE @LS_SecondaryRestoreJobScheduleID AS INT;

    EXECUTE msdb.dbo.sp_add_schedule
        @schedule_name = N'DefaultRestoreJobSchedule',
        @enabled = 1,
        @freq_type = 4,
        @freq_interval = 1,
        @freq_subday_type = 4,
        @freq_subday_interval = 15,
        @freq_recurrence_factor = 0,
        @active_start_date = 20170418,
        @active_end_date = 99991231,
        @active_start_time = 0,
        @active_end_time = 235900,
        @schedule_uid = @LS_SecondaryRestoreJobScheduleUID OUTPUT,
        @schedule_id = @LS_SecondaryRestoreJobScheduleID OUTPUT;

    EXECUTE msdb.dbo.sp_attach_schedule
        @job_id = @LS_Secondary__RestoreJobId,
        @schedule_id = @LS_SecondaryRestoreJobScheduleID;
END

DECLARE @LS_Add_RetCode2 AS INT;

IF (@@ERROR = 0 AND @LS_Add_RetCode = 0)
BEGIN
    EXECUTE @LS_Add_RetCode2 = master.dbo.sp_add_log_shipping_secondary_database
        @secondary_database = N'SampleDB',
        @primary_server = N'<ip_address_of_primary_server>',
        @primary_database = N'SampleDB',
        @restore_delay = 0,
        @restore_mode = 0,
        @disconnect_users = 0,
        @restore_threshold = 45,
        @threshold_alert_enabled = 1,
        @history_retention_period = 5760,
        @overwrite = 1;
END

IF (@@ERROR = 0 AND @LS_Add_RetCode = 0)
BEGIN
    EXECUTE msdb.dbo.sp_update_job
        @job_id = @LS_Secondary__CopyJobId,
        @enabled = 1;

    EXECUTE msdb.dbo.sp_update_job
        @job_id = @LS_Secondary__RestoreJobId,
        @enabled = 1;
END

Verificar se o envio de logs funciona

Verifique se o envio de logs funciona iniciando o trabalho a seguir no servidor primário:
```
USE msdb;
GO

EXECUTE dbo.sp_start_job N'LSBackup_SampleDB';
GO
```

Verifique se o envio de logs funciona iniciando o trabalho a seguir no servidor secundário:

USE msdb;
GO

EXECUTE dbo.sp_start_job N'LSCopy_SampleDB';
GO

EXECUTE dbo.sp_start_job N'LSRestore_SampleDB';
GO

Verifique se o failover do Envio de Logs funciona executando o seguinte comando:

Aviso

Este comando colocará o banco de dados secundário online e interromperá a configuração de Envio de Logs. Você precisa reconfigurar o Envio de Logs depois de executar este comando.
```
RESTORE DATABASE SampleDB WITH RECOVERY;
```

Compartilhar via

Introdução ao envio de logs no Linux

Prerequisites

Configurar o servidor primário

Configure o servidor secundário

Configurar o envio de logs usando o Transact-SQL

Verificar se o envio de logs funciona

Comentários

Recursos adicionais

Compartilhar via

Introdução ao envio de logs no Linux

Prerequisites

Configurar um compartilhamento de rede para o envio de logs usando o CIFS

Configurar o servidor primário

Configure o servidor secundário

Configurar o envio de logs usando o Transact-SQL

Verificar se o envio de logs funciona

Conteúdo relacionado

Comentários

Recursos adicionais