Connecting to SQL Database

BellaDati can be connected to numerous Databases.

Please consult with support particular solutions.

Connecting to Database

From Data Source Connectors page select SQL Database Connector.

Supported Databases

Depending on application usage (cloud or On-Premise) BellaDati is able to connect to these SQL databases.

Support for database not listed below can be added on-demand.

Name	Supported versions	Driver versions	Note
`Oracle`	10.1.0.5, 10.2.0.1-10.2.0.5, 11.1.0.7, 11.2.0.1 -11.2.0.4, 12.1.0.1, 12.1.0.2, 12.2.0.1	v6-11.1.0.7, v6-11.2.0.1, v6-11.2.0.2, v14-10.1.0.5, v14-10.2.0.1, v14-10.2.0.2, v14-10.2.0.3 ,v14-10.2.0.4, v14-10.2.0.5
`MySQL`	3.1.3 and higher	5.1.13	MySQL 8 is supported from BellaDati 2.9.19.2.
`PostgreSQL`	8 and higher	9.0-801-jdbc4
`Microsoft SQL Server`	MSSQL 2017, MSSQL 2018	sqljdbc6.2.2.jre7
`SAP Max DB`	7.3 and higher	7.4.4 Build 003-000-002-502
SAP HANA	all	SAP In-Memory Database JDBC Driver, 1.00.48 Build 0372847-1510
Hadoop Hive	Hadoop 2 and higher	2.3.3
Cloudera Impala	5 and higher	2.5.31.1051
Microsoft Access	all	Java SE JDBC/ODBC	Scheduled import is not supported. Before each import, the file has to be selected again.
Sybase	all	jconn4
Teradata	11 and higher	terajdbc4
Vertica	8.1 and higher	9.2.x
Firebird		Jaybird 2.2.7
Custom			Supported in BellaDati 2.9.6.2 and newer. Usable when a custom connection string is needed or user provides own JDBC driver to the application server. two mandatory fields: driverClassName connectionString Example: driverClassName=org.postgresql.Driver connectionString=jdbc:postgresql://localhost:5432/belladati

Database support varies by BellaDati Cloud or On-Premise integration environment.

Connection Parameters

Connection parameters may vary depending on the selected database vendor. Most common parameters are the following

host: IP address or domain name
database: database name
password
user

Additional parameters can be specified by clicking on Add link in bottom left part of Connection parameters window. They can include:

port
driver: If different drivers are required for various database versions, you can select the right version here (eg. Oracle).

For connection via SSH Tunnel, following parameters have to be added:

port: this value must be specified
sshHost: overrides the "host" parameter (optional)
sshPort: specifies the SSH port, default value is 22 (optional)
sshUser
sshPassword

Connection parameters above may vary according database vendor. Please, refer to your database vendor`s documentation for details or see the Connection parameters examples for examples.

Connection to the database will be checked immediately - if a problem arises, you will be informed via error message. Please also check your firewall settings - if BellaDati can connect to the data source.*

Direct connection using localhost keyword or localhost IP address is disabled due to security reasons. Please define an alias in hosts file (eg. C:\WINDOWS\system32\drivers\etc in Windows). Than use this alias in BellaDati.

Troubleshooting

If you cannot connect to your database, please verify:

Host, port, driver and database name (where applicable) are correct. Host should be an IP address or a domain name.
The database server is reachable from the server running BellaDati. For BellaDati cloud, this means your database must be reachable from the internet (use sshTunneling for security reasons)
If sshTunneling is used. Verify, that sshd on server running source database accepts ssh access using password method for IP of server running BellaDati and for IP of BellaDati import node(s).See short tutorial below
The database server's firewall allows incoming requests from the BellaDati server on the database port.
Database username and password are correct.

SSH Tunnel - data source server setup

If your data source server is using sshd to establish secure ssh tunneling follow below
Find /etc/ssh/sshd_config file
At the end of the file insert logical construct Match as below (one ip for server running belladati and other ips can be for one or more import nodes)
Save the sshd_config and reload sshd service by command (for linux)
```
systemctl restart sshd.service
 
```

Match construct

# Settings that override global settings for matching IP addresses.Match statement must be at the end of the file. Users from IP below need only password for ssh authentication not private/public keys
Match address 192.168.168.1,192.33.54.1

Still having problems with connection to your SQL database? Please navigate to separate page focused on troubleshooting of this issue.

Querying Database

There are two options how to query database:

Database Discovery
SQL Query Window

Database Discovery

Database Discovery is a visual editor for specifying database queries. To obtain data from the your database:

Click table you want to query. BellaDati includes all columns by default.
All available columns are selected to be imported. Click on values that you don't want to import. Click on button Update SQL to update sql query according to changes. Use Select all/Unselect all buttons to quickly manipulate with columns.

BellaDati will construct corresponding SQL query in the right SQL window

SQL Query Window

For advanced users or queries, BellaDati offers SQL Query Window. Use Query Window to construct desired SQL commands (SQL query with join, stored procedures, etc.).

Click validate button to make sure that your command is correct before proceeding with data mapping.

Using Stored Procedures

You can also use stored procedures for data import. Stored procedures should have syntax like following:

execute [db].[sp] 
@BegDate = '2015-07-01' 
,@EndDate = '2015-07-31'

Where [db] is the name of the database, [sp] is the name of the stored procedure, @BegDate and @EndDate are parameters used by stored procedure.

Connection Modifications

Following data source parameters can be modified within the existing data source in Data Set page:

Connection parameters
SQL statement

When changing SQL query to extract more columns from the database, use Get new columns function - this function adds new columns and preserves previous settings. Otherwise the additional columns will not be imported.

Second option is use of Reset function. This function resets previous settings and adds new columns. You need to setup new import settings in this case. Otherwise the additional columns will not be imported.

Tutorial video

Next Steps

Page tree