Créer un instantané d'une publication de fusion avec des filtres paramétrésCreate a Snapshot for a Merge Publication with Parameterized Filters

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Cette rubrique explique comment créer un instantané pour une publication de fusion avec des filtres paramétrables dans SQL Server 2017SQL Server 2017 à l'aide de SQL Server Management StudioSQL Server Management Studio, de Transact-SQLTransact-SQLou d'objets RMO (Replication Management Objects).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).

Lorsque vous utilisez des filtres de lignes paramétrés dans les publications de fusion, la réplication initialise chaque abonnement avec un instantané en deux parties.When parameterized row filters are used in merge publications, replication initializes each subscription with a two-part snapshot. Un instantané est d'abord créée. Il contient tous les objets nécessaires à la publication ainsi que le schéma des objets publiés mais pas les données.First, a schema snapshot is created that contains all objects required by replication and the schema of the published objects, but not the data. Ensuite, chaque abonnement est initialisé avec un instantané qui comprend les objets et le schéma provenant de l'instantané du schéma ainsi que les données appartenant à la partition de l'abonnement.Then, each subscription is initialized with a snapshot that includes the objects and schema from the schema snapshot and the data that belongs to the subscription's partition. Si plusieurs abonnements reçoivent une partition donnée (en d'autres termes, s'ils reçoivent les mêmes schéma et données), l'instantané de cette partition n'est créé qu'une seule fois ; plusieurs abonnements sont initialisés à l'aide du même instantané.If more than one subscription receives a given partition (in other words, they receive the same schema and data), the snapshot for that partition is created only once; multiple subscriptions are initialized from the same snapshot. Pour plus d'informations sur les filtres de lignes paramétrés, consultez Parameterized Row Filters.For more information about parameterized row filters, see Parameterized Row Filters.

Pour créer des instantanés de publication avec des filtres paramétrés, trois méthodes sont possibles :You can create snapshots for publications with parameterized filters in one of three ways:

  • Vous pouvez prégénérer des instantanés pour chaque partition.Pre-generate snapshots for each partition. Cette option vous permet de contrôler le moment où les instantanés sont générés.Using this option allows you to control when snapshots are generated.
    Vous pouvez également choisir d'actualiser les instantanés selon une planification définie.You can also choose to have the snapshots refreshed on a schedule. Les nouveaux Abonnés à une partition dont vous avez créé un instantané reçoivent un instantané à jour.New Subscribers that subscribe to a partition for which a snapshot has been created will receive an up-to-date snapshot.

  • Vous pouvez autoriser les Abonnés à demander la génération et l’application d’un instantané lors de leur première synchronisation.Allow Subscribers to request snapshot generation and application the first time they synchronize. Cette option permet aux nouveaux Abonnés de se synchroniser sans intervention d'un administrateur (l'AgentSQL ServerSQL Server doit être en cours d'exécution sur le serveur de publication pour que l'instantané puisse être généré).Using this option allows new Subscribers to synchronize without requiring intervention from an administrator (SQL ServerSQL Server Agent must be running at the Publisher to allow the snapshot to be generated).

    Notes

    Si le filtrage d'un ou plusieurs articles de la publication donne des partitions qui ne se chevauchent pas et sont uniques pour chaque abonnement, les métadonnées sont nettoyées à chaque exécution de l'Agent de fusion.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. Cela signifie que l'instantané partitionné expire plus rapidement.This means that the partitioned snapshot expires more quickly. Lorsque vous optez pour cette méthode, envisagez d'autoriser les Abonnées à initialiser la génération et la remise d'instantané.When using this option, you should consider allowing Subscribers to initiate snapshot generation and delivery. Pour plus d'informations sur les options de filtrage, consultez Parameterized Row Filters.For more information about filtering options, see Parameterized Row Filters.

  • Vous pouvez générer manuellement un instantané pour chaque Abonné avec l’Agent d’instantané.Manually generate a snapshot for each Subscriber with the Snapshot Agent. L'Abonné doit alors fournir l'emplacement de l'instantané à l'Agent de fusion afin qu'il puisse extraire et appliquer l'instantané approprié.The Subscriber must then provide the snapshot location to the Merge Agent, so it can retrieve and apply the correct snapshot.

    Notes

    Cette option est prise en charge pour assurer la compatibilité descendante et n'autorise pas les partages d'instantanés FTP.This option is supported for backward compatibility and does not allow FTP snapshot shares.

L'approche la plus souple est celle qui consiste à combiner les options d'instantané prégénéré et d'instantané demandé par l'Abonné : les instantanés sont prégénérés et actualisés à intervalles planifiés (généralement pendant les heures creuses), mais un Abonné peut générer son propre instantané en cas de création d'un abonnement nécessitant une nouvelle partition.The most flexible approach is to use a combination of pre-generated and Subscriber-requested snapshot options: snapshots are pre-generated and refreshed on a scheduled basis (usually during off-peak times), but a Subscriber can generate its own snapshot if a subscription that requires a new partition is created.

Prenons l'exemple de Adventure WorksAdventure Works, qui possède une force de vente nomade chargée d'approvisionner en stock différents magasins.Consider Adventure WorksAdventure Works, which has a mobile work force that delivers inventory to individual stores. Chaque commercial reçoit un abonnement basé sur son nom de connexion, lequel extrait les données relatives aux magasins dont le commercial est responsable.Each sales person receives a subscription based on their login, which retrieves the data for the stores they service. L'administrateur choisit de prégénérer des instantanés et de les actualiser tous les dimanches.The administrator chooses to pre-generate snapshots and refresh them every Sunday. De temps à autre, un nouvel utilisateur est ajouté au système et a besoin de données pour une partition dont il n'existe aucun instantané disponible.Occasionally a new user is added to the system and needs data for a partition that does not have a snapshot available. L'administrateur décide par ailleurs d'autoriser les instantanés initialisés par l'Abonné pour éviter que ce dernier se retrouve dans une situation où il est incapable de s'abonner à la publication car aucun instantané n'est disponible.The administrator also chooses to allow Subscriber-initiated snapshots to avoid the situation where a Subscriber cannot subscribe to the publication because the snapshot is not yet available. Lorsque le nouvel Abonné se connecte pour la première fois, l'instantané est généré pour la partition spécifiée et appliqué à l'Abonné (l'AgentSQL ServerSQL Server doit être en cours d'exécution sur le serveur de publication pour que l'instantané puisse être généré).When the new Subscriber connects for the first time, the snapshot is generated for the specified partition and applied at the Subscriber (SQL ServerSQL Server Agent must be running at the Publisher to allow the snapshot to be generated).

Pour créer un instantané d'une publication avec des filtres paramétrés, consultez Créer un instantané d'une publication de fusion avec des filtres paramétrés.To create a snapshot for a publication with parameterized filters, see Create a Snapshot for a Merge Publication with Parameterized Filters.

Paramètres de sécurité de l'Agent d'instantanéSecurity Settings for the Snapshot Agent

L'Agent d'instantané crée des instantanés de chaque partition.The Snapshot Agent creates snapshots for each partition. Pour les instantanés prégénérés et ceux demandés par un Abonné, l'Agent s'exécute et se connecte avec les informations d'identification spécifiées au moment de la création du travail de l'Agent d'instantané pour la publication (ce travail est créé par l'Assistant Nouvelle publication ou par sp_addpublication_snapshot).For pre-generated snapshots and snapshots requested by a Subscriber, the agent runs and makes connections under the credentials that were specified when the snapshot agent job for the publication was created (the job is created by the New Publication Wizard or sp_addpublication_snapshot). Pour modifier les informations d'identification, utilisez sp_changedynamicsnapshot_job.To change the credentials, use sp_changedynamicsnapshot_job. Pour plus d’informations, consultez sp_changedynamicsnapshot_job (Transact-SQL).For more information, see sp_changedynamicsnapshot_job (Transact-SQL).

RecommandationsRecommendations

  • Lors de la génération d'un instantané pour une publication de fusion à l'aide de filtres paramétrables, vous devez commencer par générer un instantané standard (schéma) qui contient l'ensemble des données publiées, ainsi que les métadonnées de l'Abonné pour l'abonnement.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. Pour plus d'informations, voir Créer et appliquer l'instantané initial.For more information, see Create and Apply the Initial Snapshot. Après avoir créé l'instantané de schéma, vous pouvez générer l'instantané qui contient la partition des données publiées spécifique à l'Abonné.After you have created the schema snapshot, you can generate the snapshot that contains the Subscriber-specific partition of the published data.

  • Si le filtrage d'un ou plusieurs articles de la publication donne des partitions qui ne se chevauchent pas et sont uniques pour chaque abonnement, les métadonnées sont nettoyées à chaque exécution de l'Agent de fusion.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. Cela signifie que l'instantané partitionné expire plus rapidement.This means that the partitioned snapshot expires more quickly. Lorsque vous optez pour cette méthode, envisagez d'autoriser les Abonnées à initialiser la génération et la remise d'instantané.When using this option, you should consider allowing Subscribers to initiate snapshot generation and delivery.

Utilisation de SQL Server Management StudioUsing SQL Server Management Studio

Générez des instantanés pour des partitions dans la page Partitions de données de la boîte de dialogue Propriétés de la publication< - Publication>.Generate snapshots for partitions on the Data Partitions page of the Publication Properties - <Publication> dialog box. Pour plus d'informations sur l'accès à cette boîte de dialogue, consultez Afficher et modifier les propriétés d’un serveur de publication.For more information about accessing this dialog box, see View and Modify Publication Properties. Vous pouvez permettre à des Abonnés de lancer la génération et la livraison d'instantanés et/ou de générer des instantanés.You can allow Subscribers to initiate snapshot generation and delivery and/or generate snapshots.

Pour générer des instantanés pour une ou plusieurs partitions, vous devez préalablement :Before generating snapshots for one or more partitions, you must:

  1. créer une publication de fusion à l'aide de l'Assistant Nouvelle publication et spécifier un ou plusieurs filtres de lignes paramétrables dans la page Ajouter un filtre de l'Assistant.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. Pour plus d'informations, voir 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. Générez un instantané du schéma pour la publication.Generate a schema snapshot for the publication. Par défaut, un instantané du schéma est généré lorsque vous terminez l'Assistant Nouvelle publication ; vous pouvez également générer un instantané du schéma à partir de 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.

Nous sommes à votre écoute : Si vous trouvez des informations obsolètes ou incorrectes dans cet article, par exemple une étape ou une erreur dans un code, n’hésitez pas à nous en faire part.We are listening: If you find something outdated or incorrect in this article, such as a step or a code example, please tell us. Vous pouvez cliquer sur le bouton Cette page dans la section Commentaires au bas de cette page.You can click the This page button in the Feedback section at the bottom of this page. Nous lisons chaque commentaire concernant SQL, généralement le jour suivant.We read every item of feedback about SQL, typically the next day. Nous vous remercions.Thanks.

Pour générer un instantané du schémaTo generate a schema snapshot

  1. Connectez-vous au serveur de publication dans Management StudioManagement Studio, puis développez le nœud du serveur.Connect to the Publisher in Management StudioManagement Studio, and then expand the server node.

  2. Développez le dossier Réplication , puis le dossier Publications .Expand the Replication folder, and then expand the Publications folder.

  3. Cliquez avec le bouton droit sur la réplication pour laquelle vous souhaitez créer un instantané, puis cliquez sur Afficher l'état de l'Agent d'instantané.Right-click the publication for which you want to create a snapshot, and then click View Snapshot Agent Status.

  4. Dans la boîte de dialogue Afficher l’état de l’Agent d’instantané - <Publication> , cliquez sur Démarrer.In the View Snapshot Agent Status - <Publication> dialog box, click Start.

    Lorsque l'Agent d'instantané termine la génération de l'instantané, un message comme celui-ci s'affiche : « [100 %] Un instantané de 17 article(s) a été généré ».When the Snapshot Agent finishes generating the snapshot, a message will be displayed, such as "[100%] A snapshot of 17 article(s) was generated."

Pour permettre aux Abonnés d'initier la génération et la remise d'instantanésTo allow Subscribers to initiate snapshot generation and delivery

  1. Dans la page Partitions de données de la boîte de dialogue Propriétés de la publication - <Publication> , sélectionnez Définir automatiquement une partition et générer un instantané si nécessaire lorsqu’un nouvel Abonné essaie de se synchroniser.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. Cliquez sur OK.Click OK.

Pour générer et actualiser des instantanésTo generate and refresh snapshots

  1. Dans la page Partitions de données de la boîte de dialogue Propriétés de la publication - <Publication> , cliquez sur Ajouter.On the Data Partitions page of the Publication Properties - <Publication> dialog box, click Add.

  2. Entrez une valeur pour la valeur HOST_NAME() et/ou SUSER_SNAME() associée à la partition pour laquelle vous voulez créer un instantané.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. En option, spécifiez une planification pour l'actualisation des instantanés :Optionally specify a schedule for refreshing snapshots:

    1. Sélectionnez Planifier l'Agent d'instantané pour l'exécution de cette partition à l'heure ou aux heures suivantes.Select Schedule the Snapshot Agent for this partition to run at the following time(s)

    2. Acceptez la planification par défaut pour l'actualisation des instantanés, ou cliquez sur Modifier pour spécifier une autre planification.Accept the default schedule for refreshing snapshots, or click Change to specify a different schedule.

  4. Cliquez sur OK pour revenir à la boîte de dialogue Propriétés de la publication - <Publication> .Click OK, which returns you to the Publication Properties - <Publication> dialog box.

  5. Sélectionnez la partition dans la grille de propriétés, puis cliquez sur Générer les instantanés sélectionnés maintenant.Select the partition in the property grid, and then click Generate the selected snapshots now.

  6. Cliquez sur OK.Click OK.

Utilisation de Transact-SQLUsing Transact-SQL

Les procédures stockées et l'Agent d'instantané permettent d'effectuer les tâches suivantes :Using stored procedures and the Snapshot Agent, you can perform the following:

  • Vous pouvez autoriser les Abonnés à demander la génération et l'application d'un instantané lors de leur première synchronisation.Allow Subscribers to request snapshot generation and application the first time they synchronize.

  • Vous pouvez prégénérer des instantanés pour chaque partition.Pre-generate snapshots for each partition.

  • générer manuellement un instantané pour chaque Abonné.Manually generate a snapshot for each Subscriber.

    Important

    Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution.When possible, prompt users to enter security credentials at runtime. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

Pour créer une publication qui permet aux Abonnés d'initialiser la génération et la remise d'instantanésTo create a publication that allows Subscribers to initiate snapshot generation and delivery

  1. Dans la base de données de publication sur le serveur de publication, exécutez sp_addmergepublication (Transact-SQL).At the Publisher on the publication database, execute sp_addmergepublication (Transact-SQL). Spécifiez les paramètres suivants :Specify the following parameters:

    • Le nom de la publication pour @publication.The name of the publication for @publication.

    • La valeur true pour @allow_subscriber_initiated_snapshot, qui permet aux Abonnés de lancer le processus d’instantané.A value of true for @allow_subscriber_initiated_snapshot, which enables Subscribers to initiate the snapshot process.

    • (Facultatif) Le nombre de processus d’instantané dynamique qui peuvent s’exécuter simultanément pour @max_concurrent_dynamic_snapshots.(Optional) The number of dynamic snapshot processes that can run concurrently for @max_concurrent_dynamic_snapshots. Si le nombre maximal de processus en cours d'exécution est atteint et si un Abonné essaie de générer un instantané, le processus est placé en file d'attente.If the maximum number of processes is running and a Subscriber attempts to generate a snapshot, the process is placed in a queue. Par défaut, le nombre de processus simultanés est illimité.By default there is no limit to the number of concurrent processes.

  2. Sur le serveur de publication, exécutez sp_addpublication_snapshot (Transact-SQL).At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). Spécifiez le nom de publication utilisé à l’étape 1 pour @publication et les informations d’identification Windows MicrosoftMicrosoft sous lesquelles Replication Snapshot Agent s’exécute pour @job_login et @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. Si l’agent doit utiliser l’authentification SQL ServerSQL Server lors de la connexion au serveur de publication, vous devez aussi spécifier la valeur 0 pour @publisher_security_mode et les informations de connexion MicrosoftMicrosoft SQL ServerSQL Server pour @publisher_login et @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. Il s'ensuit la création d'un travail de l'Agent d'instantané pour la publication.This creates a Snapshot Agent job for the publication. Pour plus d'informations sur la génération d'un instantané initial et la définition d'une planification personnalisée pour l'Agent d'instantané, consultez 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.

    Important

    Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées en texte brut au serveur de distribution.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. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Pour plus d’informations, consultez Activer des connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. Exécutez sp_addmergearticle (Transact-SQL) pour ajouter des articles à la publication.Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. Cette procédure stockée doit être exécutée une fois pour chaque article de la publication.This stored procedure must be executed once for each article in the publication. Lorsque vous utilisez des filtres paramétrables, vous devez spécifier un filtre de lignes paramétrable pour un ou plusieurs articles à l’aide du paramètre @subset_filterclause.When using parameterized filters, you must specify a parameterized row filter for one or more articles using the @subset_filterclause parameter. Pour plus d'informations, voir Définir et modifier un filtre de lignes paramétrable pour un article de fusion.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. Si d’autres articles doivent être filtrés sur la base du filtre de lignes paramétrable, exécutez sp_addmergefilter (Transact-SQL) pour définir la relation de jointure ou d’enregistrements logiques entre les articles.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. Cette procédure stockée doit être exécutée une fois pour chaque relation en cours de définition.This stored procedure must be executed once for each relationship being defined. Pour plus d'informations, voir Define and Modify a Join Filter Between Merge Articles.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. Lorsque l'Agent de fusion demande à l'instantané d'initialiser l'Abonné, l'instantané de la partition de l'abonnement demandeur est généré automatiquement.When the Merge Agent requests the snapshot to initialize the Subscriber, the snapshot for the requesting subscription's partition is automatically generated.

Pour créer une publication et prégénérer ou actualiser automatiquement des instantanésTo create a publication and pre-generate or automatically refresh snapshots

  1. Exécutez sp_addmergepublication (Transact-SQL) pour créer la publication.Execute sp_addmergepublication (Transact-SQL) to create the publication. Pour plus d’informations, voir Create a Publication.For more information, see Create a Publication.

  2. Sur le serveur de publication, exécutez sp_addpublication_snapshot (Transact-SQL).At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). Spécifiez le nom de publication utilisé à l’étape 1 pour @publication et les informations d’identification Windows sous lesquelles l’Agent d’instantané s’exécute pour @job_login et @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. Si l’agent doit utiliser l’authentification SQL ServerSQL Server lors de la connexion au serveur de publication, vous devez aussi spécifier la valeur 0 pour @publisher_security_mode et les informations de connexion SQL ServerSQL Server pour @publisher_login et @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. Il s'ensuit la création d'un travail de l'Agent d'instantané pour la publication.This creates a Snapshot Agent job for the publication. Pour plus d'informations sur la génération d'un instantané initial et la définition d'une planification personnalisée pour l'Agent d'instantané, consultez 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.

    Important

    Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées en texte brut au serveur de distribution.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. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Pour plus d’informations, consultez Activer des connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. Exécutez sp_addmergearticle (Transact-SQL) pour ajouter des articles à la publication.Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. Cette procédure stockée doit être exécutée une fois pour chaque article de la publication.This stored procedure must be executed once for each article in the publication. Lorsque vous utilisez des filtres paramétrables, vous devez spécifier un filtre de lignes paramétrable pour un seul article à l’aide du paramètre @subset_filterclause.When using parameterized filters, you must specify a parameterized row filter for one article using the @subset_filterclause parameter. Pour plus d'informations, voir Définir et modifier un filtre de lignes paramétrable pour un article de fusion.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. Si d’autres articles doivent être filtrés sur la base du filtre de lignes paramétrable, exécutez sp_addmergefilter (Transact-SQL) pour définir la relation de jointure ou d’enregistrements logiques entre les articles.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. Cette procédure stockée doit être exécutée une fois pour chaque relation en cours de définition.This stored procedure must be executed once for each relationship being defined. Pour plus d’informations, consultez Définir et modifier un filtre de jointure entre des articles de fusion.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. Dans la base de données de publication sur le serveur de publication, exécutez sp_helpmergepublication (Transact-SQL), en spécifiant la valeur de @publication créée à l’étape 1.At the Publisher on the publication database, execute sp_helpmergepublication (Transact-SQL), specifying the value of @publication from step 1. Notez la valeur du snapshot_jobid dans le jeu de résultats.Note the value of the snapshot_jobid in the result set.

  6. Convertissez la valeur du snapshot_jobid obtenue à l'étape 5 en uniqueidentifier.Convert the value of the snapshot_jobid obtained in step 5 to uniqueidentifier.

  7. Dans la base de données msdb sur le serveur de publication, exécutez sp_start_job (Transact-SQL), en spécifiant la valeur convertie obtenue à l’étape 6 pour @job_id.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. Dans la base de données de publication sur le serveur de publication, exécutez sp_addmergepartition (Transact-SQL).At the Publisher on the publication database, execute sp_addmergepartition (Transact-SQL). Spécifiez le nom de la publication créée à l’étape 1 pour @publication et la valeur utilisée afin de définir la partition pour @suser_sname si SUSER_SNAME (Transact-SQL) est utilisé dans la clause de filtre ou pour @host_name si HOST_NAME (Transact-SQL) est utilisé dans la clause de filtre.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. Dans la base de données de publication sur le serveur de publication, exécutez sp_adddynamicsnapshot_job (Transact-SQL).At the publisher on the publication database, execute sp_adddynamicsnapshot_job (Transact-SQL). Spécifiez le nom de la publication définie à l’étape 1 pour @publication, la valeur de @suser_sname ou @host_name définie à l’étape 8 et une planification pour le travail.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. Le travail qui génère l'instantané paramétrable pour la partition spécifiée est ainsi créé.This creates the job that generates the parameterized snapshot for the specified partition. Pour plus d’informations, consultez Spécifier des planifications de synchronisation.For more information, see Specify Synchronization Schedules.

    Notes

    Ce travail s'exécute à l'aide du même compte Windows que le travail d'instantané initial défini à l'étape 2.This job runs using the same Windows account as the initial snapshot job defined in step 2. Pour supprimer le travail d’instantané paramétrable et sa partition de données associée, exécutez sp_dropdynamicsnapshot_job (Transact-SQL).To remove the parameterized snapshot job and its related data partition, execute sp_dropdynamicsnapshot_job (Transact-SQL).

  10. Dans la base de données de publication sur le serveur de publication, exécutez sp_helpmergepartition (Transact-SQL) en spécifiant la valeur de @publication définie à l’étape 1 et la valeur de @suser_sname ou @host_name définie à l’étape 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. Notez la valeur du dynamic_snapshot_jobid dans le jeu de résultats.Note the value of the dynamic_snapshot_jobid in the result set.

  11. Dans la base de données msdb sur le serveur de distribution, exécutez sp_start_job (Transact-SQL), en spécifiant la valeur obtenue à l’étape 9 pour @job_id.At the Distributor on the msdb database, execute sp_start_job (Transact-SQL), specifying the value obtained in step 9 for @job_id. Le travail d'instantané paramétrable de la partition est alors démarré.This starts the parameterized snapshot job for the partition.

  12. Répétez les étapes 8 à 11 pour générer un instantané partitionné pour chaque abonnement.Repeat steps 8-11 to generate a partitioned snapshot for each subscription.

Pour créer une publication et créer manuellement des instantanés pour chaque partitionTo create a publication and manually create snapshots for each partition

  1. Exécutez sp_addmergepublication (Transact-SQL) pour créer la publication.Execute sp_addmergepublication (Transact-SQL) to create the publication. Pour plus d’informations, voir Create a Publication.For more information, see Create a Publication.

  2. Sur le serveur de publication, exécutez sp_addpublication_snapshot (Transact-SQL).At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). Spécifiez le nom de publication utilisé à l’étape 1 pour @publication et les informations d’identification Windows sous lesquelles l’Agent d’instantané s’exécute pour @job_login et @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. Si l’agent doit utiliser l’authentification SQL ServerSQL Server lors de la connexion au serveur de publication, vous devez aussi spécifier la valeur 0 pour @publisher_security_mode et les informations de connexion SQL ServerSQL Server pour @publisher_login et @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. Il s'ensuit la création d'un travail de l'Agent d'instantané pour la publication.This creates a Snapshot Agent job for the publication. Pour plus d'informations sur la génération d'un instantané initial et la définition d'une planification personnalisée pour l'Agent d'instantané, consultez 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.

    Important

    Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées en texte brut au serveur de distribution.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. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Pour plus d’informations, consultez Activer des connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. Exécutez sp_addmergearticle (Transact-SQL) pour ajouter des articles à la publication.Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. Cette procédure stockée doit être exécutée une fois pour chaque article de la publication.This stored procedure must be executed once for each article in the publication. Lorsque vous utilisez des filtres paramétrables, vous devez spécifier un filtre de lignes paramétrable pour au moins un article à l’aide du paramètre @subset_filterclause.When using parameterized filters, you must specify a parameterized row filter for at least one article using the @subset_filterclause parameter. Pour plus d'informations, voir Définir et modifier un filtre de lignes paramétrable pour un article de fusion.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. Si d’autres articles doivent être filtrés sur la base du filtre de lignes paramétrable, exécutez sp_addmergefilter (Transact-SQL) pour définir la relation de jointure ou d’enregistrements logiques entre les articles.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. Cette procédure stockée doit être exécutée une fois pour chaque relation en cours de définition.This stored procedure must be executed once for each relationship being defined. Pour plus d'informations, voir Define and Modify a Join Filter Between Merge Articles.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. Démarrez le travail d'instantané ou exécutez l'Agent d'instantané des réplications à partir de l'invite de commandes pour générer le schéma d'instantané standard et d'autres fichiers.Start the snapshot job or run the Replication Snapshot Agent from the command prompt to generate the standard snapshot schema and other files. Pour plus d’informations, voir Create and Apply the Initial Snapshot.For more information, see Create and Apply the Initial Snapshot.

  6. Exécutez de nouveau l'Agent d'instantané des réplications à partir de l'invite de commandes pour générer des fichiers de copie en bloc (.bcp), en spécifiant l'emplacement de l'instantané partitionné pour - DynamicSnapshotLocation et une des propriétés suivantes ou les deux qui définissent la partition :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. Répétez l'étape 6 pour générer un instantané partitionné pour chaque abonnement.Repeat step 6 to generate a partitioned snapshot for each subscription.

  8. Exécutez l'Agent de fusion pour chaque abonnement afin d'appliquer l'instantané partitionné initial aux Abonnés, en spécifiant les propriétés suivantes :Run the Merge Agent for each subscription to apply the initial partitioned snapshot at the Subscribers, specifying the following properties:

    • -Hostname - la valeur utilisée pour définir la partition si la valeur réelle de HOST_NAME est remplacée.-Hostname - the value used to define the partition if the actual value of HOST_NAME is being overridden.

    • - DynamicSnapshotLocation - l'emplacement de l'instantané dynamique pour cette partition.-DynamicSnapshotLocation - the location of the dynamic snapshot for this partition.

Notes

Pour plus d’informations sur la programmation des agents de réplication, consultez Concepts des exécutables de l’Agent de réplication.For more information about programming replication agents, see Replication Agent Executables Concepts.

Exemples (Transact-SQL)Examples (Transact-SQL)

Cet exemple crée une publication de fusion avec des filtres paramétrables dans laquelle les Abonnés initialisent le processus de génération d'instantané.This example creates a merge publication with parameterized filters where Subscribers initiate the snapshot generation process. Les valeurs de @job_login et @job_password sont passées à l’aide de variables de script.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

Cet exemple crée une publication à l'aide d'un filtre paramétrable dans laquelle la partition de chaque Abonné est définie en exécutant sp_addmergepartition et le travail d'instantané filtré est créé en exécutant sp_adddynamicsnapshot_job et en passant les informations de partitionnement.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. Les valeurs de @job_login et @job_password sont passées à l’aide de variables de script.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

Cet exemple crée une publication à l'aide d'un filtre paramétrable dans laquelle la partition de données et le travail d'instantané filtré de chaque Abonné doivent être créés en fournissant les informations de partitionnement.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 Abonné fournit des informations de partitionnement à l'aide de paramètres de ligne de commande lors de l'exécution manuelle des agents de réplication.A Subscriber supplies partitioning information using command-line parameters when manually running the replication agents. Cet exemple suppose qu'un abonnement à la publication a également été créé.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  
  

Utilisation d'objets RMO (Replication Management Objects)Using Replication Management Objects (RMO)

Vous pouvez utiliser les Replication Management Objects pour générer par programme des instantanés partitionnés des manières suivantes :You can use Replication Management Objects (RMO) to generate partitioned snapshots programmatically in the following ways:

  • Vous pouvez autoriser les Abonnés à demander la génération et l'application d'un instantané lors de leur première synchronisation.Allow Subscribers to request snapshot generation and application the first time they synchronize.

  • Vous pouvez prégénérer des instantanés pour chaque partition.Pre-generate snapshots for each partition.

  • Vous pouvez générer manuellement un instantané pour chaque Abonné en exécutant l'Agent d'instantané.Manually generate a snapshot for each Subscriber by running the Snapshot Agent.

Notes

Lorsque le filtrage d’un article génère des partitions qui ne se chevauchent pas et qui sont uniques pour chaque abonnement (en spécifiant une valeur de F:Microsoft.SqlServer.Replication.PartitionOptions.NonOverlappingSingleSubscription pour P:Microsoft.SqlServer.Replication.MergeArticle.PartitionOption lors de la création d’un article de fusion), les métadonnées sont nettoyées à chaque exécution de l’Agent de fusion.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. Cela signifie que l'instantané partitionné expire plus rapidement.This means that the partitioned snapshot expires more quickly. Lorsque vous optez pour cette méthode, envisagez d'autoriser les Abonnées à demander la génération d'instantanés.When you use this option, you should consider allowing Subscribers to request snapshot generation. Pour plus d'informations, consultez la section Utilisation des options de filtrage appropriées, dans la rubrique Parameterized Row Filters.For more information, see the section Using the Appropriate Filtering Options in the topic Parameterized Row Filters.

Important

Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution.When possible, prompt users to enter security credentials at runtime. Si vous devez stocker des informations d'identification, utilisez les Services de chiffrement fournis par MicrosoftMicrosoft Windows .NET Framework.If you must store credentials, use the cryptographic services provided by the MicrosoftMicrosoft Windows .NET Framework.

Pour créer une publication qui permet aux Abonnés d'initialiser la génération et la remise d'instantanésTo create a publication that allows Subscribers to initiate snapshot generation and delivery

  1. Créez une connexion au serveur de publication en utilisant la classe ServerConnection .Create a connection to the Publisher by using the ServerConnection class.

  2. Créez une instance de la classe ReplicationDatabase pour la base de données de publication, affectez à la propriété ConnectionContext l'instance de ServerConnection créée à l'étape 1, puis appelez la méthode 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 retourne false, confirmez que la base de données existe.If LoadProperties returns false, confirm that the database exists.

  3. If EnabledMergePublishing a la valeur false, affectez-lui la valeur true et appelez CommitPropertyChanges.If EnabledMergePublishing property is false, set it to true and call CommitPropertyChanges.

  4. Créez une instance de la classe MergePublication et définissez les propriétés suivantes pour cet objet :Create an instance of the MergePublication class, and set the following properties for this object:

    • La classe ServerConnection créée à l'étape 1 pour la propriété ConnectionContext.The ServerConnection from step 1 for ConnectionContext.

    • Le nom de la base de données publiée pour DatabaseName.The name of the published database for DatabaseName.

    • Le nom de la publication pour Name.A name for the publication for Name.

    • Le nombre maximal de travaux d'instantané dynamique à exécuter pour MaxConcurrentDynamicSnapshots.The maximum number of dynamic snapshot jobs to run for MaxConcurrentDynamicSnapshots. Comme des demandes d'instantané initialisées par l'Abonné peuvent se produire à tout moment, cette propriété limite le nombre des travaux de l'Agent d'instantané qui peuvent s'exécuter simultanément lorsque plusieurs Abonnés demandent leur instantané partitionné au même moment.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. Lorsque le nombre maximal de travaux s'exécute, des demandes d'instantanés partitionnés supplémentaires sont mises en file d'attente jusqu'à ce que l'un des travaux en cours d'exécution se termine.When the maximum number of jobs are running, additional partitioned snapshot requests are queued until one of the running jobs is completed.

    • Utilisez l'opérateur OR logique de bits ( | dans Visual C# et Or dans Visual Basic) pour ajouter la valeur AllowSubscriberInitiatedSnapshot à Attributes.Use the bitwise logical OR (| in Visual C# and Or in Visual Basic) operator to add the value AllowSubscriberInitiatedSnapshot to Attributes.

    • Les champs Login et Password de SnapshotGenerationAgentProcessSecurity pour fournir les informations d'identification pour le compte MicrosoftMicrosoft Windows sous lequel le travail de l'Agent d'instantané s'exécute.The Login and Password fields of SnapshotGenerationAgentProcessSecurity to provide the credentials for the MicrosoftMicrosoft Windows account under which the Snapshot Agent job runs.

      Notes

      La définition de SnapshotGenerationAgentProcessSecurity est recommandée lorsque la publication est créée par un membre du rôle serveur fixe sysadmin .Setting SnapshotGenerationAgentProcessSecurity is recommended when the publication is created by a member of the sysadmin fixed server role. Pour plus d’informations, voir Replication Agent Security Model.For more information, see Replication Agent Security Model.

  5. Appelez la méthode Create pour créer la publication.Call the Create method to create the publication.

    Important

    Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour toutes les propriétés, y compris SnapshotGenerationAgentProcessSecurity, sont envoyées sous forme de texte brut au serveur de distribution.When configuring a Publisher with a remote Distributor, the values supplied for all properties, including SnapshotGenerationAgentProcessSecurity, are sent to the Distributor as plain text. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'appeler la méthode Create.You should encrypt the connection between the Publisher and its remote Distributor before calling the Create method. Pour plus d’informations, consultez Activer des connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  6. Utilisez la propriété MergeArticle pour ajouter des articles à la publication.Use the MergeArticle property to add articles to the publication. Spécifiez la propriété FilterClause pour au moins un article qui définit le filtre paramétrable.Specify the FilterClause property for at least one article that defines the parameterized filter. (Facultatif) Créez des objets MergeJoinFilter qui définissent des filtres de jointure entre les articles.(Optional) Create MergeJoinFilter objects that define join filters between articles. Pour plus d'informations, voir Define an Article.For more information, see Define an Article.

  7. Si SnapshotAgentExists a la valeur false, appelez CreateSnapshotAgent pour créer le travail de l'Agent d'instantané initial pour cette publication.If the value of SnapshotAgentExists is false, call CreateSnapshotAgent to create the initial Snapshot Agent job for this publication.

  8. Appelez la méthode StartSnapshotGenerationAgentJob de l'objet MergePublication créé à l'étape 4.Call the StartSnapshotGenerationAgentJob method of the MergePublication object created in step 4. Cela démarre le travail de l'agent qui génère l'instantané initial.This starts the agent job that generates the initial snapshot. Pour plus d'informations sur la génération d'un instantané initial et la définition d'une planification personnalisée pour l'Agent d'instantané, consultez 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. (Facultatif) Cherchez une valeur true pour la propriété SnapshotAvailable afin de déterminer quand l'instantané initial est prêt à être utilisé.(Optional) Check for a value of true for the SnapshotAvailable property to determine when the initial snapshot is ready for use.

  10. Lorsque l'Agent de fusion pour un Abonné se connecte pour la première fois, un instantané partitionné est généré automatiquement.When the Merge Agent for a Subscriber connects for the first time, a partitioned snapshot is generated automatically.

Pour créer une publication et prégénérer ou actualiser automatiquement des instantanésTo create a publication and pregenerate or automatically refresh snapshots

  1. Utilisez une instance de la classe MergePublication pour définir une publication de fusion.Use an instance of the MergePublication class to define a merge publication. Pour plus d’informations, voir Create a Publication.For more information, see Create a Publication.

  2. Utilisez la propriété MergeArticle pour ajouter des articles à la publication.Use the MergeArticle property to add articles to the publication. Spécifiez la propriété FilterClause pour au moins un article qui définit le filtre paramétrable et créez tous les objets MergeJoinFilter qui définissent les filtres de jointure entre les articles.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. Pour plus d’informations, consultez définir un Article.For more information, see Define an Article.

  3. Si SnapshotAgentExists a la valeur false, appelez CreateSnapshotAgent pour créer le travail de l'Agent d'instantané pour cette publication.If the value of SnapshotAgentExists is false, call CreateSnapshotAgent to create the snapshot agent job for this publication.

  4. Appelez la méthode StartSnapshotGenerationAgentJob de l'objet MergePublication créé à l'étape 1.Call the StartSnapshotGenerationAgentJob method of the MergePublication object created in step 1. Cette méthode démarre le travail de l'agent qui génère l'instantané initial.This method starts the agent job that generates the initial snapshot. Pour plus d'informations sur la génération d'un instantané initial et la définition d'une planification personnalisée pour l'Agent d'instantané, consultez Créer et appliquer l'instantané initial.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. Cherchez une valeur true pour la propriété SnapshotAvailable afin de déterminer quand l'instantané initial est prêt à être utilisé.Check for a value of true for the SnapshotAvailable property to determine when the initial snapshot is ready for use.

  6. Créez une instance de la classe MergePartition et définissez les critères de filtrage paramétrable pour l'Abonné en utilisant une des propriétés suivantes, ou les deux :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. Créez une instance de la classe MergeDynamicSnapshotJob et définissez la même propriété qu'à l'étape 6.Create an instance of the MergeDynamicSnapshotJob class, and set the same property as in step 6.

  8. Utilisez la classe ReplicationAgentSchedule pour définir une planification pour générer l'instantané filtré pour la partition de l'Abonné.Use the ReplicationAgentSchedule class to define a schedule for generating the filtered snapshot for the Subscriber partition.

  9. Utilisez l'instance de MergePublication de l'étape 1 pour appeler AddMergePartition.Using the instance of MergePublication from step 1, call AddMergePartition. Passez l'objet MergePartition créé à l'étape 6.Pass the MergePartition object from step 6.

  10. Utilisez l'instance de MergePublication de l'étape 1 pour appeler la méthode AddMergeDynamicSnapshotJob .Using the instance of MergePublication from step 1, call the AddMergeDynamicSnapshotJob method. Passez l'objet MergeDynamicSnapshotJob créé à l'étape 7 et l'objet ReplicationAgentSchedule créé à l'étape 8.Pass the MergeDynamicSnapshotJob object from step 7 and the ReplicationAgentSchedule object from step 8.

  11. Appelez EnumMergeDynamicSnapshotJobset localisez l'objet MergeDynamicSnapshotJob correspondant au travail d'instantané partitionné nouvellement ajouté dans le tableau retourné.Call EnumMergeDynamicSnapshotJobs, and locate the MergeDynamicSnapshotJob object for the newly added partitioned snapshot job in the returned array.

  12. Obtenez la propriété Name pour le travail.Get the Name property for the job.

  13. Créez une connexion au serveur de distribution en utilisant la classe ServerConnection .Create a connection to the Distributor by using the ServerConnection class.

  14. Créez une instance de la classe Server SMO (SQL Server Management Objects), en passant l'objet ServerConnection créé à l'étape 13.Create an instance of the SQL Server Management Objects (SMO) Server class, passing the ServerConnection object from step 13.

  15. Créez une instance de la classe Job , en passant la propriété JobServer de l'objet Server créé à l'étape 14 et le nom du travail obtenu à l'étape 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. Appelez la méthode Start pour démarrer le travail d'instantané partitionné.Call the Start method to start the partitioned snapshot job.

  17. Répétez les étapes 6 à 16 pour chaque Abonné.Repeat steps 6-16 for each Subscriber.

Pour créer une publication et créer manuellement des instantanés pour chaque partitionTo create a publication and manually create snapshots for each partition

  1. Utilisez une instance de la classe MergePublication pour définir une publication de fusion.Use an instance of the MergePublication class to define a merge publication. Pour plus d’informations, voir Create a Publication.For more information, see Create a Publication.

  2. Utilisez la propriété MergeArticle pour ajouter des articles à la publication. Spécifiez la propriété FilterClause pour au moins un article qui définit le filtre paramétrable et créez tous les objets MergeJoinFilter qui définissent les filtres de jointure entre les articles.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. Pour plus d’informations, consultez définir un Article.For more information, see Define an Article.

  3. Générez l'instantané initial.Generate the initial snapshot. Pour plus d'informations, voir Create and Apply the Initial Snapshot.For more information, see Create and Apply the Initial Snapshot.

  4. Créez une instance de la classe Microsoft.SqlServer.Replication.SnapshotGenerationAgent et définissez les propriétés requises suivantes :Create an instance of the Microsoft.SqlServer.Replication.SnapshotGenerationAgent class, and set the following required properties:

  5. Spécifiez la valeur Merge pour Microsoft.SqlServer.Replication.SnapshotGenerationAgent.ReplicationType*.Set a value of Merge for Microsoft.SqlServer.Replication.SnapshotGenerationAgent.ReplicationType*.

  6. Définissez une ou plusieurs des propriétés suivantes pour définir les paramètres de partitionnement :Set one or more of the following properties to define the partitioning parameters:

  7. Appelez la méthode Microsoft.SqlServer.Replication.SnapshotGenerationAgent.GenerateSnapshot* .Call the Microsoft.SqlServer.Replication.SnapshotGenerationAgent.GenerateSnapshot* method.

  8. Répétez les étapes 4 à 7 pour chaque Abonné.Repeat steps 4-7 for each Subscriber.

Exemples (RMO)Examples (RMO)

Cet exemple crée une publication de fusion qui permet aux Abonnés de demander la génération d'instantanés.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

Cet exemple crée manuellement la partition de l'Abonné et l'instantané filtré pour une publication de fusion avec des filtres de lignes paramétrables.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

Cet exemple lance manuellement l'Agent d'instantané pour qu'il génère l'instantané des données filtrées pour un Abonné à une publication de fusion avec des filtres de lignes paramétrables.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

Voir aussiSee Also

Filtres de lignes paramétrés Parameterized Row Filters
Concepts liés aux procédures stockées système de réplication Replication System Stored Procedures Concepts
Bonnes pratiques en matière de sécurité de la réplicationReplication Security Best Practices