sp_MSchange_distribution_agent_properties (Transact-SQL)

Cambia las propiedades de un trabajo del Agente de distribución que se ejecuta en un distribuidor de Microsoft SQL Server 2005 o una version posterior. Este procedimiento almacenado se utiliza para cambiar las propiedades cuando el publicador se ejecuta en una instancia de SQL Server 2000. Este procedimiento almacenado se ejecuta en el distribuidor de la base de datos de distribución.

Icono de vínculo a temasConvenciones 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 de tipo sysname y no tiene ningún valor predeterminado.

  • [ @publisher_db= ] 'publisher_db'
    Es el nombre de la base de datos de la publicación. publisher_db es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @publication = ] 'publication'
    Es el nombre de la publicación. publication es de tipo sysname y no tiene valor predeterminado.

  • [ @subscriber= ] 'subscriber'
    Es el nombre del suscriptor. subscriber es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @subscriber_db= ] 'subscriber_db'
    Es el nombre de la base de datos de suscripciones. subscriber_db es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @property = ] 'property'
    Es la propiedad de la publicación que se va a cambiar. property es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @value = ] 'value'
    Es el nuevo valor de la propiedad. value es de tipo nvarchar(524) y su valor predeterminado es NULL.

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

    Propiedad

    Valor

    Descripción

    distrib_job_login

    Inicio de sesión para la cuenta de Microsoft Windows con la que se ejecuta el agente.

    distrib_job_password

    Contraseña para la cuenta de Windows con la que se ejecuta el trabajo del agente.

    subscriber_catalog

    Catálogo que debe utilizarse al establecer una conexión con un proveedor OLE DB. Esta propiedad sólo es válida para suscriptores que no sean de SQL Server.

    subscriber_datasource

    Nombre del origen de datos tal como el proveedor OLE DB lo ha entendido. Esta propiedad sólo es válida para suscriptores que no sean de SQL Server.

    subscriber_location

    Ubicación de la base de datos tal como el proveedor OLE DB la ha entendido. Esta propiedad sólo es válida para suscriptores que no sean de SQL Server.

    subscriber_login

    Inicio de sesión que debe utilizarse al establecer la conexión 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) con el que se registra el proveedor OLE DB para el origen de datos que no es de SQL Server. Esta propiedad sólo es válida para suscriptores que no sean de SQL Server.

    subscriber_providerstring

    Cadena de conexión específica del proveedor OLE DB que identifica el origen de datos. Esta propiedad sólo es válida para suscriptores que no sean 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 suscripciones que no sean de SQL Server, publicadores Oracle ni suscripciones del mismo nivel.

    Nota

    Después de cambiar la contraseña o el inicio de sesión del agente, debe detener y volver a iniciar 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 utiliza en la replicación de instantáneas y la replicación transaccional.

Cuando el publicador se ejecuta en una instancia de SQL Server 2005 o una versión posterior, debe utilizar sp_changesubscription para cambiar las propiedades de un trabajo de Agente de mezcla que sincronice una suscripción de inserción que se ejecuta en el distribuidor.

Permisos

Sólo los miembros de la función fija de servidor sysadmin en el distribuidor pueden ejecutar sp_MSchange_distribution_agent_properties.