El comando de O3 Builder permite realizar una construcción completa o incremental desde la línea de comandos, o programando la construcción del datamart a través del programador de tareas del sistema operativo.
El ejecutable para el Builder se encuentra en la carpeta bin de la instalación de O3. Y en script en la carpeta bat (instalación MS-Windows) o sh.
La sintaxis de ejecución del Builder es:
Builder [opciones] <modelo | cubo | servercfg>
Las Opciones incluyen:
Opción | Descripción |
|---|---|
-debug | Activa la ejecución más detallada del componente. |
-log | Activa el envío de log de construcción a la consola. Esta opción está habilitada por defecto |
-logfile=<archivo> | Activa el envío de log de construcción al archivo indicado. Si bien el archivo no tiene por qué existir, sí la ruta donde será creado. |
-logtype=<tipo log> | Configura el tipo de log que se genera cuando la opción logfile está habilitada.
|
-help | Muestra los posibles parámetros y opciones para el comando. |
-version | Muestra información de versión de los componentes de O3. |
-cube=<archivo> | Especifica el nombre y la ubicación del datamart que se está generando. Es válido solamente para una construcción completa. Si no especifica un nombre de archivo, la ubicación por defecto y el nombre son los mismos del modelo con la extensión .cube. |
-is=<Input Set> | Especifique el nombre de un Input Set para usar en la construcción. Si está realizando una construcción completa, especifique un Input Set de tipo Full para esta opción y un archivo .mdl como parámetro. |
-cfg=<archivo> | Especifique el nombre y la ubicación del archivo que contiene los parámetros sustitutos de construcción. Por defecto, los parámetros de construcción toman su valor del indicado en el propio O3 Designer. |
-server | Indica que el O3 Builder se ejecutará como un servidor. Esto permite que un usuario se conecte desde Adm Server al Builder durante el proceso de construcción, para apagarlo usando ShutDown o para ver el registro. Esto es útil cuando el proceso de construcción es largo. |
-port=<número> | Cuando ejecuta el O3 Builder como un servidor, debe especificar un puerto para la conexión entre el AdmServer y el O3 Builder. El formato es <hostname>:<portnumber>. El puerto por defecto es 1098. |
Especifique uno de los siguientes parámetros:
Tipo | Descripción |
|---|---|
modelo | Un archivo .mdl indica que se solicita una construcción completa para el modelo indicado. Si no especifica un Input Set, se usará por defecto el Input Set de tipo Full llamado "Full" Notar que el nombre es sensible a mayúsculas y minúsculas |
cubo | Un archivo .cube indica que se solicita una construcción incremental del cubo indicado. Si no especifica un Input Set se usará por defecto el Input Set de tipo Incremental llamado "Incremental". Notar que el nombre es sensible a mayúsculas y minúsculas |
servercfg | Un archivo .srv conteniendo la información de actualización de un datamart publicado en un O3 Server. Puede ser utilizado tanto para construcciones completas o incrementales. El tipo de construcción se especifica usando la opción -is. Con este tipo de construcción el O3 Builder se conecta con el O3 Server, deshabilita el datamart (notificando a los usuarios conectados y cerrando las conexiones), construye o actualiza el datamart y lo habilita. |
El archivo .srv debe tener el siguiente formato:
# Ejemplo de archivo de configuración para actualizar el cubo Demo serverHost = localhost serverName = O3Server user = admin password = XXXXXXX cubeName = Demo model = istore:models/Demo.mdl publishType = contents #targetURL = C:\IdeaSoft\O3_50070Test/Files/Demo.cube forceAvailable = true #uploadURL = istore:/o3builder_cubes/Demo.cube deleteDownloadFile = true deletePreviousCube = true
donde:
serverHost | Es la dirección IP o nombre de la máquina en la que se está ejecutando el O3 Server. |
serverName | Es el nombre del servidor al que O3 Builder está conectado. El valor de este parámetro debe mantenerse "O3Server" excepto en raras ocasiones en las cuales sea necesario renombrar el servicio del O3 Server |
user | Es el usuario a través del cual el O3 Builder se conecta al O3 Server para notificar que el datamart será actualizado. Este usuario debe tener privilegios de administrador. |
password | Es la contraseña para el usuario especificado. |
cubeName | Es el nombre del datamart que se desea actualizar. Este nombre es aquel usado para publicarlo en el O3 Server y no tiene por qué coincidir con el nombre del archivo físico. |
model | Es la ruta y nombre del modelo del datamart. Se usa para construcciones completas. |
publishType | Especifica como se hará disponible en el servidor
|
targetURL | Especifica el lugar donde el datamart sera creado. |
forceAvailable | Especifica si el datamart debe quedar visible despues de la construcción |
uploadURL | Especifica el repositorio intermedio donde el datamart será construído. |
deleteDownloadFile | Especifica si el datamart tiene que ser borrado del depósito intermedio una vez publicado sobre en el Servidor |
deletePreviousCube | Especifica si el datamart publicado originalmente tiene que ser suprimido del Servidor después de copiar el nuevo. |
Este archivo de actualización de datamarts publicados en el servidor debe ser creado automáticamente por el O3 Server Administrator. Para más detalles referirse a la sección de Información de la Sección Parámetros de Actualización de la página de Administración de Cubos del Manual del O3 Server Administrator.
Ejemplos
Supongamos un datamart de ejemplo con información de ventas para los años 2000, 2001 y 2002
Generar una Construcción Completa
La siguiente línea se utiliza para realizar una construcción completa del datamart definido por el modelo
C:\IdeaSoft\O3\Modelos\Ventas.mdl. Esta construcción dará origen al datamart C:\IdeaSoft\O3\Cubos\Ventas.cube
builder -cube=C:\IdeaSoft\O3\Cubos\Ventas.cube C:\IdeaSoft\O3\Modelos\Ventas.mdl
- El parámetro -cube se usó para cambiar el path del datamart de destino. Si se omite este parámetro se genera el datamart en la misma ruta y con el mismo nombre que el modelo
- Como no se incluye un Input Set, por defecto se usa el Input Set llamado "Full".
- La especificación del archivo .mdl indica una construcción completa.
Al usar el Input Set "Full" la totalidad de los datos (2000 al 2002) serán incorporados en el cubo
Generar un Datamart con Datos Solamente del año 2000
Para este ejemplo se asume que se tiene definido un Input Set llamado "Solo2000" de tipo Full que extrae datos de la base de datos únicamente para el año 2000
La siguiente es la línea necesaria para realizar la construcción de dicho datamart
builder -is=Solo2000 C:\IdeaSoft\O3\Modelos\Ventas.mdl
- El parámetro -is especifica un Input Set de tipo Full llamado Solo2000 que sólo trae datos para el año 2000.
- El datamart construido será C:\IdeaSoft\O3\Modelos\Ventas.cube ya que no fue especificada la opción -cube.
Agregar Datos del 2001 al Datamart del 2000
Para este ejemplo se asume que se tiene definido un Input Set llamado "Incr2001" de tipo Incremental que únicamente trae datos para el año 2001
La siguiente es la línea necesaria para actualizar el datamart creado en el caso anterior con los datos del 2001
builder -is=Incr2001 C:\IdeaSoft\O3\Modelos\Ventas.cube
- El parámetro -is especifica un Input Set de tipo Incremental llamado Incr2001 que sólo trae datos para el año 2001.
- La especificación del archivo .cube indica que se trata de una construcción incremental del datamart indicado.