Ver y modificar las propiedades de un artículo
En este tema se describe cómo ver y modificar las propiedades del artículo en SQL Server 2012 mediante SQL Server Management Studio, Transact-SQL o Replication Management Objects (RMO).
En este tema
Antes de empezar:
Limitaciones y restricciones
Recomendaciones
Para ver y modificar las propiedades del artículo con:
SQL Server Management Studio
Transact-SQL
Replication Management Objects (RMO)
Antes de empezar
Limitaciones y restricciones
- Algunas propiedades no se pueden modificar después de crearlas, y otras no se pueden modificar si existen suscripciones a la publicación. Las propiedades que no se pueden modificar se muestran como de solo lectura.
Recomendaciones
- Una vez creada una publicación, algunos cambios de propiedades necesitan una nueva instantánea. Si una publicación tiene suscripciones, algunos cambios también necesitan que se reinicialicen todas las suscripciones. Para obtener más información, vea Cambiar las propiedades de la publicación y de los artículos y Agregar y quitar artículos de publicaciones existentes.
.gif "Icono de flecha usado con el vínculo Volver al principio")
[Top]
Usar SQL Server Management Studio
Vea y modifique las propiedades del artículo en el cuadro de diálogo Propiedades de la publicación: <publicación>, que está disponible en Microsoft SQL Server Management Studio y el Monitor de replicación. Para obtener información sobre cómo iniciar el Monitor de replicación, vea Iniciar el Monitor de replicación.
La página General incluye el nombre y la descripción de la publicación, el nombre de la base de datos, el tipo de publicación y los valores de expiración de la suscripción.
La página Artículos corresponde a la página Artículos del Asistente para nueva publicación. Utilice esta página para agregar y eliminar artículos, y para cambiar propiedades y el filtro de columna de artículos.
La página Filtrar filas corresponde a la página Filtrar filas de tabla del Asistente para nueva publicación. Utilice esta página para agregar, editar y eliminar filtros de fila estáticos de todos los tipos de publicaciones, y para agregar, editar y eliminar filtros de fila con parámetros y filtros de combinación de publicaciones de combinación.
La página Instantánea permite especificar el formato y la ubicación de la instantánea, si la instantánea debe comprimirse y si los scripts deben ejecutarse antes y después de aplicar la instantánea.
La página Instantánea de FTP (en publicaciones de instantáneas y transaccionales, y publicaciones de combinación en publicadores que ejecutan versiones anteriores a SQL Server 2005) permite especificar si los suscriptores pueden descargar archivos de instantáneas mediante el Protocolo de transferencia de archivos (FTP).
La página Instantánea de FTP e Internet (en publicaciones de combinación de publicadores que ejecutan SQL Server 2005 o posterior) permite especificar si los suscriptores pueden descargar archivos de instantáneas mediante FTP y si los suscriptores pueden sincronizar suscripciones mediante HTTPS.
La página Opciones de suscripción permite establecer diversas opciones que se aplican a todas las suscripciones. Las opciones varían según el tipo de publicación.
La página Lista de acceso a la publicación permite especificar qué inicios de sesión y grupos pueden tener acceso a una publicación.
La página Seguridad del agente le permite tener acceso a la configuración para las cuentas con las que se ejecutan los agentes siguientes y realizan conexiones a los equipos en una topología de replicación: el Agente de instantáneas para todas las publicaciones, el Agente de registro del LOG para todas las publicaciones transaccionales y el Agente de lectura de cola para las publicaciones transaccionales que permiten las suscripciones de actualización en cola.
La página Particiones de datos (en publicaciones de combinación de publicadores que ejecutan SQL Server 2005 o posterior) permite especificar si los suscriptores a publicaciones con filtros con parámetros pueden solicitar una instantánea si no está disponible. También permite generar instantáneas de una o varias particiones, solo una vez o varias veces.
Para ver y modificar propiedades de un artículo
En la página Artículos del cuadro de diálogo Propiedades de la publicación: <publicación>, seleccione un artículo y, a continuación, haga clic en Propiedades del artículo.
Seleccione a qué propiedades de artículos se deben aplicar los cambios:
Haga clic en Establecer propiedades del artículo de <tipoDeObjeto> resaltado para abrir el cuadro de diálogo Propiedades del artículo: <nombreDeObjeto>; los cambios de propiedades realizados en este cuadro de diálogo solo se aplican al objeto que está resaltado en el panel de objetos en la página Artículos.
Haga clic en Establecer propiedades de todos los artículos de <tipoDeObjeto> para abrir el cuadro de diálogo Propiedades de todos los artículos de <tipoDeObjeto>; los cambios de propiedades realizados en este cuadro de diálogo se aplican a todos los objetos del tipo en el panel de objetos en la página Artículos, incluidos los que aún no se han seleccionado para su publicación.
[!NOTA]
Los cambios de propiedades realizados en el cuadro de diálogo Propiedades de todos los artículos de <TipoDeObjeto> reemplazan los realizados anteriormente en el cuadro de diálogo Propiedades del artículo; <nombreDeObjeto>. Por ejemplo, si desea establecer varios valores predeterminados para todos los artículos de un tipo de objeto, pero solo desea establecer algunas propiedades para objetos individuales, establezca primero los valores predeterminados para todos los artículos. A continuación, establezca las propiedades de los objetos individuales.
Modifique las propiedades si es necesario y, a continuación, haga clic en Aceptar.
Haga clic en Aceptar en el cuadro de diálogo Propiedades de la publicación: <publicación>.
[Top]
Usar Transact-SQL
Se pueden modificar los artículos y devolver sus propiedades mediante programación con los procedimientos almacenados de replicación. Los procedimientos almacenados que se usen dependerán del tipo de publicación a la que pertenece el artículo.
Para ver las propiedades de un artículo que pertenece a una publicación transaccional o de instantáneas
Ejecute sp_helparticle, especificando el nombre de la publicación para el parámetro @publication y el nombre de artículo para el parámetro @article. Si no especifica @article, se devolverá información para todos los artículos de la publicación.
Ejecute sp_helparticlecolumns para que los artículos de tabla muestren todas las columnas disponibles en la tabla base.
Para modificar las propiedades de un artículo que pertenece a una publicación transaccional o de instantáneas
Ejecute sp_changearticle, especificando la propiedad de artículo que se está cambiando en el parámetro @property y el nuevo valor de esta propiedad en el parámetro @value.
[!NOTA]
Si el cambio requiere la generación de una nueva instantánea, también debe especificar el valor 1 para @force_invalidate_snapshot, y si el cambio requiere que se reinicialicen los suscriptores, debe especificar el valor 1 para @force_reinit_subscription. Para obtener más información acerca de las propiedades que, cuando se cambian, requieren una nueva instantánea o una reinicialización, vea Cambiar las propiedades de la publicación y de los artículos.
Para ver las propiedades de un artículo que pertenece a una publicación de combinación
Ejecute sp_helpmergearticle, especificando el nombre de la publicación para el parámetro @publication y el nombre de artículo para el parámetro @article. Si no especifica estos parámetros, se devolverá información para todos los artículos de una publicación o en el publicador.
Ejecute sp_helpmergearticlecolumn para que los artículos de tabla muestren todas las columnas disponibles en la tabla base.
Para modificar las propiedades de un artículo que pertenece a una publicación de combinación
Ejecute sp_changemergearticle, especificando la propiedad de artículo que se está cambiando en el parámetro @property y el nuevo valor de esta propiedad en el parámetro @value.
[!NOTA]
Si el cambio requiere la generación de una nueva instantánea, también debe especificar el valor 1 para @force_invalidate_snapshot, y si el cambio requiere que se reinicialicen los suscriptores, debe especificar el valor 1 para @force_reinit_subscription. Para obtener más información acerca de las propiedades que, cuando se cambian, necesitan una nueva instantánea o una reinicialización, vea Cambiar las propiedades de la publicación y de los artículos.
Ejemplo (Transact-SQL)
Este ejemplo de replicación transaccional devuelve las propiedades del artículo publicado.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksProductTran';
USE [AdventureWorks2012]
EXEC sp_helparticle
@publication = @publication;
GO
Este ejemplo de replicación transaccional cambia las opciones de esquema del artículo publicado.
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @option AS int;
SET @publication = N'AdvWorksProductTran';
SET @article = N'Product';
SET @option = (SELECT CAST(0x0000000002030073 AS int));
-- Change the schema options to replicate schema with XML.
USE [AdventureWorks2012]
EXEC sp_changearticle
@publication = @publication,
@article = @article,
@property = N'schema_option',
@value = @option,
@force_invalidate_snapshot = 1;
GO
Este ejemplo de replicación de mezcla devuelve las propiedades del artículo publicado.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
USE [AdventureWorks2012]
EXEC sp_helpmergearticle
@publication = @publication;
GO
Este ejemplo de replicación de mezcla cambia los valores de detección de conflictos para un artículo publicado.
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article = N'SalesOrderHeader';
-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2012]
EXEC sp_changemergearticle
@publication = @publication,
@article = @article,
@property = N'column_tracking',
@value = N'true',
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
GO
[Top]
Usar Replication Management Objects (RMO)
Puede modificar los artículos y obtener acceso mediante programación a sus propiedades utilizando Replication Management Objects (RMO). Las clases RMO que usa para ver o modificar las propiedades de artículo dependen del tipo de publicación a la que pertenece el artículo.
Para ver o modificar propiedades de un artículo que pertenece a una publicación transaccional o de instantáneas
Cree una conexión al publicador mediante la clase ServerConnection.
Cree una instancia de la clase TransArticle.
Establezca las propiedades Name, PublicationName y DatabaseName.
Establezca la conexión del paso 1 para la propiedad ConnectionContext.
Llame al método LoadProperties para obtener las propiedades del objeto. Si este método devuelve false, se definieron incorrectamente las propiedades de artículo en el paso 3, o bien el artículo no existe.
(Opcional) Para cambiar las propiedades, establezca un nuevo valor para una de las propiedades TransArticle que se pueden establecer.
(Opcional) Si especificara un valor de true para CachePropertyChanges, llame al método CommitPropertyChanges para confirmar los cambios en el servidor. Si especificara un valor de false para CachePropertyChanges (predeterminado), los cambios se envían inmediatamente al servidor.
Para ver o modificar propiedades de un artículo que pertenece a una publicación de combinación
Cree una conexión al publicador mediante la clase ServerConnection.
Cree una instancia de la clase MergeArticle.
Establezca las propiedades Name, PublicationName y DatabaseName.
Establezca la conexión del paso 1 para la propiedad ConnectionContext.
Llame al método LoadProperties para obtener las propiedades del objeto. Si este método devuelve false, se definieron incorrectamente las propiedades de artículo en el paso 3, o bien el artículo no existe.
(Opcional) Para cambiar las propiedades, establezca un nuevo valor para una de las propiedades MergeArticle que se pueden establecer.
(Opcional) Si especificara un valor de true para CachePropertyChanges, llame al método CommitPropertyChanges para confirmar los cambios en el servidor. Si especificó el valor false para CachePropertyChanges (predeterminado), los cambios se envían inmediatamente al servidor.
Ejemplo (RMO)
Este ejemplo cambia un artículo de mezcla para especificar el controlador de lógica de negocios que usa el artículo.
// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string articleName = "SalesOrderHeader";
// Set the friendly name of the business logic handler.
string customLogic = "OrderEntryLogic";
MergeArticle article = new MergeArticle();
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
try
{
// Connect to the Publisher.
conn.Connect();
// Set the required properties for the article.
article.ConnectionContext = conn;
article.Name = articleName;
article.DatabaseName = publicationDbName;
article.PublicationName = publicationName;
// Load the article properties.
if (article.LoadProperties())
{
article.ArticleResolver = customLogic;
}
else
{
// Throw an exception of the article does not exist.
throw new ApplicationException(String.Format(
"{0} is not published in {1}", articleName, publicationName));
}
}
catch (Exception ex)
{
// Do error handling here and rollback the transaction.
throw new ApplicationException(String.Format(
"The business logic handler {0} could not be associated with " +
" the {1} article.",customLogic,articleName), ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "SalesOrderHeader"
' Set the friendly name of the business logic handler.
Dim customLogic As String = "OrderEntryLogic"
Dim article As MergeArticle = New MergeArticle()
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
Try
' Connect to the Publisher.
conn.Connect()
' Set the required properties for the article.
article.ConnectionContext = conn
article.Name = articleName
article.DatabaseName = publicationDbName
article.PublicationName = publicationName
' Load the article properties.
If article.LoadProperties() Then
article.ArticleResolver = customLogic
Else
' Throw an exception of the article does not exist.
Throw New ApplicationException(String.Format( _
"{0} is not published in {1}", articleName, publicationName))
End If
Catch ex As Exception
' Do error handling here and rollback the transaction.
Throw New ApplicationException(String.Format( _
"The business logic handler {0} could not be associated with " + _
" the {1} article.", customLogic, articleName), ex)
Finally
conn.Disconnect()
End Try
[Top]
Vea también
Conceptos
Implementar un controlador de lógica de negocios para un artículo de mezcla
Publicar datos y objetos de base de datos
Cambiar las propiedades de la publicación y de los artículos
Conceptos sobre los procedimientos almacenados del sistema de replicación
Detección y resolución de conflictos de replicación de mezcla avanzada