Database Types

Overview

Fabric supports creating a new database type based on a JDBC driver's specifications or overriding existing database types without the need for product enhancement.

Once saved, the database type appears in the Interface type dropdown list and can be selected when creating a new Interface.

How Do I Create a Database Type?

To create a new database type, do the following:

  1. Go to Project Tree > Shared Objects, right click Database Types and select New Database Type.

    image

  2. Populate the Driver's Settings:

    • Name, a unique Database type name.
    • Class Name, URL Template and Default Port (optional). Settings from the JDBC driver.
  3. Optional: Edit the Pool Properties and Fabric Properties fields.

  • Note that the Pool Properties and Fabric Properties should be modified only by advanced users. During initial setup, use the default values.
  1. Optional: Populate the Studio – Metadata settings (to be used by Fabric Studio only):
    • SQL Query for Tables List and SQL Query for Column List, with SQL queries to retrieve the lists of tables and columns from the schema.
    • SQL Query for FKs List and SQL Query for PKs List, with SQL queries to retrieve the list of foreign keys (FK) and primary keys (PK) of the tables. These keys can be used by the Auto Discovery Wizard when creating a new Logical Unit.
    • Note that if the JDBC driver does not enable access to metadata and the above settings have not been populated, you can still work with this DB and run queries on it. However the Fabric Studio's Auto Discovery Wizard, DB Query and Query Builder schemas will not work above it. The implementer must write the Root functions and all SQL queries manually.
    • Populating the above queries can be also done to customize the list of tables or columns to be returned by the schema. For example, when the schema includes many tables and only a small subset of tables is required.
    • Set Query Builder: Identifiers Case Sensitivity as either:
      • Insensitive (default).
      • SensitiveUpperCase.
      • SensitiveLowerCase.
  2. Set JDBC Connection Properties as follows:
    • Name and a Value for parameters to be used as a part of JDBC connection properties.
    • When setting the Enable Interface Override, the parameters are displayed under the Connection Properties section of the Interface window, parameter values can be updated.
    • When setting the Connection Property, the connection properties map is sent to the JDBC driver.
  3. Save the database type.

Example of JDBC Connection Properties Definition

  • Create a new MySQL2 Database type which includes the useSSL JDBC Connection Property and add it to the URL Template as shown below:
&abc=[useSSL]

image

  • Create a new Interface using the MySQL2 Database type. Note that useSSL JDBC Connection Property is added to the Interface window under Connection Properties section and the following is added to the Connection String:
abc=false

image

  • If needed, update the value of useSSL property. When updated, it is also reflected in the Connection String.

How Do I Create a Database Type from a Template?

A new database type can be created from a template to customize a built-in database type or when a new database type is very similar to an existing type.

To create a new database type from a template, do the following:

  1. Go to Project Tree > Shared Objects, right click Database Types and select New Database Type From Template and then select the DB type, for example Oracle.

  2. Edit the required properties. For example, add the following connection property for Oracle:

   oracle.jdbc.ReadTimeout=10000

image

  1. Save the database type.

When creating a database type from a template based on an existing database type (for example, Oracle) make sure to save it with the same name (Oracle) in order to override default configurations, otherwise it will be handled as a new database type.

JDBC Drivers Management

When introducing a new database type, the JDBC driver is saved under:

[Fabric Project's Directory]\[Project Name]\lib\[new database type].

Each database type is kept in a separate folder in order to avoid overlapping or conflicts with other drivers (dynamically loaded).

Note that the JDBC drivers are not part of the Fabric Deployment and must be copied to the Fabric server to the following folder prior to running the Linux server:

/home/k2view/ExternalJars/

Previous

Database Types

Overview

Fabric supports creating a new database type based on a JDBC driver's specifications or overriding existing database types without the need for product enhancement.

Once saved, the database type appears in the Interface type dropdown list and can be selected when creating a new Interface.

How Do I Create a Database Type?

To create a new database type, do the following:

  1. Go to Project Tree > Shared Objects, right click Database Types and select New Database Type.

    image

  2. Populate the Driver's Settings:

    • Name, a unique Database type name.
    • Class Name, URL Template and Default Port (optional). Settings from the JDBC driver.
  3. Optional: Edit the Pool Properties and Fabric Properties fields.

  • Note that the Pool Properties and Fabric Properties should be modified only by advanced users. During initial setup, use the default values.
  1. Optional: Populate the Studio – Metadata settings (to be used by Fabric Studio only):
    • SQL Query for Tables List and SQL Query for Column List, with SQL queries to retrieve the lists of tables and columns from the schema.
    • SQL Query for FKs List and SQL Query for PKs List, with SQL queries to retrieve the list of foreign keys (FK) and primary keys (PK) of the tables. These keys can be used by the Auto Discovery Wizard when creating a new Logical Unit.
    • Note that if the JDBC driver does not enable access to metadata and the above settings have not been populated, you can still work with this DB and run queries on it. However the Fabric Studio's Auto Discovery Wizard, DB Query and Query Builder schemas will not work above it. The implementer must write the Root functions and all SQL queries manually.
    • Populating the above queries can be also done to customize the list of tables or columns to be returned by the schema. For example, when the schema includes many tables and only a small subset of tables is required.
    • Set Query Builder: Identifiers Case Sensitivity as either:
      • Insensitive (default).
      • SensitiveUpperCase.
      • SensitiveLowerCase.
  2. Set JDBC Connection Properties as follows:
    • Name and a Value for parameters to be used as a part of JDBC connection properties.
    • When setting the Enable Interface Override, the parameters are displayed under the Connection Properties section of the Interface window, parameter values can be updated.
    • When setting the Connection Property, the connection properties map is sent to the JDBC driver.
  3. Save the database type.

Example of JDBC Connection Properties Definition

  • Create a new MySQL2 Database type which includes the useSSL JDBC Connection Property and add it to the URL Template as shown below:
&abc=[useSSL]

image

  • Create a new Interface using the MySQL2 Database type. Note that useSSL JDBC Connection Property is added to the Interface window under Connection Properties section and the following is added to the Connection String:
abc=false

image

  • If needed, update the value of useSSL property. When updated, it is also reflected in the Connection String.

How Do I Create a Database Type from a Template?

A new database type can be created from a template to customize a built-in database type or when a new database type is very similar to an existing type.

To create a new database type from a template, do the following:

  1. Go to Project Tree > Shared Objects, right click Database Types and select New Database Type From Template and then select the DB type, for example Oracle.

  2. Edit the required properties. For example, add the following connection property for Oracle:

   oracle.jdbc.ReadTimeout=10000

image

  1. Save the database type.

When creating a database type from a template based on an existing database type (for example, Oracle) make sure to save it with the same name (Oracle) in order to override default configurations, otherwise it will be handled as a new database type.

JDBC Drivers Management

When introducing a new database type, the JDBC driver is saved under:

[Fabric Project's Directory]\[Project Name]\lib\[new database type].

Each database type is kept in a separate folder in order to avoid overlapping or conflicts with other drivers (dynamically loaded).

Note that the JDBC drivers are not part of the Fabric Deployment and must be copied to the Fabric server to the following folder prior to running the Linux server:

/home/k2view/ExternalJars/

Previous