tablediff (Hilfsprogramm)

Artikel
03/06/2017

Mit dem Hilfsprogramm tablediff wird verglichen, ob die Daten in zwei Tabellen konvergent sind. Das Hilfsprogramm eignet sich besonders zur Problembehandlung bei mangelnder Konvergenz in einer Replikationstopologie. Dieses Hilfsprogramm kann an der Eingabeaufforderung oder in einer Batchdatei verwendet werden, um die folgenden Aufgaben auszuführen:

Durchführen eines zeilenweisen Vergleichs einer Quelltabelle in einer Microsoft SQL Server-Instanz, die als Replikationsherausgeber fungiert, mit der Zieltabelle in einer oder mehreren SQL Server-Instanzen, die als Replikationsabonnenten fungieren.
Ausführen eines schnellen Vergleichs, indem nur Zeilenanzahl und Schema verglichen werden.
Ausführen spaltenweiser Vergleiche.
Generieren Sie ein Transact-SQL-Skript, um Diskrepanzen auf dem Zielserver zu beheben und die Quell- und Zieltabellen in Übereinstimmung zu bringen.
Protokollieren von Ergebnissen in einer Ausgabedatei oder einer Tabelle in der Zieldatenbank.

Syntax

  
      tablediff   
[ -? ] |   
{  
        -sourceserversource_server_name[\instance_name]  
        -sourcedatabasesource_database-sourcetablesource_table_name   
    [ -sourceschemasource_schema_name ]  
    [ -sourcepasswordsource_password ]  
    [ -sourceusersource_login ]  
    [ -sourcelocked ]  
        -destinationserverdestination_server_name[\instance_name]  
        -destinationdatabasesubscription_database-destinationtabledestination_table   
    [ -destinationschemadestination_schema_name ]  
    [ -destinationpassworddestination_password ]  
    [ -destinationuserdestination_login ]  
    [ -destinationlocked ]  
    [ -blarge_object_bytes ]   
    [ -bfnumber_of_statements ]   
    [ -c ]   
    [ -dt ]   
    [ -ettable_name ]   
    [ -f [ file_name ] ]   
    [ -ooutput_file_name ]   
    [ -q ]   
    [ -rcnumber_of_retries ]   
    [ -riretry_interval ]   
    [ -strict ]  
    [ -tconnection_timeouts ]   
}

Argumente

[ -? ]
Gibt die Liste unterstützter Parameter zurück.

-sourceserver source_server_name[\instance_name]
Der Name des Quellservers. Geben Sie Name des Quellservers für die Standardinstanz von SQL Serveran. Geben Sie Name des Quellservers\Instanzname für eine benannte Instanz von SQL Serveran.

-sourcedatabase source_database
Der Name der Quelldatenbank.

-sourcetable source_table_name
Der Name der zu überprüfenden Quelldatenbank.

-sourceschema source_schema_name
Der Schemabesitzer der Quelltabelle. Standardmäßig wird dbo als Tabellenbesitzer angenommen.

-sourcepassword source_password
Das Kennwort für den Anmeldenamen, der verwendet wird, um mithilfe der SQL Server -Authentifizierung eine Verbindung mit dem Quellserver herzustellen.

Wichtig

Anmeldeinformationen sollten, sofern möglich, zur Laufzeit angegeben werden. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, sollten Sie die Datei an einem sicheren Ort speichern, um den unbefugten Zugriff zu vermeiden.

-sourceuser source_login
Der Anmeldename, der verwendet wird, um mithilfe der SQL Server -Authentifizierung eine Verbindung mit dem Quellserver herzustellen. Wenn Quellanmeldename nicht angegeben wird, wird die Windows-Authentifizierung zum Herstellen der Verbindung mit dem Quellserver verwendet. Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

-sourcelocked
Die Quelltabelle wird während des Vergleichs mit den Tabellenhinweisen TABLOCK und HOLDLOCK gesperrt.

-destinationserver destination_server_name[\instance_name]
Der Name des Zielservers. Angeben von Zielservername für die Standardinstanz von SQL Server. Geben Sie Zielservername\Instanzname für eine benannte Instanz von SQL Serveran.

-destinationdatabase subscription_database
Der Name der Zieldatenbank.

-destinationtable destination_table
Entspricht dem Namen der Zieltabelle.

-destinationschema destination_schema_name
Der Schemabesitzer der Zieltabelle. Standardmäßig wird dbo als Tabellenbesitzer angenommen.

-destinationpassword destination_password
Das Kennwort für den Anmeldenamen, der verwendet wird, um mithilfe der SQL Server -Authentifizierung eine Verbindung mit dem Zielserver herzustellen.

Wichtig

-destinationuser destination_login
Der Anmeldename, der verwendet wird, um mithilfe der SQL Server -Authentifizierung eine Verbindung mit dem Zielserver herzustellen. Wenn Zielanmeldename nicht angegeben wird, wird die Windows-Authentifizierung zum Herstellen der Verbindung mit dem Server verwendet. Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

-destinationlocked
Die Zieltabelle wird während des Vergleichs mit den Tabellenhinweisen TABLOCK und HOLDLOCK gesperrt.

-b large_object_bytes
Ist die Anzahl von Bytes, die für LOB-Datentyp-Spalten verglichen werden sollen, darunter: text, ntext, image, varchar(max), nvarchar(max) und varbinary(max). large_object_bytes wird standardmäßig auf die Größe der Spalte festgelegt. Alle Daten über large_object_bytes werden nicht überprüft.

-bf number_of_statements
Die Anzahl der TransactSQL -Anweisungen, die in die aktuelle TransactSQL -Skriptdatei geschrieben werden können, wenn die Option -f verwendet wird. Wenn die Anzahl der TransactSQL-Anweisungen number_of_statementsüberschreitet, wird eine neue TransactSQL-Skriptdatei erstellt.

-c
Vergleicht Unterschiede auf Spaltenebene.

-dt
Löscht die in table_nameangegebene Ergebnistabelle, wenn die Tabelle bereits vorhanden ist.

-et table_name
Gibt den Namen der zu erstellenden Ergebnistabelle an. Wenn diese Tabelle bereits vorhanden ist, muss -DT verwendet werden; andernfalls schlägt der Vorgang fehl.

-f [ file_name ]
Erzeugt ein Transact-SQL-Skript, um die Tabelle auf dem Zielserver mit der Tabelle auf dem Quellserver in Konvergenz zu bringen. Sie können optional einen Namen und einen Pfad für die generierte Transact-SQL-Skriptdatei angeben. Wurde file_name nicht angegeben, wird die TransactSQL -Skriptdatei in dem Verzeichnis erstellt, in dem das Hilfsprogramm ausgeführt wird.

-o output_file_name
Gibt den vollständigen Namen und Pfad der Ausgabedatei an.

-q
Ausführen eines schnellen Vergleichs, indem nur Zeilenanzahl und Schema verglichen werden.

-rc number_of_retries
Gibt an, wie oft das Hilfsprogramm einen fehlgeschlagenen Vorgang wiederholt.

-ri retry_interval
Gibt das Intervall (in Sekunden) zwischen den Wiederholungen an.

-strict
Für Quell- und Zielschema wird ein strenger Vergleich durchgeführt.

-t connection_timeouts
Legt das Verbindungstimeout (in Sekunden) für Verbindungen zwischen dem Quellserver und dem Zielserver fest.

Rückgabewert

Wert	Beschreibung
0	Erfolgreich
1	Schwerwiegender Fehler
2	Tabellenunterschiede

Hinweise

Das Tablediff-Hilfsprogramm kann nicht mit Nicht-SQL Server-Servern verwendet werden.

Tabellen, die Spalten des Datentyps sql_variant enthalten, werden nicht unterstützt.

Standardmäßig unterstützt das Hilfsprogramm tablediff die folgenden Datentypzuordnungen zwischen Quell- und Zielspalten.

Quelldatentyp	Zieldatentyp
`tinyint`	`smallint`, `int`oder `bigint`
`smallint`	`int` oder `bigint`
`int`	`bigint`
`timestamp`	`varbinary`
`varchar(max)`	`text`
`nvarchar(max)`	`ntext`
`varbinary(max)`	`image`
`text`	`varchar(max)`
`ntext`	`nvarchar(max)`
`image`	`varbinary(max)`

Verwenden Sie die Option -strict , wenn Sie diese Zuordnungen nicht zulassen und eine strenge Überprüfung durchführen möchten.

Die Quelltabelle bei dem Vergleich muss mindestens eine Primärschlüssel-, Identitäts- oder ROWGUID-Spalte enthalten. Wenn Sie die Option -strict verwenden, muss die Zieltabelle ebenfalls eine Primärschlüssel-, Identitäts- oder ROWGUID-Spalte enthalten.

Das Transact-SQL-Skript, das erstellt wurde, um die Zieltabelle in Konvergenz zu bringen, enthält die folgenden Datentypen nicht:

varchar(max)
nvarchar(max)
varbinary(max)
timestamp
xml
text
ntext
image

Berechtigungen

Für den Vergleich von Tabellen benötigen Sie SELECT ALL-Berechtigungen für die zu vergleichenden Tabellenobjekte.

Damit Sie die Option -et verwenden können, müssen Sie ein Mitglied der festen Datenbankrolle db_owner sein oder zumindest über die CREATE TABLE-Berechtigung für die Abonnementdatenbank und die ALTER-Berechtigung für das Zielbesitzerschema auf dem Zielserver verfügen.

Damit Sie die Option -dt verwenden können, müssen Sie ein Mitglied der festen Datenbankrolle db_owner sein oder zumindest über die ALTER-Berechtigung für das Zielbesitzerschema auf dem Zielserver verfügen.

Damit Sie die Option -o oder -f verwenden können, müssen Sie über Schreibberechtigungen für das angegebene Dateiverzeichnis verfügen.

Weitere Informationen

Überprüfen replizierter Tabellen auf Unterschiede (Replikationsprogrammierung)

Freigeben über