Partager via

Agent d'instantané de réplication

  • Article

L'Agent d'instantané de réplication est un fichier exécutable qui prépare les fichiers d'instantané contenant les schémas ainsi que les données des tables et des objets de base de données publiés, stocke les fichiers dans le dossier d'instantanés, et enregistre les travaux de synchronisation dans la base de données de distribution.

[!REMARQUE]

Les paramètres peuvent être spécifiés dans n'importe quel ordre.

Syntaxe

snapshot [ -?] 
-Publisher server_name[\instance_name] 
-Publication publication_name 
[-70Subscribers] 
[-BcpBatchSize bcp_batch_size]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorDeadlockPriority [-1|0|1] ]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1] ]
[-DynamicFilterHostName dynamic_filter_host_name]
[-DynamicFilterLogin dynamic_filter_login]
[-DynamicSnapshotLocation dynamic_snapshot_location] 
[-EncryptionLevel [0|1|2]]
[-FieldDelimiter field_delimiter]
[-HistoryVerboseLevel [0|1|2|3] ]
[-HRBcpBlocks number_of_blocks ]
[-HRBcpBlockSize block_size ]
[-HRBcpDynamicBlocks ]
[-KeepAliveMessageInterval keep_alive_interval]
[-LoginTimeOut login_time_out_seconds]
[-MaxBcpThreads number_of_threads ]
[-MaxNetworkOptimization [0|1]]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2] ]
[-PacketSize packet_size]
[-ProfileName profile_name]
[-PublisherDB publisher_database]
[-PublisherDeadlockPriority [-1|0|1] ]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password] 
[-PublisherSecurityMode [0|1] ]
[-QueryTimeOut query_time_out_seconds]
[-ReplicationType [1|2] ]
[-RowDelimiter row_delimiter]
[-StartQueueTimeout start_queue_timeout_seconds]
[-UsePerArticleContentsView use_per_article_contents_view]

Arguments

  • -?
    Imprime tous les paramètres disponibles.

  • -Publisher server_name[**\instance_name]
    Nom du serveur de publication. Spécifiez server_name pour l'instance par défaut de Microsoft SQL Server sur ce serveur. Spécifiez server_name    \**instance_name pour une instance nommée de SQL Server sur ce serveur.

  • -Publicationpublication
    Nom de la publication. Ce paramètre est uniquement valide si la publication est configurée de telle sorte qu'un instantané soit toujours disponible pour les nouveaux abonnements ou les abonnements réinitialisés.

  • -70Subscribers
    Doit être utilisé si des Abonnés exécutent SQL Server version 7.0.

  • -BcpBatchSizebcp_ batch_ size
    Nombre de lignes à envoyer dans une opération de copie en bloc. Lorsque vous effectuez une opération bcp in, la taille du lot correspond au nombre de lignes à envoyer au serveur en une transaction, mais aussi au nombre de lignes à envoyer avant que l'Agent de distribution ne journalise un message de progression bcp. Lorsque vous effectuez une opération bcp out, une taille de lot fixe de 1000 est utilisée. La valeur 0 indique qu'aucune journalisation de message n'est autorisée.

  • -DefinitionFiledef_path_and_file_name
    Chemin d'accès du fichier de définition d'agent. Un fichier de définition d'agent contient des arguments de ligne de commande pour l'agent. Le contenu du fichier est analysé en tant que fichier exécutable. Utilisez des guillemets doubles (") pour spécifier des valeurs d'argument qui contiennent des caractères arbitraires.

  • -Distributorserver_name[**\instance_name]
    Nom du serveur de distribution. Spécifiez server_name pour l'instance par défaut de SQL Server sur ce serveur. Spécifiez server_name    \**instance_name pour une instance nommée de SQL Server sur ce serveur.

  • -DistributorDeadlockPriority [-1|0|1]
    Priorité de la connexion de l'Agent d'instantané au serveur de distribution lorsqu'un blocage se produit. Ce paramètre est spécifié pour résoudre les blocages qui peuvent se produire entre l'Agent d'instantané et les applications utilisateur lors de la génération d'instantané.

    Valeur DistributorDeadlockPriority

    Description

    -1

    Les applications autres que l'Agent d'instantané ont priorité lorsqu'un blocage se produit au niveau du serveur de distribution.

    0 (valeur par défaut)

    La priorité n'est pas assignée.

    1

    L'Agent d'instantané a priorité lorsqu'un blocage se produit au niveau du serveur de distribution.

  • -DistributorLogindistributor_login
    Nom de connexion utilisé pour la connexion au serveur de distribution avec l'authentification SQL Server.

  • -DistributorPassworddistributor_password
    Mot de passe utilisé pour la connexion au serveur de distribution avec l'authentification SQL Server. .

  • -DistributorSecurityMode [ 0| 1]
    Spécifie le mode de sécurité du serveur de distribution. La valeur 0 indique le mode d'authentification SQL Server (par défaut), tandis que la valeur 1 indique le mode d'authentification Windows.

  • -DynamicFilterHostNamedynamic_filter_host_name
    Est utilisé pour définir une valeur pour l'HOST_NAME (Transact-SQL) chargés du filtrage lorsqu'un instantané dynamique est créée. Par exemple, si la clause de filtre de sous-ensemble rep_id = HOST_NAME() est spécifiée pour un article et que vous attribuez à la propriété DynamicFilterHostName la valeur « FBJones » avant d'appeler l'Agent de fusion, seules les lignes contenant « FBJones » dans la colonne rep_id seront répliquées.

  • -DynamicFilterLogindynamic_filter_login
    Est utilisé pour définir une valeur pour l'SUSER_SNAME (Transact-SQL)chargés du filtrage lorsqu'un instantané dynamique est créée. Par exemple, si la clause de filtre de sous-ensemble user_id = SUSER_SNAME() est spécifiée pour un article et que vous attribuez à la propriété DynamicFilterLogin la valeur « rsmith » avant d'appeler la méthode Run de l'objet SQLSnapshot, seules les lignes contenant « rsmith » dans la colonne user_id seront incluses dans l'instantané.

  • -DynamicSnapshotLocationdynamic_snapshot_location
    Emplacement où l'instantané dynamique doit être généré.

  • -EncryptionLevel [ 0 | 1 | 2 ]
    Niveau du chiffrement SSL (Secure Sockets Layer) utilisé par l'Agent d'instantané lors de l'établissement de connexions.

    Valeur EncryptionLevel

    Description

    0

    Spécifie que le chiffrement SSL n'est pas utilisé.

    1

    Spécifie que le chiffrement SSL est utilisé, mais que l'agent ne vérifie pas si le certificat de serveur SSL est signé par un émetteur de confiance.

    2

    Spécifie que le chiffrement SSL est utilisé et que le certificat est vérifié.

    Pour plus d'informations, consultez Vue d'ensemble de la sécurité (réplication).

  • -FieldDelimiterfield_delimiter
    Caractère ou séquence de caractères qui marque la fin d'un champ dans le fichier de données de copie en bloc SQL Server. La valeur par défaut est \n<x$3>\n.

  • -HistoryVerboseLevel [ 1| 2| 3]
    Spécifie la quantité d'informations d'historique journalisées pendant une opération d'instantané. Vous pouvez réduire l'effet de la journalisation d'historique sur les performances en sélectionnant 1.

    Valeur HistoryVerboseLevel

    Description

    0

    Les messages de progression sont écrits dans la console ou dans un fichier de sortie. Les enregistrements d'historique ne sont pas journalisés dans la base de données de distribution.

    1

    Met toujours à jour un message d'historique précédent du même état (démarrage, progression, succès, et ainsi de suite). Si aucun enregistrement précédent du même état n'existe, insère un nouvel enregistrement.

    2 (valeur par défaut)

    Insère de nouveaux enregistrements d'historique, sauf s'il s'agit d'un enregistrement concernant notamment un message inactif ou un message de travail de longue durée, auquel cas les enregistrements précédents sont mis à jour.

    3

    Insère toujours de nouveaux enregistrements, sauf s'il s'agit de messages inactifs.

  • -HRBcpBlocks number_of_blocks
    Nombre des blocs de données bcp mis en file d'attente entre les threads de lecture/écriture. La valeur par défaut est 50. HRBcpBlocks est utilisé uniquement avec les publications Oracle.

    [!REMARQUE]

    Ce paramètre est utilisé pour le réglage des performances de bcp pour un serveur de publication Oracle.

  • -HRBcpBlockSizeblock_size
    Taille, en kilo-octets (Ko), de chaque bloc de données bcp. La valeur par défaut est 64 Ko. HRBcpBlocks est utilisé uniquement avec les publications Oracle.

    [!REMARQUE]

    Ce paramètre est utilisé pour le réglage des performances de bcp pour un serveur de publication Oracle.

  • -HRBcpDynamicBlocks
    Indique si la taille de chaque bloc de données bcp peut croître dynamiquement ou non. HRBcpBlocks est utilisé uniquement avec les publications Oracle.

    [!REMARQUE]

    Ce paramètre est utilisé pour le réglage des performances de bcp pour un serveur de publication Oracle.

  • -KeepAliveMessageInterval keep_alive_interval
    Durée, en secondes, de l'attente de l'Agent d'instantané avant de journaliser un message d'attente du système principal dans la table MSsnapshot_history. La valeur par défaut est 300 secondes.

  • -LoginTimeOutlogin_time_out_seconds
    Nombre de secondes avant l'expiration de la connexion. La valeur par défaut est 15 secondes.

  • -MaxBcpThreadsnumber_of_threads
    Spécifie le nombre d'opérations de copie en bloc pouvant être effectuées en parallèle. Le nombre maximal de threads et de connexions ODBC pouvant exister simultanément est, en privilégiant la valeur la plus petite, MaxBcpThreads ou le nombre de demandes de copie en bloc qui apparaissent dans la transaction de synchronisation dans la base de données de distribution. MaxBcpThreads doit avoir une valeur supérieure à 0 et n'a aucune limite supérieure codée en dur. La valeur par défaut est 1.

  • - MaxNetworkOptimization [ 0| 1]
    Indique si les suppressions non pertinentes sont envoyées à l'Abonné. Les suppressions non pertinentes sont des commandes DELETE qui sont envoyées aux Abonnés pour les lignes qui n'appartiennent pas à la partition de l'Abonné. Les suppressions non pertinentes n'affectent ni l'intégrité ni la convergence des données, mais elles peuvent générer un trafic réseau inutile. La valeur par défaut de MaxNetworkOptimization est 0. Le fait d'attribuer à MaxNetworkOptimization la valeur 1 réduit le risque d'obtention de suppressions non pertinentes, minimisant ainsi le trafic réseau et maximisant l'optimisation du réseau. L'attribution de la valeur 1 à ce paramètre peut aussi augmenter le stockage des métadonnées et entraîner une réduction des performances au niveau du serveur de publication si plusieurs niveaux de filtres de jointure et des filtres de sous-ensemble complexes sont présents. Vous devez évaluer avec soin votre topologie de réplication et attribuer uniquement à MaxNetworkOptimization la valeur 1 si le trafic réseau des suppressions non pertinentes est trop élevé.

    [!REMARQUE]

    L'attribution de la valeur 1 à ce paramètre n'est utile que lorsque l'option d'optimisation de la synchronisation de la publication de fusion a la valeur true (le paramètre @keep_partition_changes de sp_addmergepublication (Transact-SQL)).

  • -Outputoutput_path_and_file_name
    Chemin d'accès du fichier de sortie de l'Agent. Si le nom du fichier n'est pas spécifié, la sortie est envoyée à la console. Si le nom de fichier spécifié existe, la sortie est ajoutée au fichier.

  • -OutputVerboseLevel [ 0| 1| 2]
    Spécifie si la sortie doit être en clair.

    Valeur OutputVerboseLevel

    Description

    0

    Seuls les messages d'erreur sont imprimés.

    1 (valeur par défaut)

    Tous les messages du rapport de progression sont imprimés (valeur par défaut).

    2

    Tous les messages d'erreur et tous les messages du rapport de progression sont imprimés, ce qui peut s'avérer utile lors du débogage.

  • -PacketSize packet_size
    Taille du paquet (en octets) utilisée par l'Agent d'instantané lors de la connexion à SQL Server. La valeur par défaut est 8 192 octets.

> [!REMARQUE]
> <P>Ne modifiez pas la taille des paquets, sauf si vous êtes certain que cela permettra d'accroître les performances. Pour la plupart des applications, la taille de paquet par défaut représente la meilleure solution.</P>

  • -ProfileNameprofile_name
    Spécifie un profil d'agent à utiliser pour les paramètres d'agent. Si ProfileName a la valeur NULL, le profil d'agent est désactivé. Si ProfileName n'est pas spécifié, le profil par défaut du type d'agent est utilisé. Pour plus d'informations, consultez Profils de l'Agent de réplication.

  • -PublisherDBpublisher_database
    Nom de la base de données de publication. Ce paramètre n'est pas pris en charge pour les serveurs de publication Oracle.

  • -PublisherDeadlockPriority [-1|0|1]
    Priorité de la connexion de l'Agent d'instantané au serveur de publication lorsqu'un blocage se produit. Ce paramètre est spécifié pour résoudre les blocages qui peuvent se produire entre l'Agent d'instantané et les applications utilisateur lors de la génération d'instantané.

    Valeur PublisherDeadlockPriority

    Description

    -1

    Les applications autres que l'Agent d'instantané ont priorité lorsqu'un blocage se produit au niveau du serveur de publication.

    0 (valeur par défaut)

    La priorité n'est pas assignée.

    1

    L'Agent d'instantané a priorité lorsqu'un blocage se produit au niveau du serveur de publication.

  • -PublisherFailoverPartner server_name[**\**instance_name]
    Spécifie l'instance du partenaire de basculement de SQL Server participant à une session de mise en miroir de bases de données avec la base de données de publication. Pour plus d'informations, consultez Mise en miroir de bases de données et réplication (SQL Server).

  • -PublisherLoginpublisher_login
    Nom de connexion utilisé pour la connexion au serveur de publication avec l'authentification SQL Server.

  • -PublisherPassword publisher_password
    Mot de passe utilisé pour la connexion au serveur de publication avec l'authentification SQL Server. .

  • -PublisherSecurityMode [ 0| 1]
    Spécifie le mode de sécurité du serveur de publication. La valeur 0 indique le mode d'authentification SQL Server (par défaut), tandis que la valeur 1 indique le mode d'authentification Windows.

  • -QueryTimeOutquery_time_out_seconds
    Nombre de secondes avant l'expiration de la requête. La valeur par défaut est 1 800 secondes.

  • -ReplicationType [ 1| 2]
    Spécifie le type de la réplication. La valeur 1 indique la réplication transactionnelle, tandis que la valeur 2 indique la réplication de fusion.

  • -RowDelimiterrow_delimiter
    Caractère ou séquence de caractères qui marque la fin d'une ligne dans le fichier de données de copie en bloc SQL Server. La valeur par défaut est \n<,@g\>\n.

  • -StartQueueTimeoutstart_queue_timeout_seconds
    Durée maximale en secondes de l'attente de l'Agent d'instantané lorsque le nombre de processus d'instantané dynamique simultanés en cours d'exécution a atteint la limite définie par la propriété @max_concurrent_dynamic_snapshots de sp_addmergepublication (Transact-SQL). Si le nombre maximal de secondes est atteint et que l'Agent d'instantané attend toujours, celui-ci se ferme. La valeur 0 signifie que l'Agent attend indéfiniment, bien qu'il soit possible de l'annuler.

  • - UsePerArticleContentsView use_per_article_contents_view
    Ce paramètre est déconseillé et n'est pris en charge que dans un but de compatibilité ascendante.

Notes

Important

Si vous avez installé l'Agent SQL Server pour s'exécuter sous un compte système local plutôt que sous un compte d'utilisateur de domaine (option par défaut), le service peut uniquement accéder à l'ordinateur local. Si l'Agent d'instantané qui s'exécute sous l'Agent SQL Server est configuré pour utiliser le mode d'authentification Windows lorsqu'il se connecte à SQL Server, l'Agent d'instantané échoue. Le paramètre par défaut est l'authentification SQL Server.

Pour démarrer l'Agent d'instantané, exécutez snapshot.exe à l'invite de commandes. Pour plus d'informations, consultez Concepts des exécutables de l'agent de réplication.

Voir aussi

Concepts

Administration de l'Agent de réplication