Agente de instantáneas de replicación

  • Artículo

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.

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

  • -PublishernombreDeServidor[**\nombreDeInstancia]
    Es el nombre del publicador. Especifique nombreDeServidor para conectarse a la instancia predeterminada de Microsoft SQL Server en ese servidor. Especifique nombreDeServidor    \**nombreDeInstancia para una instancia con nombre de SQL Server en dicho 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 en las suscripciones nuevas o reinicializadas.

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

  • -BcpBatchSizetamañoLoteBcp
    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 que se enviarán 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.

  • -DefinitionFilerutaYNombreDeArchivoDeDefinición
    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 nombreDeServidor    \**nombreDeInstancia para una instancia con nombre de SQL Server en dicho 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.

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

  • -DistributorPasswordcontraseñaDelDistribuidor
    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 a la autenticación de SQL Server (valor predeterminado) y un valor de 1 hace referencia al modo de autenticación de Windows.

  • -DynamicFilterHostNamenombreDeHostDelFiltroDinámico
    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.

  • -DynamicFilterLogininicioDeSesiónDelFiltroDinámico
    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.

  • -DynamicSnapshotLocationubicaciónDeInstantáneaDinámica
    Es la ubicación donde se generará la instantánea dinámica.

  • -EncryptionLevel [ 0 | 1 | 2 ]
    Es el nivel de cifrado de Capa de sockets seguros (SSL) que usa el Agente de instantáneas cuando realiza conexiones.

    Valor de EncryptionLevel

    Descripción

    0

    Especifica que no se utiliza SSL.

    1

    Especifica que se utiliza SSL, pero el agente no comprueba que un emisor confiable haya firmado el certificado del servidor SSL.

    2

    Especifica que se utiliza SSL, y que se ha comprobado el certificado.

    Para obtener más información, vea Información general sobre seguridad (replicación).

  • -FieldDelimiterdelimitadorDeCampo
    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 del registro del historial sobre el rendimiento si selecciona 1.

    Valor HistoryVerboseLevel

    Descripción

    0

    Los mensajes de progreso se escriben en la consola o bien en un archivo de salida. 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 de inactividad.

  • -HRBcpBlocks number_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.

  • -KeepAliveMessageInterval keep_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.

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

  • -MaxBcpThreadsnúmeroDeSubprocesos
    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 1.

  • - 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 solamente es útil cuando la opción de optimización de sincronización de la publicación de combinación está establecida en true (parámetro @keep_partition_changes de sp_addmergepublication (Transact-SQL)).

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

  • -PacketSize packet_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]
> <P>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.</P>

  • -ProfileNamenombreDePerfil
    Especifica un perfil de agente que se usará en los parámetros del agente. Si ProfileName es NULL, el perfil de agente se deshabilita. Si no se especifica ProfileName, se usa el perfil predeterminado para el tipo de agente. Para obtener información, vea Perfiles del Agente de replicación.

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

  • -PublisherFailoverPartner server_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).

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

  • -PublisherPassword contraseñaDelPublicador
    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 (predeterminado) y un valor de 1 hace referencia al modo de autenticación de Windows.

  • -QueryTimeOutsegundosDeTiempoDeEsperaDeConsulta
    Es el número de segundos antes de que la consulta exceda el tiempo de espera. 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.

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

  • -StartQueueTimeoutsegundosDeTiempoDeEsperaEnColaParaComenzar
    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ámica 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.

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

Comentarios

Nota importanteImportante

Si ha instalado el Agente SQL Server para que se ejecute en una cuenta de 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.

Vea también

Conceptos

Administración del Agente de replicación