Configure a replicação com Transact-SQL

Aplica-se a: SQL Server no Linux

Neste tutorial, configure a replicação de instantâneo do SQL Server no Linux com duas instâncias do SQL Server usando T-SQL (Transact-SQL). O publicador e o distribuidor estão na mesma instância e o assinante está em uma instância separada.

Habilitar agentes de Replicação do SQL Server em Linux
Criar banco de dados de exemplo
Configurar a pasta de instantâneo para acesso aos agentes do SQL Server
Configurar o distribuidor
Configurar o publicador
Configurar a publicação e os artigos
Configurar o assinante
Executar os trabalhos de replicação

Você pode configurar todos os componentes de replicação com procedimentos armazenados de replicação.

Pré-requisitos

Para concluir este tutorial, você precisará:

Duas instâncias do SQL Server com a versão mais recente do SQL Server em Linux
Uma ferramenta para emitir consultas T-SQL para configurar a replicação, como sqlcmd ou SSMS (SQL Server Management Studio)

Consulte Usar o SQL Server Management Studio no Windows para gerenciar o SQL Server no Linux.

Note

O SQL Server Replication é suportado no Linux no SQL Server 2017 (14.x) CU 18 e versões posteriores. Para mais informações, veja Informações de lançamento para SQL Server no Linux.

Etapas detalhadas

Habilitar agentes de Replicação do SQL Server em Linux. Nas duas máquinas de host, execute os seguintes comandos no terminal.
```
sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true
sudo systemctl restart mssql-server
```

Crie o banco de dados de exemplo e a tabela. No servidor publicador, crie um banco de dados de exemplo e uma tabela que servirão como artigos para uma publicação.

CREATE DATABASE Sales;
GO

USE [Sales];
GO

CREATE TABLE Customer
(
    [CustomerID] INT NOT NULL,
    [SalesAmount] DECIMAL NOT NULL
);
GO

INSERT INTO Customer (CustomerID, SalesAmount)
VALUES (1, 100),
    (2, 200),
    (3, 300);
GO

Na outra instância do SQL Server, o assinante, crie um banco de dados para receber os artigos.

CREATE DATABASE Sales;
GO

No distribuidor, crie a pasta snapshot para agentes do SQL Server lerem e escreverem, e conceda acesso ao mssql usuário:

sudo mkdir /var/opt/mssql/data/ReplData/
sudo chown mssql /var/opt/mssql/data/ReplData/
sudo chgrp mssql /var/opt/mssql/data/ReplData/

Configure o distribuidor. Neste exemplo, o publicador também será o distribuidor. Execute os seguintes comandos no publicador para configurar a instância para distribuição também.

DECLARE @distributor AS SYSNAME;
DECLARE @distributorlogin AS SYSNAME;
DECLARE @distributorpassword AS SYSNAME;

-- Specify the distributor name. Use the 'hostname' command in the terminal to find the hostname.
SET @distributor = N'<distributor instance name>'; -- In this example, it will be the name of the publisher
SET @distributorlogin = N'<distributor login>';
SET @distributorpassword = N'<distributor password>';

-- Specify the distribution database.
USE master;

EXECUTE sp_adddistributor
    @distributor = @distributor; -- this should be the hostname

-- Log into the distributor and create the distribution database.
-- In this example, the publisher and distributor are on the same host.
EXECUTE sp_adddistributiondb
    @database = N'distribution',
    @log_file_size = 2,
    @deletebatchsize_xact = 5000,
    @deletebatchsize_cmd = 2000,
    @security_mode = 0,
    @login = @distributorlogin,
    @password = @distributorpassword;
GO

-- Log into the distributor and configure the snapshot directory.
-- In this example, the publisher and distributor are on the same host.
USE [distribution];
GO

DECLARE @snapshotdirectory AS NVARCHAR (500) = N'/var/opt/mssql/data/ReplData/';

IF (NOT EXISTS (SELECT * FROM sysobjects
    WHERE name = 'UIProperties' AND type = 'U'))
CREATE TABLE UIProperties(id INT);

IF (EXISTS (SELECT *
            FROM ::fn_listextendedproperty ('SnapshotFolder', 'user', 'dbo', 'table', 'UIProperties', NULL, NULL)))
    EXECUTE sp_updateextendedproperty N'SnapshotFolder', @snapshotdirectory, 'user', dbo, 'table', 'UIProperties';
ELSE
    EXECUTE sp_addextendedproperty N'SnapshotFolder', @snapshotdirectory, 'user', dbo, 'table', 'UIProperties';
GO

Configure o publicador. Execute os seguintes comandos T-SQL no Publicador.

DECLARE @publisher AS SYSNAME;
DECLARE @distributorlogin AS SYSNAME;
DECLARE @distributorpassword AS SYSNAME;

-- Specify the publisher name. Use the 'hostname' command in the terminal to find the hostname.
SET @publisher = N'<instance name>';
SET @distributorlogin = N'<distributor login>';
SET @distributorpassword = N'<distributor password>';

-- Specify the distribution database.
-- Adding the distribution publishers
EXECUTE sp_adddistpublisher
    @publisher = @publisher,
    @distribution_db = N'distribution',
    @security_mode = 0,
    @login = @distributorlogin,
    @password = @distributorpassword,
    @working_directory = N'/var/opt/mssql/data/ReplData',
    @trusted = N'false',
    @thirdparty_flag = 0,
    @publisher_type = N'MSSQLSERVER';
GO

Configure a publicação e o trabalho do agente de instantâneo. Execute os seguintes comandos T-SQL no Publicador.

USE [Sales];
GO

DECLARE @publisherlogin AS SYSNAME;
DECLARE @publisherpassword AS SYSNAME;

SET @publisherlogin = N'<publisher login>';
SET @publisherpassword = N'<publisher password>';

EXECUTE sp_replicationdboption
    @dbname = N'Sales',
    @optname = N'publish',
    @value = N'true';

-- Add the snapshot publication
EXECUTE sp_addpublication
    @publication = N'SnapshotRepl',
    @description = N'Snapshot publication of database ''Sales'' from Publisher ''<PUBLISHER HOSTNAME>''.',
    @retention = 0,
    @allow_push = N'true',
    @repl_freq = N'snapshot',
    @status = N'active',
    @independent_agent = N'true';

EXECUTE sp_addpublication_snapshot
    @publication = N'SnapshotRepl',
    @frequency_type = 1,
    @frequency_interval = 1,
    @frequency_relative_interval = 1,
    @frequency_recurrence_factor = 0,
    @frequency_subday = 8,
    @frequency_subday_interval = 1,
    @active_start_time_of_day = 0,
    @active_end_time_of_day = 235959,
    @active_start_date = 0,
    @active_end_date = 0,
    @publisher_security_mode = 0,
    @publisher_login = @publisherlogin,
    @publisher_password = @publisherpassword;

Crie o Customer artigo a partir da Customer tabela.

Execute os seguintes comandos T-SQL no Publicador.

USE [Sales];
GO

EXECUTE sp_addarticle
    @publication = N'SnapshotRepl',
    @article = N'Customer',
    @source_owner = N'dbo',
    @source_object = N'Customer',
    @type = N'logbased',
    @description = NULL,
    @creation_script = NULL,
    @pre_creation_cmd = N'drop',
    @schema_option = 0x000000000803509D,
    @destination_table = N'Customer',
    @destination_owner = N'dbo',
    @identityrangemanagementoption = N'manual',
    @vertical_partition = N'false';

Configure a assinatura. Execute os seguintes comandos T-SQL no Publicador.

USE [Sales];
GO

DECLARE @subscriber AS SYSNAME;
DECLARE @subscriber_db AS SYSNAME;
DECLARE @subscriberLogin AS SYSNAME;
DECLARE @subscriberPassword AS SYSNAME;

SET @subscriber = N'<instance name>'; -- for example, MSSQLSERVER
SET @subscriber_db = N'Sales';
SET @subscriberLogin = N'<subscriber login>';
SET @subscriberPassword = N'<subscriber password>';

EXECUTE sp_addsubscription
    @publication = N'SnapshotRepl',
    @subscriber = @subscriber,
    @destination_db = @subscriber_db,
    @subscription_type = N'Push',
    @sync_type = N'automatic',
    @article = N'all',
    @update_mode = N'read only',
    @subscriber_type = 0;

EXECUTE sp_addpushsubscription_agent
    @publication = N'SnapshotRepl',
    @subscriber = @subscriber,
    @subscriber_db = @subscriber_db,
    @subscriber_security_mode = 0,
    @subscriber_login = @subscriberLogin,
    @subscriber_password = @subscriberPassword,
    @frequency_type = 1,
    @frequency_interval = 0,
    @frequency_relative_interval = 0,
    @frequency_recurrence_factor = 0,
    @frequency_subday = 0,
    @frequency_subday_interval = 0,
    @active_start_time_of_day = 0,
    @active_end_time_of_day = 0,
    @active_start_date = 0,
    @active_end_date = 19950101;
GO

Executar tarefas do agente de replicação. Execute a seguinte consulta para obter uma lista de trabalhos:

SELECT name,
       date_modified
FROM msdb.dbo.sysjobs
ORDER BY date_modified DESC;

Inicie o trabalho do agente de snapshot para gerar o snapshot:

USE msdb;
GO

-- Generate the publication snapshot, for example.
EXECUTE dbo.sp_start_job N'PUBLISHER-PUBLICATION-SnapshotRepl-1';
GO

Inicie o trabalho do agente de distribuição para distribuir a publicação ao assinante:

USE msdb;
GO

-- Distribute the publication to the subscriber.
EXECUTE dbo.sp_start_job N'DISTRIBUTOR-PUBLICATION-SnapshotRepl-SUBSCRIBER';
GO

Conecte-se ao assinante e consulte os dados replicados.

No assinante, verifique se a replicação está funcionando executando a consulta a seguir:
```
SELECT *
FROM [Sales].[dbo].[Customer];
```

Neste tutorial, você configurou a replicação de instantâneo do SQL Server no Linux com duas instâncias do SQL Server usando T-SQL.

Habilitar agentes de Replicação do SQL Server em Linux
Criar banco de dados de exemplo
Configurar a pasta de instantâneo para acesso aos agentes do SQL Server
Configurar o distribuidor
Configurar o publicador
Configurar a publicação e os artigos
Configurar o assinante
Executar os trabalhos de replicação

Comentários

Esta página foi útil?

Última atualização em 2026-10-08

Configure a replicação com Transact-SQL

Pré-requisitos

Etapas detalhadas

Conteúdo relacionado

Comentários

Recursos adicionais