Application Service Guide > Data Integration Service Applications > SQL Data Services
  

SQL Data Services

The Applications view displays SQL data services included in applications that have been deployed to a Data Integration Service. You can view objects in the SQL data service and configure properties that the Data Integration Service uses to run the SQL data service. You can enable and rename an SQL data service.

SQL Data Service Properties

SQL data service properties include read-only general properties and properties to configure the settings the Data Integration Service uses when it runs the SQL data service.
When you expand an SQL data service in the top panel of the Applications view, you can access the following objects contained in an SQL data service:
The Applications view displays read-only general properties for SQL data services and the objects contained in the SQL data services. Properties that appear in the view depend on the object type.
The following table describes the read-only general properties for SQL data services, virtual tables, virtual columns, and virtual stored procedures:
Property
Description
Name
Name of the selected object. Appears for all object types.
Description
Short description of the selected object. Appears for all object types.
Type
Type of the selected object. Appears for all object types.
Location
The location of the selected object. This includes the domain and Data Integration Service name. Appears for all object types.
JDBC URL
JDBC connection string used to access the SQL data service. The SQL data service contains virtual tables that you can query. It also contains virtual stored procedures that you can run. Appears for SQL data services.
Column Type
Datatype of the virtual column. Appears for virtual columns.
The following table describes the configurable SQL data service properties:
Property
Description
Startup Type
Determines whether the SQL data service is enabled to run when the application starts or when you start the SQL data service. Enter ENABLED to allow the SQL data service to run. Enter DISABLED to prevent the SQL data service from running.
Trace Level
Level of error written to the log files. Choose one of the following message levels:
  • - OFF
  • - SEVERE
  • - WARNING
  • - INFO
  • - FINE
  • - FINEST
  • - ALL
Default is INFO.
Connection Timeout
Maximum number of milliseconds to wait for a connection to the SQL data service. Default is 3,600,000.
Request Timeout
Maximum number of milliseconds for an SQL request to wait for an SQL data service response. Default is 3,600,000.
Sort Order
Sort order that the Data Integration Service uses for sorting and comparing data when running in Unicode mode. You can choose the sort order based on your code page. When the Data Integration runs in ASCII mode, it ignores the sort order value and uses a binary sort order. Default is binary.
Maximum Active Connections
Maximum number of active connections to the SQL data service.
Result Set Cache Expiration Period
The number of milliseconds that the result set cache is available for use. If set to -1, the cache never expires. If set to 0, result set caching is disabled. Changes to the expiration period do not apply to existing caches. If you want all caches to use the same expiration period, purge the result set cache after you change the expiration period. Default is 0.
DTM Keep Alive Time
Number of milliseconds that the DTM instance stays open after it completes the last request. Identical SQL queries can reuse the open instance. Use the keep alive time to increase performance when the time required to process the SQL query is small compared to the initialization time for the DTM instance. If the query fails, the DTM instance terminates.
Must be an integer. A negative integer value means that the DTM Keep Alive Time for the Data Integration Service is used. 0 means that the Data Integration Service does not keep the DTM instance in memory. Default is -1.
Optimization Level
The optimizer level that the Data Integration Service applies to the object. Enter the numeric value that is associated with the optimizer level that you want to configure. You can enter one of the following numeric values:
  • - 0. The Data Integration Service does not apply optimization.
  • - 1. The Data Integration Service applies the early projection optimization method.
  • - 2. The Data Integration Service applies the early projection, early selection, push-into, and predicate optimization methods.
  • - 3. The Data Integration Service applies the cost-based, early projection, early selection, push-into, predicate, and semi-join optimization methods.

Virtual Table Properties

Configure whether to cache virtual tables for an SQL data service and configure how often to refresh the cache. You must disable the SQL data service before configuring virtual table properties.
The following table describes the configurable virtual table properties:
Property
Description
Enable Caching
Cache the virtual table in the data object cache database.
Cache Refresh Period
Number of minutes between cache refreshes.
Cache Table Name
The name of the user-managed table from which the Data Integration Service accesses the virtual table cache. A user-managed cache table is a table in the data object cache database that you create, populate, and manually refresh when needed.
If you specify a cache table name, the Data Object Cache Manager does not manage the cache for the object and ignores the cache refresh period.
If you do not specify a cache table name, the Data Object Cache Manager manages the cache for the object.

Virtual Column Properties

Configure the properties for the virtual columns included in an SQL data service.
The following table describes the configurable virtual column properties:
Property
Description
Create Index
Enables the Data Integration Service to generate indexes for the cache table based on this column. Default is false.
Deny With
When you use column level security, this property determines whether to substitute the restricted column value or to fail the query. If you substitute the column value, you can choose to substitute the value with NULL or with a constant value.
Select one of the following options:
  • - ERROR. Fails the query and returns an error when an SQL query selects a restricted column.
  • - NULL. Returns a null value for a restricted column in each row.
  • - VALUE. Returns a constant value for a restricted column in each row.
Insufficient Permission Value
The constant that the Data Integration Service returns for a restricted column.

Virtual Stored Procedure Properties

Configure the property for the virtual stored procedures included in an SQL data service.
The following table describes the configurable virtual stored procedure property:
Property
Description
Result Set Cache Expiration Period
The number of milliseconds that the result set cache is available for use. If set to -1, the cache never expires. If set to 0, result set caching is disabled. Changes to the expiration period do not apply to existing caches. If you want all caches to use the same expiration period, purge the result set cache after you change the expiration period. Default is 0.

Enabling an SQL Data Service

Before you can start an SQL data service, the Data Integration Service must be running and the SQL data service must be enabled.
When a deployed application is enabled by default, the SQL data services in the application are also enabled.
When a deployed application is disabled by default, the SQL data services are also disabled. When you enable the application manually, you must also enable each SQL data service in the application.
    1. Select the Data Integration Service in the Navigator.
    2. In the Applications view, select the SQL data service that you want to enable.
    3. In SQL Data Service Properties area, click Edit.
    The Edit Properties dialog box appears.
    4. In the Startup Type field, select Enabled and click OK.

Renaming an SQL Data Service

Rename an SQL data service to change the name of the SQL data service. You can rename an SQL data service when the SQL data service is not running.
    1. Select the Data Integration Service in the Navigator.
    2. In the Application view, select the SQL data service that you want to rename.
    3. Click Actions > Rename SQL Data Service.
    4. Enter the name and click OK.