run, import, load
El comando run, import o load toma como argumento un archivo de comparación de DiffDog y ejecuta una comparación en los objetos definidos en el archivo de comparación. Estos archivos de comparación se crean en Altova DiffDog. Se aceptan estos tipos de archivo de comparación de DiffDog:
•.dirdif (que define una comparación de directorios)
•.filedif (que define una comparación de archivos)
•.dbdif (que define una comparación de datos de BD)
Puede dar más de un archivo de comparación como argumento del comando. Esto permite hacer varias comparaciones con una sola llamada.
Consideraciones importantes
Cuando se utilizan archivos de comparación como argumentos de este comando, deben tenerse en cuenta algunos aspectos.
Archivos Dirdif y Filedif
DiffDog Server solo puede ejecutar archivos *.filedif y *.dirdif en Windows. Para que la comparación se ejecute correctamente, todas las rutas de los archivos o directorios que eran válidas en el equipo local deben ser válidas en el equipo servidor.
Archivos Dbdif
Es más conveniente ejecutar los archivos .dbdif con DiffDog Server si DiffDog Server se ejecuta en el mismo ordenador que DiffDog Desktop o en un equipo Windows. Si DiffDog Server se ejecuta en un equipo o sistema operativo diferente, existen algunas limitaciones:
•Si la comparación incluye archivos CSV, la ejecución de archivos .dbdif solo funciona en servidores Windows. Para que la comparación se ejecute correctamente, todas las rutas de los archivos CSV que eran válidas en el equipo local deben ser válidas en el equipo servidor.
•Si la comparación incluye conexiones de BD, el equipo servidor debe estar configurado y ser capaz de establecer y mantener la conexión a la BD. Es decir, los controladores de BD y cualquier otro requisito previo de la conexión también deben estar presentes en el sistema operativo 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 compatibles con Windows no son compatibles con Linux y macOS. Para más información, consulte Bases de datos compatibles.
Nota: Si, en lugar de usar archivos de comparación, configura trabajos de comparación directamente en DiffDog Server (con los comandos data-diff y diff), entonces podrá ejecutar los trabajos de comparación en cualquier plataforma.
Resultados
La ejecución del comando run devuelve lo siguiente:
•Un código de estado de retorno (0 = sin diferencias, 1 = diferencias, 2 = error).
•El resultado de la comparación, directamente visible en la línea de comandos a menos que se suprima con la opción --quiet.
Redireccionar el resultado de la comparación a un archivo
Existe la posibilidad de redirigir el resultado de la comparación a un archivo en los tres tipos de archivos de comparación compatibles.
•En el caso de las comparaciones .filedif y .dirdif, el resultado de la comparación se puede redirigir a un archivo de informe en formato XML o texto. La ruta de acceso del archivo se especifica en DiffDog, en la opción de configuración Ruta de salida del archivo de comparación. Consulte la documentación de DiffDog para obtener más información.
•En el caso de las comparaciones .dbdif, el resultado de la comparación solamente está disponible en formato XML. Utilice la redirección de la shell de comandos, por ejemplo, así:
run comparison.dbdif >"C:\result.xml"
Sintaxis
diffdogserver run [opciones] {ARCHIVOS}
diffdogcmdlclient run [opciones] {ARCHIVOS}
Notas
•El argumento {ARCHIVOS} es una lista de archivos de comparación de DiffDog en formato .dirdif, .filedif o .dbdif separados por espacios. La ruta de un archivo puede ser absoluta o relativa al directorio de trabajo actual. Puede incluir tantos archivos como quiera en la lista. El único límite es el número de caracteres que admita su shell de comandos.
•Las opciones --server y --port solo se utilizan con diffdogcmdlclient. Especifican los detalles de conexión del servidor.
Opciones
Si el administrador del servidor ha restringido el acceso a las rutas de acceso del servidor por razones de seguridad, las comparaciones no pueden usar las rutas de acceso de archivos del servidor directamente, sino que deben usar un alias ya asignado por el administrador del servidor. Esto se hace especificando el alias en la opción --alias (de los comandos diff, compare y run, import, load). Consulte Alias para carpetas del servidor para obtener más información sobre esta característica.
Esta opción es importante si la comparación implica una ruta de servidor (es decir, si se han configurado las opciones--server-left or --server-right). Los valores válidos para esta opción son los alias definidos en el archivo de configuración del servidor . Para generar la lista de alias disponibles, ejecute el comando aliases. Para ver más información, consulte Restringir el acceso a las rutas de servidor.
|
Especifica la ruta a un archivo de configuración del cliente donde se definen los detalles de la conexión a DiffDog Server.
Si no configura la opción --c, entonces diffdogcmdlclient intenta leer el archivo de configuración del cliente desde el mismo directorio que el ejecutable. Si no hay ningún archivo de configuración en el mismo directorio, se utilizan los valores predeterminados que muestra el comando showcfg de la línea de comandos (los mismos valores del tema Archivo de configuración del cliente).
|
Establece el nivel de información que se ofrece en los mensajes de información, advertencia y error. Los valores válidos son:
•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: (Predeterminado) Solo informa acerca de mensajes de error.
|
Indica el puerto desde el que DiffDog Server escucha las solicitudes. Si esta opción no está configurada, se utilizará el puerto especificado en el archivo de configuración del cliente (29800 por defecto). La opción --port anula lo configurado en el archivo de configuración.
|
Indica el servidor desde el que DiffDog Server escucha las solicitudes. Si esta opción no está configurada, se utilizará el servidor especificado en el archivo de configuración del cliente (127.0.0.1 por defecto). La opción --server anula lo configurado en el archivo de configuración.
|
Evita que el resultado estándar sea visible en la línea de comandos. Los valores válidos son:
•true: No muestra el resultado estándar en la ventana del terminal. •false: (Predeterminado) Muestra el resultado estándar en la ventana del terminal.
|
Indica el formato de salida del informe generado. Estos son los valores disponibles: auto (predeterminado), text, sql, xml, html. La opción predeterminada es sql.
Tiene sentido generar el informe en formato SQL cuando el lado derecho de la comparación de datos es una base de datos. Contiene instrucciones SQL que combinan datos del lado izquierdo con datos del lado derecho de la comparación. Por ejemplo, si faltan filas en el lado derecho, entonces se generan instrucciones INSERT. En cambio, si en el lado derecho sobran filas, entonces se generan instrucciones DELETE. Para los valores modificados, se generan instrucciones UPDATE.
Sin embargo, cuando el lado izquierdo de la comparación es una base de datos y el lado derecho es un archivo CSV, entonces la opción predeterminada es text.
|
Ejemplos
El siguiente comando llama al ejecutable de DiffDog Client para ejecutar el archivo de comparación C:\DiffDog\Comparison1.filedif:
DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif
El siguiente comando llama al ejecutable de DiffDog Client para ejecutar los archivos de comparación Comparison1.filedif y Comparison2.dirdif:
DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif C:\DiffDog\Comparison2.dirdif