Agente de distribución de replicaciónReplication Distribution Agent

El Agente de distribución de replicación es un ejecutable que mueve la instantánea (para la replicación de instantáneas y la replicación transaccional) y las transacciones de las tablas de base de datos de la distribución (para la replicación transaccional) a las tablas de destino en los suscriptores.The Replication Distribution Agent is an executable that moves the snapshot (for snapshot replication and transactional replication) and the transactions held in the distribution database tables (for transactional replication) to the destination tables at the Subscribers.

Nota

Los parámetros se pueden especificar en cualquier orden.Parameters can be specified in any order. Cuando no se especifican parámetros opcionales, se utilizan valores de la configuración del Registro predefinida en el equipo local.When optional parameters are not specified, values from predefined registry settings on the local computer are used.

SintaxisSyntax


distrib [-?]  
-Publisher server_name[\instance_name]  
-PublisherDB publisher_database  
-Subscriber server_name[\instance_name]  
-SubscriberDB subscriber_database   
[-AltSnapshotFolder alt_snapshot_folder_path]   
[-BcpBatchSize bcp_batch_size]  
[-CommitBatchSize commit_batch_size]  
[-CommitBatchThreshold commit_batch_threshold]  
[-Continuous]  
[-DefinitionFile def_path_and_file_name]  
[-Distributor distributor]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-ErrorFile error_path_and_file_name]  
[-ExtendedEventConfigFile configuration_path_and_file_name]  
[-FileTransferType [0|1]]  
[-FtpAddress ftp_address]  
[-FtpPassword ftp_password]   
[-FtpPort ftp_port]  
[-FtpUserName ftp_user_name]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-Hostname host_name]  
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]  
[-LoginTimeOut login_time_out_seconds]  
[-MaxBcpThreads]  
[-MaxDeliveredTransactions number_of_transactions]  
[-MessageInterval message_interval]  
[-OledbStreamThreshold oledb_stream_threshold]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PacketSize packet_size]  
[-PollingInterval polling_interval]  
[-ProfileName profile_name]  
[-Publication publication]  
[-QueryTimeOut query_time_out_seconds]  
[-QuotedIdentifier quoted_identifier]  
[-SkipErrors native_error_id [:...n]]  
[-SubscriberDatabasePath subscriber_path]  
[-SubscriberLogin subscriber_login]  
[-SubscriberPassword subscriber_password]  
[-SubscriberSecurityMode [0|1]]  
[-SubscriberType [0|1|3]]  
[-SubscriptionStreams [1|2|...64]]  
[-SubscriptionTableName subscription_table]  
[-SubscriptionType [0|1|2]]  
[-TransactionsPerHistory [0|1|...10000]]  
[-UseDTS]  
[-UseInprocLoader]  
[-UseOledbStreaming]  

ArgumentosArguments

-?-?
Imprime todos los parámetros disponibles.Prints all available parameters.

-Publisher server_name[\instance_name]-Publisher server_name[\instance_name]
Es el nombre del publicador.Is the name of the Publisher. Especifique server_name para conectarse a la instancia predeterminada del MicrosoftMicrosoft SQL ServerSQL Server en ese servidor.Specify server_name for the default instance of MicrosoftMicrosoft SQL ServerSQL Server on that server. Especifique server_name\instance_name para la instancia predeterminada de SQL ServerSQL Server en ese servidor.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-PublisherDB publisher_database-PublisherDB publisher_database
Es el nombre de la base de datos del publicador.Is the name of the Publisher database.

-Subscriber server_name[\instance_name]-Subscriber server_name[\instance_name]
Es el nombre del suscriptor.Is the name of the Subscriber. Especifique server_name para conectarse a la instancia predeterminada del SQL ServerSQL Server en ese servidor.Specify server_name for the default instance of SQL ServerSQL Server on that server. Especifique server_name\instance_name para la instancia predeterminada de SQL ServerSQL Server en ese servidor.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-SubscriberDB subscriber_database-SubscriberDB subscriber_database
Es el nombre de la base de datos del suscriptor.Is the name of the Subscriber database.

-AltSnapshotFolder alt_snapshot_folder_path-AltSnapshotFolder alt_snapshot_folder_path
Es la ruta de acceso a la carpeta que contiene la instantánea inicial para una suscripción.Is the path to the folder that contains the initial snapshot for a subscription.

-BcpBatchSize bcp_batch_size-BcpBatchSize bcp_batch_size
Es el número de filas para enviar en una operación de copia masiva.Is the number of rows to send in a bulk copy operation. 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 .When performing a bcp in operation, the batch size is the number of rows to send to the server as one transaction, and also the number of rows that must be sent before the Distribution Agent logs a bcp progress message. Al realizar una operación bcp out , se usa un tamaño de lote fijo de 1000 .When performing a bcp out operation, a fixed batch size of 1000 is used.

-CommitBatchSize commit_batch_size-CommitBatchSize commit_batch_size
Es el número de transacciones que se va a emitir al Suscriptor antes de que se emita una instrucción COMMIT.Is the number of transactions to be issued to the Subscriber before a COMMIT statement is issued. El valor predeterminado es 100.The default is 100.

-CommitBatchThreshold commit_batch_threshold-CommitBatchThreshold commit_batch_threshold
Es el número de comandos de replicación que se va a emitir al Suscriptor antes de que se emita una instrucción COMMIT.Is the number of replication commands to be issued to the Subscriber before a COMMIT statement is issued. El valor predeterminado es 1000.The default is 1000.

-Continuous-Continuous
Especifica si el agente intenta sondear las transacciones replicadas continuamente.Specifies whether the agent attempts to poll replicated transactions continually. Si se especifica, el agente sondea las transacciones replicadas del origen en intervalos de sondeo, aunque no haya ninguna transacción pendiente.If specified, the agent polls replicated transactions from the source at polling intervals, even if there are no transactions pending.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
Es la ruta de acceso del archivo de definición de agente.Is the path of the agent definition file. Un archivo de definición de agente contiene los argumentos de símbolo del sistema para el agente.An agent definition file contains command prompt arguments for the agent. El contenido del archivo se analiza como un archivo ejecutable.The content of the file is parsed as an executable file. Utilice las comillas tipográficas (") para especificar valores de argumento que contienen caracteres arbitrarios.Use double quotation marks (") to specify argument values containing arbitrary characters.

-Distributor distributor-Distributor distributor
Es el nombre del distribuidor.Is the Distributor name. Para la distribución (inserción) del Distribuidor, el nombre tiene como valor predeterminado el nombre del Distribuidor local.For Distributor (push) distribution, the name defaults to the name of the local Distributor.

-DistributorLogin distributor_login-DistributorLogin distributor_login
Es el nombre de inicio de sesión del distribuidor.Is the Distributor login name.

-DistributorPassword distributor_password-DistributorPassword distributor_password
Es la contraseña del distribuidor.Is the Distributor password.

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
Especifica el modo de seguridad del distribuidor.Specifies the security mode of the Distributor. Un valor de 0 hace referencia al modo de autenticación de SQL ServerSQL Server y un valor de 1 hace referencia al modo de autenticación de Windows (valor predeterminado).A value of 0 indicates SQL ServerSQL Server Authentication Mode, and a value of 1 indicates Windows Authentication Mode (default).

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
Es el nivel de cifrado de Capa de sockets seguros (SSL) utilizado por el agente de distribución cuando realiza conexiones.Is the level of Secure Sockets Layer (SSL) encryption used by the Distribution Agent when making connections.

Valor de EncryptionLevelEncryptionLevel value DescripciónDescription
00 Especifica que no se utiliza SSL.Specifies that SSL is not used.
11 Especifica que se utiliza SSL, pero el agente no comprueba que un emisor confiable haya firmado el certificado del servidor SSL.Specifies that SSL is used, but the agent does not verify that the SSL server certificate is signed by a trusted issuer.
22 Especifica que se usa SSL y que se ha comprobado el certificado.Specifies that SSL is used, and that the certificate is verified.

Para obtener más información, vea Información general sobre seguridad (replicación).For more information, see Security Overview (Replication).

-ErrorFile error_path_and_file_name-ErrorFile error_path_and_file_name
Es la ruta y nombre del archivo de error generado por el Agente de distribución.Is the path and file name of the error file generated by the Distribution Agent. Este archivo se genera en cualquier punto en el que se haya producido el error durante la aplicación de transacciones de replicación en el suscriptor; los errores que se producen en el publicador o el distribuidor no se registran en este archivo.This file is generated at any point where failure occurred while applying replication transactions at the Subscriber; errors that occur at the Publisher or Distributor are not logged in this file. Contiene las transacciones de replicación en las que se ha producido un error y los mensajes de error relacionados.This file contains the failed replication transactions and associated error messages. Si no se especifica, el archivo de error se genera en el directorio actual del Agente de distribución.When not specified, the error file is generated in the current directory of the Distribution Agent. El nombre del archivo de error es el nombre del agente de distribución con la extensión .err.The error file name is the name of the Distribution Agent with an .err extension. Si el nombre de archivo especificado existe, los mensajes de error se anexan al archivo.If the specified file name exists, error messages are appended to the file. Este parámetro puede tener un máximo de 256 caracteres Unicode.This parameter can be a maximum of 256 Unicode characters.

-ExtendedEventConfigFile configuration_path_and_file_name-ExtendedEventConfigFile configuration_path_and_file_name
Especifica el nombre y la ruta del archivo para el archivo de configuración XML de eventos extendidos.Specifies the path and file name for the extended events XML configuration file. El archivo de configuración de eventos extendidos le permite configurar sesiones y habilitar eventos para su seguimiento.The extended events configuration file allows you to configure sessions and enable events for tracking.

-FileTransferType [ 0| 1]-FileTransferType [ 0| 1]
Especifica el tipo de transferencia de archivo.Specifies the file transfer type. Un valor de 0 indica UNC (convención de nomenclatura universal) y un valor de 1 indica FTP (protocolo de transferencia de archivos).A value of 0 indicates UNC (universal naming convention), and a value of 1 indicates FTP (file transfer protocol).

-FtpAddress ftp_address-FtpAddress ftp_address
Es la dirección de red del servicio FTP para el distribuidor.Is the network address of the FTP service for the Distributor. Cuando no se especifica, se utiliza DistributorAddress .When not specified, DistributorAddress is used. Si no se especifica DistributorAddress , se utiliza Distribuidor .If DistributorAddress is not specified, Distributor is used.

-FtpPassword ftp_password-FtpPassword ftp_password
Es la contraseña del usuario que se utiliza para conectarse al servicio FTP.Is the user password used to connect to the FTP service.

-FtpPort ftp_port-FtpPort ftp_port
Es el número de puerto del servicio FTP para el distribuidor.Is the port number of the FTP service for the Distributor. Cuando no se especifica, se utiliza el número de puerto predeterminado para el servicio FTP (21).When not specified, the default port number for FTP service (21) is used.

-FtpUserName ftp_user_name-FtpUserName ftp_user_name
Es el nombre de usuario que se utiliza para conectar con el servicio FTP.Is the user name used to connect to the FTP service. Cuando no se especifica, se utiliza anónimo .When not specified, anonymous is used.

-HistoryVerboseLevel [ 0 | 1 | 2 | 3 ]-HistoryVerboseLevel [ 0 | 1 | 2 | 3 ]
Especifica la cantidad de historial registrado durante una operación de la distribución.Specifies the amount of history logged during a distribution operation. Puede minimizar el efecto sobre el rendimiento del registro del historial seleccionando 1.You can minimize the performance effect of history logging by selecting 1.

Valor HistoryVerboseLevelHistoryVerboseLevel value DescripciónDescription
00 Los mensajes de progreso se escriben en la consola o bien en un archivo de resultados.Progress messages are written either to the console or to an output file. Los registros del historial no se registran en la base de datos de distribución.History records are not logged in the distribution database.
11 Predeterminado:Default. Siempre actualiza un mensaje del historial anterior del mismo estado (inicio, progreso, éxito, etc.).Always update a previous history message of the same status (startup, progress, success, and so on). Si no existe ningún registro anterior con el mismo estado, inserta un nuevo registro.If no previous record with the same status exists, insert a new record.
22 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.Insert new history records unless the record is for such things as idle messages or long-running job messages, in which case update the previous records.
33 Siempre inserta nuevos registros, a menos que sea para mensajes inactivos.Always insert new records, unless it is for idle messages.

-Hostname host_name-Hostname host_name
Es el nombre del host utilizado al conectarse al publicador.Is the host name used when connecting to the Publisher. Este parámetro puede tener un máximo de 128 caracteres Unicode.This parameter can be a maximum of 128 Unicode characters.

-KeepAliveMessageInterval keep_alive_message_interval_seconds-KeepAliveMessageInterval keep_alive_message_interval_seconds
Es el número de segundos antes de que el subproceso del historial compruebe si cualquiera de las conexiones existentes está esperando una respuesta del servidor.Is the number of seconds before the history thread checks if any of the existing connections is waiting for a response from the server. Este valor se puede reducir para evitar que la comprobación del agente marque al agente de distribución como sospechoso al ejecutar un lote de ejecución prolongada.This value can be decreased to avoid having the checkup agent mark the Distribution Agent as suspect when executing a long-running batch. El valor predeterminado es 300 segundos.The default is 300 seconds.

-LoginTimeOut login_time_out_seconds-LoginTimeOut login_time_out_seconds
Es el número de segundos antes de que el inicio de sesión exceda el tiempo de espera.Is the number of seconds before the login times out. El valor predeterminado es de 15 segundos.The default is 15 seconds.

-MaxBcpThreads number_of_threads-MaxBcpThreads number_of_threads
Especifica el número de operaciones de copia masiva que se pueden realizar en paralelo.Specifies the number of bulk copy operations that can be performed in parallel. 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.The maximum number of threads and ODBC connections that exist simultaneously is the lesser of MaxBcpThreads or the number of bulk copy requests that appear in the synchronization transaction in the distribution database. MaxBcpThreads debe tener un valor mayor que 0 y no tiene ningún límite superior codificado de forma rígida.MaxBcpThreads must have a value greater than 0 and has no hard-coded upper limit. El valor predeterminado es 2 veces el número de procesadores, hasta un valor máximo de 8.The default is 2 times the number of processors, up to a maximum value of 8. Al aplicar una instantánea que se generó en el publicador utilizando la opción de instantánea simultánea, se utiliza un subproceso, sin tener en cuenta el número especificado para MaxBcpThreads.When applying a snapshot that was generated at the Publisher using the concurrent snapshot option, one thread is used, regardless of the number you specify for MaxBcpThreads.

-MaxDeliveredTransactions number_of_transactions-MaxDeliveredTransactions number_of_transactions
Es el número máximo de transacciones de inserción o extracción aplicado a suscriptores en una sincronización.Is the maximum number of push or pull transactions applied to Subscribers in one synchronization. Un valor de 0 indica que el máximo es un número infinito de transacciones.A value of 0 indicates that the maximum is an infinite number of transactions. Los suscriptores pueden utilizar otros valores para acortar la duración de una sincronización que se extrae de un publicador.Other values can be used by Subscribers to shorten the duration of a synchronization being pulled from a Publisher.

Nota

Si se especifican tanto -MaxDeliveredTransactions como -Continuous, el Agente de distribución entrega el número especificado de transacciones y, a continuación, se detiene (aunque se especifique -Continuous).If -MaxDeliveredTransactions and -Continuous are both specified, the Distribution Agent delivers the specified number of transactions and then stops (even though -Continuous is specified). Debe reiniciar el Agente de distribución cuando el trabajo se complete.You must restart the Distribution Agent after the job completes.

-MessageInterval message_interval-MessageInterval message_interval
Es el intervalo de tiempo utilizado para el registro del historial.Is the time interval used for history logging. Un evento de historial se registra cuando se alcanza uno de estos parámetros:A history event is logged when one of these parameters is reached:

  • Se alcanza el valor TransactionsPerHistory una vez registrado el último evento de historial.The TransactionsPerHistory value is reached after the last history event is logged.

  • Se alcanza el valor MessageInterval una vez registrado el último evento de historial.The MessageInterval value is reached after the last history event is logged.

    Si no hay ninguna transacción replicada disponible en el origen, el agente envía un mensaje de no transacción al distribuidor.If there is no replicated transaction available at the source, the agent reports a no-transaction message to the Distributor. Esta opción especifica cuánto tiempo espera el agente para enviar otro mensaje que indica que no hay ninguna transacción.This option specifies how long the agent waits before reporting another no-transaction message. Los agentes siempre envían un mensaje que indica que no hay ninguna transacción cuando detectan que no hay ninguna transacción disponible en el origen después de procesar previamente las transacciones replicadas.Agents always report a no-transaction message when they detect that there are no transactions available at the source after previously processing replicated transactions. El valor predeterminado es 60 segundos.The default is 60 seconds.

    -OledbStreamThreshold oledb_stream_threshold-OledbStreamThreshold oledb_stream_threshold
    Especifica el tamaño mínimo, en bytes, para los datos del objeto binario grande por encima del cual los datos se vincularán como un flujo.Specifies the minimum size, in bytes, for binary large object data above which the data will be bound as a stream. Debe especificar –UseOledbStreaming para utilizar este parámetro.You must specify –UseOledbStreaming to use this parameter. Los valores pueden ir de 400 a 1048576 bytes, con un valor predeterminado de 16384 bytes.Values can range from 400 to 1048576 bytes, with a default of 16384 bytes.

    -Output output_path_and_file_name-Output output_path_and_file_name
    Es la ruta de acceso del archivo de salida del agente.Is the path of the agent output file. Si no se proporciona un nombre de archivo, el resultado se envía a la consola.If the file name is not provided, the output is sent to the console. Si el nombre de archivo especificado existe, el resultado se anexa al archivo.If the specified file name exists, the output is appended to the file.

    -OutputVerboseLevel [ 0| 1| 2]-OutputVerboseLevel [ 0| 1| 2]
    Especifica si el resultado debería ser detallado.Specifies whether the output should be verbose. Si el nivel detallado es 0, solo se imprimen los mensajes de error.If the verbose level is 0, only error messages are printed. Si el nivel detallado es 1, se imprimen todos los mensajes del informe de progreso.If the verbose level is 1, all the progress report messages are printed. Si el nivel detallado es 2 (valor predeterminado), se imprimen todos los mensajes de error y mensajes del informe de progreso, lo que es útil para la depuración.If the verbose level is 2 (default), all error messages and progress report messages are printed, which is useful for debugging.

    -PacketSize packet_size-PacketSize packet_size
    Es el tamaño del paquete, en bytes.Is the packet size, in bytes. El valor predeterminado es 4096 (bytes).The default is 4096 (bytes).

    -PollingInterval polling_interval-PollingInterval polling_interval
    Es la frecuencia, en segundos, con la que la base de datos de distribución recibe consultas de transacciones replicadas.Is how often, in seconds, the distribution database is queried for replicated transactions. El valor predeterminado es 5 segundos.The default is 5 seconds.

    -ProfileName profile_name-ProfileName profile_name
    Especifica un perfil de agente para utilizar para los parámetros del agente.Specifies an agent profile to use for agent parameters. Si ProfileName es NULL, el perfil de agente se deshabilita.If ProfileName is NULL, the agent profile is disabled. Si no se especifica ProfileName , se utiliza el perfil predeterminado para el tipo de agente.If ProfileName is not specified, the default profile for the agent type is used. Para obtener información, vea Perfiles del Agente de replicación.For information, see Replication Agent Profiles.

    -Publication publication-Publication publication
    Es el nombre de la publicación.Is the name of the publication. 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.This parameter is only valid if the publication is set to always have a snapshot available for new or reinitialized subscriptions.

    -QueryTimeOut query_time_out_seconds-QueryTimeOut query_time_out_seconds
    Es el número de segundos antes de que la consulta exceda el tiempo de espera.Is the number of seconds before the query times out. El valor predeterminado es 1800 segundos.The default is 1800 seconds.

    -QuotedIdentifier quoted_identifier-QuotedIdentifier quoted_identifier
    Especifica el carácter del identificador entrecomillado que se utilizará.Specifies the quoted identifier character to use. El primer carácter del valor indica el valor que utiliza el agente de distribución.The first character of the value indicates the value the Distribution Agent uses. Si QuotedIdentifier se utiliza sin ningún valor, el agente de distribución utiliza un espacio.If QuotedIdentifier is used with no value, the Distribution Agent uses a space. Si no se utiliza QuotedIdentifier , el agente de distribución utiliza cualquier identificador entrecomillado que admita el suscriptor.If QuotedIdentifier is not used, the Distribution Agent uses whatever quoted identifier the Subscriber supports.

    -SkipErrors native_error_id [:...n]-SkipErrors native_error_id [:...n]
    Es una lista separada por dos puntos que especifica los números de error que este agente omitirá.Is a colon-separated list that specifies the error numbers to be skipped by this agent.

    -SubscriberDatabasePath subscriber_database_path-SubscriberDatabasePath subscriber_database_path
    Es la ruta de acceso a la base de datos Jet (archivo .mdb) si SubscriberType es 2 (permite una conexión a una base de datos Jet sin un nombre del origen de datos ODBC (DSN)).Is the path to the Jet database (.mdb file) if SubscriberType is 2 (allows a connection to a Jet database without an ODBC Data Source Name (DSN)).

    -SubscriberLogin subscriber_login-SubscriberLogin subscriber_login
    Es el nombre de inicio de sesión del suscriptor.Is the Subscriber login name. Si SubscriberSecurityMode es 0 (para autenticación de SQL ServerSQL Server ), se debe especificar este parámetro.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

    -SubscriberPassword subscriber_password-SubscriberPassword subscriber_password
    Es la contraseña del suscriptor.Is the Subscriber password. Si SubscriberSecurityMode es 0 (para autenticación de SQL ServerSQL Server ), se debe especificar este parámetro.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

    -SubscriberSecurityMode [ 0| 1]-SubscriberSecurityMode [ 0| 1]
    Especifica el modo de seguridad del suscriptor.Specifies the security mode of the Subscriber. Un valor de 0 hace referencia a la autenticación de SQL ServerSQL Server y un valor de 1 hace referencia al modo de autenticación de Windows (valor predeterminado).A value of 0 indicates SQL ServerSQL Server Authentication, and a value of 1 indicates Windows Authentication Mode (default).

    -SubscriberType [ 0| 1| 3]-SubscriberType [ 0| 1| 3]
    Especifica el tipo de conexión de suscriptor utilizada por el agente de distribución.Specifies the type of Subscriber connection used by the Distribution Agent.

Valor SubscriberTypeSubscriberType value DescripciónDescription
00 SQL ServerSQL Server
11 Origen de datos ODBCODBC data source
33 Origen de datos OLE DBOLE DB data source

-SubscriptionStreams [0|1|2|...64]-SubscriptionStreams [0|1|2|...64]
Es el número de conexiones permitidas por el agente de distribución para aplicar lotes de cambios en paralelo a un suscriptor, aunque manteniendo muchas de las características transaccionales presentes al utilizar un único subproceso.Is the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber, while maintaining many of the transactional characteristics present when using a single thread. Para un publicador de SQL ServerSQL Server , se admite un intervalo de valores de 1 a 64.For a SQL ServerSQL Server Publisher, a range of values from 1 to 64 is supported. Este parámetro solo se admite cuando el publicador y el distribuidor se están ejecutando en Resultado deSQL Server 2005 o en versiones posteriores.This parameter is only supported when the Publisher and Distributor are running on Resultado deSQL Server 2005 or later versions. Este parámetro no se admite o debe ser 0 para suscriptores que no son de SQL ServerSQL Server o suscripciones punto a punto.This parameter is not supported or must be 0 for non- SQL ServerSQL Server Subscribers or peer-to-peer subscriptions.

Nota

Si una de las conexiones no se puede ejecutar o confirmar, todas las conexiones anularán el lote actual y el agente utilizará un solo flujo para volver a intentar los lotes con errores.If one of the connections fails to execute or commit, all connections will abort the current batch, and the agent will use a single stream to retry the failed batches. Antes de que finalice esta fase de reintento, pueden aparecer incoherencias transaccionales temporales en el suscriptor.Before this retry phase completes, there can be temporary transactional inconsistencies at the Subscriber. Una vez que se han confirmado correctamente los lotes con errores, el suscriptor vuelve al estado de coherencia transaccional.After the failed batches are successfully committed, the Subscriber is brought back to a state of transactional consistency.

Importante

Al especificar un valor de 2 o mayor para -SubscriptionStreams, el orden en el que las transacciones se reciben en el suscriptor puede diferir del orden en el que se realizaron en el publicador.When you specify a value of 2 or greater for -SubscriptionStreams, the order in which transactions are received at the Subscriber may differ from the order in which they were made at the Publisher. Si este comportamiento produce las infracciones de restricción durante la sincronización, debería utilizar la opción NOT FOR REPLICATION para deshabilitar el cumplimiento de restricciones durante la sincronización.If this behavior causes constraint violations during synchronization, you should use the NOT FOR REPLICATION option to disable the enforcement of constraints during synchronization. Para obtener más información, vea Controlar el comportamiento de desencadenadores y restricciones durante la sincronización (programación de la replicación con Transact-SQL).For more information, see Control the Behavior of Triggers and Constraints During Synchronization (Replication Transact-SQL Programming).

Nota

Los flujos de suscripción no funcionan en los artículos configurados para entregar Transact-SQLTransact-SQL.Subscriptionstreams do not work for articles configured to deliver Transact-SQLTransact-SQL. Para usar flujos de suscripción, configure en su lugar los artículos para que entreguen llamadas de procedimiento almacenado.To use subscriptionstreams, configure articles to deliver stored procedure calls instead.

-SubscriptionTableName subscription_table-SubscriptionTableName subscription_table
Es el nombre de la tabla de suscripción generada o usada en el Suscriptor determinado.Is the name of the subscription table generated or used at the given Subscriber. Si no se especifica, se usa la tabla MSreplication_subscriptions (Transact-SQL).When not specified, the MSreplication_subscriptions (Transact-SQL) table is used. Utilice esta opción para los sistemas de administración de bases de datos (DBMS) que no admiten los nombres largos del archivo.Use this option for database management systems (DBMS) that do not support long file names.

-SubscriptionType [ 0| 1| 2]-SubscriptionType [ 0| 1| 2]
Especifica el tipo de suscripción para la distribución.Specifies the subscription type for distribution. Un valor de 0 indica una suscripción de inserción, un valor de 1 indica una suscripción de extracción y un valor de 2 indica una suscripción anónima.A value of 0 indicates a push subscription, a value of 1 indicates a pull subscription, and a value of 2 indicates an anonymous subscription.

-TransactionsPerHistory [ 0| 1|... 10000]-TransactionsPerHistory [ 0| 1|... 10000]
Especifica el intervalo de la transacción para el registro del historial.Specifies the transaction interval for history logging. Si el número de transacciones confirmadas después de la última instancia de registro del historial es mayor que esta opción, se registra un mensaje de historial.If the number of committed transactions after the last instance of history logging is greater than this option, a history message is logged. El valor predeterminado es 100.The default is 100. Un valor de 0 indica infinito TransactionsPerHistory.A value of 0 indicates infinite TransactionsPerHistory. See the preceding –MessageIntervalparameter.See the preceding –MessageIntervalparameter.

-UseDTS-UseDTS
Se debe especificar como un parámetro para una publicación que permite la transformación de datos.Must be specified as a parameter for a publication that allows data transformation.

-UseInprocLoader-UseInprocLoader
Mejora el rendimiento de la instantánea inicial haciendo que el agente de distribución utilice el comando BULK INSERT al aplicar los archivos de instantánea al Suscriptor.Improves the performance of the initial snapshot by causing the Distribution Agent to use the BULK INSERT command when applying snapshot files to the Subscriber. Este parámetro está obsoleto porque no es compatible con el tipo de datos XML.This parameter is deprecated because it is not compatible with the XML data type. Si no replica datos XML, puede utilizar este parámetro.If you are not replicating XML data, this parameter can be used. Este parámetro no se puede utilizar con instantáneas del modo de carácter o suscriptores que no son de SQL ServerSQL Server .This parameter cannot be used with character mode snapshots or non- SQL ServerSQL Server Subscribers. Si utiliza este parámetro, la cuenta de servicio de SQL ServerSQL Server del suscriptor debe tener permisos de lectura en el directorio donde se encuentran los archivos de datos .bcp de instantánea.If you use this parameter, the SQL ServerSQL Server service account at the Subscriber must have read permissions on the directory where the snapshot .bcp data files are located. Cuando no se utiliza este parámetro, el agente (para suscriptores que no son de SQL ServerSQL Server ) o el controlador ODBC cargado por el agente (para suscriptores de SQL ServerSQL Server ) lee los archivos, por lo que no se utiliza el contexto de seguridad de la cuenta de servicio de SQL ServerSQL Server .When this parameter is not used, the agent (for non- SQL ServerSQL Server Subscribers) or the ODBC driver loaded by the agent (for SQL ServerSQL Server Subscribers) reads from the files, so the security context of the SQL ServerSQL Server service account is not used.

-UseOledbStreaming-UseOledbStreaming
Cuando se especifica, habilita el enlace de datos del objeto binario como un flujo.When specified, enables the binding of binary large object data as a stream. Utilice -OledbStreamThreshold para especificar el tamaño, en bytes, por encima del cual se utilizará un flujo.Use -OledbStreamThreshold to specify the size, in bytes, above which a stream will be used. UseOledbStreaming se habilita de forma predeterminada.UseOledbStreaming is enabled by default. UseOledbStreaming escribe en la carpeta C:\Archivos de programa\Microsoft SQL Server\\COM.UseOledbStreaming writes to the C:\Program Files\Microsoft SQL Server\\COM folder.

ComentariosRemarks

Importante

Si ha instalado el agente de SQL ServerSQL Server para que se ejecute en una cuenta de sistema local en lugar de debajo de una cuenta de usuario de dominio (el valor predeterminado), el servicio puede tener acceso solo al equipo local.If you have installed SQL ServerSQL Server Agent to run under a local system account rather than under a domain user account (the default), the service can only access the local computer. Si el agente de distribución que se ejecuta en el agente de SQL ServerSQL Server se configura para utilizar el modo de autenticación de Windows cuando inicia sesión en una instancia de SQL ServerSQL Server, el agente de distribución devuelve un error.If the Distribution Agent that runs under SQL ServerSQL Server Agent is configured to use Windows Authentication Mode when it logs in to an instance of SQL ServerSQL Server, the Distribution Agent fails. La configuración predeterminada es la autenticación de SQL ServerSQL Server .The default setting is SQL ServerSQL Server Authentication. Para obtener información acerca del cambio de cuentas de seguridad, vea View and Modify Replication Security Settings.For information on changing security accounts, see View and Modify Replication Security Settings.

Para iniciar el agente de distribución, ejecute distrib.exe desde el símbolo del sistema.To start the Distribution Agent, execute distrib.exe from the command prompt. Para obtener información, vea Conceptos de los ejecutables del Agente de replicación.For information, see Replication Agent Executables Concepts.

Historial de cambiosChange History

Contenido actualizadoUpdated content
Se ha agregado el parámetro -ExtendedEventConfigFile .Added the -ExtendedEventConfigFile parameter.

Vea tambiénSee Also

Administración del Agente de replicaciónReplication Agent Administration