Declaring Data Sources

If your mashup script invokes SQL queries or statements directly, you typically refer to named datasources that have already been configured in the Business Analytics Server called implicit datasources. If needed, you can explicitly declare a <datasource> with connection information for a database directly in the mashup script. You can use several named datasources in a mashup script as well as a single, explicitly declared, default datasource.

Datasource

Advantages

Disadvantages

Configuration

Implicit

Configured in the Business Analytics Server by Business Analytics administrators.

Tip:	It is a best practice to use implicit datasources.

Single, consistent configuration.

Easily managed in clustered environments.

Credentials for database access are secure (encrypted in the Business Analytics Repository).

Supports 'hot' updates to drivers without restarting the Business Analytics Server.

Does not support dynamic connection information.

Connection and credential information is static in the Business Analytics Repository.

Explicit

Declared in the mashup script using the <datasource> element.

Can support dynamic connection information or credentials using Business Analytics attributes or input parameters to the mashup script.

Credentials and connection information is less secure, as clear text within the mashup script or defined as input parameters or Business Analytics attributes.

Configuration is in individual mashup scripts, and thus harder to manage and maintain consistency.

If datasources are named, connection information must be consistent across all mashup scripts in the Business Analytics Repository.

You must add and configure drivers in the Business Analytics Server for explicit datasources. See Configuring Datasource Drivers for instructions.