Linux でのログ配布の概要

[アーティクル]
01/18/2024

適用対象: SQL Server - Linux

ログ配布は、プライマリサーバーのデータベースが 1 つ以上のセカンダリサーバーにレプリケートされる SQL Server 高可用性 (HA) 構成です。ログ配布により、ソースデータベースからのバックアップファイルをセカンダリサーバーに復元できます。プライマリサーバー内で、トランザクションログのバックアップが定期的に作成され、セカンダリサーバーでそれらが復元されて、データベースのセカンダリコピーが更新されます。

ログ配布のワークフローを示す図。

前記のダイアグラムで説明されているように、ログ配布セッションには次のステップが含まれます。

プライマリ SQL Server インスタンスでのトランザクションログファイルのバックアップ
ネットワーク経由での、1 つまたは複数のセカンダリ SQL Server インスタンスへの、トランザクションログバックアップファイルのコピー
セカンダリ SQL Server インスタンスでのトランザクションログバックアップファイルの復元

前提条件

Linux 上に SQL Server エージェントをインストールします

Note

このチュートリアルでは、CIFS + Samba を使ってネットワーク共有をセットアップします。

プライマリサーバーを構成する

次のコマンドを使用して Samba をインストールします。
- Red Hat Enterprise Linux (RHEL)について:
```
sudo yum -y install samba
```
- Ubuntu の場合:
```
sudo apt-get install samba
```
ログ配布用のログを格納するディレクトリを作成し、必要なアクセス許可を mssql ユーザーに付与します。
```
mkdir /var/opt/mssql/tlogs
chown mssql:mssql /var/opt/mssql/tlogs
chmod 0700 /var/opt/mssql/tlogs
```
/etc/samba/smb.conf ファイルを編集し (ルートアクセス許可が必要です)、次のセクションを追加します。
```
[tlogs]
path=/var/opt/mssql/tlogs
available=yes
read only=yes
browsable=yes
public=yes
writable=no
```
Samba 用の mssql ユーザーを作成します。
```
sudo smbpasswd -a mssql
```

Samba サービスを再起動します。

sudo systemctl restart smbd.service nmbd.service

セカンダリサーバーを構成する

次のコマンドを使用して、この CIFS クライアントをインストールします。
- RHEL の場合:
```
sudo yum -y install cifs-utils
```
- Ubuntu の場合:
```
sudo apt-get install cifs-utils
```
資格情報を格納するためのファイルを作成します。この例では、/var/opt/mssql/.tlogcreds を使用します。 mssql Samba アカウントに対して前に設定したパスワードを使用して、<domain> を置き換えます。
```
username=mssql
domain=<domain>
password=<password>
```

次のコマンドを実行して、マウント用の空のディレクトリを作成し、アクセス許可と所有権を正しく設定します

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

etc/fstab に行を追加して、共有を保持します。 <ip_address_of_primary_server> を適切な値に置き換えます。

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

共有をマウントします。
```
sudo mount -a
```

Transact-SQL を使用してログ配布を設定する

プライマリサーバー内のデータベースをバックアップします。
```
BACKUP DATABASE SampleDB TO DISK = '/var/opt/mssql/tlogs/SampleDB.bak'
GO
```

プライマリサーバー内でログ配布を構成します。

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;

データベースをセカンダリサーバーに復元します。

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

セカンダリサーバー内でログ配布を構成します。

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

ログ配布の動作を確認する

プライマリサーバーで次のジョブを開始して、ログ配布が機能することを確認します。
```
USE msdb;
GO

EXECUTE dbo.sp_start_job N'LSBackup_SampleDB';
GO
```
セカンダリサーバーで次のジョブを開始して、ログ配布が機能することを確認します。
```
USE msdb;
GO

EXECUTE dbo.sp_start_job N'LSCopy_SampleDB';
GO

EXECUTE dbo.sp_start_job N'LSRestore_SampleDB';
GO
```
次のコマンドを実行して、ログ配布フェールオーバーが機能することを確認します。

警告

このコマンドを実行すると、セカンダリデータベースがオンラインになり、ログ配布構成が中断されます。このコマンドを実行した後、ログ配布を再構成する必要があります。
```
RESTORE DATABASE SampleDB WITH RECOVERY;
```

次の方法で共有

Linux でのログ配布の概要

前提条件

プライマリサーバーを構成する

セカンダリサーバーを構成する

Transact-SQL を使用してログ配布を設定する

ログ配布の動作を確認する

フィードバック

その他のリソース

次の方法で共有

Linux でのログ配布の概要

前提条件

CIFS を使用したログ配布用にネットワーク共有をセットアップする

プライマリ サーバーを構成する

セカンダリ サーバーを構成する

Transact-SQL を使用してログ配布を設定する

ログ配布の動作を確認する

関連するコンテンツ

フィードバック

その他のリソース

プライマリサーバーを構成する

セカンダリサーバーを構成する