Replication Snapshot Agent

Se aplica a:SQL ServerAzure SQL Database

El Agente de instantáneas de replicación es un archivo ejecutable que prepara archivos de instantáneas que contienen el esquema y los datos de las tablas y objetos de base de datos publicados, almacena los archivos en la carpeta de instantáneas y registra los trabajos de sincronización en la base de datos de distribución.

Nota:

  • Los parámetros se pueden especificar en cualquier orden.

Nota:

Azure SQL Managed Instance puede ser un publicador, un distribuidor y un suscriptor para la replicación transaccional y de instantáneas. Las bases de datos de Azure SQL Database solo pueden ser suscriptores de extracción para la replicación transaccional y de instantáneas. Para obtener más información, vea Replicación transaccional con Azure SQL Database y Azure SQL Managed Instance.

Sintaxis

  
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]  

Argumentos

-?
Imprime todos los parámetros disponibles.

-Publisherserver_name[\instance_name]
Es el nombre del publicador. Especifique server_name para la instancia predeterminada de Microsoft SQL Server en ese servidor. Especifique server_name\instance_name para una instancia con nombre de SQL Server en ese servidor.

-Publicationpublicación
Es el nombre de la publicación. Este parámetro solamente es válido si la publicación se define para tener siempre una instantánea disponible para las suscripciones nuevas o reinicializadas.

-70Subscribers
Se debe usar si algún suscriptor ejecuta la versión 7.0 de SQL Server.

-BcpBatchSizebcp_ batch_ size
Es el número de filas para enviar en una operación de copia masiva. Al realizar una operación bcp in , el tamaño del lote es el número de filas para enviar al servidor como una transacción y también el número de filas que se deben enviar antes de que el Agente de distribución registre un mensaje de progreso de bcp . Al realizar una operación bcp out , se usa un tamaño de lote fijo de 1000. Un valor 0 indica que no se registran mensajes.

-DefinitionFiledef_path_and_file_name
Es la ruta de acceso del archivo de definición de agente. Un archivo de definición de agente contiene los argumentos de línea de comandos para el agente. El contenido del archivo se analiza como un archivo ejecutable. Utilice las comillas tipográficas (") para especificar valores de argumento que contienen caracteres arbitrarios.

-Distributorserver_name[\instance_name]
Es el nombre del distribuidor. Especifique server_name para la instancia predeterminada de SQL Server en ese servidor. Especifique server_name\instance_name para una instancia con nombre de SQL Server en ese servidor.

-DistributorDeadlockPriority [-1|0|1]
Es la prioridad de la conexión del Agente de instantáneas al distribuidor cuando se produce un interbloqueo. Este parámetro se especifica para resolver interbloqueos que se pueden producir entre las aplicaciones de usuario y el Agente de instantáneas durante la generación de instantáneas.

Valor DistributorDeadlockPriority Descripción
-1 Cuando se produce un interbloqueo en el distribuidor, tienen prioridad las aplicaciones distintas del Agente de instantáneas.
0 (predeterminado) No se asigna prioridad.
1 El Agente de instantáneas tiene la prioridad cuando se produce un interbloqueo en el distribuidor.

-DistributorLogindistributor_login
Es el inicio de sesión que se usa al conectar con el distribuidor mediante autenticación de SQL Server.

-DistributorPassworddistributor_password
Es la contraseña que se usa al conectar con el distribuidor mediante autenticación de SQL Server. .

-DistributorSecurityMode [ 0| 1]
Especifica el modo de seguridad del distribuidor. Un valor de 0 hace referencia al modo de autenticación de SQL Server (valor predeterminado) y un valor de 1 hace referencia al modo de autenticación de Windows.

-DynamicFilterHostNamedynamic_filter_host_name
Se usa para establecer un valor para HOST_NAME (Transact-SQL) al filtrar cuando se crea una instantánea dinámica. Por ejemplo, si especifica la cláusula de filtro de subconjunto rep_id = HOST_NAME() para un artículo y establece la propiedad DynamicFilterHostName en "FBJones" antes de llamar al Agente de mezcla, solo se replicarán las filas que tienen "FBJones" en la columna rep_id .

-DynamicFilterLogindynamic_filter_login
Se usa para establecer un valor para SUSER_SNAME (Transact-SQL) al filtrar cuando se crea una instantánea dinámica. Por ejemplo, si especifica la cláusula de filtro de subconjunto user_id = SUSER_SNAME() en un artículo y establece la propiedad DynamicFilterLogin en "rsmith" antes de llamar al método Run del objeto SQLSnapshot , solo se incluirán en la instantánea las filas que tienen "rsmith" en la columna user_id .

-DynamicSnapshotLocationdynamic_snapshot_location
Es la ubicación donde se generará la instantánea dinámica.

-EncryptionLevel [ 0 | 1 | 2 ]
Es el nivel de cifrado de la Seguridad de la capa de transporte (TLS), conocida anteriormente como Capa de sockets seguros (SSL), utilizado por el Agente de instantáneas cuando realiza conexiones.

Valor de EncryptionLevel Descripción
0 Especifica que no se utiliza TLS.
1 Especifica que se utiliza TLS, pero el agente no comprueba que un emisor confiable haya firmado el certificado del servidor TLS/SSL.
2 Especifica que se usa TLS y que se ha comprobado el certificado.

Nota:

Un certificado TLS/SSL válido se define con un nombre de dominio completo de SQL Server. Para que el agente se conecte correctamente al establecer -EncryptionLevel en 2, cree un alias en la instancia local de SQL Server. El parámetro "Alias Name" debe ser el nombre del servidor, mientras que el parámetro "Server" se debe establecer en el nombre completo de la instancia de SQL Server.

Para más información, consulte Ver y modificar la configuración de seguridad de la replicación.

-FieldDelimiterfield_delimiter
Es el carácter o secuencia de caracteres que marca el fin de un campo en el archivo de datos de copia masiva de SQL Server. El valor predeterminado es \n<x$3>\n.

-HistoryVerboseLevel [ 1| 2| 3]
Especifica la cantidad de historial registrado durante una operación de instantánea. Puede minimizar el efecto sobre el rendimiento del registro del historial seleccionando 1.

Valor HistoryVerboseLevel Descripción
0 Los mensajes de progreso se escriben en la consola o bien en un archivo de resultados. Los registros del historial no se registran en la base de datos de distribución.
1 Siempre actualiza un mensaje del historial anterior del mismo estado (inicio, progreso, éxito, etc.). Si no existe ningún registro anterior con el mismo estado, inserta un nuevo registro.
2 (predeterminado) Inserta nuevos registros de historial a menos que el registro sea para mensajes de inactividad o mensajes de trabajos de ejecución prolongada, en cuyo caso actualiza los registros anteriores.
3 Siempre inserta nuevos registros, a menos que sea para mensajes inactivos.

-HRBcpBlocksnumber_of_blocks
Es el número de bloques de datos de bcp que se ponen en la cola entre los subprocesos de escritor y lector. El valor predeterminado es 50. HRBcpBlocks solamente se usa con publicaciones de Oracle.

Nota:

Este parámetro se usa para el ajuste del rendimiento de bcp en un publicador de Oracle.

-HRBcpBlockSizeblock_size
Es el tamaño, en kilobytes (KB), de cada bloque de datos de bcp . El valor predeterminado es 64 KB. HRBcpBlocks solamente se usa con publicaciones de Oracle.

Nota:

Este parámetro se usa para el ajuste del rendimiento de bcp en un publicador de Oracle.

-HRBcpDynamicBlocks
Indica si el tamaño de cada bloque de datos de bcp puede crecer dinámicamente o no. HRBcpBlocks solamente se usa con publicaciones de Oracle.

Nota:

Este parámetro se usa para el ajuste del rendimiento de bcp en un publicador de Oracle.

-KeepAliveMessageIntervalkeep_alive_interval
Es la cantidad de tiempo, en segundos, que el Agente de instantáneas espera antes de registrar una espera por el mensaje de back-end en la tabla MSsnapshot_history . El valor predeterminado es 300 segundos.

-LoginTimeOutlogin_time_out_seconds
Es el número de segundos antes de que el inicio de sesión exceda el tiempo de espera. El valor predeterminado es 15 segundos.

-MaxBcpThreadsnumber_of_threads
Especifica el número de operaciones de copia masiva que se pueden realizar en paralelo. El número máximo de subprocesos y conexiones ODBC que existen simultáneamente es el menor entre MaxBcpThreads y el número de solicitudes de copia masiva que aparecen en la transacción de sincronización en la base de datos de distribución. MaxBcpThreads debe tener un valor mayor que 0 y no tiene ningún límite superior codificado de forma rígida. El valor predeterminado es dos veces el número de procesadores.

Nota:

Si el objeto replicado tiene un filtro, el Agente de instantáneas generará un solo archivo BCP para ese artículo en lugar de generar varios.

- MaxNetworkOptimization [ 0| 1]
Si es irrelevante, las eliminaciones se envían al suscriptor. Las eliminaciones irrelevantes son comandos DELETE que se envían a los suscriptores para filas que no pertenecen a la partición del suscriptor. Las eliminaciones irrelevantes no afectan a integridad o convergencia de los datos, pero pueden producir un tráfico de red innecesario. El valor predeterminado de MaxNetworkOptimization es 0. Al establecer MaxNetworkOptimization en 1 , se reducen las oportunidades eliminaciones irrelevantes, lo que a su vez reduce el tráfico de red y mejora la optimización de la red. Si se establece este parámetro en 1 , también puede aumentar el almacenamiento de metadatos y afectar negativamente al rendimiento en el publicador si existen varios niveles de filtros de combinación y filtros de subconjunto complejos. Debe evaluar cuidadosamente su topología de replicación y establecer MaxNetworkOptimization en 1 solo si el tráfico de red debido a eliminaciones irrelevantes es inaceptablemente alto.

Nota:

El establecimiento de este parámetro en 1 solo es útil cuando la opción de optimización de sincronización de la publicación de combinación está establecida en true (el parámetro @keep_partition_changes** de sp_addmergepublication (Transact-SQL)).

-Outputoutput_path_and_file_name
Es la ruta de acceso del archivo de salida del agente. Si no se proporciona un nombre de archivo, el resultado se envía a la consola. Si el nombre de archivo especificado existe, el resultado se anexa al archivo.

-OutputVerboseLevel [ 0| 1| 2]
Especifica si el resultado debería ser detallado.

Valor OutputVerboseLevel Descripción
0 Solo se imprimen los mensajes de error.
1 (predeterminado) Se imprimen todos los mensajes de informe de progreso (predeterminado).
2 Se imprimen todos los mensajes de error y mensajes del informe de progreso, la información útil para depurar.

-PacketSizepacket_size
Es el tamaño del paquete (en bytes) que usa el Agente de instantáneas al conectar a SQL Server. El valor predeterminado es 8192 bytes.

Nota:

No cambie el tamaño de los paquetes a menos que esté seguro de que mejorará el rendimiento. En la mayoría de las aplicaciones, el tamaño más conveniente de los paquetes es el tamaño predeterminado.

-PrefetchTables [ 0| 1]
Parámetro opcional que especifica si se va a realizar una captura previa de los objetos de la tabla y se almacenarán en caché. El comportamiento predeterminado es la captura previa de determinadas propiedades de tabla mediante el componente SMO basado en un cálculo interno. Este parámetro puede ser útil en escenarios en los que la operación de captura previa de SMO tarda bastante más tiempo en ejecutarse. Si no se utiliza este parámetro, esta decisión se toma en tiempo de ejecución en función del porcentaje de tablas que se agregan como artículos a la publicación.

Valor OutputVerboseLevel Descripción
0 La llamada al método de captura previa del componente SMO está deshabilitada.
1 El Agente de instantáneas llamará al método de captura previa para almacenar en caché algunas propiedades de tabla mediante SMO.

-ProfileNameprofile_name
Especifica un perfil de agente para utilizar para los parámetros del agente. Si ProfileName es NULL, el perfil de agente se deshabilita. Si no se especifica ProfileName , se utiliza el perfil predeterminado para el tipo de agente. Para obtener información, vea Perfiles del Agente de replicación.

-PublisherDBpublisher_database
Es el nombre de la base de datos de publicación. Este parámetro no se admite en publicadores de Oracle.

-PublisherDeadlockPriority [-1|0|1]
Es la prioridad de la conexión del Agente de instantáneas al publicador cuando se produce un interbloqueo. Este parámetro se especifica para resolver interbloqueos que se pueden producir entre las aplicaciones de usuario y el Agente de instantáneas durante la generación de instantáneas.

Valor PublisherDeadlockPriority Descripción
-1 Cuando se produce un interbloqueo en el publicador, tienen prioridad las aplicaciones distintas del Agente de instantáneas.
0 (predeterminado) No se asigna prioridad.
1 El Agente de instantáneas tiene la prioridad cuando se produce un interbloqueo en el publicador.

-PublisherFailoverPartnerserver_name[\instance_name]
Especifica la instancia del asociado de conmutación por error de SQL Server que participa en una sesión de creación de reflejo de la base de datos con la base de datos de publicación. Para obtener más información, vea Replicación y creación de reflejo de la base de datos (SQL Server).

-PublisherLoginpublisher_login
Es el inicio de sesión que se usa al conectar con el publicador mediante autenticación de SQL Server.

-PublisherPasswordcontraseña_de_publicador
Es la contraseña que se usa al conectar con el publicador mediante autenticación de SQL Server. .

-PublisherSecurityMode [ 0| 1]
Especifica el modo de seguridad del publicador. Un valor de 0 hace referencia a la autenticación de SQL Server (valor predeterminado) y un valor de 1 hace referencia al modo de autenticación de Windows.

-QueryTimeOutquery_time_out_seconds
Es el número de segundos antes de que el inicio de sesión exceda el tiempo de espera de la consulta. El valor predeterminado es 1800 segundos.

-ReplicationType [ 1| 2]
Especifica el tipo de replicación. Un valor de 1 indica la replicación transaccional y un valor de 2 indica la replicación de mezcla.

-RowDelimiterrow_delimiter
Es el carácter o secuencia de caracteres que marca el fin de una fila en el archivo de datos de copia masiva de SQL Server. El valor predeterminado es \n<,@g>\n.

-StartQueueTimeoutstart_queue_timeout_seconds
Es el número máximo de segundos que el Agente de instantáneas espera cuando el número de procesos de instantánea dinámicos simultáneos en ejecución ha alcanzado el límite establecido por la propiedad @max_concurrent_dynamic_snapshots de sp_addmergepublication (Transact-SQL). Si se alcanza el número máximo de segundos y el Agente de instantáneas todavía está esperando, se cerrará. Un valor de 0 significa que el agente espera indefinidamente, aunque se puede cancelar.

- UsePerArticleContentsViewvistaDeContenidoDeUsoPorArtículo
Este parámetro ha quedado desusado y solamente se admite por compatibilidad con versiones anteriores.

Comentarios

Importante

Si ha instalado el Agente SQL Server para que se ejecute en una cuenta del sistema local en lugar de hacerlo en una cuenta de usuario de dominio (el valor predeterminado), el servicio solamente puede tener acceso al equipo local. Si el Agente de instantáneas que se ejecuta en el Agente SQL Server se configura para usar el modo de autenticación de Windows cuando inicia sesión en una instancia de SQL Server, el Agente de instantáneas devuelve un error. La configuración predeterminada es la autenticación de SQL Server.

Para iniciar el Agente de instantáneas, ejecute snapshot.exe desde el símbolo del sistema. Para obtener información, vea Aplicaciones ejecutables del Agente de replicación.

Consulte también

Administración del Agente de replicación