sp_changesubscription (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

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 demás tipos de suscripciones de extracción, use sp_change_subscription_properties (Transact-SQL). sp_changesubscription se ejecuta en el publicador de la base de datos de publicación.

Importante

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 Habilitar conexiones cifradas en el motor de base de datos (Administrador de configuración de 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. publicationes sysname, sin valores predeterminados

[ @article = ] 'article' Es el nombre del artículo que se va a cambiar. article es sysname, sin valor predeterminado.

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

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

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

[ @value = ] 'value'Es el nuevo valor de la propiedad especificada. value es nvarchar(4000) y puede ser uno de los valores de la tabla.

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 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 solo es válida para suscriptores que no son de Microsoft 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		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	Use la autenticación de SQL Server al conectarse al 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 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 .
subscriptionstreams		Es el número de conexiones permitidas por Agente de distribución para aplicar lotes de cambios en paralelo a un suscriptor. Se admite un intervalo de valores de 1 a 64 para publicadores de SQL Server. Esta propiedad debe ser 0 para suscriptores que no son de SQL Server, publicadores de Oracle o suscripciones punto a punto.
subscriber_type	1	Servidor del origen de datos ODBC
	3	Proveedor OLE DB
memory_optimized	bit	Indica que la suscripción admite tablas optimizadas para memoria. memory_optimized es bit, donde 1 es igual a true (la suscripción admite tablas optimizadas para memoria).

[ @publisher = ] 'publisher' Especifica un publicador que no es de SQL Server. publisher es sysname, con un valor predeterminado de NULL.

Nota:

publisher no debe especificarse para un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_changesubscription se usa en la replicación transaccional y instantánea.

sp_changesubscription solo se pueden usar para modificar las propiedades de las suscripciones de inserción o las suscripciones de extracción implicadas en la replicación transaccional de actualización en cola. Para cambiar las propiedades de todos los demás tipos de suscripciones de extracción, use 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

Solo los miembros del rol fijo de servidor sysadmin o db_owner rol fijo de base de datos pueden ejecutar sp_changesubscription.

Consulte también

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