sp_changesubscription (Transact-SQL)

Cambia las propiedades de una suscripción de inserción transaccional o de instantáneas o de una suscripción de extracción relacionada con la replicación transaccional de actualización en cola. Para cambiar las propiedades de todos los tipos de suscripciones de extracción, utilice sp_change_subscription_properties (Transact-SQL). sp_changesubscription se ejecuta en el publicador de la base de datos de publicaciones.

Nota de seguridadNota de seguridad

Al configurar un publicador con un distribuidor remoto, los valores suministrados para todos los parámetros, incluidos job_login y job_password, se envían al distribuidor como texto sin formato. Antes de ejecutar este procedimiento almacenado, se recomienda cifrar la conexión entre el publicador y su distribuidor remoto. Para obtener más información, vea Cifrar conexiones a SQL Server.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_changesubscription [ @publication = ] 'publication'
        , [ @article = ] 'article'
        , [ @subscriber = ] 'subscriber'
        , [ @destination_db = ] 'destination_db'
        , [ @property = ] 'property'
        , [ @value = ] 'value'
    [ , [ @publisher = ] 'publisher' ]

Argumentos

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

  • [ @article = ] 'article'
    Es el nombre del artículo que se va a cambiar. article 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.

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

  • [ @property=] 'property'
    Es la propiedad que se va a cambiar para la suscripción dada. property es de tipo nvarchar(30) y puede tener uno de los valores que muestra la tabla.

  • [ @value=] 'value'
    Es el nuevo valor de la property especificada. value es de tipo nvarchar(4000) y puede tener uno de los valores que aparecen en la tabla.

    Propiedad

    Valor

    Descripción

    distrib_job_login

     

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

    distrib_job_password

     

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

    subscriber_catalog

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

    subscriber_datasource

    Nombre del origen de datos tal y como lo interpreta el proveedor OLE DB. 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 y como la interpreta el proveedor OLE DB. Esta propiedad sólo es válida para suscriptores que no sean de SQL Server.

    subscriber_login

     

    Nombre de inicio de sesión del suscriptor.

    subscriber_password

     

    Contraseña segura para el inicio de sesión que se ha proporcionado.

    subscriber_security_mode

    1

    Se utiliza la autenticación de Windows para la conexión con el suscriptor.

     

    0

    Se utiliza la autenticación de SQL Server para la conexión con el suscriptor.

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

    subscriptionstreams

    Es el número de conexiones permitidas por Agente de distribución para aplicar lotes de cambios en paralelo a un suscriptor. Para los publicadores SQL Server se admite un intervalo de valores que va de 1 a 64. Esta propiedad debe ser 0 para los suscriptores que no sean de SQL Server, publicadores de Oracle o suscripciones punto a punto.

    subscriber_type

    1

    Servidor del origen de datos ODBC

    3

    Proveedor OLE DB

  • [ @publisher=] 'publisher'
    Especifica un publicador que no es de SQL Server. publisher es de tipo sysname y su valor predeterminado es NULL.

    Nota

    No se debe especificar publisher con un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_changesubscription se utiliza en la replicación de instantáneas y transaccional.

sp_changesubscription sólo puede utilizarse para modificar las propiedades de suscripciones de inserción o de extracción relacionadas con la replicación transaccional de actualización en cola. Para cambiar las propiedades de todos los otros tipos de suscripciones de inserción, utilice sp_change_subscription_properties (Transact-SQL).

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.

Permisos

Sólo los miembros de la función fija de servidor sysadmin o de la función fija de base de datos db_owner pueden ejecutar sp_changesubscription.