Replication Snapshot Agent
S’applique à : 
SQL Server Azure 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.
Remarque
- Les paramètres peuvent être spécifiés dans n'importe quel ordre.
Remarque
Azure SQL Managed Instance peut être un serveur de publication, un serveur de distribution et un abonné pour la réplication transactionnelle et d’instantané. Les bases de données dans Azure SQL Database peuvent uniquement être des abonnés de type push pour la réplication transactionnelle et d’instantané. Pour plus d’informations, consultez Réplication transactionnelle avec Azure SQL Database et Réplication transactionnelle avec Azure SQL Managed Instance.
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é.
| 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. |
-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.
| Valeur EncryptionLevel | Description |
|---|---|
| 0 | Spécifie que le chiffrement TLS n'est pas utilisé. |
| 1 | Spécifie que le chiffrement TLS/SSL est utilisé, mais que l'agent ne vérifie pas si le certificat de serveur TLS/SSL est signé par un émetteur de confiance. |
| 2 | Spécifie que le chiffrement TLS est utilisé et que le certificat est vérifié. |
Remarque
Un certificat TLS/SSL valide est défini avec le nom de domaine complet de l’instance SQL Server. Pour que l’agent puisse se connecter lorsque vous définissez EncryptionLevel sur 2, créez un alias sur l’instance locale de SQL Server. Le paramètre « Nom de l’alias » doit correspondre au nom du serveur, et le paramètre « Serveur » doit être défini sur le nom complet de l’instance SQL Server.
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.
| 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 (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.
-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.
Remarque
Si l’objet répliqué a un filtre, l’agent de capture instantanée va générer un fichier BCP pour cet article au lieu de générer plusieurs fichiers BCP.
- 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
La définition de ce paramètre sur 1 est utile uniquement lorsque l’option d’optimisation de synchronisation de la publication de fusion a la valeur true (le @keep_partition_changes** paramètre de sp_addmergepublication (Transact-SQL)).
-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.
| Valeur OutputVerboseLevel | Description |
|---|---|
| 0 | Seuls les messages d'erreur sont imprimés. |
| 1 (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 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.
Remarque
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.
-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.
| Valeur OutputVerboseLevel | Description |
|---|---|
| 0 | L’appel de la méthode de prérécupération de composant SMO est désactivé. |
| 1 | L’Agent d’instantané appellera la méthode prérécupération pour mettre en cache certaines propriétés de la table à l’aide de SMO. |
-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é.
| 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 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
Important
Si vous avez installé SQL Server Agent pour s’exécuter sous un compte système local plutôt que sous un compte d’utilisateur de domaine (la valeur par défaut), le service peut accéder uniquement à l’ordinateur local. Si l’Agent d’instantané qui s’exécute sous SQL Server Agent 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.