Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{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.

...

La sintaxis de ejecución del Builder es:

Code Block

Builder [opciones] <modelo | cubo | servercfg>

...

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

-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.

...

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:

Code Block

# 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

...

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
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: ?? - Editando Diego

targetURL

Especifica el lugar donde el datamart sera creado.
No es utilizado si publishType tiene otro valor a "none"

forceAvailable

Especifica si el datamart debe quedar visible despues de la construcción
No es utilizado si publishType tiene otro valor a "none"

uploadURL

Especifica el repositorio intermedio donde el datamart será construído.
Esta URL puede ser de file system, fto 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

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" estaáseteada en "newfile" en el archivo GServer.properties

...

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

Code Block

builder -cube=C:\IdeaSoft\O3\Cubos\Ventas.cube C:\IdeaSoft\O3\Modelos\Ventas.mdl

...

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

Code Block

builder -is=Solo2000 C:\IdeaSoft\O3\Modelos\Ventas.mdl

...

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

Code Block

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.

...

Wiki Markup
{scrollbar}

Child pages (Children Display)