Abilitare le sottoscrizioni aggiornabili per le pubblicazioni transazionali

Si applica a:SQL Server

Questo argomento descrive come abilitare le sottoscrizioni aggiornabili per le pubblicazioni transazionali in SQL Server usando SQL Server Management Studio o Transact-SQL.

Sicurezza

Se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione. Se è necessario archiviare le credenziali in un file script, è fondamentale proteggere il file per evitare accessi non autorizzati.

Utilizzo di SQL Server Management Studio

Abilita l'aggiornamento delle sottoscrizioni per le pubblicazioni transazionali nella pagina Tipo di pubblicazione della Creazione guidata Nuova pubblicazione.

Per utilizzare le sottoscrizioni aggiornabili, è inoltre necessario configurare le opzioni nella procedura guidata Nuova sottoscrizione.

Per abilitare l'aggiornamento delle sottoscrizioni

1. Nella pagina Tipo di pubblicazione della procedura guidata Nuova pubblicazione, selezionare Pubblicazione transazionale con sottoscrizioni aggiornabili.

2. Nella pagina Sicurezza dell'agente, specificare le impostazioni di sicurezza per l'Agente di lettura coda, oltre che per l'Agente snapshot e l'Agente di lettura log. Per ulteriori informazioni sulle autorizzazioni necessarie per l'account nel cui contesto viene eseguito Queue Reader Agent, vedere Replication Agent Security Model.

   Nota

   L'agente di lettura coda viene configurato anche se si utilizzano solo le sottoscrizioni ad aggiornamento immediato.

Utilizzo di Transact-SQL

Quando si crea una pubblicazione transazionale a livello di codice utilizzando le stored procedure di replica, è possibile abilitare sottoscrizioni con aggiornamento immediato o in coda.

Per creare una pubblicazione che supporta sottoscrizioni ad aggiornamento immediato

1. Se necessario, creare un processo dell'agente di lettura log per il database di pubblicazione.

   • Se per il database di pubblicazione esiste già un processo dell'Agente di lettura log, passare al passaggio 2.

   • Per sapere se un processo dell'agente di lettura log esiste già per un database pubblicato, eseguire sp_helplogreader_agent (Transact-SQL) nel database di pubblicazione nel server di pubblicazione. Se il set di risultati è vuoto, deve essere creato un processo di Log Reader Agent.

   • Nel server di pubblicazione eseguire sp_addlogreader_agent (Transact-SQL). Specificare le credenziali di Microsoft Windows utilizzate per l'esecuzione dell'agente per @job_name e @password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di Microsoft SQL Server per @publisher_login e @publisher_password.

2. Eseguire sp_addpublication (Transact-SQL), specificando il valore true per il parametro @allow_sync_tran.

3. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione usato nel passaggio 2 per @publication e le credenziali di Windows con cui viene eseguito l'agente snapshot per @job_name e @password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di SQL Server per @publisher_login e @publisher_password. Questo crea un processo di agente di snapshot per la pubblicazione.

4. Aggiungere articoli alla pubblicazione. Per altre informazioni, vedere definire un articolo.

5. Nel Sottoscrittore, creare una sottoscrizione di aggiornamento per questa pubblicazione.

Per creare una pubblicazione che supporta sottoscrizioni di aggiornamento in coda

1. Se necessario, creare un processo dell'agente di lettura log per il database di pubblicazione.

   • Se per il database di pubblicazione esiste già un processo dell'Agente di lettura log, passare al passaggio 2.

   • Per sapere se un processo dell'agente di lettura log esiste già per un database pubblicato, eseguire sp_helplogreader_agent (Transact-SQL) nel database di pubblicazione nel server di pubblicazione. Se il set di risultati è vuoto, è necessario creare un processo di Log Reader Agent.

   • Nel server di pubblicazione eseguire sp_addlogreader_agent (Transact-SQL). Specificare le credenziali di Windows utilizzate per l'esecuzione dell'agente per @job_name e @job_password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di SQL Server per @publisher_login e @publisher_password.

2. Se necessario, creare un processo dell'agente di lettura coda per il server di distribuzione.

   • Se per il database di distribuzione esiste già un processo dell'Agente di lettura della coda, passare al passaggio 3.

   • Se non si è sicuri che esista un processo Queue Reader Agent per il database di distribuzione, eseguire sp_helpqreader_agent (Transact-SQL) presso il server di distribuzione, nel database di distribuzione. Se il set di risultati è vuoto, deve essere creato un job di Queue Reader Agent.

   • Nel Distributore, eseguire sp_addqreader_agent (Transact-SQL). Specificare le credenziali di Windows utilizzate per l'esecuzione dell'agente per @job_name e @job_password. Queste credenziali vengono utilizzate quando l'Agente di lettura della coda si connette all'Autore e al Sottoscrittore. Per altre informazioni, vedere Modello di sicurezza dell'agente di replica.

3. Eseguire sp_addpublication (Transact-SQL), specificando il valore true per il parametro @allow_queued_tran e il valore pub wins, sub reinit o sub wins per @conflict_policy.

4. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione utilizzato nel passaggio 3 per @publication e le credenziali di Windows con cui viene eseguito l'Agente snapshot per @snapshot_job_name e @password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di SQL Server per @publisher_login e @publisher_password. Questo crea un processo di agente di snapshot per la pubblicazione.

5. Aggiungere articoli alla pubblicazione. Per altre informazioni, vedere definire un articolo.

6. Nel Sottoscrittore, creare una sottoscrizione di aggiornamento per questa pubblicazione.

Per modificare i criteri di risoluzione dei conflitti per una pubblicazione che consente sottoscrizioni con aggiornamento in coda

1. Nel server di pubblicazione, nel database di pubblicazione, eseguire sp_changepublication (Transact-SQL). Specificare un valore di conflict_policy per @property e la modalità desiderata dei criteri di conflitto pub wins, sub reinit o sub wins per @value.

Esempio (Transact-SQL)

In questo esempio viene creata una pubblicazione che supporta le sottoscrizioni pull ad aggiornamento immediato e in coda.

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

--Declarations for adding a transactional publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksProductTran'; 
SET @login = $(Login); 
SET @password = $(Password); 

USE [AdventureWorks2022]
-- Enable transactional replication on the publication database.
EXEC sp_replicationdboption 
    @dbname=@publicationDB, 
    @optname=N'publish',
    @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;

-- Create a transactional publication that supports immediate updating, 
-- queued updating, and pull subscriptions. 
EXEC sp_addpublication 
    @publication = @publication, 
    @status = N'active',
    @allow_sync_tran = N'true', 
    @allow_queued_tran = N'true',
    @allow_pull = N'true',
    @independent_agent = N'true',
  -- Explicitly declare the related default properties 
    @conflict_policy = N'pub wins';

-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot 
    @publication = @publication, 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;
GO

--Declarations for adding an article.
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @owner AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @article = N'Product'; 
SET @owner = N'Production'; 

-- Add a horizontally and vertically filtered article for the Product table.
USE [AdventureWorks2022]
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @article, 
    @source_table = @article, 
    @vertical_partition = N'false', 
    @type = N'logbased',
    @source_owner = @owner, 
    @destination_owner = @owner;
GO

Contenuto correlato

• Crea un abbonamento aggiornabile a una pubblicazione transazionale
• Replicazione transazionale
• Sottoscrizioni aggiornabili - Per la replica transazionale
• Creare una pubblicazione
• Usare sqlcmd con variabili di scripting