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 réplica 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 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.

Convenciones 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 la suscripción. 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.

Notas

sp_changesubscription se utiliza en la réplica 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 réplica 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.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_addsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005