14-10 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition
lastUpdated= valueType=
mappedColumn= MVLinkName=
specialType=
DynamicName RefVariable …
DynamicName SourceColumn
RefPhysicalColumn … SourceColumn
PicklistColumns RefPhysicalColumn …
PicklistColumns PhysicalColumn
Example PhysicalColumn name=DOLLARS
parentName=quot;Forecastquot;...quot;Forecastquot; parentId=3001:681
id=3003:685 uid=765
dataType=DOUBLE scale=0
precision=0 nullable=true
extName=TableFORECASTDOLLARS lastUpdated=2001-01-01 00:00:00
Description PhysicalColumn
14.7 Connection Pool
The connection pool element corresponds to the connection pool object in the Physical layer.
The connection pool tag includes the following attributes:
Table 14–10 Connection Pool Tag Attributes
Attribute Name Description
bulkInsertBufferSize Used for limiting the number of bytes each time data is inserted
in a database table. The value is given in kilobytes KB. transactionBoundary
Controls the batch size for an insert in a database table. unicodeDB
This attribute is typically set to true when working with columns of an explicit Unicode data type, such as NCHAR, in an
Unicode database. tempTablePrefix
The first two characters in a temporary table name. The default value is TT.
tempTableOwner Table owner name used to qualify a temporary table name in a
SQL statement, for example to create the table owner.tablename.
tempTableDatabase Database where the temporary table will be created. This
property applies only to IBM OS390, because IBM OS390 requires the database name qualifier to be part of the CREATE
TABLE statement.
Physical Elements 14-11
tempTableSpace Tablespace where the temporary table will be created. This
property applies only to IBM OS390, because IBM OS390 requires the tablespace name qualifier to be part of the CREATE
TABLE statement.
user The user name for the data source.
password The password for the data source. Note that passwords are
encrypted. timeout
The amount of time that a connection to the data source will remain open after a request completes. During this time, new
requests use this connection rather than open a new one up to the number specified for the maximum connections. The time
is reset after each completed connection request.
If you set the timeout to 0 the default, connection pooling is disabled. In other words, each connection to the data source
terminates immediately when the request completes. Any new connections either use another connection pool or open a new
connection.
maxConnDiff The maximum number of total connections allowed to this
connection pool across all users. dataSource
The data source name that is configured to access the database to which you want to connect. The data source name must
contain valid logon information for the data source. reqQualifedTableName
If set to true, indicates that this database requires fully qualified table names. The fully qualified names are based on the physical
object names in the repository. isSharedLogin
If set to true, all users whose queries use the connection pool will access the underlying database using the same user name
and password. isConcurrentQueriesInCon
nection An option that enables a single database connection to remain
open for the specified time for use by future query requests. If you do not select this option, each query sent to the database
opens a new connection.
In the Administration Tool, this option corresponds to a value of selected for Enable connection pooling in the General tab of
the Connection Pool dialog. isCloseAfterEveryRequest
If set to true, indicates that the connection pool gets closed after every query.
In the Administration Tool, this option corresponds to a value of not selected for Enable connection pooling in the General tab
of the Connection Pool dialog. isAsyncExecution
An option that indicates that the data source supports asynchronous queries.
executeOnCmd A command that is to be executed by the Oracle BI Server each
time a connection is made to the database. The command may be any command accepted by the database.
xslPath For XML data sources only. An XSLT file contains formatting
rules written according to the XSLT standard. It defines how an XML file may be transformed. Specifying the XSLT file in the
connection pool applies it to all the XML physical tables in the connection pool. Used when outputType is set to XML.
maxConn The maximum number of total connections allowed to this
connection pool for a given user.
Table 14–10 Cont. Connection Pool Tag Attributes
Attribute Name Description
14-12 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition
xmlRefreshInterval For XML data sources only. The time interval after which the
XML data source is queried again directly, rather than using results in cache.
scriptPath The connection method Search script. This option is used for
XML Server data sources. outputType
For XML data sources only. The query output format delimited, xml, or fixed.
In the Administration Tool, this option is called Query output format
in the XML tab of the Connection Pool dialog. If this option is not set, the query output format is assumed to
be a custom format, and the value for convertScriptPath is used.
gwDelim The delimiting characters for the query output format. Used
when outputType is set to delimited. xpath
An XPath expression is a simple XSLT transformation rule that fits into one line. Used when outputType is set to xml.
convertScriptPath Used when outputType is not set. The path to the .exe file to
be used to convert the query output to a custom output format such as HTML.
ignoreFirstLine If set to true, indicates that the first line of the output file is
ignored. xmlHeaderPath
The path to the header file, if any, used as a query input supplement. Used for XML Server data sources.
trailerPath The path to the trailer file, if any, used as a query input
supplement. Used for XML Server data sources. supportParams
Indicates whether the data source supports parameters. If set to false, and the database features table supports parameters,
special code executes that enables the Oracle BI Server to push filters or calculations with parameters to the database.
isolationLevel For ODBC and DB2 gateways. Sets the transaction isolation
level on each connection to the back-end database. The isolation level setting controls the default transaction locking behavior
for all statements issued by a connection. Options are as follows:
■
default uses the default transaction locking behavior of the data source.
■
readCommitted specifies that shared locks are held while the data is read to avoid dirty reads.
■
readUncommitted implements dirty read isolation level 0 locking. When this option is set, it is possible to read
uncommitted or dirty data, change values in the data, and have rows appear or disappear in the data set before the
end of the transaction.
■
repeatableRead places locks on all data that is used in a query, preventing other users from updating the data.
■
serializable places a range lock on the data set, preventing other users from updating or inserting rows
into the data set until the transaction is complete. xmlaInfo
The vendor-specific information used to connect to the multidimensional data source.
xmlaCatalog The list of catalogs available. The cube tables correspond to the
catalog you use in the connection pool.
Table 14–10 Cont. Connection Pool Tag Attributes
Attribute Name Description
Physical Elements 14-13
The connection pool tag includes the following child elements: xmlaUseSession
If set to true, causes queries go through a common session. multiThreaded
If set to true, indicates that the connection pool supports multi-threading, or in other words, that one connection pool can
support multiple queries. If this option is set to false, each query is tied to a single database connection.
type The call interface type.
appServerName The name of the ADF application server.
appServerPort The port number of the ADF application server.
appID The ADF application ID.
appEJBBean The name of the ADF application Enterprise Java Bean.
javaHostServiceName The name of the JavaHost service. The JavaHost is used as a
connector between the Oracle BI Server and data sources that use Java, such as ADF.
isSiebelJDBSecured For Siebel OM data sources only. Indicates whether the
connection between the Oracle BI Server and the Siebel data source is encrypted.
csfKey This attribute is not currently used.
isAW This attribute is not currently used.
useCert This attribute stands for Use Certificate. It is used for ADF
data sources and indicates whether to use a certificate when securing the connection.
wsServer This attribute is reserved for a future release.
wsWSDL This attribute is reserved for a future release.
Table 14–11 Connection Pool Child Elements
Element Name Description
AfterQueryString Contains a connection script that is executed after the query is
run. BeforeQueryString
Contains a connection script that is executed before the query is run.
PostConnectString Contains SQL queries executed after the connection is closed.
PreDisconnectString Contains SQL queries executed before the connection is
established. RelationalConnPool
This child element is reserved for a future release. RelationalDataFolder
This child element is reserved for a future release. SQLBypassDB
For Oracle ADF data sources only. References the SQL Bypass database, if one has been specified.
The SQL Bypass feature directly queries the database so that aggregations and other transformations are pushed down
where possible, reducing the amount of data streamed and worked on in Oracle Business Intelligence.
The database object is contained in a sub-element called RefDatabase.
Table 14–10 Cont. Connection Pool Tag Attributes
Attribute Name Description
