Procedura: Attivazione delle sottoscrizioni aggiornabili per le pubblicazioni transazionali (programmazione Transact-SQL della replica)

[!NOTA]

Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

Quando si crea una pubblicazione transazionale a livello di programmazione utilizzando stored procedure di replica, è possibile attivare sottoscrizioni ad aggiornamento immediato o in coda.

Nota sulla protezioneNota sulla protezione

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

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, procedere con il 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 del server di pubblicazione. Se il set di risultati è vuoto, sarà necessario creare un processo dell'agente di lettura log.

    • 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 @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 MicrosoftSQL 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 utilizzato al passaggio 2 per @publication e le credenziali di Windows utilizzate per 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. Verrà creato un processo dell'agente snapshot per la pubblicazione.

  4. Aggiungere articoli alla pubblicazione. Per ulteriori informazioni, vedere Procedura: Definizione di un articolo (programmazione Transact-SQL della replica).

  5. Nel Sottoscrittore creare una sottoscrizione aggiornabile per la pubblicazione. Per ulteriori informazioni, vedere Procedura: Creazione di una sottoscrizione aggiornabile di una pubblicazione transazionale (programmazione Transact-SQL della replica).

Per creare una pubblicazione che supporta sottoscrizioni ad 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, procedere con il 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 del server di pubblicazione. Se il set di risultati è vuoto, sarà necessario creare un processo dell'agente di lettura log.

    • 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 coda, procedere con il passaggio 3.

    • Per sapere se un processo dell'agente di lettura coda esiste già per un database di distribuzione, eseguire sp_helpqreader_agent (Transact-SQL) nel database di distribuzione del server di distribuzione. Se il set di risultati è vuoto, sarà necessario creare un processo dell'agente di lettura coda.

    • Nel server di distribuzione 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 coda si connette al server di pubblicazione e al Sottoscrittore. Per ulteriori informazioni, vedere Modello di protezione 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 al passaggio 3 per @publication e le credenziali di Windows utilizzate per 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. Verrà creato un processo dell'agente snapshot per la pubblicazione.

  5. Aggiungere articoli alla pubblicazione. Per ulteriori informazioni, vedere Procedura: Definizione di un articolo (programmazione Transact-SQL della replica).

  6. Nel Sottoscrittore creare una sottoscrizione aggiornabile per la pubblicazione. Per ulteriori informazioni, vedere Procedura: Creazione di una sottoscrizione aggiornabile di una pubblicazione transazionale (programmazione Transact-SQL della replica).

Per modificare i criteri per la gestione dei conflitti per una pubblicazione che consente le sottoscrizioni ad aggiornamento in coda

  • Nel database di pubblicazione del server di pubblicazione eseguire sp_changepublication (Transact-SQL). Specificare il valore conflict_policy per @property e la modalità desiderata per la gestione dei conflitti pub wins, sub reinit o sub wins per @value.

Esempio

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'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 
SET @login = $(Login); 
SET @password = $(Password); 

USE [AdventureWorks]
-- 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 [AdventureWorks]
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @article, 
    @source_table = @article, 
    @vertical_partition = N'false', 
    @type = N'logbased',
    @source_owner = @owner, 
    @destination_owner = @owner;
GO