Replication Snapshot Agent

S’applique à : SQL ServerAzure SQL Database

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.

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]  
[-PrefetchTables [0|1] ]  
[-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.

-Publication publication
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.

-BcpBatchSize bcp_ 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.

-DefinitionFile def_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.

-Distributor server_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é.

-DistributorLogin distributor_login
Connexion utilisée lors de la connexion au serveur de distribution à l’aide de l’authentification SQL Server.

-DistributorPassword distributor_password
Mot de passe utilisé lors de la connexion au serveur de distribution à l’aide de 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) et la valeur 1 indique le mode d’authentification Windows.

-DynamicFilterHostName dynamic_filter_host_name
Permet de définir une valeur pour HOST_NAME (Transact-SQL) dans le filtrage lorsqu’un instantané dynamique est créé. 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.

-DynamicFilterLogin dynamic_filter_login
Permet de définir une valeur pour SUSER_SNAME (Transact-SQL) dans le filtrage lorsqu’un instantané dynamique est créé. 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é.

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

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

Pour plus d’informations, consultez Afficher et modifier les paramètres de sécurité de la réplication.

-FieldDelimiter field_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.

-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.

-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.

-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.

-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.

-LoginTimeOut login_time_out_seconds
Nombre de secondes avant l’expiration de la connexion. La valeur par défaut est de 15 secondes.

-MaxBcpThreads number_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 correspond au double du nombre de processeurs.

- 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é.

-Output output_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.

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

-PrefetchTables [ 0| 1]
Paramètre facultatif qui spécifie si les objets de table sont prérécupérés et mis en cache. Le comportement par défaut consiste à prérécupérer certaines propriétés de la table à l’aide du composant SMO suivant un calcul interne. Ce paramètre peut être utile dans les scénarios où l’opération de prérécupération SMO est considérablement plus longue. S’il n’est pas utilisé, cette décision est prise à l’exécution en fonction du pourcentage de tables ajoutées comme articles à la publication.

-ProfileName profile_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.

-PublisherDB publisher_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é.

-PublisherFailoverPartner server_name[\instance_name]
Spécifie l’instance de 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).

-PublisherLogin publisher_login
Connexion utilisée lors de la connexion au serveur de publication à l’aide de l’authentification SQL Server.

-PublisherPassword publisher_password
Mot de passe utilisé lors de la connexion au serveur de publication à l’aide de l’authentification SQL Server. .

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

-QueryTimeOut query_time_out_seconds
Nombre de secondes avant l’expiration de la requête. La valeur par défaut est 1800 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.

-RowDelimiter row_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.

-StartQueueTimeout start_queue_timeout_seconds
Nombre maximal de secondes que l’Agent d’instantané attend lorsque le nombre de processus d’instantané dynamique simultanés en cours d’exécution est défini par la @max_concurrent_dynamic_snapshots propriété 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

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

Administration de l’Agent de réplication