manunueal de entrenamiento en contablidad basica para manejo de la aplicacion SAP business One. contiene paso a paso con pantallazos de la aplicacion en casos reales de operacion en difer…Descripción completa
Uso de Token para SAP B1
Descripción: sap
sap
Manual de SAP B1 acerca de la funcionalidad de la determinación de cuentas.Descripción completa
Descripción: .
Descripción completa
Full description
prueba1Descripción completa
Full description
change sapFull description
dfsdDescripción completa
Descripción completa
Descripción: ACCESO A DATOS - LIBRO EDITORIAL GARCETA
Descripción: El Manual de los Datos Abiertos Accesible sin registrarse en: http://www.datos.misiones.gov.ar/repositorio/documentos/Manual_de_Datos_Abiertos.pdf Este manual se refiere a los aspectos lega...
Descripción: Manual basico sobre base de datos
Descripción: business
Descripción completa
Plataforma SAP BusinessObjects Business Intelligence Versión del documento: 4.1 Support Package 4 - 2014-06-17
Agregar un controlad controlado or nuevo después de la instalación de revisiones. . . . . . . . . . . . . . . . . . . . . . . . . 64
5.7
Establecer la configu ra raci ción ón re regi gion onal al en un fl fluj ujo o de tr trab abaj ajo o de va vari rios os or oríg ígen enes es de da dato tos. s. . . . . . . . . . . . . .65
Cont Co ntro rola lado dorr ODat OData: a: as asig igna naci ción ón de ár área ea de no nomb mbre res, s, pro propi piet etar ario io y cali califi fica cado dor. r. . . . . . . . . . . . . 75
Configurar el servidor de conexión para una conexión de ODBC de Data Federator. . . . . . . . 142
8.4 Configurar conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC de Data Federator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 8.4.1 Configurar el middleware ODBC de Data Federator para una conexión de Cliente enriquecido de Web Intelligence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 8.4.2 Configurar el servidor de conexión para una conexión del Cliente enriquecido de Web Intelligence con Data Federator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 8.4.3
Definir la clave de registro del Cliente enriquecido de Windows. . . . . . . . . . . . . . . . . . . . . . .145
8.4.4 Configurar el servidor de conexión para conexiones de Cliente enriquecido de Web Intelligence o la herramienta de diseño de universos con Data Federator. . . . . . . . . . . . . . . . . . . . . . .145 9
En la siguiente tabla se ofrece información general sobre los cambios más importantes del documento.
Plataforma SAP Busi nessObjects Business Intelligence 4.1
Mayo de 2013
Nuevos controladores OData, XML y de servicio Web, consulte Controla dores de acceso a datos [página 66]. Compatibilidad de inicio de sesión único para Teradata 13, Teradata 14, y Sybase IQ, consulte Soporte de inicio de sesión único [página 27]. Compatibilidad de procedimientos almacenados SAP HANA, consulte Procedimientos almacenados de SAP HANA [página 31]. Para conexiones SAP ERP, asignación simple de c olumnas de entrada opcional, consulte Controlador de SAP ERP: acceso a funciones ABAP [página 89]. Para conexiones SAP HANA, compatibilidad con la nueva versión de SAP HANA SPS 05 , conexiones OLAP, inicio de sesión único a través del protocolo SAML, protocolo SSL, y plataformas UNIX de 64 bits me diante ODBC, consulte Conexiones SAP HANA [página 130]. Compatibilidad de conexiones HIVE 0.9 mediante JDBC, consulte Cone xiones HIVE [página 115]. Nuevo registrador para la actividad del servidor de conexión, consulte Activar registros y seguimientos del servidor de conexión y de lo s contro ladores [página 157].
Para consultar cómo activar logs de cliente OLAP, véase Activar regis tros y seguimientos para el cliente OLAP [página 164]. Compatibilidad con controladores DataDirect ODB C 7.0, consulte Acerca de los controladores DataDirect ODBC [página 172]. Nuevo parámetro SBO para cualquier controlador de acceso a datos, consulte Dictionary Transaction Mode [página 181]. Nuevos parámetros SBO para conexiones MySQL, consulte JDBC Re sultSet Type [página 198] y JDBC ResultSet Concurrency [página 198]. Nuevo parámetro SBO para conexiones Teradata, consulte Replace Cu rrent Owner With Database [página 206]. Nuevo parámetro SBO para omitir SAML con conexiones SAP HANA, consulte Skip SAML SSO [página 188]. Plataforma de SAP Busi Agosto de nessObjects Business 2013 Intelligence 4.1 Paquete de compatibilidad 1
Hay nuevas conectividades disponibles, consulte Matriz de productos disponibles para obtener más información. Descripción de modo de conjunto de conexiones, consulte Modo de con junto de conexiones [página 33].
Para comprobar las conexiones almacenadas en CMS, consulte Com probar herramienta—Información CMS [página 49]. Para encontrar la versión de controlador JDBC, consulte Para encontrar la versión de un controlador JDBC [página 57]. Ajustar el tiempo de espera de conexión OData para mejorar el rendi miento, consulte Supervisar el rendimiento del controlador OData [pá gina 80]. Soporte de conexiones a diferentes versiones de la base de datos HIVE, consulte Conexiones HIVE [página 115]. Configuración UNIX para conexiones de MS SQL Server, con sulte Esta blecer las opciones JVM para conexiones con MS SQL Server en UNIX
[página 122]. Para fijar el valor de parámetro CURSOR_SHARING, consulte Conexiones Oracle [página 123]. Soporte de conexiones de 64 bits a SAP BW para universos .unv, con sulte Conexiones de SAP BW [página 129]. Si no se carga el controlador de SAP ERP, consulte Conexiones de SAP ERP - Error de controlador al cargar [página 130]. Soporte de la base de datos de SAP HANA 1.0 SPS 06, consulte Cone xiones SAP HANA [página 130]. Requisitos de seguridad de conexiones de SAP NetWeaver BW, consulte Conexiones de SAP NetWeaver BW [página 137]. cs.cfg, ejemplo de archivo de servidor de conexión en mod o de servi dor, consulte Configurar el modo de despliegue [página 154].
Formato de fecha para usar en consultas a sistemas de SAP ERP, con sulte Tipos de datos de SAP ERP [página 234]. Tipos de datos de SAP HANA y sus equivalentes en infraestr ucturas de datos, consulte Tipos de datos de SAP HANA [página 235]. Plataforma de SAP Busi Noviembre nessObjects Business de 2013 Intelligence 4.1 Paquete de compatibilidad 2
Las conectividades nuevas están disponibles, véase Product Availability Matrix para obtener más información. Actualización de la sección de soporte de Microsoft Windows de 64 bits, consulte Compatibilidad con Microsoft Windows de 64 bits [página 26]. Compatibilidad de la configuración regional en conexiones nativas de universos habilitados para varios orígenes, consulte Establecer la confi guración regional en un flujo de trabajo de varios orígenes de datos [pá gina 65]. Para instalar el controlador Apache Hadoop HIVE después de una actua lización de la plataforma, véase Hacer que las connexiones HIVE funcio nen después de una actualización de plat aforma [página 118].
Manual de acceso a los datos Historial de versiones del documento
Las columnas sinónimas de MS SQL Server a través de OLE DB no se admiten, consulte Conexiones de MS SQL Server [página 121]. Actualización de la sección Oracle Essbase, consulte Conexiones Oracle Essbase [página 126]. Actualización de la sección Conexiones SAP BW, consulte Conexiones de SAP BW [página 129]. Compatibilidad de la base de datos SAP HANA 1.0 SPS 08, consulte Co nexiones SAP HANA [página 130]. Para admitir nuevas funciones analíticas, c onsulte Verificar y añadir compatibilidad de la función analítica a archivos PRM [página 209]. Plataforma de SAP Busi Febrero de nessObjects Business 2014 Intelligence 4.1 Paquete de compatibilidad 3
Las conectividades nuevas están disponibles, véase Product Availability Matrix para obtener más información. Compatibilidad directa para la fuente de datos SQL Server 2014: Middle wares compatibles son ODBC y JDBC (Microsoft ha desaprobado OLE DB) Para añadir un controlador nuevo después de la instalación de revisio nes, consulte Agregar un controlador nuevo después de la instalación de revisiones [página 64] Para obtener información sobre conexiones MySQL - Privilegios de base de datos necesarios para algunos flujos de trabajo en la herramienta de diseño de información, consulte Conexiones MySQL - Privilegios de base de datos necesarios para algunos flujos de trabajo en la herramienta de diseño de información [página 124]
Plataforma de SAP Busi Junio de nessObjects Business 2014 Intelligence 4.1 Paquete de compatibilidad 4
Las conectividades nuevas están disponibles, véase Product Availability Matrix para obtener más información. Para obtener información sobre la nueva función de JVM, consulte Con figuración JVM [página 153].
El Manual de acceso a datos proporciona información sobre la funcionalidad del servidor de conexión y sobre la configuración del servidor de conexión para activar conexiones de la plataforma SAP BusinessObjects Business Intelligence 4.1 Support Package 1 a bases de datos de producción. El Manual de acceso a datos proporciona la siguiente información: ● ●
● ●
Aspectos fundamentales del servidor de conexión Más información sobre los controladores de acceso a datos para orígenes de datos CSV, OData, SAP ERP, y XML Crear una conexión JDBC, ODBC o Javabean Configurar parámetros de acceso a los datos
Nota También proporciona información para configurar algunas conexiones relacionales que se basan en el servicio de federación de datos y las conexiones OLAP.
2.2
Audiencia
El Manual de acceso a datos está dirigido al siguiente público: ● ●
Usuarios de aplicaciones de SAP BusinessObjects que deben crear conexiones a orígenes de datos; administradores de sistemas responsables de configurar, administrar y mantener una instalación de la plataforma de BI.
2.3
Tareas clave
El Manual de acceso a los datos proporciona información importante para administrar parámetros de configuración y establecer conexiones. Para obtener información sobre cada una de las siguientes tareas, consulte la sección correspondiente más abajo: ● ● ● ● ● ●
Cómo establecer el modo de funcionamiento del servidor Cómo seleccionar los controladores que desea cargar Cómo configurar los controladores de acceso a los datos Cómo comprobar la configuración de una conexión Cómo crear conexiones JDBC Cómo crear conexiones SAP HANA
Manual de acceso a los datos Introducción al manual de acceso a datos
Nota Para obtener información sobre tareas administrativas como iniciar y detener el servidor de conexión o administrar propiedades y métricas, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence.
Información relacionada Configurar el modo de despliegue [página 155] Configurar los controladores que se cargarán [página 155] Visualizar y editar archivos SBO [página 170] Ejecutar la herramienta cscheck [página 40] Crear conexiones JDBC [página 50] Conexiones SAP HANA [página 130]
2.4
Convenciones de este manual
En este manual, la variable es la ruta raíz de la instalación para los archivos de acceso a los datos usados por herramientas cliente de SAP BusinessObjects. En Microsoft Windows, el directorio predeterminado representa C:\Archivos de programa\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\dataAccess . La variable es la ruta raíz de la instalación de la plataforma de BI o las herramientas cliente. En MS Windows (64 bits), es el directorio C:\Program Files (x86)\SAP Business Objects\SAP BusinessObjects Enterprise XI 4.0.
Precaución En los archivos de configuración de acceso a los datos, use el signo de omisión \ con la barra invertida \ en las rutas de archivos si implementa la plataforma de BI en Microsoft Windows.
El servidor de conexión es el software de acceso a datos que administra la conexión entre una aplicación de SAP BusinessObjects y un El servidor de conexión permite a las aplicaciones como la herramienta de diseño de universos, la herramienta de diseñador de información y SAP BusinessObjects Web Intelligence conectarse y ejecutar consultas en un origen de datos. El servidor de conexión no dispone de interfaz de usuario. El usuario crea y administra las conexiones desde la interfaz de usuario de estas aplicaciones o mediante la edición de los archivos de configuración del servidor de conexión. ●
Creación de conexiones Puede crear conexiones usando el asistente de conexión de las herramientas de cliente de la plataforma de Business Intelligence.
Nota El asistente de conexión de la herramienta de diseño de universos es el Asistente de nueva conexión. En la herramienta de diseño de información, puede ser tanto el asistente de nueva conexión relacional como el asistente de nueva conexión OLAP. Consulte las guías de usuario de las aplicaciones para obtener información sobre cómo usar el asistente de conexión. ●
Optimización de acceso a datos Optimice el modo en que los datos pasan a través del servidor de conexión modificando los archivos de configuración de acceso a datos. Estos archivos están en formato XML y se instalan junto con el servidor de conexión. Puede establecer valores de parámetros para que se apliquen a un controlador de acceso a los datos específico o a todos los controladores de acceso a los datos instalados.
3.2
Componentes de una conexión
Una conexión de acceso a los datos consta de los componentes siguientes: ●
●
●
El servidor de conexión es el software que administra la conexión entre la aplicación y el origen de datos. El servidor de conexión se encarga, por ejemplo, de las solicitudes de datos procedentes de la aplicación. Un controlador de acceso a los datos es un componente de software específico de base de datos que administra la conexión entre el servidor de conexión y el middleware de base de datos. Los archivos de configuración definen los parámetros para configurar la conexión entre los siguientes sistemas: ○ ○ ○
La aplicación y el servidor de conexión La aplicación y el controlador de acceso a datos El servidor de conexión y el controlador de acceso a datos
Manual de acceso a los datos Introducción al acceso a datos
En el diagrama siguiente se ilustra la posición que ocupan el servidor de conexión y los controladores de acceso a datos en una configuración de SAP BusinessObjects.
3.2.2
Controladores de acceso a datos
Los controladores de acceso a datos conectan Connection Server con un origen de datos. Una base de datos requiere un controlador de acceso a datos para que puedan usarla aplicaciones de SAP BusinessObjects. Las aplicaciones de SAP BusinessObjects incluyen controladores de acceso a datos con los que puede configurar conexiones a sus bases de datos. Los controladores de acceso a datos incluidos en su producto, dependen del tipo de licencia que tenga. Antes de poder crear una conexión de base de datos para la que no tiene un controlador, debe obtener los controladores requeridos. Las siguientes opciones están disponibles para obtener un controlador: ●
●
Póngase en contacto con su representante de SAP para averiguar si hay un c ontrolador disponible y si su licencia le permitirá usarlo. Utilice Driver Development Kit (DDK) para desarrollar un controlador. Si necesita más información, consulte con el representante de SAP.
Al crear una nueva conexión, debe seleccionar el controlador de acceso a datos apropiado para el origen de datos de destino. Si, por ejemplo, accede a una base de datos Oracle 10g, deberá instalar el middleware correspondiente (Oracle 10g Client) y, a continuación, el controlador de acceso a datos para Oracle de SAP BusinessObjects.
Precaución Los controladores de acceso a datos bean de Excel ( bean_excel.jar) y CSV (dbd_open_sample.jar) son muestras de controladores. No debe usarlos tal cual, sino como puntos de partida para desarrollar controladores más complejos mediante el uso de DDK. En SAP Service Marketplace encontrará una lista actualizada de los controladores de acceso a datos compatibles, en http://service.sap.com/bosap-support
. También puede consultar con su representante de SAP.
Para obtener más información sobre DDK, consulte el manual Data Access Driver Java SDK Developer Guide en http://boc.sdn.sap.com
3.3
.
Archivos de configuración de acceso a datos
Los archivos de configuración de acceso a datos se suministran con la instalación de la plataforma de Business Intelligence. Se pueden dividir en los siguientes niveles: ●
●
●
Nivel global El archivo de configuración cs.cfg se aplica a todas las conexiones. Nivel de controlador Los archivos de configuración SBO se aplican a controladores específicos. Conexiones OLAP El archivo de configuración OlapClient.cfg se aplica a las conexiones OLAP para universos .unx.
Además de los archivos de configuración que controlan una conexión, cada controlador de acceso a datos tiene un archivo de configuración PRM asociado. Estos archivos controlan la forma en que una aplicación genera SQL en función de las capacidades del software de la base de datos. Los usan aplicaciones como la herramienta de diseño de información.
Información relacionada Conexiones OLAP [página 23] La capa de acceso a datos permite que la plataforma de BI se conecte a orígenes de datos OLAP. Acerca del archivo de configuración cs.cfg [página 147] Archivos de configuración de acceso a datos [página 166]
Manual de acceso a los datos Introducción al acceso a datos
El archivo de configuración global cs.cfg que utilizan los controladores de acceso a los datos se instala en la siguiente ubicación: ●
\connectionServer
El archivo cs.cfg contiene parámetros que se aplican a todos los controladores de acceso a datos instalados.
Información relacionada Acerca de parámetros globales [página 147]
3.3.2 Acerca de los archivos de configuración de controladores Los archivos de configuración que utilizan los controladores de acceso a datos se instalan en la siguiente ruta: ●
En un sistema Microsoft Windows: \connectionServer\
●
En un sistema UNIX: /connectionServer/
donde es el nombre de la capa de red o el middleware de la base de datos que usa el archivo de configuración. Los archivos que se listan a continuación tienen parámetros que se aplican a controladores de acceso a los datos que están instalados.
.sbo
Sí
oracle.sbo Cada controlador de ac ceso a datos tiene un ar chivo SBO. Define la confi guración de conectividad específica para cada con trolador y cada base de datos de destino.
.prm
Sí
Cada controlador de ac ceso a datos tiene un ar chivo PRM. Define pará metros que afectan a la forma en la que una apli cación genera SQL.
Cada controlador de ac ceso a datos tiene un ar chivo COD. Guarda infor mación relacionada con definiciones de conexión. Define los campos que aparecen al crear una co nexión nueva.
oracleen.cod
Nota No modifique estos ar chivos. .rss
No
Cada controlador de ac ceso a datos tiene un ar chivo RSS. Contiene las sentencias SQL predefini das que usa el servidor de conexión.
.stg
No
El controlador de acceso a oracle.stg datos puede tener un ar chivo de estrategia. Con sulte la referencia del pa rámetro de archivo SBO para más información.
oracle.rss
Información relacionada Descripción de parámetro SBO [página 176] Referencia de la configuración del archivo PRM [página 212] Acerca de los parámetros de función de base de datos [página 207]
3.3.3
Acerca del archivo de configuración OlapClient.cfg
En Microsoft Windows, el archivo OlapClient.cfg se encuentra en la siguiente ubicación: ●
\win32_x86
En el archivo OlapClient.cfg, solo puede configurar parámetros de la sección OlapClient.
Manual de acceso a los datos Introducción al acceso a datos
Información relacionada Activar registros y seguimientos para el cliente OLAP [página 164]
3.4
Modo de despliegue
El Servidor de conexión se puede ejecutar en los modos de despliegue siguientes: ●
●
Modo de biblioteca (in-proc) El Servidor de conexión se incluye en el proceso de cliente. La mayoría de aplicaciones de SAP BusinessObjects usan el servidor de conexión en modo de biblioteca. Modo de servidor El Servidor de conexión es un servidor CORBA y se accede a él remotamente. El servidor de conexión sirve a los clientes CORBA y HTTP para responder a los modos de 2 niveles y de nivel web respectivamente.
Consulte el Manual del administrador de la plataforma SAP BusinessObjects Business Intelligence para obtener más información sobre los escenarios de despliegue.
Información relacionada Configurar el modo de despliegue [página 154] Configurar el modo de despliegue [página 155] Configurar los controladores que se cargarán [página 155]
3.5
Servicios de conectividad
Con la instalación predeterminada de la plataforma de Business Intelligence se incluyen tres instancias del servidor de conexión. Estas instancias se agrupan en Servicios de conectividad en la Consola de administración central (CMC). Los servidores del servidor de conexión ofrecen los siguientes servicios: ● ●
Servicio de conectividad nativa (64 bits) Servicio de conectividad nativa (32 bits solo en MS Windows)
El servidor de procesamiento Adaptive aloja el servicio de conectividad Adaptive, que permite que las aplicaciones del usuario accedan de forma remota a orígenes de datos basados en Java. Al iniciarse, los servicios de conectividad informan de la lista de orígenes de datos que admiten en el clúster de la plataforma de Business Intelligence, de modo que las aplicaciones de SAP BusinessObjects pueden detectar y utilizar la instancia del servidor adecuada. Las aplicaciones buscan orígenes de datos mediante el servidor de conexión primero en el modo de biblioteca y, a continuación, en el modo de servidor.
Conexión frente a servicio Cuando se utiliza el servidor de conexión en modo de biblioteca, los controladores de acceso a los datos y el middleware instalados en el equipo local definen la lista de orígenes de datos disponibles. Cuando se utiliza el servidor de conexión en el modo de servidor, la lista de orígenes de datos también incluye los orígenes de datos que admiten las instancias del servidor que se ejecutan en el sistema back-end de la plataforma de Business Intelligence. Cada instancia del servidor admite un subconjunto de los orígenes de datos que admite la capa de acceso a los datos. Estos subconjuntos dependen de los siguientes parámetros: La tecnología de implementación del servidor CS (C++ o Java) El sistema operativo host (versiones de UNIX o MS Windows) Los controladores que puede seleccionar cuando instala la plataforma de BI Los orígenes de datos activos que puede seleccionar para cada instancia del servidor en la CMC
● ● ● ●
La siguiente tabla describe qué tipo de servicio de conectividad puede usar cada tipo de conexión.
Todos los orígenes de da tos nativos de 64 bits
Servicio de conectividad nativa
Admisión de ODBC, OLE DB, OCI, etc.
Todos los orígenes de da tos nativos de 32 bits
Servicio de conectividad nativa
Admisión de orígenes de datos disponibles solo en 32 bits. Este servicio solo está dispo nible en MS Windows.
Orígenes de datos basados Servicio de conectividad de Adap en Java tive
Admisión de todo el middleware basado en Java. Este servicio es una implementación Java basada en el marco de trabajo Platform Java Service (PJS).
Ejemplo ● ● ●
Un origen de datos nativo de 64 bits es una base de datos Oracle mediante Oracle OCI. Un origen de datos nativo de 32 bits es MS Excel 2007 mediante ODBC. Un origen de datos basado en Java es MS SQL Server 2008 R2 mediante JDBC.
3.6
Conexiones OLAP
La capa de acceso a datos permite que la plataforma de BI se conecte a orígenes de datos OLAP. Los universos .unv que se basan en orígenes de datos OLAP utilizan conexiones gestionadas por el servidor de conexión de 32 bits. La versión actual permite a las conexiones de SAP BW usar el servidor de conexión de 32 o de 64 bits. Los universos .unx que se basan en orígenes de datos OLAP utilizan conexiones gestionadas por el componente de cliente OLAP de la plataforma de BI.
Manual de acceso a los datos Introducción al acceso a datos
Para la lista de orígenes de datos OLAP soportados, consulte la matriz de disponibilidad de productos. Para crear conexiones OLAP, véase el Manual de usuario de herramientas de diseño de información.
Información relacionada Compatibilidad con Microsoft Windows de 64 bits [página 26] Conexiones de SAP BW [página 129] La capa de acceso de datos permite a la plataforma de BI acceder al origen de datos de SAP BW.
4 Información específica sobre el acceso a datos 4.1
Compatibilidad con el sistema operativo de 64 bits
SAP BusinessObjects proporciona versiones de la plataforma de BI para los siguientes sistemas operativos: ● ●
versiones de 32 bits de Microsoft Windows versiones de 64 bits de los sistemas Microsoft Windows y UNIX
A continuación, la capa de acceso a datos proporciona controladores de acceso a datos que se pueden ejecutar en un entorno de 32 bits o de 64 bits. En las siguientes secciones se ofrece información sobre lo que esto significa para la compatibilidad del middleware de base de datos en los entornos de 32 bits o 64 bits. Para obtener la lista completa de orígenes de datos compatibles con los sistemas operativos de 64 bits, consulte la matriz de disponibilidad de los productos.
Nota El Kit de desarrollo de controladores proporciona muestras de controladores de acceso a datos que se pueden ejecutar en un entorno de 32 bits o de 64 bits. Para obtener más información sobre DDK, consulte el manual Data Access Driver Java SDK Developer Guide.
4.1.1
Compatibilidad con UNIX de 64 bits
El servidor de conexión se suministra con la plataforma BI y admite la instalación en entornos UNIX de 64 bits como servidor in-proc o servidor remoto.
Precaución Debe asegurarse de instalar el middleware de 64 bits para ejecutar conexiones a bases de datos a través del servidor de conexión. Algunos proveedores no ofrecen middleware de 64 bits para las siguientes bases de datos y capas de red de UNIX. Sólo están disponibles en Microsoft Windows: ● ● ● ● ● ● ● ●
DB2 UDB para iSeries V5 con Client Access AS400 DB2 UDB para iSeries V6 con Client Access AS400 DB2 para i v6.1 con Client Access AS400 DB2 para i v7.1 con Client Access AS400 Origen de datos genéricos a través de OLE DB MS Access 2010 y 2013 a través de ODBC MS Excel 2010 y 2013 a través de ODBC MS SQL Server 2005, 2008 R2 y 2012 a través de OLE DB
Manual de acceso a los datos Información específica sobre el acceso a datos
Recuerde Esta sección solo trata las bases de datos usadas para universos .unv. El servidor de conexión se suministra con la plataforma BI y admite la instalación en entornos MS Windows de 32 bits (como servidor in-proc) y de 64 bits (como servidor in-proc y remoto). Los proveedores no ofrecen middleware de 64 bits para las siguientes bases de datos a través de ODBC en Microsoft Windows: Base de datos Ingres 9 MS Access 2007 y MS Excel 2007 PostgreSQL 8 Archivos de texto Data Federator XI 3.0 Query Server Salesforce.com
● ● ● ● ● ●
Microsoft Windows de 64 bits tampoco admite las siguientes bases de datos OLAP ni su middleware: Base de datos de MS Analysis Services a través de OLE DB para OLAP Oracle Essbase 9 y 11 a través de Oracle Essbase Client
● ●
Para todos estos orígenes de datos, la capa de acceso a datos puede funcionar con middleware de 32 bits en versiones de 64 bits de Microsoft Windows. Esta función se administra a través de un despliegue específico que consta de dos servidores de conexión que se ejecutan al mismo tiempo en modo de servidor. El primero funciona con 32 bits y ejecuta las conexiones a orígenes de datos que no puede administrar el middleware de 64 bits, mientras que el segundo funciona con 64 bits y ejecuta las conexiones al resto de orígenes de datos. Dado que el archivo cs.cfg es común para los dos servidores, ambos comparten la misma configuración.
Restricción Debido a esta arquitectura, no es posible ejecutar el mismo controlador de acceso a datos en los dos servidores. Sin embargo, se puede establecer una conexión de ODBC genérica en el servidor de conexión de 32 bits o en el servidor de conexión de 64 bits, pero no en ambos al mismo tiempo.
Información relacionada Conexiones Oracle Essbase [página 126] La capa de acceso de datos permite a la plataforma de BI acceder al origen de datos de Oracle Essbase. Conexiones de SAP BW [página 129] La capa de acceso de datos permite a la plataforma de BI acceder al origen de datos de SAP BW. Array Fetch Size [página 178]
Para las instalaciones de la herramienta de diseño de información y de la herramienta de diseño de universos en un sistema operativo Windows de 32 bits, los controladores de los orígenes de datos ODBC que se deben crear, probar y acceder en la herramienta se deben definir con el administrador de origen de datos ODBC que se puede encontrar en la siguiente ubicación del equipo físico en la que está instalada la herramienta: ●
C:\Windows\System32\odbcad32.exe
Para las instalaciones de la herramienta de diseño de información o de la herramienta de diseño de universos en un sistema operativo Windows de 64 bits, los controladores de los orígenes de datos ODBC que se deben crear, probar y acceder en la herramienta se deben definir con la versión de 32 bits del administrador de origen de datos ODBC que se puede encontrar en la siguiente ubicación del equipo físico en el que está instalada la herramienta: ●
C:\Windows\SysWOW64\odbcad32.exe
Para la herramienta de diseño de información, los orígenes de datos ODBC que deben usar los componentes del servidor se definen con el administrador de origen de datos ODBC que se puede encontrar en la siguiente ubicación del equipo físico en el que están instalados los componentes del servidor: ●
●
Versión de 64 bits: C:\Windows\System32\odbcad32.exe (Recomendada para usarla cuando exista middleware de bases de datos de 64 bits.) Versión de 32 bits: C:\Windows\SysWOW64\odbcad32.exe (Úsela cuando solo exista middleware de bases de datos de 32 bits.)
Nota Si la herramienta de diseño de información o la herramienta de diseño de universos usa el DSN de ODBC para orígenes de datos de universos, se deben crear DSN con los mismos nombres en el equipo físico en el que están instalados los componentes de servidor para las aplicaciones de generación de informes de SAP BusinessObjects que usan los universos publicados. Para obtener información, consulte el Manual de instalación de la plataforma SAP BusinessObjects Business Intelligence
4.2
Soporte de inicio de sesión único
La plataforma de BI proporciona autenticación para inicio de sesión único (SSO) cuando se instala en las siguientes plataformas y con las conectividades que se señalan a continuación:
MS Analysis Services en Microsoft Windows
Windows AD con Kerberos proporciona el inicio de sesión único a la plataforma de BI.
MS SQL Server a través de ODBC u OLE DB en Microsoft Windows
Windows AD con Kerberos proporciona el inicio de sesión único a la plataforma de BI.
Manual de acceso a los datos Información específica sobre el acceso a datos
LDAP proporciona el inicio de sesión único a la plataforma de BI.
Oracle EBS a través de OCI en todas las plataformas
Para activar el inicio de sesión único, se debe instalar y configurar el complemento de autenticación que se suministra con la plataforma. Los usuarios se registran en la plataforma de Business Intelligence desde una aplicación de SAP BusinessObjects usando sus credenciales de EBS (nombre de usuario y contraseña).
SAP BW a través de OLAP BAPI en todas las plataformas
El inicio de sesión único se activa instalando y configurando la autenticación SAP. Los usuarios se registran en la plataforma de Business Intelligence desde una aplicación de SAP BusinessObjects usando sus credenciales de SAP BW.
Sistemas SAP ERP a través de conectividad SAP Java (JCo) 3.x en todas las plataformas
El inicio de sesión único se activa instalando y configurando la autenticación SAP. Los usuarios se registran en la plataforma de Business Intelligence desde una aplicación de SAP BusinessObjects usando sus credenciales de SAP ERP.
Base de datos de SAP HANA 1.0 SPS 08 a través de ODBC, JDBC en todas las plataformas y OLAP en Microsoft Windows, Linux y AIX
El SSO proporcionado es SSO a la base de datos y usa Windows AD con Kerberos (en ODBC, JDBC y OLAP) o el protocolo SAML (en JDBC y OLAP). Los usuarios se registran en la plataforma de Business Intelligence desde una aplicación de SAP BusinessObjects usando sus credenciales de Windows AD.
Base de datos Sybase IQ mediante ODBC en Microsoft Windows
Windows AD con Kerberos proporciona el inicio de sesión único a la plataforma de BI.
Teradata 13 y Teradata 14 mediante ODBC en Microsoft Windows
Windows AD con Kerberos proporciona el inicio de sesión único a la plataforma de BI.
Para obtener más información sobre SSO, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence.
Información relacionada Conexiones Oracle EBS [página 125] Controlador de SAP ERP [página 86] Conexiones SAP HANA [página 130]
El servidor de conexión puede administrar datos de orígenes de datos resultantes de una consulta SQL o la ejecución de un procedimiento almacenado. Los procedimientos almacenados son secuencias de comandos SQL que están almacenadas como código ejecutable en un SGBDR. Pueden recibir argumentos y devolver datos. En la plataforma de Business Intelligence se admiten procedimientos almacenados para las siguientes capas de red y bases de datos: ● ● ● ●
● ●
●
DB2 UDB e iSeries a través del controlador CLI Sybase Adaptive Server a través de CTLIB Javabean DB2 UDB, Derby, HSQL DB, Informix, MS SQL Server, MySQL 5, Oracle, SAP HANA y Sybase, todos a través de JDBC Oracle a través de OCI DB2 iSeries, Informix, MS SQL Server, SAP HANA, Sybase ASIQ, Sybase SQL Anywhere, y Teradata (solo macros) todos a través de ODBC MS SQL Server a través de OLE DB
4.3.1
Capacidades admitidas de la base de datos
El servidor de conexión sólo admite procedimientos almacenados que devuelven datos como conjuntos de resultados, es decir, en forma de tablas. Esto significa que el procedimiento almacenado no puede devolver números enteros, cadenas ni cursores y debe contener siempre sentencias SELECT. Además, los procedimientos almacenados admitidos no pueden contener parámetros OUT o IN/OUT, solo parámetros IN. Asimismo, las sentencias COMPUTE, PRINT, OUTPUT o STATUS que se encuentran en procedimientos almacenados no se ejecutan.
Precaución Estas restricciones no son válidas para procedimientos almacenados de Oracle. Consulte la siguiente sección para obtener información sobre los procedimientos almacenados de Oracle admitidos. El Servidor de conexión admite los procedimientos almacenados de Oracle dentro de un paquete. El nombre del paquete se devuelve como el nombre del catálogo. El comportamiento es válido para las capas de red de Oracle CI y de JDBC. Para obtener más información acerca del uso de procedimientos almacenados, consulte el manual del usuario de la herramienta de diseño de universos.
4.3.2
Procedimientos almacenados de Oracle
Los procedimientos almacenados de Oracle son los siguientes:
Manual de acceso a los datos Información específica sobre el acceso a datos
Cualquier procedimiento PL/SQL que devuelva conjuntos de resultados mediante REF Cursor Procedimientos PL/SQL almacenados que tengan como mínimo un parámetro de variable de cursor IN/OUT REF y ningún parámetro OUT
● ●
Nota Los demás parámetros de cursor IN/OUT del procedimiento se omiten. Los procedimientos almacenados de Oracle que no se admiten son los siguientes: ●
● ● ●
●
Cualquier procedimiento PL/SQL que no devuelva conjuntos de resultados mediante un parámetro REF CURSOR Cualquier procedimiento PL/SQL que contenga al menos un parámetro OUT Cualquier función PL/SQL Cualquier procedimiento PL/SQL que tenga un parámetro IN/OUT de un tipo distinto al de REF CURSOR, por ejemplo, VARRAY Cualquier función de tabla PL/SQL
Para acceder a los procedimientos almacenados de Oracle, deberá realizar varias tareas en el servidor para permitir que la plataforma de BI se conecte a un procedimiento almacenado. Estas tareas se explican en las siguientes secciones.
4.3.3
Crear un cursor dentro de un paquete
En bases de datos de Oracle, un paquete es un objeto de base de datos que contiene tipos, objetos y subprogramas relacionados con PL/SQL. En primer lugar debe crear un cursor dentro de un paquete antes de crear un procedimiento almacenado de Oracle usando el cursor definido. En el sistema de administración de base de datos de Oracle, use el siguiente enunciado: CREATE or REPLACE PACKAGE catalog_data AS TYPE CatCurTyp IS REF CURSOR RETURN all_objects%ROWTYPE; END catalog_data;
La plataforma de BI no admite procedimientos almacenados empaquetados, solo procedimientos independientes.
4.3.4
Crear un procedimiento almacenado de Oracle
En el siguiente procedimiento, use el cursor catcurtyp que previamente se ha creado en el paquete y catalog_data.catcurtyp. Realice una de las siguientes acciones: a) Escriba el siguiente enunciado: CREATE or REPLACE PROCEDURE get_allobjects(cat_cv IN OUT catalog_data.catcurtyp) AS BEGIN
b) Escriba el siguiente enunciado con diversos parámetros: CREATE or REPLACE PROCEDURE get_ownerobjects(owner_name IN varchar2, cat_cv IN OUT catalog_data.catcurtyp) AS BEGIN OPEN cat_cv FOR SELECT * FROM all_objects WHERE owner=owner_name; END;
Para obtener más información sobre la creación de paquetes y procedimientos almacenados, consulte la documentación de Oracle.
4.3.5
Procedimientos almacenados de SAP HANA
El servidor de conexión admite procedimientos almacenados SAP HANA mediante JDBC y ODBC. Crea procedimientos SAP HANA almacenados con la sintaxis siguiente: CREATE PROCEDURE {LANGUAGE } {SQL SECURITY } {READS SQL DATA {WITH RESULT VIEW }} AS BEGIN select ... from ; END LANGUAGE, SQL SECURITY y READS SQL DATA no son obligatorios. El idioma predeterminado es SQLScript. Consulte el Manual SQLScript de base de datos de SAP HANA para obtener más información.
Ejemplo Procedimiento almacenado simple: CREATE PROCEDURE Proc LANGUAGE SQLSCRIPT READS SQL DATA AS BEGIN select * from CUSTOMER; END
Procedimiento almacenado con una vista de resultados y de parámetros: CREATE PROCEDURE ProcWithResultView(IN id int) LANGUAGE SQLSCRIPT READS SQL DATA WITH RESULT VIEW ProcView AS BEGIN select * from CUSTOMER where CUST_ID = :id; END
4.3.6
Macros Teradata
El Servidor de conexión solo admite las macros de Teradata si la conexión establecida usa ODBC.
Manual de acceso a los datos Información específica sobre el acceso a datos
Precaución No admite los procedimientos almacenados de Teradata en ODBC, ya que los procedimientos almacenados no devuelven ningún conjunto de datos. Tampoco admite macros o procedimientos almacenados en JDBC. Crea macros de Teradata con la sintaxis siguiente: create macro as (select * from ;);
Para obtener más información, consulte la documentación de Teradata.
Ejemplo Macro simple: create macro GUEST95 as (select * from guest where TYear='FY95';);
Macro con un parámetro: create macro MGUESTIN (inyear VARCHAR(12)) as (select * from GUEST where TYear=:inyear;);
Macro con varios conjuntos de resultados: create macro MGUEST as ( select * from guest where TYear='FY95'; select count(*) from guest; );
4.4
Grupos de conexiones
Los controladores abren una conexión en la base de datos para acceder a los datos. A c ontinuación se indican dos métodos para conectarse a una base de datos: Cada vez que el servidor de conexión requiere información, el controlador de acceso a datos abre una conexión a la base de datos, recupera los datos y después cierra la conexión. El servidor de conexión mantiene las conexiones disponibles abiertas y mantiene sus detalles en un grupo de conexiones. Cada vez que el servidor de conexión requiere información del origen de datos, el controlador de acceso a datos consulta el grupo de conexiones para ver si contiene una conexión adecuada que no se esté usando. Si existe una conexión disponible, la usa. Si todas las conexiones están en uso, el servidor de conexión crea una conexión y la agrega al grupo. Este método usa los recursos del sistema más eficientemente.
●
●
Recuerde Servidor de conexión no agrega una conexión que utiliza el inicio de sesión único al conjunto.
Las conexiones que están disponibles en el grupo de conexiones pueden ser exclusivas o compartibles. ●
●
Las conexiones exclusivas sólo pueden asignarse a un usuario a la vez. Cuando se asigna una conexión exclusiva, deja de estar disponible en el grupo. No puede asignarse a otro solicitante. Cuando la conexión deja de ser necesaria, el controlador personalizado la libera de modo que pueda reasignarse. Las conexiones compartibles pueden asignarse a varios usuarios a la vez. Cuando una conexión se asigna, permanece en el grupo para que esté disponible para otros solicitantes.
Puede seleccionar si crear una conexión exclusiva o compartible con el parámetro Modo de conjunto de conexiones del asistente de conexiones.
Información relacionada Connection Shareable [página 195] Shared Connection [página 197] Max Pool Time [página 150]
4.4.2
Modo de conjunto de conexiones
Desconectar después de cada transacción
Se desconecta de la base de datos después que se haya completado una consulta. La próxima vez que se ejecute una consulta, se crea de nuevo la conexión.
Mantenga la conexión activa para
Esta es la opción de conjunto de conexiones. Si se ha completado una consulta antes del tiempo especificado en el Tiempo de espera de grupo (10 minutos es el valor por defecto), se puede reutilizar la conexión. Todos los usuarios comparten la conexión.
Mantener la conexión activa durante toda la sesión (sólo
La conexión finaliza cuando el usuario cierra la aplicación. Esta opción no usa el conjunto de conexiones.
modo local)
Escoger el modo de conjunto de conexiones El modo de conjunto de conexiones puede depender de la disponibilidad de recursos de su máquina. ● ●
Si la memoria está baja, seleccione la opción Desconectar después de cada transacción. Si la memoria está elevada y el rendimiento es crítico, seleccione la opción Mantener la conexión activa durante toda la sesión (solo modo local).
Manual de acceso a los datos Información específica sobre el acceso a datos
Para controlar el comportamiento de manera más precisa, seleccione la opción Mantener la conexión activa durante.
●
4.4.3
Comprobar conjunto de conexiones de middleware
Los middlewares de origen de datos a menudo proporcionan su propio mecanismo de conjunto de conexiones. Tiene que asegurarse de que la configuración del conjunto de conexiones de middleware sea compatible con el conjunto en la herramienta de diseño para obtener el rendimiento de conexión que espera.
4.5
Balanceo de carga
En el modo de servidor, puede ejecutar varias instancias del servidor de conexión en la plataforma de Business Intelligence. El servidor de conexión implementa un mecanismo de equilibrio de carga en este modo de despliegue. Se usa para elegir el mejor servidor en cuanto a recursos que puedan admitir nuevas solicitudes de cliente. El equilibro de carga ayuda a enfrentarse a los problemas de ampliación; para ello, aumenta el número de instancias de servidor de la plataforma de Business Intelligence.
Precaución Este mecanismo de equilibrio de carga es diferente al equilibrio de carga que el servidor de administración central implementa. El equilibrio de carga se realiza en los niveles siguientes: Proxys de cliente en un despliegue de 2 niveles, en el nivel de cliente Puentes de servidor en un despliegue de nivel Web, en el nivel Web
● ●
El Servidor de conexión también proporciona un mecanismo de consulta de nivel de aplicación, que le ayuda a elegir la instancia de servidor correcta para un trabajo. El servidor de conexión enlaza al cliente con el servidor adecuado, en función del tipo de origen de datos que solicite el cliente y según el par de capa de red y base de datos que el servidor admita.
Recuerde El equilibrio de carga se realiza después de la búsqueda, y está disponible en todas las plataformas.
4.5.1
Encontrar el mejor servidor
Los problemas de escalabilidad del servidor de conexión se pueden derivar de los siguientes factores: ●
Los problemas relacionados con el número de conexiones a bases de datos abiertas ya los gestiona el mecanismo del conjunto de conexiones. La CPU que usa el servidor de conexiones Es posible que el servidor de conexiones use una cantidad considerable de CPU al convertir datos o al escribir y devolver al cliente búferes de respuesta de gran tamaño. Pero el servidor de conexiones no utiliza una gran cantidad de CPU. El número de tareas en ejecución El número de tareas que se ejecutan en un servidor aumenta su carga de trabajo. La cantidad de memoria que asignó el servidor de conexiones o el middleware que la incrusta La cantidad de memoria usada depende de las consultas SQL ejecutadas. Por ejemplo, es posible que una única instrucción SQL para una tabla de gran tamaño tenga un mayor impacto en la escalabilidad que una serie de consultas SQL pequeñas.
El servidor de conexiones implementa el equilibrio de carga con la ayuda del indicador más relevante de la carga de trabajo del servidor, en este caso, la cantidad de memoria asignada. Cuanto menos memoria use un servidor de conexiones, en mejor estado se encuentra.
Nota Es posible que el servidor de conexiones utilice asimismo una serie de tareas como indicador de estado en versiones posteriores. La siguiente fórmula calcula el ESTADO del servidor: HEALTH = (available memory / max memory) * constant
donde: ●
●
●
La memoria máxima es la cantidad máxima de memoria asignable, por ejemplo, 2 GB en una plataforma de MS Windows de 32 bit La memoria disponible es la diferencia entre la memoria máxima y la cantidad actual de memoria asignada La constante es el ESTADO máximo (establecido en 10000 para el servidor de conexión).
4.5.2
Lógica de equilibrio de carga
Cada servidor candidato informa de su ESTADO al equilibrador de carga. Un servidor candidato es un servidor de conexiones que admite la capa de red solicitada y el par de bases de datos. Suponiendo que todas las instancias del servidor admiten el mismo conjunto de orígenes de datos, existen candidatos potenciales para atender a la solicitud del cliente. El equilibrador de carga determina el servidor al que se le envía la solicitud del cliente al identificar y clasificar el conjunto de servidores en mejor estado. A continuación, identifica cuál de ellos es el mejor servidor. Si este conjunto solamente contiene un servidor, este se convertirá en el servidor de destino. El ESTADO se actualizará durante el ciclo de vida del servidor. HEALTH se vuelve a calcular cuando se realiza una de las siguientes operaciones: ● ●
Una tarea se crea o se destruye Una tarea se prepara o se ejecuta
Manual de acceso a los datos Información específica sobre el acceso a datos
El mecanismo de equilibrio de carga es compatible con todas las plataformas a partir de la versión de la plataforma de Business Intelligence de SAP BusinessObjects 4.0 Feature Pack 3. Se admite la compatibilidad con versiones anteriores en el caso de despliegues incrementales o de actualizaciones limitadas de versiones previas. Cualquier servidor que no informa del ESTADO al equilibrador de carga se considera que está en buen estado, es decir, en el estado máximo.
Nota El equilibrio de carga también está disponible en ciertas plataformas en paquetes de servicios de versiones anteriores. Póngase en contacto con el representante de SAP para obtener más información.
4.6
Asignación de memoria
El servicio de conectividad nativo puede usar la funcionalidad de asignación de memoria HOARD en los equipos que tengan instalado el sistema operativo MS Windows de 64 bits. HOARD es un asignador de memoria optimizado y ampliable destinado a los componentes C++, y el cual permite que el servicio tenga un mejor rendimiento, una mejor capacidad de ampliación y menos fragmentación de memoria. La capa Acceso a datos proporciona los siguiente binarios: ●
ConnectionServer.exe, que es el binario predeterminado. HOARD no está activado.
●
ConnectionServerOptimized.exe, que es el binario con HOARD activado
4.6.1
Activar HOARD
Abra la CMC. En Servicios de conectividad, detenga el servicio de conectividad nativa que aloja el servidor de ConnectionServer. Busque el archivo ejecutable del Servidor de conexión. \win64_x64. Se encuentra en el directorio
Haga una copia de seguridad del archivo ConnectionServer.exe. Cambie el nombre de ConnectionServerOptimized.exe a ConnectionServer.exe. Reinicie el servicio. Ya ha activado HOARD en el servicio de conectividad nativa.
Abra la CMC. En Servicios de conectividad, detenga el servicio de conectividad nativa que aloja el servidor de ConnectionServer. Restaure el archivo ConnectionServer.exe predeterminado. Reinicie el servicio desde la CMC. Ya ha desactivado HOARD en el servicio de conectividad nativa.
4.7
Actividad en la estación de trabajo CA Wily Introscope
La actividad de flujo de trabajo relacionados con el servidor de conexión se registra en la estación de trabajo de CA Wily Introscope. Las funciones del servidor de conexión se pueden analizar mediante las diferentes vistas propuestas por la herramienta, que son las siguientes: ● ● ●
Cuadro de mandos y vista de resumen para la información general Vista de registro, donde los errores se resaltan y se describen en mensajes La vista de árbol, donde se muestran las sucesivas llamadas de funciones de un flujo de trabajo concreto y se resalta el tiempo invertido en una función para seguir fácilmente las actividades que tardan mucho tiempo
Para obtener más información, consulte el Manual del administrador de la plataforma SAP BusinessObjects Business Intelligence.
Información relacionada Establecer la Máquina virtual de Java para la instrumentación con las conexiones de SAP HANA [página 136]
Manual de acceso a los datos Información específica sobre el acceso a datos
En esta sección se describen los requisitos para crear una conexión. Asegúrese de que su plataforma se ajusta a las plataformas compatibles con las conexiones SAP. Asegúrese de que el middleware de base de datos está correctamente instalado y de que puede acceder a la base de datos a través del equipo o de un servidor. Asegúrese de que dispone de toda la información necesaria para acceder a la base de datos, por ejemplo, el nombre de inicio de sesión y la contraseña de la base de datos. Instale la solución SAP BusinessObjects que utilizará, incluido el controlador de acceso a datos apropiado. Compruebe que todos los servicios se han iniciado correctamente. Consulte el aviso Léame incluido con la solución SAP BusinessObjects para comprobar cualquier cambio de configuración que el entorno o el software puedan requerir. Consulte el aviso de la versión de acceso a datos actual para comprobar cualquier cambio de configuración que pudiera afectar al entorno.
● ●
●
● ● ●
●
Nota La herramienta cscheck se puede utilizar para comprobar la infraestructura y determinar si es adecuada para su uso con las aplicaciones de SAP BusinessObjects.
Información relacionada Comprobación de configuración de conexión [página 38]
5.2
Comprobación de configuración de conexión
El software del servidor de conexión incluye una utilidad de línea de comandos que permite comprobar la infraestructura de la conexión al origen de datos. Puede utilizar la herramienta cscheck para comprobar en cualquier momento el middleware cliente y los controladores de acceso a los datos instalados.
Nota Los resultados de todas las comprobaciones se aplican al equipo local en el que se ejecuta la herramienta. \ La herramienta cscheck está instalada en el donde es el directorio de instalación de BOE y es win32x_86, win64_x64, etc.
La herramienta cscheck se ejecuta desde una consola de comandos (DOS o shell). La salida se muestra en pantalla. Puede especificar que la salida se genere en formato XML, o bien puede omitir la salida para usar la herramienta en una secuencia de comandos. La herramienta cscheck permite realizar las siguientes funciones en el equipo local: ●
● ● ●
●
●
Devolver detalles de todas las conectividades, es decir, las capas de red y las bases de datos que la instalación puede soportar Devolver detalles de los controladores de acceso a los datos que están instalados en el equipo local Devolver detalles de las conectividades que están instaladas en el equipo local Comprobar si existe una instalación válida de middleware para una capa de red y un cliente de base de datos proporcionados Comprobar si existe una instalación válida del controlador de acceso a datos para una capa de red y un cliente de base de datos proporcionados Comprobar si se puede establecer una conexión a una base de datos concreta
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40]
5.2.1
Mostrar ayuda sobre la herramienta cscheck
La herramienta cscheck proporciona funcionalidad para las siguientes acciones: ● ●
Mostrar ayuda general sobre la utilidad cscheck Mostrar ayuda sobre cada una de las funciones de cscheck disponibles
La ayuda se puede mostrar en los idiomas seleccionados al instalar la solución SAP BusinessObjects. Para mostrar ayuda general sobre cscheck, use la siguiente sintaxis: cscheck --help|h --language|l { idioma }
Para mostrar ayuda sobre una función, use la siguiente sintaxis, donde es el nombre de la función para la que se precisa ayuda, e es el idioma en el que se mostrará la ayuda: cscheck --help|h { nombreFunción } --language|l { idioma }
Ejemplo Para mostrar ayuda en inglés sobre la herramienta cscheck, use el siguiente comando: cscheck --help
Para mostrar ayuda en francés sobre la función connectivity, use el siguiente comando: cscheck --language fr --help connectivity
La herramienta cscheck se puede ejecutar en cualquier momento tras la instalación de la solución SAP BusinessObjects. Abra una consola de comandos. Cambie el directorio a la ruta de acceso en la que se encuentra instalada la herramienta. Introduzca cscheck con los parámetros correctos para encontrar la información deseada. Revise la información que se devuelve.
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40]
5.2.3 Herramienta de comprobación: introducción a las funciones Desde una consola de comandos, utilice el comando cscheck con la función apropiada y sus argumentos para devolver los resultados que desee. Los comandos de cscheck tienen la siguiente estructura. Algunos de los parámetros son opcionales. cscheck --language|l { idioma de salida } --xml|x --mute|m nombre de la función opciones de la función
La primera parte del comando controla el formato de la salida: ●
●
●
o l seguido del idioma especificado en la norma ISO639-1. Esto es opcional. El idioma
predeterminado es el inglés. --xml o x especifica que la salida tiene el formato XML. Esto es opcional. La salida predeterminada es el texto que se muestra en pantalla. --mute indica que no se genere la salida. Debería usar esta opción si emplea la herramienta en una secuencia de comandos que comprueba el estado devuelto. Esto es opcional. El valor predeterminado es que se genere la salida.
La parte restante del comando se compone de la función y de sus argumentos de opciones. puede tomar los valores siguientes. Cada función tiene un formato abreviado que se
puede usar en lugar del nombre de función completo: ●
Información relacionada Herramienta de comprobación—accessdriver [página 45] Herramienta de comprobación—conectividad [página 46] Herramienta de comprobación—driverssearch [página 42] Herramienta de comprobación—buscar [página 43] Herramienta de comprobación— lista [página 41] Herramienta de comprobación—middleware [página 44] Herramienta de comprobación— ping [página 48]
5.2.4
Herramienta de comprobación— lista
Sintaxis Esta función devuelve una lista de los niveles de red y los motores de base de datos soportados. Por ejemplo, podría usarla para determinar los valores correctos que deben usarse c on otras funciones de la herramienta de comprobación.
Nota Esta función devuelve la lista completa de controladores de acceso a los datos y middleware admitidos, incluso los que no están necesariamente instalados en el equipo.
cscheck |list||lt|
Ejemplo El siguiente comando muestra una lista de todas las capas de red y los motores de base de datos admitidos por la solución SAP BusinessObjects instalada en el equipo actual. cscheck list
A continuación se ofrece un extracto de la lista de resultados: Oracle Client Oracle 10 Oracle 11 Sybase Open Client Sybase Adaptive Server 15.5 Informix ODBC Driver Informix Dynamic Server 11 Teradata ODBC Driver Teradata 12 Teradata 13 Teradata 14
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Mostrar ayuda sobre la herramienta cscheck [página 39]
5.2.5
Herramienta de comprobación—driverssearch
Sintaxis Esta función devuelve una lista de los controladores de acceso a datos instalados. cscheck |driverssearch||ds|
Ejemplo El siguiente comando muestra una lista de todos los controladores de acceso a datos instalados en el equipo. cscheck driverssearch
A continuación se ofrece un extracto de la lista de resultados: This access driver is installed: Oracle OCI access driver Client layer: Oracle Client Database engine(s): Oracle 10 Oracle 11 This access driver is installed: Sybase Open Client access driver Client layer: Sybase Open Client Database engine(s): Sybase Adaptive Server 15.5 This access driver is installed: Informix ODBC access driver Client layer: Informix ODBC Driver Database engine(s): Informix Dynamic Server 11 This access driver is installed: Teradata ODBC access driver Client layer: Teradata ODBC Driver Database engine(s): Teradata 12 Teradata 13 Teradata 14 ...
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Mostrar ayuda sobre la herramienta cscheck [página 39]
5.2.6
Herramienta de comprobación—buscar
Sintaxis Esta función muestra una lista de los tipos de conectividad disponibles, es decir, el middleware y los clientes de base de datos que están disponibles en el equipo local. Esto incluye: ● ● ● ●
tipos de conectividad disponibles en el equipo local tipos de conectividad disponibles que emplean la capa de comunicación CORBA tipos de conectividad disponibles que emplean la capa de comunicación HTTP Tipos de conectividad Java disponibles en el equipo local
cscheck |find||fd| -m { Modo de acceso al servidor de conexión } Tabla 1: Parámetros de entrada de la función
Modo de acceso al servidor de conexión (-m)
Modo en el que la aplicación cliente accede al servidor de conexión: ●
●
●
●
●
local: muestra una lista de los tipos de conecti
vidad disponibles en el equipo local. corba: muestra una lista de los tipos de conecti vidad disponibles que emplean CORBA. http: muestra una lista de los tipos de conectivi dad disponibles que emplean HTTP. java: muestra una lista de los tipos de conectivi dad Java disponibles en el equipo local. extended: enumera los tipos de conectividad lo cal, java y CORBA.
Ejemplo El siguiente comando devuelve una lista de los controladores de acceso a datos disponibles en el equipo local y que el servidor de conexión puede cargar. cscheck find –m local
A continuación se ofrece un extracto de la lista de resultados: Local Library Mode IBM DB2 Client
DB2 10 for LUW DB2 10 for z/OS DB2 for i v6 DB2 for i v7 DB2 for z/OS v9 DB2 UDB for iSeries v5 DB2 v9 Essbase Provider Hyperion Essbase 7 Hyperion Essbase 9 Informix ODBC Driver Informix Dynamic Server 11 ODBC Drivers Generic ODBC datasource Generic ODBC3 datasource MS SQL Server 2008 MS SQL Server 2012 Sybase SQL Anywhere 10 ...
Ejemplo El siguiente comando devuelve una lista de los controladores de acceso a datos disponibles en un servidor CORBA. cscheck find –m corba
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Mostrar ayuda sobre la herramienta cscheck [página 39] Comprobar herramienta—Información CMS [página 49]
5.2.7
Herramienta de comprobación—middleware
Sintaxis Esta función comprueba si existe una instalación válida del middleware cliente, tanto para el nivel de red como para el cliente de base de datos proporcionados. Para comprobar tanto el middleware como el controlador de acceso a datos de un nivel de red y un cliente de base de datos dados, utilice la función connectivity. cscheck |middleware| |mw| -c { nivel de red } -d { cliente de base de datos } Tabla 2: Parámetros de entrada de la función
Nivel de red ( -c )
Nivel de red que usa el middleware de la base de da tos, tal como lo devuelve la función find.
Base de datos que se comprueba, tal como la de vuelve la función find.
Ejemplo El siguiente comando comprueba si existe una instalación válida del middleware de Oracle Client 10g en el equipo local. Crea un archivo XML de la salida: c:\result.xml cscheck --xml middleware -c "Oracle Client" -d "Oracle 9" > c:\result.xml
Si el middleware no está instalado correctamente, el resultado será el siguiente: Starting to check the middleware component installation... Begin AND operator... ORACLE_HOME... The environment setting does not exist. End AND operator: failure. The middleware is not correctly installed.
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Mostrar ayuda sobre la herramienta cscheck [página 39] Herramienta de comprobación—conectividad [página 46] Herramienta de comprobación—accessdriver [página 45]
5.2.8
Herramienta de comprobación—accessdriver
Sintaxis Esta función comprueba si existe una instalación válida de un controlador de acceso a datos, tanto para el nivel de red como para el cliente de base de datos proporcionados. Para comprobar tanto el middleware como el controlador de acceso a datos de un nivel de red y un cliente de base de datos dados, utilice la función connectivity. cscheck |accessdriver| |ad| -c { nivel de red } -d { cliente de base de datos } Tabla 3: Parámetros de entrada de la función
Nivel de red ( -c )
Nivel de red que usa el middleware de la base de da tos, tal como lo devuelve la función find.
Cliente de base de datos (-d)
Base de datos que se comprueba, tal como la de vuelve la función find.
Ejemplo El siguiente comando comprueba si existe una instalación válida de un controlador de acceso a datos de Oracle 10 y muestra la salida en francés: cscheck -l fr accessdriver -c "Oracle Client" -d "Oracle 10"
Si el idioma francés no está instalado, el resultado será el siguiente: The language specified is not installed. Please use an installed language. English ([en]).
Ejemplo El siguiente comando comprueba si existe una instalación válida de un controlador de acceso a datos de Oracle 10: cscheck ad -c "Oracle Client" -d "Oracle 10"
El resultado es el siguiente: Starting to check the access driver component installation... Begin AND operator... Config Directory... success. %SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success. Directory... success. / /connectionServer//oracle... success. Library... success. / /connectionServer//libdbd_oci10.so... success. / /connectionServer//libdbd_oci11.so... success. Data File Name... success. / /connectionServer//oracle/oracle.sbo... success. End AND operator: success. The access driver is installed.
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Mostrar ayuda sobre la herramienta cscheck [página 39] Herramienta de comprobación— lista [página 41]
5.2.9
Herramienta de comprobación—conectividad
Sintaxis Esta función comprueba que el middleware instalado y el controlador de acceso a datos son válidos, tanto para el nivel de red como para el cliente de base de datos proporcionados.
Puede comprobar cada elemento de manera individual mediante el empleo de las funciones middleware y accessdriver. Puede usar la función ping para comprobar si puede conectarse a una base de datos concreta. cscheck |connectivity| |ct| -c { nivel de red } -d { cliente de base de datos } Tabla 4: Parámetros de entrada de la función
Nivel de red ( -c )
Nivel de red que usa el middleware de la base de da tos, tal como lo devuelve la función find.
Cliente de base de datos (-d)
Base de datos que se comprueba, tal como la de vuelve la función find.
Ejemplo El siguiente comando comprueba el middleware del cliente Oracle instalado y el controlador de acceso a datos de Oracle 10. El comando escribe la salida en un archivo de texto: c:\result.txt . cscheck -l en connectivity -c "Oracle Client" -d "Oracle 10">c:\result.txt
Si el middleware no está instalado correctamente, el resultado será el siguiente: Starting to check the middleware component installation... Begin AND operator... ORACLE_HOME... The environment setting does not exist. End AND operator: failure. The middleware is not correctly installed. Starting to check the access driver component installation... Begin AND operator... Config Directory... success. %SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success. Directory... success. / /connectionServer//oracle... success. Library... success. / /connectionServer//libdbd_oci10.so... success. / /connectionServer//libdbd_oci11.so... success. Data File Name... success. / /connectionServer//oracle/oracle.sbo... success. End AND operator: success. The access driver is installed.
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Mostrar ayuda sobre la herramienta cscheck [página 39] Herramienta de comprobación—buscar [página 43] Herramienta de comprobación—accessdriver [página 45] Herramienta de comprobación—middleware [página 44] Herramienta de comprobación— ping [página 48]
5.2.10 Herramienta de comprobación— ping Sintaxis Esta función intenta tener acceso a una base de datos concreta con los detalles que se proporcionen. cscheck ping|pg| -m { Modo de acceso al servidor de conexión } -c { nivel de red } -d { cliente de base de datos } -u { nombre de usuario } -p { contraseña } -s { origen de datos } -t { base de datos } -r { nombre de host } -j { PID } Tabla 5: Parámetros de entrada de la función
Modo de acceso al servidor de conexión <(-m)>
Modo en el que la aplicación cliente accede al servidor de conexión: ●
●
●
●
local: El servidor de conexión se ejecuta en el
equipo local. corba: El servidor de conexión se ejecuta en un servidor CORBA. http: El Servidor de conexión se ejecuta en un servidor HTTP. java: El servidor de conexión usa un controlador de acceso a datos Java en el equipo local.
Nivel de red ( -c )
Middleware de base de datos para el que se com prueba la conexión, tal como se devuelve con la fun ción find.
Cliente de base de datos (-d)
Tipo de base de datos, tal como se devuelve con la función find.
nombre de usuario (-u)
Nombre de usuario válido para la base de datos.
contraseña (-p)
La contraseña para el nombre de usuario.
Fuente de datos (-s)
Servidor en el que se ejecuta la base de datos.
base de datos (-t)
Servidor de la base de datos.
nombre de host (-r)
Para el modo CORBA, equipo que aloja al servidor de conexión.
PID (-i)
Para el modo CORBA, el número de proceso del servi dor de conexión a través del cual se realiza el sondeo.
Ejemplo El siguiente comando comprueba el acceso para:
Modo de acceso al servidor de conexión: local, es decir, la base de datos se ejecuta en el equipo local. Nivel de red: Cliente Oracle Base de datos: Oracle 10g Origen de datos: Harlaxton Nombre de usuario: efashion Contraseña: X2345
Ejemplo El siguiente comando comprueba el acceso para: ●
● ● ● ● ● ● ●
Modo de acceso al servidor de conexión: CORBA, es decir, el servidor de conexión se ejecuta en un servidor CORBA. Nivel de red: Sybase Nombre de usuario: sysadmin Contraseña: contraseña Origen de datos: Sybase Adaptive Server 15 Base de datos: SY1 Host de base de datos: sybasehost ID de proceso: 456
Información relacionada Herramienta de comprobación: introducción a las funciones [página 40] Herramienta de comprobación—buscar [página 43] Comprobar herramienta—Información CMS [página 49]
5.2.11
Comprobar herramienta—Información CMS
Sintaxis Los parámetros siguientes le permiten especificar la información CMS que puede usar con la función encontrar o ping de la herramienta cscheck. cscheck--ce_cluster{ Servidor CMS } --ce_user { Nombre de usuario } --ce_pass { Contraseña } -ce_auth { Autenticación } find-mcorba
El método utilizado para autenticar las credenciales de inicio de sesión del usuario al acceder a CMS.
Ejemplo El siguiente comando devuelve una lista de conexiones que se almacenan en CMS y que están disponibles usando CORBA. cscheck --ce_cluster localhost --ce_user Administrador --ce_pass Password1 --ce_auth SecEnterprise find -m corba
Recuerde Se tiene que ubicar el parámetro antes de la función de encontrar o ping en la línea de comando. Son todos obligatorios.
Información relacionada Herramienta de comprobación—buscar [página 43] Herramienta de comprobación— ping [página 48]
5.3
Crear conexiones JDBC
Durante la instalación de la plataforma de BI se instala un conjunto de controladores de acceso a datos. Puede usar esos controladores de acceso a datos para crear conexiones a bases de datos. Se encuentran en el directorio \connectionServer\drivers\java.
Nota La conectividad de JDBC está disponible para SAP BusinessObjects Enterprise XI 3.0 y superior. El Cliente enriquecido de Web Intelligence es compatible con la conectividad de JDBC en modo de 3 niveles en la plataforma de Business Intelligence de SAP BusinessObjects 4.0 y superior. El software de SAP BusinessObjects incluye también archivos de configuración para usar controladores JDBC para acceder a sus bases de datos. Para usar estos controladores, necesita: Obtener el software de controlador Java a través del proveedor de su base de datos.
Indicar las rutas de los archivos JAR de cualquiera de estas maneras: Defina el elemento ClassPath en el archivo de configuración SBO del controlador de acceso a datos con la ruta completa del archivo JAR. Almacene los archivos JAR en los directorios que cree desde los valores del parámetro Extensions del archivo SBO.
○
○
Puede usar simultáneamente estas dos maneras para especificar las rutas de los archivos JAR. Sin embargo, los archivos JAR especificados en el archivo SBO tendrán preferencia sobre los archivos JAR almacenados en sus propios directorios.
Nota SAP Visual Intelligence permite que los usuarios seleccionen archivos JAR directamente desde la c asilla de creación de conexiones de la aplicación. Consulte el Manual de usuario de SAP Visual Intelligence para obtener más información. En el sitio web de SAP Service Marketplace encontrará una lista actualizada de los controladores compatibles, en http://service.sap.com/bosap-support
o puede consultar con su representante de SAP.
Nota La capa Acceso a los datos proporciona la conectividad de ODBC genérico para crear una conexión a un origen de datos que la plataforma de BI no admite explícitamente.
Información relacionada Crear una conexión JDBC con el archivo SBO [página 51] Crear una conexión JDBC con extensiones [página 53] Crear una conexión de JDBC genérico [página 54] Propiedades del controlador de JDBC [página 172]
5.3.1 ●
●
Crear una conexión JDBC con el archivo SBO
Obtenga el software de controlador JDBC requerido para la base de datos y copie los archivos a su sistema. Estos archivos están disponibles en el proveedor de base de datos. El software de controlador suele estar compuesto de uno o varios archivos .jar. Preste atención a los detalles de la ruta de instalación de estos archivos. Asegúrese de que tiene disponibles los detalles de acceso a la base de datos (por ejemplo, los datos de inicio de sesión y la contraseña). Vaya al directorio que contiene el archivo SBO que desea usar. Por ejemplo, en Microsoft Windows, los archivos de configuración JDBC se encuentran en el directorio \connectionServer\jdbc. Use un editor de XML para abrir y editar el archivo SBO.
Agregue los detalles de archivo .jar requeridos al área ClassPath. Al especificar estos archivos debe incluir la ruta completa, por ejemplo: C:\\JDBC Drivers\\MSSQLSERVER2008\\msutil.jar
Nota Los archivos deben instalarse en el equipo en que se ejecuta la aplicación. Compruebe que la ruta del controlador JDBC sea correcta. Localice el parámetro Driver Capabilities y asegúrese de que está configurado como Procedure, Queries o ambos.
Nota Si están definidos los dos valores, las configuraciones se separan mediante una coma.
Precaución Si no está definido ninguno de estos valores, el controlador JDBC no estará disponible desde el asistente de conexión. Guarde y cierre el archivo SBO. Ejecute el asistente de conexión. El controlador JDBC que ha configurado aparece en la lista de conexiones disponibles. Seleccione el controlador JDBC y use el asistente para configurar la conexión. Cuando se complete esta tarea, la conexión estará disponible para usar.
Información relacionada Requisitos de conexión [página 38] Archivos de configuración de acceso a datos [página 166]
5.3.2
Ejemplo de estructura de archivos de JDBC SBO
Aquí se ofrece un ejemplo de la sección del archivo sqlsrv.sbo que debe modificar. Este archivo SBO es para Microsoft SQL Server 2008. ... C:\\JDBC Drivers\\MSSQLSERVER2008\\msbase.jarC:\JDBC Drivers\MSSQLSERVER2008\\msutil.jarC:\\JDBC Drivers\\MSSQLSERVER2008\\mssqlserver.jar ...
Obtenga el software de controlador JDBC requerido para la base de datos y copie los archivos a su sistema. Estos archivos están disponibles en el proveedor de base de datos. El software de controlador suele estar compuesto de uno o varios archivos JAR. Asegúrese de que tiene disponibles los detalles de acceso a la base de datos (por ejemplo, los datos de inicio de sesión y la contraseña). Vaya a la siguiente sección de la guía para encontrar los valores del parámetro Extensions. Use uno o varios valores del parámetro Extensions para crear sus propios directorios de controlador. Por ejemplo, los valores de parámetro Extensiones para el middleware MS SQL Server 2008 son sqlsrv2008, sqlsrv y jdbc del archivo sqlsrv.sbo. Puede crear cualquiera de los siguientes directorios: ○
\connectionServer\jdbc\drivers\sqlsrv2008
○
\connectionServer\jdbc\drivers\sqlsrv
○
\connectionServer\jdbc\drivers\jdbc
Copie los archivos JAR en los directorios que desee. Ejecute el asistente de conexión. El controlador JDBC que ha configurado aparece en la lista de conexiones disponibles. Seleccione el controlador JDBC y use el asistente para configurar la conexión. Para cargar los controladores JDBC, el servidor de conexión busca todos los archivos JAR en los directorios, desde el más específico hasta el menos específico, hasta que los encuentra. A continuación, la conexión quedará disponible para su uso.
Ejemplo Por ejemplo, si almacena los archivos JAR únicamente en \connectionServer\jdbc\drivers\sqlsrv, el servidor de conexión busca primero los controladores en el directorio sqlsrv2008. Si está vacío, busca en el directorio sqlsrv. Si encuentra los archivos JAR carga el controlador.
Nota Debido a que sqlsrv es un valor Extensiones para todas las bases de datos objetivo de MS SQL Server, los archivos JAR especificados en este directorio se cargan para todas las bases de datos de MS SQL Server.
Información relacionada Crear una conexión JDBC con el archivo SBO [página 51]
Archivos de configuración de acceso a datos [página 166]
5.3.4
Crear una conexión de JDBC genérico
Obtenga el software de controlador JDBC necesario para la base de datos. El archivo .jar debe instalarse en el equipo en que se ejecuta la aplicación de SAP BusinessObjects. Tenga preparados los datos de acceso a la base de datos (por ejemplo, los datos de inicio de sesión y la contraseña).
●
●
Desplácese al directorio que contiene los archivos jdbc.sbo y jdbc.prm. Por ejemplo, en Microsoft Windows, los archivos de configuración se encuentran en el directorio \connectionServer\jdbc. Copie el archivo .jar necesario en el directorio \connectionServer\jdbc\drivers\jdbc. Si no existe, debe crear el directorio. Ejecute el asistente de conexión. El controlador JDBC aparece en la lista de conexiones disponibles en Genérico. Seleccione el controlador JDBC y use el asistente para configurar la conexión con los detalles siguientes: ○ ○ ○ ○
URL de JDBC clase JDBC nombre de usuario password
Cuando se complete esta tarea, la conexión con el origen de datos estará disponible para usar mediante JDBC.
Nota El archivo jdbc.prm sólo contiene información sobre las funciones genéricas de una base de datos JDBC. Puede agregar o actualizar cualquier información que sea específica de una base de datos personalizada del archivo. Las modificaciones que se hagan al archivo jdbc.prm se aplican a todas las conexiones JDBC genéricas que se creen o se vayan a crear.
Información relacionada Archivos de configuración de acceso a datos [página 166] Acerca de los archivos PRM [página 207]
La siguiente tabla describe los nombres de las carpetas donde debe ubicar los archivos JAR del middleware para habilitar las conexiones JDBC. La primera columna indica los nombres de proveedores de contenido de bases de datos, como se muestran en el asistente de conexión. La segunda columna indica los nombres de las bases de datos que admiten las conexiones JDBC, como se describe en la sección DataBase del archivo SBO correspondiente. La tercera columna indica los nombres de las carpetas que puede crear, como describen los valores del parámetro Extensions del archivo SBO. El parámetro Extensions es un elemento secundario del elemento DataBase que corresponde al middleware de la base de datos objetivo en los archivos SBO. Si no se encuentra en la sección DataBase, significa que el valor de parámetro es válido para todos los middleware configurados en el archivo SBO. A continuación, consulte la sección Predeterminados del archivo. En MS Windows, los archivos de configuración JDBC se encuentran en el \connectionServer\jdbc. directorio
Nota Los controladores JDBC de Data Federator se instalan como parte de la plataforma de Business Intelligence en \connectionServer\jdbc\drivers\datafederator. el directorio Los controladores JDBC de SAP HANA 1.0 SPS 08 se instalan en el directorio ninguna configuración adicional para crear una conexión a la base de datos SAP HANA o Data Federator XI 3.0 Query Server.
Información relacionada Conexiones SAP HANA [página 130] Acerca de las conexiones del servidor de consultas Data Federator XI 3.0 [página 140]
5.3.6
Para encontrar la versión de un controlador JDBC
Esta sección describe cómo buscar la versión del controlador en su conexión JDBC. Puede encontrar la versión del controlador JDBC utilizada en el archivo META-INF/MANIFEST.MF contenido en el archivo JAR del controlador. Realice una de las siguientes acciones: Inicie la aplicación WinRAR. Arrastre el archivo JAR y suéltelo en la ventana de aplicación. Expanda la carpeta META-INF . Arrastre el archivo MANIFEST.MF de WinRAR y suéltelo en una carpeta local. Abra el archivo y ubique el valor de Versión de paquete. Abra una petición de comando. Vaya a la carpeta donde debe extraer el archivo:
Abra el archivo y ubique el valor de Versión de paquete. Por ejemplo, ejecute los comandos siguientes para recuperar la versión del controlador JDBC de SAP HANA.
cd C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\dataAccess\connectionServer\jdbc\drivers\newdb "C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win64_x64\jdk\bin\jar.exe" -xf ngdbc.jar METAINF/MANIFEST.MF
Nota Escriba el directorio del archivo JAR entre comillas dobles si contiene espacios.
5.4
Crear conexiones JavaBean
Durante la instalación de la plataforma de BI se instala un controlador de acceso a datos que usa JavaBean. Se \connectionServer\drivers\java\. encuentra en el directorio Los desarrolladores también pueden crear objetos JavaBean para proporcionar acceso a los orígenes de datos. Es posible crear conexiones mediante estos objetos Javabean. Para crear una conexión JavaBeans, los desarrolladores que creen el objeto JavaBean suministrarán la información siguiente: Los archivos JAR requeridos Cualquier otro archivo que requiera JavaBean Cualquier detalle de configuración específico que requiera el controlador JavaBean
● ● ●
Al igual que sucede con las conexiones JDBC, puede crear una conexión JavaBean usando la función Extensiones.
Nota Dentro de un controlador JavaBean, los procedimientos de recuperación de datos se configuran como procedimientos almacenados. Al crear una conexión JavaBean a través del asistente de conexión, debe seleccionar Filtrar niveles de red de procedimientos almacenados en la pantalla Selección del middleware de la base de datos. De lo contrario, el asistente de conexión no mostrará los controladores de objetos JavaBean que haya disponibles.
Información relacionada Crear conexiones JDBC [página 50] Crear una conexión JavaBean [página 59] Crear una conexión JavaBean con extensiones [página 60]
5.4.1
Crear una conexión JavaBean
Use un editor de XML para abrir y editar el archivo javabean.sbo. Por ejemplo, en Microsoft Windows, los archivos de configuración se encuentran en el directorio Agregue los detalles de archivo .jar requeridos al área ClassPath. Al especificar estos archivos debe incluir la ruta completa.
Nota Los archivos deben instalarse en el equipo en que se ejecut a la aplicación de SAP BusinessObjects. Para obtener más información, consulte la sección de ejemplo de estructura de archivos javabean.sbo. Guarde y cierre el archivo. Realice otras tareas de configuración especificadas por el desarrollador de JavaBeans. Ejecute el asistente de conexión. El origen de datos JavaBeans que ha configurado aparecerá en la lista de conexiones disponibles. Seleccione el origen de datos JavaBeans y utilice el asistente para configurar la conexión. Cuando se complete esta tarea, la conexión estará disponible para usar con la aplicación.
Información relacionada Archivos de configuración de acceso a datos [página 166]
5.4.2
Ejemplo de estructura de archivos de JavaBean SBO
Esta sección contiene un ejemplo de archivo JavaBeans SBO. $ROOT$\\beans\\bean_excel.jarcom.businessobjects.beans.excel.Excel Parameter> $DATASOURCE$
Desplácese al directorio que contiene el archivo javabean.sbo. Por ejemplo, en Microsoft Windows, el archivo se e ncuentra en el directorio Abra el archivo SBO para visualizarlo. Localice el elemento en la sección Defaults.
Nota Si desarrolla un controlador JavaBean usando el DDK, localice el parámetro Extensions en el elemento . Use uno o varios valores del parámetro Extensions para crear sus propios directorios de controlador. Por ejemplo, supongamos que el valor del parámetro Extensions es javabean en la sección Defaults del archivo. Entonces, puede crear el directorio \connectionServer\javabean\drivers\javabean. Copie los archivos JAR en los directorios que desee. Cierre el archivo SBO. Ejecute el asistente de conexión. El controlador JavaBean que ha configurado aparece en la lista de conexiones disponibles. Seleccione el controlador JavaBean y use el asistente para configurar la conexión. Para cargar controladores JavaBean, el servidor de conexión busca archivos JAR en cada directorio desde el más específico al menos específico, hasta que los encuentra. A continuación, la conexión quedará disponible para su uso.
Información relacionada Crear una conexión JavaBean [página 59] Archivos de configuración de acceso a datos [página 166]
Durante la instalación de la plataforma de BI se instala un conjunto de controladores de acceso a datos. Puede usar esos controladores de acceso a datos para crear conexiones a bases de datos. Se encuentran en el directorio \connectionServer\drivers\lib32 o \connectionServer\drivers\lib64. connectionserver> El software de SAP BusinessObjects incluye también archivos de configuración para usar controladores ODBC para acceder a sus bases de datos. Para usar estos controladores, necesita: Obtener el software de controlador ODBC a través del proveedor de su base de datos. Modificar los archivos de configuración suministrados. La mayoría de controladores ODBC están disponibles en Unicode y no Unicode. En SAP Service Marketplace encontrará una lista actualizada de los controladores ODCB compatibles, en http:// service.sap.com/bosap-support
. También puede consultar con su representante de SAP.
Nota La capa Acceso a los datos proporciona la conectividad de ODBC genérico para crear una conexión a un origen de datos que la plataforma SAP BusinessObjects Business Intelligence no admite explícitamente.
Acerca de las conexiones de ODBC genérico en UNIX El sistema operativo Microsoft Windows incluye un administrador de controladores ODBC estándar. En cambio, UNIX no proporciona ningún método estándar para administrar los controladores. El software de SAP BusinessObjects permite usar los administradores de controladores DataDirect o unixODBC para las conexiones de ODBC genérico en UNIX. Antes de crear una conexión de ODBC genérico en UNIX para una base de datos específica, debe identificar lo siguiente: ● ●
La versión del controlador ODBC Si el controlador puede funcionar con el administrador de controladores DataDirect o unixODBC
A continuación, modifique los archivos de configuración proporcionados y configure los orígenes de datos pertinentes para activar la conexión.
Información relacionada Crear una conexión de ODBC genérico [página 62] Crear una conexión de ODBC3 genérico [página 63]
El siguiente procedimiento indica cómo configurar una conexión de ODBC genérico con una base de datos con los siguientes supuestos: ● ●
El controlador es ODBC2. El controlador admite el administrador de controladores unixODBC. Desplácese al directorio que contiene los archivos odbc.sbo y odbc.prm. / Los archivos de configuración se encuentran en el directorio connectionServer/odbc.
Use un editor de XML para abrir y editar el archivo odbc.sbo. Localice la siguiente sección: ... dbd_wddodbcdbd_ddodbcdatadirect ...
Comente las dos primeras filas para DataDirect y elimine el comentario de una de las dos filas siguientes. Asegúrese de que coloca la fila de la que elimine el comentario en la parte superior de la sección, de forma que se pueda leer en primer lugar. Comente el elemento .
Nota ○
dbd_wddodbc especifica el controlador Unicode ODBC2 basado en DataDirect.
○
dbd_ddodbc especifica el controlador no Unicode ODBC2 basado en DataDirect.
○
dbd_wuxodbc especifica el controlador Unicode ODBC2 basado en unixODBC.
○
dbd_uxodbc especifica el controlador no Unicode ODBC2 basado en unixODBC.
Guarde y cierre el archivo odbc.sbo. Use un editor de XML para abrir y editar el archivo odbc.prm. Agregue o actualice cualquier información específica de la base de datos.
Nota Puede que el archivo odbc.prm no contenga información sobre las funciones específicas de la base de datos. Guarde y cierre el archivo odbc.prm. Instale los controladores ODBC relevantes en el equipo de UNIX. Configure el origen de datos editando el archivo odbc.ini. Guarde y cierre el archivo odbc.ini.
Ejecute el asistente de conexión. El controlador ODBC que ha configurado aparece en la lista de conexiones disponibles en Genérico. Seleccione el controlador ODBC y use el asistente para configurar la conexión. Cuando finalice esta tarea, la conexión con el origen de datos estará disponible para usarla mediante ODBC genérico con el administrador de controladores unixODBC.
Información relacionada Archivos de configuración de acceso a datos [página 166]
5.5.2
Crear una conexión de ODBC3 genérico
El siguiente procedimiento indica cómo configurar una conexión de ODBC genérico con una base de datos con los siguientes supuestos: ● ●
El controlador es ODBC3. El controlador admite el administrador de controladores unixODBC. Desplácese al directorio que contiene los archivos odbc.sbo y odbc.prm. / Los archivos de configuración se encuentran en el directorio connectionServer/odbc.
Use un editor de XML para abrir y editar el archivo odbc.sbo. Localice la siguiente sección: ... dbd_wddodbc3dbd_ddodbc3datadirect ...
Comente las dos primeras filas para DataDirect y elimine el comentario de una de las cuatro filas siguientes. Asegúrese de que coloca la fila de la que elimine el comentario en la parte superior de la sección, de forma que se pueda leer en primer lugar. Comente el elemento .
Nota ○
dbd_wddodbc3 especifica el controlador Unicode ODBC3 basado en DataDirect.
○
dbd_ddodbc3 especifica el controlador no Unicode ODBC3 basado en DataDirect.
dbd_wuxodbc3 especifica el controlador Unicode ODBC3 basado en unixODBC.
○
dbd_uxodbc3 especifica el controlador no Unicode ODBC3 basado en unixODBC.
○
dbd_wux32odbc3 especifica el controlador Unicode ODBC3 basado en unixODBC con API de 32 bits
○
en lugar de 64 bits (disponible sólo en plataformas de 64 bits). dbd_ux32odbc3 especifica el controlador no Unicode ODBC3 basado en unixODBC con API de 32 bits en lugar de 64 bits (disponible sólo en plataformas de 64 bits).
Guarde y cierre el archivo odbc.sbo. Use un editor de XML para abrir y editar el archivo odbc.prm. Agregue o actualice cualquier información específica de la base de datos.
Nota Puede que el archivo odbc.prm no contenga información sobre las funciones específicas de la base de datos. Guarde y cierre el archivo odbc.prm. Instale los controladores ODBC relevantes en el equipo de UNIX. Configure el origen de datos editando el archivo odbc.ini. Guarde y cierre el archivo odbc.ini. Ejecute el asistente de conexión. El controlador ODBC que ha configurado aparece en la lista de conexiones disponibles en Genérico. Seleccione el controlador ODBC y use el asistente para configurar la conexión. Cuando finalice esta tarea, la conexión con el origen de datos estará disponible para usarla mediante ODBC3 con el administrador de controladores unixODBC.
Información relacionada Archivos de configuración de acceso a datos [página 166]
5.6 Agregar un controlador nuevo después de la instalación de revisiones Debe modificar la instalación de la plataforma de BI manualmente si desea agregar un controlador nuevo. Ha realizado una instalación de revisiones de esta versión a los servidores de la plataforma de BI o herramientas cliente. Una revisión en los servidores de la plataforma de BI o herramientas cliente no instala ninguna función nueva a la instalación existente. Solo actualiza archivos que ya están instalados. Para beneficiarse de un controlador nuevo, debe instalarlo manualmente desde la instalación completa más reciente. En el Panel de control, localice el programa más reciente de instalación completa de la plataforma de BI.
Recuerde No puede realizar el paso siguiente en una actualización del programa de la plataforma. Haga clic con el botón derecho y seleccione Desinstalar/Modificar. En la pantalla Actualización de aplicación del cuadro de diálogo configuración de la plataforma de SAP BusinessObjects BI, seleccione Modificar y haga clic en Siguiente. En la pantalla Seleccionar funciones, seleccione la opción del controlador deseado en Acceso y seguridad a base de datos. Haga clic en Siguiente y termine la instalación. Ha instalado el controlador en la plataforma. You can now create connections to the desired database.
5.7 Establecer la configuración regional en un flujo de trabajo de varios orígenes de datos En las herramientas de diseño y de generación de informes, las consultas de las columnas BigDecimal de un universo habilitado para varios orígenes que se usa en una conexión nativa puede que devuelva un error (java.lang.NumberFormatException). Para evitar este problema, añada el parámetro Configuración regional con los valores de país e idioma adecuados al archivo SBO del controlador de base de datos en el servidor de la plataforma de BIP. El procedimiento usa la configuración regional de francés a modo de ejemplo. Detenga el servicio de conectividad de Adaptive. Abra el archivo SBO para editarlo. \dataAccess\connectionServer Se encuentra en el directorio \ , en el que es por ejemplo db2, odbc, oracle o sybase.
Añada una de las siguientes líneas en la sección Base de datos adecuada: ○
fr
○
fr_FR
Guarde el archivo. Reinicie el servicio y la aplicación. Cuando finaliza esta tarea, las conexiones nativas en un flujo de trabajo de varios orígenes se ejecutan adecuadamente.
6 Documentación del controlador de acceso a datos 6.1
Controladores de acceso a datos
Este capítulo proporciona información detallada en algunos controladores de acceso a datos, lo que habilita conexiones a los orígenes de datos usando documentos OData o XML, y bases de datos específicas como sistemas basados en ABAP y SAP ERP. Principalmente describe las reglas de asignación entre modelos de datos no triviales y el modelo relacional usado en la capa de acceso a datos. Este capítulo se refiere solo a las conexiones que se van a crear en la herramienta de diseño de información.
Información relacionada CSV OpenDriver [página 66] Controlador OData [página 72] Controlador de SAP ERP [página 86] Controlador XML [página 93] Controlador de servicio Web [página 106]
6.2
CSV OpenDriver
La capa Acceso a datos permite que la plataforma de BI se conecte a los archivos CSV (valores separados por comas) a través de la capa de red BusinessObjects OpenConnectivity. Proporciona un controlador de acceso a datos denominado CSV OpenDriver para acceder a los archivos CSV. El asistente de conexión proporciona un flujo de trabajo para introducir la información necesaria para conectarse con archivos CSV. Los orígenes de datos CSV se muestran en Archivos de texto DBMS y BusinessObjects OpenConnectivity NetworkLayer.
Compatibilidad con versiones anteriores La compatibilidad entre la versión SAP BusinessObjects Enterprise XI 3.x y la plataforma SAP BusinessObjects Business Intelligence 4.1 solo es posible para los documentos que se crearan con una conectividad de ODBC.
Cuando, en el Cliente enriquecido de Web Intelligence, un usuario de informes actualiza un documento basado en una conectividad BusinessObjects OpenConnectivity en modo de 3 niveles y creado con la versión XI 3.x, se crea la siguiente excepción: Database error: (CS) "Specified network layer is invalid : BO OC". (IES 10901) (WIS 10901)
Puesto que la conectividad de JDBC en modo de 3 niveles no se admite en las versiones XI 3.x, BusinessObjects OpenConnectivity no se reconoce como una capa de red de acceso a datos cuando el usuario intenta actualizar un documento en la versión 4.1.
6.2.1
Capacidades CSV OpenDriver
Dado que los archivos de texto no realizan operaciones en la base de datos, el controlador de acceso a los datos implementa las siguientes funcionalidades de consulta: ● ●
● ● ●
Operaciones básicas para enunciados SELECT (WHERE, ORDER BY, GROUP BY y AS) Operadores básicos en la cláusula WHERE (=, <>, <, <=, >, >=, BETWEEN, NOT BETWEEN, LIKE, NOT LIKE, IS NULL, IS NOT NULL, AND, OR) Uso de comodines ("?") en la cláusula WHERE Cláusula DISTINCT en enunciados SELECT UNION y UNION ALL
El controlador de acceso a datos también admite las funciones de grupo MIN, MAX, AVG, SUM y COUNT en enunciados SELECT.
Restricciones del controlador El controlador CSV OpenDriver no implementa ninguna funcionalidad para modificar el estado del archivo CSV, como INSERT, UPDATE y ALTER. El controlador de acceso a datos tampoco admite índices ni operaciones JOIN en los archivos CSV.
Información relacionada Disco local usado como caché para clasificar operaciones [página 113] Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas.
6.2.2
CSV OpenDriver: asignación de tablas
El controlador de acceso a datos mostrará a la herramienta de diseño de información los archivos CSV como tablas.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Puede conectarse a varios archivos si el parámetro Ruta de archivo o patrón del asistente de conexión está fijado en un modelo, por ejemplo, informe_*.csv, el cual coincide con archivos como informe_2010-09-22.csv e informe_2010-09-21.csv.
Recuerde No puede conectar varios archivos ubicados en un servidor HTTP. El protocolo HTTP no admite el uso de comodines en los modelos. El controlador aplica uno de los siguientes procesos: Si se selecciona el parámetro Fusionar archivos en uno en el asistente de conexión, todos los archivos CSV se asignan a una única tabla. Se presupone que todos presentan el mismo esquema. Este es el comportamiento predeterminado del controlador de acceso a datos. Si no se selecciona el parámetro, cada archivo CSV se asigna a una tabla diferente.
●
●
Asignar todos los archivos a una tabla El nombre de la tabla corresponde al nombre del modelo, por ejemplo, informe_*.csv. La tabla dispone de una columna adicional llamada archivo de origen, que contiene el nombre del archivo de origen para cada fila de la tabla. Si usa un archivo SQLDDL para proporcionar el esquema, el nombre de la tabla también será el modelo. Si los archivos tienen diferentes nombres de columna, los nombres de columna de la tabla resultante serán los del primer archivo analizado por el controlador, teniendo en cuenta que los archivos se analizan en orden alfabético.
Asignar un archivo a una tabla El nombre de cada tabla corresponde al nombre del fichero de su origen de datos. Si usa un archivo SQLDDL para proporcionar el esquema, el nombre de la tabla en la instrucción CREATE debe ser el nombre del archivo. Con independencia del valor del parámetro, la ruta del archivo se asigna al calificador de la tabla.
Ejemplo Si el archivo informe_1.csv contiene las columnas col1, ... y col10, mientas que el archivo informe_2.csv contiene las columnas column1, ... y column10, las columnas de la tabla resultante son col1, ... y col10.
Ejemplo Si C:\reports\informe_1.csv es el origen de datos, el calificador es C:\reports\ y el nombre de la tabla es informe_1.csv.
Información relacionada Ubicación de archivos CSV [página 69] Detección de esquemas CSV [página 69]
6.2.3
Ubicación de archivos CSV
CSV los archivos que se usan como orígenes de datos pueden ser locales o remotos. Para archivos en sistemas remotos, se admiten los protocolos HTTP, FTP y SMB (también llamado CIFS). La versión actual también admite los protocolos cifrados HTTPS y FTPS basados en un certificado. CSV los archivos se pueden ubicar en el Servidor de administración central (CMS) de la plataforma de BI.
Nota SMB es el protocolo estándar para compartir archivos en MS Windows. Dado que la biblioteca jCIFS proporciona acceso al protocolo, debe instalar el archivo JAR de jCIFS en el directorio del servidor de \connectionServer\sharedLibraries conexiones, es decir \jcifs. La versión para instalar es la 1.3.15 y está disponible en http://jcifs.samba.org/
.
Puede definir si el origen de datos es local o remoto mediante el parámetro Tipo de ubicación del asistente de conexión. Si el origen de datos es remoto, puede ajustar el protocolo empleado utilizando el parámetro Protocolo del asistente. El valor Protocolo debe coincidir con el protocolo especificado en los valores de los parámetros Ruta de archivo o patrón y Archivo esquema.
Ejemplo
●
C:\csv\report.csv o csv/report.csv para un archivo local
●
http://server:8080/path/report.csv para un archivo accesible a través de HTTP
●
ftp://servidor/ruta/ para archivos a los que se puede acceder mediante FTP
●
smb://servidor:puerto/recurso/midirectorio para archivos a los que s e puede acceder mediante
SMB
6.2.4
Detección de esquemas CSV
La capa de acceso a datos proporciona los siguientes métodos para la detección de esquemas de un archivo CSV : ● ● ● ●
Sin detección Detección automática Uso de un archivo de Data Definition Language (DDL) Uso de un archivo SQLDDL
Manual de acceso a los datos Documentación del controlador de acceso a datos
Puede elegir el método que se debe aplicar a los archivos mediante el parámetro Detección de esquemas en el asistente de conexión. Puede proporcionar el esquema con archivos de esquemas (DDL o SQLDDL). Esto puede ser útil para archivos de gran tamaño o complejos. Los archivos se analizan en orden alfabético.
Nota Es posible que en las primeras líneas de un archivo CSV se incluyan comentarios; estos se pueden omitir con el parámetro Número de líneas de comentarios en el inicio en el asistente.
Sin detección El controlador de acceso a datos omite las líneas de comentarios, analiza la primera línea y determina el número de columnas, pero no el tipo de columna. Todos los valores se consideran cadenas y el tamaño de las columnas está fijado en 255 caracteres, cifra que corresponde a la longitud estándar del tipo de datos VARCHAR. Se truncará un valor si excede la cantidad máxima de caracteres. Las columnas pueden contener valores nulos.
Detección automática
Recuerde No puede aplicar este método a archivos CSV con columnas de longitud fija. El controlador de acceso a datos analiza archivos con formato correcto y obtiene la siguiente información: ●
●
●
nombres de columnas En la mayoría de los casos, la primera línea contiene los nombres de columnas. Sin embargo, CSV OpenDriver genera nombres de columna con el formato column_0, column_1, …, column_ . Tipos de columnas El controlador busca tipos de columnas con modelos predefinidos y con las opciones del usuario para tipos de datos numéricos, de fecha y hora. Si una columna contiene valores de diferentes tipos, el controlador considerará los valores de la columna como cadenas. Tamaños de columnas El tamaño de las columnas depende de su tipo. Para valores numéricos, el tamaño de las columnas es la longitud del valor más alto en el rango del tipo. Para los otros valores, el tamaño es la longitud del valor de cadena más largo que se encuentre durante la detección.
Precaución Solo las filas de métricaestablecidas para todopermite al controlador encontrar la cadena más larga. ●
Anulabilidad de columnas La anulabilidad es verdadera si existe un valor nulo en la columna, y falsa, si se han rellenado todos los valores.
A no ser que seleccione todas las filas, debe elegir el número de líneas que el controlador debe analizar ajustando el parámetro Número de filas de métrica en el asistente de conexión. Consulte laGuía del usuario de la herramienta de diseño de información para conocer las recomendaciones.
Uso de archivos DDL En primer lugar, el controlador de acceso a datos analiza el archivo DDL para convertir los tipos de datos SQL en tipos de datos de controlador. El archivo DDL sigue este modelo: ColumnName[:ColumnType[(Length)]];
Por ejemplo: col1:VARCHAR(20); col2:DATE; col3:INTEGER; col4:INTEGER;
El archivo DDL solamente define un esquema de tablas. El controlador asigna el mismo esquema a todos los archivos CSV usados como orígenes de datos.
Uso de archivos SQLDDL En primer lugar, el controlador de acceso a datos analiza el archivo SQLDDL para convertir los tipos de datos SQL en tipos de datos de controlador. El archivo SQLDDL sigue el siguiente modelo: CREATE TABLE ( ( [NOT] NULL,)* ( [NOT] NULL) );
Por ejemplo: CREATE TABLE Clients ( id INTEGER NOT NULL, name CHAR(20) NULL, date DATE NULL, PRIMARY KEY (id) )
El archivo SQLDDL puede definir diversos esquemas de tablas. El controlador puede asignar un esquema a diferentes tablas. El controlador de acceso a datos analiza enunciados CREATE y, en caso de existir otras, las ignora. Si el archivo DDL o SQLDDL no define un tipo de columna, el controlador considera los valores de la columna como cadenas de 255 caracteres. Se truncará un valor si excede la cantidad máxima de caracteres. Si el archivo DDL o SQLDDL proporciona un tipo pero no la longitud, el controlador usará las longitudes estándar, como por ejemplo, 10 para enteros. La precisión y la escala son obligatorias para el tipo de datos DECIMAL.
Manual de acceso a los datos Documentación del controlador de acceso a datos
La capa de acceso a datos permite que la plataforma de BI se conecte a los orígenes de datos que usan el protocolo Open Data (OData). Proporciona un controlador de acceso a datos denominado controlador OData para acceder en línea a los orígenes de datos en Internet o intranets. El controlador OData admite el protocolo OData 2.0, cuyo esquema se describe con el Idioma de definición de esquema conceptual (CSDL) 2.0. El controlador OData permite que la plataforma de BI se conecte a los servicios OData que expone SAP NetWeaver Gateway 2.0. SAP NetWeaver Gateway 2.0 permite a los usuarios de la aplicación a acceder a los datos desde sistemas SAP Business Suite, como por ejemplo ERP y CRM mediante HTTP. El asistente de conexión proporciona un flujo de trabajo para introducir la información necesaria para conectarse con orígenes de datos OData. Los orígenes de datos OData mostrados en Generic OData 2.0 DBMS y OData Connector NetworkLayer. Puede encontrar los archivos de configuración del controlador en el directorio acceso a datos en cuanto a funciones y operaciones de bases de datos.
6.3.1
Capacidades del controlador OData
El controlador de acceso a datos admite las funciones de consulta siguientes: Operaciones de base de datos básicas (SELECT, WHERE, ORDER BY, combinaciones estructuradas) Operadores de filtrado básico en la cláusula WHERE (=, !=, <, <=, >, >=, AND, OR, LIKE, NOT LIKE, BETWEEN, NOT BETWEEN, IS NULL, IS NOT NULL) Consultas anidadas en cláusulas FROM
● ●
●
El controlador de acceso a datos admite las operaciones AS, DISTINCT y GROUP BY, aunque no se pueden expresar en el protocolo OData 2.0. El controlador realiza estas operaciones de forma interna.
Restricción La versión actual del controlador OData no admite las capacidades siguientes: ● ● ● ●
Operaciones UNION y UNION ALL Cláusula HAVING DISTINCT en funciones agregadas Subconsultas en la cláusula WHERE
Funciones de base de datos El controlador de acceso a datos admite las funciones de base de datos AVG, MIN, MAX, y SUM, aunque no se pueden expresar en el protocolo OData 2.0. El controlador realiza estas operaciones de forma interna. El protocolo OData 2.0 solo admite la función COUNT, que se corresponde con el operador $count.
Información relacionada Controlador OData: asignación de claves [página 77] Controlador OData: comportamientos y restricciones no triviales [página 83] Disco local usado como caché para clasificar operaciones [página 113] Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas.
6.3.2
Ubicación del servicio OData
Puede conectarse a servicios OData mediante HTTP. La versión actual también admite los protocolos cifrados HTTPS basados en un certificado.
Ejemplo Los enlaces siguientes hacen referencia a ejemplos de servicios OData mediante HTTP y HTTPS y a un ejemplo de un servicio de SAP NetWeaver Gateway.
Un origen de datos OData expone sus datos según un esquema basado en el modelo de datos de entidad (EDM). El esquema se describe con la ayuda de CSDL. CSDL es un formato XML que describe la estructura y la semántica de esquemas de modelo de datos de entidad. Los ejemplos siguientes ilustran la estructura de un esquema basado en CSDL. Este esquema define metadatos de un origen de datos OData que proporciona el servicio Northwind. El URI del servicio es http:// services.odata.org/Northwind/Northwind.svc/
. Para obtener más información sobre los conceptos que rigen
un modelo de datos de entidad, consulte el CSDL specification
.
Recuerde La versión actual del controlador OData no admite FunctionImports, AnnotationElements, ReferentialConstraints, y propiedades dinámicas.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Puede acceder al esquema desde http://services.odata.org/Northwind/Northwind.svc/$metadata
.
Nota Las propiedades ficticias CustomerClothing ComplexType y CustomerClothes se ha agregado al ejemplo para la documentación. ... ... ... ... ... ... ...
6.3.4 Controlador OData: asignación de área de nombres, propietario y calificador El atributo Espacio de nombres del esquema está asignado al espacio de nombres del modelo. EntityContainer está asignado al calificador de la base de datos. El calificador predeterminado es EntityContainer con el atributo m:IsDefaultEntityContainer establecido en true. Los elementos EntityContainer son secundarios de los elementos de esquema. Dado que los diferentes esquemas pueden contener el mismo EntityContainer, el valor del calificador de base de datos es . . La versión actual del controlador solo expone un propietario, denominado entidades.
Ejemplo El espacio de nombres del servicio Northwind es ODataWeb.Northwind.Model. El calificador de la base de datos del servicio Northwind es ODataWeb.Northwind.Model.NorthwindEntities. El propietario de la base de datos del servicio Northwind es entidades.
6.3.5
Controlador OData: asignación de tablas
El controlador de acceso a datos mostrará a la herramienta de diseño de información los controles OData como tablas. Un EntitySet está asignado a una tabla. El atributo Nombre de EntitySet está asignado al nombre de la tabla. En el esquema OData, AssociationSet vincula dos EntitySets. AssociationSet está asignado a una tabla, si la multiplicidad de los dos EntitySets es *. El atributo Nombre de AssociationSet está asignado al nombre de la tabla. Si como mínimo una de las multiplicidades de EntityTypes es 1 o 0..1, AssociationSet está asignado a una clave externa.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Ejemplo Los siguientes conjuntos de entidad del servicio Northwind están asignados a tablas: ●
Customers
●
Orders
●
Productos
Ejemplo Los siguientes conjuntos de asociación del servicio Northwind también están asignados a tablas: ●
CustomerCustomerDemo
●
EmployeeTerritories
AssociationSet CustomerCustomerDemo está asignado a la tabla CustomerCustomerDemo, porque la aplicación CustomerCustomerDemo vincula los dos EntityTypes CustomerDemographic y Cliente con * multitudes.
Información relacionada Controlador OData: asignación de claves [página 77]
6.3.6
Controlador OData: asignación de columnas
Un EntitySet está definido por un EntityType. Un EntityType consiste de una serie de propiedades. Una propiedad de tipo primitivo se asigna a una columna de la tabla que representa el EntitySet. El atributo Nombre de la propiedad está asignado al nombre de la columna. Una propiedad del tipo complejo se asigna a un conjunto de columnas de tabla. Una columna corresponde a una subpropiedad. El nombre de la columna es la concatenación de los nombres de las propiedades de tipos principales y complejos, separados por una barra ( /). Esta asignación también se aplica a las propiedades anidadas del tipo complejo.
Ejemplo La tabla Pedidos tiene la columna ID de pedido, porque el tipo de entidad Pedido tiene la propiedad ID de pedido.
La tabla Clientes tiene las columnas Dirección, CustomerClothes/Suit y CustomerClothes/Shoes porque: ● ●
La propiedad Dirección del tipo de entidad Cliente tiene un tipo principal. La propiedad CustomerClothes de EntityType Cliente tiene un tipo complejo, realizado con las propiedades de tipo principal Traje y Zapatos.
6.3.7
Controlador OData: asignación de claves
Asignar claves principales La clave de un EntityType está asignada a la clave primaria de la tabla que asigna el EntitySet correspondiente. Pueden ser una o más columnas.
Ejemplo La tabla Clientes tiene una clave principal en la columna CustomerID, porque EntityType Cliente tiene una clave que hace referencia a la propiedad CustomerID.
Asignar claves externas El protocolo OData usa NavigationProperties para exponer las rutas de las combinaciones de un modelo relacional. NavigationProperties usa roles definidos en AssociationSets para vincular EntitySets según su multiplicidad. El controlador OData representa combinaciones bidireccionales como claves externas. Una combinación bidireccional se puede crear entre tablas si EntityTypes de EntitySets que representan estas tablas contienen NavigationProperties que usan el mismo AssociationSet para vincular EntitySets. Esto significa que ambos extremos de un conjunto de asociaciones deben tener propiedades de navegación en ambos tipos de entidad. Las asociaciones que no cumplen esta condición no se exponen como claves externas. Si la multiplicidad de los dos EntitySets es *, el AssociationSet se asigna a la tabla. Si como mínimo una de las multiplicidades de EntityTypes es 1 o 0..1, AssociationSet está asignado a una clave externa en la tabla que representa el EntitySet de la multiplicidad *. El modelo de un nombre de clave externa es -idref .
Recuerde Las claves externas son columnas ocultas de las tablas de infraestructura de datos de forma predeterminada, porque no contienen datos empresariales. Sin embargo, puede mostrarlos editando las propiedades de la tabla y de las columnas. Consulte la Guía del usuario de la herramienta de diseño de información.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Precaución SAP recomienda a los usuarios de la aplicación que no consulten columnas -idref, porque puede reducir el rendimiento del controlador.
Ejemplo La tabla Pedidos tiene las claves externas -idref-Customer-CustomerID, -idref-EmployeeEmployeeID, y -idref-Shipper-ShipperID porque: ●
El tipo de entidad Pedido tiene las siguientes propiedades de navegación. ...
●
Estas propiedades de navegación hacen referencia a las asociaciones FK_Orders_, que vinculan el tipo de entidad Pedido a los tipos de entidades Cliente, Empleado y Transportista. Hay una multiplicidad 0..1 en cada asociación. Esto genera tres claves externas en la tabla que representa el conjunto de entidad Pedidos.
●
CustomerID en -idref-Customer-CustomerID viene de la clave principal de la tabla Clientes.
●
EmployeeID en -idref-Employee-EmployeeID viene de la clave principal de la tabla Empleados.
●
ShipperID en -idref-Shipper-ShipperID viene de la clave principal de la tabla Transportistas.
Ejemplo La tabla CustomerCustomerDemo tiene las claves externas -idref-CustomerDemographicsCustomerTypeID y -idref-Customers-CustomerID porque: ●
EntityType Cliente tiene una NavigationProperty CustomerDemographics. ...
EntityType CustomerDemographic tiene NavigationProperty Clientes. ...
●
NavigationProperties hace referencia a la asociación CustomerCustomerDemo, que vincula los EntityTypes Cliente y CustomerDemographic. Esto genera dos claves externas en la tabla que representa el conjunto de asociación CustomerCustomerDemo.
● ●
CustomerID en -idref-Customers-CustomerID viene de la clave principal de la tabla Clientes. CustomerTypeID en -idref-CustomerDemographics-CustomerTypeID viene de la clave principal de la tabla CustomerDemographics.
6.3.8 Controlador OData: asignación de elementos de documentación Según la disponibilidad, los subelementos Resumen o DescripciónExplicativa de Documentación se asignan a descripciones de entidades de modelos relacionales. Un subelemento de documentación de EntitySet y AssociationSet se muestra como descripción de la tabla en la herramienta de diseño de información. Un subelemento de documentación de propiedad o NavigationProperty se muestra como descripción de la columna. Si no hay resumen o LongDescription, el campo de descripción permanece vacío. Las descripciones no se localizan.
6.3.9 Controlador OData: asignación de entidades de tipos derivados El siguiente ejemplo ilustra un EntitySet del tipo Empleado.
El diagrama siguiente muestra el concepto heredado entre un tipo Empleado base, y dos tipos derivados, EmpleadoExterno y EmpleadoInterno. Los tipos derivados heredados de todas las propiedades de tipo base. También definen propiedades adicionales, que se denominan propiedades directas.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Para un EntitySet específico, el esquema de resultados es el resultado de fusionar a un tipo general. El diagrama siguiente muestra la tabla Empleado tal y como está representada en el modelo relacional.
La tabla Empleado del modelo relacional contendrá información de ambas entidades, es decir, columnas del tipo principal y del tipo derivado. Para evitar nombrar conflictos, las columnas declaradas en tipos derivados están prefijadas con el nombre del tipo de entidad. También pueden contener el valor nulo.
6.3.10 Supervisar el rendimiento del controlador OData Debe considerar los siguientes comportamientos del controlador OData para mejorar el rendimiento de la conexión en la ejecución de consultas.
Ejecutar operaciones en el lado del cliente o del proveedor Al crear una conexión, puede seleccionar si ejecutar algunas operaciones de la consulta SQL a nivel del proveedor o del controlador. La tabla siguiente muestra los parámetros del asistente de conexión que controla su comportamiento. Si se selecciona un parámetro, el proveedor de servicios OData gestiona la operación correspondiente si la admite. Es el comportamiento predeterminado. Si no se selecciona, el controlador OData gestiona la operación.
Precaución SAP recomienda no usar el controlador de acceso a datos para ejecutar estas operaciones, ya que puede reducir el rendimiento de la conexión. El tiempo de respuesta aumenta porque todo el conjunto de datos se debe transferir al cliente. Úselo solo si el proveedor de servicios OData no admite o admite parcialmente la operación.
Selección de columnas
SELECT
Si el parámetro no está seleccionado, el controlador OData gestiona la proyección SQL, que aumenta significativamente el tráfico de datos.
Condiciones de filtro admitidas
WHERE
Puede ejecutar algunas operaciones de filtrado al nivel del controlador si las normas OData no las admiten. Sin embargo, los filtros del pro veedor normalmente reducen el tiempo de ejecución de la consulta. La capa de acceso a datos aplica la lógica siguiente para mejorar el rendimiento: cualquier condición de filtrado compatible con normas OData se impulsa al proveedor OData. El controlador OData ejecuta cualquier otro filtro incompatible que puede contener la cláusula WHERE. Consulte el ejemplo siguiente.
Ordenación
ORDER BY
El proveedor OData ejecuta la operación ORDER BY si no se usa nin guna expresión DISTINCT o GROUP BY en la consulta. Si una consulta contiene una expresión DISTINCT o GROUP BY, el controlador debe realizar la operación de clasificación, lo que aumenta el tiempo de eje cución.
Nota ●
●
●
La operación ORDER BY depende del parámetro SBO Tamaño de particiones de intervalos cuando la ejecuta el controlador. El operador BETWEEN está asignado a funciones de comparación OData y, a continuación, el proveedor OData lo ejecuta. Los operadores LIKE y NOT LIKE se ejecutan normalmente en el cliente. Sin embargo, están traducidos en las funciones OData startsWith y endsWith, si solo un modelo % se encuentra al final o al principio del valor del filtro respectivamente.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Ejemplo La consulta siguiente contiene dos condiciones de filtro en la cláusula WHERE: SELECT * FROM T1 WHERE col1='San Francisco' AND col2 LIKE 'S%n'
El proveedor OData puede manejar la primera parte de la cláusula, pero no la segunda. A continuación, el controlador OData ejecuta col2 LIKE 'S%n', mientras el proveedor ejecuta col1='San Francisco'.
Ejemplo La siguiente consulta SQL devuelve los empleados de ventas que viven en ramblas. SELECT * FROM EMPLOYEES WHERE EMPLOYEES."Title" LIKE 'Sales %' AND EMPLOYEES."Address" LIKE '% Blvd.'
Se corresponde con el URI siguiente: http://services.odata.org/Northwind/Northwind.svc/Employees? $filter=startswith(Title,'Sales')&endswith(Address,'Blvd.')
Ejecutar funciones de agregación La función de la base de datos COUNT es la única función agregada que admite el protocolo OData 2.0. Otras funciones y agrupaciones de agregados activadas por la cláusula GROUP BY se ejecutan en el cliente. Sin embargo, si el controlador realiza cálculos que modifican el resultado antes de que se compute el recuento, la función COUNT también se debe ejecutar en el cliente. Esto puede reducir el rendimiento de la conexión.
Configurar el parámetro de tiempo de espera de conexión Puede escoger el valor del parámetro de Tiempo de espera de conexión en el asistente de conexión para ajustar con precisión el rendimiento del controlador. Especifica el tiempo en segundos en que una conexión está activa en caso de que no haya respuesta del origen de datos. Tiene que escoger el mejor valor de parámetro para el mejor rendimiento. Por ejemplo, si se conecta a un origen de datos con un tiempo de respuesta elevado, puede escoger un valor elevado para el Tiempo de espera de conexión para esperar a la respuesta de servidor y no generar un error demasiado temprano. Si su origen de datos es normalmente rápido, puede escoger un valor bajo y no esperar un error durante demasiado tiempo si el servidor no responde.
Uso de Metamodel en caché El parámetro MetaModel en caché está seleccionado por defecto en el asistente de conexión. Le permite recuperar el modelo de metadatos solo una vez para la duración de la conexión en el grupo de conexiones, en lugar de realizarlo en cada ejecución de consulta. Esto resulta en un aumento del rendimiento de la conexión.
Nota Debe activar el tamaño de conexión si el modelo de metadatos está en caché.
Información relacionada Capacidades del controlador OData [página 72]
6.3.11 Controlador OData: comportamientos y restricciones no triviales Clasificar algoritmos La clasificación de algoritmos puede diferir de un proveedor de servicios a otro. Esto puede originar distintos resultados cuando ORDER BY se usa en la consulta. Dado que el controlador OData debe ejecutar operaciones de clasificación con su propio algoritmo, el uso de operaciones combinadas como por ejemplo ORDER BY, GROUP BY y DISTINCT se debe dirigir a distintos órdenes de clasificación.
Asignar el parámetro Máximo de filas La función OData $top está asignada al parámetro Filas máximas del panel de consultas, solo si las operaciones de consulta no modifican el número de filas. Los resultados de la consulta pueden ser erróneos si se aplica un filtro, lo que elimina filas del resultado esperado $top.
Ejemplo La consulta OData siguiente devuelve las primeras 15 filas de la tabla Clasificaciones: http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15
La consulta siguiente devuelve las primeras 15 filas donde la ciudad de envío es "Reims". Esto solo devuelve 5 filas: http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15&$filter=ShipCity eq 'Reims'
Manual de acceso a los datos Documentación del controlador de acceso a datos
Restricciones de la función COUNT Un recuento de filas en una tabla en la herramienta de diseño de información cuenta filas semánticamente que contienen valores no nulos para las columnas definidas. Algunos servicios de Azure solo devuelven el número total de filas en una tabla. Esto puede provocar discrepancias entre los resultados de consulta esperados y actuales.
Restricciones de los servicios de SAP NetWeaver Gateway So el proveedor de servicios NetWeaver Gateway no admite filtros en todas las columnas, no debe seleccionar Condiciones de filtro admitidas al crear la conexión. Si no admite la clasificación en todas las columnas, no debe seleccionar Clasificar al crear la conexión. El esquema puede indicar estas restricciones de clasificación y filtro c on la ayuda de los metadatos sap:filterable y sap:sortable. En la versión actual, el controlador OData no asigna estos atributos. Puede que algunos proveedores no ofrezcan una capacidad completa de exploración en todas las tablas. Esto puede originar errores del tiempo de ejecución, por ejemplo si una de las tablas involucradas en un SEGUIMIENTO no se puede escanear. SAP recomienda crear conexiones al sistema SAP ERP directamente para evitar problemas con consultas ad hoc.
6.3.12 Controlador OData: configuración del tamaño máximo de columna Para algunas propiedades, el parámetro MaxLength puede tener el valor Max. Por ejemplo:
Dado que el controlador OData no puede reconocer este valor no numérico, se debe configurar. El archivo de configuración cs.cfg proporciona los parámetros siguientes: ●
Longitud máxima binaria para establecer el tamaño máximo de las columnas de la tabla cuyo tipo es
binario ●
Longitud máxima de cadena para establecer el tamaño máximo de las columnas de la tabla cuyo tipo es
cadena
Información relacionada Binary Max Length [página 179] String Max Length [página 190]
6.3.13 Autenticar orígenes OData El acceso a algunos orígenes de datos OData requiere autenticación. Una aplicación puede autenticar un origen de datos OData con los métodos siguientes: ●
●
Autenticación HTTP básica, que usa un nombre de usuario y una contraseña. Las credenciales no están cifradas. Un indicador de acceso GET, es decir, un par {clave, valor} anexado al URI de servicio. La clave y el valor del indicador pueden variar según el servicio. Establezca el identificador a través de parámetros personalizados con Parámetros de autenticación personalizados en el asistente de conexiones. Use el modelo siguiente: <>=<> .
Nota La capa de acceso a datos no proporciona seguimientos para parámetros de autenticación personalizados, porque contienen información de seguridad. Se sustituyen por en los seguimientos del controlador OData. Sin embargo, considere usar niveles de seguimiento como la opción Habilitar seguimiento de tarea en la CMC para mostrar los parámetros.
Autenticar orígenes Microsoft Azure Data Se conecta al conjunto de datos de Microsoft Azure con la autenticación básica HTTP. En el asistente de conexión, introduzca la clave de cuenta como contraseña. Puede dejar el nombre de usuario en blanco.
6.3.14 Realizar el seguimiento de la actividad del controlador OData La capa de acceso a datos sigue el controlador OData con los niveles de seguridad PATH y DEBUG. Los seguimientos de RUTA contienen las entradas y salidas de cada método usado en la ejecución y planificación de consultas. Le permite saber si el controlador OData o el proveedor OData ha ejecutado una operación de consulta y dónde se puede encontrar la causa del problema. La información contenida en el URI (las credenciales del origen de datos, las credenciales del servidor de proxy y los parámetros de autenticación personalizados) está en blanco en los seguimientos del controlador.
Manual de acceso a los datos Documentación del controlador de acceso a datos
La capa Acceso a datos permite que la plataforma de BI se conecte a los sistemas de SAP ERP a través de la capa de red SAP Java Connector (JCo) 3.x. Proporciona un controlador de acceso a datos que permite acceder a los objetos ERP siguientes: ● ● ●
InfoSets Consultas de SAP Funciones ABAP
Para obtener más información sobre los sistemas de SAP ERP admitidos, consulte Product Availability Matrix (Matriz de disponibilidad de los productos). Las conectividades de SAP ERP admiten el inicio de sesión único (SSO por sus siglas en inglés) en todas las plataformas. Para obtener más información sobre la autenticación, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence. Las conectividades de SAP ERP también admiten la configuración regional de visualización preferida (PVL por sus siglas en inglés) para todos los modos de autenticación. Para desactivar el uso de PVL, seleccione Guardar idioma al crear la conexión. Encontrará los archivos de configuración del controlador en el directorio \connectionServer\jco. En el archivo jco.prm se enumeran las funciones del controlador de acceso a datos en cuanto a operaciones de base de datos. El asistente de conexión proporciona un flujo de trabajo para introducir la información necesaria para conectarse con sistemas SAP ERP.
Información relacionada Soporte de inicio de sesión único [página 27]
6.4.1
Capacidades del controlador de SAP ERP
El controlador de acceso a datos admite las funciones de consulta siguientes: ● ●
● ● ● ●
Operaciones básicas (SELECT, WHERE, ORDER BY, GROUP BY y AS) Operadores básicos (=, !=, <, <=, >, >=, BETWEEN, NOT BETWEEN, IN, NOT IN, AND y OR), cuyos operandos pueden ser nombres de columna o valores constantes Cláusula DISTINCT en enunciados SELECT Valores constantes en enunciados SELECT LIKE y NOT LIKE aceptan caracteres de omisión Consultas anidadas en cláusulas FROM
La capa de acceso a datos realiza las operaciones de clasificación manualmente.
Nota El controlador de acceso a datos no permite ordenar las columnas por índice en los enunciados de SQL. La única cláusula válida es ORDER BY con nombres de columna. El parámetro ORDER_BY_SUPPORTS_COLUMN_INDEX está establecido en NO en el archivo jco.prm.
Información relacionada Disco local usado como caché para clasificar operaciones [página 113] Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas. ORDER_BY_SUPPORTS_COLUMN_INDEX [página 220]
6.4.2 SAP
Controlador de SAP ERP: acceso a InfoSets y consultas
Acerca de InfoSets y Consultas de SAP En el sistema SAP ERP, los InfoSets y las consultas SAP están organizados dentro de un área de trabajo local o de un área de trabajo global. El acceso a los objetos incluidos en el área de trabajo local está restringido a su cliente del sistema de SAP ERP, mientras que todos los clientes pueden entrar a los objetos del área de trabajo global. Las consultas de SAP se crean en los grupos de usuarios y pertenece a ellos. Para obtener más información sobre las áreas de trabajo y los grupos de usuarios, consulte la documentación de SAP ERP.
Asignación de objetos El controlador de acceso a datos mostrará a la herramienta de diseño de información los InfoSets y las Consultas de SAP como tablas. Los InfoSets y las Consultas de SAP se componen de una serie de campos asignados a columnas en una tabla. Los campos se usan en enunciados SELECT. A nivel de controlador, las áreas de trabajo están asignadas a c alificadores. El calificador predeterminado se corresponde con el área de trabajo local. Los grupos de usuarios están asignados a los propietarios. A continuación, los grupos de usuarios de un área de trabajo se colocan por debajo de un calificador que representa dicha área de trabajo. Los InfoSets de un área de trabajo se colocan por debajo de un calificador que representa dicha área de trabajo y por debajo de un propietario ficticio denominado INFOSET. Las Consultas de SAP de un área de trabajo se colocan por debajo del calificador que representa dicha área de trabajo. Las Consultas de SAP de un grupo de usuarios se colocan por debajo del propietario que representa dicho grupo de usuarios.
Manual de acceso a los datos Documentación del controlador de acceso a datos
La organización de InfoSet y Consultas de SAP en un área de trabajo se muestra en la siguiente figura:
Los campos se asignan a las columnas de las tablas. Los InfoSets y las Consultas SAP contienen campos que son tanto campos de proyección como de selección. También contienen campos de selección que no se usan para la proyección. Cuando crea una conexión con el asistente de conexión, elije si estos campos de selección se representan como columnas de tabla. El parámetro Asignar campos de selección a columnas de tabla se hace cargo de esta funcionalidad. Si se selecciona, el campo se asigna como columna de entrada opcional. Si no se selecciona, el campo de selección se ignora y no es posible filtrar en este campo.
Nota No hay ninguna asignación específica para los campos de selección obligatoria. El usuario de la aplicación debe consultar estos campos con filtros.
Columnas de entrada Las columnas de entrada de una tabla son columnas en las que se debe señalar una condición de igual (operador =) cuando el usuario de la aplicación consulta la tabla. Solo las condiciones iguales están permitidas en las columnas de entrada. Las condiciones IN están prohibidas. En la herramienta de diseño de información, el usuario puede visualizar las columnas de entrada como obligatorias u opcionales. Las columnas de entrada obligatorias son columnas para las cuales es obligatorio establecer un valor. Las columnas de entrada opcionales son columnas para las cuales no es obligatorio establecer un valor. Si el usuario no establece ningún valor a una columna de entrada opcional de una consulta, el servidor de conexión devuelve una de las siguientes opciones: ● ●
Ningún valor si la columna de entrada opcional no contiene ningún valor predeterminado El valor predeterminado si la columna de entrada opcional contiene un valor predeterminado
Capacidades del controlador Cuando el usuario de la aplicación consulta un InfoSet, se transmiten algunas operaciones de base de datos al sistema de SAP ERP (SELECT, WHERE, ordenación solo con columnas ORDER BY y AS), mientras que otras las gestiona el controlador internamente (otros filtros con WHERE, GROUP BY, DISTINCT y ordenación solo con las funciones agregadas ORDER BY). Cuando el usuario de la aplicación consulta una consulta SAP, algunas operaciones también se transmiten al sistema de ERP. Dichas operaciones son SELECT, WHERE, ORDER BY (solo si la consulta SAP ya contiene la misma ordenación) y AS. Para obtener más información sobre las operaciones que el sistema gestiona directamente, consulte la documentación sobre el sistema de SAP ERP.
6.4.3
Controlador de SAP ERP: acceso a funciones ABAP
Recuerde El controlador de SAP ERP le permite crear conexiones tanto a las funciones ABAP publicadas como a las no publicadas.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Conceptos de la función ABAP Las funciones ABAP están compuestas de una serie de parámetros que pueden ser o bien los parámetros de entrada usados en las llamadas de función o bien los parámetros de salida, que se encuentran en las respuestas de llamada. Según la terminología de SAP, los parámetros de entrada se denominan de "importación", mientras que los parámetros de salida se denominan de "exportación". Algunos parámetros pueden ser tanto de entrada como de salida, por lo que se les denomina "parámetros cambiantes". Además de los parámetros de importación, de exportación y cambiantes, también existen los parámetros de tabla, que se pueden considerar un tipo de parámetros cambiantes. Los parámetros de la función ABAP pueden ser del tipo siguiente: ● ● ●
Campo del tipo de ABAP primitivo Estructura, que es una secuencia de varios campos Tabla, que puede estar formada por campos, estructuras o incluso tablas
Asignación de objetos El controlador de acceso a datos mostrará a la herramienta de diseño de información las funciones ABAP como tablas. Al nivel del controlador, los grupos de la función ABAP se asignan a los propietarios y las funciones ABAP se asignan a un calificador denominado ABAPFunction. Esto quiere decir que cada función ABAP se coloca por debajo de un propietario específico, el cual corresponde a un grupo de funciones dentro del sistema SAP ERP. Los parámetros de importación, cambiantes y de tabla que se usan como entrada se asignan en columnas de entrada. Los parámetros de exportación, cambiantes y de tabla que se usan como salida se asignan en tablas. Las columnas de entrada pueden ser obligatorias u opcionales. La capa Acceso a datos considera estos parámetros como atributos de clave primaria, que no son anulables. El controlador asigna los parámetros de la función ABAP tal y como se indica a continuación: ●
●
●
Los parámetros obligatorios se asignan a las columnas de entrada obligatorias. El usuario debe establecer un valor en esta columna. Los parámetros opcionales que tengan un valor predeterminado se asignan a las columnas de entrada opcionales. El usuario no tiene que establecer un valor en esta columna. El valor que el origen de datos devuelve al servidor de conexión en ese caso es el valor predeterminado. Un parámetro opcional sin ningún valor predeterminado también se asigna a la columna de entrada opcional. El servidor de conexión devuelve los valores siguientes del tipo de datos de cadena, según el tipo SQL de la columna de entrada:
Nota -ID a la tabla, a la que se asigna la función ABAP, y El controlador anexa una columna -IDREF a la tabla si contiene una referencia a otra tabla. otra columna
Cambio de nombre de las columnas Los nombres de las columnas se cambian en el nivel del controlador. En la tabla siguiente se muestran los prefijos que se añaden a las columnas.
Entrada
Importar
-IMPORT_
Entrada
Cambiante
-IMPORT_CH_
Entrada
Tabla
-IMPORT_CH_
Salida
Cambiante
-EXPORT_CH_
Salida
Tabla
-EXPORT_CH_
Nota Cuando un parámetro de tabla de salida (A) está formado por otra tabla (B), la denominación de ambas tablas cambia a -EXPORT_CH_A y -EXPORT_CH_A.B respectivamente.
Capacidades del controlador Todas las operaciones de la base de datos (SELECT, WHERE, ORDER BY, GROUP BY, AS, etc.) se tratan internamente por parte del controlador, mientras que las condiciones iguales en columnas de entrada se pasan al sistema SAP ERP.
Recuerde El controlador solo acepta las tablas que tengan una sola línea como parámetros de entrada. Equivalen a las estructuras de entrada.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Al crear una conexión en el asistente de conexión, define si se considera como entrada y salida a un parámetro cambiante de tipo de tabla o a un parámetro de tabla. El parámetro Asignar parámetros de tabla a columnas de entrada se encarga de esta funcionalidad. Si se selecciona, el parámetro es tanto la entrada como la salida. En este caso, solo puede ser una estructura como entrada. Si no se selecciona, el parámetro solo se tiene en consideración como un parámetro de salida. El controlador considera los campos de una estructura de entrada opcional como columnas de entrada opcionales. Las columnas de entrada se consideran opcionales en conjunto, es decir, si una columna tiene un valor, el resto también debe tener un valor. El usuario de la aplicación debe asegurarse de que todas las columnas tengan un valor. Algunos parámetros ABAP de función pueden contener valores cuyo tamaño puede ser igual o cero según el sistema SAP ERP. El controlador utiliza el parámetro Longitud máxima de cadena del archivo cs.cfg para establecer una longitud máxima de cadena para las columnas de la tabla asignadas a estos parámetros.
Información relacionada String Max Length [página 190]
6.4.4 ●
●
Restricciones del controlador de SAP ERP
No puede realizar consultas en objetos ERP basados en programas ABAP que involucran un procesamiento SAPGUI, a los que no se puede acceder con las llamadas de función remotas. La API de JCo no admite array fetch. Esto quiere decir que los datos de los resultados se devuelven todos a la vez. Para restringir el número de filas resultantes y para evitar un problema de memoria insuficiente, el usuario de la aplicación debe filtrar los datos adecuadamente. Con independencia a esta restricción, el servidor de conexión sigue aplicando array fetch.
Nota El usuario de la aplicación también puede asignar un valor de Filas máximas en el panel de consultas. Sin embargo, el sistema de SAP ERP no tiene en cuenta Máximo de filas si el universo que se define es de origen múltiple o si la consulta requiere computaciones después de recoger los datos (SELECT, DISTINCT, ORDER BY y GROUP BY). ●
El parámetro Máximo de filas de ERP del archivo de configuración jco.sbopermite al usuario de la aplicación realizar consultas sin filtro en una tabla de InfoSet o de consulta de SAP que solo contenga columnas de tipo de datos numéricos. El usuario también puede realizar consultas en una tabla que contenga columnas de tipo de datos numéricos y DATS. Este parámetro también se usa cuando Máximo de filas no se transmite al sistema de SAP ERP. Máximo de filas de ERP se puede usar con universos de un solo origen o de origen múltiple. Establezca Máximo de filas de ERP en un valor adecuado para evitar cualquier problema de memoria insuficiente.
Nota En el caso de los universos de origen múltiple, también puede establecer un valor en el parámetro Máximo de filas del Panel de consulta de la herramienta de administración de federación de datos. Consulte el Manual de la herramienta de administración de la federación de datos para obtener más información.
La capa de acceso a datos permite que la plataforma de BI se conecte a documentos XML como orígenes de datos. Los documentos XML se basan en esquemas XML. Un esquema XML es un documento XSD que define los metadatos de un origen de datos XML. El asistente de conexión proporciona un flujo de trabajo para introducir la información necesaria para conectarse con orígenes de datos XML. Los orígenes de datos XML se muestran en la capa de red Archivos XML DBMS y Conector de archivos XML. Puede encontrar los archivos de configuración del controlador en el directorio \connectionServer\xml. En el archivo xml.prm se enumeran capacidades del controlador de acceso a datos en cuanto a funciones y operaciones de bases de datos.
6.5.1
Capacidades del controlador XML
Los controladores de acceso a datos admiten las funciones de consulta siguientes: ● ● ● ●
Operaciones de base de datos básicas (SELECT, WHERE, ORDER BY, GROUP BY, DISTINCT) Alias de columna en la cláusula ORDER BY (AS) Consultas anidadas en cláusulas FROM Filtrar operaciones ( =, !=, <, <=, >, >=, AND, OR, BETWEEN, NOT BETWEEN, IN, NOT IN, LIKE, NOT LIKE, IS NULL, IS NOT NULL)
El controlador de acceso a datos no admite operaciones JOIN. El controlador de acceso a datos admite las funciones de grupo MIN, MAX, AVG, SUM y COUNT en enunciados SELECT.
Información relacionada Disco local usado como caché para clasificar operaciones [página 113] Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Los documentos XML que se usan como orígenes de datos pueden ser locales o remotos. Para archivos en sistemas remotos, se admiten los protocolos HTTP, FTP, y SMB. La versión actual también admite los protocolos cifrados HTTPS y FTPS basados en un certificado.
Nota SMB es el protocolo estándar para compartir archivos en MS Windows. Dado que la biblioteca jCIFS proporciona acceso al protocolo, debe instalar el archivo JAR de jCIFS en el directorio del servidor de \connectionServer\sharedLibraries conexiones, es decir \jcifs. La versión para instalar es la 1.3.15 y está disponible en http://jcifs.samba.org/
.
Puede definir si el origen de datos es local o remoto mediante el parámetro Tipo de ubicación del asistente de conexión. Si el origen de datos es remoto, puede ajustar el protocolo empleado utilizando el parámetro Protocolo del asistente. El valor Protocolo debe coincidir con el protocolo especificado en el valor del parámetro Ruta de archivo o patrón.
Ejemplo
●
C:\xml\report.xml o xml/report.xml para un archivo local
●
http://server:8080/path/report.xml para un archivo accesible a través de HTTP
●
ftp://servidor/ruta/ para archivos a los que se puede acceder mediante FTP
●
smb://servidor:puerto/recurso/midirectorio para archivos a los que se puede acceder mediante
SMB
Información relacionada Ubicación de archivos CSV [página 69]
6.5.3
Ejemplo de esquema y documento XML
El ejemplo siguiente ilustra la estructura de un documento XML denominado clubdemo.xml y basado en el esquema clubdemo.xsd.
ChristineMartin25 12, allee Victor Hugo 75016Paris1234PeterTravis34 7835 Hartford Drive 06108Springfield23204WilliamBaker64 2890 Grant Avenue 20020Washington DC3530644106
Ejemplo
Manual de acceso a los datos Documentación del controlador de acceso a datos
Puede conectarse a varios archivos si el parámetro Ruta de archivo o patrón del asistente de conexión está fijado en un modelo, por ejemplo, clubdemo_*.xml, el cual coincide con archivos como clubdemo_1.xml y clubdemo_2.xml.
Recuerde No puede conectar varios archivos ubicados en un servidor HTTP. El protocolo HTTP no admite el uso de comodines en los modelos. Si se selecciona el parámetro Fusionar archivos en uno en el asistente de conexión, las tablas idénticas de varios archivos XML se fusionan en una tabla. El nombre del calificador de tabla es la ruta completa del modelo, por ejemplo C:\files\xml\clubdemo_*.xml. Se presupone que todos los archivos presentan el mismo esquema. Si el parámetro no está seleccionado, las tablas no se fusionan porque no pertenecen al mismo calificador. A continuación, cada documento XML se asigna a un calificador de base de datos. El nombre del calificador es la ruta completa del archivo XML, por ejemplo C:\files\xml\clubdemo_1.xml. En este caso, cada archivo XML puede tener su propio esquema. No hay datos asignados a los propietarios de la base de datos.
6.5.5
Controlador XML: asignación de tablas
El controlador de acceso a datos mostrará a la herramienta de diseño de información los archivos XML como tablas. La raíz del documento XML está asignada a la tabla. Los elementos que tienen un valor maxOccurs mayor que 1 están asignados a tablas. El nombre de la tabla asignada a un elemento es la concatenación de todos los nombres de elementos entre la raíz y el elemento, separado con una barra ( /).
Ejemplo El documento clubdemo.xml está asignado a las tablas siguientes: ●
ClubDemo
●
ClubDemo/Países/País
●
ClubDemo/Clientes/Cliente
●
ClubDemo/Clientes/Cliente/Factura
●
ClubDemo/Clientes/Cliente/Nombre
Información relacionada Ejemplo de esquema y documento XML [página 94]
Manual de acceso a los datos Documentación del controlador de acceso a datos
Los objetos siguientes en un elemento XML están asignados a columnas de la tabla que representa este elemento: Atributos Elementos del tipo simpleType o complexType con un elemento simpleContent Textos que se encuentran en un elemento mezclado, cuyo tipo define mixed=true any y anyAttribute
● ● ● ●
Si la columna representa un atributo, su nombre es la concatenación de los nombres de todos los elementos que empiezan por (pero no incluyen) el elemento con maxOccurs mayor que 1, e incluye el elemento que aloja este atributo. El nombre del atributo está prefijado con @, para evitar conflictos de nombres con otros elementos. Si la columna representa un elemento, su nombre es la concatenación de los nombres de todos los elementos que empiezan por (pero no incluyen) el elemento con maxOccurs mayor que 1. Si la columna representa el mismo elemento que su tabla, su nombre es el nombre del elemento. El separador que se usa en concatenaciones es la barra ( /). Los nombres de elemento están prefijados con un guión ( -) cuando representan elementos principales usados en rutas para generar claves externas. Los siguientes ejemplos de asignación hacen referencia al tema del ejemplo de un documento y un esquema XML.
Ejemplo La tabla ClubDemo tiene la columna siguiente: ●
-id
Ejemplo La tabla ClubDemo/Países/País tiene las siguientes columnas: ●
nombre
●
-Countries/-ClubDemo/-id
Ejemplo La tabla ClubDemo/Customers/Customer tiene las columnas siguientes: ●
Ejemplo La tabla ClubDemo/Customers/Customer tiene las columnas siguientes: ●
-id
●
Invoice
●
-Customers/ID
Ejemplo La tabla ClubDemo/Customers/Customer tiene las columnas siguientes: ●
-id
●
Name
●
@type
●
-Customer/ID
En el esquema XML, name, type, e ID son nombres de atributos de los elementos Country, Name, y Customer respectivamente. Las columnas Invoice y Name representan los elementos Invoice y Name respectivamente. Consulte el tema sobre la asignación de claves externas y principales para obtener más información sobre el significado de los nombres de las columnas.
Información relacionada Ejemplo de esquema y documento XML [página 94] Controlador XML: asi gnación de claves principales y externas [página 99] Controlador XML - asignación anyType y simpleType [página 104]
6.5.7 Controlador XML: asignación de claves principales y externas Claves principales Las reglas siguientes son aplicables a la asignación de claves principales: ●
●
El controlador genera la clave principal de la tabla que asigna la raíz del documento. La columna asociada se denomina -id y el valor de la columna es el nombre del documento. Un atributo o elemento del tipo "xs:ID" está asignado a una columna que representa una clave principal.
Si el esquema XML define una clave con , se aplica la regla siguiente: ●
●
Si la clave está definida en el nivel de raíz y si el selector contiene un elemento con un valor maxOccurs mayor que 1, la clave se asigna a la clave principal de la tabla correspondiente. Si la clave no está definida en el nivel de raíz, la clave principal de la tabla es la combinación de la clave principal del elemento principal y del campo de la clave.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Si el esquema no define una clave primaria para un elemento selector con un valor maxOccurs mayor que 1, se agrega una columna con el nombre -id a la tabla como clave primaria.
Ejemplo El elemento ClubDemo es la raíz del documento clubdemo.xml. La columna -id se crea y define como clave primaria de la tabla ClubDemo. El valor de la columna -id es clubdemo.xml.
Ejemplo El siguiente conjunto de claves a nivel raíz define la columna @name de la tabla ClubDemo/Países/País como clave principal:
La tabla ClubDemo/Clientes/Cliente tiene la columna ID como clave principal, porque el esquema define la clave explícita custkey:
Ejemplo La tabla ClubDemo/Clientes/Cliente/Factura tiene la columna -id como clave principal, porque el esquema no define una clave para este elemento.
Claves externas Si el esquema XML define una referencia clave con , y si la referencia clave está definida al mismo nivel que sus referencias, la referencia clave se asigna a una clave externa de la tabla correspondiente. Para cada tabla que se corresponde con un elemento que no es la raíz, la clave externa se genera a partir de las columnas de la clave principal de la tabla principal y de la ruta inversa desde el elemento a su principal. Esto habilita la asignación de las relaciones entre elementos principales y secundarios.
Restricción Aunque la infraestructura de datos expone claves externas, el controlador XML no admite operaciones JOIN.
Ejemplo La tabla ClubDemo/Clientes/Cliente tiene las claves externas siguientes: ●
País/nombre, que es el campo de la siguiente referencia clave:
●
Tenga en cuenta que countkey es la clave explícita definida para una tabla que no es principal. -Customers/-ClubDemo/-id, que se genera desde la ruta inversa a la tabla principal y la clave principal de la tabla principal
Ejemplo La tabla ClubDemo/Clientes/Cliente/Factura tiene la columna -Customer/ID definida como clave externa, que se genera a partir de la columna de la clave principal de la tabla principal y la ruta inversa a su tabla principal.
Información relacionada Ejemplo de esquema y documento XML [página 94] Controlador XML: asignación de columnas [página 98]
6.5.8
Controlador XML: asignación de elementos mezclados
El contenido completo de un elemento mezclado está asignado a una columna de tabla. Esto incluye sus datos secundarios y todos los demás entre los secundarios. Los atributos de un elemento mezclado están asignados a columnas, independientemente de cómo está asignado el elemento.
Ejemplo En este ejemplo, el elemento documentación tiene un complexType con tres elementos secundarios ( name, datatype y location). The XML driver allows you to retrieve XML data from documents located on a remote server.
La capa de acceso a datos asigna estos elementos de la forma siguiente:
Manual de acceso a los datos Documentación del controlador de acceso a datos
El elemento documentación está asignado a una columna de tabla. El contenido del elemento documentación se convierte en datos de columna, incluyendo sus secundarios y todos los datos entre los secundarios. En el ejemplo, la columna contiene las filas siguientes:
● ●
The XML driver allows you to retrieve XML data from documents located on a remote server.
6.5.9
Controlador XML: asignación de elementos recursivos
El esquema siguiente define elementos recursivos:
El controlador XML asigna el primer elemento principal y el elemento secundario a las tablas e ignora el secundario principal.
6.5.10 Controlador XML - asignación any y anyAtributo Ejemplo
● ●
El nombre y el tipo de datos se asignan a las columnas El elemento any está asignado a la columna -any
Los datos de la columna -any son el contenido y el nombre del elemento. En el ejemplo, contiene la fila siguiente: ExternalAdministrator
Restricción Si el elemento any tiene maxOccurs más que 1, el controlador XML solo asigna a la columna -any el nombre del primer elemento que encuentra al analizar el documento XML. Se ignoran otros nombres de elemento. En el ejemplo siguiente, PDF se ignora. Data Access GuideXMLExternalAdministratorPDF
Ejemplo
● ●
El nombre y el tipo de datos se asignan a las columnas El elemento anyAttribute está asignado a la columna -@anyAttribute
Manual de acceso a los datos Documentación del controlador de acceso a datos
Los datos de la columna -@anyAttribute son el nombre y el valor del atributo de elemento. En el ejemplo, los datos de la columna contienen las dos filas siguientes: myAttribute="ConnectionServer" myAttribute="DataFederator"
6.5.11
Controlador XML - asignación anyType y simpleType
Las secciones siguientes muestra cómo se asignan anyType y disposiciones específicas de simpleType en esquemas XML.
Asignar el tipo anyType El contenido completo de un elemento del tipo anyType está asignado a una columna de tabla.
Ejemplo En el ejemplo de Club Demo, el elemento Dirección está asignado a la columna Dirección.
Asignar listas de valores Independientemente del tipo de base de datos del valor, siempre se asigna una lista de valores a VARCHAR.
Ejemplo El tipo de dato base es un entero. El tipo de datos de la lista de enteros es VARCHAR. 100 34 56 -23 1567
Asignar restricciones a un tipo El valor de un elemento se puede restringir a cierto rango. Esto no tiene impacto en la conversión del tipo de datos.
Ejemplo
Asignar uniones de tipos El tipo de datos XML al que se asigna la unión es la cadena, es decir, tipos de datos CHAR o VARCHAR en infraestructuras de datos.
Ejemplo
6.5.12 Controlador XML: configuración del tamaño máximo de columna El archivo de configuración cs.cfg proporciona los parámetros siguientes:
Manual de acceso a los datos Documentación del controlador de acceso a datos
Longitud máxima binaria para establecer el tamaño máximo de las columnas cuyo tipo de datos es
●
binario Longitud máxima de entero para establecer el tamaño máximo de las columnas de la tabla cuyo tipo de
●
datos es integer, nonPositiveInteger, negativeInteger, noNegativeInteger, and positiveInteger Longitud máxima de cadena para establecer el tamaño máximo de las columnas de la tabla cuyo tipo de datos es cadena o cualquiera de los siguientes: anyURI, QName, NOTATION, duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, TYPE_NORMALIZEDSTRING, token, language, Name, NCName, XSD_TYPE_ID, IDREF, IDREFS, ENTITY, ENTITIES
●
Información relacionada Binary Max Length [página 179] Integer Max Length [página 185] String Max Length [página 190]
6.6
Controlador de servicio Web
La capa de acceso a datos permite que la plataforma de BI se conecte a los servicios disponibles en Internet mediante HTTP o FTP. Proporciona un controlador de acceso a datos denominado controlador del servicio Web para comunicarse con servicios Web usando mensajes SOAP 1.1. Los servicios Web se definen en documentos que describen tipos de datos, mensajes, y vinculaciones con el idioma de descripción de servicios Web (WSDL) 1.1. El controlador de servicios Web admite servicios Web de SOAP 1.1 vinculante y el documento o estilo rpc con cuerpo literal. Por ejemplo: ...
o ...
Recuerde El controlador no admite otras versiones y servicios del protocolo SOAP de estilos distintos a documento y rpc.
El asistente de conexión proporciona un flujo de trabajo para introducir la información necesaria para conectarse con servicios Web. Los servicios Web se muestran en el DBM Servicios Web (WSDL 1.1) y la capa de red Conector de servicios Web . Puede encontrar los archivos de configuración del controlador en el directorio \connectionServer\xml. En el archivo xml.prm se enumeran capacidades del controlador de acceso a datos en cuanto a funciones y operaciones de bases de datos.
6.6.1
Capacidades del controlador de servicio Web
Los controladores del servicio Web y XML comparten las mismas capacidades.
Información relacionada Capacidades del controlador XML [página 93]
6.6.2
Ubicación de servicio Web
Configure la ubicación de servicio Web con el parámetro URL de servicio Web en el asistente de conexión, con la información siguiente: ● ● ●
Nombre de usuario y contraseña en caso necesario para la autenticación Dirección del servidor proxy Nombre de usuario y contraseña proxy en caso necesario para la autenticación
La versión actual también admite los protocolos cifrados HTTPS y FTPS basados en un certificado.
Recuerde El controlador de servicios Web solo admite el documento de definición de servicios Web y los servicios asociados alojados en el mismo servidor HTTP.
El ejemplo siguiente ilustra el documento ClubDemo.wsdl que define el servicio Web CustomerService del estilo del documento. La URL de muestra de este servicio Web es http://ws.myexample.com/ClubDemo/ ClubDemo.wsdl.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Ejemplo El documento WSDL define los detalles siguientes: El servicio CustomerService El puerto Cliente El enlace GetCustomer El tipo de puerto CustomerType La operación GetCustomerList El mensaje de entrada GetCustomerListByCountryRequest, que contiene el elemento País El mensaje de salida GetCustomerListByCountryResponse, que contiene el elemento GetCustomerListReturn de tipo complejo Cliente
wsdl:part> wsdl:part> Gets Information on ClubDemo Customers wsdl:documentation>
6.6.4
Asignar reglas para servicios Web
El controlador de servicios Web usa las mismas reglas de asignación de columna y tabla como controlador XML. El controlador también admite las siguientes reglas específicas para servicios Web.
Manual de acceso a los datos Documentación del controlador de acceso a datos
Calificadores La capa de acceso a datos se puede conectar a un servicio Web poco a poco. El servicio está asignado al calificador de la base de datos. En el ejemplo de ClubDemo, el nombre del calificador es el nombre del servicio CustomerService.
Propietarios El atributo puerto se asigna al propietario de la base de datos. En el ejemplo, el propietario es Cliente.
Tablas En la capa de acceso a datos, cada operación se representa como una raíz. Cada mensaje de salida representa un elemento secundario de una operación. El controlador de servicios Web expone mensajes de salida como tablas. Los nombres de tablas son concatenaciones de los nombres de la operación, el mensaje de salida, y los elementos XML contenidos en la respuesta, separados por una barra ( /).
Ejemplo En el ejemplo de ClubDemo, las tablas son las siguientes: ●
Columnas y columnas de entrada Las reglas de asignación XML para columnas también son aplicables a los servicios Web. El controlador de servicios Web solo acepta tablas c on una fila única como mensajes de entrada. Cada entrada de la tabla está asignada a una columna de entrada de la tabla de resultados. El controlador asigna todos los mensajes de entrada, incluso si están definidos como opcionales en el documento WSDL.
Restricción El controlador no admite any ni anyAttribute en las columnas de entrada.
En los ejemplos siguientes, la columna GetCustomerListByCountryRequest/GetCustomerListByCountry es una columna de entrada. Los otros nombres de columna resultan de las reglas de asignación de elementos XML. Consulte la sección del controlador XML para obtener más información.
Ejemplo Las columnas de la tabla GetCustomerList/GetCustomerListByCountryResponse/ GetCustomerListResponse son las siguientes: ●
Ejemplo Las columnas de la tabla GetCustomerList/GetCustomerListByCountryResponse/ GetCustomerListResponse/GetCustomerListReturn/Name son las siguientes: ●
Ejemplo Las columnas de la tabla GetCustomerList/GetCustomerListByCountryResponse/ GetCustomerListResponse/GetCustomerListReturn/Invoiceson las siguientes: ●
Claves principales y claves externas Las reglas de asignación XML para claves principales y externas también se aplican a los servicios Web. Además, una columna de entrada siempre forma parte de la definición de una clave principal.
Restricción Aunque la infraestructura de datos expone claves externas, el controlador del servicio Web no admite operaciones JOIN.
Ejemplo La columna -id de la tabla GetCustomerList/GetCustomerListByCountryResponse/ GetCustomerListResponse se genera porque el esquema no define ninguna clave principal. El esquema define una clave principal explícita para la columna ID de la tabla GetCustomerList/ GetCustomerListByCountryResponse/GetCustomerListResponse/GetCustomerListReturn.
La columna de entrada GetCustomerListByCountryRequest/GetCustomerListByCountry se usa como clave principal.
Ejemplo Las columnas -GetCustomerListResponse/ID y -GetCustomerListReturn/ID se generan desde la ruta inversa a la tabla principal de la tabla principal.
Tipos de datos de matriz Los servicios Web admiten tipos de datos en el formato de una matriz realizada con una serie de tipos complejos o principales. Un elemento de este tipo está asignado a una tabla de una fila. Está asignado como parte de nombres de columna o tabla como -arrayElement. El tipo de datos de la matriz no define el nombre del elemento y acepta cualquier nombre. Consulte el siguiente vínculo para obtener más información sobre los tipos de datos de matriz.
Ejemplo arrayType="xsd:int[2]" es un tipo de dato de un elemento con dos ocurrencias y cuyo valor es un entero. Por ejemplo, el siguiente tipo complejo es aplicable al elemento CustomerIDs y lo define como principal de un elemento CustomerID que acepta valores enteros:
Información relacionada Details on arrays in SOAP 1.1 note Controlador XML: asignación de columnas [página 98] Controlador XML: asignación de claves principales y externas [página 99]
6.6.5 Controlador de servicio Web: configurar el tamaño máximo de la columna Como el controlador XML, el controlador del servicio Web también usa los parámetros Longitud máxima binaria, Longitud máxima entera y Longitud máxima de cadena en el archivo cs.cfg para manejar grandes volúmenes de este tipo de datos.
Información relacionada Binary Max Length [página 179] Integer Max Length [página 185] String Max Length [página 190]
6.7
Disco local usado como caché para clasificar operaciones
Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas. Los controladores de acceso a datos realizan las operaciones de clasificación (ORDER BY, GROUP BY y DISTINCT) de la forma siguiente: ● ●
En la memoria principal, si existe una cantidad pequeña de datos para clasificar Al escribir datos en un directorio temporal en el disco local
Manual de acceso a los datos Documentación del controlador de acceso a datos
Las filas clasificadas se escriben en el disco cuando la memoria principal que queda libre es demasiado pequeña o cuando se alcanza el número de filas definidas con el parámetro SBO Tamaño de particiones de intervalos. El disco local se usa como caché y los datos se escriben en la carpeta temporal predeterminada de su equipo. Puede configurar la ruta del directorio en el archivo cs.cfg con el parámetro Directorio de datos temporal cuando el sistema operativo no especifica ninguna carpeta temporal.
Información relacionada CSV OpenDriver [página 66] Controlador OData [página 72] Controlador de SAP ERP [página 86] Controlador XML [página 93] Controlador de servicio Web [página 106] Bucket Split Size [página 180] Temp Data Dir [página 191]
Las siguientes secciones describen cómo crear conexiones a bases de datos HIVE. En esta versión, puede crear conexiones a diferentes versiones de bases de datos HIVE simultáneamente.
7.1.1
Para crear una conexión a Apache Hadoop HIVE
La capa de acceso a datos permite que la plataforma de BI se conecte a bases de datos Apache Hadoop HIVE 0.7.1, 0.8.0, 0.9.0 y 0.10 mediante JDBC en todas las conexiones de plataformas.Apache Hadoop HIVE
Nota ●
HiveServer1 es el único servidor compatible
●
El controlador Apache Adoop HiIVE no admite tipos de datos compleos Para crear una conexión con el servidor Apache Hive, coloque los siguientes conjuntos de archivos JAR en el \connectionServer\jdbc\drivers directorio \ , en el que es hive07, hive08, hive09 o hive010 y, hive012.
Ejecute el asistente de conexión. Seleccione la versión de controlador de Apache Hadoop HIVE que desee usar. Utilice el asistente para configurar la conexión. Ha creado una conexión para la base de datos Apache Hadoop HIVE.
Nota ●
●
Las conexiones creadas a partir de la plataforma de BI 4.1 siguen funcionando en esta versión. El nombre de la base de datos Apache Hadoop HIVE es un alias de Apache Hadoop Hive 0.7. La carpeta hive para archivos JAR aún se soporta. No necesita realizar ninguna configuración adicional para crear una conexión con Apache Hadoop Hive 0.12 Simba JDBC4, ya que los controladores están instalados como parte de la plataforma de BI en el directorio \connectionServer\jdbc\drivers \hive012simba4server1.
Información relacionada Información sobre la ubicación del archivo JAR [página 54]
Manual de acceso a los datos Documentación de conexión
7.1.2 Hacer que las connexiones HIVE funcionen después de una actualización de plataforma Como requisito previo, su entorno de producción tiene que funcionar en la plataforma BI de SAP BusinessObjects release 4.0 hasta el Support Package 8 en un sistema operativo Microsoft Windows o UNIX. Después de actualizar los servidores de plataforma o las herramientas de cliente a un release 4.1, el controlador Apache Hadoop HIVE se ha desinstalado. Debe modificar la instalación de la plataforma para que funcionen las conexiones Apache Hadoop HIVE. El siguiente procedimiento muestra los pasos para realizarlo en Microsoft Windows. En el panel de control, localice el programa de instalación completo más reciente de la plataforma de BI.
Recuerde No puede llevar a cabo el paso siguiente en la actualización del programa de la plataforma. Haga clic con el botón derecho y seleccione Desinstalar/Cambiar. En la pantalla Actualización de aplicación del cuadro de diálogo configuración de la plataforma de SAP BusinessObjects BI, seleccione Modificar y haga clic en Siguiente. En la pantalla Seleccionar funciones, seleccione la opción Hadoop HIVE en Acceso y seguridad a base de datos. Haga clic en Siguiente y complete la instalación. Ha instalado el controlador Apache Hadoop HIVE en la plataforma. Ahora puede crear conexiones en la base de datos HIVE.
7.1.3
Crear una conexión a Amazon EMR HIVE
La capa de acceso a datos permite que la plataforma de BI se conecte a bases de datos Amazon Elastic MapReduce (EMR) HIVE 0.7 y 0.8 mediante JDBC en todas las plataformas. Configurar un túnel SSH al nodo maestro de Amazon. Para obtener más información, consulte la documentación de Amazon. Descargue los archivos JAR necesarios de la página web de Amazon y colóquelos en el directorio \connectionServer\jdbc\drivers\ ,
donde es emrhive07 o emrhive08. En el asistente de conexión, especifique localhost para el servidor y 10002 para el puerto en el campo Servidor (host:port). Ha creado una conexión a la base de datos de Amazon EMR HIVE.
Nota Las conexiones creadas a partir de la plataforma de BI 4.1 siguen funcionando en esta versión. El nombre de la base de datos Amazon EMR HIVE es un alias de Amazon EMR Hive 0.7. La carpeta hive para archivos JAR aún se soporta.
Información relacionada Creating an SSH tunnel to the master node HIVE 0.7.1 JAR file download website HIVE 0.8.1 JAR file download website Información sobre la ubicación del archivo JAR [página 54]
7.1.4
Crear una conexión a Cloudera Impala
Los controladores Cloudera Impala 1.0 Simba JDBC4 se instalan como parte de la plataforma BI en el directorio \connectionServer\jdbc\drivers\impala10simba4. No necesita realizar ninguna configuración adicional para crear una conexión con la base de datos Cloudera Impala. Los siguientes archivos JAR son compatibles con la base de datos de Impala 1.0: Tabla 7:
7.2 Conexiones IBM DB2 - Claves de referencia asignadas a nulo Restricción Debido a una restricción del controlador de base de datos, los nombres clave de referencia IBM DB2 10 para tablas de bases de datos z/OS se asignan como NULL.
Manual de acceso a los datos Documentación de conexión
Las secciones siguientes describen las acciones a realizar cuando se generan problemas con las conexiones IBM Informix.
Información relacionada Establecer la zona horaria JVM para conexiones de IBM Informix [página 120] Establecer el modo de transacción para conexiones de I BM Informix [página 120]
7.3.1 Establecer la zona horaria JVM para conexiones de IBM Informix En la herramienta de diseño de información, las consultas de IBM Informix Dynamic Server 11 que usan JDBC pueden devolver valores del tipo de datos incorrectos si la herramienta del cliente y el servidor se ubican en distintos husos horarios. Para evitar este problema, debe establecer el valor del huso horario de JVM al mismo conjunto de huso horario a nivel del servidor de la base de datos. Salga de la herramienta de diseño de información. \win32_x86. Vaya al directorio
Abra InformationDesignTool.ini para la edición. Agregue la línea siguiente al final del archivo: -Duser.timezone=
donde es el valor de la zona horaria fijado en el servidor de la base de datos. Por ejemplo: GMT. Guarde el archivo. Reinicie la aplicación. Una vez finalizada esta tarea, se habrán configurado correctamente las conexiones de una base de datos IBM Informix que usa JDBC.
7.3.2 Establecer el modo de transacción para conexiones de IBM Informix La capa de acceso a datos permite ejecutar operaciones SQL como bloque de transacción de forma predeterminada. Si Informix Dynamic Server no admite transacciones, debe esperar un error de conexión. Para evitar este problema, especifique en el archivo de c onfiguración del controlador que el modo de transacción no está disponible.
Salga de la herramienta de cliente. Abra el archivo informix.sbo para editarlo. \connectionServer\jdbc. Se encuentra en el directorio
Agregar la siguiente línea en la sección Base de datos adecuada: No
Guarde el archivo. Reinicie el servicio y la aplicación. Una vez finalizada esta tarea, habrá configurado correctamente las conexiones a IBM Informix.
Información relacionada Transactional Available [página 191]
7.4
Conexiones de MS Analysis Services Precaución
Las conexiones de MS Analysis Services mediante XMLA no usan el servidor de conexión. Esta sección se refiere sólo a las conexiones que se van a crear en la herramienta de diseño de información. En la herramienta de diseño de información los usuarios pueden crear conexiones a MS Analysis Services sobre HTTP a través de un controlador XMLA. Para configurar estas conexiones, primero debe activar el acceso a HTTP. Para obtener más información, consulte el sitio web de Microsoft TechNet.
Información relacionada Soporte sinónimo para conexiones OLE DB a MS SQL Server [página 122] Las columnas sinónimas no se muestran en las herramientas de generación de informes. Establecer las opciones JVM para conexiones con MS SQL Server en UNIX [página 122] Después de instalar el controlador JDBC para MS SQL Server en UNIX y configurar el archivo jdbc.sbo, fije la información JVM en el archivo cs.cfg.
7.5.1 Soporte sinónimo para conexiones OLE DB a MS SQL Server Las columnas sinónimas no se muestran en las herramientas de generación de informes. El middleware del cliente nativo de MS SQL Server no admite metadatos de columnas sinónimas. Por consiguiente, las columnas sinónimas de la base de datos de MS SQL Server no se muestran en la herramienta de diseño de universos o en la herramienta de diseño de información al conectarse a través de OLE DB.
Información relacionada SQL Server Native Client (OLE DB)
7.5.2 Establecer las opciones JVM para conexiones con MS SQL Server en UNIX Después de instalar el controlador JDBC para MS SQL Server en UNIX y configurar el archivo jdbc.sbo, fije la información JVM en el archivo cs.cfg. Abra el archivo cs.cfg para su edición. Añada el directorio de archivo siguiente a la sección JavaVM de manera que sobrescriba la configuración de JVM por defecto: $BOBJEDIR/jdk/jre/lib/i386/server/ libjvm.so
Agregue las siguientes opciones a la sección JavaVM:
La sección siguiente proporciona la información de configuración para conexiones de Oracle.
Información relacionada Conexiones a clústeres de servidores de Oracle. [página 123] Establecer el valor del parámetro de Oracle CURSOR_SHARING [página 124]
7.6.1
Conexiones a clústeres de servidores de Oracle.
Las conexiones a los clústeres de los servidores de Oracle que funcionan en modo de conmutación por error se admiten a través de ODBC y JDBC. El controlador elige uno de dichos servidores y, si no está disponible, se usa el siguiente. Si no hay ningún servidor disponible, se produce un error de conexión. En el asistente de conexión, introduzca el host y el puerto del servidor separados por un punto y coma en Servidores (host:port{,host:port}) para crear una conexión JDBC. Introduzca información para uno o varios servidores si desea tomar ventaja del mecanismo de conmutación por error.
Manual de acceso a los datos Documentación de conexión
7.6.2 Establecer el valor del parámetro de Oracle CURSOR_SHARING Las bases de datos Oracle 10 y superiores unas el parámetro CURSOR_SHARING. Las herramientas de la plataforma de BI y de la generación de informes de SAP BusinessObjects solo soportan el valor EXACT para CURSOR_SHARING. Si utiliza el valor FORCE, puede causar algunos problemas de rendimiento de las herramientas de generación de informes. Realice una de las siguientes acciones:
Abra la conexión de universo para editarla. CURSOR_SHARING
Haga clic en Siguiente para ir a la pantalla Parámetros personalizados . Haga clic en Añadir parámetro. Introduzca ConnectInit y haga clic en Aceptar. Introduzca "alter session set CURSOR_SHARING=EXACT " como valor ConnectInit. Haga clic en Finalizar.
CURSOR_SHARING
Explore el directorio que almacena el archivo oracle.prm: \connectionServer\Oracle. Abra el archivo en un editor XML. Bajo la sección de Configuración, añada el parámetro siguiente:
EXACT Guarde el archivo. Reinicie los servicios de conectividad y de generación de informes de la Consola de administración central.
Nota Para la definición de CURSOR_SHARING, consulte la documentación de Oracle.
7.6.3 Conexiones MySQL - Privilegios de base de datos necesarios para algunos flujos de trabajo en la herramienta de diseño de información Al trabajar con un universo en la herramienta de diseño de información basado en una conexión MySQL JDBC, si la infraestructura de datos incluye una tabla basada en una vista en la base de datos MySQL, el usuario necesitará MOSTRAR VISTA o un privilegio equivalente otorgado en la base de datos de esta vista.
Si no se ha concedido el privilegio, el usuario de la herramienta de diseño de información puede recibir una excepción de base de datos (comando MOSTRAR VISTA denegado) al realizar ciertos flujos de trabajo, por ejemplo, mostrar valores o detectar claves.
7.6.4 Usar conexiones Oracle JDBC en la herramienta de diseño de información en idioma de interfaz noruego Bokmål Para usar conexiones Oracle JDBC en la herramienta de diseño de información cuando se utilice el idioma de interfaz noruego Bokmål, debe definir la configuración regional predeterminada realizando los siguientes cambios en el archivo InformationDesignTool.ini. Salga de la herramienta de diseño de información. \SAP BusinessObjects Enterprise XI 4.0\win32_x86\ , En el directorio localice el archivo InformationDesignTool.ini y ábralo en un editor.
Nota Sustituya con la ruta del directorio en el que está instalada la plataforma de BI. Agregue las siguientes líneas a InformationDesignTool.ini y guarde el archivo. -Duser.language=nb -Duser.country=NO
Reinicie la herramienta de diseño de información. Siga los siguientes pasos en la herramienta de diseño de información para definir el idioma del producto como la configuración regional predeterminada: a) Desde el menú principal de la herramienta de diseño de información, seleccione Ventana Preferencias . b) En el cuadro de diálogo Preferencias, expanda el nodo Herramienta de diseño de información y seleccione Idiomas. c) Seleccione Configuración regional de la lista Idiomas del producto. La configuración local debe ser (Noruego Bokmål (Noruega)). Asegúrese de que no selecciona el idioma del producto Noruego Bokmål. d) Haga clic en Aceptar. Para que el cambio de idioma se aplique, debe salir y reiniciar la herramienta de diseño de información.
7.7
Conexiones Oracle EBS
La capa de acceso a datos ofrece un controlador nuevo para conectar las aplicaciones de SAP BusinessObjects a Oracle E-Business Suite (EBS) a través de la interfaz de llamadas de Oracle (OCI). Permite que las aplicaciones accedan a los datos desde las vistas y los procedimientos almacenados de EBS. Solo puede usar OCI para conectar el controlador a Oracle EBS.
Manual de acceso a los datos Documentación de conexión
Al crear una conexión en la herramienta de diseño de universos o en la herramienta de diseño de información, en primer lugar debe elegir el modo de autenticación, que puede ser proporcionado por el usuario si el usuario de la aplicación indica el nombre de usuario y la contraseña al iniciar la sesión a la plataforma de BI; o de inicio de sesión único si el usuario inicia la sesión con los credenciales de Oracle EBS. A continuación debe elegir la aplicación Oracle EBS, la responsabilidad y el grupo de seguridad, que definen el origen de datos del universo. La plataforma de Business Intelligence proporciona inicio de sesión único para Oracle EBS con ayuda de un complemento de autenticación. SSO se habilitará si el comp lemento está instalado y configurado correctamente. SSO permite que el usuario de la aplicación inicie sesión en la plataforma de lanzamiento de BI con credenciales de Oracle EBS. El servidor de conexión usa las mismas credenciales para tener acceso al origen de datos de Oracle EBS. Para obtener más información sobre el complemento de autenticación, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence.
7.8
Conexiones Oracle Essbase
La capa de acceso de datos permite a la plataforma de BI acceder al origen de datos de Oracle Essbase. Las conexiones a Oracle Essbase son conexiones OLAP. Puede crear universos .unv basados en Oracle Essbase 9 o 11 a través del middleware de cliente Essbase en MS Windows de 32 bits o un sistema operativo UNIX de 64 bits. Estas conexiones funcionan con un servidor de conexiones de 32 bits o de 64 bits. En MS Windows de 64 bits, la capa de acceso a datos le permite trabajar con un servidor de conexiones de 32 bits. Consulte la sección Compatibilidad con Microsoft Windows de 64 bits. Puede crear universos .unx basados en Oracle Essbase 11 a través de ESSJAPI o el API nativo en un entorno de 32 bits o de 64 bits. Estas conexiones funcionan con el cliente OLAP.
Precaución Debido a una restricción en el middleware de ESSJAPI para universos .unv, es necesario realizar un despliegue específico del servidor de la plataforma de BI para admitir universos .unv y .unx basados en Oracle Essbase 11. Para implementar un servidor que admita universos Essbase .unv y .unx, configure un sistema con los dos siguientes clústeres en dos equipos separados: ●
●
En un entorno de 64 bits, instale el siguiente software en el primer clúster (Cluster1): la plataforma de BI de 64 bits, el Servidor de administración central, servidores de Web Intelligence, un servidor de conexión de 64 bits y todos los controladores del middleware de 64 bits. En un entorno de 32 bits, instale el siguiente software en el segundo clúster (Cluster2): el servidor de conexiones de 32 bits y los controladores del middleware de 32 bits (incluido el controlador Essbase de 32 bits para universos .unv).
En tiempo de ejecución, el servidor de conexión utiliza Cluster2 para universos .unv. El cliente OLAP, que sirve universos .unx, usa el middleware de 64 bits disponible en Cluster1.
Información relacionada Compatibilidad con Microsoft Windows de 64 bits [página 26]
La capa Acceso a datos permite que la plataforma de BI se conecte a Oracle Real Application Clusters (RAC) mediante JDBC. Para crear una conexión desde su aplicación mediante el asistente de conexión, tendrá que suministrar la entrada del origen de datos de Oracle RAC, que presenta el siguiente formato: :,:,...,:
El número de pares de host y puerto depende del número de equipos relacionados con el clúster.
7.10 Conexiones salesforce.com - Para configurar el entorno Primero debe configurar su entorno para que funcionen las conexiones salesforce.com ya sea en la herramienta de diseño de universo o en la herramienta de diseño de información. Detenga el servicio de conectividad del CMC y la aplicación cliente. Ejecute regedit.exe en la línea de comandos de MS Windows para abrir el editor del Registro. Vaya al origen de datos ODBC de Salesforce en
HKEY_LOCAL_MACHINE
SOFTWARE
ODBC
ODBC.INI <> , donde es el nombre del origen de
datos de salesforce.com. Haga clic con el botón derecho en el nombre del origen de datos y seleccione
Nuevo
Valor de cadena .
Introducir CheckJVMChanged . Haga doble clic en la propiedad e introduzca 0. Cierre el editor del Registro. Luego debe seguir los pasos siguientes para completar la configuración.
Información relacionada Para que funcionen las conexiones salesforce.com en la herramienta de diseño de información [página 128] Para que funcionen las conexiones salesforce.com en la herramienta de diseño de universo [página 128]
Manual de acceso a los datos Documentación de conexión
7.10.1 Para que funcionen las conexiones salesforce.com en la herramienta de diseño de información Salga de la herramienta de diseño de información. \win32_x86\jdk\jre6\lib Copie el archivo de la unidad sforce.jar al directorio \ext. \win32_x86. Vaya al directorio
Abra InformationDesignTool.ini para la edición. Agregue la línea siguiente al final del archivo: -Dosgi.parentClassloader=ext
Guarde el archivo. Reinicie la aplicación. Una vez finalizada esta tarea habrá configurado por completo las conexiones a salesforce.com.
7.10.2 Para que funcionen las conexiones salesforce.com en la herramienta de diseño de universo Salga de la herramienta de diseño de universos. Abra el archivo cs.cfg para su edición. En la sección JavaVM, agregue la siguiente ruta: C:\Program Files (x86)\Progress\DataDirect\Connect_for_ODBC_61\java\lib \sforce.jar
Guarde el archivo. Abra el archivo openaccess.sbo para editarlo. \connectionServer\odbc. Se encuentra en el directorio
Agrega la siguiente línea en la sección Base de datos: No
Guarde el archivo. Reinicie el servicio y la aplicación. Una vez finalizada esta tarea habrá configurado por completo las conexiones a salesforce.com.
Información relacionada Transactional Available [página 191]
La capa de acceso de datos permite a la plataforma de BI acceder al origen de datos de SAP BW. Las conexiones a SAP BW a través de BAPI son las conexiones OLAP. La versión actual le permite crear universos .unv basados en SAP BW en MS Windows de 32 bits o de 64 bits, y UNIX de 64 bits. Las conexiones de SAP BW funcionan con un servidor de conexiones de 32 bits para sistemas operativos de 32 bits o con un servidor de conexiones de 64 bits para sistemas operativos de 64 bits.
7.11.1
Para permitir conexiones de 64 bits de SAP BW
Puede utilizar conexiones de SAP BW con un servidor de conexión de 64 bits para construir universos .unv. Puede instalar el controlador de 64 bits de SAP BW en una plataforma de SAP BusinessObjects BI en Microsoft Windows de 64 bits. Siga los pasos siguientes según el tipo de instalación que realice: ○
○
Si realiza una instalación completa de esta versión, las conexiones de SAP BW utilizarán el servidor de conexión de 64 bits. Si realiza una instalación de revisión sobre una plataforma existente, las conexiones de SAP BW continuarán utilizando el servidor de conexión de 32 bits. Para usar el servidor de conexiones de 64 bits, modifique la instalación de la plataforma:
a) En el panel de control, localice el programa de instalación completo más reciente de la plataforma de BI.
Recuerde No puede llevar a cabo el paso siguiente en la actualización del programa de la plataforma. b) Haga clic con el botón derecho y seleccione Desinstalar/Cambiar. c) En la pantalla Actualización de aplicación del cuadro de diálogo configuración de la plataforma de SAP BusinessObjects BI, seleccione Modificar y haga clic en Siguiente. d) En la pantalla Seleccionar funciones, seleccione la opción SAPBW64 en Acceso a base de datos. e) Haga clic en Siguiente y complete la instalación. Ha instalado el controlador de 64 bits de SAP BW en la plataforma. Ahora puede crear conexiones de SAP BW que usen el servidor de conexiones de 64 bits en Microsoft Windows de 64 bits.
Manual de acceso a los datos Documentación de conexión
7.12 Conexiones de SAP ERP - Error de controlador al cargar El siguiente mensaje de error puede aparecer en SAP BusinessObjects Web Intelligence: Database error: (CS) "Java Exception : java.lang.NoClassDefFoundError: com/sap/bip/jco/JCoManager : cannot initialize class because prior initialization attempt failed"
Significa que el controlador de SAP ERP no puede cargarse, ya que el servidor de procesamiento de Web Intelligence no puede encontrar el archivo sapjco3.dll. Para hacer funcionar la conexiones de SAP ERP, tiene que copiar el archivo del directorio de servidor de \win64_x64) al directorio de MS Windows ( C:\WINDOWS\system32). plataforma de BI ( Luego, reinicie el servidor de procesamiento de Web Intelligence.
7.13 Conexiones SAP HANA La capa de acceso a datos permite que la plataforma de BI se conecte a la base de datos de SAP HANA 1.0 SPS 08 mediante la utilización de ODBC y JDBC en todas las plataformas. La versión actual también admite conexiones OLAP a la base de datos SAP HANA en MS Windows, Linux y AIX.
Tamaño Array fetch El valor predeterminado de Tamaño Array fetch es 1000 para conexiones SAP HANA.
Precaución Debido que un número elevado para Tamaño Array fetch requiere más memoria, esta configuración puede afectar al rendimiento de su sistema.
Recuperación tras fallos Las conexiones a los clústeres de los servidores de SAP HANA que funcionan en modo de recuperación tras fallos se admiten a través de ODBC y de JDBC. El controlador elige uno de dichos servidores y, si no está disponible, se usa el siguiente. Si no hay ningún servidor disponible, se produce un error de conexión.
Configuración regional de visualización preferida Las conectividades de SAP HANA admiten la configuración regional de visualización preferida (PVL) para todos los modos de autenticación y únicamente a través de JDBC y ODBC. La PVL permite que el usuario recupere datos localizados si la base de datos almacena datos en varios idiomas.
Inicio de sesión único a la base de datos La plataforma de BI proporciona inicio de sesión único (SSO) a la base de datos usando Windows AD con Kerberos o el protocolo SAML en las plataformas de MS Windows y Linux. SSO con Kerberos está disponible para conexiones JDBC y ODBC. SSO con SAML está disponible en JDBC, pero no en ODBC. Si las implementaciones Kerberos y SAML están disponibles en su entorno, la plataforma usa SAML como prioritaria. Si se produce un problema usando SAML, la plataforma usa Kerberos en su lugar. Esta lógica es transparente al usuario de la aplicación. Para desactivar el uso de SAML, establezca el parámetro Omitir SSO SAML en True en el archivo de configuración newdb.sbo adecuado. La plataforma de BI también proporciona SSO a la base de datos usando Windows AD con Kerberos o el protocolo SAML en conexiones OLAP. Cuando los usuarios inician sesión en la plataforma de BI desde una aplicación de SAP BusinessObjects, pueden realizar acciones que requieren acceso a la base de datos, como actualizar documentos de Web Intelligence, sin proporcionar sus credenciales para la base de datos.
Soporte UNIX Al empezar a partir de la versión 4.1, la capa de acceso a datos permite que la plataforma de BI se conecte a la base de datos de SAP HANA a través de ODBC en plataformas UNIX de 64 bits.
Uso de SSL Las conexiones relacionales y OLAP pueden utilizar el protocolo SSL.
Crear una conexión JDBC Los controladores SAP HANA 1.0 SPS 08 JDBC se instalan como parte de la plataforma de Business Intelligence \connectionServer\jdbc\drivers\newdb. Por en el directorio consiguiente, no necesita realizar ninguna configuración adicional para crear una conexión con la base de datos SAP HANA. Seleccione una de las siguientes opciones en el asistente de conexiones para crear una conexión JDBC: Servidor único
●
Introduzca el nombre de host HANA y el número de la instancia en los campos Nombre de host y Número de instancia. Servidores múltiples (conmutación por error)
●
Introduzca el host del servidor y el puerto separados por un punto y coma en Servidor (host:port{;host:port}). Introduzca información para uno o varios servidores si desea tomar ventaja del mecanismo de conmutación por error. A continuación encontrará la convención para números de puerto: 3##15
donde ## es el número de instancia de HANA.
Ejemplo Si se está conectando a una instancia 0, escriba el número de instancia 00 o el número de puerto 30015 en el asistente. Si se está conectando a una instancia 1, escriba el número de instancia 01 o el número de puerto 30115 en el asistente.
Usar SSL Seleccione Usar SSL en el asistente de conexiones para crear una conexión OLAP o JDBC que use el protocolo SSL para conectarse a un servidor de SAP HANA.
Nota Para usar SSL en ODBC en MS Windows, abra el administrador de origen de datos ODBC y seleccione SSL al configurar el DSN.
7.13.2 Editar una conexión SAP HANA Una conexión SAP HANA abierta para la edición se puede mostrar en Servidor único o Servidores múltiples (conmutación por error) en el asistente de conexión. Para editar el filtro, realice una de las siguientes acciones: ● ●
Si se muestra en Servidor único, modifique el nombre de host y el número de instancia del origen de datos. Si se muestra en Servidores múltiples (conmutación por error), modifique el host y el puerto del servidor.
7.13.3 Antes de configurar el inicio de sesión único para conexiones SAP HANA Recuerde Esta sección trata sobre la configuración del inicio de sesión único mediante Windows AD con Kerberos para conexiones SAP HANA. Antes de configurar las opciones necesarias de Java VM, debe crear los archivos de configuración bscLogin.conf de JAAS y krb5.ini de Kerberos para preparar la aplicación para la autenticación con Windows AD. Consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence para obtener más información.
Información relacionada Configurar el inicio de sesión único en SAP HANA para la herramienta de diseño de información [página 133] Configurar el inicio de sesión único en SAP HANA para Web Intelligence [página 134] Configurar el inicio de sesión único en SAP HANA para el cliente enriquecido de Web Intelligence [página 135] Antes de configurar el inicio de sesión único para conexiones SAP HANA [página 133]
7.13.4 Configurar el inicio de sesión único en SAP HANA para la herramienta de diseño de información Con los siguientes pasos se activa el inicio de sesión único en bases de datos SAP HANA mediante JDBC utilizando la herramienta de diseño de información. Realice una de las siguientes acciones: Salga de la herramienta de diseño de información. Abra el archivo InformationDesignTool.ini para editarlo. \win32_x86. Se encuentra en el directorio
Manual de acceso a los datos Documentación de conexión
-Djava.security.auth.login.config=C:\ \bscLogin.conf -Djava.security.krb5.conf=C:\ \Krb5.ini donde es el directorio del archivo de configuración en el equipo donde se ejecuta el servidor de conexión. Guarde el archivo. Reinicie la herramienta de diseño de información. El objetivo es configurar el servicio de conectividad de Adaptive. Abra la CMC. En Servicios de conectividad , detenga el servicio de conectividad de Adaptive que aloja el servidor de procesamiento de Adaptive. Diríjase a la página Propiedades. Agregue las siguientes opciones a la propiedad Parámetros de línea de comandos :
-Djava.security.auth.login.config=C:\ \bscLogin.conf -Djava.security.krb5.conf=C:\ \Krb5.ini donde es el directorio del archivo de configuración en el equipo donde se ejecuta el servidor de conexión. Haga clic en Guardar. Reinicie el servicio desde la CMC.
Recuerde También debe configurar el servicio de conectividad de Adaptive para habilitar el SSO con el cliente enriquecido de Web Intelligence en modo conectado. Estos pasos también le permiten configurar el inicio de sesión único para el resto de servicios Java, como los servicios de federación de datos. Puede usar los servicios de federación de datos para realizar consultas en un universo habilitado para varias fuentes basado en una conexión a SAP HANA.
7.13.5 Configurar el inicio de sesión único en SAP HANA para Web Intelligence Los siguientes pasos activan el inicio de sesión único en la base de datos SAP HANA mediante JDBC para SAP BusinessObjects Web Intelligence.
Nota Este procedimiento también se aplica a la interfaz Java o HTML de SAP BusinessObjects Web Intelligence que el usuario de aplicaciones inicia desde la plataforma de lanzamiento de Business Intelligence.
Recuerde Esta configuración solo afecta a los servicios de generación de informes de Web Intelligence que aloja el servidor de procesamiento de Web Intelligence.
Abra la CMC. En Servicios de Web Intelligence, detenga el servicio de generación de informes alojado en el servidor de procesamiento de Web Intelligence. Abra el archivo cs.cfg para su edición. En la sección JavaVM, agregue las siguientes opciones de Java VM:
donde es el directorio del archivo de configuración en el equipo donde se ejecuta el servidor de conexión. Guarde el archivo. Reinicie el servicio desde la CMC.
7.13.6 Configurar el inicio de sesión único en SAP HANA para el cliente enriquecido de Web Intelligence Los siguientes pasos activan el inicio de sesión único en la base de datos SAP HANA mediante JDBC desde la aplicación Cliente enriquecido de Web Intelligence. Siga uno de los procedimientos indicados a continuación: ○
Si se conecta al Cliente enriquecido de Web Intelligence desde un documento WID o el menú Inicio de Windows: Cierre el documento y salga del Cliente enriquecido de Web Intelligence. Cree las siguientes variables de entorno:
donde es el directorio del archivo de configuración en el equipo donde se ejecuta el servidor de conexión. Reinicie el Cliente enriquecido de Web Intelligence. Si utiliza el Cliente enriquecido de Web Intelligence en el modo Conectado desde la plataforma de lanzamiento de Business Intelligence (también conocido como modo HTTP), debe configurar el servicio de conectividad de Adaptive. Siga los pasos que se describen a continuación para configurar el inicio de sesión único para la herramienta de diseño de información.
Manual de acceso a los datos Documentación de conexión
Información relacionada Configurar el inicio de sesión único en SAP HANA para la herramienta de diseño de información [página 133]
7.13.7 Establecer la Máquina virtual de Java para la instrumentación con las conexiones de SAP HANA Puede controlar la actividad de los controladores SAP HANA si instala CA Wily Introscope con la plataforma de Business Intelligence. Esta instrumentación proporciona compatibilidad con seguimiento integral para las conexiones SAP HANA mediante ODBC y JDBC. El seguimiento de SAP HANA se activa de forma predeterminada en la plataforma. Sin embargo, también tiene que configurar la Máquina virtual de Java para usar el puente JNI. Abra el archivo cs.cfg para su edición. Agregue las siguientes rutas de archivo JAR a la sección JavaVM para cargar las clases necesarias: " \java\lib\TraceLog.jar; \java\lib \external\com.sap.js.passport.api.jar"
Agregue las siguientes opciones a la sección JavaVM:
Guarde el archivo. Abra IntroscopeAgent_CSJNI.profile para editarlo. \java\wily. Se encuentra en el directorio
Sustituya localhost con el nombre de host del agente de Introscope en la siguiente línea: introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost
7.14 Conexiones de SAP MaxDB En ODBC, asegúrese de usar el controlador SAP MaxDB ODBC versión 7.7.07 (número de versión 07 o superior). SAP MaxDB proporciona los controladores ASCII y Unicode para MS Windows y UNIX. La versión ASCII del controlador de ODBC siempre se conecta a la referencia de la base de datos con ASCII. La versión Unicode del controlador de ODBC se conecta a referencias de la base de datos ASCII a través de ASCII, y a las referencias de base de datos Unicode con UCS2. SAP MaxDB no requiere ningún gestor de controlador es específico en UNIX. Sin embargo, se puede configurar para que funcione con los siguientes gestores de controladores si es necesario: ● ●
unixODBC 2.0.9 o superior iODBC 3.0.5 o superior
En JDBC, asegúrese de que usa la versión más reciente del controlador sapdbc.jar. Para obtener más información sobre el controlador JDBC de SAP MaxDB, consulte el archivo de configuración maxdb.sbo.
7.15 Conexiones de SAP NetWeaver BW Las conexiones relacionales a SAP NetWeaver BW no utilizan el servidor de conexión. Dichas conexiones pasan por un conector dedicado y usan una fachada específica en SAP NetWeaver BW. Para obtener información detallada sobre cómo configurar y ajustar las c onexiones a SAP NetWeaver BW, consulte el Manual de la herramienta de administración de Data Federator.
7.15.1 Requisitos de conexión de Data Federator a SAP NetWeaver BW Para conectarse a SAP NetWeaver BW, se debe tener una versión compatible de SAP NetWeaver BW y las notas de SAP adecuadas: ●
La versión mínima necesaria es SAP NetWeaver BI 7.01 SP06.
Nota El nombre oficial SAP NetWeaver BW ha cambiado entre las distintas versiones. Antes de la versión 7.3, se llamaba SAP NetWeaver BI. ●
La nota de SAP necesaria es: https://service.sap.com/sap/support/notes/1460273
.
Para más detalles acerca de las versiones soportadas de SAP NetWeaver BW, consulte la matriz de disponibilidad de productos.
Manual de acceso a los datos Documentación de conexión
7.15.2 Requisitos para hacer que las conexiones SAP NetWeaver BW funcionen en la herramienta de diseño de información Una aplicación externa como la herramienta de diseño de información puede conectarse a SAP NetWeaver BW si lo permite SAP Gateway. Para hacer que las conexiones funcionen en la herramienta de diseño de información, asegúrese que la configuración de seguridad de SAP Gateway para programas externos está configurada correctamente. Para más información, véase la documentación en línea de SAP Gateway.
Información relacionada Parámetros de seguridad - Conectividad - Biblioteca SAP
7.15.3 Requisitos para acceso a universos habilitados para varios orígenes en SAP NetWeaver BW Los usuarios de la aplicación necesitan autorizaciones para acceder a los universos de origen múltiple basados en la base de datos de SAP NetWeaver BW. Para obtener información sobre las autorizaciones necesarias para los usuarios de las aplicaciones de consulta y generación de informes a fin de acceder a universos de orígenes múltiples en SAP NetWeaver BW, consulte la nota SAP #1465871.
Información relacionada Nota de SAP #1465871
7.16 Conexiones SAS Las conexiones a SAS no usan el servidor de conexión. Usan un conector JDBC adaptado para conjuntos de datos SAS/SHARE. Para configurar estas conexiones, tendrá que instalar un controlador JDBC compatible. Para obtener más información sobre cómo configurar los conectores SAS, consulte el Manual de la herramienta de administración de Data Federator.
Si desea usar un conector SAS, debe instalar un controlador que permita que el motor de consulta de la federación de datos se conecte a un servidor SAS/SHARE. Un servidor SAS/SHARE es un servidor que permite la conexión con conjuntos de datos SAS. Para obtener más información sobre SAS/SHARE, consulte el sitio web de SAS. El directorio donde debe copiar los archivos jar del controlador JDBC SAS en el equipo donde ha instalado la /java/pjs/services/DataFederatorService/resources/ plataforma de BI es drivers/sas. Debe crear los directorios drivers/sas dentro del directorio resources. Para más detalles acerca de las versiones soportadas de SAS, consulte la matriz de disponibilidad de productos.
7.17 Conexiones Teradata - Asignar base de datos Teradata a propietario actual La siguiente sección proporciona información de configuración para conexiones Teradata. Una base de datos Teradata admite propietarios de tabla, pero no calificadores. El servidor de conexión devuelve el usuario actual como propietario actual para orígenes de datos de Teradata. Sin embargo, el origen de datos se debe configurar para asignar un usuario a la base de datos de otro usuario. En este caso, puede configurar el controlador Teradata para asignar el propietario actual a la base de datos con el parámetro Sustituir propietario actual con base de datos . Solo puede usar este parámetro con conexiones ODBC.
Información relacionada Replace Current Owner With Database [página 206]
Manual de acceso a los datos Documentación de conexión
8 Crear una conexión con el servidor de consultas de Data Federator XI 3.0 8.1 Acerca de las conexiones del servidor de consultas Data Federator XI 3.0 Puede crear conexiones a las tablas desplegadas en Data Federator XI 3.0 Query Server con el objeto de usarlas con una aplicación de SAP BusinessObjects. En este capítulo se describe la configuración que se debe desplegar en Data Federator XI 3.0 Query Server y en el servidor de conexión para crear conexiones. Solo se pueden crear conexiones a Data Federator XI 3.0 Query Server mediante la herramienta de diseño de universos. Este capítulo también indica la configuración que se debe implementar en el asistente de conexión con el objeto de poder crear conexiones.
Conexiones JDBC No se necesitan configuraciones adicionales para crear conexiones JDBC. El controlador JDBC de Data Federator se suministra con la plataforma de SAP BusinessObjects Business Intelligence 4.0, y está configurado para ejecutarse correctamente con el servidor de consultas de Data Federator XI 3.0.
Conexiones ODBC En el caso de las conexiones ODBC, la configuración depende de la aplicación de SAP BusinessObjects que esté usando. El proceso es diferente si está creando una conexión para usarla con el Cliente enriquecido de Web Intelligence.
Precaución SAP recomienda usar una conectividad de JDBC para conectar aplicaciones de SAP BusinessObjects a Data Federator XI 3.0 Query Server. La conectividad de JDBC está disponible en todas las plataformas (Microsoft Windows, tipos de UNIX y Linux). El middleware ODBC de Data Federator sólo se puede usar en Microsoft Windows y, debido al uso de OpenAccess ODBC to JDBC Bridge, tiene repercusión en el rendimiento.
Información relacionada Configurar el asistente de conexión para una conexión JDBC o ODBC de Data Federator [página 141]
Crear una conexión con el servidor de consultas de Data Federator XI 3.0
Acerca de las conexiones del servidor de consultas Data Federator XI 3.0 [página 140] Configurar conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC de Data Federator
[página 143]
8.2 Configurar el asistente de conexión para una conexión JDBC o ODBC de Data Federator Con el objeto de crear una conexión a Data Federator XI 3.0 Query Server, necesita la siguiente información. Consulte con el administrador de Data Federator para obtener los siguientes detalles: ● ●
●
El puerto y el nombre del servidor en el que se está ejecutando el servidor de Data Federator El nombre del catálogo de Data Federator Query Server En el asistente de conexión, introdúzcalo como nombre de la base de datos con la que se está conectando. Los detalles de autenticación de la instalación de Data Federator Query Server que alimenta el catálogo con el que se está conectando
En el asistente de conexión, desde la pantalla Selección del middleware de la base de dat os, podrá usar el middleware de SAP BusinessObjects, el servidor de Data Federator, los controladores JDBC o los controladores ODBC para crear la conexión. Para configurar una conexión ODBC a Data Federator XI 3.0 Query Server, existen algunas configuraciones adicionales que se deben realizar. Si está utilizando el Cliente enriquecido de Web Intelligence, los cambios de configuración requeridos son diferentes de los utilizados por otras aplicaciones de SAP BusinessObjects.
8.3
Configurar conexiones ODBC de Data Federator
Esta sección contiene la configuración adicional de Data Federator XI 3.0 Query Server, así como los cambios de configuración del servidor de conexión para las conexiones de ODBC a todas las aplicaciones de SAP BusinessObjects, excepto el Cliente enriquecido de Web Intelligence. Los detalles de configuración de esta sección hacen referencia a las rutas de acceso siguientes: ●
●
●
\OaJdbcBridge: Directorio de
instalación raíz para el middleware ODBC de Data Federator. El administrador eligió este directorio al ejecutar el instalador de controladores de Data Federator. \JdbcDriver: Directorio de instalación raíz del middleware JDBC de Data Federator. El administrador eligió este directorio al ejecutar el instalador de Data Federator. : directorio de instalación raíz para las aplicaciones de SAP BusinessObjects.
Nota Edite los archivos en un editor de XML para asegurarse de que sus archivos tengan el formato correcto. Tras efectuar los cambios en la configuración detallados a continuación, reinicie el sistema para que se apliquen dichos cambios.
Manual de acceso a los datos Crear una conexión con el servidor de consultas de Data Federator XI 3.0
Información relacionada Configurar el middleware ODBC de Data Federator [página 142] Configurar el servidor de conexión para una conexión de ODBC de Data Federator [página 142]
8.3.1
Configurar el middleware ODBC de Data Federator
Nota Este tema se aplica a todas las aplicaciones de SAP BusinessObjects que usan el servidor de conexión, salvo el Cliente enriquecido de Web Intelligence. Para configurar el middleware ODBC de Data Federator, debe modificar el archivo openrda.ini. Este archivo se instala en el siguiente directorio: ●
\OaJdbcBridge\bin\iwinnt
Establezca los parámetros en la sección [JavaIp] de la siguiente manera: ●
CLASSPATH= \OaJdbcBridge\oajava \oasql.jar; \JdbcDriver \thindriver.jar; \SAP BusinessObjects Enterprise XI 4.0\java\lib\ConnectionServer.jar
Nota Revise el archivo openrda.ini para asegurarse de que esta ruta de acceso no esté definida con el parámetro Djava.endorsed.dirs. En caso afirmativo, deberá eliminar la ruta de acceso del parámetro Djava.endorsed.dirs.
8.3.2 Configurar el servidor de conexión para una conexión de ODBC de Data Federator Nota Este tema se aplica a todas las aplicaciones de SAP BusinessObjects que usan el servidor de conexión, salvo el Cliente enriquecido de Web Intelligence. Para configurar el servidor de conexión, debe cambiar el archivo de configuración: \connectionServer\cs.cfg
Crear una conexión con el servidor de consultas de Data Federator XI 3.0
Para configurar el archivo cs.cfg, defina parámetros bajo la etiqueta JavaVM, del siguiente modo: \\ \\OaJdbcBridge\\oajava\\oasql.jar Path> \\ \\JdbcDriver\\thindriver.jar
8.4 Configurar conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC de Data Federator Al crear conexiones del Cliente enriquecido de Web Intelligence que utilicen el middleware ODBC de Data Federator, es necesario realizar los cambios de configuración descritos en esta sección. Sin las modificaciones correctas en la configuración, la conexión genera errores. Este tipo de conexión sólo es compatible con entornos Windows.
Recuerde Los detalles que se indican a continuación sólo están relacionados con el Cliente enriquecido de Web Intelligence. Para crear conexiones que hagan uso del middleware ODBC de Data Federator, debe modificar las configuraciones de: ● ● ●
El middleware ODBC servidor de conexión La clave de registro del Cliente enriquecido de Windows
Los detalles de configuración de esta sección hacen referencia a las rutas de acceso siguientes: ●
●
●
\OaJdbcBridge: Directorio de
instalación raíz para el middleware ODBC de Data Federator. El administrador eligió este directorio al ejecutar el instalador de controladores de Data Federator. \JdbcDriver: Directorio de instalación raíz del middleware JDBC de Data Federator. El administrador eligió este directorio al ejecutar el instalador de Data Federator. : directorio de instalación raíz para las aplicaciones de SAP BusinessObjects.
Nota Edite los archivos en un editor de XML para asegurarse de que sus archivos tengan el formato correcto.
Información relacionada Configurar conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC de Data Federator
[página 143]
Manual de acceso a los datos Crear una conexión con el servidor de consultas de Data Federator XI 3.0
Configurar el servidor de conexión para una conexión del Cliente enriquecido de Web Intelli gence con Data Federator [página 144] Definir la clave de registro del Cliente enriquecido de Windows [página 145] Configurar el servidor de conexión para conexiones de Cliente enriquecido de Web Intelligence o la herramienta de diseño de universos con Data Federator [página 145]
8.4.1 Configurar el middleware ODBC de Data Federator para una conexión de Cliente enriquecido de Web Intelligence Para configurar el middleware ODBC de Data Federator, debe modificar el archivo openrda.ini. Este archivo se instala en el siguiente directorio: ●
\OaJdbcBridge\bin\iwinnt
Para configurar el archivo openrda.ini, defina parámetros en la sección [JavaIp] del siguiente modo: ●
CLASSPATH= \OaJdbcBridge\oajava \oasql.jar; \JdbcDriver \thindriver.jar; \SAP BusinessObjects Enterprise XI 4.0\java\lib\ConnectionServer.jar
●
JVM_DLL_NAME= \javasdk\jre6\bin\client\jvm.dll
Nota El Cliente enriquecido de Web Intelligence requiere JDK 6. JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.directory=
●
Nota Revise el archivo openrda.ini para asegurarse de que esta ruta de acceso no esté definida con el parámetro Djava.endorsed.dirs. En caso afirmativo, deberá eliminar la ruta de acceso del parámetro Djava.endorsed.dirs.
8.4.2 Configurar el servidor de conexión para una conexión del Cliente enriquecido de Web Intelligence con Data Federator Para configurar el servidor de conexión para una conexión del Cliente enriquecido de Web Intelligence con Data Federator, debe cambiar el archivo de configuración: \connectionServer\cs.cfg
Para configurar el archivo cs.cfg, defina parámetros bajo la etiqueta JavaVM, del siguiente modo: \\ \\OaJdbcBridge\\oajava\\oasql.jar Path>
Crear una conexión con el servidor de consultas de Data Federator XI 3.0
\\ \\JdbcDriver\\thindriver.jar
8.4.3 Definir la clave de registro del Cliente enriquecido de Windows Para modificar la clave del registro del cliente enriquecido de Windows, use una herramienta como regedit. En el registro, busque la clave HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI 4.0\default\WebIntelligence\RichClient. En esta clave, agregue los siguientes valores a la entrada classpath. Como sucede con todos los valores de claves de registro, los valores deben ir separados por un punto y coma. ○
\OaJdbcBridge\oajava \oasql.jar
○
\JdbcDriver\thindriver.jar
En la clave RichClient\JVMOptions, agregue el siguiente valor a la entrada 6 (si hay ya cinco entradas): ○
ODBCMode=true
8.4.4 Configurar el servidor de conexión para conexiones de Cliente enriquecido de Web Intelligence o la herramienta de diseño de universos con Data Federator Es posible usar una única configuración para crear una conexión de ODBC con Data Federator desde la herramienta de diseño de universos, así como desde el Cliente enriquecido de Web Intelligence. Además de la configuración descrita anteriormente, siga uno de los conjuntos de instrucciones siguientes: ●
Haga lo siguiente:
●
Ejecute la herramienta regedit. En el registro, localice la clave HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI 4.0\default\ConnectionServer\Configuration. \javasdk En esta clave, agregue el siguiente valor JVM Library a la entrada: \jre6\bin\client\jvm.dll. Haga lo siguiente: Abra el archivo cs.cfg para su edición. Localice la etiqueta JavaVM. Defina LibraryName en la misma ruta del directorio JVM especificada en el archivo openrda.ini: ... \\ \\javasdk\\jre6\ \bin\\client\\jvm.dll
Manual de acceso a los datos Crear una conexión con el servidor de consultas de Data Federator XI 3.0
Crear una conexión con el servidor de consultas de Data Federator XI 3.0
9 Configurar parámetros globales de acceso a los datos 9.1
Acerca de parámetros globales
Puede configurar los valores de parámetros globales que se aplican a todas las conexiones. Puede hacerlo para mejorar el rendimiento o para resolver problemas que surjan con la conexión. Los parámetros globales del acceso a datos se conservan en el archivo cs.cfg. Este es un archivo XML que contiene los parámetros de configuración del servidor de conexión y los parámetros de configuración predeterminados que se aplican a todos los controladores de acceso a datos. Para sustituir esta configuración global, puede editar los parámetros en el archivo de configuración SBO de cada controlador.
Información relacionada Configurar parámetros de controlador [página 166]
9.2
Acerca del archivo de configuración cs.cfg
En un sistema Microsoft Windows, el archivo cs.cfg se encuentra en la siguiente ubicación: ●
\connectionServer
En el archivo cs.cfg, puede configurar parámetros únicamente en estas secciones: ●
Capabilities
En esta sección se definen los parámetros que le permitirán especificar el uso del servidor de conexión local o remoto. ●
Configuración
En esta sección se definen los parámetros de configuración globales del servidor de conexión, incluidos los controladores que se cargan al inicio en el modo de biblioteca. ●
JavaVM
En esta sección se define la biblioteca predeterminada de la Máquina virtual de Java (JVM) que usará la capa de acceso de datos. ●
DriverDefaults
Esta sección define los parámetros que se aplican a todos los controladores de acceso a datos. Se pueden sustituir para un controlador específico por la configuración correspondiente en los archivos de configuración .sbo, donde es el nombre del controlador de acceso a datos con el que está relacionado el archivo SBO. ●
Traces
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
Esta sección define los parámetros que permiten el registro de la actividad de la conexión mediante el servidor de conexión en archivos de registro. La sección Locales define el juego de caracteres del sistema operativo para cada idioma disponible. No debe modificar los parámetros en esta sección.
9.3
Visualizar y editar un archivo cs.cfg
Vaya al directorio que almacena el archivo cs.cfg. Por ejemplo, en un sistema Microsoft Windows: \connectionServer\cs.cfg donde connectionserver> es la ruta en la que está instalado el software del servidor de conexión. es
Abra el archivo cs.cfg en un editor de XML. Expanda las secciones como sea necesario. Defina parámetros mediante la adición de parámetros y valores nuevos o mediante la modificación de los valores de parámetros existentes. Compruebe que el documento es válido con respecto a DTD; a continuación, guarde y cierre el archivo.
Recuerde Debe reiniciar el servidor de conexión después de editar el archivo cs.cfg.
9.4
Configurar los parámetros de configuración global
La sección Settings del archivo cs.cfg define los parámetros que se aplican a todos los controladores y no se puede personalizar para los controladores individuales de acceso a datos. Para visualizar o editar parámetros, abra el archivo cs.cfg en un editor de XML y vaya a la sección Settings. En el archivo, cada parámetro está definido en la etiqueta siguiente: ">
donde es el nombre del parámetro y es es el valor atribuido al parámetro. es Cada parámetro se muestra con la información siguiente: Ejemplo de la manera en que aparece el parámetro en el archivo XML Descripción del parámetro Valores posibles que se pueden definir para el parámetro (cuando se aplique) Valor predeterminado del parámetro
● ● ● ●
Nota Algunos parámetros se pueden modificar desde la Consola de administración central (CMC). Para obtener más información,, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business información Intelligence.
Determina la acció Determina acción n lleva llevada da a cabo cabo cuand cuando o se se produ produce ce un un fallo fallo al carga cargarr el contr controlad olador. or. El pará pará metro permite elegir entre la posibilidad de seguir utilizando la conexión sin el funcionamiento de todos los controladores o que se produzca un error grave y no funcione la conexión cuando se produce un fallo al cargar un controlador.
Nota Este parámetro se omite en el modo de despliegue del servidor. Valores
Sí: el servidor de conexión genera un mensaje de advertencia cuando se produce un fallo al
cargar el controlador. No: el servidor de conexión genera un error grave cuando se produce un fallo al cargar el con
trolador. Por defecto
Sí
Información relacionada Cargar controladores al iniciar [página 150]
9.4.5
Cargar controladores al iniciar
No
Precaución Load Drivers On Startup sólo se aplica al modo de biblioteca.
Descri Des cripci pción ón
Deter De termin minaa cóm cómo o se car cargan gan las bib biblio liotec tecas as de dell con contro trolad lador. or.
Valores
●
Sí: todos los controladores instalados se cargan durante la fase de inicialización.
●
No: los controladores se cargan cuando sean requeridos.
Por defecto
9.4.6
No
Max Pool Time
-1
Precaución Max Pool Time está disponible solamente en modo de biblioteca.
Configurar parámetros globales de acceso a los datos
Puede cambiar el tiempo de espera del conjunto de conexiones para el modo de servidor en la página Propiedades del servidor en la CMC. Consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence. El valor se aplica a instalacione instalacioness de servidor independientes de Connection Server. Para obtener información sobre el despliegue del servidor de conexión en un nodo dedicado, consulte el Manual de planificación de la plataforma de Business Intelligence de SAP BusinessObjects. Descri Des cripci pción ón
Determi Deter mina na la dura duració ción n máxima máxima dura durante nte la la que pued puedee perma permanec necer er inact inactiva iva en en el conjun conjunto to de co co nexiones una conexión no usada. Este dato es el límite máximo de duración de las conexiones. Un conjunto de conexiones es un mecanismo utilizado por los controladores de acceso a los datos para reutilizar las conexiones conexiones de la base de datos y así hacer el mejor uso posible de los recursos del sistema. Puede definir Max Pool Time solamente para el modo de despliegue de biblioteca. El valor se aplica a nodos que tienen el servidor de conexión instalado con productos de servidor.
Valores
-1: ningún tiempo de espera definido; se mantiene la conexión durante toda la sesión. 0: conexión no administrada por el grupo. >0: duración de inactividad (en minutos).
Por defecto
-1
Información relacionada Grupos de conexiones [página 32]
9.4.7
Instalar extensión de archivo
setup
Descripción
Nota No modifique este parámetro. Establece la extensión para los archivos de configuración del controlador de acceso a datos.
Por defecto
9.4.8
setup
Extensión externa SQL
rss
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
Configurar parámetros globales de acceso a los datos
Nota Solo se pueden validar los archivos de configuración cuando se usan conectividades basa das en Java. Por defecto
No
9.4.12 Validar transferencias XML No
Descripci Descr ipción ón
Activa la Activa la valid validació ación n de las secu secuencia enciass XML XML anali analizada zadass dentro dentro de la impl implemen ementació tación n del del Servi Servi dor de conexión en oposición al esquema XML (por ejemplo: definición de conexión).
Nota Solo se pueden validar las secuencias XML cuando se usan conectividades basadas en Java. Por defecto
No
9.4.13 Configuración JVM La siguiente tabla le explica el parámetro Opción de JVM junto con los siguientes ejemplos: Tabla 8:
Por defecto
Processor="32"
En este ejemplo, como no se men cionó un atributo Procesador, las Herramientas del cliente y servidor utilizan esta Opción de manera pre determinada.
En este ejemplo el atributo Procesa dor se fija en “32”. Las Herramien tas del cliente utilizan esta Opción.
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
En este ejemplo el atributo Procesa dor se fija en “64”. El Servidor utiliza esta Opción.
9.5
Configurar el modo de despliegue
La sección Capabilities ayuda a especificar el modo de despliegue del servidor de conexión para su uso en tiempo de ejecución. Bajo la sección Capabilities, el nombre Local indica que el servicio de conexión se ofrece localmente, como una biblioteca activa incrustada en el proceso c liente. El nombre Remote indica que el servidor de conexión se proporciona a través de un servidor remoto. Puede habilitar estos tres modos de despliegue de forma independiente configurando el atributo Active. Específicamente para la funcionalidad Local, el atributo EnableJNI habilita el uso de Java Native Interface (JNI).
Nota Una JNI bidireccional incrustada en el servidor de conexión permite que las API funcionen con el núcleo del servidor de conexión desarrollado en un idioma diferente. Esto significa que puede usar la API Java para que funcione con el núcleo principal y viceversa.
Ejemplo La siguiente configuración posibilita el modo de despliegue de biblioteca con JNI y el modo de despliegue de servidor.
Ejemplo La configuración siguiente le permite usar el servidor de conexión solo en modo de servidor.
Configurar parámetros globales de acceso a los datos
En este modo, solo los controladores instalados en el sistema back-end de la plataforma de BI se pueden usar para crear conexiones. Si se está ejecutando una instancia de servidor, puede crear una conexión local basada en un controlador c ontrolador instalado en el sistema backend en la plataforma. Si detiene la instancia del servidor, no puede crear conexiones, porque este ajuste no permite que use un controlador instalado en el equipo del cliente.
Información relacionada Servicios de conectividad [página 22]
9.6
Configurar el modo de despliegue
Los parámetros definidos en la sección Settings del archivo cs.cfg controlan el modo de despliegue.
Modo de biblioteca Los parámetros de la sección Library controlan el modo de biblioteca.
Modo de servidor Puede administrar este modo desde la CMC de su instalación de SAP BusinessObj BusinessObjects ects Enterprise. Los parámetros que se muestran en la página Propiedades del servidor controlan el acceso CORBA. Consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence para obtener más información.
9.7
Configurar los controladores que se cargarán
De forma predeterminada, el servidor de conexión carga todos los controladores disponibles. Sin embargo, puede seleccionar los orígenes de datos que expondrá el servidor de conexión.
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
Modo de biblioteca Quite los comentarios de la sección ActiveDataSources junto a Library en el archivo cs.cfgy especifique las capas de red y las bases de datos que quiere cargar. Por ejemplo:
Nota Los nombres de las bases de datos pueden ser expresiones regulares si son ASCII puros. Los modelos usan la sintaxis regexp de GNU. Use el modelo .* para hacer coincidir cualquier carácter. Para obtener más información acerca de expresiones regulares, consulte el sitio Web de PERL en http://www.perl.com/doc/ manual/html/pod/perlre.html#Regular_Expressions
.
Modo de servidor Seleccione los orígenes de datos en la sección Orígenes de datos activos de las propiedades del servidor en la CMC.
Precaución Para evitar errores de conexión, debe asegurarse de que el entorno proporciona todo el middleware necesario; necesario; de lo contrario, deberá configurar las capas de red y bases de datos que necesita en la sección Orígenes de datos activos. Si permite la l a especialización de servidores, esta configuración afect a también a los escenarios de despliegue complejos que implican varios servidores de conexión en el modo de servidor. Para obtener más información sobre escenarios de despliegues complejos, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence.
9.7.1
Configurar una conectividad por equipo
En escenarios de despliegue complejos, es posible que desee configurar una conectividad por tipo de equipo, por ejemplo, si desea conectar aplicaciones que se proporcionen con la plataforma de BI a una base de datos de MS SQL Server instalada en Microsoft Windows y a una base de datos Oracle instalada en un equipo de UNIX. Para evitar errores de conexión, necesita realizar una de las siguientes opciones:
Configurar parámetros globales de acceso a los datos
●
●
Al realizar una instalación personalizada de la plataforma de BI, especifique las conectividades que desea desplegar para cada tipo de base de datos que necesite. Esto se realiza seleccionando las funciones que desearía instalar. Al configurar el Servidor de conexión en el archivo cs.cfg, debe configurar la sección ActiveDataSources del modo de biblioteca (elemento principal Library) de la misma manera que el modo de servidor de la CMC. Puesto que las aplicaciones intentan en primer lugar establecer conexiones a través de los controladores instalados de forma local, debe configurar el filtro de los controladores para ambos modos de la misma manera.
9.8
Configurar los protocolos de acceso CORBA
Puede fijar los protocolos de acceso CORBA en la CMC de la instalación de la plataforma de BI. Los protocolos definen los valores que el servidor de conexión usa para procesar solicitudes procedentes de clientes CORBA o clientes HTTP. Para obtener más información sobre la CMC, consulte el Manual del administrador de la plataforma de SAP BusinessObjects Business Intelligence.
9.9 Activar registros y seguimientos del servidor de conexión y de los controladores SAP distingue entre dos tipos de mensajes: ●
●
Un mensaje de seguimiento analiza el sistema de forma detallada desde el punto de vista del desarrollador como un procedimiento excepcional. Un mensaje de registro es un registro permanente de los eventos y estados de un sistema.
Los mensajes de error son para los administradores del sistema, y los seguimientos para los desarrolladores. Puede activar trazas para todas las conectividades que admite la capa de acceso a datos (por ejemplo, ODBC, JDBC, Javabean, OLE DB, OCI, y JCo). El proceso de seguimiento y de conexión del servidor de conexión confía en el inicio de sesión y la utilidad de seguimiento de SAP BusinessObjects TraceLog. Ayuda a registrar y seguir los procesos siguientes: Registros
● ● ●
Seguimientos
● ● ● ● ●
Inicio y parada de las instancias del servidor de conexiones Inicialización de inicio de sesión Cargar controlador Configuración e inicialización del servidor de conexión Creación y ejecución de tarea y diccionario Carga y actividad del controlador Inicio y parada de las instancias del servidor de conexiones Inicialización y actividad de servicios de las instancias del servidor de conexión
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
Configure los niveles de conexión y de seguimiento en el archivo de configuración _trace.ini. Por ejemplo, puede establecer la información siguiente en el archivo BO_trace.ini: sap_log_level = log_info; sap_trace_level = trace_debug; if (process == "cms") { log_level = error; // but only log errors for the CMS }
Contenido del archivo En el ejemplo anterior, las etiquetas definidas son las siguientes: ●
sap_log_level define el nivel de conexión
●
sap_trace_level define el nivel de seguimiento
●
Una parte de código para especificar el nivel de registro o seguimiento para un proceso. El código está basado en C o en Java y puede contener expresiones, enunciados simples, y enunciados if-else.
La tabla siguiente describe los valores de configuración aceptados por las etiquetas sap_log_level y sap_trace_level. Tabla 9: Nivel de registro de SAP
INFO
log_info o log_information
ADVERTENCIA
log_warn o log_warning
ERROR
log_error
FATAL
log_fatal
NINGUNO
log_none
Todos los mensajes del nivel de gravedad conjunto y superior aparecen en el archivo de registro. Por ejemplo, si establece la gravedad de registro en WARNING, todos los mensajes de gravedad WARNING, ERROR y FATAL están registrados. La gravedad del registro predeterminada es ERROR.
Configurar parámetros globales de acceso a los datos
Tabla 10: Nivel de seguimiento SAP
DEPURAR
trace_debug
PATH
trace_path
INFO
trace_info o trace_information
ERROR
trace_error
NINGUNO
trace_none
Todos los mensajes del nivel de gravedad conjunto y superior aparecen en el archivo de registro. Por ejemplo, si establece la gravedad de seguimiento en INFO, todos los mensajes de gravedad INFO y error están registrados. La gravedad del seguimiento predeterminada es ERROR.
Opciones de configuración También puede agregar las opciones siguientes al archivo:
always_close
true o false
Cierra el archivo de registro después de cada escri tura. El valor predeterminado es false.
anexar
true o false
Agrega la información de registro a los archivos de re gistros existentes. Modifica el modelo de nombres para excluir el PID y el huso horario, y en su lugar usa un número de archivo de registro actual. El valor pre determinado es false.
keep_num
un entero
Especifica el número de archivos de registro a conser var. El valor predeterminado es 0. Un entero negativo significa que todos los archivos de registro se conser van.
log_dir
una cadena
Especifica el directorio de archivos de registro. El valor predeterminado es el valor de la variable de entorno BO_TRACE_LOGDIR. Un guión ( -) significa que la infor mación de registro se dirige a stdout.
log_level
ninguno, bajo, medio o alto
Define un acceso directo para especificar los valores sap_log_level y sap_trace_level. Consulte la ta bla siguiente.
scope_only
true o false
Especifica si solo los mensajes asociados con alcances aparecen en los archivos de registro. El valor predeter minado es false.
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
Nota Un rango que marca la entrada y la salida de un blo que de código. un número en KB Tamaño máximo de un archivo de registro. El valor predeterminado es 10000.
size
valores de opción log_level La tabla siguiente proporciona los valores sap_log_level y sap_trace_level establecidos al especificar el valor log_level correspondiente en el archivo de configuración.
ninguno
log_error
trace_error
bajo
log_error
trace_info
medio
log_warn
trace_path
alto
log_info
trace_debug
Analizar errores Los errores y las advertencias que se pueden producir al analizar el archivo _trace.ini se escriben en un archivo ERR en el mismo directorio que el archivo INI. El nombre del archivo de error se genera con el nombre del archivo INI. Si varios procesos comparten el mismo archivo INI, no sabrá qué proceso genera el error. Para generar más nombres de archivo de error informativo, agregue las siguientes líneas en la parte superior del archivo _trace.ini: error_file = config_file + "_" + process + ".err"; output_file = config_file + "_" + process + ".out";
9.9.2
Activar registros y seguimientos en el archivo cs.cfg
Puede encontrar registros y seguimientos del servidor de conexión con los de las aplicaciones de SAP BusinessObjects, como por ejemplo SAP BusinessObjects Web Intelligence. También puede registrar y seguir el servidor de conexión de forma separada mediante la configuración del archivo cs.cfg.
Configurar parámetros globales de acceso a los datos
La sección Seguimientos del archivo le ayuda a activar seguimientos para controladores y tareas del servidor de conexión. Para activar las trazas de trabajos, ajuste el atributo Active de Job y JobLevel en Sí. Para activar las trazas de controladores, ajuste el atributo Active de Middleware en Yes. Puede activar las trazas para un controlador específico ajustando el atributo Active del controlador en Yes.
Ejemplo
...
Esta configuración habilita de forma predeterminada la conexión y el seguimiento del servidor de conexión y los controladores.
9.9.3
Activar registros y seguimientos en modo de biblioteca
Detenga el servidor de conexión. Cree y establezca los valores en las siguientes variables de entorno: ○
○
○
BO_TRACE_CONFIGDIR, para definir el nombre de la carpeta de archivos de configuración de registro, por ejemplo: C:\BOTraces\config BO_TRACE_CONFIGFILE, para definir el nombre del archivo de configuración, por ejemplo BO_trace.ini BO_TRACE_LOGDIR, para definir el nombre de la carpeta de registros, por ejemplo: C:\BOTraces
Nota Estas variables de entorno se usan normalmente para configurar las trazas de toda la actividad de la plataforma de Business Intelligence. Cree el archivo de configuración BO_trace.ini del siguiente modo: sap_log_level = log_info; sap_trace_level = trace_debug;
Nota En el nombre del archivo INI se distingue entre mayúsculas y minúsculas.
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
Agregue las rutas de los directorios de logging.jar y tracelog.jar a la variable de entorno CLASSPATH. Por ejemplo: C:\BOTraces\lib\logging.jar y C:\BOTraces\lib\tracelog.jar. Reinicie el Servidor de conexión. Los registros y los seguimientos se escriben en un archivo cuyo nombre predeterminado es TraceLog_ _ _trace.log. Si quiere ajustar un nombre diferente para el archivo de <> <> registro, actualice la variable de entorno BO_TRACE_PROCESS con el nuevo nombre.
9.9.4
Activar registros y seguimientos en modo de servidor
Puede activar las trazas para tareas y controladores desde la CMC. Así puede mantener el servidor en ejecución mientras activa las trazas. Inicie la CMC. Vaya a la página Propiedades del servidor ConnectionServer (para el servicio de conectividad nativa) o el servidor de procesamiento de Adaptive (para el servicio de conectividad de Adaptive). En la sección Seguimiento de nivel bajo, seleccione: ○
Activar trazas de tareas para activar las trazas de tareas.
○
Activar trazas de middleware para activar las trazas del middleware
Nota El nivel Registro de seguimiento debe ajustarse en Alto en la sección Servicio de registro de seguimiento . Este nivel es distinto del nivel de registro de SAP definido a través del archivo BO_Trace.ini.
Recuerde El ajuste de Activar trazas de middleware le permite trazar todo el middleware. Si solo desea trazar middleware específico, deberá configurar el archivo cs.cfg y reiniciar el servidor.
9.9.5
Leer registros y seguimientos
Los seguimientos y registros del servidor de conexión están etiquetados con |CS| en los archivos de seguimiento. A los registros del servidor de conexión también los identifica la mención THIS IS A LOG . Cada función tiene su propia traza. Los seguimientos contienen las siguiente información: ●
● ● ● ●
●
Seguimientos ENTER, que identifican la llamada API de middleware. Los seguimientos EXIT identifican la llamada devuelta. El API middleware no devuelve ninguna llamada si no hay SALIR después de INTRO. Excepciones de llamada, si se muestra |E| Errores de API, si se muestra el código de devolución -1 Gravedad de registro o error (Por ejemplo, Depurar, Ruta, o Información) La capa de red de seguimiento y la base de datos de la sección [Capa de red|Base de datos|ID] del seguimiento Los mensajes de error y registro
Configurar parámetros globales de acceso a los datos
Ejemplo El siguiente es un extracto de un seguimiento con gravedades DEBUG y PATH obtenidas al usar en servidor de conexión en modo de biblioteca: |BE42CC9D40484416BADEF01039652F620|2012 04 12 11:41:27.422|+0200|Debug| |<<| | | TraceLog| 5256| 1|main | ||||||||||||||||||||CS||[unknown|unknown|ID: 0]CS Internal Configuration: |BE42CC9D40484416BADEF01039652F621|2012 04 12 11:41:27.534|+0200|Debug| |<<| | | TraceLog| 5256| 1|main | ||||||||||||||||||||CS||[unknown|unknown|ID: 0] ... |BE42CC9D40484416BADEF01039652F628|2012 04 12 11:41:27.920|+0200|Path| | | | | TraceLog| 5256| 1|main | ||||||||||||||||||||CS||ENTER [JDBC|Oracle 11|ID: 0]com.sap.connectivity.cs.java.ConnectionManager{com.businessobjects.connectionser ver.ConnectionManager}.close |BE42CC9D40484416BADEF01039652F629|2012 04 12 11:41:27.920|+0200|Path| | | | | TraceLog| 5256| 1|main | ||||||||||||||||||||CS||EXIT [JDBC|Oracle 11|ID: 0]com.sap.connectivity.cs.java.ConnectionManager{com.businessobjects.connectionser ver.ConnectionManager}.close
Ejemplo El siguiente es un extracto de un seguimiento con gravedad INFO obtenida al usar el servidor de conexión en modo de servidor: |6E606102224D49849A2C17D8691FAC785011|2012 04 26 19:02:43.075|+0200|Information| | ==| | |aps_MySIA.csjava| 7088| 53|service builder-4| ||||||||||||||||||||CS|| [unknown|unknown|ID:0]Starting CORBA NetworkLayer service...
Ejemplo El siguiente es un extracto de un archivo obtenido al usar el servidor de conexión en modo de servidor: |6E606102224D49849A2C17D8691FAC7B5114|2012 04 26 19:02:43.805|+0200| | Information| | | |aps_MySIA.csjava| 7088| 61|service builder-1| ||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver: NetworkLayer=JDBC, Database=Generic JDBC datasource |6E606102224D49849A2C17D8691FAC7B5116|2012 04 26 19:02:43.817|+0200| | Information| | | |aps_MySIA.csjava| 7088| 61|service builder-1| ||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver: NetworkLayer=JDBC, Database=MaxDB 7.7 ... |43eabdad-d3e4-ec14-89aa-0c9a9fba3101|2012 04 26 19:02:20:883|+0200| | Information| | | |connectionserver_MySIA.ConnectionServer|1576|7816|| |0|94|0| 2|-|-|-|-|-|-||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]ConnectionServer is now started
Manual de acceso a los datos Configurar parámetros globales de acceso a los datos
9.10 Activar registros y seguimientos para el cliente OLAP Puede encontrar registros y seguimientos de cliente OLAP con los de las aplicaciones de SAP BusinessObjects, como por ejemplo SAP BusinessObjects Web Intelligence. Por ejemplo, los puede encontrar con seguimientos del servidor de procesamiento de Web Intelligence. También puede registrar y seguir el cliente OLAP de forma separada mediante la configuración del archivo OlapClient.cfg. Active registros configurando el atributo UseLog en sí en la sección OlapClient del archivo. Especifique la ruta del archivo de registro en el atributo LogFileName. No puede cambiar el valor UseProcessName. No tiene que detener el servidor de procesamiento de Web Intelligence para modificar estos ajustes. Puede activar los registros y seguimientos mientras se está ejecutando.
Ejemplo [OlapClient] UseLog =yes UseProcessName=false LogFileName =c:\OlapClient.log ; Factory Mode can be: Lib (inproc) or Proxy (Remoting) FactoryMode=Lib ...
Esta configuración habilita la conexión y el seguimiento para el cliente OLAP.
Información relacionada Acerca del archivo de configuración OlapClient.cfg [página 21]
9.10.1 Ejemplo de registro El ejemplo siguiente es un extracto de un archivo de registro para el cliente OLAP obtenido para una conexión MSAS. ... [2012/11/05 - 12:04:54:025][0] XmlaConnectionWinhttp::XmlaConnectionWinhttp() -> Using Windows HTTP Services version 6.1.7600.16385 [2012/11/05 - 12:04:54:025][0] HTTPClient::connect() -> Using direct access [2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Using Windows Proxy Automatic Discovery (WPAD) [2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Using proxy settings: WPAD url=http://proxy:8083, Proxy= ProxyBypass= [2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Connecting using WinHttpConnect(): Hostname='olap-wxp' Port=80 [2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::Open() -> Connected. [2012/11/05 - 12:04:54:040][0] XmlaClient::discover() Call 'DISCOVER_DATASOURCES'... [2012/11/05 - 12:04:54:040][0] SoapEnvelope::updateProperties() BeginRange=-1 EndRange=-1 [2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::SendRequest() Authentication Mode = Credentials.
10 Configurar parámetros de controlador de acceso a los datos 10.1 Configurar parámetros de controlador Para configurar el acceso a los datos de un controlador de acceso a datos concreto, puede editar los archivos de configuración del controlador para ajustar los valores de los parámetros o bien crear sus propias entradas en la base de datos si necesita conexiones para bases de datos específicas de su entorno.
Nota Para cada aplicación de SAP BusinessObjects que usa el servidor de conexión, el archivo Readme asociado contiene información acerca de las utilidades de línea de comandos que puede usar para comprobar la configuración del SGBDR (Sistema de gestión de bases de datos relacionales) y del controlador de acceso a datos. Estas utilidades pueden crear archivos de registro que realizan un seguimiento de la actividad del servidor de análisis interactivos. Consulte el archivo Readme de la versión correspondiente para obtener instrucciones de uso de estas utilidades.
Información relacionada Acerca de parámetros globales [página 147]
10.1.1
Archivos de configuración de acceso a datos
Los siguientes archivos de configuración controlan las configuraciones del controlador de acceso a datos para cada conexión definida: cs.cfg
●
Este archivo define los parámetros globales que se aplican a todas las conexiones. Se encuentra en el \connectionServer. directorio ●
.sbo
Este archivo es específico a cada controlador de acceso a datos. El marcador de posición hace referencia al origen de datos al que se aplica el archivo de configuración. Cada archivo SBO se encuentra en un subdirectorio del directorio connectionServer, donde el nombre del subdirectorio está basado en el nombre de la capa de red de la base de datos o del middleware, como, por ejemplo, \connectionServer\oracle para bases de datos de Oracle.
Nota Los parámetros establecidos en la sección DriverDefaults del archivo cs.cfg se reemplazan con la configuración correspondiente de los archivos SBO.
Configurar parámetros de controlador de acceso a los datos
●
.setup
Este archivo define el nombre del archivo SBO, el directorio y la capa de red de la base de datos o el middleware relacionado con el controlador. Este archivo es necesario para poder usar el controlador. No se podrá usar un controlador si carece de un archivo de configuración. Todos los archivos se encuentran en el directorio \connectionServer\setup. Directorio A modo de ejemplo, el siguiente archivo oracle_jdbc.setup define el archivo de configuración oracle.sbo para controladores de acceso a datos Oracle usados para establecer conexiones JDBC: ... jdbcoracle ...
10.1.2 Archivos SBO instalados .sbo están instalados de forma predeterminada en Microsoft Windows. Los siguientes archivos
En el sitio Web de SAP Service Marketplace, en en service.sap.com/bosap-support , encontrará una lista actualizada de los controladores compatibles; también puede ponerse en contacto con su representante de SAP.
db2
IBM DB2
db2.sbo
essbase
Oracle Essbase
essbase.sbo
javabean
Javabean
javabean.sbo
jco
SAP ERP
jco.sbo
jdbc
Servidor de Data Federator
datafederator.sbo
IBM DB2
db2.sbo
Derby
derby.sbo
Greenplum
greenplum.sbo
Manual de acceso a los datos Configurar parámetros de controlador de acceso a los datos
Configurar parámetros de controlador de acceso a los datos
MaxDB
maxdb.sbo
MS Excel 2007
msexcel.sbo
MySQL
mysql.sbo
HP Neoview
neoview.sbo
Netezza
netezza.sbo
SAP HANA
newdb.sbo
ODBC genérico y ODBC3 genérico
odbc.sbo
OpenAccess para Salesforce
openaccess.sbo
MS Excel 2010, 2013 y archivos de texto
personalfiles.sbo
Microsoft SQL Server
sqlsrv.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
HP Vertica 6.1
vertica.sbo
OLE DB genérico
oledb.sbo
Microsoft SQL Server
sqlsrv.sbo
oledb_olap
Microsoft Analysis Services
slqsrv_as.sbo
open
archivos CSV
open.sbo
oracle
Oracle
oracle.sbo
Oracle EBS
oracle_ebs.sbo
sap
SAP BW
sap.sbo
sybase
Sybase
sybase.sbo
xml
XML
xml.sbo
Servicios Web
webservices.sbo
oledb
El subdirectorio jdbc contiene los archivos de configuración para administrar conexiones a bases de datos a través de la capa de red de JDBC. Consulte el sitio web de SAP Service Marketplace o las series de archivos SBO para averiguar qué bases de datos son compatibles con conexiones de JDBC.
Manual de acceso a los datos Configurar parámetros de controlador de acceso a los datos
El subdirectorio odbc contiene el archivo de configuración mysql.sbo para administrar conexiones a la base de datos MySQL a través de la capa de red de ODBC. La base de datos MySQL 5 está disponible en todas las plataformas y dispone de compatibilidad con Unicode. Asegúrese de que utiliza MySQL Connector/ODBC 5.1.4 o una versión superior para conectarse a esta base de datos. Si utiliza una versión anterior del controlador en Unix, se producirán errores en el tiempo de ejecución. El subdirectorio odbc contiene los archivos de configuración greenplum4.sbo y access2010.sbo para gestionar las conexiones a Greenplum 4 y PostgreSQL 9 de un lado y a MS Access 2010 y 2013 del otro a través de la capa de red ODBC. Estos archivos son diferentes a los archivos greenplum.sbo y access.sbo, ya que implementan la configuración en MS Windows tanto de 32 bits como de 64 bits. Las bases de datos Greenplum 4 y PostgreSQL 9 también están disponibles en aderezos de UNIX de 64 bits. El subdirectorio odbc también contiene el archivo de configuración msexcel.sbo para administrar las conexiones a MS Excel 2007 mediante la capa de red de ODBC. Este archivo despliega a la configuración solo en MS Windows de 32 bits. El archivo de configuración personalfiles.sbo implementa la configuración para MS Excel 2010 y 2013 mediante ODBC en MS Windows de 32 y 64 bits. El subdirectorio open contiene el archivo de configuración open.sbo para administrar conexiones a archivos CSV mediante CSV OpenDriver. Al desarrollar un controlador CSV basado en el controlador de muestra CSV Open mediante el kit de desarrollo de controladores Java, debe situar todos los archivos de configuración en este directorio. Para obtener más información sobre este controlador, consulte Data Access Driver Java SDK Developer Guide (Manual del desarrollador del SDK de Java del controlador de acceso a datos).
10.1.3 Visualizar y editar archivos SBO Precaución Antes de abrir el archivo SBO, cree una copia de seguridad del archivo. Algunos parámetros de configuración no se deben editar. Si los cambia o los elimina, podría afectar al funcionamiento de las aplicaciones de SAP BusinessObjects. Vaya al directorio que almacena el archivo SBO del controlador de acceso a los datos de destino. Abra el archivo SBO en un editor de XML. Expanda las secciones como sea necesario. Localice la etiqueta adecuada para el valor que desee cambiar y cambie el valor. "> Parámetros que aparecen en el formato: ... datadirect ...
Añada la siguiente línea a la sección DataBase:
donde es la consulta que usa para verificar la validez.
Manual de acceso a los datos Configurar parámetros de controlador de acceso a los datos
Guarde el archivo SBO. Reinicie el servidor de conexión. El servidor de conexión valida que se puede usar la conexión antes de ejecutar la solicitud de datos.
10.1.6 Propiedades del controlador de JDBC Puede agregar propiedades del controlador de JDBC de la siguiente manera: En el asistente de conexión de la aplicación, en la creación de conexiones, establezca el parámetro Propiedades del controlador JDBC (clave==valor,clave==valor):. parameter. Es opcional. Establezca las propiedades del controlador en el archivo SBO adecuado tras detener el servidor de conexión.
●
●
Si la propiedad está establecida en el archivo SBO y en el asistente, la aplicación solo considerará el valor establecido en el asistente.
Ejemplo Este manual ofrece un ejemplo de la sección de un archivo oracle.sbo modificado con dos propiedades del controlador. com.businessobjects.connectionserver.java.drivers.jdbc.oracle.OracleDriver Class> oracle.jdbc.OracleDriverjdbc:oracle:thin:@§DATASOURCE§:§DATABASE§ Parameter> truetrue ... ...
Información relacionada Crear una conexión JDBC con el archivo SBO [página 51]
10.2 Acerca de los controladores DataDirect ODBC La capa de acceso a datos permite el uso de controladores DataDirect DataDirect ODBC 7.0 para bases de datos de MS SQL Server en todas las plataformas UNIX. Estos controladores pueden ser no personaliz personalizados ados o personaliza personalizados. dos.
Configurar parámetros de controlador de acceso a los datos
Estos controladores DataDirect DataDirect personalizados se proporcionan como parte de la plataforma de BI y solo se pueden usar con aplicaciones de SAP BusinessObje BusinessObjects cts como SAP BusinessObj BusinessObjects ects Web Intelligence. Los puede /enterprise_xi40/ /enterprise_xi40/ /odbc/lib, donde /odbc/lib encontrar en el directorio representa el directorio de instalación de la plataforma de BI y para el nombre de la representa plataforma de UNIX . Las bases de datos de MS SQL Server pueden trabajar con el controlador DataDirect ODBC 7.0 o el c ontrolador DataDirect ODBC 7.0 nombrado. También pueden funcionar con la versión 6.0 SP2 del controlador. Sin embargo, esta versión no viene con la versión de la plataforma actual. La configuración predeterminada del servidor de conexión permite que el controlador ODBC no personaliza personalizado do funcione sin problemas con la configuración actual. Si ya ha desplegado un controlador en su entorno, podrá instalar el controlador no personaliza personalizado do sin ningún cambio de configuración.
10.2.1 Activar el uso de los controladores personalizados DataDirect Para utilizar el controlador personalizado, debe asegurarse de que el acceso a datos está configurado correctamente. Desplácese al directorio que contiene el archivo sqlsrv.sbo. / En UNIX, este archivo de configuración se encuentra en el directorio connectionServer/odbc.
Use un editor de XML para abrir y editar el archivo sqlsrv.sbo. Localice la sección Defaults. El parámetro Use DataDirect OEM Driver está establecido en No de forma predeterminada. Esto significa que el acceso a datos está configurado de forma predeterminada para funcionar con controladores no personalizados. Establezca el parámetro Use DataDirect OEM Driver en Yes y guarde el archivo. Agregue la siguiente ruta a la variable de entorno LD_LIBRARY_PATH: /enterprise_xi40/ /enterprise_xi40/ /odbc/lib /odbc/lib
/setup y establézcalo /setup Configure el entorno editando el archivo env.sh en el directorio como origen. Por ejemplo: DEFAULT_ODBCFILE="${BOBJEDIR}enterprise_xi40/"odbc.ini Export DEFAULT_ODBCFILE ODBC_HOME="${BINDIR}odbc" Export ODBC_HOME ODBCINI="${BOBJEDIR}enterprise_xi40/"odbc.ini export ODBCINI
Nota DEFAULT_ODBCFILE puede señalar a cualquier archivo que contenga los datos de conexión de los
controladores marcados. Configure el origen de datos editando el archivo odbc.ini.
Manual de acceso a los datos Configurar parámetros de controlador de acceso a los datos
Por ejemplo: [ODBC Data Sources] sql2008=sql=DataDirect 7.0 SQL Server Native Wire Protocol Driver=/.../enterprise_xi40/linux_x64/odbc/lib/CRsqls24.so Description=DataDirect 7.0 SQLServer Wire Protocol Driver Address=10.180.0.197,1433 Database=bodb01
Inicie el servidor de conexión desde la CMC. El servidor de conexión puede crear una conexión con bases de datos de MS SQL Server con controladores DataDirect ODBC personalizados.
Ejemplo A continuación se ofrece un extracto del archivo sqlsrv.sbo predetermina predeterminado. do. ...
Configurar parámetros de controlador de acceso a los datos
11
Referencia de parámetro SBO
11.1
Estructura de archivo SBO
.sbo para cada controlador de acceso a datos admitido. Cada archivo .sbo Existe un archivo .sbo está dividido en las secciones siguientes: .sbo
Defaults
Esta sección contiene los parámetros de configuración predeterminados que se aplican a todo el middleware de base de datos que utilice el contro lador de acceso a los datos. Estos parámetros reemplazan cualquier valor correspondientee definido en el middleware de base de datos. correspondient
Databases
Esta sección contiene un elemento secundario DataBase para cada mid dleware de base de datos compatible con el controlador de acceso a datos. Cada elemento DataBase puede contener los siguientes elementos o atri butos: ●
●
●
●
Active: este atributo indica si está activada o no la admisión del mid dleware. Su valor es YES o NO. Name: este atributo indica el nombre del middleware admitido por el
controlador de acceso a datos. Los valores de nombres de middleware definidos aquí aparecen en la página de middleware de base de datos del asistente de conexión. Alias: este elemento indica el nombre de las versiones anteriores de middleware que ya no son admitidas de manera oficial por el controla dor de acceso a datos, pero que aún se usan. Puede agregar un ele mento de alias para una versión anterior de middleware, de modo que las conexiones existentes usen el controlador actual de acceso a da tos. Puede establecer parámetros de configuración específicos específicos para el middleware anterior como parámetros del nuevo alias. Puede crear co nexiones nuevas utilizando el alias. Parameter: este elemento tiene un atributo Name y un valor que se aplica específicamente específicamente a un middleware middleware.. Los valores definidos para los parámetros que se enumeran aquí reemplazan los valores definidos para los mismos parámetros de la sección Defaults.
Nota Los parámetros booleanos aceptan los valores true/false y yes/no. Los valores no distinguen entre mayúsculas y minúsculas.
Manual de acceso a los datos Referencia de parámetro SBO
Los parámetros de configuración se enumeran en el siguiente orden: ●
● ● ● ● ● ● ● ● ●
En común Esta sección describe los parámetros del archivo SBO que comparten diferentes tecnologías de base de datos. El resto de categorías describen los parámetros específicos de la tecnología de base de datos o la capa de red que representan. JavaBean JCO JDBC OData ODBC OLE DB DB OLE DB DB para OLAP Sybasee ASE/CTL Sybas Teradata Terad ata
Cada parámetro parámetro se muestra con la l a información siguiente: ● ● ● ●
Ejemplo de la manera en que aparece el parámetro en el archivo XML Descripción del parámetro Valores posibles que se pueden definir para el parámetro Valor predeterminado del parámetro
Información relacionada Parámetros de SBO comunes [página 176] Parámetros de JavaBean SBO [página 193] Parámetros de JCO SBO [página 194] Parámetros de JDBC SBO [página 194] Parámetros OData SBO [página 199] Parámetros ODBC SBO [página 199] Parámetros de OLE DB SBO [página 203] Parámetros de OLE DB OLAP SBO [página 203] Parámetros Sybase SBO [página 204] Parámetros Teradata SBO [página 206]
11.3
Parámetros de SBO comunes
Generalmente estos parámetros de SBO son comunes a todos los controladores de acceso a los datos. Se definen en la sección Defaults de los archivos. Algunos de estos parámetros de SBO se definen también en el
archivo cs.cfg. Los valores definidos en la sección Defaults sustituyen los valores definidos en el archivo cs.cfg.
11.3.1
Array Bind Available
No
Descri Des cripci pción ón
Indica Ind ica si la ba base se de da datos tos ad admit mitee la con conexi exión ón de ma matri trices ces.. La conexión de matrices ayuda a optimizar el rendimiento de las consultas de actualización de SQL.
Valores
Sí: la base de datos admite la conexión de matrices. No: la base de datos no admite la conexión de matrices.
Porr def Po defeect cto o
11.3.2
El va valor def efiini nido do en el el arc archi hivo vo cs.cfg.
Array Bind Size
Restricción Las herramientas de cliente de la plataforma de Business Intelligence Intelligence de SAP BusinessObj BusinessObjects ects no utilizan este parámetro. 5
Desc De scri ripc pció ión n
Indi In dica ca el el núme número ro de de fila filass expo export rtad adas as con con cad cadaa cons consul ulta ta INSERT.
Valores
Indica el número de filas que se exporta con cada INSERT (número entero).
Porr def Po defeect cto o
El va valor def efiini nido do en el el arc archi hivo vo cs.cfg.
11.3.3
Array Fetch Available
No
Descri Des cripci pción ón
Indica Ind ica si el el serv servido idorr de con conexi exión ón habi habilit litaa la la búsq búsqued uedaa de de matr matrice ices. s. La búsqueda de matrices ayuda a optimizar el rendimiento recuperando recuperando resultados SQL por sector.
Valores
Sí: se admite la búsqueda de matrices.
Manual de acceso a los datos Referencia de parámetro SBO
El val valo or de defi fini nido do en el arc archi hivo vo cs.cfg.
Array Fetch Size
10
Descripción
Especifica el número de filas de datos que se recuperan por sector. El El Servidor de conexión proporciona funcionalidad array fetch en cualquier modo de des pliegue.
Recuerde El valor Tamaño Array fetch se propaga al middleware de base datos si admite array fetch. El numero óptimo depende del rendimiento del sistema: ●
●
Si el número es bajo, el sistema devuelve pequeñas cantidades de datos muchas veces. Esto puede afectar al rendimiento. Si el número es alto, el sistema realiza pocas operaciones de recuperación, pero se requiere más memoria para cada una.
Precaución Asegúrese de que el valor de Tamaño Array fetch sea adecuado, ya que podría afectar al rendimiento del sistema, sobre todo en el acceso remoto; por ejemplo, cuando las conexiones al sistema de SAP ERP se establecen en un modo de despliegue de nivel Web. Para las conexiones OLAP en el acceso remoto (orígenes de datos de MS Analysis Services, SAP BW y Essbase a tra vés del servidor de conexión de 32 bits), configure el tamaño array fetch en un valor óptimo dependiendo del número de columnas de los informes que se vayan a crear (por ejemplo, 100 si el número de columnas es alto y 250 si el número es bajo). En un modo de despliegue de nivel Web, el parámetro Tamaño de bloque HTTP también le puede ayudar a optimizar el rendimiento reduciendo el número de llamadas de datos entre el cliente y el servidor. Consulte el Manual del adminis trador de la plataforma de SAP BusinessObjects Business Intelligence para obte ner más información sobre los bloques HTTP. Valores
Número de filas recuperadas por sector (número entero). 1 indica que la búsqueda de matrices está deshabilitada. 0 indica que el controlador decide qué tamaño Array fetch se usa. Este valor
Información relacionada Restricciones del controlador de SAP ERP [página 92]
11.3.5
BigDecimal Max Display Size
128
Descripción
Indica el tamaño de visualización máximo de los datos recuperados con el tipo de carácter Big Decimal.
Valores
El tamaño de visualización (número entero en bits).
Predetermi nado
No existe un valor predeterminado.
11.3.6
Binary Max Length
32768
Descripción
Especifica la longitud máxima de las columnas de la tabla, cuyo tipo es: ●
●
El valor binario y Longitud máxima es máximo o longitud no fijada proporcionada para orígenes de datos OData base64Binary y hexBinary para orígenes de datos XML
Datos devueltos truncados si son mayores a lo especificado. Por defecto
32768
Información relacionada Controlador OData [página 72] Controlador XML [página 93] Controlador de servicio Web [página 106]
Manual de acceso a los datos Referencia de parámetro SBO
Especifica el número de registros clasificados en memoria antes de que se escriban en el disco local. Los siguientes controladores de acceso a los datos utilizan Tamaño de partición de depósito cuando realizan las operaciones ORDER BY, GROUP BY o DISTINCT: ● ● ● ●
CSV OpenDriver Controlador OData Controlador de SAP ERP Controladores del servicio Web y XML
Nota Puede configurar la ruta del directorio en el archivo cs.cfg con el parámetro Directorio de datos temporal cuando el sistema operativo no especifica ninguna carpeta temporal. Esto puede suceder con los sistemas operativos Linux. El tamaño de particiones de intervalos incide en el consumo de memoria. Si el ta maño de memoria principal es demasiado reducido, el valor del parámetro se ignorará. Predetermi nado
25000
Información relacionada Disco local usado como caché para clasificar operaciones [página 113] Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas. Temp Data Dir [página 191]
11.3.8
Catalog Separator
.
Descripción
Indica el carácter utilizado como separador entre elementos de identificadores de base de da . tos (calificadores, propietarios, tablas y columnas). Por ejemplo: . .
Valores
El carácter de separación requerido. Normalmente se usa un punto.
Predetermi nado
Si no se especifica, el servidor de conexión usa el separador especificado en el middleware de la base de datos.
Especifica el nombre de la tabla usada para la asignación de un conjunto de caracteres entre el sistema operativo y el middleware.
Valores
El nombre del archivo CRS.
Predetermi nado
Ningún valor predeterminado.
11.3.10
Description File
oracle
Descripción
Nota No edite este parámetro. Indica el nombre del archivo COD que contiene las etiquetas de campo de entrada del asis tente de conexión.
11.3.11
Dictionary Transaction Mode
Transactional
Descripción
Especifica si el controlador de acceso a datos consulta los metadatos en el modo de transac ción.
Nota Los metadatos de consulta de controladores de acceso a datos se encuentran en modo Au toCommit de forma predeterminada. Para modificar la configuración de un controlador a transaccional, agregue el parámetro a la sección adecuada del archivo de configuración SBO (en la sección Predeterminada o Base de datos). Valores
11.3.12
Transaccional
Driver Capabilities
Procedures , Query
Manual de acceso a los datos Referencia de parámetro SBO
Las funciones del controlador, es decir, si puede acceder a procedimientos almacenados y consultas disponibles en el software de la base de datos. Este parámetro se ajusta mediante el asistente de conexión. Puede incluir ambos valores en el parámetro.
Nota Este parámetro debe estar configurado como Procedures para un controlador JavaBean. Las funciones de un controlador JavaBean se definen como procedimientos almacenados si afectan a aplicaciones de SAP BusinessObjects. Valores
Procedures: el controlador puede utilizar procedimientos almacenados en la base de datos
para recuperar datos. Query: el controlador puede utilizar un lenguaje de consulta como SQL para recuperar datos.
Por defecto
11.3.13
Consulta
Driver Name
Adaptive Server IQ
Descripción
Especifica el nombre del controlador que se muestra en la ficha Controladores del Administra dor de origen de datos ODBC en Microsoft Windows. Este parámetro es específico de ODBC. Ayuda a filtrar los controladores en la lista Nombre de origen de datos (DNS) ODBC.
Valores
El nombre del controlador.
Nota Puede utilizar una expresión regular en base a la sintaxis GNU regexp de PERL. Predetermi nado
11.3.14
No existe un valor predeterminado.
Escape Character
/
Descripción
Especifica el carácter que utilizar para cadenas de escape de caracteres especiales, por ejem plo, patrones.
Si no se especifica, el servidor de conexión usa el valor especificado en el middleware.
Extensions
oracle10,oracle,jdbc
Descripción
Nota No edite este parámetro. Indica la lista de posibles nombres de archivos PRM y RSS de controladores de acceso a los datos. También enumera los posibles nombres de directorios donde puede almacenar archi vos JAR.
Información relacionada Crear una conexión JDBC con extensiones [página 53]
11.3.16
Family
Sybase
Descripción
Nota No edite este parámetro. Indica la familia de motor de base de datos que se va a mostrar en la página Selección del middleware de la base de datos del asistente de conexión. El conjunto de middleware que co rresponde a la licencia se muestra en esta página en vista de árbol.
11.3.17
Force Execute
Never
Descripción
Nota No edite este parámetro.
Manual de acceso a los datos Referencia de parámetro SBO
Indica si la consulta SQL se ejecuta antes de recuperar descripciones de resultados. Valores
Never: la consulta SQL no se ejecuta nunca antes de recuperar descripciones de resultados. Procedures: la consulta SQL se ejecuta antes de recuperar descripciones de resultados, pero
únicamente para procedimientos almacenados. Always: la consulta SQL se ejecuta siempre antes de recuperar descripciones de resultados.
Por defecto
11.3.18
Never
Identifier Case
LowerCase
Descripción
Especifica cómo gestiona la base de datos el comportamiento de casos de identificadores sim ples.
Valores
Coincidir mayúsculas y minúsculas: la base de datos trata identificadores SQL de caso
mixto como Coincidir mayús/minús. LowerCase: la base de datos trata identificadores SQL mezclados como mayúsculas y minús
culas coincidentes y las almacena en minúsculas. MixedCase: la base de datos trata identificadores SQL mezclados como mayúsculas y minús
culas coincidentes y las almacena en mayúsculas y minúsculas. UpperCase: la base de datos trata identificadores SQL mezclados como mayúsculas y minús
culas coincidentes y las almacena en mayúsculas.
11.3.19
Identifier Quote String
"
Descripción
Indica el carácter utilizado para entrecomillar identificadores de bases de datos.
Valores
El carácter utilizado para entrecomillar identificadores de bases de datos. Normalmente se en trecomilla ( ").
Por defecto
Si no se especifica, el servidor de conexión recupera la información del middleware de la base de datos.
Especifica si las columnas de sinónimos de Oracle se recuperan de la base de datos Oracle. Es válido para conexiones a Oracle mediante las capas de red JDBC u Oracle OCI.
Valores
True: las columnas de sinónimos de Oracle se recuperan y se muestran como columnas de
la tabla. False: las columnas de sinónimos de Oracle no se recuperan.
Predeterminado
11.3.21
Falso
Integer Max Length
18
Descripción
Especifica la longitud máxima de las columnas de la tabla cuyo tipo de XML integrado es en tero, nonPositiveInteger, negativeInteger, noNegativeInteger, y positiveInteger. Datos devueltos truncados si son mayores a lo especificado. Longitud máxima de entero es aplicable a orígenes de datos XML y servicios Web.
Por defecto
18
Información relacionada Controlador XML: configuración del tamaño máximo de columna [página 105] Controlador de servicio Web: configurar el t amaño máximo de la columna [página 113]
11.3.22
Introscope Available
True
Descripción
Nota No edite este parámetro. Especifica si la supervisión del rendimiento mediante CA Wily Introscope está activada para el controlador.
Valores
True: la supervisión del controlador está activada. False: la supervisión del controlador no está activada.
Manual de acceso a los datos Referencia de parámetro SBO
El parámetro está ajustado en False para todos los controladores del archivo cs.cfg. La su pervisión solo está activada para las conexiones SAP HANA en el archivo newdb.sbo.
Max Rows Available
No
Descripción
Indica si el controlador puede limitar el número máximo de filas que pueden recuperarse de un origen de datos.
Valores
Sí: se puede limitar el número máximo de filas. No: no se puede limitar el número máximo de filas.
Por defecto
11.3.24
No
Native Int64 Available
False
Descripción
Nota No edite este parámetro. Indica si el middleware puede gestionar directamente números enteros de 64 bits.
Valores
True: el middleware puede gestionar números enteros de 64 bits. False: la capa de acceso a los datos emula los métodos Int64.
Por defecto
11.3.25
Falso
Optimize Execute
False
Descripción
Indica si el servidor de conexión optimiza la ejecución de consultas SQL. Este parámetro sólo es compatible con controladores Oracle y ODBC.
Valores
True: las consultas SQL se optimizan durante la ejecución cuando sea posible. False: las consultas SQL no se optimizan durante la ejecución.
Especifica si el middleware de la base de datos admite tiempo de espera de consulta, es decir, si es posible cancelar al cabo de un tiempo una consulta en ejecución.
Valores
True: el middleware de la base de datos administra tiempos de espera de consulta. False: el middleware de la base de datos no administra tiempos de espera de consulta.
Por defecto
11.3.29
Falso
Quote Identifiers
True
Descripción
Indica si el identificador del procedimiento almacenado admite comillas.
Valores
True: se admiten comillas. False: no se admiten comillas.
Por defecto
Verdadero
11.3.30
Skip SAML SSO
False
Descripción
Especifica si la implementación SAML del inicio de sesión único (SSO) se omite al conectarse a la base de datos de SAP HANA. Para obtener más información sobre el inicio de sesión único, consulte el Manual del adminis trador de la plataforma de Business Intelligence de SAP BusinessObjects.
Nota No edite este parámetro. El archivo externo SQL contiene detalles de configuración usados en la capa de acceso a da tos.
11.3.32
SQL Parameter File
oracle
Descripción
Nombre del archivo que almacena los parámetros de la base de datos. La extensión de este archivo es .prm. Debe asegurarse de que este archivo se encuentra ubicado en el mismo directorio que el ar chivo de configuración SBO.
Valores
Ver la lista de valores del archivo SBO.
Por defecto
Los valores enumerados.
11.3.33
SSO Available
False
Descripción
Indica si se admite el inicio de sesión único (SSO). Para obtener más información sobre el inicio de sesión único, consulte el Manual del adminis trador de la plataforma de Business Intelligence de SAP BusinessObjects.
Valores
True: se admite el inicio de sesión único. False: no se admite el inicio de sesión único.
Por defecto
11.3.34
False
Strategies File
oracle
Descripción
Indica el nombre, sin extensión, del archivo de estrategias ( .stg).
Manual de acceso a los datos Referencia de parámetro SBO
Este archivo contiene las estrategias externas que la herramienta de diseño de universos usa para la creación automática de universos. Los archivos de estrategia se almacenan en el mismo directorio que el archivo SBO. Valores
db2 para controladores de acceso a datos IBM DB2 informix para IBM Informix oracle para Oracle sqlsrv para MS SQL Server sybase para Sybase teradata para Teradata
Por defecto
11.3.35
Los valores enumerados.
String Max Length
32768
Descripción
Especifica la logítud máxima de cadena de las columnas de la tablas asignadas a parámetros de función ABAP cuya longitud de valor es igual a cero. También especifica la longitud máxima de las columnas de la tabla, cuyo tipo es: ● ●
El valor de cadena y longitud máxima es Máx. para orígenes de datos OData Cadena y cualquiera de los siguientes para el origen de datos XML: anyURI, QName, NO TATION, duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, TYPE_NORMALIZEDS TRING, token, language, Name, NCName, XSD_TYPE_ID, IDREF, IDREFS, ENTITY, ENTI TIES
Datos devueltos truncados si son mayores a lo especificado. Por defecto
32768
Información relacionada Controlador OData [página 72] Controlador de SAP ERP: acceso a funciones ABA P [página 89] Controlador XML [página 93] Controlador de servicio Web [página 106]
Especifica la ruta del directorio para datos temporales escritos en el disco. Utilice este pará metro si el sistema operativo no especifica ninguna carpeta temporal predeterminada, por \AppData\Local\Temp. ejemplo: C:\Users\ Los siguientes controladores de acceso a los datos pueden utilizar Directorio de datos temporal: ● ● ● ●
CSV OpenDriver Controlador OData Controlador de SAP ERP Controladores del servicio Web y XML
Cuando el controlador realiza una operación ORDER BY, GROUP BY o DISTINCT, los datos se escriben en esta carpeta si el número de registros que se han de ordenar superan el valor de parámetro Tamaño de partición de depósito . Por defecto
El parámetro está marcado con asteriscos. Elimine la sintaxis del comentario para habilitar el parámetro.
Información relacionada Disco local usado como caché para clasificar operaciones [página 113] Los controladores CSV OpenDriver y OData, SAP ERP, XML y de servicio Web pueden usar el disco local como caché de filas clasificadas. Bucket Split Size [página 180]
11.3.37
Transactional Available
Yes
Descripción
Especifica si las operaciones SQL que se ejecutan con la base de datos se gestionan en blo ques o individualmente. Este parámetro no se lista de manera predeterminada en el archivo SBO. Debe añadirlo al ar chivo SBO si su controlador de acceso a los datos no admite el modo de transacción.
Valores
Sí: indica que las operaciones realizadas con respecto a la base de datos se ejecutan en blo
que cuando están validadas. No: cada sentencia SQL se valida inmediatamente, es decir, la función de validación automática está desactivada.
Manual de acceso a los datos Referencia de parámetro SBO
Nota No utilice un controlador con Transactional Available=No para acceder al repositorio de SAP BusinessObjects. Por defecto
Yes. Configurado en el archivo cs.cfg.
Información relacionada Establecer el modo de transacción para conexiones de I BM Informix [página 120] Para que funcionen las conexiones salesforce.com en la herramienta de diseño de universo [página 128]
11.3.38
Type
Relational
Descripción
Nota No edite este parámetro. Indica el tipo de origen de datos.
11.3.39
Unicode
\ {3}UTF8\ {4}
Descripción
Indica si el controlador de acceso a los datos puede beneficiar de la configuración de Unicode del middleware cliente. Este parámetro aparece como predeterminado del controlador en el archivo cs.cfg. Este va lor se aplica a todos los controladores de acceso a los datos. No se lista de manera predeter minada en el archivo SBO. Si desea pasar por alto el valor predeterminado debe agregarlo en la sección Defaults del archivo SBO para el controlador de acceso a los datos de destino.
Valores
UTF8: codificación UCS/Unicode Transformation Format de 8 bits CharSet: codificación de juego de caracteres. UCS2: codificación Universal Character Set de 2 bytes
Especifica el formato de URL. La especificación JDBC no indica el formato de cadena de conexión requerido. Los proveedo res utilizan diversos tipos de formato URL, por ejemplo: MySQL:
●
jdbc:mysql://$DATASOURCE$/$DATABASE$
Oracle:
●
jdbc:oracle:thin:@$DATASOURCE$:$DATABASE$
Nota Este parámetro sólo es compatible con archivos de los controladores JDBC y JavaBean. Valores
El formato de URL.
Por defecto
No existe un valor predeterminado.
11.3.41
XML Max Size
65536
Descripción
Indica el tamaño máximo de los datos recuperados en formato XML.
Valores
El tamaño máximo permitido para XML (en bytes).
Por defecto
Depende de la base de datos.
11.4 Parámetros de JavaBean SBO Estos parámetros son aplicables al archivo JavaBean SBO. Se utilizan para configurar una conexión JavaBean. \connectionServer Estos parámetros se definen en el archivo \\ \javabean\javabean.sbo.
11.4.1
JavaBean Class
Manual de acceso a los datos Referencia de parámetro SBO
Define el punto de entrada de JavaBean que usa la aplicación de SAP BusinessObjects. El punto de entrada es la definición de una clase java que se extiende desde la interfaz Bean especificada al paquete com.businessobjects.
Valores
Un nombre completo de clase JavaBean.
Por defecto
No existe un valor predeterminado.
11.5
Parámetros de JCO SBO
Estos parámetros son aplicables a la tecnología de base de datos de SAP ERP. Se usan para configurar una conexión a un sistema de SAP ERP. \connectionServer Estos parámetros se definen en el archivo \\ \jco\jco.sbo.
11.5.1
ERP Max Rows
2147483647
Descripción
Especifica el número máximo de filas que una consulta puede devolver a un InfoSet o a una consulta SAP sin filtro.
Valores
Un entero igual o inferior a 2147483647.
Predetermi nado
2147483647
Información relacionada Controlador de SAP ERP [página 86]
11.6 Parámetros de JDBC SBO Estos parámetros son aplicables al archivo JDBC SBO. Se utilizan para configurar una conexión JDBC. Estos parámetros se definen en los archivos SBO del directorio \\ \connectionServer\jdbc.
Nota No edite este parámetro. Indica si una conexión de un conjunto de conexiones puede compartirse entre diversas solici tudes. Funciona conjuntamente con el parámetro Shared Connection.
Valores
True: la conexión se puede compartir entre varios usuarios. False: la conexión no se puede compartir entre varios usuarios.
Indica si la capa de red JDBC administra una cláusula de escape después de la expresión like de la consulta SQL. Esta cláusula ayuda a especificar un carácter de escape para caracteres específicos como los guiones de subrayado ( _).
Valores
True: se admite una cláusula de escape. False: se admiten cláusulas de escape.
Predetermi nado
11.6.3
Verdadero
ForeignKeys Available
True
Descripción
Indica si se pueden obtener las claves externas de las tablas de bases de datos.
Manual de acceso a los datos Referencia de parámetro SBO
True: se pueden obtener las claves externas. False: no se pueden obtener las claves externas.
Predetermi nado
11.6.4
Verdadero
Get Extended Column
No
Descripción
Nota No edite este parámetro. Especifica si la capa Acceso a datos usa el procedimiento almacenado getExtendedColumns proporcionado por el servidor de consultas de Data Federator para recuperar columnas de en trada.
Valores
Sí: se usa getExtendedColumns. No: no se usa getExtendedColumns.
Predetermi nado
11.6.5
No
JDBC Class
Descripción
La clase Java de controlador JDBC totalmente cualificada.
Valores
Depende del proveedor o el origen de datos, por ejemplo:
Indica si se pueden obtener las claves primarias de las tablas de bases de datos.
Valores
True: se pueden obtener las claves primarias. False: no se pueden obtener las claves primarias.
Predetermi nado
11.6.7
Verdadero
PVL Available
True
Descripción
Especifica si la conexión admite la funcionalidad de configuración regional de visualización pre ferida (PVL). Solo la admiten las conexiones SAP HANA en esta versión.
Valores
True: se admite PVL. False: no se admite PVL.
11.6.8
Shared Connection
False
Descripción
Nota No edite este parámetro. Indica si se comparte la conexión solicitada de un conjunto de conexiones. Funciona conjunta mente con el parámetro Connection Shareable. No se tiene en cuenta si el parámetro Max Pool Time de cs.cfg se establece en 0.
Valores
True: la conexión se comparte. False: la conexión no se comparte.
Nota Debe usar este parámetro junto con Simultaneidad de ResultSet de JDBC . No es obligatorio. Especifica el valor de argumento resultSetType del método Java createStatement. Este método pertenece a la interfaz java.sql.Connection. Se agrega este parámetro para crear un objeto de enunciado predeterminado y para optimizar el rendimiento de la conexión.
Valores
Establezca valores Java estándar o valores específicos de base de datos. Los valores deben ser enteros.
Nota Debe usar este parámetro junto con Tipo de ResultSet de JDBC . No es obligatorio. Especifica el valor de argumento resultSetConcurrency del método Java createStatement. Este método pertenece a la interfaz java.sql.Connection. Se agrega este parámetro para crear un objeto de enunciado predeterminado y para optimizar el rendimiento de la conexión.
Valores
Establezca valores Java estándar o valores específicos de base de datos. Los valores deben ser enteros.
Estos parámetros se usan para configurar conexiones a orígenes de datos que usan el protocolo OData. \connectionServer Estos parámetros se definen en el archivo \\ \odata\odata.sbo.
11.7.1
Enforce Max Protocol Version
Yes
Descripción
Especifica si el controlador envía la versión compatible del protocolo OData al proveedor OData. Si la admite, el proveedor OData puede decidir si responde el controlador en el protocolo. Este parámetro puede ser útil cuando la plataforma de BI se conecta a un proveedor que usa el pro tocolo OData 3.0.
Valores
Sí: el controlador envía la versión admitida del protocolo OData. No: el controlador no envía la versión admitida del protocolo OData.
Por defecto
Sí
11.8 Parámetros ODBC SBO Estos parámetros son aplicables a la capa de red ODBC. Se utilizan para configurar una conexión ODBC. \connectionServer\odbc.
11.8.1
CharSet
ISO88591
Manual de acceso a los datos Referencia de parámetro SBO
Nota No edite este parámetro. Especifica el conjunto de caracteres de los datos devueltos por el middleware de la base de datos.
Valores
ISO88591: el conjunto de caracteres predeterminado especificado para HP Neoview en UNIX.
Por defecto
Si no se especifica, el servidor de conexión usa el conjunto de caracteres especificado en el middleware de la base de datos.
11.8.2
Connection Status Available
True
Descripción
Indica si el middleware es capaz de detectar una conexión defectuosa (función ping).
Valores
True: el middleware puede detectar una conexión defectuosa. False: el middleware no puede detectar una conexión defectuosa.
Por defecto
11.8.3
El valor especificado en el middleware.
Cost Estimate Available
False
Descripción
Indica si el middleware de la base de datos permite realizar estimaciones de costes de la ejecu ción de una consulta SQL. Este parámetro se utiliza únicamente con la base de datos Teradata.
Valores
True: el middleware permite realizar estimaciones de costes. False: el middleware no permite realizar estimaciones de costes.
Indica que determinadas funciones, por ejemplo, SQL Tables, reciben una cadena vacía o un puntero nulo para reemplazar los parámetros que faltan.
Valores
NullString: se utiliza una cadena nula. EmptyString: se utiliza una cadena vacía.
Por defecto
11.8.5
EmptyString
ODBC Cursors
No
Descripción
Especifica si el controlador de acceso a los datos utiliza la biblioteca de cursores ODBC. Puede ayudar a mejorar el rendimiento del sistema.
Valores
Sí: el controlador de acceso a los datos utiliza la biblioteca de cursores ODBC. No: el controlador de acceso a los datos no utiliza la biblioteca de cursores ODBC.
Por defecto
11.8.6
El valor definido en el archivo cs.cfg.
SQLDescribeParam Available
True
Descripción
Indica si el middleware admite la función ODBC SQLDescribeParam. Esta función ayuda a describir los parámetros de un procedimiento almacenado. Este parámetro se utiliza única mente para la base de datos IBM Informix.
Valores
True: la función SQLDescribeParam está disponible. False: la función SQLDescribeParam no está disponible.
Por defecto
11.8.7
El valor definido en el middleware de la base de datos.
SQLMoreResults Available
True
Descripción
Indica si el middleware admite la función ODBC SQLMoreResults.
Manual de acceso a los datos Referencia de parámetro SBO
Esta función ayuda a recuperar más conjuntos de resultados de la ejecución de SQL, si los hay. Este parámetro sólo es compatible con los controladores ODBC. Valores
True: se admite la función SQLMoreResults. False: no se admite la función SQLMoreResults.
Por defecto
11.8.8
El valor especificado en el middleware.
Use DataDirect OEM Driver
No
Descripción
Indica si las conexiones a la base de datos MS SQL Server pueden usar controladores DataDi rect ODBC personalizados.
Valores
Sí: la conexión puede usar el controlador personalizado. No: la conexión no puede usar el controlador personalizado.
Por defecto
No
Información relacionada Acerca de los controladores DataDirect ODBC [página 172]
11.8.9
V5toV6DriverName
{Informix 3.34 32 BIT}
Descripción
Especifica la regla de conversión de Informix Connect a Informix ODBC. El valor de este parámetro determina el controlador Informix que se usa para definir el nombre de origen de datos (DSN) ODBC sin la cadena de conexión. Este parámetro se utiliza únicamente para la base de datos IBM Informix.
Valores
Nombre exacto del controlador Informix instalado en el equipo.
11.9 Parámetros de OLE DB SBO Estos parámetros son aplicables a la tecnología de base de datos OLE DB. Se usan para configurar una conexión OLE DB. Estos parámetros se definen en los archivos \\ \connectionServer\oledb\oledb.sbo y \sqlsrv.sbo.
11.9.1
Enumerator CLSID
MSDASQL Enumerator
Descripción
Nota No edite este parámetro. Indica el ID de clase del enumerador OLE DB. Este parámetro se utiliza con OLE DB única mente.
11.9.2
Provider CLSID
MSDASQL
Descripción
Nota No edite este parámetro. Indica el ID de clase del proveedor OLE DB. Este parámetro se utiliza con OLE DB únicamente.
11.10 Parámetros de OLE DB OLAP SBO Estos parámetros son aplicables a la tecnología de base de datos OLE DB OLAP. Se usan para configurar una conexión OLE DB para OLAP. \connectionServer Estos parámetros se definen en el archivo \\ \oledb_olap\slqsrv_as.sbo.
Manual de acceso a los datos Referencia de parámetro SBO
Nota No edite este parámetro. Indica el ID de clase del proveedor OLE DB. Este parámetro se utiliza únicamente con OLE DB pata OLAP.
11.11 Parámetros Sybase SBO Estos parámetros son aplicables al archivo Sybase ASE/CTLIB SBO. Se utilizan para configurar una conexión Sybase ASE/CTLIB. \connectionServer Estos parámetros se definen en el archivo \\ \sybase\sybase.sbo.
11.11.1
Driver Behavior
Dynamic
Descripción
Indica qué controlador Sybase se va a utilizar.
Valores
Dynamic: se utiliza el controlador ct_dynamic.
Cualquier otro valor habilita el uso del controlador CTLib. Por defecto
11.11.2
Dynamic.
Password Encryption
True
Descripción
Indica si se desea utilizar el mecanismo de contraseña de cifrado especificado en el middle ware para la contraseña introducida en el cuadro de diálogo Detalles de conexión. Este parámetro solamente se utiliza con Sybase. Se incluye en la sección Defaults para una compatibilidad futura.
True: se va a utilizar el mecanismo de contraseña de cifrado del middleware. False: no se va a utilizar el mecanismo de contraseña de cifrado del middleware.
Por defecto
11.11.3
El valor definido en el archivo cs.cfg.
Quoted Identifier
False
Descripción
Especifica si se admiten identificadores entre comillas. Este parámetro sólo es compatible con el middleware Sybase.
Valores
True: se admiten identificadores entre comillas. False: no se admiten identificadores entre comillas.
Por defecto
11.11.4
Falso
Recover Errors
True
Descripción
Indica si el controlador de la biblioteca del cliente se puede utilizar después de un fallo en el controlador ct_dynamic.
Valores
True: se utiliza el controlador de la biblioteca del cliente. False: no se utiliza el controlador de la biblioteca del cliente.
Predetermi nado
11.11.5
Verdadero
Text Size
32768
Descripción
Nota Este parámetro no es obligatorio.
Manual de acceso a los datos Referencia de parámetro SBO
Indica el tamaño máximo admitido para datos binarios de longitud variable o caracteres gran des. Los datos binarios de longitud variable o caracteres grandes recuperados de la base de datos Sybase CTL se truncan si superan los 32 KBytes. Puede agregar este parámetro a la sección Database correspondiente del archivo de configuración para evitar que se trunquen los datos. Predetermi nado
32768
11.12 Parámetros Teradata SBO Estos parámetros son aplicables a los archivos SBO Teradata. Estos parámetros se usan para configurar una conexión Teradata mediante JDBC u ODBC. \connectionServer Estos parámetros se definen en los archivos \\ \jdbc\teradata.sbo y \\ \connectionServer\odbc \teradata.sbo.
11.12.1
Replace Current Owner With Database
Yes
Descripción
Especifica si el controlador devuelve el nombre de la base de datos actual si el propietario ac tual consulta el origen de datos. Solo se usa con conexiones ODBC.
Valores
Sí: el propietario actual está asignado al nombre de la base de datos Teradata. No: el usuario asignado está asignado al nombre de usuario actual.
Por defecto
No
Información relacionada Conexiones Teradata - Asignar base de datos Teradata a propietario actual [página 139] La siguiente sección proporciona información de configuración par a conexiones Teradata.
12 Configurar parámetros de función de base de datos 12.1
Acerca de los parámetros de función de base de datos
Los parámetros de función (capability) de base de datos describen funciones de bases de datos que se usan como orígenes de datos para el contenido de un universo. Puede establecer estos parámetros para que funcionen en los siguientes niveles: ●
●
Nivel de universo Estos parámetros se definen cuando se crea o modifica un universo. Nivel de base de datos Estos parámetros se establecen en el archivo PRM para la base de datos. Se reemplazan con la configuración correspondiente en el nivel de universo.
Nota Para ver los operadores y funciones disponibles para el controlador de acceso a datos, abra el archivo .prm en un editor de XML. <>
12.2 Acerca de los archivos PRM Los archivos PRM proporcionan parámetros que describen funciones de bases de datos que se usan como orígenes de datos para las aplicaciones de SAP BusinessObjects. Permiten que los factores dependientes de la base de datos controlen qué SQL se puede usar con el universo, en función de la conexión y la base de datos a la que estén vinculados. Existe un archivo PRM que corresponde a cada controlador de base de datos. Puede configurar algunos parámetros de función desde el interior de un universo. Consecuentemente, sustituyen la configuración del archivo PRM. Los archivos PRM se encuentran en la carpeta siguiente: ●
●
\connectionServer\ Directorios , en los que es la capa de red o nombre de middleware. \connectionServer\ \extensions\qt. Estos Directorios archivos PRM se llaman archivos ampliados. Para obtener más información acerca de los parámetros de los archivos ampliados, consulte el capítulo de referencia de SQL y MDX en el Manual de usuario de la herramienta de diseño de información .
Nota En los mismos directorios también hay disponibles archivos de texto de ayuda en otros idiomas.
Manual de acceso a los datos Configurar parámetros de función de base de datos
Existe un archivo PRM para cada controlador base de datos admitido. Cada archivo está dividido en secciones que contienen parámetros específicos. La tabla siguiente describe el contenido y significado de cada sección de un archivo PRM.
Configuración
Parámetros empleados para describir funciones de bases de datos usadas como ori gen de datos para universos como, por ejemplo, EXT_JOIN, ORDER_BY y UNION. No están disponibles directamente para ningún producto de SAP BusinessObjects. Estos parámetros se pueden editar para optimizar la ejecución de consultas con uni versos utilizando el controlador de acceso a los datos de destino.
Nota Se describen en el capítulo siguiente. DateOperations
Operadores de fecha disponibles para la herramienta de diseño de universos y la herramienta de diseño de información, por ejemplo, AÑO, TRIMESTRE o MES.
Operadores
Operadores disponibles para la herramienta de diseño de universos y la herramienta de diseño de información, por ejemplo, ADD, SUBSTRACT o MULTIPLY.
Funciones
Funciones disponibles para la herramienta de diseño de universos y la herramienta de diseño de información, por ejemplo, Promedio, Suma o Variación. Consulte la Guía del usuario de la herramienta de diseño de información para obtener más información. El texto de ayuda que aparece cuando las funciones de esta sección están selecciona das en la herramienta de diseño de universos y la herramienta de diseñador de .prm como, por información se enumera en el archivo < idioma> ejemplo, oracleen.prm. Este archivo se encuentra en el mismo directorio que el ar .prm. Puede abrirlo para visualizar descripciones de todas las chivo .prm. funciones disponibles en el archivo La sección Function tiene los siguientes elementos secundarios: ●
●
●
●
Grupo: hace referencia a si el uso de esta función en una consulta genera una cláusula group by. ○
Verdadero establece que la consulta genera una cláusula group by.
○
Falso establece que la consulta no genera una cláusula group by.
ID: es el nombre que aparece en la lista de funciones Objetos del usuario en Desk
top Intelligence. Obsoleto en esta versión. InMacro: si este valor es Verdadero, la función se enumera en la lista de funcio nes Objetos del usuario de Desktop Intelligence. Obsoleto en esta versión. Type: tipo de datos de la función.
Arguments: argumentos aceptados por la función. Una función sólo puede tener
●
un máximo de cuatro argumentos y cualquier otro argumento adicional no se ten drá en cuenta. SQL: sintaxis SQL de la función.
Información relacionada Visualizar y editar un archivo de texto de ayuda de funciones [página 210]
12.3 Visualizar y editar archivos PRM Vaya al directorio que almacena el archivo PRM del controlador de acceso a los datos de destino. Los archivos PRM se almacenan en los directorios \connectionServer\ .prm en un editor de XML. Abra un archivo
Expanda las secciones como sea necesario. Defina los valores introduciendo el valor en la etiqueta adecuada. Guarde y cierre el archivo.
12.4 Verificar y añadir compatibilidad de la función analítica a archivos PRM Los archivos PRM pueden no contener todas las funciones analíticas disponibles en la base de datos de destino. Antes de utilizar una función analítica, debe comprobar que aparezca en el archivo y, si es necesario, agréguela a la lista. Debe actualizar el archivo PRM solo si la función es analítica y agregada, como por ejemplo SUM. Vaya al directorio que almacena el archivo PRM extendido del controlador de acceso a los datos de destino. .prm en un editor de XML. Abra el archivo
En la sección Configuración, compruebe que el parámetro siguiente está presente: Y
Para obtener una definición de este parámetro, consulte el Manual del usuario de la herramienta de diseño de información. Vaya al directorio que almacena el archivo PRM del controlador de acceso a los datos de destino.
Manual de acceso a los datos Configurar parámetros de función de base de datos
En la sección Configuración, compruebe que el ID de la función analítica se enumera en el valor del parámetro ANALYTIC_FUNCTIONS. Si no está enumerado, escriba el ID de la función al final de la lista. En Funciones, añada la sección Función y especifique el ID, el nombre, los tipos de argumento y la definición SQL de la función analítica. Name=" " Type =“All"> ...
Recuerde Proporcione distintos nombres e ID a la función que es analítica y agregada. Por ejemplo, el nombre de SUM como función agregada es SUM. El nombre de SUM como función analítica es SUM_OVER. Guarde los cambios y cierre el archivo. Ha agregado compatibilidad de una función analítica a la herramienta de diseño de información. Debe reiniciar la herramienta de diseño de información para que surtan efecto los cambios realizados en el archivo .PRM.
Información relacionada Acerca de los archivos PRM [página 207]
12.5 Visualizar y editar un archivo de texto de ayuda de funciones El texto de ayuda que aparece debajo de cada función cuando se selecciona en la herramienta de diseño de universos o la herramienta de diseño de información se conserva en un archivo XML separado. Puede editar y .prm. Existe un archivo agregar texto para describir una función editando el archivo de texto de ayuda para cada versión de idioma de los productos SAP BusinessObjects instalados. Cuando agrega una función al archivo PRM, necesita agregar el texto de ayuda de la nueva función al archivo .prm apropiado. Por ejemplo, si agrega una función al archivo oracle.prm, entonces también deberá agregar el nombre de la función y el texto de ayuda de la función al archivo oracleen.prm si está trabajando con la versión en inglés de la herramienta. Consulte la norma ISO639-1.
12.6 Para editar el texto de ayuda de una función PRM Vaya al directorio que almacena el archivo de idioma PRM del controlador de acceso a los datos de destino. Los archivos de idioma PRM se almacenan en los directorios \connectionServer\ . .prm en un editor XML. Abra un archivo
Expanda la sección Messages. Para agregar la Ayuda de una nueva función, haga lo siguiente: ○
○
Agregue una nueva sección para una función. La manera más sencilla de hacerlo es copiar una entrada de función existente y pegarla en la sección Function. A continuación, puede editar el nuevo texto de función. Introduzca el texto de ayuda de la función.
Para visualizar o editar el texto de ayuda de una función existente, haga lo siguiente: ○ ○ ○
Expanda la sección Function. Expanda la sección Message de una función. Edite el texto de ayuda como sea necesario.
Guarde y cierre el archivo.
Manual de acceso a los datos Configurar parámetros de función de base de datos
Los parámetros de función de la base de datos se enumeran alfabéticamente. Para visualizar funciones, .prm en un editor de XML; operadores de fecha y otros operadores disponibles, abra un archivo cada parámetro está definido en la etiqueta siguiente:
donde es el nombre del parámetro y es el valor atribuido al parámetro. Cada parámetro se muestra con la información siguiente: Ejemplo de la manera en que aparece el parámetro en el archivo XML Descripción del parámetro Valores posibles que se pueden definir para el parámetro Valor predeterminado del parámetro, si existe
● ● ● ●
Nota Determinados parámetros de configuración no se deben editar. Estos parámetros tienen valores definidos para uso interno dentro de las soluciones SAP BusinessObjects. Estos parámetros se describen en esta sección, pero contienen una advertencia para no editar e valor. No debe editar estos parámetros. Antes de editar cualquier otro parámetro del archivo PRM, debe hacer una copia de seguridad del archivo PRM.
13.1.1
ANALYTIC_CLAUSE
WHEN
Descripción
Indica qué palabra clave SQL se debe usar si una función especificada en el parámetro ANALYTIC_FUNCTIONS se usa en la sentencia SQL.
Valores
WHEN: indica que se usa una cláusula WHEN. Éste es el valor predeterminado para bases de
datos IBM Red Brick. QUALIFY: indica que se usa una cláusula QUALIFY. Éste es el valor predeterminado para bases
de datos Teradata.
Nota Para obtener información sobre cómo se implementa la cláusula SQL, consulte la base de datos de documentación. Predetermi nado
Enumera las funciones analíticas que admite la base de datos.
Valores
Ver valores en los archivos PRM.
Predetermi nado
Los valores enumerados.
13.1.3
CALCULATION_FUNCTION
YES
Descripción
Especifica si la base de datos admite las funciones de cálculo.
Valores
YES: la base de datos admite las funciones de cálculo. Si es el caso, la herramienta de diseño
de información puede crear columnas de cálculos. NO: la base de datos no admite las funciones de cálculos.
13.1.4
CONSTANT_SAMPLING_SUPPORTED
YES
Descripción
Especifica si la base de datos admite el muestreo aleatorio. El muestreo aleatorio consiste en la extracción de filas aleatorias de un conjunto de datos.
Valores
YES: la base de datos admite el muestreo aleatorio. NO: la base de datos no admite el muestreo aleatorio.
Predetermi nado
YES
Manual de acceso a los datos Referencia de parámetro PRM
Indica si la base de datos admite la palabra clave DISTINCT en las sentencias SQL. Este pará metro se usa con MS Access.
Valores
YES: la base de datos admite la palabra clave DISTINCT. NO: la base de datos no admite la palabra clave DISTINCT. En este comportamiento inhabilita
las siguientes características: ●
●
Predetermi nado
13.1.6
La opción Valores únicos que aparece al hacer clic en el botón Ver valores del asistente para la creación de universos de la herramienta de diseño de universos. La función CálculoDiferencial que aparece cuando se crea una condición con el ope rando Cálculo del Panel de consulta.
YES
EXT_JOIN
YES
Descripción
Indica si la base de datos admite combinaciones externas. Este parámetro se usa con todos los controladores de acceso a datos.
Valores
YES: la base de datos admite combinaciones externas. NO: la base de datos no admite combinaciones externas. Las casillas de verificación Combinación externa del cuadro de diálogo Editar la combinación de la herramienta de diseño
de universos están sombreadas. Por defecto
13.1.7
YES
FULL_EXT_JOIN
YES
Descripción
Indica si la base de datos admite combinaciones externas completas.
Valores
YES: la base de datos admite combinaciones externas completas. NO: la base de datos no admite combinaciones externas.
Indica si la base de datos admite la cláusula GROUP BY en las sentencias SQL.
Valores
YES: la base de datos admite la cláusula GROUP BY. NO: la base de datos no admite la cláusula GROUP BY.
13.1.9
GROUP_BY_SUPPORTS_COLUMN_INDEX
NO
Descripción
Indica si la base de datos admite el uso de índices de columnas de la sentencia SELECT en la cláusula GROUP BY.
Valores
YES: la base de datos admite el uso de índices de columnas de la sentencia SELECT en lugar de
nombres de columnas. NO: la base de datos no admite el uso de índices de columnas de la sentencia SELECT en lugar
de nombres de columnas. Predetermi nado
13.1.10
NO
GROUP_BY_SUPPORTS_COMPLEX
Parameter Name="GROUP_BY_SUPPORTS_COMPLEX">NO
Descripción
Indica si la base de datos admite expresiones complejas en la cláusula GROUP BY. Las expre siones complejas representan cualquier valor excepto los nombres de columna o índices pre sentes en la sentencia SELECT, por ejemplo, funciones o columnas no presentes en la senten cia SELECT. Este parámetro se utiliza con IBM DB2.
Nota Si se ejecuta una consulta que contiene objetos indicadores y objetos complejos, es decir, objetos que usan funciones y concatenación, la aplicación muestra el siguiente mensaje de
Manual de acceso a los datos Referencia de parámetro PRM
error: Su base de datos no le permite realizar agregaciones con el objeto <> . Valores
YES: la base de datos admite expresiones complejas en la cláusula GROUP BY. NO: la base de datos no admite expresiones complejas en la cláusula GROUP BY.
Predetermi nado
13.1.11
NO
GROUP_BY_SUPPORTS_CONSTANT
YES
Descripción
Indica si la base de datos admite el uso de objetos constantes en la cláusula GROUP BY. Este parámetro es utilizado por las bases de datos de IBM DB2 y Microsoft SQL Server.
Valores
YES: la base de datos admite el uso de objetos constantes en la cláusula GROUP BY. NO: la base de datos no admite el uso de objetos constantes en la cláusula GROUP BY.
Predetermi nado
13.1.12
YES
HAVING
NO
Descripción
Indica si la base de datos admite la cláusula HAVING en las sentencias SQL.
Valores
YES: la base de datos admite la cláusula HAVING. NO: la base de datos no admite la cláusula HAVING.
Indica la palabra clave que admite la base de datos para la operación de conjuntos INTER SECT.
Valores
INTERSECT: la palabra clave que admite la base de datos es INTERSECT.
Ningún valor: la base de datos no admite ninguna palabra clave para la operación de conjuntos INTERSECT. En este caso, se generan dos consultas. Predetermi nado
13.1.14
INTERSECT
INTERSECT_ALL
YES
Descripción
Indica si la base de datos admite la operación de conjuntos INTERSECT ALL.
Valores
YES: la base de datos admite la operación de conjuntos INTERSECT ALL. NO: la base de datos no admite la operación de conjuntos INTERSECT ALL.
Predetermi nado
13.1.15
YES
INTERSECT_IN_SUBQUERY
YES
Descripción
Indica si la base de datos admite la operación de conjuntos INTERSECT en subconsultas.
Valores
YES: la base de datos admite la operación de conjuntos INTERSECT en subconsultas. NO: la base de datos no admite la operación de conjuntos INTERSECT en subconsultas.
13.1.16
JOIN
YES
Descripción
Especifica si la base de datos admite una operación JOIN entre dos tablas.
Valores
YES: la base de datos admite combinaciones entre cualquier columna de dos tablas.
Manual de acceso a los datos Referencia de parámetro PRM
STRUCTURE_JOIN: la base de datos admite enlaces entre dos tablas que estén relacionadas con límites referenciales. Es idéntica a NO en esta versión. NO: la base de datos no admite enlaces entres dos tablas.
13.1.17
LEFT_EXT_JOIN
YES
Descripción
Indica si la base de datos admite combinaciones externas izquierdas.
Valores
YES: la base de datos admite combinaciones externas izquierdas. NO : la base de datos no admite combinaciones externas izquierdas.
13.1.18
LEFT_OUTER
$(+)$*
Descripción
Indica la sintaxis que se usará para las expresiones de combinación externa izquierda.
Valores
$(+): esta sintaxis se usa con Oracle. $*: esta sintaxis se usa con Sybase, MS SQL Server e IBM Red Brick.
Nota $ representa una expresión de combinación.
Predetermi nado
Consulte los valores anteriores.
Ejemplo
Si la tabla1.col1 está combinada con la tabla2.col2 en Oracle, la expresión generada en tonces es: tabla1.col1(+) = tabla2.col2.
Indica si la base de datos admite el uso de una cláusula ESCAPE en la condición LIKE de la sen tencia SQL.
Valores
YES: la base de datos admite la cláusula ESCAPE en la condición LIKE. NO: la base de datos no admite la cláusula ESCAPE en la condición LIKE.
Predetermi nado
13.1.20
Si no se especifica, el servidor de conexión recupera la información del middleware de la base de datos.
MINUS
MINUS
Descripción
Indica la palabra clave que admite la base de datos para la operación de conjuntos MINUS.
Valores
MINUS: la base de datos admite el operador de conjuntos MINUS. EXCEPT: la base de datos admite el operador de conjuntos EXCEPT.
Ningún valor: la base de datos no admite ninguna palabra clave para la operación de conjuntos MINUS. En este caso, se generan dos consultas. Predetermi nado
13.1.21
MINUS
MINUS_ALL
Yes
Descripción
Indica si la base de datos admite la operación de conjuntos MINUS ALL.
Valores
YES: la base de datos admite la operación de conjuntos MINUS ALL. NO: la base de datos no admite la operación de conjuntos MINUS ALL.
13.1.22
MINUS_IN_SUBQUERY
YES
Descripción
Indica si la base de datos admite la operación de conjuntos MINUS en subconsultas.
Valores
YES: la base de datos admite la operación de conjuntos MINUS en subconsultas.
Manual de acceso a los datos Referencia de parámetro PRM
NO: la base de datos no admite la operación de conjuntos MINUS en subconsultas.
13.1.23
ORDER_BY
YES
Descripción
Indica si la base de datos admite la cláusula ORDER BY.
Valores
YES: la base de datos admite la cláusula ORDER BY. NO: la base de datos no admite la cláusula ORDER BY.
13.1.24
ORDER_BY_REQUIRES_SELECT
NO
Descripción
Indica si la base de datos requiere que se haga referencia a las columnas usadas en la cláusula ORDER BY en la sentencia SELECT.
Valores
YES: los usuarios no pueden ordenar columnas si no están incluidas en la sentencia SELECT. En este caso, el botón Administrar orden del panel Consulta de la herramienta de diseño de
universos está sombreado. NO: los usuarios pueden ordenar columnas aunque no estén incluidas en la sentencia SELECT.
Predetermi nado
13.1.25
NO
ORDER_BY_SUPPORTS_COLUMN_INDEX
YES
Descripción
Indica si la base de datos admite el uso de índices de columnas de la instrucción SELECT en la cláusula ORDER BY.
Valores
YES: la base de datos admite el uso de índices de c olumnas de la sentencia SELECT en lugar de
nombres de columnas. NO: la base de datos no admite el uso de índices de columnas de la sentencia SELECT en lugar
Indica si la base de datos admite la función analítica de rango de porcentaje. Para obtener in formación sobre cómo se implementa el rango de porcentaje, consulte la documentación de la base de datos.
Valores
YES: la base de datos admite el rango de porcentaje. NO: la base de datos no admite el rango de porcentaje.
Predetermi nado
13.1.27
YES
RANK_SUPPORTED
YES
Descripción
Indica si la base de datos admite la función analítica de rango en las sentencias SQL.
Valores
YES: la base de datos admite la función de rango. NO: la base de datos no admite la función de rango.
Predetermi nado
13.1.28
YES
RIGHT_EXT_JOIN
YES
Descripción
Indica si la base de datos admite combinaciones externas derechas.
Valores
YES: la base de datos admite combinaciones externas derechas. NO: la base de datos no admite combinaciones externas derechas.
13.1.29
RIGHT_OUTER
$(+)*$
Manual de acceso a los datos Referencia de parámetro PRM
Indica la sintaxis que se usará para las expresiones de combinación externa derecha.
Valores
$(+): esta sintaxis se usa con Oracle. *$: esta sintaxis se usa con Sybase, MS SQL Server e IBM Red Brick.
Nota $ representa una expresión de combinación.
Predetermi nado
13.1.30
Consulte los valores anteriores.
SEED_SAMPLING_SUPPORTED
YES
Descripción
Indica si la base de datos admite el muestreo de inicio. El muestreo de inicio es una variante del muestreo aleatorio en el que el usuario proporciona el valor de inicio aleatorio.
Valores
YES: la base de datos admite el muestreo de inicio. NO: la base de datos no admite el muestreo de inicio.
Predetermi nado
13.1.31
NO
SELECT_SUPPORTS_NULL
YES
Descripción
Indica si la base de datos admite NULL como columna en la sentencia SELECT.
Valores
YES: la base de datos admite NULL como columna en la sentencia SELECT. NO: la base de datos no admite NULL como columna en la sentencia SELECT.
Predetermi nado
YES NO para bases de datos Teradata, IBM DB2, IBM Informix e IBM Red Brick, que no admiten el
Indica si la base de datos admite el uso de subconsultas en la cláusula FROM.
Valores
YES: la base de datos admite el uso de subconsultas en la cláusula FROM. NO: la base de datos no admite el uso de subconsultas en la cláusula FROM.
13.1.33
SUBQUERY_IN_IN
YES
Descripción
Indica si la base de datos admite el uso de subconsultas en la cláusula IN.
Valores
YES: la base de datos admite el uso de subconsultas en la cláusula IN. NO: la base de datos no admite el uso de subconsultas en la cláusula IN.
13.1.34
SUBQUERY_IN_WHERE
YES
Descripción
Indica si la base de datos admite el uso de subconsultas en la cláusula WHERE.
Valores
YES: la base de datos admite el uso de subconsultas en la cláusula WHERE. NO: la base de datos no admite el uso de subconsultas en la cláusula WHERE.
13.1.35
TECHNICAL_COLUMN_NAME_PATTERN
^(-idref)(.)*
Descripción
Especifica que todas las columnas que empiezan con el modelo -idref no se visuali zan en las conexiones, infraestructuras de datos y capas empresariales de universos basados en orígenes de datos OData. Por consiguiente, el diseñador de información no puede generar consultas con estas columnas.
Nota No edite este parámetro.
Manual de acceso a los datos Referencia de parámetro PRM
Indica la palabra clave que admite la base de datos para la operación de conjuntos UNION.
Valores
UNION: la palabra clave que admite la base de datos es UNION.
Ningún valor: la base de datos no admite ninguna palabra clave para la operación de conjuntos UNION. En este caso, se generan dos consultas. Predetermi nado
13.1.37
UNION
UNION_ALL
YES
Descripción
Indica si la base de datos admite la operación de conjuntos UNION ALL.
Valores
YES: la base de datos admite la operación de conjuntos UNION ALL. NO: la base de datos no admite la operación de conjuntos UNION ALL.
13.1.38
UNION_IN_SUBQUERY
YES
Descripción
Indica si la base de datos admite el uso de la operación de conjuntos UNION en subconsul tas.
Valores
YES: la base de datos admite la operación de conjuntos UNION en subconsultas. NO: la base de datos no admite la operación de conjuntos UNION en subconsultas.
14 Referencia a conversión de tipos de datos 14.1 Conversión de tipo de datos En la herramienta de diseño de información, las infraestructuras de datos muestran tablas de una o varias bases de datos relacionales, que son la base de las capas empresariales. En las infraestructuras de datos se muestra, junto con otros detalles de columna, el tipo de datos asociado con cada columna de la tabla. Las capas empresariales exponen las columnas como objetos de metadatos, como dimensiones y jerarquías y muestran los tipos de datos asociados con cada objeto. La siguiente tabla describe la asignación entre estos dos conjuntos de tipos de datos:
Nota Desde cualquier base de datos, una hora se gestiona como FechaHora en la plataforma de BI. La parte correspondiente a la fecha del parámetro DateTime se mostrará normalmente como la fecha actual en los informes de usuario final. La capa de acceso a datos administra la conversión de los tipos de datos que exponen las capas de red en tipos de datos del servidor de conexión, que a continuación se asignan a los tipos de datos expuestos en las infraestructuras de datos. Esta sección ofrece tablas de conversión entre los tipos de datos de capa de red genéricos (JDBC y ODBC) y los tipos de datos de infraestructura de datos. También proporciona tablas de conversión para capas de red específicas como OLE DB, Oracle OCI y Sybase CTL y describe las conversiones no triviales y excepciones para bases de datos específicas, como los archivos CSV y los sistemas SAP ERP y la base de datos de SAP HANA.
Manual de acceso a los datos Referencia a conversión de tipos de datos
Información relacionada Tipos de datos de archivos CSV [página 226] Tipos de datos JDBC [página 227] Tipos de datos ODBC [página 229] Tipos de datos OData [página 231] Tipos de datos OLE DB [página 232] Tipos de datos Oracle OCI [página 233] Tipos de datos de SAP ERP [página 234] Tipos de datos de SAP HANA [página 235] Tipos de datos Sybase CTL [página 236] Tipos de datos XML [página 237]
14.1.1
Tipos de datos de archivos CSV
Sintaxis:
La siguiente tabla detalla los tipos de datos declarados en los archivos DDL para la detección de esquemas de archivos CSV y sus equivalentes en infraestructuras de datos. .
BIT, BOOLEAN
BIT
DATE
DATE
TIME
TIME
CRONOMARCADOR
CRONOMARCADOR
BIGINT, DECIMAL
DECIMAL
FLOAT, DOUBLE, REAL
DOUBLE
INTEGER, INT, SMALLINT
INTEGER
NUMBER, NUMERIC
NUMERIC
VARCHAR
VARCHAR
Información relacionada Detección de esquemas CSV [página 69]
IBM Informix La siguiente tabla recoge los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos IBM Informix mediante JDBC y sus equivalentes en las infraestructuras de datos. Estos tipos de datos sobrescriben a los genéricos.
TIMESTAMP
Puede asignarse al tipo siguiente:
Manual de acceso a los datos Referencia a conversión de tipos de datos
DATE si el tipo de datos de Informix sigue el patrón DATETIME\\s+(HOUR|MINUTE|SECOND)\\s+TO \\s+(HOUR|MINUTE|SECOND)
●
TIME si el tipo de datos de Informix sigue el patrón DATETIME\\s+(YEAR|MONTH|DAY)\\s+TO\\s+ (YEAR|MONTH|DAY)
●
BOOLEAN
TIMESTAMP en el resto de casos
SMALLINT
MS SQL Server La siguiente tabla recoge los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos MS SQL Server mediante JDBC y sus equivalentes en las infraestructuras de datos. La asignación del tipo de datos también depende del nombre del tipo de SQL asociado con el tipo de datos de la capa de red. Estos tipos de datos sobrescriben a los genéricos.
LONGVARCHAR
cualquier otro valor diferente de "xml"
VARCHAR
LONGVARCHAR
xml
XML
Oracle La siguiente tabla recoge los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos Oracle mediante JDBC y sus equivalentes en las infraestructuras de datos. La asignación del tipo de datos también depende del nombre del tipo de SQL asociado con el tipo de datos de la capa de red. Estos tipos de datos sobrescriben a los genéricos.
IBM DB2 La siguiente tabla recoge los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos IBM DB2 mediante ODBC y sus equivalentes en las infraestructuras de datos. Estos tipos de datos sobrescriben a los genéricos.
SQL_BLOB
LONGVARBINARY
SQL_CLOB, SQL_DBCLOB, SQL_LONGVARGRAPHIC
LONGVARCHAR
SQL_DECFLOAT
DOUBLE
SQL_GRAPHIC
CHAR
SQL_VARGRAPHIC
VARCHAR
SQL_XML
XML
IBM Informix La siguiente tabla recoge los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos IBM Informix mediante ODBC y sus equivalentes en las infraestructuras de datos. Estos tipos de datos sobrescriben a los genéricos.
MS SQL Server La siguiente tabla recoge los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos MS SQL Server mediante ODBC y sus equivalentes en las infraestructuras de datos. Estos tipos de datos sobrescriben a los genéricos.
SQL_SS_TIME2, SQL_SS_TIMESTAMPOFFSET
TIMESTAMP
SQL_SS_XML
XML
14.1.4 Tipos de datos OData Sintaxis:
La tabla siguiente enumera tipos de datos Modelo de datos de entidad (EDM) internos en orígenes de datos OData y sus equivalentes en las infraestructuras de datos.
Edm.Binary
BINARY
Edm.Boolean
BIT
Edm.DateTime, Edm.Time
TIMESTAMP
Nota Los nanosegundos no están asignados. Edm.Int64
BIGINT
Manual de acceso a los datos Referencia a conversión de tipos de datos
La siguiente tabla recoge los tipos de datos que aparecen en OLE DB y sus equivalentes en las infraestructuras de datos.
Nota En algunos tipos de datos, la asignación depende de los valores de los parámetros DBCOLUMNFLAGS_ISLONG y DBCOLUMNFLAGS_ISFIXEDLENGTH asociados con cada tipo.
Tipos de datos de MS SQL Server La siguiente tabla muestra los tipos de datos que podrían encontrarse en resultados cuando el usuario realiza consultas en una base de datos MS SQL Server mediante OLE DB y sus equivalentes en las infraestructuras de datos. Estos tipos de datos sobrescriben a los anteriores.
DBTYPE_DBTIME2, DBTYPE_DBTIMESTAMPOFFSET
TIMESTAMP
DBTYPE_GUID
CHAR
DBTYPE_XML
XML
14.1.6 Tipos de datos Oracle OCI Sintaxis:
La siguiente tabla recoge los tipos de datos que aparecen en Oracle OCI y sus equivalentes en las infraestructuras de datos.
SQLT_BIN
BINARY
SQLT_BFILE, SQLT_BLOB, SQLT_LBI
LONGVARBINARY
Manual de acceso a los datos Referencia a conversión de tipos de datos
La siguiente tabla recoge los tipos de datos ABAP que utilizan los sistemas SAP ERP y sus equivalentes en infraestructuras de datos.
HEXADECIMAL
BINARY
DATE
DATE
TIME
TIME
FLOAT
FLOAT
INTEGER
INTEGER
NUMERIC TEXT, PACKED NUMBER
NUMERIC
TEXT
CHAR
VARIABLE LENGTH STRING
VARCHAR
Formato de fecha en expresiones SQL El formato de fecha que el usuario de aplicación tiene que utilizar al construir consultas en el Editor de la expresión SQL es FECHA'aaaa-mm-dd', por ejemplo: FECHA'2013-04-10'.
El formato se especifica en el archivo PRM ampliado jco.prm con el parámetro USER_INPUT_DATE_FORMAT. Consulte la Guía del usuario de la herramienta de diseño de información.
Información relacionada Acerca de los archivos PRM [página 207]
14.1.8 Tipos de datos de SAP HANA Sintaxis:
La tabla siguiente lista los tipos de datos usados en la base de datos de SAP HANA y sus equivalentes en las infraestructuras de datos. Para más información acerca de los tipos de datos de SAP HANA, consulte la referencia de tipos de datos de SAP HANA.
BLOB
LONGVARBINARY
VARBINARY
VARBINARY
DATE
DATE
TIME
TIME
LONGDATE, SECONDDATE, TIMESTAMP
TIMESTAMP
Nota SECONDDATE se convierte en TIMESTAMP sin mili segundos. DECIMAL, REAL, SMALLDECIMAL
FLOAT
BIGINT, INTEGER, SMALLINT, TINYINT
INTEGER
DOUBLE
DOUBLE
CLOB, NCLOB, TEXT
LONGVARCHAR
ALPHANUM, NVARCHAR, SHORTTEXT, VARCHAR
VARCHAR
Manual de acceso a los datos Referencia a conversión de tipos de datos
Información relacionada Referencia de tipo de datos de SAP HANA
14.1.9 Tipos de datos Sybase CTL Sintaxis:
La siguiente tabla recoge los tipos de datos que aparecen en Sybase CTL y sus equivalentes en las infraestructuras de datos.
Nota Los tipos de datos de Sybase CTL son los valores del campo datatype de la estructura CS_DATAFMT, que exhibe la capa de red. El valor del campo usertype de la estructura se proporciona también para algunos tipos de datos y lo utiliza la capa de acceso a datos para la asignación.
Nota Los tipos de datos derivados de la cadena están asignados a CHAR o VARCHAR. anySimpleType, anyType, anyURI, duration, gDay, gMonth, gMonthDay, gYear, gYearMonth, NOTATION, QName
VARCHAR
Asignar los metadatos de columna El tipo de datos determina si firmado o sin firmar. Anulable se determina desde los atributos nullable y minOccurs. Tamaño de la columna, dígitos decimales, y tamaño de visualización se determinan desde el tipo de datos. Si el tipo no proporciona ninguna indicación, se devuelve una longitud máxima configurable por el usuario.
● ● ●
14.2 Restricción del tamaño de datos de longitud variable Restricción La restricción solo afecta a aplicaciones de Crystal Reports. Debido a la implementación de la capa de acceso a datos, el tamaño máximo de una columna para datos binarios de longitud variable y caracteres está limitado a 16 MB para los siguientes orígenes de datos: ●
Si el usuario de una aplicación inserta datos de longitud variable de más de 16 MB en un informe, el rendimiento del sistema puede verse afectado.
14.3 Asignación de tipo de datos para universos habilitados para varios orígenes En caso de una infraestructura de datos habilitada para varias fuentes, los tipos de datos del servidor de conexión se convierten en los tipos de datos expuestos por el servicio de federación de datos. Los tipos de datos de la federación de datos son: ● ● ● ● ● ● ● ●
BIT DATE TIME TIMESTAMP DOUBLE DECIMAL INTEGER VARCHAR
Se asignan a los tipos de datos de la infraestructura de datos correspondiente.
Precaución Los tipos BINARY, VARBINARY y LONGVARBINARY no se admiten y los valores de estos tipos se asignan a NULL.
Manual de acceso a los datos Referencia a conversión de tipos de datos