TransArticle Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Artikel in einer Transaktionsveröffentlichung dar.
public ref class TransArticle sealed : Microsoft::SqlServer::Replication::Article
public sealed class TransArticle : Microsoft.SqlServer.Replication.Article
type TransArticle = class
inherit Article
Public NotInheritable Class TransArticle
Inherits Article
- Vererbung
Beispiele
// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string articleName = "Product";
string schemaOwner = "Production";
TransArticle article;
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
// Create a filtered transactional articles in the following steps:
// 1) Create the article with a horizontal filter clause.
// 2) Add columns to or remove columns from the article.
try
{
// Connect to the Publisher.
conn.Connect();
// Define a horizontally filtered, log-based table article.
article = new TransArticle();
article.ConnectionContext = conn;
article.Name = articleName;
article.DatabaseName = publicationDbName;
article.SourceObjectName = articleName;
article.SourceObjectOwner = schemaOwner;
article.PublicationName = publicationName;
article.Type = ArticleOptions.LogBased;
article.FilterClause = "DiscontinuedDate IS NULL";
// Ensure that we create the schema owner at the Subscriber.
article.SchemaOption |= CreationScriptOptions.Schema;
if (!article.IsExistingObject)
{
// Create the article.
article.Create();
}
else
{
throw new ApplicationException(String.Format(
"The article {0} already exists in publication {1}.",
articleName, publicationName));
}
// Create an array of column names to remove from the article.
String[] columns = new String[1];
columns[0] = "DaysToManufacture";
// Remove the column from the article.
article.RemoveReplicatedColumns(columns);
}
catch (Exception ex)
{
// Implement appropriate error handling here.
throw new ApplicationException("The article could not be created.", ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "Product"
Dim schemaOwner As String = "Production"
Dim article As TransArticle
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
' Create a filtered transactional articles in the following steps:
' 1) Create the article with a horizontal filter clause.
' 2) Add columns to or remove columns from the article.
Try
' Connect to the Publisher.
conn.Connect()
' Define a horizontally filtered, log-based table article.
article = New TransArticle()
article.ConnectionContext = conn
article.Name = articleName
article.DatabaseName = publicationDbName
article.SourceObjectName = articleName
article.SourceObjectOwner = schemaOwner
article.PublicationName = publicationName
article.Type = ArticleOptions.LogBased
article.FilterClause = "DiscontinuedDate IS NULL"
' Ensure that we create the schema owner at the Subscriber.
article.SchemaOption = article.SchemaOption Or _
CreationScriptOptions.Schema
If Not article.IsExistingObject Then
' Create the article.
article.Create()
Else
Throw New ApplicationException(String.Format( _
"The article {0} already exists in publication {1}.", _
articleName, publicationName))
End If
' Create an array of column names to remove from the article.
Dim columns() As String = New String(0) {}
columns(0) = "DaysToManufacture"
' Remove the column from the article.
article.RemoveReplicatedColumns(columns)
Catch ex As Exception
' Implement appropriate error handling here.
Throw New ApplicationException("The article could not be created.", ex)
Finally
conn.Disconnect()
End Try
Hinweise
Threadsicherheit
Alle öffentlichen statischen (Shared
in Microsoft Visual Basic) Member dieses Typs sind für Multithreadvorgänge sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Konstruktoren
TransArticle() |
Erstellt eine neue Instanz der TransArticle-Klasse. |
TransArticle(String, String, String, ServerConnection) |
Erstellt eine neue Instanz der TransArticle -Klasse mit den erforderlichen Eigenschaften und mit der angegebenen Verbindung mit der Instanz von Microsoft SQL Server. |
Eigenschaften
ArticleId |
Ruft den ID-Wert des Artikels ab. (Geerbt von Article) |
ArticleLogTablespace |
Ruft den Namen des Oracle-Tabellenbereichs ab, der verwendet wurde, um Replikationsprotokollinformationen zu speichern, oder legt ihn fest. |
CachePropertyChanges |
Ruft ab oder legt fest, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden sollen. (Geerbt von ReplicationObject) |
CommandFormat |
Ruft ab oder legt fest, wie Änderungen für den Artikel weitergegeben werden. |
ConnectionContext |
Ruft die Verbindung mit einer Instanz von Microsoft SQL Server ab oder legt sie fest. (Geerbt von ReplicationObject) |
CreateArticleAsHeterogeneous |
Ruft einen Wert ab, der angibt, ob ein Artikel als heterogen erstellt werden soll, oder legt ihn fest. (Geerbt von Article) |
CreationScript |
Ruft den Namen und den vollständigen Pfad der Transact-SQL-Skriptdatei ab, die zum Erstellen des Zielobjekts beim Abonnenten verwendet wird, oder legt diesen fest. (Geerbt von Article) |
DatabaseName |
Ruft den Namen der Datenbank ab, die die Daten und Objekte enthält, die im Artikel veröffentlicht werden, oder legt ihn fest. (Geerbt von Article) |
DatatypeMappingOptions |
Gibt an, ob die Standardtypzuordnung von Artikeldaten für einen Nicht-SQL Server-Verleger verwendet wird. |
DeleteCommand |
Ruft den Befehl ab, mit dem Löschungen repliziert werden, oder legt ihn fest. |
Description |
Ruft eine Textbeschreibung des Artikels ab oder legt sie fest. (Geerbt von Article) |
DestinationObjectName |
Ruft das Datenbankobjekt ab, das das Quelldatenbankobjekt für den Artikel auf dem Abonnenten ist, oder legt es fest. (Geerbt von Article) |
DestinationObjectOwner |
Ruft den Schemabesitzer des Quelldatenbankobjekts für den Artikel auf dem Abonnenten ab oder legt ihn fest. (Geerbt von Article) |
FilterClause |
Ruft die WHERE-Klausel ab, die zum horizontalen Filtern des Artikels verwendet wird, oder legt sie fest. |
FilterProcName |
Ruft die gespeicherte Prozedur (erstellt mit FOR REPLICATION) ab, mit der die Tabelle horizontal gefiltert wird, oder legt sie fest. |
FilterProcOwner |
Ruft den Datenbankbenutzer fest, der Besitzer der gespeicherten Prozedur ist, mit der ein tabellenbasierter Artikel partitioniert wird, oder legt ihn fest. |
IdentityRangeManagementOption |
Ruft die Optionen zur Identitätsbereichsverwaltung für den Artikel ab oder legt sie fest. (Geerbt von Article) |
IdentityRangeThreshold |
Ruft den Wert ab, bei dem einem Verleger oder einem Abonnenten ein neuer Bereich von Identitätsspaltenwerten zugewiesen wird, oder legt ihn fest. (Geerbt von Article) |
InsertCommand |
Ruft den Befehl ab, mit dem Einfügungen repliziert werden, oder legt ihn fest. |
IsExistingObject |
Ruft ab, ob das Objekt auf dem Server vorhanden ist. (Geerbt von ReplicationObject) |
Name |
Ruft den Namen des Artikels ab oder legt ihn fest. (Geerbt von Article) |
PreCreationMethod |
Ruft die Aktion ab, die ausgeführt werden soll, wenn das veröffentlichte Objekt bereits in der Abonnementdatenbank vorhanden ist, oder legt sie fest. (Geerbt von Article) |
PublicationName |
Ruft den Namen der Veröffentlichung ab, zu der der Artikel gehört, oder legt ihn fest. (Geerbt von Article) |
PublisherIdentityRangeSize |
Ruft den Bereich der Identitätswerte ab, die Tabellenspalten auf dem Verleger zugewiesen sind, oder legt diesen fest. (Geerbt von Article) |
PublisherName |
Ruft den Namen des Nicht-SQL Server-Verlegers ab, der den Artikel veröffentlicht, oder legt ihn fest. |
SchemaOption |
Ruft die Schemaerstellungsoptionen für einen Artikel ab oder legt sie fest. (Geerbt von Article) |
SnapshotObjectName |
Ruft das Datenbankobjekt ab, das die ursprüngliche Datenmomentaufnahme für den Artikel bereitstellt, oder legt es fest. |
SnapshotObjectOwner |
Ruft den Besitzer des Datenbankobjekts ab, das die ursprüngliche Datenmomentaufnahme für den Artikel bereitstellt, oder legt ihn fest. |
SourceObjectName |
Ruft den Namen des Datenbankobjekts ab, das veröffentlicht wird, oder legt ihn fest. (Geerbt von Article) |
SourceObjectOwner |
Ruft den Besitzer des Datenbankobjekts ab, das veröffentlicht wird, oder legt ihn fest. (Geerbt von Article) |
SqlServerName |
Ruft den Namen der Microsoft SQL Server-Instanz ab, mit der dieses Objekt verbunden ist. (Geerbt von ReplicationObject) |
SubscriberIdentityRangeSize |
Ruft die maximale Anzahl von neuen Zeilen ab, die auf einem Abonnenten in eine Identitätsspalte in einer Tabelle eingefügt werden können, bevor ein anderer Identitätsbereich zugeordnet werden muss, oder legt sie fest. (Geerbt von Article) |
Type |
Ruft den Artikeltyp ab oder legt ihn fest. (Geerbt von Article) |
UpdateCommand |
Ruft den Befehl ab, mit dem Updates repliziert werden, oder legt ihn fest. |
UserData |
Ruft eine Objekteigenschaft ab, die es Benutzern ermöglicht, ihre eigenen Daten an das Objekt anzufügen, oder legt sie fest. (Geerbt von ReplicationObject) |
VerticalPartition |
Ruft einen Wert ab, der angibt, ob alle Spalten in einem Tabellenartikel veröffentlicht werden. (Geerbt von Article) |
Methoden
AddReplicatedColumns(Array) |
Schließt Spalten einem vertikal partitionierten Tabellenartikel hinzu. |
CheckValidCreation() |
Überprüft die gültige Artikelerstellung. (Geerbt von Article) |
CheckValidDefinition(Boolean) |
Gibt an, ob die Definition gültig ist. (Geerbt von Article) |
CommitPropertyChanges() |
Sendet alle zwischengespeicherten Eigenschaftsänderungsanweisungen an die Instanz von Microsoft SQL Server. (Geerbt von ReplicationObject) |
Create() |
Erstellt einen neuen Artikel für die aktuell verbundene Instanz von SQL Server basierend auf den aktuellen Eigenschaften des TransArticle -Objekts oder -MergeArticleObjekts. (Geerbt von Article) |
Decouple() |
Entkoppelt das Replikationsobjekt, auf das verwiesen wird, vom Server. (Geerbt von ReplicationObject) |
EnumHeterogeneousColumns() |
Gibt Spalteninformationen für einen von einem Nicht-SQL Server-Verleger veröffentlichten Tabellenartikel zurück. |
GetChangeCommand(StringBuilder, String, String) |
Gibt den Änderungsbefehl von der Replikation zurück. (Geerbt von ReplicationObject) |
GetCreateCommand(StringBuilder, Boolean, ScriptOptions) |
Gibt den Erstellungsbefehl von der Replikation zurück. (Geerbt von ReplicationObject) |
GetDropCommand(StringBuilder, Boolean) |
Gibt den Löschbefehl von der Replikation zurück. (Geerbt von ReplicationObject) |
InternalRefresh(Boolean) |
Initiiert eine interne Aktualisierung von der Replikation. (Geerbt von ReplicationObject) |
ListReplicatedColumns() |
Gibt die veröffentlichten Spalten in einem Tabellenartikel zurück. |
Load() |
Lädt die Eigenschaften eines vorhandenen Objekts vom Server. (Geerbt von ReplicationObject) |
LoadProperties() |
Lädt die Eigenschaften eines vorhandenen Objekts vom Server. (Geerbt von ReplicationObject) |
Refresh() |
Lädt die Eigenschaften des Objekts erneut. (Geerbt von ReplicationObject) |
Remove() |
Entfernt einen vorhandenen Artikel für die aktuell verbundene Instanz von SQL Server basierend auf den aktuellen Eigenschaften des TransArticle -Objekts oder -MergeArticleObjekts. (Geerbt von Article) |
RemoveReplicatedColumns(Array) |
Schließt Spalten eines senkrecht partitionierten Tabellenartikels aus. |
Script(ScriptOptions) |
Generiert ein Transact-SQL-Skript, das ausgeführt werden kann, um das TransArticle Objekt oder das MergeArticle Objekt auf dem Server zu erstellen oder zu löschen. (Geerbt von Article) |
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions) |
Gibt ein Transact-SQL-Skript zurück, das zum Ändern der Spaltendatentypzuordnung für einen Nicht-SQL Server Verleger verwendet wird. |
SetColumnDestinationDataType(String, String, Int64, Int32, Int64) |
Legt die Zuordnung für die Spaltendatentypen für einen Nicht-SQL Server-Verleger fest. |