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 cubo 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. La sintaxis de ejecución del Builder es:
Las Opciones incluyen:
Opción Descripción
-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 -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 cubo 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 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 cubo, éste no se realiza hasta que la construcción del cubo esté completa. Si el proceso está esperando para intentar nuevamente, la interrupción es inmediata.
-port=<portnumber.> 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 cubo 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 cubo (notificando a los usuarios conectados y cerrando las conexiones), construye o actualiza el cubo y lo habilita.
El cubo generado se encuentra en la URL definida en el O3 Server al momento de publicarlo.
El archivo .srv debe tener el siguiente formato: serverHost = localhost serverName = O3Server cubeName = Demo model = C:\IdeaSoft\O3\Demo.mdl user = admin password = admin 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
cubeName Es el nombre del cubo 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 cubo. 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 cubo será actualizado. Este usuario debe tener privilegios de administrador.
password Es la contraseña para el usuario especificado. Nota
Ejemplos
Supongamos un cubo 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 cubo definido por el modelo C:\IdeaSoft\O3\Modelos\Ventas.mdl. Esta construcción dará origen al cubo 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 nombre del cubo de destino. Si se omite este parámetro se genera el cubo 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 Cubo 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 cubo 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 cubo construido será C:\IdeaSoft\O3\Modelos\Ventas.mdl ya que no fue especificada la opción –cube.
Agregar Datos del 2001 al Cubo 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 cubo crado 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 cubo indicado.