20 Gestión de Essbase con el cliente MaxL

MaxL es un lenguaje de acceso a la base de datos multidimensional para Essbase.

Para ejecutar sentencias o scripts MaxL, debe utilizar el cliente MaxL para emitir sentencias por HTTP o HTTPS.

Requisitos para la configuración del cliente MaxL

Complete estas tareas antes de realizar la descarga y utilizar el cliente MaxL. Para ejecutar scripts o sentencias MaxL, debe ser usuario avanzado o administrador.

Si desea prepararse para utilizar el cliente MaxL:
  1. Obtenga la URL de la instancia de Essbase del administrador del servicio. Su formato básico es:
    https://essbase-instance-name.oraclecloud.com/essbase
  2. Utilizando un explorador web o cURL, compruebe que puede obtener la URL de detección desde el host de cliente. Este es un ejemplo de cURL:
    curl https://myEssbase-myDomain.oraclecloud.com/essbase/agent --tlsv1.2
  3. Configure el certificado SSL, si es aplicable a su organización.
    • Si utiliza uno de los siguientes tipos de despliegues, se incluirá un certificado SSL firmado de CA de confianza:
      • Oracle Analytics Cloud

      • Oracle Analytics Cloud con Identity Cloud Service (IDCS) y Load Balancing

      • Cloud at Customer con Load Balancing

    • Si utiliza Oracle Analytics Cloud o Cloud at Customer con LDAP (sin Load Balancing), utilice un certificado autofirmado.
  4. Para comprobar que es de confianza, pegue la URL de detección en un explorador web. Si https es verde o en la etiqueta se lee "Seguro", es de confianza. Si https es rojo y en la etiqueta se lee "No seguro", no es de confianza.
  5. Si el certificado no es de confianza (autofirmado), impórtelo al almacén de confianza del cliente (cacert.pem).
  6. El cliente verifica el certificado digital del servidor utilizando un almacén de certificados CA que haya sido proporcionado. Proporcione la ubicación del grupo de certificados CA especificando la variable de entorno:
    API_CAINFO=Ruta de acceso del archivo de certificado CA;
    Si no se proporciona la ruta de acceso, el cliente de tiempo de ejecución de Essbase intentará obtener los certificados CA desde la ubicación de instalación de OpenSSL por defecto (aplicable a Linux y Macintosh).

    Los clientes de Oracle Data Visualization y el cliente MaxL incluyen un grupo de certificados CA (cacert.pem).

    Si necesita un grupo de certificados CA (cacert.pem), también puede descargarlo. Un ejemplo de origen es: https://curl.haxx.se/docs/caextract.html.

Descarga y uso del cliente MaxL

El cliente MaxL de Essbase le permite utilizar MaxL en HTTP y HTTPS. MaxL es una interfaz administrativa basada en el lenguaje pensada para gestionar cubos y artefactos. Esta alternativa al CLI puede resultar útil si ya dispone de una biblioteca de scripts de MaxL. Asegúrese de que utiliza la versión más reciente proporcionada por la consola, ya que otras versiones anteriores descargadas pueden no funcionar correctamente.

Para ejecutar sentencias MaxL, debe ser un usuario avanzado o administrador. Antes de descargar el cliente MaxL, consulte Requisitos para la configuración del cliente MaxL.

  1. En la interfaz web de Essbase, haga clic en Consola.

  2. En la Consola, vaya a Clientes MaxL.

  3. Haga clic en Descargar Imagen del icono Descargar. junto al cliente MaxL adecuado para su plataforma.

  4. Guarde el archivo comprimido EssbaseMaxl en su unidad local.

  5. Extraiga el contenido del archivo comprimido en una carpeta.

  6. Si está utilizando un proxy, debe definir o anular la definición del proxy correcto en el script de ejecución MaxL, startMAXL.bat o startMAXL.sh. A continuación se muestran algunos ejemplos en los que se utiliza bash:

    export https_proxy=http://proxy.example.com
    export no_proxy=127.0.0.1,localhost,something.something.com
  7. Ejecute el lote o el script de shell startMAXL. El cliente MaxL se inicia tras abrirse un símbolo del sistema y completarse la configuración del entorno.

  8. Conéctese proporcionando sus credenciales de servicio y su URL de detección en la sentencia de conexión de MaxL.

    Por ejemplo:

    login admin1 password1 on "https://myEssbase-myDomain.analytics.us2.oraclecloud.com/essbase/agent";
  9. Ejecute una sentencia interactiva MaxL.

    Por ejemplo:

    display database all;

Para obtener más información acerca de MaxL, consulte Referencia de sentencia MaxL in Referencia técnica para Oracle Analytics Cloud - Essbase.