run
El comando run ejecuta una comparación, siempre que se dé como argumento uno de estos tipos de archivo:
•*.dirdif (comparación de directorios)
•*.filedif (comparación de archivos)
•*.dbdif (comparación de bases de datos)
Puede crear archivos .filedif y .dirdif con la aplicación de escritorio Altova DiffDog (https://www.altova.com/es/diffdog); para ello guarde cualquier comparación de archivos o directorios en un archivo. Las comparaciones de datos de BD (.dbdif) solo se pueden crear con DiffDog Enterprise Edition.
Los archivos *.filedif y *.dirdif solo se pueden ejecutar en Windows. Para que la comparación se realice correctamente es necesario que todas las rutas de acceso a archivos y directorios que eran válidas en el equipo de escritorio lo sean también en el equipo servidor. Si configura los trabajos de comparación directamente en DiffDog Server (en vez de con archivos *.filedif y *.dirdif) puede ejecutarlos independientemente de la plataforma.
Para ejecutar archivos *.dbdif con DiffDog Server recomendamos ejecutar DiffDog Server en el mismo equipo que la aplicación de escritorio DiffDog o bien en un equipo Windows. Si DiffDog Server se ejecuta en un equipo o en un sistema operativo distinto, debe tener en cuenta estas limitaciones:
•si la comparación incluye archivos CSV, solo puede ejecutar archivos *.dbdif en servidores Windows. Para que la comparación se realice con éxito todas las rutas de acceso a los archivos CSV que eran válidas en el equipo de escritorio deben serlo también en el equipo servidor. •si la comparación incluye bases de datos, el equipo servidor debe estar configurado y ser capaz de establecer y mantener la conexión de BD. Es decir, debe tener instalados los controladores de la BD y cumplir con cualquier otro requisito necesario para la conexión también en el equipo de destino. Por ejemplo, si el archivo *.dbdif incluye una conexión que necesita un controlador ODBC del proveedor de BD, debe tener ese controlador instalado también en el equipo servidor. Tenga en cuenta que algunos métodos de conexión a bases de datos admitidos en Windows no son compatibles con Linux y macOS. Para más información consulte Bases de datos compatibles.
Si configura los trabajos de comparación directamente en DiffDog Server (en vez de con archivos *.dirdif) puede ejecutarlos independientemente de la plataforma. |
Al ejecutar el comando run, DiffDog Server informa del resultado de la comparación con un código de estado (0 = no hay diferencias, 1 = diferencias, 2 = error), de forma parecida a como funciona el comando diff. El resultado se muestra directamente en la línea de comandos, a no ser que se impida con la opción --quiet.
En el caso de las comparaciones .filedif or .dirdif también puede redirigir el resultado de la comparación a un archivo de informe en formato XML o texto. La ruta del archivo de informe se define en la interfaz gráfica de usuario de la aplicación de escritorio DiffDog, donde puede definir la ruta de salida de una comparación .filedif o .dirdif como sigue:
1.Abra un archivo .dirdif o .filedif ya existente (o cree una nueva comparación) en DiffDog.
2.En el menú Herramientas, haga clic en Opciones de comparación del documento.
3.Elija una opción:
a.Para no exportar a un archivo, elija No permitir exportaciones (es la opción predeterminada).
b.Para exportar el informe a un archivo XML, seleccione Exportar a un archivo XML e introduzca la ruta en el campo de búsqueda.
c.Para exportar a un archivo de texto, seleccione Exportar a un archivo de texto e introduzca la ruta en el campo de búsqueda.
4.En el menú Archivo, haga clic en Guardar como y guarde la comparación como .filedif (o .dirdif, si corresponde).
Para comparaciones .dbdif el resultado de la comparación solo está disponible en formato XML. Use el comando de redirección de la línea de comandos para redirigir el resultado a un archivo, por ejemplo:
DiffDogCmdlClient run comparison.dbdif >"C:\esult.xml" |
Sintaxis
DiffDogCmdlClient run [opciones] {FILES} |
También puede llamar al comando run usando los alias import o load. Puede usar run, import o load indistintamente.
En Linux debe usar minúsculas para llamar al ejecutable. Además, es posible que en Linux y macOS tenga que añadir el prefijo "./" antes del nombre del ejecutable al llamarlo desde el directorio actual de la línea de comandos.
Argumentos
comparison-file
Indica la ruta a un archivo de comparación en formato .dirdif, .filedif o .dbdif. La ruta del archivo de comparación puede ser absoluta o relativa al directorio de trabajo activo en ese momento. Puede dar como argumentos tantos archivos de comparación como necesite. El único límite es el número de caracteres de entrada que admita la shell de comandos.
Opciones
--config, --c
Esta opción indica la ruta de acceso a un archivo de configuración del cliente en el que están definidos los detalles de DiffDog Server.
Si no establece la opción --c, el ejecutable de DiffDog Client intentará leer el archivo de configuración del cliente desde el mismo directorio. Si no existe un archivo de configuración en el mismo directorio que el ejecutable se usarán los valores descritos en la ayuda de la línea de comandos y en esta documentación.
--port
Esta opción indica el puesto en el que DiffDog Server atiende las respuestas. Activar esta opción es útil si DiffDog Server se ejecuta en un puerto que no sea el predeterminado, 29800. Puede definir esta opción en la línea de comandos o en el archivo de configuración del cliente. Tenga en cuenta que si la define desde la línea de comandos esta opción tiene prioridad frente a la que se haya definido en el archivo de configuración.
--quiet, --q
Evita que la salida estándar se muestre en la línea de comandos. Son valores válidos:
true | No muestra la salida estándar en la ventana terminal. |
false | (Predeterminado) Muestra la salida estándar en la ventana terminal. |
--loglevel, --L
Establece el nivel de información que se proporciona sobre mensajes de información, advertencia y error. Son valores válidos:
none | No informa de nada. |
info | Informa acerca de mensajes de información, advertencia y error. |
warning | Informa acerca de mensajes de advertencia y error. |
error | (valor predeterminado) Solo informa acerca de mensajes de error. |
--output-mode, --om
Esta opción indica el formato del informe de la comparación. Son valores válidos:
auto | (Valor predeterminado) La aplicación determina el formato. |
text | El informe se genera en formato texto. |
sql | Genera el informe en formato SQL. Este valor es importante si el lado derecho de la comparación de datos es una BD. Este valor contiene instrucciones SQL que combinan datos de la comparación de izquierda a derecha. Por ejemplo, si falta alguna fila en el lado derecho se generan instrucciones INSERT. Si en el lado derecho sobran filas, entonces se generan instrucciones DELETE. Para valores que hayan cambiado se generan instrucciones UPDATE. |
xml | El informe se genera en formato XML. |
--server
Esta opción indica el puesto en el que DiffDog Server atiende las respuestas. Activar esta opción es útil si DiffDog Server se ejecuta en un servidor que no sea el predeterminado, localhost. Puede definir esta opción en la línea de comandos o en el archivo de configuración del cliente. Tenga en cuenta que si la define desde la línea de comandos esta opción tiene prioridad frente a la que se haya definido en el archivo de configuración.
--alias
Indica qué alias se usa cuando el servidor se ejecuta en modo restringido.
Ejemplo
Para ejecutar el archivo de comparación C:\DiffDog\Comparison1.filedif, use el siguiente comando:
DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif |
Para ejecutar el archivo de comparación Comparison1.filedif y Comparison2.dirdif (se encuentran ambos en el directorio C:\DiffDog), use el siguiente comando:
DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif C:\DiffDog\Comparison2.dirdif |