Open Database Connectivity

The ODBC provider allows access to a data source via an installed driver on the operating system regardless of the architecture of the data source.

In Sisense, it serves as a connector to data providers, such as MS Sql, MySql, Oracle, Hive and so forth.

DSN vs. Connection-String (DSN-Less)

A connection to the provider is configured by a connection-string. Microsoft windows allows you to store the connection string properties in its registry for further use. It supplies an ODBC configuration wizard and requests an identifying Data Source Name (DSN).

When you add an ODBC table in the ElastiCube Manager, the connection configuration dialog will provide you with two options:

  • DSN – choosing a data source name.
  • Connection String (DSN-Less) – typing the actual connection string

Adding a Table to the ElastiCube Manager:

  1. Click Add Data in the top menu of the ElastiCube Manager.
  2. Under the Database servers category, select Generic ODBC Driver.
  3. From the ODBC Connectivity Properties dialog choose DSN or Connection String (DSN-Less).

    • DSN: Choose one of the existing DSNs from the drop-down list (each item is represented by its name), or click Add DSN… to open the Create New Data Source window. In this window, you’ll be asked to select one of the installed ODBC drivers, select a name for the DSN, and configure your connection using the wizard steps. At the end, the newly added DSN will be added to the drop-down list as the selected item.
    • Connection String: Type the connection string in the input box. For known connection strings, click the Help link to navigate to Connection Strings (External site from Sisense). Click Test Connection to test the connection.Click OK to move to the final dialog. From the tables selection dialog, select tables that you want to add and click Add  to complete the wizard.

Note: You may need to update the executed table query.

Add ODBC

Setting the table query (Troubleshoot)

ODBC and OLE DB are generic drivers; therefore the SQL syntax being executed against the actual data source may vary from one provider to another.

Sisense sets by default the standard SQL for the ODBC/OLE DB tables which covers most of today’s known data providers. For cases where non-standard SQL must be supplied, the table addition dialog provides a quick preview of the current SQL query and an edit button that opens the Query Properties dialog.

In Query Properties, you can set the following options:

  • Auto Query Structure: Choosing the proper SQL syntax delimiter.
  • Manual Query Input: Type the desired query.

Customizing Your ODBC Connection

Though there hundreds of data sources available, the generic ODBC driver can help you connect to just about all of them. However, if the default settings do not fit your specific use-case, Sisense lets you customize your ODBC connection to give you the functionality you need.

When you add an ODBC connection to your Sisense configuration, Sisense saves the details of your connection in a file called odbcConfig.json. The odbcConfig.json is a configuration file written in JSON syntax located in the directory: …\Program Files\Sisense\DataConnectors\DotNetContainer\Connectors\GenericODBC  You can edit this file to add functionality such as support for accumulative builds, increase query timeouts, or modify your query patterns.

The odbcConfig.json file contains the following objects that you can edit to modify your connectors behavior:

NameTypeMandatoryDescription
ProviderStringYesThe name of your data source. This name must be unique.
DriverNamesStringYesAn array of ODBC driver names. If you don't know a driver name, you could check "Connectors.log".
IsAccumulativeSupportedBooleanNoIndicates whether accumulative build is supported.

Default value: false.
IsRelationsSupportedBooleanNoEnable/disables relations functionality in the ElastiCube Manager.

Default value: false.
QueryTimeoutIntegerNoQuery timeout value. You can increase this value is your datasource takes longer to establish a connection.

Default value: 0.
QuerySettingsQueryConfig*NoDatasource specific query settings (see QueryConfig Object table below).

Default value: default query config values.
ExtensionStringNoA name of the assembly with the appropriate extension.

Default value: none.

 

* The properties for the QueryConfig object are described in the table below:

QueryConfig Object

NameTypeMandatoryDescription
ColumnNamePatternStringNoPattern which represents column name format (should include appropriate separators).

To create a pattern, you can use the following keywords:.

@schema: Schema name (When schema is empty, table name will be using instead).
@table: Table name.
@column: Column name..

Example: `@schema`.`@column`.

Default value: [@column]
TableNamePatternStringNoPattern which represents table name format (should include appropriate separators).

To create a pattern, you can use the following keywords:

@schema: Schema name (When schema is empty, table name will be using instead).
@table: Table name.

Example: "@schema"."@table"

Default value: [@schema].[@table] or [@table] in the case when schema name is missing.
PreviewSqlPatternStringNoPattern which represents preview SQL format (should include appropriate SQL operators).

To create a pattern, you can use the following keywords:

@rowcount: The number of rows to show.
@sql: Inner select.

Example: SELECT * FROM (@sql) LIMIT @rowcount

Default value: SELECT TOP @rowcount x.* FROM (@sql) x
DateTimeFormatStringNoFormat used to convert DateTime value to string for an accumulative workflow.

More info about standard formats here.

More info about defining a custom format here..

Default value: sortable format specifier.