Usando O3 Builder

Unknown macro: {scrollbar}

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 el 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. Las opciones son: clear: Borra el archivo de log con cada construcción append: Agrega información al archivo de log si este ya existe. Opción por defecto.
-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. Si no especifica un Input Set, por defecto se usará el Input Set llamado "Full" que está presente por defecto en todos los modelos. Si está realizando una construcción incremental, especifique un Input Set Incremental para esta opción y un archivo .cube 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. Si ejecuta un ShutDown durante la construcción o actualización del datamart, éste no se realiza hasta que la construcción del datamart esté completa. Si el proceso está esperando para intentar nuevamente, la interrupción es inmediata.
-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.
-noecho	Desactiva el log en la consola
-profiling	Indica al builder que construya los modelos de análisis de monitoreo del O3 Server.
-encrypt	Encripta un texto para ser utilizado en los archivos de configuración (.cfg)
-setNotAvailable	Cambia el estado de un cubo a No Disponible. Se debe indicar el archivo .svr que especifica el cubo
-setAvailable	Cambia el estado de un cubo a Disponible. Se debe indicar el archivo .svr que especifica el cubo

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 datamart generado se encuentra en la URL definida en el O3 Server al momento de publicarlo.

El archivo .srv debe tener el siguiente formato:

# Ejemplo de archivo de configuración para actualizar el cubo Bodegas Ventas

_UEncodedVersion=
_Base64EncodedVersion=
serverHost='localhost'
serverPort='4447'
serverName='O3Server'
cubeUrn='urn:o3bi:default:r:cube:n:o3bi:BodegaVentas'
model='istore:models/BodegaVentas.mdl'
user='admin'
userPass='LS38h9m6jd4\='
forceAvailable='true'
publishType='contents'
deleteDownloadFile='true'
deletePreviousCube='true'
createTemporalCube='false'

donde:

serverHost	Es la dirección IP o nombre de la máquina en la que se está ejecutando el O3 Server.
serverPort	Es el puerto donde está escuchando 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
cubeUrn	Referencia interna del O3 Server para el cubo.
model	Es la ruta y nombre del modelo del datamart. Se usa para construcciones completas.
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.
userPass	Es la contraseña para el usuario especificado.
forceAvailable	Especifica si el datamart debe quedar visible despues de la construcción No es utilizado si publishType tiene otro valor a "none".
publishType	Especifica como se hará disponible en el servidor Las opciones son: none: Este es el valor por defecto y asegura compatibilidad con las versiones anteriores. upload: El Builder crea el datamart en un repositorio intermedio que podría ser del file system, ftp o istore contents: El Builder envía el contenido del datamart a través de la red. changelocation: Crea el datamart en donde diga el "targetURL" y al terminar la construcción, modifica la ubicación del cubo a la nueva posición.
targetURL	Especifica el lugar donde el datamart sera creado. No es utilizado si publishType tiene otro valor a "none" o "changelocation".
uploadURL	Especifica el repositorio intermedio donde el datamart será construído. Esta URL puede ser de file system, ftp o istore. Esta URL tiene que ser visible por el O3 Server. Esto solo es posible si la propiedad "publishType" fue especificada en "upload". Por "default" guarda en la carpeta temporal del usuario o del directorio temporal, dependiendo del sistema operativo.
deleteDownloadFile	Especifica si el datamart tiene que ser borrado del depósito intermedio una vez publicado sobre en el Servidor El valor por "default" es false
deletePreviousCube	Especifica si el datamart publicado originalmente tiene que ser suprimido del Servidor después de copiar el nuevo. Esto se realiza únicamente si la propiedad "o3.publish.mode" está seteada en "newfile" en el archivo GServer.properties
createTemporalCube

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 Generación de archivos de configuración para actualización de cubos 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.

Unknown macro: {scrollbar}