Creazione di uno snapshot per una pubblicazione di tipo merge con filtri con parametriCreate a Snapshot for a Merge Publication with Parameterized Filters

In questo argomento si applica a: SìSQL ServernonDatabase SQL di AzurenonAzure SQL Data Warehouse non Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse Questo argomento descrive come creare un snapshot per una pubblicazione di tipo merge con i filtri con parametri in SQL Server 2017SQL Server 2017 tramite SQL Server Management StudioSQL Server Management Studio, Transact-SQLTransact-SQL o Replication Management Objects (RMO). This topic describes how to create a snapshot for a merge publication with parameterized filters in SQL Server 2017SQL Server 2017 by using SQL Server Management StudioSQL Server Management Studio, Transact-SQLTransact-SQL, or Replication Management Objects (RMO).

Contenuto dell'argomentoIn This Topic

Prima di iniziareBefore You Begin

IndicazioniRecommendations

  • Quando si genera uno snapshot per una pubblicazione di tipo merge utilizzando filtri con parametri, è necessario innanzitutto generare uno snapshot (schema) standard che contiene tutti i dati pubblicati e i metadati del Sottoscrittore per la sottoscrizione.When generating a snapshot for a merge publication using parameterized filters, you must first generate a standard (schema) snapshot that contains all of the published data and Subscriber metadata for the subscription. Per altre informazioni, vedere Create and Apply the Initial Snapshot.For more information, see Create and Apply the Initial Snapshot. Dopo aver creato lo snapshot dello schema, è possibile generare lo snapshot che contiene la partizione dei dati pubblicati specifica del Sottoscrittore.After you have created the schema snapshot, you can generate the snapshot that contains the Subscriber-specific partition of the published data.

  • Se il filtro di uno o più articoli nella pubblicazione restituisce partizioni non sovrapposte univoche per ogni sottoscrizione, i metadati vengono eliminati a ogni esecuzione dell'agente di merge.If the filtering for one or more articles in the publication yields non-overlapping partitions that are unique for each subscription, metadata is cleaned up whenever the Merge Agent runs. Lo snapshot partizionato scade quindi più rapidamente.This means that the partitioned snapshot expires more quickly. Quando si utilizza questa opzione, è consigliabile consentire ai Sottoscrittori di inizializzare la generazione e il recapito dello snapshot.When using this option, you should consider allowing Subscribers to initiate snapshot generation and delivery. Per altre informazioni sulle opzioni di filtro, vedere la sezione "Impostazione di 'partition options'" in Snapshot per pubblicazioni di tipo merge con filtri con parametri.For more information about filtering options, see the "Setting 'partition options'" section of Snapshots for Merge Publications with Parameterized Filters.

Utilizzo di SQL Server Management StudioUsing SQL Server Management Studio

Generare snapshot per le partizioni nella pagina Partizioni dati della finestra di dialogo Proprietà pubblicazione - <Pubblicazione>.Generate snapshots for partitions on the Data Partitions page of the Publication Properties - <Publication> dialog box. Per ulteriori informazioni sull'accesso a questa finestra di dialogo, vedere View and Modify Publication Properties.For more information about accessing this dialog box, see View and Modify Publication Properties. È possibile consentire ai Sottoscrittori di avviare la generazione e il recapito degli snapshot e/o di generare snapshot.You can allow Subscribers to initiate snapshot generation and delivery and/or generate snapshots.

Prima di generare gli snapshot per una o più partizioni, è necessario:Before generating snapshots for one or more partitions, you must:

  1. Creare una pubblicazione di tipo merge mediante Creazione guidata nuova pubblicazione e specificare uno o più filtri di righe con parametri nella pagina Aggiungi filtro della procedura guidata.Create a merge publication with the New Publication Wizard, and specify one or more parameterized row filters on the Add Filter page of the wizard. Per altre informazioni, vedere Define and Modify a Parameterized Row Filter for a Merge Article.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  2. Generare uno snapshot dello schema per la pubblicazione.Generate a schema snapshot for the publication. Per impostazione predefinita, lo snapshot dello schema viene generato quando si completa la Creazione guidata nuova pubblicazione, ma è possibile generarne uno anche mediante SQL Server Management StudioSQL Server Management Studio.By default, a schema snapshot is generated when you complete the New Publication Wizard; you can also generate a schema snapshot from SQL Server Management StudioSQL Server Management Studio.

Per generare uno snapshot dello schemaTo generate a schema snapshot

  1. Connettersi al server di pubblicazione in Management StudioManagement Studioe quindi espandere il nodo del server.Connect to the Publisher in Management StudioManagement Studio, and then expand the server node.

  2. Espandere la cartella Replica e quindi la cartella Pubblicazioni .Expand the Replication folder, and then expand the Publications folder.

  3. Fare clic con il pulsante destro del mouse sulla pubblicazione per la quale si desidera creare uno snapshot, quindi scegliere Visualizza stato agente snapshot.Right-click the publication for which you want to create a snapshot, and then click View Snapshot Agent Status.

  4. Nella finestra di dialogo Visualizza stato agente snapshot - <Pubblicazione> fare clic su Avvia.In the View Snapshot Agent Status - <Publication> dialog box, click Start.

    Al termine della generazione dello snapshot, verrà visualizzato un messaggio del tipo "[100%] Generato uno snapshot di 17 articoli."When the Snapshot Agent finishes generating the snapshot, a message will be displayed, such as "[100%] A snapshot of 17 article(s) was generated."

Per consentire ai Sottoscrittori di avviare la generazione e il recapito di snapshotTo allow Subscribers to initiate snapshot generation and delivery

  1. Nella pagina Partizioni dati della finestra di dialogo Proprietà pubblicazione - <Pubblicazione> selezionare Definisci automaticamente una partizione e genera uno snapshot, se necessario, quando un nuovo Sottoscrittore cerca di eseguire la sincronizzazione.On the Data Partitions page of the Publication Properties - <Publication> dialog box, select Automatically define a partition and generate a snapshot if needed when a new Subscriber tries to synchronize.

  2. Fare clic su OK.Click OK.

Per generare e aggiornare gli snapshotTo generate and refresh snapshots

  1. Nella pagina Partizioni dati della finestra di dialogo Proprietà pubblicazione - <Pubblicazione> fare clic su Aggiungi.On the Data Partitions page of the Publication Properties - <Publication> dialog box, click Add.

  2. Immettere un valore per le funzioni HOST_NAME() e/o SUSER_SNAME() associate alla partizione per cui si desidera creare uno snapshot.Enter a value for the HOST_NAME() and/or SUSER_SNAME() value associated with the partition for which you want to create a snapshot.

  3. Facoltativamente, specificare una pianificazione per l'aggiornamento degli snapshot:Optionally specify a schedule for refreshing snapshots:

    1. Selezionare Usa la pianificazione seguente per l'esecuzione dell'agente snapshot per questa partizione.Select Schedule the Snapshot Agent for this partition to run at the following time(s)

    2. Accettare la pianificazione predefinita per l'aggiornamento degli snapshot oppure fare clic su Cambia per specificare una pianificazione diversa.Accept the default schedule for refreshing snapshots, or click Change to specify a different schedule.

  4. Facendo clic su OK si torna alla finestra di dialogo Proprietà pubblicazione - <Pubblicazione>.Click OK, which returns you to the Publication Properties - <Publication> dialog box.

  5. Selezionare la partizione nella griglia delle proprietà e quindi fare clic su Genera gli snapshot selezionati adesso.Select the partition in the property grid, and then click Generate the selected snapshots now.

  6. Fare clic su OK.Click OK.

Utilizzo di Transact-SQLUsing Transact-SQL

L'utilizzo di stored procedure e dell'agente snapshot consente di eseguire le attività indicate di seguito:Using stored procedures and the Snapshot Agent, you can perform the following:

  • Consentire ai Sottoscrittori di richiedere la generazione e l'applicazione dello snapshot alla prima sincronizzazione.Allow Subscribers to request snapshot generation and application the first time they synchronize.

  • Pregenerare uno snapshot per ogni partizione.Pre-generate snapshots for each partition.

  • Generare manualmente uno snapshot per ciascun Sottoscrittore.Manually generate a snapshot for each Subscriber.

    Importante

    Se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione.When possible, prompt users to enter security credentials at runtime. Se è necessario archiviare le credenziali in un file script, è fondamentale proteggere il file per evitare accessi non autorizzati.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

Per creare una pubblicazione che consente ai Sottoscrittori di avviare la generazione e il recapito di snapshotTo create a publication that allows Subscribers to initiate snapshot generation and delivery

  1. Nel database di pubblicazione del server di pubblicazione eseguire sp_addmergepublication (Transact-SQL).At the Publisher on the publication database, execute sp_addmergepublication (Transact-SQL). Specificare i parametri seguenti:Specify the following parameters:

    • Il nome della pubblicazione per @publication.The name of the publication for @publication.

    • Il valore true per @allow_subscriber_initiated_snapshot, che consente ai Sottoscrittori di avviare il processo di snapshot.A value of true for @allow_subscriber_initiated_snapshot, which enables Subscribers to initiate the snapshot process.

    • (Facoltativo) Il numero di processi di snapshot dinamici che è possibile eseguire simultaneamente per @max_concurrent_dynamic_snapshots.(Optional) The number of dynamic snapshot processes that can run concurrently for @max_concurrent_dynamic_snapshots. Se è in esecuzione il numero massimo di processi e un Sottoscrittore tenta di generare uno snapshot, il processo verrà inserito in una coda.If the maximum number of processes is running and a Subscriber attempts to generate a snapshot, the process is placed in a queue. Per impostazione predefinita, non esiste nessun limite per il numero di processi simultanei.By default there is no limit to the number of concurrent processes.

  2. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL).At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione utilizzato al passaggio 1 per @publication e le credenziali di MicrosoftMicrosoft Windows utilizzate per l' Replication Snapshot Agent per @job_login e @password.Specify the publication name used in step 1 for @publication and the MicrosoftMicrosoft Windows credentials under which the Replication Snapshot Agent runs for @job_login and @password. Se l'agente utilizza l'autenticazione di SQL ServerSQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le credenziali di MicrosoftMicrosoft SQL ServerSQL Server per @publisher_login e @publisher_password.If the agent will use SQL ServerSQL Server Authentication when connecting to the Publisher, you must also specify a value of 0 for @publisher_security_mode and the MicrosoftMicrosoft SQL ServerSQL Server login information for @publisher_login and @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.This creates a Snapshot Agent job for the publication. Per ulteriori informazioni sulla generazione di uno snapshot iniziale e sulla definizione di una pianificazione personalizzata per l'agente snapshot, vedere Create and Apply the Initial Snapshot.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

    Importante

    Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutti i parametri, inclusi job_login e job_password, vengono inviati al server di distribuzione come testo normale.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Per altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. Per aggiungere articoli alla pubblicazione, eseguire sp_addmergearticle (Transact-SQL).Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. Questa stored procedure deve essere eseguita una sola volta per ogni articolo della pubblicazione.This stored procedure must be executed once for each article in the publication. Quando si utilizzano filtri con parametri, è necessario specificare un filtro di riga con parametri per uno o più articoli utilizzando il parametro @subset_filterclause .When using parameterized filters, you must specify a parameterized row filter for one or more articles using the @subset_filterclause parameter. Per altre informazioni, vedere Define and Modify a Parameterized Row Filter for a Merge Article.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. Se il filtro di riga con parametri verrà usato per filtrare altri articoli, eseguire sp_addmergefilter (Transact-SQL) per definire le relazioni di join o tra record logici tra gli articoli.If other articles will be filtered based on the parameterized row filter, execute sp_addmergefilter (Transact-SQL) to define the join or logical record relationships between articles. Questa stored procedure deve essere eseguita una sola volta per ogni relazione da definire.This stored procedure must be executed once for each relationship being defined. Per altre informazioni, vedere Define and Modify a Join Filter Between Merge Articles.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. Quando l'agente di merge richiede che il Sottoscrittore venga inizializzato dallo snapshot, lo snapshot relativo alla partizione della sottoscrizione che ha eseguito la richiesta viene generato automaticamente.When the Merge Agent requests the snapshot to initialize the Subscriber, the snapshot for the requesting subscription's partition is automatically generated.

Per creare una pubblicazione e pregenerare o aggiornare automaticamente gli snapshotTo create a publication and pre-generate or automatically refresh snapshots

  1. Eseguire sp_addmergepublication (Transact-SQL) per creare la pubblicazione.Execute sp_addmergepublication (Transact-SQL) to create the publication. Per altre informazioni, vedere Create a Publication.For more information, see Create a Publication.

  2. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL).At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione utilizzato al passaggio 1 per @publication e le credenziali di Windows utilizzate per l'agente snapshot per @job_login e @password.Specify the publication name used in step 1 for @publication and the Windows credentials under which the Snapshot Agent runs for @job_login and @password. Se l'agente utilizza l'autenticazione di SQL ServerSQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le credenziali di SQL ServerSQL Server per @publisher_login e @publisher_password.If the agent will use SQL ServerSQL Server Authentication when connecting to the Publisher, you must also specify a value of 0 for @publisher_security_mode and the SQL ServerSQL Server login information for @publisher_login and @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.This creates a Snapshot Agent job for the publication. Per ulteriori informazioni sulla generazione di uno snapshot iniziale e sulla definizione di una pianificazione personalizzata per l'agente snapshot, vedere Create and Apply the Initial Snapshot.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

    Importante

    Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutti i parametri, inclusi job_login e job_password, vengono inviati al server di distribuzione come testo normale.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Per altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. Per aggiungere articoli alla pubblicazione, eseguire sp_addmergearticle (Transact-SQL).Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. Questa stored procedure deve essere eseguita una sola volta per ogni articolo della pubblicazione.This stored procedure must be executed once for each article in the publication. Quando si utilizzano filtri con parametri, è necessario specificare un filtro di riga con parametri per un articolo utilizzando il parametro @subset_filterclause .When using parameterized filters, you must specify a parameterized row filter for one article using the @subset_filterclause parameter. Per altre informazioni, vedere Define and Modify a Parameterized Row Filter for a Merge Article.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. Se il filtro di riga con parametri verrà usato per filtrare altri articoli, eseguire sp_addmergefilter (Transact-SQL) per definire le relazioni di join o tra record logici tra gli articoli.If other articles will be filtered based on the parameterized row filter, execute sp_addmergefilter (Transact-SQL) to define the join or logical record relationships between articles. Questa stored procedure deve essere eseguita una sola volta per ogni relazione da definire.This stored procedure must be executed once for each relationship being defined. Per altre informazioni, vedere Define and Modify a Join Filter Between Merge Articles.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. Nel database di pubblicazione del server di pubblicazione eseguire sp_helpmergepublication (Transact-SQL), specificando il valore @publication dal passaggio 1.At the Publisher on the publication database, execute sp_helpmergepublication (Transact-SQL), specifying the value of @publication from step 1. Si noti il valore di snapshot_jobid nel set di risultati.Note the value of the snapshot_jobid in the result set.

  6. Convertire il valore di snapshot_jobid ottenuto al passaggio 5 in uniqueidentifier.Convert the value of the snapshot_jobid obtained in step 5 to uniqueidentifier.

  7. Nel database msdb del server di pubblicazione eseguire sp_start_job (Transact-SQL) specificando per @job_id il valore convertito ottenuto al passaggio 6.At the Publisher on the msdb database, execute sp_start_job (Transact-SQL), specifying the converted value obtained in step 6 for @job_id.

  8. Nel database di pubblicazione del server di pubblicazione eseguire sp_addmergepartition (Transact-SQL).At the Publisher on the publication database, execute sp_addmergepartition (Transact-SQL). Specificare il nome della pubblicazione ottenuto al passaggio 1 per @publication e il valore usato per definire la partizione per @suser_sname se si usa SUSER_SNAME (Transact-SQL) nella clausola di filtro oppure per @host_name se si usa HOST_NAME (Transact-SQL) nella clausola di filtro.Specify the name of the publication from step 1 for @publication and the value used to define the partition for @suser_sname if SUSER_SNAME (Transact-SQL) is used in the filter clause or for @host_name if HOST_NAME (Transact-SQL) is used in the filter clause.

  9. Nel database di pubblicazione del server di pubblicazione eseguire sp_adddynamicsnapshot_job (Transact-SQL).At the publisher on the publication database, execute sp_adddynamicsnapshot_job (Transact-SQL). Specificare il nome della pubblicazione ottenuto al passaggio 1 per @publication, il valore di @suser_sname o @host_name ottenuto al passaggio 8 e una pianificazione per il processo.Specify the name of the publication from step 1 for @publication, the value of @suser_sname or @host_name from step 8, and a schedule for the job. In tal modo verrà creato il processo che genera lo snapshot con parametri per la partizione specificata.This creates the job that generates the parameterized snapshot for the specified partition. Per altre informazioni, vedere Specify Synchronization Schedules.For more information, see Specify Synchronization Schedules.

    Nota

    Per l'esecuzione di questo processo viene utilizzato lo stesso account di Windows del processo snapshot iniziale definito al passaggio 2.This job runs using the same Windows account as the initial snapshot job defined in step 2. Per rimuovere il processo snapshot con parametri e la partizione dati correlata, eseguire sp_dropdynamicsnapshot_job (Transact-SQL).To remove the parameterized snapshot job and its related data partition, execute sp_dropdynamicsnapshot_job (Transact-SQL).

  10. Nel database di pubblicazione del server di pubblicazione eseguire sp_helpmergepartition (Transact-SQL), specificando il valore @publication dal passaggio 1 e il valore @suser_sname o @host_name dal passaggio 8.At the Publisher on the publication database, execute sp_helpmergepartition (Transact-SQL), specifying the value of @publication from step 1 and the value of @suser_sname or @host_name from step 8. Si noti il valore di snapshot job nel set di risultati.Note the value of the dynamic_snapshot_jobid in the result set.

  11. Nel database msdb del server di distribuzione eseguire sp_start_job (Transact-SQL) specificando per @job_id il valore ottenuto al passaggio 9.At the Distributor on the msdb database, execute sp_start_job (Transact-SQL), specifying the value obtained in step 9 for @job_id. In tal modo verrà avviato il processo snapshot con parametri per la partizione.This starts the parameterized snapshot job for the partition.

  12. Ripetere i passaggi da 8 a 11 per generare uno snapshot partizionato per ogni sottoscrizione.Repeat steps 8-11 to generate a partitioned snapshot for each subscription.

Per creare una pubblicazione e creare manualmente gli snapshot per ogni partizioneTo create a publication and manually create snapshots for each partition

  1. Eseguire sp_addmergepublication (Transact-SQL) per creare la pubblicazione.Execute sp_addmergepublication (Transact-SQL) to create the publication. Per altre informazioni, vedere Create a Publication.For more information, see Create a Publication.

  2. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL).At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione utilizzato al passaggio 1 per @publication e le credenziali di Windows utilizzate per l'agente snapshot per @job_login e @password.Specify the publication name used in step 1 for @publication and the Windows credentials under which the Snapshot Agent runs for @job_login and @password. Se l'agente utilizza l'autenticazione di SQL ServerSQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le credenziali di SQL ServerSQL Server per @publisher_login e @publisher_password.If the agent will use SQL ServerSQL Server Authentication when connecting to the Publisher, you must also specify a value of 0 for @publisher_security_mode and the SQL ServerSQL Server login information for @publisher_login and @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.This creates a Snapshot Agent job for the publication. Per ulteriori informazioni sulla generazione di uno snapshot iniziale e sulla definizione di una pianificazione personalizzata per l'agente snapshot, vedere Create and Apply the Initial Snapshot.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

    Importante

    Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutti i parametri, inclusi job_login e job_password, vengono inviati al server di distribuzione come testo normale.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Per altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. Per aggiungere articoli alla pubblicazione, eseguire sp_addmergearticle (Transact-SQL).Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. Questa stored procedure deve essere eseguita una sola volta per ogni articolo della pubblicazione.This stored procedure must be executed once for each article in the publication. Quando si utilizzano filtri con parametri, è necessario specificare un filtro di riga con parametri per almeno un articolo utilizzando il parametro @subset_filterclause .When using parameterized filters, you must specify a parameterized row filter for at least one article using the @subset_filterclause parameter. Per altre informazioni, vedere Define and Modify a Parameterized Row Filter for a Merge Article.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. Se il filtro di riga con parametri verrà usato per filtrare altri articoli, eseguire sp_addmergefilter (Transact-SQL) per definire le relazioni di join o tra record logici tra gli articoli.If other articles will be filtered based on the parameterized row filter, execute sp_addmergefilter (Transact-SQL) to define the join or logical record relationships between articles. Questa stored procedure deve essere eseguita una sola volta per ogni relazione da definire.This stored procedure must be executed once for each relationship being defined. Per altre informazioni, vedere Define and Modify a Join Filter Between Merge Articles.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. Avviare il processo snapshot o eseguire Agente snapshot repliche dal prompt dei comandi per generare lo schema standard dello snapshot standard e gli altri file.Start the snapshot job or run the Replication Snapshot Agent from the command prompt to generate the standard snapshot schema and other files. Per altre informazioni, vedere Create and Apply the Initial Snapshot.For more information, see Create and Apply the Initial Snapshot.

  6. Eseguire nuovamente Agente snapshot repliche dal prompt dei comandi per generare file della copia bulk (estensione bcp), specificando il percorso dello snapshot partizionato per - DynamicSnapshotLocation e una o entrambe le proprietà seguenti che definiscono la partizione:Run the Replication Snapshot Agent again from the command prompt to generate bulk copy (.bcp) files, specifying the location of the partitioned snapshot for -DynamicSnapshotLocation and one or both of the following properties that defines the partition:

  7. Ripetere il passaggio 6 per generare uno snapshot partizionato per ogni sottoscrizione.Repeat step 6 to generate a partitioned snapshot for each subscription.

  8. Eseguire l'agente di merge per consentire a ogni sottoscrizione di applicare lo snapshot partizionato iniziale ai Sottoscrittori, specificando le proprietà seguenti:Run the Merge Agent for each subscription to apply the initial partitioned snapshot at the Subscribers, specifying the following properties:

    • -Hostname : valore utilizzato per definire la partizione se viene eseguito l'override del valore effettivo di HOST_NAME.-Hostname - the value used to define the partition if the actual value of HOST_NAME is being overridden.

    • -DynamicSnapshotLocation : percorso dello snapshot dinamico per questa partizione.-DynamicSnapshotLocation - the location of the dynamic snapshot for this partition.

Nota

Per altre informazioni sulla programmazione degli agenti di replica, vedere Concetti di base relativi ai file eseguibili dell'agente di replica.For more information about programming replication agents, see Replication Agent Executables Concepts.

Esempi (Transact-SQL)Examples (Transact-SQL)

In questo esempio viene creata una pubblicazione di tipo merge con filtri con parametri in cui i Sottoscrittori avviano il processo di generazione dello snapshot.This example creates a merge publication with parameterized filters where Subscribers initiate the snapshot generation process. Per passare i valori di @job_login e @job_password , vengono utilizzate variabili di scripting.Values for @job_login and @job_password are passed in using scripting variables.

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. 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".

--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;

SET @publicationdb = N'AdventureWorks2012';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';

USE [AdventureWorks2012];

-- Enable AdventureWorks2012 for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication with Subscriber requested snapshot
-- and using the default agent schedule. 
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks2012.', 
  @allow_subscriber_initiated_snapshot = N'true',
  @publication_compatibility_level = N'90RTM';

-- Create a new snapshot job for the publication, using the default schedule.
-- Pass credentials at runtime using sqlcmd scripting variables.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = $(login), 
  @job_password = $(password);

-- Add an article for the Employee table, 
-- which is horizontally partitioned using 
-- a parameterized row filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_owner = @schema_hr, 
  @source_object = @table1, 
  @type = N'table', 
  @description = 'contains employee information', 
  @subset_filterclause = N'[LoginID] = HOST_NAME()';

-- Add an article for the SalesPerson table, 
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_owner = @schema_sales, 
  @source_object = @table2, 
  @type = N'table', 
  @description = 'contains salesperson information';

-- Add a join filter between the two articles.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table1, 
  @filtername = @filter, 
  @join_articlename = @table2, 
  @join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]', 
  @join_unique_key = 1, 
  @filter_type = 1;
GO

-- Start the agent job to generate the full snapshot for the publication.
-- The filtered data snapshot is generated automatically the first time 
-- the subscription is synchronized. 
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';

EXEC sp_startpublication_snapshot 
  @publication = @publication;
GO

In questo esempio viene creata una pubblicazione utilizzando un filtro con parametri in cui la partizione di ogni Sottoscrittore viene definita eseguendo sp_addmergepartition e il processo snapshot con filtro viene creato eseguendo sp_adddynamicsnapshot_job passando le informazioni sul partizionamento.This example creates a publication using a parameterized filter where each Subscriber has its partition defined by executing sp_addmergepartition and the filtered snapshot job created by executing sp_adddynamicsnapshot_job passing the partitioning information. Per passare i valori di @job_login e @job_password , vengono utilizzate variabili di scripting.Values for @job_login and @job_password are passed in using scripting variables.

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. 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".

--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;

SET @publicationdb = N'AdventureWorks2012';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';

USE [AdventureWorks2012];

-- Enable AdventureWorks2012 for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication.  
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks2012.', 
  @allow_subscriber_initiated_snapshot = N'false';

-- Create a new snapshot job for the publication, using the 
-- default schedule. Pass credentials at runtime using 
-- sqlcmd scripting variables.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = $(Login), 
  @job_password = $(password);

-- Add an article for the Employee table, 
-- which is horizontally partitioned using 
-- a parameterized row filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_owner = @schema_hr, 
  @source_object = @table1, 
  @type = N'table', 
  @description = 'contains employee information', 
  @subset_filterclause = N'[LoginID] = HOST_NAME()';

-- Add an article for the SalesPerson table, 
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_owner = @schema_sales, 
  @source_object = @table2, 
  @type = N'table', 
  @description = 'contains customer information';

-- Add a join filter between the two articles.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table1, 
  @filtername = @filter, 
  @join_articlename = @table2, 
  @join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]', 
  @join_unique_key = 1, 
  @filter_type = 1;
GO

-- Start the snapshot agent job.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';

EXEC sp_startpublication_snapshot 
  @publication = @publication;
GO

PRINT '*** Waiting for the initial snapshot.';
GO

-- Create a temporary table to store the filtered data snapshot 
-- job information.
CREATE TABLE #temp (id int,
	job_name sysname,
	job_id uniqueidentifier,
	dynamic_filter_login sysname NULL,
	dynamic_filter_hostname sysname NULL,
	dynamic_snapshot_location nvarchar(255),
	frequency_type int, 
	frequency_interval int, 
	frequency_subday_type int,
	frequency_subday_interval int, 
	frequency_relative_interval int, 
	frequency_recurrence_factor int, 
	active_start_date int, 
	active_end_date int, 
	active_start_time int, 
	active_end_time int
)

-- Create each snapshot for a partition 
-- The initial snapshot must already be generated.
DECLARE @publication AS sysname;
DECLARE @jobname AS sysname
DECLARE @hostname AS sysname
SET @publication = N'AdvWorksSalesPersonMerge';
SET @hostname = N'adventure-works\Fernando';

WHILE NOT EXISTS(SELECT * FROM sysmergepublications 
    WHERE [name] = @publication 
    AND snapshot_ready = 1)
BEGIN
    WAITFOR DELAY '00:00:05'
END

-- Create a data partition by overriding HOST_NAME().
EXEC sp_addmergepartition 
  @publication = @publication,
  @host_name = @hostname;

-- Create the filtered data snapshot job, and use the returned 
-- information to start the job.
EXEC sp_adddynamicsnapshot_job 
  @publication = @publication,
  @host_name = @hostname;

INSERT INTO #temp (id, job_name, job_id, dynamic_filter_login,
	dynamic_filter_hostname, dynamic_snapshot_location,
	frequency_type,	frequency_interval, frequency_subday_type,
	frequency_subday_interval, frequency_relative_interval, 
	frequency_recurrence_factor, active_start_date,	active_end_date, 
	active_start_time,active_end_time)
EXEC sp_helpdynamicsnapshot_job;

SELECT @jobname = (SELECT DISTINCT job_name FROM #temp WHERE dynamic_filter_hostname = @hostname);

EXEC msdb..sp_start_job @job_name = @jobname;
DROP TABLE #temp;
GO

In questo esempio viene creata una pubblicazione utilizzando un filtro con parametri in cui il Sottoscrittore deve disporre di una propria partizione dati e il processo snapshot con filtro viene creato fornendo le informazioni sul partizionamento.This example creates a publication using a parameterized filter where each Subscriber must have its data partition and filtered snapshot job created by supplying the partitioning information. Un Sottoscrittore fornisce le informazioni sul partizionamento utilizzando i parametri della riga di comando durante l'esecuzione manuale degli agenti di replica.A Subscriber supplies partitioning information using command-line parameters when manually running the replication agents. In questo esempio si presuppone che sia stata creata anche una sottoscrizione della pubblicazione.This example assumes that a subscription to the publication has also been created.

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. 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".

--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;

SET @publicationdb = N'AdventureWorks2012';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';

USE [AdventureWorks2012];

-- Enable AdventureWorks2012 for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication.  
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks2012.', 
  @allow_subscriber_initiated_snapshot = N'false';

-- Create a new snapshot job for the publication, using the 
-- default schedule. Pass credentials at runtime using 
-- sqlcmd scripting variables.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = $(Login), 
  @job_password = $(Password);

-- Add an article for the Employee table, 
-- which is horizontally partitioned using 
-- a parameterized row filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_owner = @schema_hr, 
  @source_object = @table1, 
  @type = N'table', 
  @description = 'contains employee information', 
  @subset_filterclause = N'[LoginID] = HOST_NAME()';

-- Add an article for the SalesPerson table, 
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_owner = @schema_sales, 
  @source_object = @table2, 
  @type = N'table', 
  @description = 'contains customer information';

-- Add a join filter between the two articles.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table1, 
  @filtername = @filter, 
  @join_articlename = @table2, 
  @join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]', 
  @join_unique_key = 1, 
  @filter_type = 1;
GO

REM Line breaks are added to improve readability.   
REM In a batch file, commands must be made in a single line.  
REM Run the Snapshot agent from the command line to generate the standard snapshot   
REM schema and other files.   
SET DistPub=%computername%  
SET PubDB=AdventureWorks2012   
SET PubName=AdvWorksSalesPersonMerge  

"C:\Program Files\Microsoft SQL Server\120\COM\SNAPSHOT.EXE" -Publication %PubName%    
-Publisher %DistPub% -Distributor  %DistPub%  -PublisherDB %PubDB%  -ReplicationType 2    
-OutputVerboseLevel 1  -DistributorSecurityMode 1  

PAUSE  

REM Run the Snapshot agent from the command line, this time to generate   
REM the bulk copy (.bcp) data for each Subscriber partition.    
SET DistPub=%computername%  
SET PubDB=AdventureWorks2012   
SET PubName=AdvWorksSalesPersonMerge  
SET SnapshotDir=\\%DistPub%\repldata\unc\fernando  

MD %SnapshotDir%  

"C:\Program Files\Microsoft SQL Server\120\COM\SNAPSHOT.EXE" -Publication %PubName%    
-Publisher %DistPub%  -Distributor  %DistPub%  -PublisherDB %PubDB%  -ReplicationType 2    
-OutputVerboseLevel 1  -DistributorSecurityMode 1  -DynamicFilterHostName "adventure-works\Fernando"    
-DynamicSnapshotLocation %SnapshotDir%  

PAUSE  

REM Run the Merge Agent for each subscription to apply the partitioned   
REM snapshot for each Subscriber.    
SET Publisher = %computername%  
SET Subscriber = %computername%  
SET PubDB = AdventureWorks2012   
SET SubDB = AdventureWorks2012Replica   
SET PubName = AdvWorksSalesPersonMerge   
SET SnapshotDir=\\%DistPub%\repldata\unc\fernando  

"C:\Program Files\Microsoft SQL Server\120\COM\REPLMERG.EXE" -Publisher  %Publisher%    
-Subscriber  %Subscriber%  -Distributor %Publisher%  -PublisherDB %PubDB%    
-SubscriberDB %SubDB% -Publication %PubName%  -PublisherSecurityMode 1  -OutputVerboseLevel 3    
-Output -SubscriberSecurityMode 1  -SubscriptionType 3 -DistributorSecurityMode 1    
-Hostname "adventure-works\Fernando"  -DynamicSnapshotLocation %SnapshotDir%  

PAUSE  

Utilizzo di RMO (Replication Management Objects)Using Replication Management Objects (RMO)

È possibile utilizzare oggetti RMO (Replication Management Objects) per generare snapshot partizionati a livello di programmazione nelle modalità seguenti:You can use Replication Management Objects (RMO) to generate partitioned snapshots programmatically in the following ways:

  • Consentire ai Sottoscrittori di richiedere la generazione e l'applicazione dello snapshot alla prima sincronizzazione.Allow Subscribers to request snapshot generation and application the first time they synchronize.

  • Pregenerare uno snapshot per ogni partizione.Pre-generate snapshots for each partition.

  • Generare manualmente uno snapshot per ogni Sottoscrittore eseguendo l'agente snapshot.Manually generate a snapshot for each Subscriber by running the Snapshot Agent.

Nota

Quando il filtro di un articolo produce partizioni non sovrapposte univoche per ogni sottoscrizione (specificando un valore F:Microsoft.SqlServer.Replication.PartitionOptions.NonOverlappingSingleSubscription per P:Microsoft.SqlServer.Replication.MergeArticle.PartitionOption nel caso della creazione di un articolo di tipo merge), i metadati vengono puliti ogni volta che viene eseguito l'agente di merge.When filtering for an article yields non-overlapping partitions that are unique for each subscription (by specifying a value of F:Microsoft.SqlServer.Replication.PartitionOptions.NonOverlappingSingleSubscription for P:Microsoft.SqlServer.Replication.MergeArticle.PartitionOption when creating a merge article), metadata is cleaned up whenever the Merge Agent runs. Lo snapshot partizionato scade quindi più rapidamente.This means that the partitioned snapshot expires more quickly. Quando si utilizza questa opzione, è consigliabile consentire ai Sottoscrittori di richiedere la generazione degli snapshot.When you use this option, you should consider allowing Subscribers to request snapshot generation. Per ulteriori informazioni, vedere la sezione relativa all'utilizzo delle opzioni di filtro appropriate nell'argomento Parameterized Row Filters.For more information, see the section Using the Appropriate Filtering Options in the topic Parameterized Row Filters.

Importante

Se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione.When possible, prompt users to enter security credentials at runtime. Se è necessario archiviare le credenziali, utilizzare i servizi di crittografia offerti da MicrosoftMicrosoft Windows .NET Framework.If you must store credentials, use the cryptographic services provided by the MicrosoftMicrosoft Windows .NET Framework.

Per creare una pubblicazione che consente ai Sottoscrittori di avviare la generazione e il recapito di snapshotTo create a publication that allows Subscribers to initiate snapshot generation and delivery

  1. Creare una connessione al server di pubblicazione tramite la classe ServerConnection .Create a connection to the Publisher by using the ServerConnection class.

  2. Creare un'istanza della classe ReplicationDatabase per il database di pubblicazione, impostare la proprietà ConnectionContext sull'istanza di ServerConnection del passaggio 1, quindi chiamare il metodo LoadProperties .Create an instance of the ReplicationDatabase class for the publication database, set the ConnectionContext property to the instance of ServerConnection from step 1, and call the LoadProperties method. If LoadProperties restituisce false, verificare che il database esista.If LoadProperties returns false, confirm that the database exists.

  3. If EnabledMergePublishing è false, impostarla su true e chiamare CommitPropertyChanges.If EnabledMergePublishing property is false, set it to true and call CommitPropertyChanges.

  4. Creare un'istanza della classe MergePublication e impostare le proprietà seguenti per questo oggetto:Create an instance of the MergePublication class, and set the following properties for this object:

    • Oggetto ServerConnection indicato nel passaggio 1 per ConnectionContext.The ServerConnection from step 1 for ConnectionContext.

    • Nome del database pubblicato per DatabaseName.The name of the published database for DatabaseName.

    • Nome per la pubblicazione per Name.A name for the publication for Name.

    • Numero massimo di processi di snapshot dinamici da eseguire per MaxConcurrentDynamicSnapshots.The maximum number of dynamic snapshot jobs to run for MaxConcurrentDynamicSnapshots. Poiché le richieste di snapshot avviate dal Sottoscrittore possono verificarsi in qualsiasi momento, questa proprietà limita il numero di processi dell'agente snapshot che possono essere eseguiti simultaneamente quando più Sottoscrittori richiedono il rispettivo snapshot partizionato contemporaneamente.Because Subscriber initiated snapshot requests can occur at any time, this property limits the number of Snapshot Agent jobs that can run simultaneously when multiple Subscribers request their partitioned snapshot at the same time. Quando è in esecuzione il numero massimo di processi, le richieste aggiuntive di snapshot partizionati vengono inserite nella coda fino al completamento di uno dei processi.When the maximum number of jobs are running, additional partitioned snapshot requests are queued until one of the running jobs is completed.

    • Utilizzare l'operatore logico OR bit per bit (| in Visual C# e Or in Visual Basic) per aggiungere il valore AllowSubscriberInitiatedSnapshot a Attributes.Use the bitwise logical OR (| in Visual C# and Or in Visual Basic) operator to add the value AllowSubscriberInitiatedSnapshot to Attributes.

    • Campi Login e Password di SnapshotGenerationAgentProcessSecurity per fornire le credenziali per l'account di MicrosoftMicrosoft Windows con cui verrà eseguito il processo dell'agente snapshot.The Login and Password fields of SnapshotGenerationAgentProcessSecurity to provide the credentials for the MicrosoftMicrosoft Windows account under which the Snapshot Agent job runs.

      Nota

      È consigliabile impostare SnapshotGenerationAgentProcessSecurity quando la pubblicazione viene creata da un membro del ruolo predefinito del server sysadmin .Setting SnapshotGenerationAgentProcessSecurity is recommended when the publication is created by a member of the sysadmin fixed server role. Per altre informazioni, vedere Replication Agent Security Model.For more information, see Replication Agent Security Model.

  5. Chiamare il metodo Create per creare la pubblicazione.Call the Create method to create the publication.

    Importante

    Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutte le proprietà, inclusa SnapshotGenerationAgentProcessSecurity, vengono inviati al server di distribuzione come testo normale.When configuring a Publisher with a remote Distributor, the values supplied for all properties, including SnapshotGenerationAgentProcessSecurity, are sent to the Distributor as plain text. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di chiamare il metodo Create.You should encrypt the connection between the Publisher and its remote Distributor before calling the Create method. Per altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  6. Utilizzare la proprietà MergeArticle per aggiungere articoli alla pubblicazione.Use the MergeArticle property to add articles to the publication. Specificare la proprietà FilterClause per almeno un articolo che definisce il filtro con parametri.Specify the FilterClause property for at least one article that defines the parameterized filter. (Facoltativo) Creare oggetti MergeJoinFilter che definiscono i filtri join tra gli articoli.(Optional) Create MergeJoinFilter objects that define join filters between articles. Per altre informazioni, vedere Define an Article.For more information, see Define an Article.

  7. Se il valore di SnapshotAgentExists è false, chiamare CreateSnapshotAgent per creare il processo dell'agente snapshot iniziale per questa pubblicazione.If the value of SnapshotAgentExists is false, call CreateSnapshotAgent to create the initial Snapshot Agent job for this publication.

  8. Chiamare il metodo StartSnapshotGenerationAgentJob dell'oggetto MergePublication creato nel passaggio 4.Call the StartSnapshotGenerationAgentJob method of the MergePublication object created in step 4. In questo modo viene avviato il processo dell'agente che genera lo snapshot iniziale.This starts the agent job that generates the initial snapshot. Per ulteriori informazioni sulla generazione di uno snapshot iniziale e sulla definizione di una pianificazione personalizzata per l'agente snapshot, vedere Create and Apply the Initial Snapshot.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

  9. (Facoltativo) Verificare la presenza di un valore true per la proprietà SnapshotAvailable per determinare quando lo snapshot iniziale è pronto per l'utilizzo.(Optional) Check for a value of true for the SnapshotAvailable property to determine when the initial snapshot is ready for use.

  10. La prima volta che l'agente di merge per un Sottoscrittore si connette, verrà generato automaticamente uno snapshot partizionato.When the Merge Agent for a Subscriber connects for the first time, a partitioned snapshot is generated automatically.

Per creare una pubblicazione e pregenerare o aggiornare automaticamente gli snapshotTo create a publication and pregenerate or automatically refresh snapshots

  1. Utilizzare un'istanza della classe MergePublication per definire una pubblicazione di tipo merge.Use an instance of the MergePublication class to define a merge publication. Per altre informazioni, vedere Create a Publication.For more information, see Create a Publication.

  2. Utilizzare la proprietà MergeArticle per aggiungere articoli alla pubblicazione.Use the MergeArticle property to add articles to the publication. Specificare la proprietà FilterClause per almeno un articolo che definisce il filtro con parametri, quindi creare eventuali oggetti MergeJoinFilter che definiscono filtri join tra gli articoli.Specify the FilterClause property for at least one article that defines the parameterized filter, and create any MergeJoinFilter objects that define join filters between articles. Per altre informazioni, vedere Define an Article.For more information, see Define an Article.

  3. Se il valore di SnapshotAgentExists è false, chiamare CreateSnapshotAgent per creare il processo dell'agente snapshot per questa pubblicazione.If the value of SnapshotAgentExists is false, call CreateSnapshotAgent to create the snapshot agent job for this publication.

  4. Chiamare il metodo StartSnapshotGenerationAgentJob dell'oggetto MergePublication creato nel passaggio 1.Call the StartSnapshotGenerationAgentJob method of the MergePublication object created in step 1. Questo metodo avvia il processo dell'agente che genera lo snapshot iniziale.This method starts the agent job that generates the initial snapshot. Per ulteriori informazioni sulla generazione di uno snapshot iniziale e sulla definizione di una pianificazione personalizzata per l'agente snapshot, vedere Create and Apply the Initial Snapshot.For more information on generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

  5. (Facoltativo) Verificare la presenza di un valore true per la proprietà SnapshotAvailable per determinare quando lo snapshot iniziale è pronto per l'utilizzo.Check for a value of true for the SnapshotAvailable property to determine when the initial snapshot is ready for use.

  6. Creare un'istanza della classe MergePartition e impostare i criteri di filtro con parametri per il Sottoscrittore utilizzando una o entrambe le proprietà seguenti:Create an instance of the MergePartition class, and set the parameterized filtering criteria for the Subscriber by using one or both of the following properties:

  7. Creare un'istanza della classe MergeDynamicSnapshotJob e impostare la stessa proprietà indicata nel passaggio 6.Create an instance of the MergeDynamicSnapshotJob class, and set the same property as in step 6.

  8. Utilizzare la classe ReplicationAgentSchedule per definire una pianificazione per la generazione dello snapshot filtrato per la partizione del Sottoscrittore.Use the ReplicationAgentSchedule class to define a schedule for generating the filtered snapshot for the Subscriber partition.

  9. Utilizzando l'istanza di MergePublication indicata nel passaggio 1, chiamare AddMergePartition.Using the instance of MergePublication from step 1, call AddMergePartition. Passare l'oggetto MergePartition indicato nel passaggio 6.Pass the MergePartition object from step 6.

  10. Utilizzando l'istanza di MergePublication indicata nel passaggio 1, chiamare il metodo AddMergeDynamicSnapshotJob .Using the instance of MergePublication from step 1, call the AddMergeDynamicSnapshotJob method. Passare l'oggetto MergeDynamicSnapshotJob indicato nel passaggio 7 e l'oggetto ReplicationAgentSchedule indicato nel passaggio 8.Pass the MergeDynamicSnapshotJob object from step 7 and the ReplicationAgentSchedule object from step 8.

  11. Chiamare EnumMergeDynamicSnapshotJobse individuare l'oggetto MergeDynamicSnapshotJob per il processo di snapshot partizionato appena aggiunto nella matrice restituita.Call EnumMergeDynamicSnapshotJobs, and locate the MergeDynamicSnapshotJob object for the newly added partitioned snapshot job in the returned array.

  12. Ottenere la proprietà Name per il processo.Get the Name property for the job.

  13. Creare una connessione al server di distribuzione tramite la classe ServerConnection .Create a connection to the Distributor by using the ServerConnection class.

  14. Creare un'istanza della classe Server SMO (SQL Server Management Objects) passando l'oggetto ServerConnection indicato nel passaggio 13.Create an instance of the SQL Server Management Objects (SMO) Server class, passing the ServerConnection object from step 13.

  15. Creare un'istanza della classe Job passando la proprietà JobServer dell'oggetto Server indicato nel passaggio 14 e il nome del processo indicato nel passaggio 12.Create an instance of the Job class, passing the JobServer property of the Server object from step 14 and the job name from step 12.

  16. Chiamare il metodo Start per avviare il processo di snapshot partizionato.Call the Start method to start the partitioned snapshot job.

  17. Ripetere i passaggi da 6 a 16 per ogni Sottoscrittore.Repeat steps 6-16 for each Subscriber.

Per creare una pubblicazione e creare manualmente gli snapshot per ogni partizioneTo create a publication and manually create snapshots for each partition

  1. Utilizzare un'istanza della classe MergePublication per definire una pubblicazione di tipo merge.Use an instance of the MergePublication class to define a merge publication. Per altre informazioni, vedere Create a Publication.For more information, see Create a Publication.

  2. Utilizzare la proprietà MergeArticle per aggiungere articoli alla pubblicazione. Specificare la proprietà FilterClause per almeno un articolo che definisce il filtro con parametri, quindi creare eventuali oggetti MergeJoinFilter che definiscono i filtri join tra gli articoli.Use the MergeArticle property to add articles to the publication Specify the FilterClause property for at least one article that defines the parameterized filter, and create any MergeJoinFilter objects that define join filters between articles. Per altre informazioni, vedere Define an Article.For more information, see Define an Article.

  3. Generare lo snapshot iniziale.Generate the initial snapshot. Per altre informazioni, vedere Create and Apply the Initial Snapshot.For more information, see Create and Apply the Initial Snapshot.

  4. Creare un'istanza della classe Microsoft.SqlServer.Replication.SnapshotGenerationAgent e impostare le seguenti proprietà obbligatorie:Create an instance of the Microsoft.SqlServer.Replication.SnapshotGenerationAgent class, and set the following required properties:

  5. Impostare un valore di Merge per Microsoft.SqlServer.Replication.SnapshotGenerationAgent.ReplicationType*.Set a value of Merge for Microsoft.SqlServer.Replication.SnapshotGenerationAgent.ReplicationType*.

  6. Impostare una o più delle seguenti proprietà per definire i parametri di partizionamento:Set one or more of the following properties to define the partitioning parameters:

  7. Chiamare il metodo Microsoft.SqlServer.Replication.SnapshotGenerationAgent.GenerateSnapshot* .Call the Microsoft.SqlServer.Replication.SnapshotGenerationAgent.GenerateSnapshot* method.

  8. Ripetere i passaggi da 4 a 7 per ogni Sottoscrittore.Repeat steps 4-7 for each Subscriber.

Esempi (RMO)Examples (RMO)

In questo esempio viene creata una pubblicazione di tipo merge che consente ai Sottoscrittori di richiedere la generazione di snapshot.This example creates a merge publication that allows Subscribers to requested snapshot generation.

// Set the Publisher, publication database, and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";

ReplicationDatabase publicationDb;
MergePublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
	// Connect to the Publisher.
	conn.Connect();

	// Enable the database for merge publication.				
	publicationDb = new ReplicationDatabase(publicationDbName, conn);
	if (publicationDb.LoadProperties())
	{
		if (!publicationDb.EnabledMergePublishing)
		{
			publicationDb.EnabledMergePublishing = true;
		}
	}
	else
	{
		// Do something here if the database does not exist. 
		throw new ApplicationException(String.Format(
			"The {0} database does not exist on {1}.",
			publicationDb, publisherName));
	}

	// Set the required properties for the merge publication.
	publication = new MergePublication();
	publication.ConnectionContext = conn;
	publication.Name = publicationName;
	publication.DatabaseName = publicationDbName;

             // Enable precomputed partitions.
             publication.PartitionGroupsOption = PartitionGroupsOption.True;

	// Specify the Windows account under which the Snapshot Agent job runs.
	// This account will be used for the local connection to the 
	// Distributor and all agent connections that use Windows Authentication.
	publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
	publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

	// Explicitly set the security mode for the Publisher connection
	// Windows Authentication (the default).
	publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

	// Enable Subscribers to request snapshot generation and filtering.
	publication.Attributes |= PublicationAttributes.AllowSubscriberInitiatedSnapshot;
             publication.Attributes |= PublicationAttributes.DynamicFilters;

             // Enable pull and push subscriptions.
             publication.Attributes |= PublicationAttributes.AllowPull;
             publication.Attributes |= PublicationAttributes.AllowPush;

	if (!publication.IsExistingObject)
	{
		// Create the merge publication.
		publication.Create();
		
		// Create a Snapshot Agent job for the publication.
		publication.CreateSnapshotAgent();
	}
	else
	{
		throw new ApplicationException(String.Format(
			"The {0} publication already exists.", publicationName));
	}
}

catch (Exception ex)
{
	// Implement custom application error handling here.
	throw new ApplicationException(String.Format(
		"The publication {0} could not be created.", publicationName), ex);
}
finally
{
	conn.Disconnect();
}
' Set the Publisher, publication database, and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publicationDb As ReplicationDatabase
Dim publication As MergePublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Enable the database for merge publication.				
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = True
        End If
    Else
        ' Do something here if the database does not exist. 
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist on {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the merge publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Enable precomputed partitions.
    publication.PartitionGroupsOption = PartitionGroupsOption.True

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    ' Enable Subscribers to request snapshot generation and filtering.
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowSubscriberInitiatedSnapshot
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.DynamicFilters

    ' Enable pull and push subscriptions
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPull
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPush

    If Not publication.IsExistingObject Then
        ' Create the merge publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

In questo esempio vengono creati manualmente la partizione del Sottoscrittore e lo snapshot filtrato per una pubblicazione di tipo merge con filtri di riga con parametri.This example manually creates the Subscriber partition and the filtered snapshot for a merge publication with parameterized row filters.

// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string distributorName = publisherInstance;

MergePublication publication;
MergePartition partition;
MergeDynamicSnapshotJob snapshotAgentJob;
ReplicationAgentSchedule schedule;

// Create a connection to the Publisher.
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create a connection to the Distributor to start the Snapshot Agent.
ServerConnection distributorConn = new ServerConnection(distributorName);

try
{
	// Connect to the Publisher.
	publisherConn.Connect();

	// Set the required properties for the publication.
	publication = new MergePublication();
	publication.ConnectionContext = publisherConn;
	publication.Name = publicationName;
	publication.DatabaseName = publicationDbName;


	// If we can't get the properties for this merge publication, 
	// then throw an application exception.
	if (publication.LoadProperties() || publication.SnapshotAvailable)
	{
		// Set a weekly schedule for the filtered data snapshot.
		schedule = new ReplicationAgentSchedule();
		schedule.FrequencyType = ScheduleFrequencyType.Weekly;
		schedule.FrequencyRecurrenceFactor = 1;
		schedule.FrequencyInterval = Convert.ToInt32(0x001);

		// Set the value of Hostname that defines the data partition. 
		partition = new MergePartition();
		partition.DynamicFilterHostName = hostname;
		snapshotAgentJob = new MergeDynamicSnapshotJob();
		snapshotAgentJob.DynamicFilterHostName = hostname;

		// Create the partition for the publication with the defined schedule.
		publication.AddMergePartition(partition);
		publication.AddMergeDynamicSnapshotJob(snapshotAgentJob, schedule);
	}
	else
	{
		throw new ApplicationException(String.Format(
			"Settings could not be retrieved for the publication, " +
			" or the initial snapshot has not been generated. " +
			"Ensure that the publication {0} exists on {1} and " +
			"that the Snapshot Agent has run successfully.",
			publicationName, publisherName));
	}
}
catch (Exception ex)
{
	// Do error handling here.
	throw new ApplicationException(string.Format(
		"The partition for '{0}' in the {1} publication could not be created.",
		hostname, publicationName), ex);
}
finally
{
	publisherConn.Disconnect();
	if (distributorConn.IsOpen) distributorConn.Disconnect();
}
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim distributorName As String = publisherInstance

Dim publication As MergePublication
Dim partition As MergePartition
Dim snapshotAgentJob As MergeDynamicSnapshotJob
Dim schedule As ReplicationAgentSchedule

' Create a connection to the Publisher.
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create a connection to the Distributor to start the Snapshot Agent.
Dim distributorConn As ServerConnection = New ServerConnection(distributorName)

Try
    ' Connect to the Publisher.
    publisherConn.Connect()

    ' Set the required properties for the publication.
    publication = New MergePublication()
    publication.ConnectionContext = publisherConn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName


    ' If we can't get the properties for this merge publication, 
    ' then throw an application exception.
    If (publication.LoadProperties() Or publication.SnapshotAvailable) Then
        ' Set a weekly schedule for the filtered data snapshot.
        schedule = New ReplicationAgentSchedule()
        schedule.FrequencyType = ScheduleFrequencyType.Weekly
        schedule.FrequencyRecurrenceFactor = 1
        schedule.FrequencyInterval = Convert.ToInt32("0x001", 16)

        ' Set the value of Hostname that defines the data partition. 
        partition = New MergePartition()
        partition.DynamicFilterHostName = hostname
        snapshotAgentJob = New MergeDynamicSnapshotJob()
        snapshotAgentJob.DynamicFilterHostName = hostname

        ' Create the partition for the publication with the defined schedule.
        publication.AddMergePartition(partition)
        publication.AddMergeDynamicSnapshotJob(snapshotAgentJob, schedule)
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication, " + _
         " or the initial snapshot has not been generated. " + _
         "Ensure that the publication {0} exists on {1} and " + _
         "that the Snapshot Agent has run successfully.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException(String.Format( _
     "The partition for '{0}' in the {1} publication could not be created.", _
     hostname, publicationName), ex)
Finally
    publisherConn.Disconnect()
    If distributorConn.IsOpen Then
        distributorConn.Disconnect()
    End If
End Try

In questo esempio viene avviato manualmente l'agente snapshot per generare lo snapshot di dati filtrati per un Sottoscrittore in una pubblicazione di tipo merge con filtri di riga con parametri.This example manually starts the Snapshot Agent to generate the filtered data snapshot for a Subscriber to a merge publication with parameterized row filters.

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string publisherName = publisherInstance;
string distributorName = publisherInstance;

SnapshotGenerationAgent agent;

try
{
	// Set the required properties for Snapshot Agent.
	agent = new SnapshotGenerationAgent();
	agent.Distributor = distributorName;
	agent.DistributorSecurityMode = SecurityMode.Integrated;
	agent.Publisher = publisherName;
	agent.PublisherSecurityMode = SecurityMode.Integrated;
	agent.Publication = publicationName;
	agent.PublisherDatabase = publicationDbName;
	agent.ReplicationType = ReplicationType.Merge;

	// Specify the partition information to generate a 
	// filtered snapshot based on Hostname.
	agent.DynamicFilterHostName = hostname;

	// Start the agent synchronously.
	agent.GenerateSnapshot();
}
catch (Exception ex)
{
	// Implement custom application error handling here.
	throw new ApplicationException(String.Format(
		"A snapshot could not be generated for the {0} publication."
		, publicationName), ex);
}
' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance
Dim distributorName As String = publisherInstance

Dim agent As SnapshotGenerationAgent

Try
    ' Set the required properties for Snapshot Agent.
    agent = New SnapshotGenerationAgent()
    agent.Distributor = distributorName
    agent.DistributorSecurityMode = SecurityMode.Integrated
    agent.Publisher = publisherName
    agent.PublisherSecurityMode = SecurityMode.Integrated
    agent.Publication = publicationName
    agent.PublisherDatabase = publicationDbName
    agent.ReplicationType = ReplicationType.Merge

    ' Specify the partition information to generate a 
    ' filtered snapshot based on Hostname.
    agent.DynamicFilterHostName = hostname

    ' Start the agent synchronously.
    agent.GenerateSnapshot()
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
End Try

Vedere ancheSee Also

Parameterized Row Filters Parameterized Row Filters
Replication System Stored Procedures Concepts Replication System Stored Procedures Concepts
Snapshot per pubblicazioni di tipo merge con filtri con parametri Snapshots for Merge Publications with Parameterized Filters
Replication Security Best PracticesReplication Security Best Practices