tablediff, utilidad

La utilidad tablediff se usa para comparar los datos de dos tablas para determinar la no convergencia y es especialmente útil para solucionar problemas de no convergencia en una topología de replicación. Esta utilidad se puede usar desde el símbolo del sistema o en un archivo por lotes para realizar las siguientes tareas:

• Una comparación fila a fila entre una tabla de origen de una instancia de Microsoft SQL Server que actúa como publicador de replicación y la tabla de destino de una o más instancias de SQL Server que actúan como suscriptores de replicación.

• Realiza una comparación rápida comparando solo el número de filas y el esquema.

• Realizar comparaciones de nivel de columna.

• Generar un script Transact-SQL para solucionar discrepancias en el servidor de destino y hacer que las tablas de destino y de origen converjan.

• Registrar resultados en un archivo de salida o en una tabla de la base de datos de destino.

Sintaxis

  
      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 ]   
}  

Argumentos

[ - ? ]
Devuelve la lista de parámetros admitidos.

-sourceserver source_server_name[\instance_name]
Es el nombre del servidor de origen. Especifique source_server_name para la instancia predeterminada de SQL Server. Especifique source_server_name\instance_name para una instancia con nombre de SQL Server.

-sourcedatabase source_database
Es el nombre de la base de datos de origen.

-sourcetable source_table_name
Es el nombre de la tabla de origen que se está comprobando.

-sourceschema source_schema_name
Es el propietario del esquema de la tabla de origen. De forma predeterminada, se asume que el propietario de la tabla es dbo.

-sourcepassword source_password
Es la contraseña para el inicio de sesión que se usa para conectar con el servidor de origen mediante autenticación de SQL Server .

Importante

Cuando sea posible, proporcione credenciales de seguridad en tiempo de ejecución. Si debe almacenar credenciales en un archivo de script, debe proteger el archivo para impedir el acceso no autorizado.

-sourceuser source_login
Es el inicio de sesión que se usa para conectar con el servidor de origen mediante autenticación de SQL Server . Si no se proporciona source_login , se usa autenticación de Windows para conectar con el servidor de origen. Siempre que sea posible, utilice la autenticación de Windows.

-sourcelocked
La tabla de origen se bloquea durante la comparación con las sugerencias de tabla TABLOCK y HOLDLOCK.

-destinationserver destination_server_name[\instance_name]
Es el nombre del servidor de destino. Especifique destination_server_name para la instancia predeterminada de SQL Server. Especifique destination_server_name\instance_name para una instancia con nombre de SQL Server.

-destinationdatabase subscription_database
Es el nombre de la base de datos de destino.

-destinationtable destination_table
Es el nombre de la tabla de destino.

-destinationschema destination_schema_name
Es el propietario del esquema de la tabla de destino. De forma predeterminada, se asume que el propietario de la tabla es dbo.

-destinationpassword destination_password
Es la contraseña para el inicio de sesión que se usa para conectar con el servidor de destino mediante autenticación de SQL Server .

Importante

Cuando sea posible, proporcione credenciales de seguridad en tiempo de ejecución. Si debe almacenar credenciales en un archivo de script, debe proteger el archivo para impedir el acceso no autorizado.

-destinationuser destination_login
Es el inicio de sesión que se usa para conectar con el servidor de destino mediante autenticación de SQL Server . Si no se proporciona destination_login , se usa autenticación de Windows para conectar con el servidor. Siempre que sea posible, utilice la autenticación de Windows.

-destinationlocked
La tabla de destino se bloquea durante la comparación con las sugerencias de tabla TABLOCK y HOLDLOCK.

-b large_object_bytes
Es el número de bytes que se deben comparar en las columnas cuyo tipo de datos es de objetos grandes, lo que incluye los tipos: text, ntext, image, varchar(max), nvarchar(max) y varbinary(max). large_object_bytes toma como valor predeterminado el tamaño de la columna. Los datos que superen large_object_bytes no se compararán.

-bf number_of_statements
Es el número de instrucciones Transact-SQL que se va a escribir en el archivo de script actual Transact-SQL cuando se usa la opción -f. Cuando el número de instrucciones Transact-SQL supera el valor de number_of_statements, se crea un nuevo archivo de script Transact-SQL.

-c
Compara diferencias de nivel de columna.

-dt
Quita la tabla de resultados especificada por table_namesi la tabla ya existe.

-et table_name
Especifica el nombre de la tabla de resultados que se desea crear. Si ya existe esta tabla, debe usarse -DT o la operación no se realizará correctamente.

-f [ file_name ]
Genera un script de Transact-SQL para hacer que la tabla del servidor de destino converja con la tabla del servidor de origen. Tiene la opción de especificar un nombre y una ruta de acceso para el archivo de script Transact-SQL generado. Si no se especifica file_name, el archivo de script Transact-SQL se genera en el directorio en el que se ejecuta la utilidad.

-o output_file_name
Es la ruta y el nombre completo del archivo de salida.

-q
Realiza una comparación rápida comparando solo el número de filas y el esquema.

-rc number_of_retries
Número de reintentos de la utilidad para operaciones con errores.

-ri retry_interval
Intervalo (en segundos) entre los reintentos.

-strict
El esquema de origen y de destino se comparan de forma estricta.

-t connection_timeouts
Establece el período de tiempo de espera de la conexión, en segundos, para las conexiones con el servidor de origen y el servidor de destino.

Valor devuelto

Value	Descripción
0	Correcto
1	Error grave
2	Diferencias entre tablas

Comentarios

La utilidad tablediff no se puede usar con servidores que no son de SQL Server.

No se admiten tablas que contengan columnas con el tipo de datos sql_variant.

De forma predeterminada, la utilidad tablediff admite las siguientes asignaciones de tipos de datos entre las columnas de origen y de destino.

Tipo de datos de origen	Tipo de datos de destino
tinyint	smallint, into bigint
smallint	int o bigint
int	bigint
timestamp	varbinary
varchar(max)	text
nvarchar(max)	ntext
varbinary(max)	image
text	varchar(max)
ntext	nvarchar(max)
image	varbinary(max)

Use la opción -strict para no permitir estas asignaciones y llevar a cabo una validación estricta.

La tabla de origen de la comparación debe contener como mínimo una columna de clave principal, de identidad o ROWGUID. Cuando se emplea la opción -strict , la tabla de destino también debe tener una columna de clave principal, de identidad o ROWGUID.

El script Transact-SQL generado para hacer que la tabla de destino converja no incluye los siguientes tipos de datos:

• varchar(max)

• nvarchar(max)

• varbinary(max)

• timestamp

• xml

• text

• ntext

• image

Permisos

Para comparar tablas, necesita los permisos SELECT ALL en los objetos de la tabla que se están comparando.

Para usar la opción -et , debe ser miembro del rol fijo de base de datos db_owner o, como mínimo, tener el permiso CREATE TABLE en la base de datos de suscripciones y el permiso ALTER en el esquema del propietario de destino del servidor de destino.

Para usar la opción -dt , debe ser miembro del rol fijo de base de datos db_owner o, como mínimo, tener el permiso ALTER en el esquema del propietario de destino del servidor de destino.

Para usar las opciones -o o -f , debe tener permisos de escritura en la ubicación del directorio de archivos especificada.

Consulte también

Comparar tablas replicadas para buscar diferencias (programación de la replicación)