Compartir vía

sp_MSchange_distribution_agent_properties (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Cambia las propiedades de un trabajo de Agente de distribución que se ejecuta en un distribuidor de SQL Server 2005 (9.x) o posterior. Este procedimiento almacenado se usa para cambiar las propiedades cuando el publicador se ejecuta en una instancia de SQL Server 2000 (8.x). Este procedimiento almacenado se ejecuta en el distribuidor de la base de datos de distribución.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_MSchange_distribution_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @subscriber = ] N'subscriber'
    , [ @subscriber_db = ] N'subscriber_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
[ ; ]

Argumentos

[ @publisher = ] N'publisher'

El nombre del publicador. @publisher es sysname, sin ningún valor predeterminado.

[ @publisher_db = ] N'publisher_db'

Nombre de la base de datos de publicación. @publisher_db es sysname, sin ningún valor predeterminado.

[ @publication = ] N'publication'

Nombre de la publicación. @publication es sysname, sin ningún valor predeterminado.

[ @subscriber = ] N'subscriber'

Nombre del suscriptor. @subscriber es sysname, sin ningún valor predeterminado.

[ @subscriber_db = ] N'subscriber_db'

Nombre de la base de datos de suscripciones. @subscriber_db es sysname, sin valor predeterminado.

[ @property = ] N'property'

Propiedad de publicación que se va a cambiar. @property es sysname, sin ningún valor predeterminado.

[ @value = ] N'value'

El nuevo valor de la propiedad. @value es nvarchar(524), sin ningún valor predeterminado.

Esta tabla describe las propiedades del trabajo del Agente de distribución que se pueden cambiar y las restricciones en los valores de esas propiedades.

Propiedad Valor Descripción
distrib_job_login Inicie sesión para la cuenta de Microsoft Windows con la que se ejecuta el agente.
distrib_job_password Contraseña de la cuenta de Windows en la que se ejecuta el trabajo del agente.
subscriber_catalog 1 Catálogo que debe utilizarse al establecer una conexión con el proveedor OLE DB.
subscriber_datasource 1 Nombre del origen de datos tal y como lo entiende el proveedor OLE DB.
subscriber_location 1 Ubicación de la base de datos tal y como la interpreta el proveedor OLE DB.
subscriber_login Inicio de sesión que se debe utilizar al conectarse a un suscriptor para sincronizar la suscripción.
subscriber_password Contraseña del suscriptor.

No utilice una contraseña en blanco. Utilice una contraseña segura.
subscriber_provider 1 Identificador de programación único (PROGID) mediante el cual se registra el proveedor OLE DB para los orígenes de datos que no son de SQL Server.
subscriber_providerstring 1 Cadena de conexión específica del proveedor OLE DB que identifica el origen de datos.
subscriber_security_mode 1 Autenticación de Windows.

Siempre que sea posible, utilice la autenticación de Windows.
0 Autenticación de SQL Server.
subscriber_type 0 Suscriptor de SQL Server
1 Servidor del origen de datos ODBC
3 Proveedor OLE DB
subscriptionstreams 2 Indica el número de conexiones permitidas por Agente de distribución para aplicar lotes de cambios de forma paralela a un suscriptor.

1 Solo válido para suscriptores que no son de SQL Server.

2 No se admite para suscriptores que no son de SQL Server, publicadores de Oracle o suscripciones punto a punto.

Nota:

Después de cambiar un inicio de sesión o una contraseña de agente, debe detener y reiniciar el agente para que el cambio surta efecto.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_MSchange_distribution_agent_properties se usa en la replicación de instantáneas y la replicación transaccional.

Puede usar sp_changesubscription en un publicador para cambiar las propiedades de un trabajo de Agente de mezcla que sincroniza una suscripción de inserción que se ejecuta en el distribuidor.

Permisos

Solo los miembros del rol fijo de servidor sysadmin en el distribuidor pueden ejecutar sp_MSchange_distribution_agent_properties.

Contenido relacionado