Manual de acceso a los datos

Anuncio
Manual de acceso a los datos
SAP BusinessObjects XI3.1 Service Pack 5
Copyright
© 2011 SAP AG.Reservados todos los derechos. SAP, R/3, SAP NetWeaver,
Duet, PartnerEdge, ByDesign, SAP Business BusinessObjects Explorer,
StreamWork y otros productos y servicios de SAP mencionados aquí, así como
sus respectivos logotipos, son marcas comerciales o marcas registradas de SAP
AG en Alemania y en otros países. Business Objects y el logotipo de Business
Objects, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence,
Xcelsius y otros productos y servicios de Business Objects mencionados, así como
sus logotipos respectivos, son marcas comerciales o marcas registradas de
Business Objects Software Ltd. Business Objects es una empresa de SAP. Sybase
y Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere y otros productos y
servicios de Sybase mencionados, así como sus logotipos respectivos son marcas
comerciales o marcas registradas de Sybase, Inc. Sybase es una empresa de
SAP. Todos los demás nombres de productos y servicios mencionados son marcas
comerciales de sus respectivas empresas. Los datos de este documento sólo
tienen carácter informativo. Las especificaciones de productos en cada país pueden
ser diferentes. Estos materiales pueden modificarse sin previo aviso. Estos
materiales los proporciona SAP AG y sus empresas afiliadas ("SAP Group") con
carácter informativo, sin representación ni garantía de ningún tipo y SAP Group
no se hace responsable de los errores u omisiones en dichos materiales. Las
únicas garantías para los productos y servicios de SAP Group son aquellas
especificadas en las clausulas expresas de garantía que acompañan a dichos
productos y servicios, si las hubiera. Nada de lo que aparezca en este documento
debe interpretarse como garantía adicional.
2011-12-01
Contenido
Capítulo 1
Introducción al acceso a los datos
13
Acerca del servidor de conexión...............................................................14
Componentes de una conexión.................................................................14
Acerca de la arquitectura del sistema..................................................15
Acerca de controladores de acceso a datos........................................15
Acerca de las conectividades que admiten un inicio de sesión único...16
Acerca de archivos de configuración de acceso a datos..........................17
Acerca del archivo de configuración global cs.cfg...............................17
Acerca de los archivos de configuración de controladores *.sbo.........18
Acerca de los procedimientos almacenados.............................................20
Acerca de las funciones de base de datos compatibles......................20
Acerca de los procedimientos almacenados de Oracle.......................21
Para crear un cursor dentro de un paquete.........................................22
Para crear un procedimiento almacenado de Oracle...........................22
Acerca de los procedimientos almacenados de Teradata....................23
Capítulo 2
Crear una conexión
25
Requisitos de conexión..............................................................................26
Comprobación de configuración de conexión...........................................26
Mostrar ayuda sobre la herramienta cscheck......................................27
Para ejecutar la herramienta cscheck..................................................28
Herramienta de comprobación: introducción a las funciones..............29
Herramienta de comprobación: list......................................................30
Herramienta de comprobación: driverssearch.....................................31
Herramienta de comprobación: find.....................................................32
Herramienta de comprobación: middleware........................................35
Manual de acceso a los datos
3
Contenido
Herramienta de comprobación: accessdriver.......................................36
Herramienta de comprobación: connectivity........................................38
Herramienta de comprobación: ping ...................................................40
Acerca de conexiones JDBC ....................................................................42
Para crear una conexión JDBC ................................................................43
Ejemplo de estructura de archivos de JDBC SBO...............................44
Para crear una conexión de JDBC genérico.............................................45
Ejemplo de estructura de archivos de JDBC genérico SBO................46
Acerca de conexiones JavaBean..............................................................47
Para crear una conexión JavaBean..........................................................47
Ejemplo de estructura de archivos de JavaBean SBO .......................48
Acerca de las conexiones ODBC..............................................................49
Para crear una conexión de ODBC genérico............................................50
Para crear una conexión de ODBC3 genérico..........................................52
Capítulo 3
Crear una conexión a Data Federator Query Server
55
Acerca de las conexiones Data Federator Query Server..........................56
Configurar el Asistente de nueva conexión para una conexión JDBC o ODBC
de Data Federator......................................................................................57
Configurar conexiones JDBC de Data Federator......................................58
Configurar el servidor de conexión para una conexión ODBC de Data
Federator..............................................................................................59
Configurar conexiones ODBC de Data Federator.....................................59
Configurar el middleware ODBC de Data Federator ...........................60
Configurar el servidor de conexión para una conexión de ODBC de Data
Federator..............................................................................................61
Configurar definiciones de conexiones de Cliente enriquecido de Web
Intelligence con el middleware ODBC de Data Federator.........................62
Configurar el middleware ODBC de Data Federator para una conexión
de Cliente enriquecido de Web Intelligence ........................................63
Configurar el servidor de conexión para una conexión del Cliente
enriquecido de Web Intelligence con Data Federator..........................64
4
Manual de acceso a los datos
Contenido
Configurar la clave de registro del Cliente enriquecido de Web Intelligence
.............................................................................................................6 5
Configurar el servidor de conexión para conexiones del Cliente
enriquecido de Web Intelligence y Universe Designer con Data
Federator..............................................................................................65
Capítulo 4
Configurar parámetros globales de acceso a los datos
67
Acerca de parámetros globales.................................................................68
Acerca del archivo de configuración cs.cfg...............................................68
Para visualizar y editar un archivo cs.cfg..................................................69
Configurar los parámetros predeterminados de los controladores............70
Configurar los parámetros de configuración global...................................70
Charset List Extension.........................................................................71
Config File Extension...........................................................................71
Description Extension...........................................................................72
Enable Failed Load..............................................................................72
Load Drivers On Startup.......................................................................73
Max Pool Time......................................................................................74
SQL External Extension.......................................................................75
SQL Parameter Extension....................................................................75
Strategies Extension............................................................................76
Transient Object Timeout.....................................................................76
Configuración del modo de despliegue.....................................................77
Configuración del modo de despliegue.....................................................77
Configurar el controlador para cargarlo en el modo de servidor...............78
Configurar una conectividad por equipo..............................................80
Configurar los protocolos de acceso CORBA...........................................81
Capítulo 5
Configurar parámetros de controlador de acceso a los datos
83
Configuración de parámetros de controlador............................................84
Archivos de configuración de acceso a datos......................................84
Manual de acceso a los datos
5
Contenido
Archivos SBO instalados......................................................................85
Para visualizar y editar un archivo SBO...............................................87
Configurar el acceso a datos para los controladores personalizados ODBC
de DataDirect.............................................................................................88
Para activar el uso de los controladores personalizados DataDirect....89
Capítulo 6
Referencia de parámetros de SBO
91
Categorías de parámetros SBO................................................................92
Estructura de archivos SBO......................................................................92
Parámetros de SBO predeterminados......................................................95
Array Bind disponible...........................................................................95
Tamaño Array Bind...............................................................................95
Array Fetch Available...........................................................................96
Tamaño Array fetch..............................................................................96
Catalog Name Max Size.......................................................................97
Catalog Separator................................................................................97
CharSet................................................................................................98
Column Name Max Size.......................................................................98
Connection Shareable..........................................................................99
Cost Estimate Available.......................................................................99
Description File...................................................................................100
Driver Capabilities..............................................................................100
Escape Character...............................................................................101
Extensions..........................................................................................102
Family.................................................................................................102
Field Size Factor................................................................................102
Force Execute....................................................................................103
Identifier Case....................................................................................104
Identifier Quote String........................................................................104
Cláusula de escape LIKE...................................................................105
Configuración regional.......................................................................105
6
Manual de acceso a los datos
Contenido
Max Rows Available...........................................................................106
Optimize Execute...............................................................................106
Owners Available...............................................................................107
Password Encryption..........................................................................107
Procedure Name Max Size................................................................108
Procedure Parameter Name Max Size..............................................109
Qualifiers Available.............................................................................109
Query TimeOut Available...................................................................110
Quoted Identifier Case.......................................................................110
Schema Name Max Size....................................................................111
Shared Connection.............................................................................111
SQL External File...............................................................................112
SQL Parameter File............................................................................112
SSO Available....................................................................................113
Strategies File....................................................................................113
Table Name Max Size........................................................................114
Transactional Available......................................................................115
Transaction Mode...............................................................................115
Tipo.....................................................................................................116
Versión...............................................................................................116
XML Max Size....................................................................................117
Parámetros de Informix SBO...................................................................117
Para modificar el archivo Informix ODBC.INI.....................................117
V5toV6DriverName............................................................................118
Unicode..............................................................................................119
Parámetros de JavaBean SBO...............................................................119
JavaBean Class.................................................................................120
Formato de las direcciones URL........................................................120
Parámetros de JDBC SBO......................................................................121
ForeignKeys Available........................................................................121
JDBC Class........................................................................................121
Manual de acceso a los datos
7
Contenido
PrimaryKey Available.........................................................................122
Parámetros de ODBC SBO.....................................................................122
Connection Status Available..............................................................123
Empty String.......................................................................................123
Force Close Statement.......................................................................124
Native Int64 Available.........................................................................124
ODBC Cursors...................................................................................125
SQLDescribeParam Available............................................................125
SQLMoreResults Available................................................................126
Use DataDirect OEM Driver...............................................................126
Parámetros de OLE DB SBO..................................................................127
Enumerator CLSID.............................................................................127
Provider CLSID..................................................................................127
Parámetros de OLE DB OLAP SBO........................................................128
MSOlap CLSID...................................................................................128
Sybase ASE/CTLIB.................................................................................128
Quoted Identifier.................................................................................128
Capítulo 7
Configurar parámetros de generación de SQL
131
Acerca de parámetros de generación de SQL........................................132
Acerca de los archivos PRM....................................................................132
Estructura de archivos de parámetros PRM......................................135
Para visualizar y editar un archivo PRM..................................................139
Para visualizar y editar un archivo de texto de ayuda de funciones........139
Para editar el texto de ayuda de una función PRM.................................140
Capítulo 8
Referencia de parámetros de PRM
143
Referencia de la configuración del archivo PRM.....................................144
BACK_QUOTE_SUPPORTED..........................................................144
CASE_SENSITIVE.............................................................................145
8
Manual de acceso a los datos
Contenido
CHECK_OWNER_STATE..................................................................145
CHECK_QUALIFIER_STATE.............................................................146
COMMA..............................................................................................146
CONCAT............................................................................................147
CONSTANT_SAMPLING_SUPPORTED...........................................148
DATABASE_DATE_FORMAT............................................................148
DATATYPE_BLOB..............................................................................148
DATATYPE_DOUBLE........................................................................149
DATATYPE_DTM...............................................................................149
DATATYPE_INT.................................................................................150
DATATYPE_NULL..............................................................................150
DATATYPE_STRING .........................................................................150
DATE_WITHOUT_QUOTE ...............................................................151
DELIMIT_IDENTIFIERS.....................................................................151
EXT_JOIN..........................................................................................152
EXT_JOIN_INVERT...........................................................................152
EXTERN_SORT_EXCLUDE_DISTINCT...........................................153
GROUPBY_EXCLUDE_COMPLEX...................................................154
GROUPBY_WITH_ALIAS..................................................................154
GROUPBY_WITHOUT_CONSTANT.................................................155
GROUPBYCOL..................................................................................156
IDENTIFIER_DELIMITER..................................................................156
IF_NULL.............................................................................................157
INTERSECT.......................................................................................158
KEY_INFO_SUPPORTED.................................................................158
LEFT_OUTER....................................................................................159
LENMAXFORCOLUMNNAME...........................................................160
LENMAXFORTABLENAME...............................................................160
LENMAXFORVARCHAR....................................................................160
MINUS................................................................................................161
NO_DISTINCT...................................................................................161
Manual de acceso a los datos
9
Contenido
NULL_IN_SELECT_SUPPORTED....................................................162
OLAP_CLAUSE.................................................................................163
OUTERJOINS_GENERATION...........................................................163
OVER_CLAUSE.................................................................................167
OWNER..............................................................................................168
PERCENT_RANK_SUPPORTED......................................................168
PREFIX_SYS_TABLE........................................................................169
QUALIFIER........................................................................................169
QUOTE_OWNER...............................................................................170
RANK_SUPPORTED.........................................................................171
REFRESH_COLUMNS_TYPE...........................................................171
REVERSE_TABLE_WEIGHT.............................................................172
RIGHT_OUTER..................................................................................172
RISQL_FUNCTIONS..........................................................................173
SEED_SAMPLING_SUPPORTED.....................................................174
SORT_BY_NO...................................................................................175
UNICODE_PATTERN........................................................................175
UNION................................................................................................176
USER_INPUT_DATE_FORMAT........................................................177
USER_INPUT_NUMERIC_SEPARATOR..........................................178
Capítulo 9
Referencia a conversión de tipos de datos
179
Conversión de tipo de datos ...................................................................180
IBM DB2.............................................................................................180
Informix...............................................................................................182
Microsoft SQL Server.........................................................................183
Oracle.................................................................................................184
Red Brick............................................................................................185
Para agregar compatibilidad con TIME y TIMESTAMP en una cláusula
WHERE..............................................................................................186
Sybase...............................................................................................187
10
Manual de acceso a los datos
Contenido
Teradata.............................................................................................189
Apéndice A
Más información
191
Índice
195
Manual de acceso a los datos
11
Contenido
12
Manual de acceso a los datos
Introducción al acceso a los
datos
1
1
Introducción al acceso a los datos
Acerca del servidor de conexión
Acerca del servidor de conexión
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 origen de datos.
El servidor de conexión permite a las aplicaciones como Universe Designer
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: Cree conexiones mediante 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.
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 contienen parámetros que definen la
conexión entre:
• la aplicación y el servidor de conexión
•
14
la aplicación y el controlador de acceso a los datos
Manual de acceso a los datos
Introducción al acceso a los datos
Componentes de una conexión
•
El servidor de conexión y el controlador de acceso a datos
Acerca de la arquitectura del sistema
El diagrama siguiente 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 Enterprise.
Acerca de controladores de acceso a datos
Los controladores de acceso a los datos conectan el servidor de conexión
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
Manual de acceso a los datos
15
1
1
Introducción al acceso a los datos
Componentes de una conexión
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 controlador 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.
En SAP Service Marketplace encontrará una lista actualizada de los
controladores de acceso a datos compatibles, en http://service.sap.com/bo
sap-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.
Acerca de las conectividades que admiten un inicio
de sesión único
SAP BusinessObjects Enterprise solo ofrece 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:
•
•
•
•
SAP BW en todas las plataformas
MS Analysis Services en Microsoft Windows
MS SQL Server a través de ODBC u OLE DB en Microsoft Windows
Oracle 10 a través de Oracle OCI en Microsoft Windows
Nota:
SSO no está disponible para conexiones JDBC. Para obtener más
información sobre el SSO, consulte el Manual del administrador de SAP
BusinessObjects Enterprise.
16
Manual de acceso a los datos
Introducción al acceso a los datos
Acerca de archivos de configuración de acceso a datos
Acerca de archivos de configuración de
acceso a datos
Los archivos de configuración de acceso a los datos se instalan con SAP
BusinessObjects Enterprise. Los archivos de configuración se pueden dividir
en dos niveles:
•
Nivel global: El archivo de configuración cs.cfg se aplica a todas las
conexiones.
•
Nivel de controlador: Existe un archivo de configuración *.sbo para cada
controlador específico.
Además de los archivos de configuración que controlan una conexión, cada
controlador de acceso a los datos tiene un archivo de configuración .prm
asociado. Estos archivos los usan aplicaciones como Universe Designer.
Los archivos .prm controlan la forma en que una aplicación genera SQL
en función de las capacidades del software de la base de datos.
Nota:
En este manual, la variable connectionserver-install-dir es la ruta
raíz de la instalación para los archivos de acceso a los datos usados por
aplicaciones de SAP Business Objects. En Microsoft Windows, el directorio
connectionserver-install-dir predeterminado es: C:\Archivos
de programa\Business Objects\BusinessObjects Enterprise
12.0\win32_x86\dataAccess.
Precaución:
En los archivos de configuración de acceso a los datos, use el signo de
escape \ con la barra invertida \ en las rutas de archivos si despliega el
software SAP BusinessObjects Enterprise en una plataforma Microsoft
Windows.
Acerca del archivo de configuración global cs.cfg
El archivo de configuración global cs.cfg que utilizan los controladores de
acceso a los datos se instala en la siguiente ubicación:
• dir-instal-connectionserver \connectionServer
Manual de acceso a los datos
17
1
1
Introducción al acceso a los datos
Acerca de archivos de configuración de acceso a datos
El archivo cs.cfg contiene parámetros que se aplican a todos los
controladores de acceso a datos instalados.
Temas relacionados
• Acerca de parámetros globales
Acerca de los archivos de configuración de
controladores *.sbo
Los archivos de configuración que utilizan los controladores de acceso a
datos se instalan en la siguiente ruta:
• en un sistema Windows:
dir-instal-connectionserver \connectionServer\RDBMS
•
en un sistema Unix:
dir-instal-connectionserver /RDBMS/connectionServer
donde RDBMS es el nombre de la tecnología de base de datos que utiliza
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.
18
Manual de acceso a los datos
Introducción al acceso a los datos
Acerca de archivos de configuración de acceso a datos
Archivo específi¿Se puede edico de controlatar?
dor
Descripción
<controla
dor>.sbo
Yes
Existe un archivo
.sbo para cada
protocolo de red
compabible o cada middleware de
base de datos utilizado para la cooracle.sbo
nexión a una base de datos. Define la configuración de conectividad específica
para cada base
de datos.
Sí
Define parámetros que afectan
a la forma en la oracle.prm
que una aplicación genera SQL.
<controla
dor>.prm
<controla
dor><idio
ma>.cod
No
Ejemplo
Guarda información relacionada
con definiciones
de conexión. Define los campos
que aparecen al oracleen.cod
crear una conexión nueva.
Nota:
No modifique estos archivos.
Manual de acceso a los datos
19
1
1
Introducción al acceso a los datos
Acerca de los procedimientos almacenados
Temas relacionados
• Categorías de parámetros SBO
• Referencia de la configuración del archivo PRM
• Acerca de parámetros de generación de SQL
Acerca de los procedimientos
almacenados
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 SAP BusinessObjects Enterprise 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,
Sybase y Teradata, todos a través de JDBC
Oracle a través de OCI
DB2 iSeries, Informix, MS SQL Server, Sybase ASIQ, Sybase SQL
Anywhere y Teradata, todos a través de ODBC
MS SQL Server a través de OLE DB
Acerca de las funciones de base de datos compatibles
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 ni IN/OUT. Asimismo, las sentencias COMPUTE, PRINT,
20
Manual de acceso a los datos
Introducción al acceso a los datos
Acerca de los procedimientos almacenados
OUTPUT o STATUS que se encuentran en procedimientos almacenados no
se ejecutan.
Recuerde:
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.
Nota:
Para obtener más información acerca del uso de procedimientos
almacenados, consulte el Manual del diseñador.
Acerca de los procedimientos almacenados de Oracle
Los procedimientos almacenados de Oracle son los siguientes:
•
•
Procedimientos PL/SQL que devuelvan 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:
•
•
•
•
•
Procedimientos PL/SQL que no devuelvan conjuntos de resultados
mediante un parámetro REF CURSOR
Procedimientos PL/SQL que tengan al menos un parámetro OUT
Funciones PL/SQL
Procedimientos PL/SQL que tengan un parámetro IN/OUT de un tipo
distinto al de REF CURSOR, por ejemplo, VARRAY
Funciones de tabla PL/SQL
Para acceder a los procedimientos almacenados de Oracle, deberá realizar
varias tareas en el servidor para permitir que SAP BusinessObjects Enterprise
se conecte a un procedimiento almacenado. Estas tareas se explican en las
siguientes secciones.
Manual de acceso a los datos
21
1
1
Introducción al acceso a los datos
Acerca de los procedimientos almacenados
Para 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;
Precaución:
SAP BusinessObjects Enterprise no admite procedimientos almacenados
empaquetados, sólo independientes.
Para 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
OPEN cat_cv FOR SELECT * FROM all_objects;
END;
b. Escriba el siguiente enunciado con diversos parámetros:
CREATE or REPLACE PROCEDURE get_ownerobjects(ow
ner_name IN
varchar2, cat_cv IN OUT catalog_data.catcurtyp) AS
BEGIN
OPEN cat_cv FOR SELECT * FROM all_objects WHERE
22
Manual de acceso a los datos
Introducción al acceso a los datos
Acerca de los procedimientos almacenados
owner=owner_name;
END;
Nota:
Para obtener más información sobre la creación de paquetes y
procedimientos almacenados, consulte la documentación de Oracle.
Acerca de los procedimientos almacenados de
Teradata
El Servidor de conexión solo admite las macros de Teradata si la conexión
establecida usa ODBC.
Precaución:
No admite los procedimientos almacenados en Teradata de ODBC. Tampoco
admite macros o procedimientos almacenados en JDBC.
Las macros de Teradata tienen la sintaxis siguiente:
create macro <macro_name> as (select * from <table_na
me>;);
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 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';
Manual de acceso a los datos
23
1
1
Introducción al acceso a los datos
Acerca de los procedimientos almacenados
select count(*) from guest;
);
24
Manual de acceso a los datos
Crear una conexión
2
2
Crear una conexión
Requisitos de conexión
Requisitos de conexión
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 SAP BusinessObjects.
•
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.
Temas relacionados
• Comprobación de configuración de conexión
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
26
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
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 siguiente directorio: connec
tionserver-install-dir\connectionServer\tools
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 dados
•
comprobar si existe una instalación válida del controlador de acceso a
los datos para una capa de red y un cliente de base de datos dados
•
comprobar si se puede establecer una conexión a una base de datos
concreta
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
Mostrar ayuda sobre la herramienta cscheck
La herramienta cscheck proporciona funciones para:
•
mostrar ayuda general sobre la utilidad cscheck
Manual de acceso a los datos
27
2
2
Crear una conexión
Comprobación de configuración de conexión
•
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:
Figura 2-1: Sintaxis de ayuda del comando
cscheck
--help|h --language|l { idioma }
Para mostrar ayuda sobre una función, use la siguiente sintaxis, donde
nombreFunción es el nombre de la función para la que se precisa ayuda, e
idioma es el idioma en el que se mostrará la ayuda:
Figura 2-2: Sintaxis de ayuda de la función
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
Para ejecutar la herramienta cscheck
La herramienta cscheck se puede ejecutar en cualquier momento tras la
instalación de la solución SAP BusinessObjects.
1. Abra una consola de comandos.
2. Cambie el directorio a la ruta de acceso en la que se encuentra instalada
la herramienta.
3. Introduzca cscheck con los parámetros correctos para encontrar la
información deseada.
4. Revise la información que se devuelve.
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
28
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
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.
Figura 2-3: Sintaxis de cscheck
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:
• <idioma de salida> o l seguido del idioma especificado en el
estándar ISO-639. 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.
<nombre de función> puede tomar los valores siguientes. Cada función tiene
un formato abreviado que se puede usar en lugar del nombre de función
completo:
• list o lt
•
driverssearch o ds
•
find o fd
•
middleware o mw
•
accessdriver o ad
•
connectivity o ct
Manual de acceso a los datos
29
2
2
Crear una conexión
Comprobación de configuración de conexión
•
ping o pg
Temas relacionados
• Herramienta de comprobación: accessdriver
• Herramienta de comprobación: connectivity
• Herramienta de comprobación: driverssearch
• Herramienta de comprobación: find
• Herramienta de comprobación: list
• Herramienta de comprobación: middleware
• Herramienta de comprobación: ping
Herramienta de comprobación: list
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 con 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.
Figura 2-4: Sintaxis de list
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 9
Oracle 10
Oracle 11
30
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
Sybase Open Client
Sybase Adaptive Server 12
Sybase Adaptive Server 15
Informix ODBC Driver
Informix XPS 8.4
Informix XPS 8.5
Informix Dynamic Server 7.3
Informix Dynamic Server 2000
Informix Dynamic Server 10
Informix Dynamic Server 11
Teradata ODBC Driver
Teradata V2 R5
Teradata V2 R6
Teradata 12
ODBC Drivers
Generic ODBC Datasource
Generic ODBC3 Datasource
...
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Mostrar ayuda sobre la herramienta cscheck
Herramienta de comprobación: driverssearch
Esta función devuelve una lista de los controladores de acceso a datos
instalados.
Figura 2-5: Sintaxis de driverssearch
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 dri
ver
Manual de acceso a los datos
31
2
2
Crear una conexión
Comprobación de configuración de conexión
Client layer: Oracle Client
Database engine(s):
Oracle 9
Oracle 10
Oracle 11
This access driver is installed: Sybase Open Client ac
cess driver
Client layer: Sybase Open Client
Database engine(s):
Sybase Adaptive Server 12
Sybase Adaptive Server 15
This access driver is installed: Informix ODBC access
driver
Client layer: Informix ODBC Driver
Database engine(s):
Informix XPS 8.4
Informix XPS 8.5
Informix Dynamic Server 7.3
Informix Dynamic Server 2000
Informix Dynamic Server 10
Informix Dynamic Server 11
This access driver is installed: Teradata ODBC access
driver
Client layer: Teradata ODBC Driver
Database engine(s):
Teradata V2 R5
Teradata V2 R6
Teradata 12
...
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Mostrar ayuda sobre la herramienta cscheck
Herramienta de comprobación: find
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
32
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
•
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
Figura 2-6: Sintaxis de find
cscheck |find||fd| -m { Modo de acceso al servidor de conexión }
Tabla 2-1: Parámetros de entrada de la función
Modo en el que la aplicación cliente
accede al servidor de conexión:
• local: muestra una lista de los tipos de conectividad disponibles
en el equipo local.
•
corba: muestra una lista de los tipos de conectividad disponibles
que emplean CORBA.
Modo de acceso al servidor de cone- •
xión (-m)
http: muestra una lista de los tipos
de conectividad disponibles que
emplean HTTP.
•
java: muestra una lista de los tipos de conectividad Java disponibles en el equipo local.
•
extended: muestra una lista de
los tipos de conectividad local,
java y corba.
Ejemplo: Buscar conectividades locales
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.
Manual de acceso a los datos
33
2
2
Crear una conexión
Comprobación de configuración de conexión
cscheck find –m local
A continuación se ofrece un extracto de la lista de resultados:
Local Library Mode
IBM DB2 Client
DB2 v9
DB2 UDB v8
DB2 UDB for z/OS v8
DB2 UDB for OS/390 v7
DB2 UDB for iSeries v5
Essbase Provider
Hyperion Essbase 7.0
Hyperion Essbase 9
Informix ODBC Driver
Informix Dynamic Server 7.3
Informix Dynamic Server 2000
Informix Dynamic Server 10
Informix Dynamic Server 11
Informix XPS 8.4
Informix XPS 8.5
ODBC Drivers
Generic ODBC datasource
Generic ODBC3 datasource
MS SQL Server 7.x
MS SQL Server 2000
MS SQL Server 2005
Sybase ASIQ 12
Sybase SQL Anywhere 10
...
Ejemplo: Buscar conectividades de servidor CORBA
El siguiente comando devuelve una lista de los controladores de acceso
a datos disponibles en un servidor CORBA.
cscheck find –m corba
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Mostrar ayuda sobre la herramienta cscheck
34
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
Herramienta de comprobación: middleware
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.
Figura 2-7: Sintaxis de middleware
cscheck |middleware| |mw| -c { capa de red }-d{ cliente de base
de datos }
Tabla 2-2: Parámetros de entrada de la función
nivel de red (-c)
Nivel de red que usa el middleware
de la base de datos, tal como lo devuelve la función find.
cliente de base de datos (-d)
Base de datos que se comprueba,
tal como la devuelve la función find.
Ejemplo:
El siguiente comando comprueba si existe una instalación válida del
middleware de Oracle Client 9 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 installa
tion...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
Manual de acceso a los datos
35
2
2
Crear una conexión
Comprobación de configuración de conexión
End AND operator: failure.
The middleware is not correctly installed.
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Mostrar ayuda sobre la herramienta cscheck
• Herramienta de comprobación: connectivity
• Herramienta de comprobación: accessdriver
Herramienta de comprobación: accessdriver
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.
Figura 2-8: Sintaxis de accessdriver
cscheck |accessdriver| |ad| -c { capa de red }-d{ cliente de base
de datos }
Tabla 2-3: Parámetros de entrada de la función
36
nivel de red ( -c )
Nivel de red que usa el middleware
de la base de datos, tal como lo devuelve la función find.
cliente de base de datos (-d)
Base de datos que se comprueba,
tal como la devuelve la función find.
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
Ejemplo:
El siguiente comando comprueba si existe una instalación válida de un
controlador de acceso a datos de Oracle 9, y muestra la salida en francés:
cscheck -l fr accessdriver -c "Oracle Client" -d "Oracle
9"
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 los datos de Oracle 9:
cscheck ad -c "Oracle Client" -d "Oracle 9"
El resultado es el siguiente:
Starting to check the access driver component installa
tion...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle
OCI... success.
Directory... success.
/connectionserver-install-dir/connectionServer//ora
cle... success.
Library... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci9.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci10.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci11.so... success.
Data File Name... success.
/connectionserver-install-dir/connectionServer//ora
cle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
Manual de acceso a los datos
37
2
2
Crear una conexión
Comprobación de configuración de conexión
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Mostrar ayuda sobre la herramienta cscheck
• Herramienta de comprobación: list
Herramienta de comprobación: connectivity
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.
Figura 2-9: Sintaxis de connectivity
cscheck |connectivity||ct|-c{ capa de red }-d{ cliente de base de
datos }
Tabla 2-4: Parámetros de entrada de la función
nivel de red (-c)
Nivel de red que usa el middleware
de la base de datos, tal como lo devuelve la función find.
cliente de base de datos (-d)
Base de datos que se comprueba,
tal como la devuelve la función find.
Ejemplo:
El siguiente comando comprueba el middleware del cliente Oracle instalado
y el controlador de acceso a datos de Oracle 9. El comando escribe la
salida en un archivo de texto: c:\result.txt .
cscheck -l en connectivity -c "Cliente Oracle" -d "Ora
cle 9">c:\result.txt
38
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
Si el middleware no está instalado correctamente, el resultado será el
siguiente:
Starting to check the middleware component installa
tion...
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 installa
tion...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle
OCI... success.
Directory... success.
/connectionserver-install-dir/connectionServer//ora
cle... success.
Library... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci9.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci10.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci11.so... success.
Data File Name... success.
/connectionserver-install-dir/connectionServer//ora
cle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Mostrar ayuda sobre la herramienta cscheck
• Herramienta de comprobación: find
• Herramienta de comprobación: accessdriver
• Herramienta de comprobación: middleware
• Herramienta de comprobación: ping
Manual de acceso a los datos
39
2
2
Crear una conexión
Comprobación de configuración de conexión
Herramienta de comprobación: ping
Esta función intenta tener acceso a una base de datos concreta con los
detalles que se proporcionen.
Figura 2-10: Sintaxis de ping
cscheck ping|pg|-m{ Modo de acceso al servidor de conexión }-c{
capa 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 2-5: Parámetros de entrada de la función
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.
Modo de acceso al servidor de conexión (-m)
40
•
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 comprueba la conexión, tal
como se devuelve con la función
find.
cliente de base de datos (-d)
Tipo de base de datos, tal como se
devuelve con la función find.
Manual de acceso a los datos
Crear una conexión
Comprobación de configuración de conexión
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.
origen 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 servidor de conexión a
través del cual se realiza el sondeo.
Ejemplo: Sondeo de una base de datos Oracle
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 8.1
•
Origen de datos: Harlaxton
•
Nombre de usuario: efashion
•
Contraseña: X2345
cscheck ping -m local -c "Cliente Oracle" -d "Oracle
8.1" -u "efashion" -p "X2345" -s "Harlaxton"
Manual de acceso a los datos
41
2
2
Crear una conexión
Acerca de conexiones JDBC
Ejemplo: Sondeo de una base de datos Sybase mediante CORBA
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: password
•
Origen de datos: Sybase Adaptive Server 15
•
Base de datos: SY1
•
Host de base de datos: sybasehost
•
ID de proceso: 456
cscheck ping -m corba -c "Sybase Open Client" -d syb15
-u "syadmin" -p "password" -s "Sybase Adaptive Server
15" -t "SY1" -r "sybasehost" -i 456
Temas relacionados
• Herramienta de comprobación: introducción a las funciones
• Herramienta de comprobación: find
Acerca de conexiones JDBC
Durante la instalación de la aplicación de SAP Business Objects se instala
un conjunto de controladores de acceso a los datos. Puede usar esos
controladores de acceso a datos para crear conexiones a bases de datos.
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 debe:
• Obtener el software de controlador Java a través del proveedor de su
base de datos.
•
42
Modificar los archivos de configuración suministrados.
Manual de acceso a los datos
Crear una conexión
Para crear una conexión JDBC
Nota:
La conectividad de JDBC está disponible para SAP BusinessObjects
Enterprise XI 3.0 y superior.
Precaución:
El Cliente enriquecido de SAP BusinessObjects Web Intelligence no admite
la conectividad JDBC en modo 3-tier.
En SAP Service Marketplace encontrará una lista actualizada de los
controladores JDBC compatibles, en http://service.sap.com/bosap-support.
También puede consultar con su representante de SAP.
Nota:
La capa de acceso a los datos proporciona la conectividad de JDBC genérico
para crear una conexión a un origen de datos que SAP BusinessObjects
Enterprise no admite explícitamente.
Temas relacionados
• Para crear una conexión JDBC
• Para crear una conexión de JDBC genérico
Para crear una conexión JDBC
Para crear una conexión JDBC:
• 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).
Para crear una conexión JDBC, use este procedimiento:
1. Compruebe si hay más archivos DLL que necesite el controlador y
asegúrese de que están accesibles para el sistema. Por ejemplo, el
controlador JDBC de SQL Server 2005 utiliza más archivos DLL. El
directorio de éstos debe estar incluido en la variable de entorno PATH.
2. Acceda al directorio que contiene el archivo jdbc.sbo. Por ejemplo, en
Microsoft Windows, los archivos de configuración se encuentran en el
Manual de acceso a los datos
43
2
2
Crear una conexión
Para crear una conexión JDBC
directorio connectionserver-install-dir\connectionSer
ver\jdbc.
3. Use un editor XML para abrir y editar el archivo jdbc.sbo.
4. Agregue los detalles de archivo .jar requeridos al área ClassPath. Al
especificar estos archivos debe incluir la ruta completa, por ejemplo:
<Path>C:\\JDBC Drivers\\MSSQLSERVER2000\\msu
til.jar</Path>
Nota:
Los archivos deben instalarse en el equipo en que se ejecuta la aplicación.
Para obtener más detalles, consulte la información sobre la estructura
del archivo de ejemplo jdbc.sbo.
5. Localice el parámetro Driver Capabilities y asegúrese de que está
configurado como Procedures o Queries.
De no ser así, el controlador JDBC no estará disponible desde el
Asistente de nueva conexión.
6. Guarde y cierre el archivo .sbo.
7. 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.
Temas relacionados
• Ejemplo de estructura de archivos de JDBC SBO
• Requisitos de conexión
Ejemplo de estructura de archivos de JDBC SBO
Aquí se ofrece un ejemplo de la sección del archivo JDBC SBO que debe
modificar. Este archivo SBO es para Microsoft SQL Server 2000.
<DataBase Active="Yes" Name="MS SQL Server 2000">
...
<JDBCDriver>
<ClassPath>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2000\\msba
se.jar</Path>
44
Manual de acceso a los datos
Crear una conexión
Para crear una conexión de JDBC genérico
<Path>C:\JDBC Drivers\MSSQLSERVER2000\\msu
til.jar</Path>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2000\\mssqlser
ver.jar</Path>
</ClassPath>
...
</JDBCDriver>
...
</DataBase>
Para crear una conexión de JDBC genérico
El siguiente procedimiento indica cómo configurar una conexión de JDBC
genérico con una base de datos. Para crear una conexión de JDBC genérico:
• Obtenga el software de controlador JDBC requerido para la base de
datos y copie los archivos a su sistema. 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).
Para crear una conexión JDBC, use este procedimiento:
1. Desplácese al directorio que contiene los archivos jdbc.sbo y
jdbc.prm. Por ejemplo, en Microsoft Windows, los archivos de configu
ración se encuentran en el directorio connectionserver-installdir\connectionServer\jdbc.
2. Use un editor XML para abrir y editar el archivo jdbc.sbo.
3. Agregue los detalles de archivo .jar requeridos al área ClassPath. Al
especificar estos archivos debe incluir la ruta completa. Establezca la
clase del controlador JDBC y el formato de URL con los parámetros
adecuados.
Para obtener más detalles, consulte la información sobre la estructura
del archivo de ejemplo jdbc.sbo.
4. Guarde y cierre el archivo jdbc.sbo.
5. Use un editor de XML para abrir y editar el archivo jdbc.prm.
6. Agregue o actualice cualquier información específica de la base de datos.
Manual de acceso a los datos
45
2
2
Crear una conexión
Para crear una conexión de JDBC genérico
Nota:
Puede que el archivo jdbc.prm no contenga información sobre las
funciones específicas de la base de datos.
7. Guarde y cierre el archivo jdbc.prm.
8. Ejecute el Asistente de nueva conexión. El controlador JDBC que ha
configurado aparece en la lista de conexiones disponibles en Genérico.
Seleccione el controlador JDBC y use el asistente para configurar la
conexión.
Cuando se complete esta tarea, la conexión con el origen de datos estará
disponible para usar mediante JDBC.
Nota:
Sólo puede configurar una conexión a través de una implementación de
JDBC genérico.
Temas relacionados
• Acerca de los archivos PRM
Ejemplo de estructura de archivos de JDBC genérico
SBO
Aquí se ofrece un ejemplo de la sección del archivo JDBC SBO que debe
modificar. Este archivo SBO es para el origen de datos de JDBC genérico
y la base de datos Ingres.
Nota:
El controlador JDBC Ingres consta del archivo iijdbc.jar. La clase
com.ingres.jdbc.IngresDriver implementa la interfaz JDBC ja
va.sql.Driver.
<DataBases>
<DataBase Active="Yes" Name="Generic JDBC datasource">
<JDBCDriver>
<ClassPath>
<Path>c:\\jdbc\\ingres\\iijdbc.jar</Path>
</ClassPath>
<Parameter Name="JDBC Class">com.ingres.jdbc.IngresDri
ver</Parameter>
<Parameter Name="URL Format">jdbc:ingres://$DATASOUR
CE$</Parameter>
46
Manual de acceso a los datos
Crear una conexión
Acerca de conexiones JavaBean
</JDBCDriver>
...
</DataBases>
Nota:
$DATASOURCE$ es <host>:<puerto> o <host>:<puerto>/<base_da
tos>.
Acerca de conexiones JavaBean
Los desarrolladores 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:
•
los archivos .jar requeridos
•
cualquier otro archivo requerido por JavaBean
•
cualquier detalle de configuración específico requerido por el controlador
de objetos JavaBean
Dentro de un controlador de objetos JavaBean, los procedimientos de
recuperación de datos se configuran como procedimientos almacenados.
Al configurar una conexión de objetos JavaBean, en la pantalla Selección
del middleware de la base de datos del asistente Nueva conexión, debe
seleccionar la casilla Filtrar capas de red de procedimientos almacenados.
De lo contrario, el asistente Nueva conexión no mostrará los controladores
de JavaBeans que haya disponibles.
Para crear una conexión JavaBean
Para crear una conexión JavaBeans, use el siguiente procedimiento:
1. Use un editor XML para abrir y editar el archivo javabeans.sbo. Por
ejemplo, en Microsoft Windows, los archivos de configuración se encuen
tran en el directorio connectionserver-install-dir\connection
Server\javabean.
2. Agregue los detalles de archivo .jar requeridos al área ClassPath. Al
especificar estos archivos debe incluir la ruta completa.
Manual de acceso a los datos
47
2
2
Crear una conexión
Para crear una conexión JavaBean
Nota:
Los archivos deben instalarse en el equipo en que se ejecuta la aplicación
de SAP BusinessObjects.
Para más información, consulte la sección de ejemplo de estructura de
archivos JavaBean.sbo.
3. Guarde y cierre el archivo .sbo.
4. Realice otras tareas de configuración especificadas por el desarrollador
de JavaBeans.
5. Ejecute el Asistente de conexión. El origen de datos JavaBeans que ha
configurado debería 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.
Temas relacionados
• Ejemplo de estructura de archivos de JavaBean SBO
• PrimaryKey Available
Ejemplo de estructura de archivos de JavaBean SBO
Esta sección contiene un ejemplo de archivo JavaBeans SBO.
<DataBase Active="Yes" Name="Excel
Spreadsheet">
<JavaBean>
<ClassPath>
<Path>$ROOT$\\beans\\bean_excel.jar
</Path>
</ClassPath>
<Parameter Name="JavaBean Class">com.
businessobjects.beans.excel.Excel
</Parameter>
<Parameter Name="URL Format">$DATASOURCE$
</Parameter>
</JavaBean>
<Parameter Name="Family">Java Beans
</Parameter>
<Parameter Name="Description File">
bean_excel</Parameter>
48
Manual de acceso a los datos
Crear una conexión
Acerca de las conexiones ODBC
<Parameter Name="Authentication Mode">
Bypass</Parameter>
<Parameter Name="Extensions">bean_excel,
javabean</Parameter>
</DataBase>
</DataBases>
Acerca de las conexiones ODBC
Durante la instalación de la aplicación de SAP Business Objects se instala
un conjunto de controladores de acceso a los datos. Puede usar esos
controladores de acceso a datos para crear conexiones a bases de datos.
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.
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 de acceso a los datos proporciona la conectividad de ODBC genérico
para crear una conexión a un origen de datos que SAP BusinessObjects
Enterprise 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
Manual de acceso a los datos
49
2
2
Crear una conexión
Para crear una conexión de ODBC genérico
•
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.
Nota:
Sólo puede configurar una conexión a través de una implementación de
ODBC genérico.
Temas relacionados
• Para crear una conexión de ODBC genérico
• Para crear una conexión de ODBC3 genérico
Para crear una conexión de ODBC
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 ODBC2.
• El controlador admite el administrador de controladores unixODBC.
1. Desplácese al directorio que contiene los archivos odbc.sbo y
odbc.prm.
Los archivos de configuración se encuentran en el directorio connec
tionserver-install-dir/connectionServer/odbc.
2. Use un editor de XML para abrir y editar el archivo odbc.sbo.
3. Localice la siguiente sección:
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc</Library>
<Library Platform="Unix">dbd_ddodbc</Library>
<!--Library Platform="Unix">dbd_wuxodbc</Library-->
<!--Library Platform="Unix">dbd_uxodbc</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">data
direct</Parameter>
50
Manual de acceso a los datos
Crear una conexión
Para crear una conexión de ODBC genérico
...
</DataBases>
4. 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 <Parameter
Name="CharSet Table" Platform="Unix">.
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.
5. Guarde y cierre el archivo odbc.sbo.
6. Use un editor de XML para abrir y editar el archivo odbc.prm.
7. 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.
8. Guarde y cierre el archivo odbc.prm.
9. Instale los controladores ODBC relevantes en el equipo de UNIX.
10. Configure el origen de datos editando el archivo odbc.ini.
11. Guarde y cierre el archivo odbc.ini.
12. Ejecute el Asistente de nueva 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 se complete esta tarea, la conexión con el origen de datos estará
disponible para usar mediante ODBC genérico con el administrador de
controladores unixODBC.
Manual de acceso a los datos
51
2
2
Crear una conexión
Para crear una conexión de ODBC3 genérico
Para 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.
1. Desplácese al directorio que contiene los archivos odbc.sbo y
odbc.prm.
Los archivos de configuración se encuentran en el directorio connec
tionserver-install-dir/connectionServer/odbc.
2. Use un editor de XML para abrir y editar el archivo odbc.sbo.
3. Localice la siguiente sección:
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC3 datasour
ce">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc3</Library>
<Library Platform="Unix">dbd_ddodbc3</Library>
<!--Library Platform="Unix">dbd_wuxodbc3</Library->
<!--Library Platform="Unix">dbd_uxodbc3</Library-->
<!--Library Platform="Unix64">dbd_wux32odbc3</Li
brary-->
<!--Library Platform="Unix64">dbd_ux32odbc3</Library->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">data
direct</Parameter>
...
</DataBases>
4. 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 <Parameter
name="CharSet Table" Platform="Unix">.
52
Manual de acceso a los datos
Crear una conexión
Para crear una conexión de ODBC3 genérico
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).
5. Guarde y cierre el archivo odbc.sbo.
6. Use un editor de XML para abrir y editar el archivo odbc.prm.
7. 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.
8. Guarde y cierre el archivo odbc.prm.
9. Instale los controladores ODBC relevantes en el equipo de UNIX.
10. Configure el origen de datos editando el archivo odbc.ini.
11. Guarde y cierre el archivo odbc.ini.
12. Ejecute el Asistente de nueva 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.
Manual de acceso a los datos
53
2
2
Crear una conexión
Para crear una conexión de ODBC3 genérico
54
Manual de acceso a los datos
Crear una conexión a Data
Federator Query Server
3
3
Crear una conexión a Data Federator Query Server
Acerca de las conexiones Data Federator Query Server
Acerca de las conexiones Data Federator
Query Server
Puede crear conexiones a las tablas desplegadas en Data Federator Query
Server con el objeto de usarlas con una aplicación de SAP BusinessObjects.
Nota:
Para obtener más información acerca de la conexión a Data Federator,
consulte el Manual de usuario de Data Federator (en inglés) y el capítulo
“Connecting to Data Federator Query Server using JDBC/ODBC drivers”
(Conexión con Data Federator Query Server mediante controladores
JDBC/ODBC).
Este capítulo describe la configuración adicional que se debe implementar
en Data Federator Query Server, así como los detalles de configuración que
se deben utilizar en el servidor de conexión para crear conexiones.
El método que utilice para configurar la conexión dependerá de si utiliza
JDBC o ODBC para ésta. 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 SAP BusinessObjects Web Intelligence.
El método que use para crear la conexión dependerá de la aplicación que
esté usando. Utilice el Asistente de nueva conexión de la aplicación para
crear la conexión. Consulte la documentación de usuario de la aplicación
para obtener más información.
Este capítulo también indica la configuración que se debe implementar en
el Asistente de nueva conexión de las aplicaciones Universe Designer y
SAP BusinessObjects Web Intelligence con el fin de poder crear conexiones.
Precaución:
SAP recomienda usar una conectividad de JDBC para conectar aplicaciones
de SAP BusinessObjects a Data Federator Query Server. La conectividad
de JDBC sólo se admite en la versión SAP BusinessObjects Enterprise XI 3.0
y superior, y no permite las conexiones a SAP BusinessObjects Desktop
Intelligence. La conectividad de JDBC está disponible en todas las
plataformas (Microsoft Windows, tipos de UNIX y Linux).
56
Manual de acceso a los datos
Crear una conexión a Data Federator Query Server
Configurar el Asistente de nueva conexión para una conexión JDBC o ODBC de Data Federator
La versión de ODBC mínima que puede usar con los detalles de
configuración siguientes es Data Federator XI versión 2 SP1 MHF1. Si es
necesario, póngase en contacto con el representante de SAP para obtener
más información sobre la versión y cómo conseguirla. 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.
Temas relacionados
• Configurar el Asistente de nueva conexión para una conexión JDBC o
ODBC de Data Federator
• Configurar conexiones JDBC de Data Federator
• Configurar conexiones ODBC de Data Federator
• Configurar definiciones de conexiones de Cliente enriquecido de Web
Intelligence con el middleware ODBC de Data Federator
Configurar el Asistente de nueva
conexión para una conexión JDBC o
ODBC de Data Federator
Con el objeto de crear una conexión a Data Federator 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 nueva 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 nueva conexión, desde la pantalla Selección del
middleware de la base de datos, podrá usar el middleware de SAP
BusinessObjects, el servidor de Data Federator, los controladores JDBC
o los controladores ODBC para crear la conexión.
Manual de acceso a los datos
57
3
3
Crear una conexión a Data Federator Query Server
Configurar conexiones JDBC de Data Federator
Consulte la documentación de la aplicación para obtener información acerca
de cómo usar el Asistente de nueva conexión una vez haya realizado los
cambios de configuración.
Nota:
Para configurar una conexión de JDBC u ODBC en Data Federator Query
Server, existen algunas configuraciones adicionales que se deben realizar.
Si está utilizando el Cliente enriquecido de SAP BusinessObjects Web
Intelligence, los cambios de configuración requeridos son diferentes de los
utilizados por otras aplicaciones de SAP BusinessObjects.
Configurar conexiones JDBC de Data
Federator
Esta sección contiene los cambios de configuración del servidor de conexión
para conexiones JDBC a todas las aplicaciones de SAP BusinessObjects.
Los detalles de configuración de esta sección hacen referencia a la ruta de
acceso siguiente:
• data-federator-drivers-install-dir\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.
• dir-instal-bo: 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.
58
Manual de acceso a los datos
Crear una conexión a Data Federator Query Server
Configurar conexiones ODBC de Data Federator
Configurar el servidor de conexión para una conexión
ODBC de Data Federator
Nota:
Este tema se aplica a todas las aplicaciones de SAP BusinessObjects que
usan el servidor de conexión.
Para configurar el servidor de conexión, debe cambiar el archivo de
configuración: bo_install_dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer\jdbc\jdbc.sbo
Para configurar el archivo jdbc.sbo, agregue o modifique las siguientes
líneas en el área ClassPath del siguiente modo:
<DataBase Active="Yes" Name="Data Federator Server">
<JDBCDriver>
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\JdbcDri
ver\\lib\\thindriver.jar</Path>
<Path>\\businessobjects-install-dir\\common\\4.0\\ja
va\\lib\\ebus405.jar</Path>
</ClassPath>
<Parameter Name="URL Format">jdbc:datafederator://$DA
TASOURCE$;catalog="$DATABASE$";commProto
col=EBUS</Parameter>
</JDBCDriver>
...
</DataBase>
donde businessobjects-install-dir representa el directorio
C:\Archivos de programa\Business Objects de Microsoft Windows.
El archivo ebus405.jar se incluye en la instalación de SAP
BusinessObjects Enterprise.
Configurar conexiones ODBC de Data
Federator
Esta sección contiene la configuración adicional de Data Federator 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
Manual de acceso a los datos
59
3
3
Crear una conexión a Data Federator Query Server
Configurar conexiones ODBC de Data Federator
BusinessObjects, excepto el Cliente enriquecido de SAP BusinessObjects
Web Intelligence.
Los detalles de configuración de esta sección hacen referencia a las rutas
de acceso siguientes:
• data-federator-drivers-install-dir\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.
•
data-federator-drivers-install-dir\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.
•
dir-instal-bo: 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.
Temas relacionados
• Configurar el middleware ODBC de Data Federator
• Configurar el servidor de conexión para una conexión de ODBC de Data
Federator
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 SAP
BusinessObjects Web Intelligence.
Para configurar el middleware ODBC de Data Federator, debe modificar el
archivo openrda.ini. Este archivo se instala en el siguiente directorio:
60
Manual de acceso a los datos
Crear una conexión a Data Federator Query Server
Configurar conexiones ODBC de Data Federator
•
data-federator-drivers-install-dir\OaJdbcBrid
ge\bin\iwinnt
Para configurar el archivo openrda.ini, defina parámetros en la sección
[JavaIp] del siguiente modo:
•
CLASSPATH=data-federator-drivers-install-dir\OaJdbc
Bridge\oajava\oasql.jar;data-federator-drivers-installdir\JdbcDriver\thindriver.jar;bo-install-dir\Busines
sObjects Enterprise 12.0\classes\ConnectionServer.jar
•
JVM_DLL_NAME=bo-install-dir\ja
vasdk\jre\bin\client\jvm.dll
•
JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connec
tivity.directory=bo-install-dir\BusinessObjects Enter
prise 12.0\win32_x86\dataAccess\connectionServer
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 Dja
va.endorsed.dirs.
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 SAP
BusinessObjects Web Intelligence.
Para configurar el servidor de conexión, debe cambiar el archivo de
configuración: bo_install_dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer\cs.cfg
Manual de acceso a los datos
61
3
3
Crear una conexión a Data Federator Query Server
Configurar definiciones de conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC
de Data Federator
Para configurar el archivo cs.cfg, defina parámetros bajo la etiqueta Ja
vaVM, del siguiente modo:
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\OaJdbcBrid
ge\\oajava\\oasql.jar</Path>
<Path>\\data-federator-drivers-install-dir\\JdbcDri
ver\\thindriver.jar</Path>
</ClassPath>
Configurar definiciones de conexiones
de Cliente enriquecido de Web
Intelligence con el middleware ODBC de
Data Federator
Al crear conexiones del Cliente enriquecido de SAP BusinessObjects Web
Intelligence que usen 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 SAP BusinessObjects Web Intelligence.
Para crear conexiones que hagan uso del middleware ODBC de Data
Federator para usarlas con esta aplicación, 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:
• data-federator-drivers-install-dir\OaJdbcBridge: Directorio
de instalación raíz para el middleware ODBC de Data Federator. El
62
Manual de acceso a los datos
Crear una conexión a Data Federator Query Server
Configurar definiciones de conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC
de Data Federator
administrador eligió este directorio al ejecutar el instalador de
controladores de Data Federator.
•
data-federator-drivers-install-dir\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.
•
dir-instal-bo: 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.
Temas relacionados
• Configurar el middleware ODBC de Data Federator para una conexión de
Cliente enriquecido de Web Intelligence
• Configurar el servidor de conexión para una conexión del Cliente
enriquecido de Web Intelligence con Data Federator
• Configurar la clave de registro del Cliente enriquecido de Web Intelligence
• Configurar el servidor de conexión para conexiones del Cliente enriquecido
de Web Intelligence y Universe Designer con Data Federator
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:
•
data-federator-drivers-install-dir\OaJdbcBrid
ge\bin\iwinnt
Para configurar el archivo openrda.ini, defina parámetros en la sección
[JavaIp] del siguiente modo:
•
CLASSPATH=data-federator-drivers-install-dir\OaJdbc
Bridge\oajava\oasql.jar;data-federator-drivers-install-
Manual de acceso a los datos
63
3
3
Crear una conexión a Data Federator Query Server
Configurar definiciones de conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC
de Data Federator
dir\JdbcDriver\thindriver.jar;bo-install-dir\Busines
sObjects Enterprise 12.0\classes\ConnectionServer.jar
•
JVM_DLL_NAME=bo-install-dir\ja
vasdk\jre6\bin\client\jvm.dll
Nota:
El cliente enriquecido de SAP BusinessObjects Web Intelligence requiere
JDK 6.
•
JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connec
tivity.directory=bo-install-dir\BusinessObjects Enter
prise 12.0\win32_x86\dataAccess\connectionServer
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 Dja
va.endorsed.dirs.
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 SAP BusinessObjects Web Intelligence con Data Federator,
debe cambiar el archivo de configuración: bo-installdir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer\cs.cfg
Para configurar el archivo cs.cfg, defina parámetros bajo la etiqueta Ja
vaVM, del siguiente modo:
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\OaJdbcBrid
ge\\oajava\\oasql.jar</Path>
<Path>\\data-federator-drivers-install-dir\\JdbcDri
ver\\thindriver.jar</Path>
</ClassPath>
64
Manual de acceso a los datos
Crear una conexión a Data Federator Query Server
Configurar definiciones de conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC
de Data Federator
Configurar la clave de registro del Cliente
enriquecido de Web Intelligence
Para modificar la clave del registro del cliente enriquecido de Windows, use
una herramienta como regedit.
1. En el registro, localice la clave
HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite
12.0\default\WebIntelligence\RichClient.
2. En esta clave, agregue los siguientes valores al valor classpath. Como
sucede con todos los valores de claves de registro, los valores deben ir
separados por un punto y coma.
• data-federator-drivers-install-dir\OaJdbcBridge\oa
java\oasql.jar
•
data-federator-drivers-install-dir\JdbcDriver\thin
driver.jar
Configurar el servidor de conexión para conexiones
del Cliente enriquecido de Web Intelligence y
Universe Designer con Data Federator
Es posible usar una única configuración para crear una conexión de ODBC
con Data Federator desde Universe Designer, así como desde el Cliente
enriquecido de SAP BusinessObjects Web Intelligence. Además de la
configuración descrita anteriormente, siga uno de los conjuntos de
instrucciones siguientes:
• Haga lo siguiente:
1. Ejecute la herramienta regedit.
2. En el registro, localice la clave
HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite
12.0\default\ConnectionServer\Configuration.
3. En esta clave, agregue el siguiente valor al valor JVM Library: boinstall-dir\javasdk\jre6\bin\client\jvm.dll.
Manual de acceso a los datos
65
3
3
Crear una conexión a Data Federator Query Server
Configurar definiciones de conexiones de Cliente enriquecido de Web Intelligence con el middleware ODBC
de Data Federator
•
Haga lo siguiente:
1. Abra el archivo cs.cfg para su edición.
2. Localice la etiqueta JavaVM.
3. Defina LibraryName en la misma ruta del directorio JVM especificada
en el archivo openrda.ini:
...
<JavaVM>
<LibraryName JNIVersion="JNI_VERSION_1_4">\\boinstall-dir\\javasdk\\jre6\\bin\\client\\jvm.dll</Li
braryName>
</JavaVM>
Precaución:
Universe Designer y el puente OpenEdge deben especificar la misma ruta
del directorio JVM.
66
Manual de acceso a los datos
Configurar parámetros
globales de acceso a los
datos
4
4
Configurar parámetros globales de acceso a los datos
Acerca de parámetros globales
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 reemplazar esta configuración global, puede configurar parámetros en
cada archivo .sbo del controlador.
Temas relacionados
• Configuración de parámetros de controlador
Acerca del archivo de configuración cs.cfg
En un sistema Windows, el archivo cs.cfg se encuentra en esta ubicación:
•
dir-instal-connectionserver \connectionServer
En el archivo cs.cfg, puede configurar parámetros únicamente en estas
secciones:
• <Configuración>
Esta sección define los parámetros de configuración globales del servidor
de conexión, incluidos los tipos de acceso de clientes (por ejemplo,
CORBA).
Estos parámetros se pueden sustituir por los correspondientes en el
archivo de configuración de controlador de acceso a datos: <controla
dor>.sbo, donde <controlador> es el nombre del controlador de
acceso a datos con el que está relacionado el archivo .sbo.
•
<Capacidades>
En esta sección se definen los parámetros que le permitirán especificar
el uso del servidor de conexión local o remoto.
68
Manual de acceso a los datos
Configurar parámetros globales de acceso a los datos
Para visualizar y editar un archivo cs.cfg
•
<Distribución>
Puede configurar estos parámetros en esta sección si utiliza CORBA.
•
<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.
•
<Controladores predeterminados>
Estos parámetros se aplican a todos los controladores de acceso a datos.
•
<Seguimientos>
Puede definir parámetros de seguimiento que permiten el registro de la
actividad de la conexión mediante Connection Server en archivos de
registro. Para obtener más información acerca de la generación de
seguimientos, consulte las notas de la versión.
La sección <Locales> define el juego de caracteres del sistema operativo
para cada idioma disponible. No es posible modificar los parámetros de esta
sección.
Para visualizar y editar un archivo cs.cfg
Puede visualizar y editar parámetros de un archivo cs.cfg de la siguiente
manera:
1. Vaya al directorio que almacena el archivo cs.cfg. Por ejemplo, en un
sistema Windows:
dir-instal-connectionserver\connectionServer\cs.cfg
donde dir-instal-connectionserver es la ruta en la que está
instalado el software del servidor de conexión.
2. Abra el archivo cs.cfg en un editor de XML.
3. Despliegue las secciones como sea necesario.
4. 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.
5. Compruebe que el documento es válido con respecto a DTD; a
continuación, guarde y cierre el archivo.
Manual de acceso a los datos
69
4
4
Configurar parámetros globales de acceso a los datos
Configurar los parámetros predeterminados de los controladores
Configurar los parámetros
predeterminados de los controladores
La sección <DriverDefaults> del archivo cs.cfg contiene los valores
predeterminados que se aplican a todos los controladores de acceso a los
datos. Estos valores predeterminados se reemplazan para un controlador
específico por los valores correspondientes establecidos en el archivo
<controlador>.sbo.
Consulte la referencia de parámetros de archivo SBO para obtener
información sobre los parámetros que puede establecer.
Temas relacionados
• Archivos de configuración de acceso a datos
• Configuración de parámetros de controlador
• Categorías de parámetros SBO
Configurar los parámetros de
configuración global
La sección <Configuración> de un 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.
Los parámetros de <Settings> se enumeran alfabéticamente. Para
visualizar o editar parámetros, abra el archivo cs.cfgen un editor de XML
y vaya a la sección Settings y, a continuación, a la sección Parameters.
En el archivo, cada parámetro está definido en la etiqueta siguiente:
<Parameter Name="parámetro">valor</Parameter>
donde parámetro es el nombre del parámetro y valor es el valor atribuido
al parámetro.
Cada parámetro se muestra con la información siguiente:
•
70
ejemplo de cómo aparece el parámetro en el archivo XML; cuando el
parámetro está disponible en modo de biblioteca y de servidor, se muestra
un ejemplo de cada uno
Manual de acceso a los datos
Configurar parámetros globales de acceso a los datos
Configurar los parámetros de configuración global
•
descripción del parámetro
•
valores posibles que se pueden definir para el parámetro (cuando se
aplique)
•
valor predeterminado del parámetro
Charset List Extension
<Parameter Name="CharSet List Extension">crs</Parameter>
Nota:
Descripción
Predeterminado
No modifique este parámetro.
Establece la extensión de archivo para archivos de
juegos de caracteres.
crs
Config File Extension
<Parameter Name="Config File Extension">sbo</Parameter>
Nota:
Descripción
Predeterminado
No modifique este parámetro.
Establece la extensión de archivo para los archivos
de configuración general.
sbo
Manual de acceso a los datos
71
4
4
Configurar parámetros globales de acceso a los datos
Configurar los parámetros de configuración global
Description Extension
<Parameter Name="Description Extension">cod</Parameter>
Nota:
Descripción
Predeterminado
No modifique este parámetro.
Establece la extensión de archivo para los archivos
de descripción de conexiones.
cod
Enable Failed Load
<Parameter Name="Enable Failed Load">Yes</Parameter>
Descripción
Valores
Determina la acción llevada a cabo cuando se produce un fallo al cargar el controlador. El 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
el controlador.
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 controlador.
Predeterminados
72
Manual de acceso a los datos
Sí
Configurar parámetros globales de acceso a los datos
Configurar los parámetros de configuración global
Temas relacionados
• Load Drivers On Startup
Load Drivers On Startup
Load Drivers On startup se aplica tanto al modo de biblioteca como de ser
vidor.
Biblioteca
<Settings>
<Parameter Name="Load Drivers On Startup">No</Parameter>
...
<Library/>
Servidor
<Server>
<Parameter Name="Load Drivers On Startup">Yes</Parameter>
...
</Server>
Se describen a continuación.
Descripción
Valores
Determina cómo se cargan las bibliotecas del controlador.
•
Yes: todos los controladores instalados se cargan
durante la fase de inicialización.
•
No: los controladores se cargan cuando sean requeridos.
Modo de biblioteca: No
Predeterminado
Modo se servidor: Yes
Manual de acceso a los datos
73
4
4
Configurar parámetros globales de acceso a los datos
Configurar los parámetros de configuración global
Max Pool Time
Max Pool Time está disponible en modo de biblioteca y de servidor.
Biblioteca
<Settings>
<Parameter Name="Max Pool Time">-1</Parameter>
<Library/>
Servidor
<Server>
<Parameter Name="Max Pool Time">60</Parameter>
. . .
</Server>
Determina la duración máxima durante la que puede
permanecer inactiva en el conjunto de conexiones
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 de la base de datos y así hacer el mejor uso posible de los recursos del sistema.
Descripción
Puede definir Max Pool Time para dos tipos de despliegue de Connection Server:
Biblioteca: el valor se aplica a nodos que tienen
Connection Server instalado con productos de escritorio o servidor.
Servidor: el valor se aplica a instalaciones 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 despliegue de SAP BusinessObjects
Enterprise.
74
Manual de acceso a los datos
Configurar parámetros globales de acceso a los datos
Configurar los parámetros de configuración global
Modo de biblioteca: -1
Predeterminado
Servidor: 60
-1: ningún tiempo de espera definido; se mantiene la
conexión durante toda la sesión.
Valores
0: conexión no administrada por el grupo.
>0: duración de inactividad (en minutos).
SQL External Extension
<Parameter Name="SQL External Extension">rss</Parameter>
Nota:
Descripción
Predeterminado
No modifique este parámetro.
Establece la extensión de archivo para los archivos
SQL externos.
rss
SQL Parameter Extension
<Parameter Name="SQL Parameter Extension">prm</Parameter>
Nota:
Descripción
No modifique este parámetro.
Establece la extensión de archivo para los archivos
de parámetros de SQL.
Manual de acceso a los datos
75
4
4
Configurar parámetros globales de acceso a los datos
Configurar los parámetros de configuración global
Predeterminado
prm
Strategies Extension
<Parameter Name="Strategies Extension">stg</Parameter>
Nota:
Descripción
No modifique este parámetro.
Establece la extensión para archivos de estrategias.
Predeterminado
stg
Transient Object Timeout
<Parameter Name="Transient Object Timeout">60</Parameter>
Nota:
Descripción
No modifique este parámetro directamente. Puede
cambiarlo desde la Consola de administración central.
Consulte el Manual del administrador de SAP BusinessObjects Enterprise.
Especifica cuántos minutos se conservan los objetos
temporales no usados.
Predeterminado
76
Manual de acceso a los datos
60 (en minutos)
Configurar parámetros globales de acceso a los datos
Configuración del modo de despliegue
Configuración del 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 cliente. El nombre CORBA 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 MixedMode 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 C++ principal y viceversa.
Ejemplo:
El siguiente ejemplo muestra los valores predeterminados de <Capacida
des> en el archivo cs.cfg:
<Capabilities>
<Capability Name="Local" MixedMode="Yes" Active="Yes"/>
<Capability Name="CORBA" Active="Yes"/>
</Capabilities>
Configuración del modo de despliegue
Los parámetros definidos en la sección <Configuración> del archivo
cs.cfg controlan el método de acceso.
•
Los parámetros de la sección <Biblioteca> controlan el modo de
biblioteca. En este modo, el servidor de conexión se incluye en el proceso
del cliente. La mayoría de aplicaciones de SAP BusinessObjects usan
el servidor de conexión en modo de biblioteca.
Manual de acceso a los datos
77
4
4
Configurar parámetros globales de acceso a los datos
Configurar el controlador para cargarlo en el modo de servidor
•
Los parámetros de la sección <Servidor> controlan el acceso CORBA.
En este modo, el servidor de conexión es un servidor CORBA y se accede
a él remotamente. El servidor de conexión sirve a dos tipos diferentes
de clientes: clientes HTTP y clientes CORBA.
Estos parámetros se anteponen a cualquier definición de parámetros que
se haya establecido en otras partes de la sección <Configuración>. Por
lo tanto, la configuración definida en la sección <Servidor> anula los
parámetros definidos en otras áreas para aplicaciones que usan acceso a
<Biblioteca>. Estos parámetros son los siguientes:
•
Load Drivers On Startup
El valor predeterminado de este parámetro es Yes. Esto significa que
todos los controladores de acceso a los datos se cargan en el servidor
de conexión al inicio.
Precaución:
Para evitar fallos de conexión, debe asegurarse de que el entorno
proporciona todo el middleware necesario; de lo contrario, deberá
modificar la sección <Settings> incluyendo las capas de red y bases
de datos que necesita en <ActiveDataSources>. También puede
establecer Enable Failed Load en No.
•
•
Max Pool Time
Transient Object Timeout
Temas relacionados
• Configurar el controlador para cargarlo en el modo de servidor
• Load Drivers On Startup
• Enable Failed Load
• Max Pool Time
• Transient Object Timeout
Configurar el controlador para cargarlo
en el modo de servidor
El archivo cs.cfg se configura para escenarios de despliegue complejos
que implican varios servidores de conexión en el modo de servidor.
78
Manual de acceso a los datos
Configurar parámetros globales de acceso a los datos
Configurar el controlador para cargarlo en el modo de servidor
Especifique los orígenes de datos activos para ayudar a las aplicaciones
cliente a determinar los controladores que cada servidor de conexión carga
y utiliza. Para obtener más información sobre escenarios de despliegue
complejos, consulte el Manual de planificación de despliegue de SAP
BusinessObjects Enterprise.
La sección <ActiveDataSources> le ayuda a especificar las capas de
red y los orígenes de datos asociados que desea que use y exponga el
servidor de conexión. Esta sección funciona como filtro para los
controladores. Bajo la sección <ActiveDataSources>, en los elementos
<NetworkLayer> se enumeran los controladores disponibles para la
conexión. Para cada controlador, en los elementos <DataBase> se
enumeran los nombres de las bases de datos a las que se puede conectar
el servidor de conexión.
Si no proporciona ninguna sección <ActiveDataSources> o si la deja
vacía, no se procesa ningún filtrado. El servidor de conexión carga todos
los controladores disponibles.
Nota:
Puede encontrar la lista de capas de red disponibles en el archivo dri
ver.cfg, ubicado en el directorio connectionserver-installdir\connectionServer\. Los nombres de base de datos son expresiones
regulares que utilizan la sintaxis GNU regexp. 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.
Además de esta configuración, debe configurar los parámetros de la sección
<Distribución>.
Ejemplo:
En el ejemplo se muestra una configuración según la que el servidor de
conexión pone disponibles las siguientes bases de datos:
• cualquier versión de MS SQL Server a través de la capa de red ODBC
• cualquier versión de MS Access a través de la capa de red ODBC
• Oracle 9 y Oracle 10 a través de la capa de red Oracle OCI
<Server>
Manual de acceso a los datos
79
4
4
Configurar parámetros globales de acceso a los datos
Configurar el controlador para cargarlo en el modo de servidor
<Parameter Name="Load Drivers On Startup">Yes</Para
meter>
<Parameter Name="Max Pool Time">60</Parameter>
<Parameter Name="Transient Object Timeout">60</Para
meter>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
<DataBase Name="MS Access.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 9"/>
<DataBase Name="Oracle 10"/>
</NetworkLayer>
</ActiveDataSources>
</Server>
Temas relacionados
• Configurar los protocolos de acceso CORBA
Configurar una conectividad por equipo
En escenarios de despliegue complejos, puede ser buena idea configurar
una conectividad por tipo de equipo, por ejemplo, si desea conectar
aplicaciones de SAP BusinessObjects Enterprise 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, debe realizar una de las siguientes opciones:
•
•
al realizar una instalación personalizada del software SAP
BusinessObjects Enterprise, debe especificar las conectividades que
desea implementar para cada tipo de base de datos que necesite.
al configurar el servidor de conexión en el archivo cs.cfg, debe
configurar la sección <ActiveDataSources> del modo de biblioteca
(sección <Library>) al igual que el modo de servidor (sección <Ser
ver>).
Puesto que las aplicaciones intentan en primer lugar establecer
conexiones a través de los controladores instalados de forma local, debe
80
Manual de acceso a los datos
Configurar parámetros globales de acceso a los datos
Configurar los protocolos de acceso CORBA
configurar el filtro de los controladores para ambos modos de la misma
manera. Por ejemplo:
<Library>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 9"/>
<DataBase Name="Oracle 8"/>
</NetworkLayer>
</ActiveDataSources>
</Library>
<Server>
<Parameter Name="Load Drivers On Startup">Yes</Para
meter>
<Parameter Name="Max Pool Time">60</Parameter>
<Parameter Name="Transient Object Timeout">60</Para
meter>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 9"/>
<DataBase Name="Oracle 8"/>
</NetworkLayer>
</ActiveDataSources>
</Server>
Configurar los protocolos de acceso
CORBA
Establezca los siguientes parámetros en la sección <Distribution> del
cs.cfg cuando utilice el servidor de conexión con CORBA.
La sección <Protocols> contiene los valores predeterminados que el
servidor de conexión utiliza para procesar peticiones procedentes de clientes
CORBA o clientes HTTP. Para el acceso CORBA, configure la sección de
la siguiente manera:
<Protocol Name="CORBA" Active="Yes"/>
<Protocol Name="HTTP" Active="No"/>
Manual de acceso a los datos
81
4
4
Configurar parámetros globales de acceso a los datos
Configurar los protocolos de acceso CORBA
82
Manual de acceso a los datos
Configurar parámetros de
controlador de acceso a los
datos
5
5
Configurar parámetros de controlador de acceso a los datos
Configuración de parámetros de controlador
Configuración de parámetros de
controlador
Para configurar el acceso a datos para un controlador de acceso a datos
concreto, puede editar los archivos de parámetros XML del controlador con
el fin de ajustar la configuración de los parámetros.
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 Web Intelligence. Consulte el archivo readme de la versión
correspondiente para obtener instrucciones de uso de estas utilidades.
Temas relacionados
• Acerca de parámetros globales
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:
•
El archivo cs.cfg define los parámetros globales que se aplican a todas
las conexiones.
•
Existe un archivo de configuración independiente para cada controlador
de acceso a datos. Estos archivos se llaman <controlador>.sbo,
donde <controlador> es el nivel de red de la base de datos al que se
aplica el archivo de configuración.
Los parámetros establecidos en la sección Settings del archivo cs.cfg
se reemplazan con la configuración correspondiente de los archivos de
configuración del controlador de acceso a datos: <controlador>.sbo.
84
Manual de acceso a los datos
Configurar parámetros de controlador de acceso a los datos
Configuración de parámetros de controlador
Los archivos de configuración se ubican en las siguientes rutas, donde dirinstal-connectionserver es el directorio en el que se instala el software
Connection Server.
•
El archivo cs.cfg se encuentra en el siguiente directorio:
dir-instal-connectionserver\connectionServer\
•
Cada archivo .sbo es un subdirectorio de este directorio, donde el
nombre del subdirectorio está basado en el nombre de nivel de red de
la base de datos; por ejemplo, para bases de datos Oracle:
dir-instal-connectionserver\connectionServer\oracle
Temas relacionados
• Acerca de parámetros globales
• Archivos SBO instalados
• Configurar los parámetros predeterminados de los controladores
Archivos SBO instalados
Los siguientes archivos <controlador>.sbo se instalan de modo
predeterminado.
En el sitio web de SAP Service Marketplace encontrará una lista actualizada
de los controladores compatibles, en service.sap.com/bosap-support.
También puede consultar con su representante de SAP.
Controlador de acceso a los datos Archivo SBO
Essbase
essbase.sbo
db2.sbo
IBM DB2
iseries.sbo
Informix
informix.sbo
Manual de acceso a los datos
85
5
5
Configurar parámetros de controlador de acceso a los datos
Configuración de parámetros de controlador
Controlador de acceso a los datos Archivo SBO
JDBC proporciona controladores
JDBC para bases de datos. Consulte
el sitio web de SAP Service MarketPlace o el archivo jdbc.sbo para jdbc.sbo
averiguar qué bases de datos son
compatibles con conexiones de
JDBC.
Microsoft SQL Server
odbc.sbo y oledb.sbo
Microsoft Analysis Services
oledb_olap.sbo
MySQL
Nota:
La base de datos MySQL 5 está disponible en todas las plataformas y dispone de compatibilidad con Unicode.
Asegúrese de que utiliza MySQL Con- odbc.sbo
nector/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.
86
ODBC
odbc.sbo
Oracle
oracle.sbo
Red Brick
odbc.sbo
SAP
sap.sbo
Manual de acceso a los datos
Configurar parámetros de controlador de acceso a los datos
Configuración de parámetros de controlador
Controlador de acceso a los datos Archivo SBO
Sybase
sybase.sbo
Teradata
teradata.sbo
Diversos controladores
Nota:
Al desarrollar un controlador CSV
usando el kit de desarrollo de controla- open.sbo
dores Java, debe ubicar todos los archivos de configuración en este directorio.
Para visualizar y editar un archivo 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.
Puede abrir un archivo SBO para visualizarlo o editarlo de la siguiente
manera:
1. Vaya al directorio que almacena el archivo SBO del controlador de acceso
a los datos de destino.
2. Abra el archivo SBO en un editor de XML.
3. Despliegue las secciones como sea necesario.
4. Localice la etiqueta adecuada para el valor que desee cambiar y cambie
el valor.
Parámetros que aparecen en el formato: <Parameter Name="paráme
tro">valor</Parameter>, donde parámetro es el nombre del
parámetro, y valor es el valor atribuido al parámetro.
Manual de acceso a los datos
87
5
5
Configurar parámetros de controlador de acceso a los datos
Configurar el acceso a datos para los controladores personalizados ODBC de DataDirect
5. Compruebe que el archivo es válido con respecto a DTD, guarde y cierre
el archivo.
Configurar el acceso a datos para los
controladores personalizados ODBC de
DataDirect
Acceso a datos admite el uso de controladores DataDirect ODBC 5.3
personalizados para bases de datos de MS SQL Server en todas las
plataformas UNIX. Estos controladores DataDirect personalizados se
proporcionan como parte del software SAP BusinessObjects Enterprise y
sólo se pueden usar con aplicaciones de SAP BusinessObjects como SAP
BusinessObjects Web Intelligence y SAP BusinessObjects Desktop Intelligence.
El middleware y controladores siguientes están disponibles para plataformas
UNIX únicamente:
•
•
•
MS SQL Server 7.x
MS SQL Server 2000 SP4
MS SQL Server 2005 SP2
Pueden funcionar con el controlador DataDirect ODBC 5.3 o con el
controlador personalizado DataDirect ODBC 5.3.
Puede encontrar los archivos del controlador personalizado DataDirect en
el directorio boe-install-dir/enterprise120/platform-na
me/odbc/lib, donde boe-install-dir representa el directorio de
instalación de SAP BusinessObjects Enterprise y platform-name es el
nombre de la plataforma UNIX.
Precaución:
Para utilizar el controlador personalizado, debe asegurarse de que el acceso
a datos está configurado correctamente.
88
Manual de acceso a los datos
Configurar parámetros de controlador de acceso a los datos
Configurar el acceso a datos para los controladores personalizados ODBC de DataDirect
Para activar el uso de los controladores
personalizados DataDirect
Nota:
La sección siguiente sólo está relacionada con las bases de datos de MS
SQL Server 7.x, MS SQL Server 2000 SP4 y MS SQL Server 2005 SP2.
El acceso a datos admite el uso de controladores DataDirect ODBC 5.3 para
bases de datos de MS SQL Server en todas las plataformas UNIX. Estos
controladores pueden ser no personalizados o personalizados.
La configuración predeterminada del servidor de conexión permite que el
controlador ODBC no personalizado funcione sin problemas con la
configuración actual. Si ya ha desplegado un controlador en su entorno,
podrá instalar el controlador no personalizado sin ningún cambio de
configuración.
1. Desplácese al directorio que contiene el archivo odbc.sbo.
En UNIX, este archivo de configuración se encuentra en el directorio
connectionserver-install-dir/connectionServer/odbc.
2. Use un editor de XML para abrir y editar el archivo odbc.sbo.
3. Localice la sección DataBase adecuada.
El parámetro Use DataDirect OEM Driver de la sección DataBase
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.
4. Establezca el parámetro Use DataDirect OEM Driver de la sección
DataBase adecuada en Yes y guarde el archivo.
5. Agregue la siguiente ruta a la variable de entorno LD_LIBRARY_PATH:
boe-install-dir/enterprise120/platform-name/odbc/lib
6. Configure el entorno editando el archivo env.sh en boe-installdir/setup y establézcalo como el origen.
Por ejemplo:
DEFAULT_ODBCFILE="${BOBJEDIR}enterprise120/"defaul
todbc.ini
Export DEFAULT_ODBCFILE
ODBC_HOME="${BINDIR}/odbc"
Manual de acceso a los datos
89
5
5
Configurar parámetros de controlador de acceso a los datos
Configurar el acceso a datos para los controladores personalizados ODBC de DataDirect
Export ODBC_HOME
ODBCINI="${BOBJEDIR}enterprise120/"defaultodbc.ini
Export ODBCINI
Nota:
DEFAULT_ODBCFILE puede señalar a cualquier archivo que alberga los
detalles de conexión de los controladores personalizados.
7. Configure el origen de datos editando el archivo defaultodbc.ini.
Por ejemplo:
[ODBC Data Sources]
sql2005=DataDirect 5.3 SQLServer Wire Protocol Driver
[sql2005]
Driver=/.../enterprise120/sola
ris_sparc/odbc/lib/CRmsss23.so
Description=DataDirect 5.3 SQLServer Wire Protocol
Driver
Address=10.6.61.197,1433
Database=bodb01
QuotedId=Yes
AnsiNPW=No
LogonID=evalkit
QEWSD=2454745
Password=evalkit
8. Inicie el servidor de conexión desde la CMC.
El servidor de conexión puede establecer 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 odbc.sbo predeterminado.
<DataBases>
<DataBase Active="Yes" Name="MS SQL Server 2005">
<Libraries>
...
</Libraries>
<Parameter Name="Family">Microsoft</Parameter>
...
<Parameter Name="Use DataDirect OEM Driver" Plat
form="Unix">No</Parameter>
...
</DataBase>
</DataBases>
90
Manual de acceso a los datos
Referencia de parámetros
de SBO
6
6
Referencia de parámetros de SBO
Categorías de parámetros SBO
Categorías de parámetros SBO
Los parámetros de configuración de este manual se detallan agrupados en
categorías. Cada categoría representa una base de datos con su propio
archivo sbo.
•
Defaults
•
Informix
•
JavaBean
•
JDBC
•
ODBC
•
OLE DB
•
OLE DB OLAP
•
Sybase ASE/CTLIB
Cada parámetro se muestra con la información siguiente:
•
ejemplo de cómo 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
Estructura de archivos SBO
Existe un archivo <controlador>.sbo para cada nivel de red de base de
datos admitido. Cada archivo <controlador>.sbo está dividido en las
secciones siguientes:
92
Manual de acceso a los datos
Referencia de parámetros de SBO
Estructura de archivos SBO
Sección del archivo
Descripción
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 controlador de acceso a los datos. Estos parámetros
reemplazan cualquier valor correspondiente definido en el middleware de base de datos.
Manual de acceso a los datos
93
6
6
Referencia de parámetros de SBO
Estructura de archivos SBO
Sección del archivo
Descripción
Esta sección contiene una subsección para cada
middleware de base de datos compatible con el
controlador de acceso a datos. El parámetro Ac
tive especifica si está activada o no la admisión
del middleware.
Los valores son YES o NO.
Cada sección de middleware puede contener los
siguientes parámetros:
• Name: nombres del middleware admitidos por
el controlador de acceso a los datos. Los valores de nombres de middleware definidos aquí
aparecen en la página de middleware de base
de datos del Asistente de nueva conexión.
•
Aliases: nombres de versiones anteriores de
middleware que ya no son admitidas de manera oficial por el controlador de acceso a datos,
pero que aún se utilizan. Puede agregar un
parámetro de alias para una versión anterior
de middleware de modo que las conexiones
existentes utilicen el controlador actual de acceso a datos. Puede establecer parámetros de
configuración específicos para el middleware
anterior como parámetros del nuevo alias.
Puede crear conexiones nuevas utilizando el
alias.
•
Parameters: parámetros de configuración con
valores que se aplican de manera específica
a un 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.
Databases
94
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Parámetros de SBO predeterminados
Los parámetros de SBO predeterminados están definidos en el archivo
cs.cfg o en la sección Defaults del archivo SBO.
Temas relacionados
• Categorías de parámetros SBO
Array Bind disponible
<Parameter Name="Array Bind Available">True</Parameter>
Descripción
Especifica si la base de datos admite o no Array bind.
True: la base de datos admite Array bind.
Valores
False: la base de datos no admite Array bind.
Predeterminado
False
Tamaño Array Bind
<Parameter Name="Array Bind Size">5</Parameter>
Descripción
Indica el número de filas exportadas con cada comando INSERT.
Valores
Un número entero que especifica el número de filas
que se devuelven con cada INSERT.
Manual de acceso a los datos
95
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Predeterminado
El valor definido en el archivo cs.cfg.
Array Fetch Available
<Parameter Name="Array Fetch Available">True</Parameter>
Descripción
Especifica si se admite o no el método Array fetch.
True: se admite el método Array Fetch.
Valores
False: no se admite el método Array Fetch.
Predeterminado
El valor definido en el archivo cs.cfg.
Tamaño Array fetch
<Parameter Name="Array Fetch Size">10</Parameter>
Descripción
Especifica el número de filas de datos recuperadas
por cada método Array fetch. El número óptimo depende del rendimiento de su sistema:
• Si el número es bajo, el sistema devuelve pequeñas cantidades de datos muchas veces. Esto
puede afectar al rendimiento.
•
96
Manual de acceso a los datos
Si el número es alto, el sistema realiza pocas
operaciones de recuperación, pero se requiere
más memoria para cada una.
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Valores
Un número entero que especifica el número de filas
que se devuelven con cada Array fetch.
1: especifica que Array fetch está desactivado.
Predeterminado
Valor definido en el archivo cs.cfg.
Catalog Name Max Size
<Parameter Name="Catalog Name Max Size">1024</Parameter>
Descripción
Especifica el número máximo de caracteres permitido
para el nombre del catálogo de una base de datos.
Valores
Un número entero que especifica el máximo de caracteres permitido para el nombre del catálogo.
Predeterminado
El valor definido en el middleware de la base de datos.
Catalog Separator
<Parameter Name="Catalog Separator">-</Parameter>
Descripción
Especifica el carácter utilizado como separador entre
identificadores.
Valores
El carácter de separación requerido.
Manual de acceso a los datos
97
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Predeterminado
Si no se especifica, el servidor de conexión usa el
separador especificado en el middleware de la base
de datos.
CharSet
<Parameter Name="CharSet">UTF8</Parameter>
Descripción
Especifica el conjunto de caracteres de los datos devueltos por el middleware de la base de datos.
UTF8: UCS/Unicode Transformation Format de 8 bits
Valores
UCS2: Universal Character Set de 2 bytes
Predeterminado
Si no se especifica, el servidor de conexión usa el
separador especificado en el middleware de la base
de datos.
Column Name Max Size
<Parameter Name="Column Name Max Size">1024</Parameter>
98
Descripción
Especifica el número máximo de caracteres permitido
para el nombre de columna de una base de datos.
Valores
Un número entero que especifica el máximo de caracteres permitido para el nombre de una columna de
base de datos.
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Predeterminado
El valor definido en el middleware de la base de datos.
Connection Shareable
<Parameter Name="Connection Shareable">False</Parameter>
Nota:
No edite este parámetro.
Descripción
Especifica si la conexión puede compartirse entre diversas peticiones. Funciona conjuntamente con el
parámetro Shared Connection.
True: la conexión se puede compartir entre varios
usuarios.
Valores
False: la conexión no se puede compartir entre varios
usuarios.
Predeterminado
False
Temas relacionados
• Shared Connection
Cost Estimate Available
<Parameter Name="Cost Estimate Available">False</Parame
ter>
Manual de acceso a los datos
99
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Descripción
Especifica si el middleware de la base de datos permite realizar estimaciones de costes.
True: el middleware permite realizar estimaciones de
costes.
Valores
False: el middleware no permite realizar estimaciones
de costes.
Predeterminado
False
Description File
<Parameter Name="Description File">oracle</Parameter>
Nota:
No edite este parámetro.
Descripción
Especifica el nombre del archivo que conserva las
etiquetas de campo de entrada del asistente de conexión.
Driver Capabilities
<Parameter Name="Driver Capabilities">Procedures ,
Query</Parameter>
100
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Las funciones del controlador, es decir, si puede acceder a procedimientos almacenados y consultas
disponibles en el software de la base de datos. La
configuración de este parámetro se define por lo general mediante el Asistente de nueva conexión. Puede
incluir ambos valores en el parámetro.
Descripción
Nota:
Este parámetro debe estar configurado como Proce
dures para un controlador JavaBeans. Las funciones
de un controlador JavaBeans se definen como procedimientos almacenados si afectan a aplicaciones de
SAP BusinessObjects.
Procedures: el controlador puede acceder a los procedimientos de recuperación de datos que se hayan
definido en el software de la base de datos.
Valores
Query: el controlador puede acceder a las consultas
de recuperación definidas en el software de la base
de datos.
Predeterminado
Procedures
Escape Character
<Parameter Name="Escape Character">-</Parameter>
Descripción
Especifica el carácter que utilizar para cadenas de
escape de caracteres especiales, por ejemplo, patrones.
Valores
El carácter que utilizar como carácter de escape.
Manual de acceso a los datos
101
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Predeterminado
Si no se especifica, el servidor de conexión usa el
valor especificado en el middleware.
Extensions
<Parameter Name="Extensions"></Parameter>
Descripción
Nota:
No modifique la configuración de este parámetro.
Family
<Parameter Name="Family">Sybase</Parameter>
Nota:
No edite este parámetro.
Descripción
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 nueva conexión. El
conjunto de middleware que corresponde a la licencia
se muestra en esta página en vista de árbol.
Field Size Factor
<Parameter Name="Field Size Factor ">1</Parameter>
102
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Nota:
No modifique este valor.
Descripción
El valor utilizado para calcular el tamaño de contenido
devuelto expresado como caracteres de campo
cuando el contenido se devuelve como bytes. Se utiliza únicamente para DB2.
Force Execute
<Parameter Name="Force Execute">Never</Parameter>
Descripción
Especifica si la consulta SQL se ejecuta antes de recuperar resultados. Es compatible con:
• ODBC
• OLE
• DB
• JDBC
Never: la consulta SQL no se ejecuta nunca antes de
recuperar resultados.
Valores
Procedures: se ejecuta sólo para procedimientos almacenados.
Always: la consulta SQL se ejecuta siempre antes de
recuperar resultados.
Predeterminado
Never
Manual de acceso a los datos
103
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Identifier Case
<Parameter Name="Identifier Case">LowerCase</Parameter>
Descripción
Especifica cómo gestiona la base de datos el comportamiento de casos de identificadores simples.
LowerCase: los identificadores deben estar en minúsculas.
UpperCase: los identificadores deben estar en mayúsculas.
Valores
MixedCase: los identificadores pueden estar en mayúsculas y minúsculas.
SensitiveCase: los identificadores distinguen entre
mayúsculas y minúsculas.
Predeterminado
Si no se especifica, el servidor de conexión recupera
la información del middleware de la base de datos.
Identifier Quote String
<Parameter Name="Identifier Quote String">-</Parameter>
104
Descripción
Especifica el carácter utilizado para citar identificadores.
Valores
El carácter utilizado para citar identificadores.
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Predeterminado
Si no se especifica, el servidor de conexión recupera
la información del middleware de la base de datos.
Cláusula de escape LIKE
<Parameter Name="Identifier Case">True</Parameter>
Descripción
Especifica si se admite el uso de un carácter de escape en la cláusula LIKE.
True: se admite el uso de un carácter de escape en
la cláusula LIKE.
Valores
False: no se admite el uso de un carácter de escape
en la cláusula LIKE.
Predeterminado
Si no se especifica, el servidor de conexión recupera
la información del middleware de la base de datos.
Configuración regional
<Parameter Name="Locale">en_us</Parameter>
Descripción
Especifica la configuración regional del middleware.
Manual de acceso a los datos
105
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Valores
Configuración regional del middleware.
• el idioma se especifica como estándar ISO-639
• el país se especifica como estándar ISO-3166
Por ejemplo : en_US para inglés y Estados Unidos.
Predeterminado
Si no se especifica, el servidor de conexión recupera
la información del middleware de la base de datos.
Max Rows Available
<Parameter Name="Max Rows Available">True</Parameter>
Descripción
Especifica si el controlador admite la función Max
Rows para limitar el número máximo de filas que
pueden recuperarse de un origen de datos.
True: el controlador admite la función Max Rows.
Valores
False: el controlador no admite la función Max Rows.
Predeterminado
False
Optimize Execute
<Parameter Name="Optimize Execute">False</Parameter>
106
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Descripción
Especifica 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.
True: especifica la optimización de consultas SQL
durante la ejecución, si es posible.
Valores
False: las consultas SQL no se optimizan durante la
ejecución.
Predeterminado
False
Owners Available
<Parameter Name="Owners Available">True</Parameter>
Descripción
Especifica si la base de datos de destino admite Ow
ners o no.
True: la base de datos de destino admite propietarios.
Valores
Predeterminado
False: la base de datos de destino no admite propietarios.
No especificado: valor recuperado del middleware de
la base de datos.
Password Encryption
<Parameter Name="Password Encryption">True</Parameter>
Manual de acceso a los datos
107
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Descripción
Especifica si se va a utilizar el mecanismo de contraseña de cifrado especificado en el middleware 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: indica que se va a utilizar el mecanismo de
contraseña de cifrado del middleware.
Valores
False: indica que no se va a utilizar el mecanismo de
contraseña de cifrado del middleware.
Predeterminado
True
Procedure Name Max Size
<Parameter Name="Procedure Name Max Size">1024</Parame
ter>
108
Descripción
Especifica el número máximo de caracteres permitido
para un nombre de procedimiento de una base de
datos
Valores
Un número entero que especifica el máximo de caracteres permitido para el nombre del procedimiento de
base de datos.
Predeterminado
El valor definido en el middleware de la base de datos.
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Procedure Parameter Name Max Size
<Parameter Name="Procedure Parameter Name Max Si
ze">1024</Parameter>
Descripción
Especifica el número máximo de caracteres permitido
para un nombre de parámetro de procedimiento de
una base de datos
Valores
Un número entero que especifica el máximo de caracteres permitido para el nombre del parámetro de
procedimiento de base de datos.
Predeterminado
El valor definido en el middleware de la base de datos.
Qualifiers Available
<Parameter Name="Qualifiers Available">True</Parameter>
Descripción
Especifica si se admiten calificadores.
True: indica que se admiten calificadores.
Valores
False: indica que no se admiten calificadores.
Predeterminado
No especificado. El servidor de conexión recupera
esta información del middleware de la base de datos.
Manual de acceso a los datos
109
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Query TimeOut Available
<Parameter Name="Query TimeOut Available">True</Parame
ter>
Descripció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.
True: indica que el middleware de la base de datos
admite tiempo de espera de consulta.
Valores
False: indica que el middleware de la base de datos
no admite tiempo de espera de consulta.
Predeterminado
False
Quoted Identifier Case
<Parameter Name="Quoted Identifier Case Availa
ble">True</Parameter>
Descripción
110
Manual de acceso a los datos
Especifica el modo en que la base de datos gestiona
el caso de identificadores entre comillas.
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
LowerCase: los identificadores entre comillas deben
escribirse en minúsculas
UpperCase: los identificadores entre comillas deben
escribirse en mayúsculas.
Valores
MixedCase: los identificadores entre comillas pueden
incluir mayúsculas y minúsculas.
SensitiveCase: los identificadores entre comillas distinguen mayúsculas y minúsculas.
Predeterminado
No especificado. El servidor de conexión recupera la
información del middleware.
Schema Name Max Size
<Parameter Name="Schema Name Max Size">1024</Parameter>
Descripción
Especifica el número máximo de caracteres permitido
para el nombre de esquema de una base de datos.
Valores
Un número entero que especifica el máximo de caracteres permitido para el nombre del esquema.
Predeterminado
El valor definido en el middleware de la base de datos.
Shared Connection
<Parameter Name="Shared Connection">True</Parameter>
Manual de acceso a los datos
111
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Descripción
Especifica si la conexión solicitada de un conjunto de
conexiones se comparte o no. Funciona conjuntamente 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.
True: la conexión se comparte.
Valores
False: la conexión no se comparte.
Predeterminado
False
Temas relacionados
• Max Pool Time
• Connection Shareable
SQL External File
<Parameter Name="SQL External File">filename</Parameter>
Nota:
Descripción
No edite este parámetro.
El archivo SQL External contiene detalles de configuración utilizados en la capa de acceso a datos.
SQL Parameter File
<Parameter Name="SQL Parameter File">oracle</Parameter>
112
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Nombre del archivo que almacena los parámetros de
la base de datos. La extensión de este archivo es
.prm.
Descripción
Debe asegurarse de que este archivo se encuentra
ubicado en el mismo directorio que el archivo de
configuración de datos (archivo .sbo).
Valores
Ver la lista de valores del archivo SBO.
Predeterminado
Los valores enumerados.
SSO Available
<Parameter Name="SSO Available">False</Parameter>
Descripción
Indica si se admite o no el inicio de sesión único
(SSO).
True: se admite el SSO.
Valores
False: no se admite el SSO.
Predeterminado
False
Strategies File
<Parameter Name="Strategies File">oracle</Parameter>
Manual de acceso a los datos
113
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Descripción
Indica el nombre, sin extensión, del archivo de estrategias (.stg). Este archivo contiene las estrategias
externas que Universe Designer usa para la creación
automática de universos. Los archivos de estrategia
se almacenan en el mismo directorio que el archivo
.sbo.
db2 para controladores de acceso a los datos DB2.
informix para Informix.
Valores
oracle para Oracle.
sybase para Sybase.
teradata para Teradata.
Predeterminado
Consulte los valores anteriores.
Table Name Max Size
<Parameter Name="Table Name Max Size">1024</Parameter>
114
Descripción
Especifica el número máximo de caracteres permitido
para el nombre de tabla de una base de datos.
Valores
Un número entero que especifica el máximo de caracteres permitido para el nombre de la tabla.
Predeterminado
El valor definido en el middleware de la base de datos.
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Transactional Available
<Parameter Name="Transactional Available">Yes</Parameter>
Especifica si las operaciones SQL que se ejecutan
con la base de datos se gestionan en bloques o individualmente.
Descripción
Este parámetro no se lista de manera predeterminada
en el archivo SBO. Debe añadirlo al archivo .sbo si
su controlador de acceso a los datos no admite el
modo de transacción.
Yes: indica que las operaciones realizadas con respecto a la base de datos se ejecutan en bloque
cuando están validadas.
Valores
No: indica que cada sentencia SQL se valida inmediatamente. Esto significa que la opción de validación
automática está desactivada.
Nota:
No utilice un controlador con Transactional
Available=No para acceder al repositorio de SAP
BusinessObjects.
Predeterminado
Yes. Configurado en el archivo cs.cfg.
Transaction Mode
<Parameter Name="Transaction Mode">AutoCommit</Parameter>
Manual de acceso a los datos
115
6
6
Referencia de parámetros de SBO
Parámetros de SBO predeterminados
Descripción
Especifica el modo de transacción que utiliza la base
de datos.
AutoCommit: las sentencias se validan automáticamente al completarse una solicitud.
Valores
Transactional: una llamada explícita completa o anula
la sentencia al completarse una solicitud.
Predeterminado
Si no se especifica, el valor se recupera del middleware de la base de datos.
Tipo
<Parameter Name="Type">Relational</Parameter>
Indica el tipo de origen de datos.
Descripción
Nota:
Este parámetro no debe modificarse.
Versión
<Parameter Name="Version">Relational</Parameter>
Especifica la versión de la base de datos.
Descripción
116
Manual de acceso a los datos
Nota:
Este parámetro no debe modificarse.
Referencia de parámetros de SBO
Parámetros de Informix SBO
XML Max Size
<Parameter Name="XML Max Size">2048</Parameter>
Descripción
Especifica el tamaño máximo permitido para datos
XML.
Valores
El tamaño máximo permitido para XML, en bytes.
Predeterminado
Depende de la base de datos.
Parámetros de Informix SBO
Estos parámetros son aplicables al archivo Informix SBO. Se utilizan para
definir la conexión a una base de datos Informix.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\informix\informix.sbo.
Nota:
Además de los parámetros SBO, para Informix en un entorno Unix debe
modificar el archivo ODBC.INI.
Temas relacionados
• V5toV6DriverName
• Para modificar el archivo Informix ODBC.INI
Para modificar el archivo Informix ODBC.INI
Para poder usar la capa de acceso a datos con una base de datos Informix
en un entorno UNIX, debe modificar la configuración de unicode. Esta
información de configuración se puede encontrar en una de estas
ubicaciones:
Manual de acceso a los datos
117
6
6
Referencia de parámetros de SBO
Parámetros de Informix SBO
•
El archivo .odbc.ini, en su directorio de inicio.
•
El archivo especificado por la variable de entorno ODBCINI.
1. Localice el archivo ODBC.INI o el especificado por la variable de entorno
ODBCINI y ábralo en un editor de texto.
2. En el archivo, localice la sección [ODBC].
3. Añada la siguiente línea a la sección [ODBC]:
UNICODE=UTF-8
4. Guarde el archivo y ciérrelo.
Ejemplo: Sección ODBC con la configuración añadida
Este código es un ejemplo de la sección ODBC con la información correcta
añadida:
[ODBC]
UNICODE=UTF-8
V5toV6DriverName
<Parameter Name="V5toV6DriverName">{Informix 3.34 32
BIT}</Parameter>
118
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 utilizar para definir el
nombre de origen de datos (DSN) ODBC sin la cadena de conexión.
Valores
Nombre exacto del controlador Informix instalado en
el equipo.
Predeterminado
El valor definido en el archivo cs.cfg.
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de JavaBean SBO
Unicode
<Parameter Name="Unicode">CharSet</Parameter>
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
valor se aplica a todos los controladores de acceso
a los datos. No se lista de manera predeterminada
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.
UTF8: codificación UCS/Unicode Transformation
Format de 8 bits
Valores
CharSet: codificación de juego de caracteres.
UCS2: codificación Universal Character Set de 2 bytes
Predeterminado
El valor definido en el archivo cs.cfg.
Parámetros de JavaBean SBO
Estos parámetros son aplicables al archivo JavaBean SBO. Se utilizan para
definir una conexión JavaBean.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\javabean\javaean.sbo.
Manual de acceso a los datos
119
6
6
Referencia de parámetros de SBO
Parámetros de JavaBean SBO
JavaBean Class
<Parameter Name="JavaBean Class">string</Parameter>
Descripción
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
Nombre de clase JavaBean totalmente cualificado.
Predeterminado
Ninguno.
Formato de las direcciones URL
<Parameter Name="URL Format ">string</Parameter>
Especifica el formato de URL.
La especificación JDBC no indica el formato de cadena de conexión requerido. Los proveedores utilizan
diversos tipos de formato URL, por ejemplo:
• MySQL:
Descripción
jdbc:mysql://$DATASOURCE$/$DATABASE$
•
Oracle:
jdbc:oracle:thin:@$DATASOURCE$:$DATA
BASE$
120
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de JDBC SBO
Valores
Formato de URL
Predeterminado
Ninguno
Parámetros de JDBC SBO
Estos parámetros son aplicables al archivo JDBC SBO. Se utilizan para
definir una conexión JDBC.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\jdbc\jdbc.sbo.
ForeignKeys Available
<Parameter Name="ForeignKeys Available">True</Parameter>
Descripción
Especifica si se pueden obtener Fo
reignKeys.
True: se pueden obtener Foreign
Keys.
Valores
False: no se pueden obtener Foreign
Keys.
Predeterminado
True
JDBC Class
<Parameter Name="JDBC Class">string</Parameter>
Manual de acceso a los datos
121
6
6
Referencia de parámetros de SBO
Parámetros de ODBC SBO
Descripción
Valores
Clase Java totalmente cualificada del controlador
JDBC.
Depende del proveedor/origen de datos, por ejemplo:
• oracle.jdbc: OracleDriver para Oracle
•
Predeterminado
com.ibm.db2.jcc.DB2Driver: para DB2
Ninguno.
PrimaryKey Available
<Parameter Name="PrimaryKey Available">True</Parameter>
Descripción
Especifica si se pueden obtener las claves primarias.
True: se pueden obtener las claves primarias.
Valores
False: no se pueden obtener las claves primarias.
Predeterminado
True
Parámetros de ODBC SBO
Estos parámetros son aplicables al archivo ODBC SBO. Se utilizan para
definir una conexión ODBC SBO.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\odbc\odbc.sbo.
122
Manual de acceso a los datos
Referencia de parámetros de SBO
Parámetros de ODBC SBO
Connection Status Available
<Parameter Name="Connection Status Available">True</Para
meter>
Descripción
Especifica si el middleware es capaz de detectar una
conexión defectuosa.
True: el middleware puede detectar una conexión
defectuosa.
Valores
False: el middleware no puede detectar una conexión
defectuosa.
Predeterminado
El valor especificado en el middleware.
Empty String
<Parameter Name="Empty String">NullString</Parameter>
Descripción
Indica que determinadas funciones, por ejemplo, SQL
Tables, reciben una cadena vacía o un puntero nulo
para reemplazar los parámetros que faltan.
NullString: especifica que se utiliza una cadena nula.
Valores
EmptyString: especifica que se utiliza una cadena
vacía.
Predeterminado
EmptyString
Manual de acceso a los datos
123
6
6
Referencia de parámetros de SBO
Parámetros de ODBC SBO
Force Close Statement
<Parameter Name="Force Close Statement">True</Parameter>
Descripción
Indica que la sentencia SQL se cierra después de
completarse la ejecución.
True: la sentencia SQL se cierra después de ejecutarse.
Valores
False: la sentencia SQL no se cierra después ejecutarse.
Native Int64 Available
<Parameter Name="Native Int64 Available">False</Parame
ter>
Descripción
Especifica si el middleware puede gestionar directamente números enteros de 64 bits.
True: indica que el middleware puede gestionar directamente números enteros de 64 bits.
Valores
False: La capa de acceso a los datos emula los métodos Int64.
Predeterminado
124
Manual de acceso a los datos
True
Referencia de parámetros de SBO
Parámetros de ODBC SBO
ODBC Cursors
<Parameter Name="ODBC Cursors">No</Parameter>
Descripción
Especifica si el controlador de acceso a los datos
utiliza la biblioteca de cursores ODBC.
Yes: el controlador de acceso a los datos utiliza la
biblioteca de cursores ODBC.
Valores
No: el controlador de acceso a los datos no utiliza la
biblioteca de cursores ODBC.
Predeterminado
El valor definido en el archivo cs.cfg.
SQLDescribeParam Available
<Parameter Name="SQLDescribeParam Available">True</Para
meter>
Descripción
Especifica si está disponible SQLDescribeParam
Available.
True: indica que SQLDescribeParam Available está
disponible.
Valores
False: indica que SQLDescribeParam Available no
está disponible.
Predeterminado
El valor definido en el middleware de la base de datos.
Manual de acceso a los datos
125
6
6
Referencia de parámetros de SBO
Parámetros de ODBC SBO
SQLMoreResults Available
<Parameter Name="SQLMoreResults Available">True</Parame
ter>
Descripción
Especifica si se admite SQLMoreResults Available .
True: indica que se admite SQLMoreResults Available
.
Valores
False: indica que no se admiteSQLMoreResults
Available Available .
Predeterminado
El valor especificado en el middleware.
Use DataDirect OEM Driver
<Parameter Name="Use DataDirect OEM Driver">No</Parame
ter>
Descripción
Indica si las conexiones a la base de datos MS SQL
Server usan controladores DataDirect ODBC personalizados.
Yes: La conexión usa el controlador personalizado.
Valores
No: La conexión no usa el controlador personalizado.
Predeterminado
126
Manual de acceso a los datos
No
Referencia de parámetros de SBO
Parámetros de OLE DB SBO
Temas relacionados
• Configurar el acceso a datos para los controladores personalizados ODBC
de DataDirect
Parámetros de OLE DB SBO
Estos parámetros son aplicables al archivo OLE DB SBO. Se utilizan para
definir una conexión OLE DB SBO.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\oledb\oledb.sbo.
Enumerator CLSID
<Parameter Name="Enumerator CLSID">MSDASQL Enumerator</Pa
rameter>
Nota:
No edite este parámetro.
Descripción
Indica el ID de clase del enumerador OLEDB. Este
parámetro se utiliza con OLEDB únicamente.
Provider CLSID
<Parameter Name="Provider CLSID">MSDASQL</Parameter>
Nota:
No edite este parámetro.
Descripción
Indica el ID de clase del proveedor OLEDB. Este parámetro se utiliza con OLEDB únicamente.
Manual de acceso a los datos
127
6
6
Referencia de parámetros de SBO
Parámetros de OLE DB OLAP SBO
Parámetros de OLE DB OLAP SBO
Estos parámetros son aplicables al archivo OLE_DB OLAP SBO. Se usan
para definir una conexión OLE DB SBO para OLAP.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\sqlsrv_as\oledb_olap.sbo.
MSOlap CLSID
<Parameter Name="MSOlap CLSID">msolap.4</Parameter>
Nota:
No edite este parámetro.
Descripción
Indica el ID de clase del proveedor OLEDB. Este parámetro se utiliza con OLEDB OLAP únicamente.
Sybase ASE/CTLIB
Estos parámetros son aplicables al archivo Sybase ASE/CTLIB SBO. Se
utilizan para definir una conexión Sybase ASE/CTLIB.
Estos parámetros se definen en el archivo \\connectionserver-ins
tall-dir\connectionServer\sybase\sybase.sbo.
Quoted Identifier
<Parameter Name="Quoted Identifier">True</Parameter>
Descripción
128
Manual de acceso a los datos
Especifica si se admiten o no identificadores entre
comillas.
Referencia de parámetros de SBO
Sybase ASE/CTLIB
True: se admiten identificadores entre comillas.
Valores
False: no se admiten identificadores entre comillas.
Predeterminado
El valor especificado en el middleware.
Manual de acceso a los datos
129
6
6
Referencia de parámetros de SBO
Sybase ASE/CTLIB
130
Manual de acceso a los datos
Configurar parámetros de
generación de SQL
7
7
Configurar parámetros de generación de SQL
Acerca de parámetros de generación de SQL
Acerca de parámetros de generación de
SQL
Los parámetros de generación de SQL controlan las consultas SQL que se
generan para recuperar el contenido de un universo.
Puede establecer estos parámetros de generación de SQL para que
funcionen en los siguientes niveles:
• nivel de universo: estos parámetros se establecen 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 sobrescriben con cualquier configuración
de archivo PRM de nivel de universo correspondiente)
Para ver los operadores de fecha, otros operadores y las funciones
disponibles para el controlador de acceso a los datos, abra el archivo
<controlador>.prm en un editor de XML.
Acerca de los archivos PRM
Los archivos .prm contienen parámetros para controlar la forma en la que
las aplicaciones de SAP BusinessObjects generan SQL. Existe un archivo
.prm que corresponde a cada controlador de base de datos. Los archivos
.prm permiten que los factores dependientes de la base de datos controlen
cómo un Universo genera SQL, en función de la conexión y la base de datos
a la que estén vinculados.
También puede configurar algunos parámetros de generación SQL desde
el interior de un universo. La configuración que defina desde el interior de
un universo reemplazará la configuración del archivo .prm.
El archivo .prm de cada controlador se encuentra en el directorio connec
tionserver-install-dir\connectionServer\<RDBMS>, donde
<RDBMS> es el nombre de la base de datos.
Están disponibles los siguientes archivos <controlador>.prm:
132
Manual de acceso a los datos
Configurar parámetros de generación de SQL
Acerca de los archivos PRM
Controlador de acceso
Archivos PRM
a los datos
Archivos de texto ayuda de PRM (inglés)
Datafederator
datafederator.prm
datafederato
ren.prm
Essbase
essbase.prm
essbaseen.prm
HSQLDB
hsqldn.prm
hsqldben.prm
db2udb.prm
db2udben.prm
db2mvs.prm
db2mvsen.prm
db2iseries.prm
db2iseriesen.prm
Informix
informix.prm
informixen.prm
Javabean
javabean.prm
javabeanen.prm
JDBC
jdbc.prm
jdbcen.prm
IBM DB2
sqlsrv7.prm para
SQL Server 7 y 2000.
Microsoft SQL Server
sqlsrv.prm para SQL sqlsrv7en.prm
Server 2005.
sqlsrven.prm
sqlsrv_as.rm
para Analysis Services.
Microsoft Jet
msjet.prm
msjeten.prm
Manual de acceso a los datos
133
7
7
Configurar parámetros de generación de SQL
Acerca de los archivos PRM
Controlador de acceso
Archivos PRM
a los datos
Archivos de texto ayuda de PRM (inglés)
MySQL
mysql.prm
mysqlen.prm
Neoview
neoview.prm
neoviewen.prm
Netezza
netezza.prm
netezzaen.prm
odbc.prm
odbcen.prm
access.prm
accessen.prm
Abrir
open.prm
openen.prm
Open Access
openaccess.prm
openaccessen.prm
oracle9.prm para
Oracle 9.
oracle9en.prm
ODBC
Oracle
oracle.prm para Ora- oracleen.prm
cle 10 y posteriores.
134
PostgreSQL
postgresql.prm
postgresqlen.prm
Progress
progress.prm
progressen.prm
Red Brick
redbrick.prm
redbricken.prm
Manual de acceso a los datos
Configurar parámetros de generación de SQL
Acerca de los archivos PRM
Controlador de acceso
Archivos PRM
a los datos
Archivos de texto ayuda de PRM (inglés)
asiq.prm
asiqen.prm
sybase11.prm
sybase11en.prm
sybase.prm
sybaseen.prm
SAP
sap.prm
sapen.prm
Teradata
teradata.prm
teradataen.prm
Sybase
Los archivos <controlador>.prm tienen formato XML. Si es necesario ver y
modificar valores en estos archivos, deberá utilizar un editor XML.
Estructura de archivos de parámetros PRM
Existe un archivo <controlador>.prm para cada middleware de SGBDR
compatible. Cada archivo <controlador>.prm está dividido en las siguientes
secciones. Cada sección contiene parámetros que tienen valores
predeterminados definidos:
Sección del arDescripción
chivo
Configuración
Parámetros de SQL utilizados para crear y optimizar un
universo, por ejemplo, COMMA, OUTERJOINS_GENERATION, REVERSE_TABLE_WEIGHT. Estos parámetros
no están disponibles directamente para ningún producto
de SAP BusinessObjects. Se describen en este capítulo.
Manual de acceso a los datos
135
7
7
Configurar parámetros de generación de SQL
Acerca de los archivos PRM
Sección del arDescripción
chivo
Operadores de fecha disponibles para Universe Designer,
SAP BusinessObjects Desktop Intelligence y SAP BusiDateOperations
nessObjects Web Intelligence, por ejemplo, YEAR,
QUARTER, MONTH.
Operadores
136
Operadores disponibles para Universe Designer, SAP
BusinessObjects Desktop Intelligence y SAP BusinessObjects Web Intelligence, por ejemplo, ADD, SUBSTRACT,
MULTIPLY.
Manual de acceso a los datos
Configurar parámetros de generación de SQL
Acerca de los archivos PRM
Sección del arDescripción
chivo
Funciones
Manual de acceso a los datos
137
7
7
Configurar parámetros de generación de SQL
Acerca de los archivos PRM
Sección del arDescripción
chivo
Funciones disponibles para Universe Designer, SAP BusinessObjects Desktop Intelligence y SAP BusinessObjects Web Intelligence, por ejemplo, Average, Sum, Variance.
El texto de ayuda que aparece cuando las funciones de
esta sección están seleccionadas en Universe Designer,
SAP BusinessObjects Desktop Intelligence y SAP BusinessObjects Web Intelligence se enumera en el archivo
<controlador><idioma>.prm, por ejemplo, oracleen.prm.
Este archivo se encuentra en el mismo directorio que el
archivo <controlador>.prm. Puede abrirlo para visualizar
descripciones de todas las funciones disponibles en el
archivo <controlador>.prm.
La sección Function tiene las subsecciones siguientes:
• 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: En Reporter, es el nombre que aparece en la lista
de funciones.
•
InMacro: En Reporter, si este valor es True, la función
se incluye en la lista de funciones Objetos del usuario
y si es False, no.
•
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 tendrá en cuenta.
•
138
•
Manual de acceso a los datos
Configurar parámetros de generación de SQL
Para visualizar y editar un archivo PRM
Sección del arDescripción
chivo
SQL: sintaxis SQL de la función.
Nota:
Aquí únicamente se documenta la sección Configuration. Los parámetros
de la sección de configuración se pueden editar para optimizar la ejecución
de consultas con universos con el controlador de acceso a los datos de
destino.
Temas relacionados
• Para visualizar y editar un archivo de texto de ayuda de funciones
Para visualizar y editar un archivo PRM
Puede visualizar, editar y agregar parámetros al archivo PRM de la manera
siguiente:
1. Vaya al directorio que almacena el archivo PRM del controlador de acceso
a los datos de destino. Los archivos PRM están almacenados en la
ubicación siguiente:
connectionserver-install-dir\connectionSer
ver\<rdbms>\<controlador>.prm
2.
3.
4.
5.
Abra un archivo <controlador>.prm en el editor de XML.
Despliegue las secciones como sea necesario.
Defina los valores introduciendo el valor en la etiqueta adecuada.
Guarde y cierre el archivo.
Para 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 Universe Designer se conserva en un archivo XML separado. Puede
editar y agregar texto para describir una función editando el archivo
Manual de acceso a los datos
139
7
7
Configurar parámetros de generación de SQL
Para editar el texto de ayuda de una función PRM
<controlador><idioma>.prm. Existe un archivo de texto de ayuda para cada
versión de idioma de los productos SAP BusinessObjects instalados.
El texto de ayuda aparece cuando una función que está almacenada en el
archivo PRM está seleccionada en Universe Designer:
Cuando agrega una función al archivo PRM, necesita agregar el texto de
ayuda de la nueva función al archivo <controlador><idioma>.prm apropiado.
Por ejemplo, si agrega una función al archivo oracle.prm, entonces también
deberá agregar el nombre de función y el texto de ayuda de la función al
archivo oraclees.prm si está trabajando con la versión en español de Universe
Designer.
Para editar el texto de ayuda de una
función PRM
1. Vaya al directorio que almacena el archivo de idioma PRM del controlador
de acceso a los datos de destino. Los archivos PRM de idioma están
almacenados en la ubicación siguiente:
dir-instal-connectionser
ver\connectionServer\<rdbms>\<controlador><idioma>.prm
Por ejemplo, oracleen.prm.
2. Abra un archivo <controlador><idioma>.prm en un editor XML.
3. Despliegue la sección Messages.
4. 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.
5. Para visualizar o editar el texto de ayuda de una función existente, haga
lo siguiente:
• Despliegue la sección Function.
140
•
Despliegue la sección Message de una función.
•
Edite el texto de ayuda como sea necesario.
Manual de acceso a los datos
Configurar parámetros de generación de SQL
Para editar el texto de ayuda de una función PRM
6. Guarde y cierre el archivo.
Manual de acceso a los datos
141
7
7
Configurar parámetros de generación de SQL
Para editar el texto de ayuda de una función PRM
142
Manual de acceso a los datos
Referencia de parámetros
de PRM
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Referencia de la configuración del archivo
PRM
Los parámetros de configuración de SQL se enumeran alfabéticamente.
Para visualizar funciones, operadores de fecha y otros operadores
disponibles, abra un archivo <controlador>.prm en un editor XML; cada
parámetro está definido en la etiqueta siguiente:
<Parameter Name="parámetro "> valor</Parameter>
donde parámetro es el nombre del parámetro y valor es el valor atribuido al
parámetro.
Cada parámetro se muestra con la información siguiente:
•
ejemplo de cómo 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
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.
BACK_QUOTE_SUPPORTED
<Parameter Name="BACK_QUOTE_SUPPORTED">Y</Parameter>
Descripción
144
Manual de acceso a los datos
Indica si se ponen entre comillas inversas los nombres
de tablas o columnas que contienen espacios o caracteres especiales.
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Y: pone entre comillas inversas los nombres de tablas
y columnas.
Valores
N: no inserta comillas inversas en los nombres de
tablas y columnas.
Predeterminado
Y
Resultado
Nombre de la tabla= "Mi tabla"
CASE_SENSITIVE
<Parameter Name="CASE_SENSITIVE">N</Parameter>
Descripción
Indica si la base de datos distingue entre mayúsculas
y minúsculas. Parámetro utilizado con Oracle.
Y: indica que la base de datos distingue entre mayúsculas y minúsculas.
Valores
N: indica que la base de datos no distingue entre
mayúsculas y minúsculas.
Predeterminado
N
CHECK_OWNER_STATE
<Parameter Name="CHECK_OWNER_STATE">N</Parameter>
Manual de acceso a los datos
145
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Descripción
Especifica si el SQL comprueba si la base de datos
admite la clasificación de tablas por nombre de propietario.
Y: el SQL comprueba si la base de datos admite la
clasificación de tablas por nombre de propietario.
Valores
N: el SQL no comprueba si la base de datos admite
la clasificación de tablas por nombre de propietario.
Predeterminado
Y
CHECK_QUALIFIER_STATE
<Parameter Name="CHECK_QUALIFIER_STATE">N</Parameter>
Descripción
Especifica si el SQL comprueba si la base de datos
admite la clasificación de tablas por calificador.
Y: comprueba si la base de datos admite la clasificación de tablas por calificador.
Valores
N: no comprueba si la base de datos admite la clasificación de tablas por calificador.
Predeterminado
Y
COMMA
<Parameter Name="COMMA">||' '||</Parameter>
146
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Indica el operador de concatenación de base de datos
que debe emplearse para reemplazar una coma en
aquellos objetos que tienen la sintaxis siguiente:
Descripción
Tab.Col1, Tab.Col2
El parámetro se utiliza con todos los controladores
de acceso a los datos.
||' '||
Valores
+' '+
Predeterminado
||' '||
Resultado
Tab.Col1||' '||Tab.Col2
CONCAT
<Parameter Name="CONCAT">||</Parameter>
Descripción
Especifica el operador de concatenación. El parámetro
se utiliza con todos los controladores de acceso a
datos.
||
Valores
+
Predeterminado
||
Manual de acceso a los datos
147
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
CONSTANT_SAMPLING_SUPPORTED
CONSTANT_SAMPLING_SUPPORTED
Descripción
Especifica si la base de datos admite el muestreo
aleatorio.
Yes: la base de datos admite el muestreo aleatorio.
Valores
No: la base de datos no admite el muestreo aleatorio.
Predeterminado
Yes
DATABASE_DATE_FORMAT
<Parameter Name="DATABASE_DATE_FORMAT">DD-MM-YYYY
HH24:MI:SS</Parameter>
Descripción
Sólo para Oracle. Especifica los formatos predeterminados de fecha y hora almacenados en el servidor.
Valores
'DD-MM-YYYY HH24:MI:SS'
Predeterminado
'DD-MM-YYYY HH24:MI:SS'
DATATYPE_BLOB
Name="Datatype_Blob">LONGVARCHAR</Parameter>
148
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Nota:
No edite este parámetro.
Descripción
Tipo de datos de la columna de la base de datos del
objeto BLOB. Este parámetro no se utiliza para esta
versión. Se incluye para una compatibilidad futura.
DATATYPE_DOUBLE
<Parameter Name="Datatype_Double">: el valor depende de la base
de datos.
Nota:
Descripción
No edite este parámetro.
Tipo de datos de columnas de la base datos para el
objeto Date (comando CREATE table)
DATATYPE_DTM
<Parameter Name="Datatype_Dtm">DATE</Parameter>
Nota:
Descripción
No edite este parámetro.
Tipo de datos de columnas de la base datos para el
objeto Date (comando CREATE table)
Manual de acceso a los datos
149
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
DATATYPE_INT
<Parameter Name="Datatype_Int">NUMBER</Parameter>
Nota:
Descripción
No edite este parámetro.
Tipo de datos de columnas de la base datos para el
objeto Numeric (comando CREATE table)
DATATYPE_NULL
<Parameter Name="Datatype_Null"/>
Nota:
Descripción
No edite este parámetro.
Sintaxis SQL de la base de datos para valores nulos
(comando INSERT)
DATATYPE_STRING
<Parameter Name="Datatype_String">VARCHAR2</Parameter>
Nota:
Descripción
150
Manual de acceso a los datos
No edite este parámetro.
Tipo de datos de columnas de la base datos para el
objeto Character y Long (comando CREATE table).
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
DATE_WITHOUT_QUOTE
<Parameter Name="DATE_WITHOUT_QUOTE">Y</Parameter>
Descripción
Indica compatibilidad de fechas sin comillas simples
en la sintaxis SQL.
El parámetro se utiliza con MS Access.
Y: las fechas no se ponen entre comillas simples.
Valores
N: las fechas se ponen entre comillas simples.
Predeterminado
Y
DELIMIT_IDENTIFIERS
<Parameter Name="DELIMIT_IDENTIFIERS">YES</Parameter>
Descripción
Especifica si las comillas establecidas en el parámetro
IDENTIFIER_DELIMITER se usan para abarcar los
nombres de tabla y de columna.
SÍ: se usa el delimitador especificado en IDENTIFIER_DELIMITER.
Valores
NO: no se utiliza el delimitador especificado en
IDENTIFIER_DELIMITER.
Predeterminado
YES
Manual de acceso a los datos
151
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Resultado
Table name="my_table"
EXT_JOIN
<Parameter Name="EXT_JOIN">YES</Parameter>
Especifica si se admiten combinaciones externas.
Descripción
Este parámetro se utiliza con todos los controladores
de acceso a datos.
YES : la base de datos admite combinaciones externas.
Valores
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 Universe Designer no están disponibles.
Predeterminado
YES
EXT_JOIN_INVERT
<Parameter Name="EXT_JOIN_INVERT">YES</Parameter>
Especifica el modo de mostrar un símbolo de combinación externa en una expresión de combinación.
Descripción
Este parámetro se utiliza con IBM DB2, Informix,
Oracle y Teradata.
152
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
YES: Al hacer clic en una casilla de verificación
Combinación externa en el cuadro de diálogo Editar
la combinación de Universe Designer, el símbolo de
combinación externa aparecerá en posición inversa
en una expresión de combinación.
Valores
NO: Al hacer clic en una casilla de verificación Combinación externa en el cuadro de diálogo Editar la
combinación de Universe Designer, el símbolo de
combinación externa aparecerá en el mismo lado en
que haya creado la combinación externa.
Predeterminado
YES
EXTERN_SORT_EXCLUDE_DISTINCT
<Parameter Name="EXTERN_SORT_EXCLUDE_DISTINCT">Y</Parame
ter>
Descripción
Indica si la aplicación genera o no un valor de SELECT DISTINCT cuando una consulta contiene un
valor de ORDER BY.
Y: no se genera ningún valor de SELECT DISTINCT
cuando la consulta contiene un valor de ORDER BY.
Valores
N: se genera un valor de DISTINCT cuando la consulta contiene un valor de ORDER BY.
Predeterminado
Y
Manual de acceso a los datos
153
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
GROUPBY_EXCLUDE_COMPLEX
Parameter Name="GROUPBY_EXCLUDE_COMPLEX">N</Parameter>
Descripción
Especifica si la base de datos permite introducir
fórmulas, alias o índices en las cláusulas GROUP BY.
El parámetro se utiliza con IBM DB2.
Valores
Y: indica que la base de datos no permite introducir
fórmulas, alias o índices en cláusulas GROUP BY. Si
se ejecuta una consulta que contiene objetos indicadores y objetos complejos (por ejemplo, con la función
de subcadena o el operador de concatenación), la
aplicación muestra el siguiente mensaje de error: Su
base de datos no le permite realizar
agregaciones con el objeto <nombre de
objeto>.
N: indica que la base de datos permite introducir
fórmulas, alias o índices en cláusulas GROUP BY.
Predeterminado
N
GROUPBY_WITH_ALIAS
<Parameter Name="GROUPBY_WITH_ALIAS">Y</Parameter>
Descripción
Especifica si la base de datos puede crear una cláusula GROUP BY en la sentencia SELECT.
El parámetro se utiliza con Red Brick.
154
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Valores
Y: permite crear una cláusula GROUP BY en la sentencia SELECT. Se utilizaría un alias, por ejemplo, para
reemplazar una sentencia T1.col + T2.col +...Tn.col
n .col .
N: no permite crear una cláusula GROUP BY en la
sentencia SELECT.
Predeterminado
Y
GROUPBY_WITHOUT_CONSTANT
<Parameter Name="GROUPBY_WITHOUT_CONSTANT">Y</Parameter>
Descripción
Indica si se autoriza o no al usuario la adición de objetos cuya definición SQL es una constante en una
cláusula GROUP BY. El parámetro es utilizado por
IBM DB2 y Microsoft SQL Server
Y: indica que puede agregar a la consulta cualquier
objeto de constante; sin embargo, éste no estará
presente en la cláusula GROUP BY.
Valores
N: indica que puede insertar todos los objetos de una
consulta (por ejemplo, sin funciones de agregación)
en una cláusula GROUP BY.
Predeterminado
Y
Manual de acceso a los datos
155
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
GROUPBYCOL
<Parameter Name="GROUPBYCOL">NO</Parameter>
Descripción
Especifica si una cláusula GROUP BY acepta números enteros en los nombres de columna.
YES: especifica que una cláusula GROUP BY acepta
un índice de columna de SELECT en lugar del nombre
de columna.
Valores
NO: especifica que una cláusula GROUP BY no
acepta ningún índice de columna de SELECT en lugar
del nombre de columna.
Predeterminado
NO
IDENTIFIER_DELIMITER
<Parameter Name="IDENTIFIER_DELIMITER">"</Parameter>
156
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Indica que:
•
•
Descripción
Los nombres de tablas o columnas que contienen
espacios o caracteres especiales se ponen entre
comillas si el parámetro BACK_QUOTE_SUPPORTED está activado.
los nombres de tablas o columnas independientemente de si los caracteres se ponen entre comillas sencillas si el parámetro DELIMIT_IDENTIFIERS está activado.
Para usar este parámetro, BACK_QUOTE_SUPPORTED o bien DELIMIT_IDENTIFIERS deben configurarse en SÍ. Éste es el valor predeterminado de ambos
parámetros.
": los nombres de tabla o columna que contienen espacios o caracteres especiales se ponen entre comillas dobles.
Valores
': los nombres de tabla o columna que contienen espacios o caracteres especiales se ponen entre comillas simples. Este valor únicamente se puede utilizar
con Microsoft Access.
Predeterminado
"
Resultado
Table name="Mi tabla"
IF_NULL
<Parameter Name="IF_NULL">NO</Parameter>
Manual de acceso a los datos
157
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Descripción
Especifica una función que utiliza dos parámetros. Si
el primer parámetro devuelve NULL, se utiliza el valor
del segundo parámetro.
Valores
Según la base de datos.
Predeterminado
Según la base de datos.
INTERSECT
<Parameter Name="INTERSECT">INTERSECT</Parameter>
Descripción
Indica si la base de datos admite el operador de
conjuntos INTERSECT.
INTERSECT: la base de datos admite el operador de
conjuntos INTERSECT.
Valores
Ningún valor: la base de datos no admite el operador
de conjuntos INTERSECT. En este caso, se generan
dos consultas.
Predeterminado
INTERSECT
KEY_INFO_SUPPORTED
<Parameter Name="KEY_INFO_SUPPORTED">Y</Parameter>
158
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Descripción
Valores
Indica si se pueden recuperar definiciones clave
principales y secundarias de la cuenta de bases de
datos.
Y: indica que la base de datos permite recuperar definiciones clave principales y secundarias de la
cuenta de bases de datos. Este parámetro activa
Universe Designer para mostrar las claves en la
ventana Estructura.
N : indica que la base de datos no permite recuperar
definiciones clave principales y secundarias de la
cuenta de bases de datos.
Predeterminado
Y
LEFT_OUTER
<Parameter Name="LEFT_OUTER">$(+)</Parameter>
<Parameter Name="LEFT_OUTER">$*</Parameter>
Descripción
Especifica la sintaxis de la combinación externa izquierda.
$(+) Esta sintaxis se utiliza con Oracle. $ representa
una expresión de combinación.
Valores
$* Esta sintaxis se utiliza con Sybase, MS SQL Server
y Red Brick. $ representa una expresión de combinación.
Predeterminado
Consulte los valores anteriores.
Manual de acceso a los datos
159
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
LENMAXFORCOLUMNNAME
<Parameter Name="LenMaxForColumnName">30</Parameter>
Nota:
No edite este parámetro.
Descripción
Longitud máxima del nombre de columna (de manera
predeterminada, se propone el nombre de objeto)
(comando CREATE table)
LENMAXFORTABLENAME
<Parameter Name="LenMaxForTableName">30</Parameter>
Nota:
Descripción
No edite este parámetro.
Longitud máxima del tipo de datos de la columna
VARCHAR (comando CREATE table).
LENMAXFORVARCHAR
<Parameter Name="LenMaxForVarchar">254</Parameter>
Nota:
Descripción
160
Manual de acceso a los datos
No edite este parámetro.
Longitud máxima del tipo de datos de la columna
VARCHAR (comando CREATE table).
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
MINUS
<Parameter Name="MINUS">MINUS</Parameter>
Descripción
Indica si la base de datos admite el operador de
conjuntos MINUS.
MINUS Especifica que la base de datos soporta el
operador MINUS.
Valores
EXCEPT Especifica que la base de datos soporta el
operador MINUS.
sin valor Especifica que la base de datos no soporta
el operador MINUS. En este caso, se generan dos
consultas.
Predeterminado
MINUS
NO_DISTINCT
<Parameter Name="NO_DISTINCT">Y</Parameter>
Descripción
Especifica si la base de datos admite la palabra clave
DISTINCT.
Este parámetro se utiliza con MS Access.
Manual de acceso a los datos
161
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Y: indica que la base de datos no admite la palabra
clave DISTINCT. Este comportamiento desactiva:
• La opción Valores únicos que aparece al hacer
clic en el botón Valores del Asistente para la
creación de universos.
Valores
•
La función CálculoDiferencial que aparece cuando
se crea una condición con el operando Cálculo del
Panel de consulta.
N: indica que la base de datos admite la palabra clave
DISTINCT.
Predeterminado
Y
NULL_IN_SELECT_SUPPORTED
<Parameter Name="NULL_IN_SELECT_SUPPORTED">Yes</Parame
ter>
Descripción
Especifica si la base de datos admite NULL como
columna en la sentencia SELECT.
Yes: NULL puede aparecer como columna en la
sentencia SELECT.
Valores
No: NULL no puede aparecer como columna en la
sentencia SELECT.
Yes
Predeterminado
162
Manual de acceso a los datos
No para bases de datos Teradata, DB2, Informix y
Red Brick, que no admiten el valor NULL como columna.
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
OLAP_CLAUSE
<Parameter Name="OLAP_CLAUSE">WHEN</Parameter>
Descripción
Especifica si las aplicaciones de SAP BusinessObjects
generan una cláusula WHEN o QUALIFY si una función enumerada en el parámetro RISQL_Functions
se usa en una condición. Este parámetro debe utilizarse con la cláusula GROUPBY.
WHEN: genera una cláusula WHEN si una función
enumerada en el parámetro RISQL_Functions se
emplea en una condición. Se trata del valor predeterminado para bases de datos Red Brick.
Valores
QUALIFY: genera una cláusula QUALIFY si una función enumerada en el parámetro RISQL_Functions
se emplea en una condición. Éste es el valor predeterminado para bases de datos Teradata.
Predeterminado
Consulte los valores anteriores.
OUTERJOINS_GENERATION
<Parameter Name="OUTERJOINS_GENERATION">ANSI92</Parame
ter>
Este parámetro controla el comportamiento de generación de combinación
externa predeterminado. Puede configurarlo para que
• La generación de combinación externa sea conforme a la especificación
ANSI92.
•
La generación de combinación externa sea igual que en versiones
anteriores de Universe Designer.
Manual de acceso a los datos
163
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Nota:
El parámetro OUTERJOINS_GENERATION del archivo PRM está relacionado
con el parámetro ANSI92 del universo del modo siguiente:
•
Si el parámetro OUTERJOINS_GENERATION del archivo PRM está
configurado como ANSI92 y el parámetro ANSI92 del universo está
configurado como NO, el parámetro PRM anula el parámetro de universo
y las combinaciones externas se comportan como ANSI92.
•
Si el parámetro OUTERJOINS_GENERATION del archivo PRM está
configurado como USUAL, prevalece el parámetro ANSI92 del universo
y las combinaciones externas se comportan como ANSI92 dependiendo
de si el parámetro ANSI92 del universo está configurado como YES o
como NO.
Recuerde:
El valor ANSI92 inutiliza al parámetro REVERSE_TABLE_WEIGHT para la
optimización de la generación SQL. Las combinaciones externas que
cumplen con el comportamiento ANSI92 lideran el orden de las tablas de la
orden SQL.
Especifica la sintaxis SQL de las combinaciones externas.
El valor ANSI92 genera una combinación externa en
la cláusula FROM. Otros valores generan una combinación externa en la cláusula WHERE.
Descripción
164
Manual de acceso a los datos
Cuando modifique este parámetro, deberá comprobar
las propiedades de la combinación para verificar que
la expresión de la consulta externa es válida y que
las cardinalidades son correctas. ANSI92 no admite
personalizaciones manuales de sixtaxis de combinación.
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Los valores primarios de OUTERJOINS_GENERATION
son:
• ANSI92: El comportamiento de combinación externa predeterminado cumple el estándar ANSI92
independientemente del valor del parámetro AN
SI92 de Universe Designer.
Valores
•
No: no se admiten combinaciones externas.
•
USUAL: El comportamiento de combinación externa
predeterminado es igual que en versiones anteriores de Universe Designer. Este comportamiento
se anula si el parámetro ANSI92 de Universe Designer está establecido en Yes.
Los demás valores disponibles dependerán de la base
de datos que se utilice. Los valores predeterminados
se muestran a continuación.
ANSI_92: valor predeterminado para Oracle, SQL
Server 2005 y Sybase.
DB2: valor predeterminado para IBM DB2.
FULL_ODBC: se puede utililizar con Microsoft SQL
Server
Predeterminado
INFORMIX: valor predeterminado para Informix.
INGRES: valor predeterminado para Teradata.
NO: valor predeterminado para ODBC.
USUAL: valor predeterminado para Neoview, Netezza,
Red Brick y SQL Server 2000.
Manual de acceso a los datos
165
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Ejemplos de configuración de OUTERJOINS_GENERATION
Valor = USUAL:
FROM T1, T2
WHERE T1.col1(+) = T2.col2
Valor = DB2:
FROM T2 LEFT OUTER JOIN T1
ON T1.col1 = T2.col2
Valor = ODBC:
FROM {oj T1 LEFT OUTER JOIN T2 ON T1.col1=T2.col2}
Where (T2.col3 = T3.col1)
Valor = INFORMIX
FROM T2
OUTER T1
WHERE T1.col1=T2.col2
Valor = FULL-ODBC
FROM {oj T1 RIGHT OUTER JOIN T2 ON T2.col2=T1.col1
T2 INNER JOIN 3 on T2.col3 = T3.col1}
Valor = ANSI_92:
SELECT DISTINCT
t1.col1,
t2.col2
FROM
(t1 RIGHT OUTER JOIN t2 ON (t1.col1=t2.col2) )
Usar OUTERJOINS con Oracle
El valor de OUTERJOINS_GENERATION predeterminado (ANSI92) puede
afectar al comportamiento de universos existentes sea cual sea el valor de
ANSI92 a nivel de universo.
Para definir un comportamiento de universos Oracle existentes igual al de
versiones anteriores de Universe Designer:
166
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
1. En el archivo PRM, el parámetro OUTERJOINS_GENERATION debe estar
configurado como USUAL.
2. En el archivo PRM, configure los parámetros LEFT_OUTER y RIGHT_OU
TER como $(+)
Para obtener más información acerca de los archivos PRM y los parámetros
SQL de universos de versiones anteriores de Universe Designer, consulte
el Manual de Designer.
Temas relacionados
• LEFT_OUTER
• RIGHT_OUTER
• REVERSE_TABLE_WEIGHT
• Acerca de parámetros de generación de SQL
OVER_CLAUSE
<Parameter Name="OVER_CLAUSE">Y</Parameter>
Descripción
Permite a las aplicaciones de SAP BusinessObjects
incluir funciones RISQL al generar SQL. Las funciones
RISQL admitidas en la base de datos se enumeran
en el parámetro RISQL_FUNCTIONS.
Y: Las aplicaciones pueden incluir funciones RISQL
al generar SQL.
Valores
N: Las aplicaciones no pueden incluir funciones
RISQL al generar SQL.
Predeterminado
Y
Manual de acceso a los datos
167
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
OWNER
<Parameter Name="OWNER">Y</Parameter>
Descripción
Define si la base de datos autoriza poner el encabezado de nombre de propietario a las tablas.
Y: indica que la base de datos admite el encabezado
de tablas con el nombre de propietario.
Valores
N: indica que la base de datos no admite el encabezado de tablas con el nombre de propietario.
Predeterminado
Y
PERCENT_RANK_SUPPORTED
<Parameter Name="PERCENT_RANK_SUPPORTED">Yes</Parameter>
Descripción
Especifica si la función analítica Percent Rank es
compatible con la base de datos.
Yes: la función analítica Percent Rank es compatible
con la base de datos.
Valores
No: la función analítica Percent Rank no es compatible
con la base de datos.
Predeterminado
168
Manual de acceso a los datos
Yes
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
PREFIX_SYS_TABLE
<Parameter Name="PREFIX_SYS_TABLE">RBW_</Parameter>
<Parameter Name="PREFIX_SYS_TABLE">MSys</Parameter>
Descripción
Especifica si las tablas del sistema se muestran en
Universe Designer. Este parámetro se encuentra en
los archivos access.prm y redbrick.prm.
MSys: Indica que las tablas del sistema MS Access
están ocultas en el explorador de tablas de Universe
Designer. Es el valor predeterminado para MS Access.
Valores
RBW_: Indica que las tablas del sistema Red Brick
están ocultas en el explorador de tablas de Universe
Designer. Es el valor predeterminado para Red Brick.
Ningún valor: Indica que las tablas del sistema de
base de datos se muestran en el explorador de tablas
de Universe Designer.
Predeterminado
Consulte los valores anteriores.
QUALIFIER
<Parameter Name="QUALIFIER">N</Parameter>
Descripción
Especifica si la base de datos autoriza el encabezado
de tablas con el nombre de calificador.
Manual de acceso a los datos
169
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Y: indica que la base de datos admite el encabezado
de tablas con el nombre de calificador.
Valores
N: indica que la base de datos no admite el encabezado de tablas con el nombre de calificador.
Predeterminado
Depende de SGBDR..
QUOTE_OWNER
<Parameter Name="QUOTE_OWNER">Y</Parameter>
Descripción
Valores
Indica si el nombre de propietario debe ir o no entre
comillas simples. Únicamente es utilizado por Informix.
Y: indica que los nombres de tabla llevan el encabezado del nombre de propietario con comillas simples.
En el caso de las bases de datos Informix compatibles
con ANSI es obligatorio. De lo contrario, Informix
cambia el nombre del propietario a mayúsculas.
N: indica que los nombres de tabla no llevan el encabezado del nombre de propietario con comillas simples.
Predeterminado
Y
SELECT Alias.col (< Alias> es un alias local)
Resultado
FROM 'Owner'.table.col Alias
170
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
RANK_SUPPORTED
<Parameter Name="RANK_SUPPORTED">Yes</Parameter>
Descripción
Especifica si la función analítica Rank es compatible
con la base de datos.
Yes: la función analítica Rank es compatible con la
base de datos.
Valores
No: la función analítica Rank no es compatible con la
base de datos.
Predeterminado
Yes
REFRESH_COLUMNS_TYPE
<Parameter Name="REFRESH_COLUMNS_TYPE">O</Parameter>
Descripción
Indica el modo en que se actualizan las columnas.
O: las columnas se actualizan según el nombre de
propietario. Es el valor predeterminado en Oracle.
Valores
Q: las columnas se actualizan según el nombre de
calificador. Valor predeterminado en Red Brick, Sybase, MS SQL Server y MS Access.
T: las columnas se actualizan según el nombre de
tabla.
Predeterminado
Consulte los valores anteriores.
Manual de acceso a los datos
171
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
REVERSE_TABLE_WEIGHT
<Parameter Name="REVERSE_TABLE_WEIGHT">Y</Parameter>
Especifica en qué orden se generarán las tablas. Este
parámetro se utiliza con Oracle. Este parámetro se
puede utilizar también con otras bases de datos, posiblemente con los valores Y y N invertidos.
Este parámetro no se admite para Teradata.
Descripción
Nota:
Si el parámetro OUTERJOINS_GENERATION se establece en ANSI92 o si el valor del universo ANSI92 se
establece en YES, el parámetro REVERSE_TA
BLE_WEIGHT no afectará a la optimización de la generación de SQL.
N: indica que las tablas se generan de mayor a menor
tamaño.
Valores
Y: indica que las tablas se generan de menor a mayor
tamaño.
Predeterminado
Y
Temas relacionados
• OUTERJOINS_GENERATION
RIGHT_OUTER
<Parameter Name="RIGHT_OUTER">$(+)</Parameter>
<Parameter Name="RIGHT_OUTER">*$</Parameter>
172
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Descripción
Especifica la sintaxis de la combinación externa derecha.
$(+): se utiliza con Oracle. $ representa una expresión
de combinación.
Valores
*$: se utiliza con Sybase, MS SQL Server y Red Brick.
$ representa una expresión de combinación.
Predeterminado
Consulte los valores anteriores.
RISQL_FUNCTIONS
<Parameter Name="RISQL_FUNC
TIONS">RANK,SUM,AVG,COUNT,MIN,MAX</Parameter>
Descripción
Enumera las funciones RISQL que admite la base de
datos.
Manual de acceso a los datos
173
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
•
Lista predeterminada de Oracle:
RANK,SUM,AVG,COUNT,MIN,MAX,RATIO_TO_RE
PORT,CUME_DIST,CORR,DEN
SE_RANK,FIRST_VALUE,LAST_VA
LUE,LAG,LEAD,NTILE,PERCENT_RANK,PER
CENTILE_CONT,PERCENTILE_DISC,ROW_NUM
BER,CORR,COVAR_POP,COVAR_SAMP,REGR_SLO
PE,REGR_INTER
CEPT,REGR_COUNT,REGR_R2,REGR_AVGX,REGR_AVGY,REGR_SXX,REGR_SYY,REGR_SXY,STD
DEV,STDDEV_POP,STD
DEV_SAMP,VAR_POP,VAR_SAMP,VARIANCE
•
Lista predeterminada de BM DB2:
RANK,SUM,AVG,COUNT,MIN,MAX
•
Lista predeterminada de Teradata:
CSUM,MAVG,MDIFF,MLINREG,MSUM,RANK,QUAN
TILE
•
Lista predeterminada de Red Brick: CUME,MOVIN
GAVG,MOVINGSUM,RANK,RATIOTOREPORT,TER
TILE
Valores
Predeterminado
Consulte los valores anteriores.
SEED_SAMPLING_SUPPORTED
<Parameter Name="SEED_SAMPLING_SUPPORTED">Yes</Parameter>
Descripción
174
Manual de acceso a los datos
Especifica si la función de muestreo aleatorio basada
en inicio es compatible con la base de datos.
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
Yes: indica que el muestreo basado en inicio es
compatible con la base de datos.
Valores
No: indica que el muestreo basado en inicio no es
compatible con la base de datos.
Predeterminado
No
SORT_BY_NO
<Parameter Name="SORT_BY_NO">NO</Parameter>
Descripción
Valores
Indica si los usuarios están autorizados a ordenar
columnas (representadas como objetos en el universo) que no están incluidas en la sentencia SELECT.
YES: indica que los usuarios no están autorizados a
ordenar columnas si no están incluidas en la sentencia
SELECT. Cuando el parámetro está establecido en
YES, el botón Administrar ordenaciones aparece
atenuado en el panel Consulta.
NO: indica que el usuario está autorizado a ordenar
columnas incluso si no están incluidas en la sentencia
SELECT.
Predeterminado
NO
UNICODE_PATTERN
<Parameter Name="UNICODE_PATTERN">UNISTR($)</Parameter>
Manual de acceso a los datos
175
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
SQL Server y Oracle únicamente.
Descripción
Sólo se aplica cuando el parámetro de generación de
SQL del universo, UNICODE_STRINGS, está definido
en Y. Todas las condiciones basadas en cadenas a
continuación se les da formato con este valor de cadena.
Microsoft SQL Server: N$
Predeterminado
Oracle: UNISTR($)
Ejemplo
UNICODE_PATTERN=N$
UNION
<Parameter Name="UNION">UNION</Parameter>
Descripción
Indica si la base de datos admite el operador de
conjuntos UNION.
UNION: la base de datos admite el operador de conjuntos UNION.
176
Valores
Ningún valor: la base de datos no admite el operador
de conjuntos UNION. En este caso, se generan dos
consultas.
Predeterminado
UNION
Manual de acceso a los datos
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
USER_INPUT_DATE_FORMAT
<Parameter Name="USER_INPUT_DATE_FORMAT">'dd-MM-yyyy
HH:mm:ss'</Parameter>
Descripción
Especifica los formatos predeterminados de fecha y
hora generados en la cláusula WHERE de un script
SQL.
{\d 'yyyy-mm-dd'} Es el formato de fecha predeterminado con ODBC.
'DD-MM-YYYY HH:MM:SS' Son los formatos predeterminados de fecha y hora con Oracle.
'MM/DD/YYYY' Es el formato predeterminado de fecha
con Informix.
Valores
'yyyy-mm-dd HH:mm:ss' Son los formatos predeterminados de fecha y hora con MS SQL Server y para la
mayoría de los servidores IBM DB2.
'mm/dd/yyyy hh:m:s am/pm' Son los formatos predeterminados de fecha y hora con Sybase.
'yyyy-mm-dd' Éste es el formato de fecha predeterminado con una puerta de enlace Sybase.
Nota:
Si es preciso utilizar variables de fechas y horas con
ODBC, deberá reemplazar el valor del formato de fecha
predeterminado por {\t 'hh:mm:ss'} o {\t\s 'yyyy-mm-dd
hh:mm:ss'} en el archivo odbc.sbo.
Predeterminado
Consulte los valores anteriores.
Manual de acceso a los datos
177
8
8
Referencia de parámetros de PRM
Referencia de la configuración del archivo PRM
USER_INPUT_NUMERIC_SEPARATOR
<Parameter Name="USER_INPUT_NUMERIC_SEPARATOR">.</Parame
ter>
178
Descripción
Especifica el separador decimal predeterminado utilizado en el script SQL generado.
Valores
'.'
Predeterminado
'.'
Manual de acceso a los datos
Referencia a conversión de
tipos de datos
9
9
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Conversión de tipo de datos
En este capítulo se incluyen tablas de conversión de datos para cada SGBDR
admitidos. SAP SAP BusinessObjects admite cuatro tipos de datos:
•
fecha
•
Carácter
•
número
•
Texto largo
Las tablas de conversión de datos se encuentran disponibles para los
siguientes SGBDRs:
•
IBM DB2
•
Informix
•
Microsoft SQL Server
•
Oracle
•
Red Brick
•
Sybase
•
Teradata
Nota:
Las tablas de conversión de datos para otros SGBDR admitidos estarán
disponibles en actualizaciones futuras del Manual de Acceso a los datos.
IBM DB2
La tabla siguiente enumera los tipos de datos internos IBM DB2 y sus
equivalentes en soluciones SAP BusinessObjects:
180
Tipo de datos IBM DB2
Tipo de datos de SAP BusinessObjects
CLOB
TEXTO LARGO
Manual de acceso a los datos
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Tipo de datos IBM DB2
Tipo de datos de SAP BusinessObjects
CARÁCTER
CARÁCTER
DATE
DATE
DECIMAL
NÚMERO
DOUBLE
NÚMERO
FLOAT
NÚMERO
INTEGER
NÚMERO
LONG VARCHAR
TEXTO LARGO
NUMERIC
NÚMERO
SMALLINT
NÚMERO
TIME
DATE
FECHADOR
DATE
VARCHAR
CARÁCTER
Manual de acceso a los datos
181
9
9
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Informix
La tabla siguiente enumera los tipos de datos internos Informix y los
equivalentes en soluciones SAP BusinessObjects:
182
Tipo de datos Informix
Tipo de datos de SAP BusinessObjects
CHAR
CARÁCTER
DATE
DATE
DATETIME
DATE
DECIMAL
NÚMERO
FLOAT
NÚMERO
INTEGER
NÚMERO
MONEY
NÚMERO
NCHAR
CARÁCTER
NVARCHAR
CARÁCTER
SERIAL
NÚMERO
SMALLINT
NÚMERO
Manual de acceso a los datos
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Tipo de datos Informix
Tipo de datos de SAP BusinessObjects
SMALLFLOAT
NÚMERO
TEXT
TEXTO LARGO
VARCHAR
CARÁCTER
Microsoft SQL Server
La tabla siguiente muestra una lista de los tipos de datos internos de
Microsoft SQL Server y sus equivalentes en SAP BusinessObjects.
Tipo de datos Microsoft SQL Ser- Tipo de datos de SAP BusinessObver
jects
BIT
NÚMERO
BOOLEAN
NÚMERO
CHAR
CARÁCTER
DATETIME
DATE
DECIMAL
NÚMERO
FLOAT
NÚMERO
Manual de acceso a los datos
183
9
9
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Tipo de datos Microsoft SQL Ser- Tipo de datos de SAP BusinessObver
jects
INT
NÚMERO
MONEY
NÚMERO
NUMERIC
NÚMERO
REAL
NÚMERO
SMALLDATETIME
DATE
SMALLINT
NÚMERO
SMALLMONEY
NÚMERO
TEXT
CARÁCTER
TINYINT
NÚMERO
VARCHAR
CARÁCTER
Oracle
La tabla siguiente enumera los tipos de datos internos de Oracle y sus
equivalentes en soluciones SAP BusinessObjects.
184
Manual de acceso a los datos
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Tipo de datos Oracle
Tipo de datos de SAP BusinessObjects
CHAR
CARÁCTER
CLOB
TEXTO LARGO
DATE
DATE
FLOAT
NÚMERO
INTEGER
NÚMERO
LONG
TEXTO LARGO
NÚMERO
NÚMERO
VARCHAR
CARÁCTER
VARCHAR2
CARÁCTER
Red Brick
La tabla siguiente enumera los tipos de datos internos de Red Brick y sus
equivalentes en SAP BusinessObjects.
Manual de acceso a los datos
185
9
9
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Tipo de datos Red Brick
Tipo de datos de SAP BusinessObjects
CHAR
CARÁCTER
DATE
DATE
DECIMAL
NÚMERO
FLOAT
NÚMERO
INTEGER
NÚMERO
NUMERIC
NÚMERO
SMALLINT
NÚMERO
TIME
DATE
FECHADOR
DATE
Para agregar compatibilidad con TIME y
TIMESTAMP en una cláusula WHERE
Los objetos que usan los tipos de datos TIME y TIMESTAMP no se admiten
en una cláusula WHERE para consultas ejecutadas en una base de datos
Red Brick. Puede definir las propiedades de un objeto en un universo para
que se admita el uso de TIME y TIMESTAMP en la cláusula WHERE de la
manera siguiente:
186
Manual de acceso a los datos
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Para admitir el objeto de tipo de datos TIME o TIMESTAMP en la cláusula
WHERE:
1. En Universe Designer, haga doble clic en un objeto del panel Universo.
Aparecerá el cuadro de diálogo Editar las propiedades de objeto.
2.
3.
4.
5.
Haga clic en la ficha Definición.
Seleccione Fecha del cuadro de lista desplegable Tipo.
Haga clic en la ficha Opciones avanzadas.
En el cuadro de texto Formato de la base de datos, escriba la siguiente
información:
Para...
Tipo
Admisión de TIME
HH:MM:SS
Admisión de TIMESTAMP
MM/DD/YYYY HH:MM:SS
6. Haga clic en Aceptar.
Sybase
La tabla siguiente enumera los tipos de datos internos de Sybase y sus
equivalentes en soluciones SAP BusinessObjects.
Tipo de datos Sybase
Tipo de datos de SAP BusinessObjects
BIT
NÚMERO
CHAR
CARÁCTER
Manual de acceso a los datos
187
9
9
Referencia a conversión de tipos de datos
Conversión de tipo de datos
188
Tipo de datos Sybase
Tipo de datos de SAP BusinessObjects
DATETIME
DATE
DECIMAL
NÚMERO
FLOAT
NÚMERO
INT
NÚMERO
MONEY
NÚMERO
NUMERIC
NÚMERO
REAL
NÚMERO
SMALLDATETIME
DATE
SMALLINT
NÚMERO
SMALLMONEY
NÚMERO
TINYINT
NÚMERO
VARCHAR
CARÁCTER
Manual de acceso a los datos
Referencia a conversión de tipos de datos
Conversión de tipo de datos
Teradata
La tabla siguiente enumera los tipos de datos internos de Teradata y sus
equivalentes en soluciones SAP BusinessObjects.
Tipo de datos Teradata
Tipo de datos de SAP BusinessObjects
DATE
DATE
DECIMAL
NÚMERO
FLOAT
NÚMERO
INTEGER
NÚMERO
SMALLINT
NÚMERO
BYTEINT
NÚMERO
DATETIME
DATE
VARCHAR
CARÁCTER
Manual de acceso a los datos
189
9
9
Referencia a conversión de tipos de datos
Conversión de tipo de datos
190
Manual de acceso a los datos
Más información
A
A
Más información
Recurso de información
Ubicación
Información del producto SAP
http://www.sap.com
BusinessObjects
Desplácese a http://help.sap.com/businessobjects/ y en el
panel lateral de "SAP BusinessObjects Overview" (Información general de SAP BusinessObjects), haga clic en All
Products (Todos los productos).
SAP Help Portal
Puede acceder a la documentación más actualizada sobre
todos los productos SAP BusinessObjects y su despliegue
en el SAP Help Portal. Puede descargar versiones en PDF
o bibliotecas HTML instalables.
Algunos manuales se almacenan en SAP Service Marketplace y no están disponibles desde SAP Help Portal. Estos
manuales aparecen listados en Help Portal junto con un
enlace a SAP Service Marketplace. Los clientes con un
acuerdo de mantenimiento disponen de una identificación
de usuario registrado para acceder a este sito. Para obtener
una identificación, póngase en contacto con su representante de asistencia al cliente.
http://service.sap.com/bosap-support > Documentación
•
•
SAP Service Marketplace
192
Manuales de instalación: https://service.sap.com/bosapinstguides
Notas de la versión: http://service.sap.com/releasenotes
SAP Service Marketplace almacena algunos manuales de
instalación, manuales de actualización y migración, de
despliegue, notas de las versiones y documentos de las
plataformas compatibles. Los clientes con un acuerdo de
mantenimiento disponen de una identificación de usuario
registrado para acceder a este sito. Póngase en contacto
su representante de asistencia al cliente para obtener una
identificación. Si se le redirige a SAP Service Marketplace
desde SAP Help Portal, utilice el menú del panel de navegación situado a la izquierda para localizar la categoría
que contiene la documentación a la que desea acceder.
Manual de acceso a los datos
Más información
Recurso de información
Ubicación
https://cw.sdn.sap.com/cw/community/docupedia
Docupedia
Docupedia proporciona más recursos de documentación,
un entorno de creación colaborador y un canal de intercambio de información interactivo.
https://boc.sdn.sap.com/
Recursos del desarrollador
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
Artículos de SAP BusinessOb- https://www.sdn.sap.com/irj/boc/businessobjects-articles
jects en SAP Community Net- Estos artículos se conocían antes como documentos técni
work
cos.
https://service.sap.com/notes
Notas
Foros en SAP Community
Network
Estas notas se conocían antes como artículos de Knowledge Base.
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Capacitación
Desde la formación tradicional en aulas hasta seminarios
de e-learning específicos, podemos ofrecer un paquete de
formación que se ajuste a sus necesidades y su estilo
preferido de aprendizaje.
Manual de acceso a los datos
193
A
A
Más información
Recurso de información
Ubicación
http://service.sap.com/bosap-support
Asistencia en línea al cliente
SAP Support Portal contiene información acerca de los
programas y servicios de asistencia al cliente. También
incluye vínculos a un amplio abanico de información técnica
y descargas. Los clientes con un acuerdo de mantenimiento
disponen de una identificación de usuario registrado para
acceder a este sito. Para obtener una identificación, póngase en contacto con su representante de asistencia al
cliente.
http://www.sap.com/services/bysubject/businessobjectscon
sulting
Consultoría
194
Los consultores pueden acompañarle desde la fase de
análisis inicial hasta la entrega de su proyecto de desplie
gue. Contamos con expertos en temas como bases de
datos relacionales y multidimensionales, conectividad, he
rramientas de diseño de base de datos y tecnología de in
crustación personalizada.
Manual de acceso a los datos
Índice
A
acceso a datos
archivos de nivel de controlador 18
archivos globales 17
archivos instalados 17
acceso a la base de datos
configurar 78
instalación 80
acceso a la base de datos, comprobar 40
ANSI92 SQL, sintaxis 163
archivo .PRM
lista de archivos 132
lista de referencia 144
referencia 132
archivo CFG
ActiveDataSources, sección 78
Biblioteca, sección 77
Charset List Extension 71
Config File Extension 71
DataBase, elemento 78
Description Extension 72
DriverDefaults, sección 70
editar 69
Enable Failed Load 72
Load Drivers On Startup 73
Max Pool Time 74
NetworkLayer, elemento 78
parámetros de Protocols 81
referencia de los parámetros de Settings 70
Sección Capabilities 77
sección Distribution 81
Servidor, sección 77
SQL External Extension 75
SQL Parameter Extension 75
Strategies Extension 76
archivo CFG (continúa)
Transient Object Timeout 76
ver 69
archivos de configuración
archivos SBO instalados 85
categorías de parámetros 92
ejemplo de JavaBean SBO 48
archivos PRM
BACK_QUOTE_SUPPORTED 144
CASE_SENSITIVE 145
CHECK_OWNER_STATE 145
CHECK_QUALIFIER_STATE 146
COMMA 146
CONCAT 147
DATABASE_DATE_FORMAT 148
DATATYPE_BLOB 148
DATATYPE_DOUBLE 149
DATATYPE_DTM 149
DATATYPE_INT 150
DATATYPE_NULL 150
DATATYPE_STRING 150
DATE_WITHOUT_QUOTE 151
DELIMIT_IDENTIFIERS 151
editar 139
editar texto de ayuda 140
estructura 135
EXT_JOIN 152
EXT_JOIN_INVERT 152
EXTERN_SORT_EXCLUDE_DISTINCT
153
GROUPBY_EXCLUDE_COMPLEX 154
GROUPBY_WITH_ALIAS 154
GROUPBY_WITHOUT_CONSTANT 155
GROUPBYCOL 156, 157, 162, 168, 171,
174
IDENTIFIER_DELIMITER 156
Manual de acceso a los datos
195
Índice
archivos PRM (continúa)
INTERSECT 158
KEY_INFO_SUPPORTED 158
LEFT_OUTER 159
LENMAXFORCOLUMNNAME 160
LENMAXFORTABLENAME 160
LENMAXFORVARCHAR 160
MINUS 161
NO_DISTINCT 161
OLAP_CLAUSE 163
OUTERJOINS_GENERATION 163
OVER_CLAUSE 167
OWNER 168
PREFIX_SYS_TABLE 169
QUALIFIER 169
QUOTE_OWNER 170
REFRESH_COLUMNS_TYPE 171
REVERSE_TABLE_WEIGHT 172
RIGHT_OUTER=$(+) 172
RISQL_FUNCTIONS 173
SORT_BY_NO 175
texto de ayuda de función, acerca de 139
UNICODE_PATTERN 175
UNION 176
USER_INPUT_DATE_FORMAT 177
USER_INPUT_NUMERIC_SEPARATOR
178
ver 139
Array Bind Available 95
Array Bind Size 95
Array Fetch Available 96
Asistente de nueva conexión
Data Federator, configurar para 57
ayuda
archivos PRM 139
ayuda, cscheck 27
B
BACK_QUOTE_SUPPORTED 144
bases de datos
admitidas, lista 30
196
Manual de acceso a los datos
bases de datos (continúa)
procedimientos almacenados admitidos 20
bases de datos admitidas, lista 30
Blob_Comparison 145
Boundary_Weight_Table 145
C
C++, controladores 49
capas de red
admitidas, lista 30
comprobar conectividad con middleware 38
comprobar el middleware disponible 35
seleccionar 78
Case_Sensitive 145
CASE_SENSITIVE 145
Catalog Name Max Size 97
Catalog Separator 97
CharSet 98
Charset List Extension 71
CHECK_OWNER_STATE 145
CHECK_QUALIFIER_STATE 146
Classpath
crear una conexión JavaBean 47
crear una conexión JDBC 43
Cláusula de escape LIKE 105
cliente enriquecido de Web Intelligence
configurar la clave de registro 65
crear conexiones en, acerca de 62
Column Name Max Size 98
COMMA 146
componentes de conexión 14
comprobar acceso a la base de datos 40
CONCAT 147
conexiones
Data Federator, crear 56
requisitos de creación 26
conexiones JavaBean
acerca de 47
crear 47
conexiones JDBC
acerca de 42
Índice
conexiones JDBC (continúa)
Crear 43
conexiones ODBC
acerca de 49
Config File Extension 71
Connection Shareable 99
Connection Status Available 123
controladores
comprobar disponibilidad en un equipo 36
comprobar la validación 36
DataDirect 88
controladores de acceso a los datos
acerca de 15
archivos PRM 132
archivos utilizados 18
buscar aplicaciones instaladas 31
comprobar disponibilidad en un equipo 36
comprobar la validación 36
configuración de parámetros 84
seleccionar 78
controladores Java 42
controladores personalizados 88
Cost Estimate Available 99
cs.cfg
acerca de 68
cscheck
ejecutar 28
lista de funciones 29
obtener ayuda 27
sintaxis 29
Cumulative_Object_Where 100
DataDirect 88
DATATYPE_BLOB 148
DATATYPE_DOUBLE 149
DATATYPE_DTM 149
DATATYPE_INT 150
DATATYPE_NULL 150
DATATYPE_STRING 150
DATE_WITHOUT_QUOTE 151
DELIMIT_IDENTIFIERS 151
Description Extension 72
Description File 100
Distribution
archivo CFG 81
Driver Capabilities 100
Driver defaults
archivo CFG 70
D
Family 102
Field Size Factor 102
Force Close Statement 124
Force Execute 103
FORCE_SORTED_LOV
parámetro del universo 148
ForeignKeys Available 121
Data Federator
configurar para conexión ODBC 60
configurar para conexión ODBC con Cliente
enriquecido de Web Intelligence 63
crear conexiones, acerca de 56
directorio de instalación 59
versión necesaria 56
DATABASE_DATE_FORMAT 148
E
EBUS 59
Empty String 123
Enable Failed Load 72
Enumerator CLSID 127
Escape Character 101
Ext_Join 152
EXT_JOIN 152
EXT_JOIN_INVERT 152
extensiones 102
EXTERN_SORT_EXCLUDE_DISTINCT 153
F
Manual de acceso a los datos
197
Índice
globales
archivos de acceso a los datos 17
GROUPBY_EXCLUDE_COMPLEX 154
GROUPBY_WITH_ALIAS 154
GROUPBY_WITHOUT_CONSTANT 155
GROUPBYCOL 156, 157, 162, 168, 171, 174
JDBC
ForeignKeys Available 121
genérico 45
JDBC Class 121
PrimaryKey Available 122
JDBC Class 121
jdbc.sbo 43
JNI, uso 77
I
K
IBM DB2
tipos de datos 180
Identifier Case 104
Identifier Quote String 104
IDENTIFIER_DELIMITER 156
Informix
modificar el archivo ODBC.ini 117
tipos de datos 182
Unicode 119
V5toV6DriverName 118
Informix, parámetros de configuración 117
inicio de sesión único 16
instalación
archivos instalados 17
controlador de acceso a los datos,
comprobar 36
Data Federator, directorio 59
instalación, directorio
ubicación 68
Intersect 158
INTERSECT 158
KEY_INFO_SUPPORTED 158
G
J
JavaBean
JavaBean Class 120
URL Format 120
JavaBean Class 120
JavaBean SBO, ejemplo 48
JavaBean SBO, parámetros 119
198
Manual de acceso a los datos
L
Left_Outer 159
LEFT_OUTER 159
LENMAXFORCOLUMNNAME 160
LENMAXFORTABLENAME 160
LENMAXFORVARCHAR 160
Load Drivers On Startup 73
Locale 105
Lock Mode 125
LongVarcharNotSupported 125
M
Max Pool Time 74
Max Rows Available 106
Max_Inlist_Values 161
middleware
comprobar conectividad con capa de red 38
comprobar disponibilidad en un equipo 35
Minus 161
MINUS 161
modo de biblioteca 77
modo de servidor 77
MS SQL Server 88
MSOlap CLSID 128
Índice
N
Owners Available 107
Native Int64 Available 124
niveles de red soportados, lista 30
NO_DISTINCT 161
P
O
ODBC
Connection Status Available 123
DataDirect, controladores 88
Empty String 123
exponer capa de base de datos en modo
de servidor 81
Force Close Statement 124
Native Int64 Available 124
ODBC Cursors 125
ODBC2 genérico 50
ODBC3 genérico 52
SQLDescribeParam Available 125
SQLMoreResults Available 126
Use DataDirect OEM Driver 126
ODBC Cursors 125
OLAP_Clause 163
OLAP_CLAUSE 163
OLE DB
Enumerator CLSID 127
Provider CLSID 127
OLE DB OLAP
MSOlap CLSID 128
Optimize Execute 106
Oracle
ejemplo de comprobación de conectividad
40
procedimientos almacenados 21
tipos de datos 184
origen de datos JDBC genérico 45
origen de datos ODBC genérico 50
origen de datos ODBC3 genérico 52
OUTERJOINS_GENERATION 163
OVER_CLAUSE 167
OWNER 168
parámetro de SQL 112
lista de archivos PRM 144
parámetro del universo
FORCE_SORTED_LOV 148
parámetros de driver.sbo
Lock Mode 125
LongVarcharNotSupported 125
parámetros de driversp.prm
Blob_Comparison 145
Boundary_Weight_Table 145
Case_Sensitive 145
Cumulative_Object_Where 100
Ext_Join 152
Intersect 158
Left_Outer 159
Max_Inlist_Values 161
Minus 161
OLAP_Clause 163
Quote_Owner 170
Refresh_Columns_Type 171
parámetros, configuración de tipos 68
Password Encryption 107
ping, comprobar acceso a la base de datos 40
PREFIX_SYS_TABLE 169
PrimaryKey Available 122
procedimientos almacenados
acerca de 20
acerca de conexiones JavaBean 47
creación de cursores dentro de un paquete
de Oracle 22
creación de Oracle 22
limitaciones 20
Oracle 21
Teradata 23
procedimientos almacenados, limitaciones 20
Procedure Name Max Size 108
Procedure Parameter Name Max Size 109
Manual de acceso a los datos
199
Índice
Protocols
archivo CFG 81
Provider CLSID 127
Q
QUALIFIER 169
Qualifiers Available 109
Query TimeOut Available 110
Quote_Owner 170
QUOTE_OWNER 170
Quoted Identifier 128
Quoted Identifier Case 110
R
Red Brick
admisión de TIME en WHERE 186
admisión de TIMESTAMP en WHERE 186
tipos de datos 185
Refresh_Columns_Type 171
REFRESH_COLUMNS_TYPE 171
requisitos
conexiones 26
Data Federator, versión mínima 56
REVERSE_TABLE_WEIGHT 172
RIGHT_OUTER=$(+) 172
RISQL_FUNCTIONS 173
S
SBO, archivos
Array Bind Available 95
Array Bind Size 95
Array Fetch Available 96
Catalog Name Max Size 97
Catalog Separator 97
categorías de parámetros 92
CharSet 98
Cláusula de escape LIKE 105
Column Name Max Size 98
200
Manual de acceso a los datos
SBO, archivos (continúa)
configurar conexión JDBC 43
Connection Shareable 99
Connection Status Available 123
Cost Estimate Available 99
Description File 100
Driver Capabilities 100
editar 87
Empty String 123
Enumerator CLSID 127
Escape Character 101
estructura 92
extensiones 102
Family 102
Field Size Factor 102
Force Close Statement 124
Force Execute 103
ForeignKeys Available 121
Identifier Case 104
Identifier Quote String 104
instalados 85
JavaBean Class 120
JDBC Class 121
Locale 105
Max Rows Available 106
MSOlap CLSID 128
Native Int64 Available 124
ODBC Cursors 125
Optimize Execute 106
Owners Available 107
parámetro de SQL 112
parámetros de Databases 92
parámetros de Defaults 92
Password Encryption 107
PrimaryKey Available 122
Procedure Name Max Size 108
Procedure Parameter Name Max Size 109
Provider CLSID 127
Qualifiers Available 109
Query TimeOut Available 110
Quoted Identifier 128
Quoted Identifier Case 110
Índice
SBO, archivos (continúa)
Schema Name Max Size 111
Shared Connection 111
SQL External File 112
SQLDescribeParam Available 125
SQLMoreResults Available 126
SSO Available 113
Strategies File 113
Table Name Max Size 114
Tamaño Array fetch 96
Tipo 116
Transaction Available 115
Transaction Mode 115
Unicode 119
URL Format 120
Use DataDirect OEM Driver 126
V5toV6DriverName 118
ver 87
Versión 116
XML Max Size 117
Schema Name Max Size 111
servidor de conexión
conexión de ODBC con Data Federator,
configurar 61
configurar acceso a datos para
controladores personalizados DataDirect
89
configurar para conexión de Web
Intelligence con Data Federator 64
configurar para conexión JDBC con Data
Federator 59
configurar para conexión ODBC con
Universe Designer y el Cliente
enriquecido de Web Intelligence 65
crear conexiones de JDBC genérico 45
crear conexiones de ODBC genérico 50
crear conexiones de ODBC3 genérico 52
crear conexiones JDBC 43
crear una conexión JavaBean 47
definición 14
depurar al inicio 77
despliegue complejo, configurar para 78
servidor de conexión (continúa)
elegir el modo de despliegue 77
en modo de servidor independiente 81
modo de despliegue, configurar 77
parámetros globales, acerca de 68
parámetros globales, configurar 70
parámetros predeterminados de controlador,
configurar 70
Shared Connection 111
sistema, arquitectura 15
SORT_BY_NO 175
SQL External Extension 75
SQL External File 112
SQL Parameter Extension 75
SQL Server
tipos de datos 183
SQLDescribeParam Available 125
SQLMoreResults Available 126
SSO 16
SSO Available 113
Strategies Extension 76
Strategies File 113
Sybase
ejemplo de comprobación de conectividad
40
Quoted Identifier 128
tipos de datos 187
T
tablas de conversión 180
Table Name Max Size 114
Tamaño Array fetch 96
Teradata
procedimientos almacenados 23
tipos de datos 189
Tipo 116
tipos de datos
IBM DB2 180
Informix 182
Oracle 184
Red Brick 185
Manual de acceso a los datos
201
Índice
tipos de datos (continúa)
SQL Server 183
Sybase 187
Teradata 189
Transaction Available 115
Transaction Mode 115
Transient Object Timeout 76, 77
U
Unicode 119
UNICODE_PATTERN 175
UNION 176
URL Format 120
202
Manual de acceso a los datos
Use DataDirect OEM Driver 126
USER_INPUT_DATE_FORMAT 177
USER_INPUT_NUMERIC_SEPARATOR 178
V
V5toV6DriverName 118
valores
referencia de los parámetros de CFG 70
Versión 116
X
XML Max Size 117
Descargar