sp_MSchange_distribution_agent_properties (Transact-SQL)

Se aplica a:SQL Server

Cambia las propiedades de un trabajo de Agente de distribución que se ejecuta en un distribuidor de Microsoft 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 = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] 'publication'   
        , [ @subscriber = ] 'subscriber'   
        , [ @subscriber_db = ] 'subscriber_db'   
        , [ @property = ] 'property'   
        , [ @value = ] 'value' ]  

Argumentos

[ @publisher = ] 'publisher' Es el nombre del publicador. publisher es sysname, sin ningún valor predeterminado.

[ @publisher_db = ] 'publisher_db' Es el nombre de la base de datos de publicación. publisher_db es sysname, sin ningún valor predeterminado.

[ @publication = ] 'publication' Es el nombre de la publicación. publication es sysname, sin ningún valor predeterminado.

[ @subscriber = ] 'subscriber' Es el nombre del suscriptor. subscriber es sysname, sin valor predeterminado.

[ @subscriber_db = ] 'subscriber_db' Es el nombre de la base de datos de suscripciones. subscriber_db es sysname, sin ningún valor predeterminado.

[ @property = ] 'property' Es la propiedad de publicación que se va a cambiar. property es sysname, sin valor predeterminado.

[ @value = ] 'value' Es el nuevo valor de propiedad. value es nvarchar(524), con un valor predeterminado de NULL.

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		Catálogo que debe utilizarse al establecer una conexión con el proveedor OLE DB. Esta propiedad solo es válida para suscriptores que no son de SQL Server .
subscriber_datasource		Nombre del origen de datos tal y como lo entiende el proveedor OLE DB. Esta propiedad solo es válida para suscriptores que no son de SQL Server .
subscriber_location		Ubicación de la base de datos tal y como la interpreta el proveedor OLE DB. Esta propiedad solo es válida para suscriptores que no son de SQL Server .
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		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. Esta propiedad solo es válida para suscriptores que no son de SQL Server .
subscriber_providerstring		Cadena de conexión específica del proveedor OLE DB que identifica el origen de datos. Esta propiedad solo es válida para suscriptores que no son de SQL Server.
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		Indica el número de conexiones permitidas por Agente de distribución para aplicar lotes de cambios de forma paralela a un suscriptor. 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 (error)

Comentarios

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

Cuando el publicador se ejecuta en una instancia de SQL Server 2005 (9.x) o una versión posterior, debe usar sp_changesubscription 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.

Consulte también

sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)