/
Documentación del Usuario de Pan

Documentación del Usuario de Pan

Mar 10, 2009

¿Qué es Pan?

Pan es un programa que puede ejecutar transformaciones diseñadas con Spoon y almacenadas como XML ó en el repositorio de base de datos. Generalmente las transformaciones se programan en modo por lotes para ser ejecutadas en intervalos de tiempo regulares.

Instalación

El primer paso es la instalación de la máquina virtual (JRE) de Java de Sun Microsystems, versión 1.5 ó mayor. La misma puede ser descargada gratuitamente desde http://www.java.com/.
Luego de esto simplemente descomprima el archivo zip de PDI (por ejemplo pdi-ce-3.1.0-GA.zip) en el directorio que elija.

En ambientes de tipo Unix (Solaris, GNU/Linux, ...) será necesario asignar permisos de ejecución a los scripts de comandos. Desde dentro del directorio de PDI se puede utilizar el siguiente comando:

chmod +x *.sh

Iniciando Pan

Para inciar Pan en diferentes plataformas se proveen los siguientes scripts:

  • Pan.bat : ejecutar Pan en la plataforma Windows

  • pan.sh : ejecutar Pan en plataformas tipo Unix y OSX

Pan puede ejecutarse en cualquier plataforma que tenga una versión de la máquina virtual de Java 1.5 ó mayor.

Opciones de línea de comandos

Estas son las opciones de línea de comandos que puede utilizar.
NOTAS IMPORTANTES:

  • En el sistema Windows, el uso del guión ("-") en las opciones causa problemas, lo mismo que el signo igual ("="). A causa de ello a partir de la versión 2.2.2 puede utilizarse ese formato ó cualquier combinación de "/,-" y ":,=".

  • Es importante que si hay valores presentes en los valores de las opciones se utilicen comillas simples ó dobles para unirlos. Observe los ejemplos subsiguientes para más información.

/opcion:valor

Debajo se listan las opciones válidas.

Mostrar información de la versión

-version

Esta opción muestra la versión de la librería principal de PDI.
El número de versión de la compilación y la fecha de compilación se muestran también.

Ejecutar archivo XML (.ktr)

-file=nombredearchivo

Esta opción ejecuta la transformación definida en el archivo XML (.ktr) indicado.

Establecer el archivo de log

-log=nombredearchivo

Indica el archivo donde guardar el log (por defecto se utiliza la salida estándar).

Establecer el nivel de log

-level=niveldelog

Esta opción establece el nivel de log para la transformación que se ejecutará.
Estos son los posibles valores:

  • Error: Mostrar sólo errores

  • Nothing: No mostrar salida

  • Minimal: Información mínima

  • Basic: Información básica (seleccionado por defecto)

  • Detailed: Información detallada

  • Debug: Para corrección de errores, salida muy detallada

  • Rowlevel: Información a nivel de registro, puede generar una gran cantidad de datos

Seleccionar un repositorio

-rep="Nombre del Repositorio"

Conectar al repositorio con nombre "Nombre del Repositorio"
También será necesario especificar las opciones --user, --pass y --trans.
(Esta opción tembién puede ser especificada mediante la variable de entorno KETTLE_REPOSITORY)

Establecer el nombre de usuario del repositorio

-user=nombredeusuario

Este es el nombre de usuario con el cual se conectará al repositorio.
(Esta opción tembién puede ser especificada mediante la variable de entorno KETTLE_USER)