Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

BellaDati can be connected to numerous Databases.

Info

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.

Tip

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

 

PostgreSQL

8 and higher

9.0-801-jdbc4

 

Microsoft SQL Server

MSSQL 2008, MSSQL 2008 R2, MSSQL 2008 Express, MS SQL Server 2012, MS SQL Server 2014 and higher

sqljdbc4.1

 

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 higher2.3.3 
Cloudera Impala
5 and higher2.5.31.1051 
Microsoft Access
allJava SE JDBC/ODBCScheduled import is not supported. Before each import, the file has to be selected again.
Sybase
alljconn4 
Teradata
11 and higherterajdbc4 
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
Note

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



Tip

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.

Note

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.*

Warning

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:

  1. Host, port, driver and database name (where applicable) are correct. Host should be an IP address or a domain name.
  2. The database server is reachable from the server running BellaDati. For BellaDati cloud, this means your database must be reachable from the internet.
  3. The database server's firewall allows incoming requests from the BellaDati server on the database port. 
  4. Database username and password are correct.


Note

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:

  1. Click table you want to query. BellaDati includes all columns by default.
  2. 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.

 

Info

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.).

Info

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
Note

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

HTML
<iframe width="560" height="315" src="https://www.youtube.com/embed/660cFs89riU" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

 

Next Steps

...

Sv translation
languageja

BellaDatiは、多数のデータベースに接続できます。

Info

特定のソリューションについては、サポートまでご相談ください。

データベースに接続

データソースに接続するページからSQL Databaseコネクターを選択してください。

サポートされているデータベース

アプリケーションの使用状況(クラウドまたはオンプレミス)に応じて、BellaDatiはこれらのSQLデータベースに接続できます。

Tip

以下に載っていないデータベースのサポートは、オンデマンドで追加できます

名称

サポートバージョン

ドライバーバージョン

ノート

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以降

5.1.13

 

PostgreSQL

8以降

9.0-801-jdbc4

 

Microsoft SQL Server

MSSQL 2008, MSSQL 2008 R2, MSSQL 2008 Express, MS SQL Server 2012, MS SQL Server 2014以降

sqljdbc4.1

 

SAP Max DB

7.3以降

7.4.4 Build 003-000-002-502

 
SAP HANA
すべて

SAP In-Memory Database JDBC Driver, 1.00.48 Build 0372847-1510

 
Hadoop Hive
Hadoop 2以降2.3.3 
Cloudera Impala
5以降2.5.31.1051 
Microsoft Access
すべてJava SE JDBC/ODBCスケジュールされたインポートはサポートされていません。各インポートの前に、ファイルを再度選択する必要があります。
Sybase
すべてjconn4 
Teradata
11以降terajdbc4 
Firebird Jaybird 2.2.7 
Custom 

 

BellaDati 2.9.6.2以降でサポートされています。

カスタム接続文字列が必要な場合、またはユーザーがアプリケーションサーバーに独自のJDBCドライバーを提供する場合に使用できます。

2つの必須フィールド:

  • driverClassName
  • connectionString

 例:

Note

BellaDatiクラウドまたはオンプレミスの統合環境によって、データベースサポートは異なります。

接続パラメーター

選択したデータベースベンダーによって、接続パラメーターが異なる場合があります。以下は最も一般的なパラメーターです。

  • host: IPアドレスまたはドメイン名
  • database: データベース名
  • password
  • user

接続パラメーターウィンドウの左下にある追加リンクをクリックして、追加のパラメーターを指定できます。以下を含めることが可能です:

  • port
  • driver: 様々なデータベースのバージョンに異なるドライバーが必要な場合、ここで適切なバージョンを選択できます(例: Oracle)。

SSHトンネル経由の接続では、以下のパラメーターを追加する必要があります:

  • port: この値を指定する必要があります
  • sshHost:「host」パラメーターを上書きします(オプション)
  • sshPort: SSHポートを指定します。デフォルト値は22です(オプション)
  • sshUser
  • sshPassword



Tip

上記の接続パラメーターは、データベースベンダーによって異なる場合があります。詳細については、データベースベンダーのドキュメントを参照するか、例についてはConnection parameters examplesをご確認ください。

Note

データベースへの接続はすぐに確認されます - 問題が発生した場合は、エラーメッセージで通知されます。ファイアウォールの設定も確認してください - BellaDatiがデータソースに接続できるかどうか。*

Warning

セキュリティ上の理由により、localhostキーワードまたはlocalhost IPアドレスを用いた直接接続は無効になっています。 hostsファイルで別名を定義してください(例: WindowsのC:\WINDOWS\system32\drivers\etc)。BellaDatiでこの別名を使用します。

トラブルシューティング

データベースに接続できない場合、以下をご確認ください:

  1. ホストポートドライバーデータベース名 (該当する場合)が正しいか。ホストはIPアドレスまたはドメイン名である必要があります。

  2. BellaDatiを実行しているサーバーからデータベースサーバーにアクセスできるか。BellaDatiクラウドの場合、データベースがインターネットからアクセスできなくてはいけません。
  3. データベースサーバーのファイアウォールが、データベースポート上のBellaDatiサーバーからの要求を許可しているかどうか。
  4. データベースのユーザー名パスワードが正しいかどうか。


Note

SQLデータベースへの接続にまだ問題がありますか? この問題のトラブルシューティングに焦点を当てた、別のページに移動してください。


データベースのクエリー

データベースを照会する方法には、2つのオプションがあります:

  • データベースディスカバリー
  • SQLクエリーウィンドウ

データベースディスカバリー

データベースディスカバリーは、データベースクエリーを指定するためのビジュアルエディターです。データベースからデータを取得するには:

  1. 検索したいをクリックします。BellaDatiにはデフォルトですべての列が含まれます。

  2. 使用可能なすべてのが選択されてインポートされます。インポートしない値をクリックします。SQLの更新ボタンをクリックし、変更に応じてSQLクエリーを更新します。すべてを選択/すべてを選択解除ボタンを使用し、列をすばやく操作します。

 

Info

BellaDatiは、適切なSQLウィンドウで対応するSQLクエリーを構築します。

SQLクエリーウィンドウ

上級ユーザーやクエリー向けに、BellaDatiはSQLクエリーウィンドウを提供しています。クエリーウィンドウを使用して、目的のSQLコマンド(結合、ストアドプロシージャなどを含むSQLクエリー)を作成します。

Info

データマッピングに進む前に、[検証]ボタンをクリックして、コマンドが正しいことを確認します。

 

ストアドプロシージャの使用

データのインポートにストアドプロシージャを使用することもできます。ストアドプロシージャの構文は以下の通りです:

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

[db]はデータベースの名前、[sp]はストアドプロシージャの名前、@BegDateおよび@EndDateはストアドプロシージャで使用されるパラメーターです。

接続の変更

以下のデータソースパラメーターは、[データセット]ページの既存のデータソース内で変更できます:

  • 接続パラメーター
  • SQLステートメント
Note

データベースからより多くの列を抽出するようにSQLクエリーを変更する場合、Get new columns関数を使用します - この関数は新しい列を追加し、以前の設定を保持します。そうしないと、追加の列はインポートされません。

2番目のオプションは、リセット関数の使用です。この関数は、以前の設定をリセットし、新しい列を追加します。この場合、新しいインポート設定をセットアップする必要があります。そうしないと、追加の列はインポートされません。

チュートリアルビデオ

HTML
<iframe width="560" height="315" src="https://www.youtube.com/embed/660cFs89riU" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

 

次に

Sv translation
languagede

BellaDati kann mit zahlreichen Datenbanken verbunden werden.

Info
Bitte konsultieren Sie den Support für bestimmte Lösungen.

Anbindung an eine Datenbank

Wählen Sie auf der Seite Datenquellenverbindungen den SQL-Datenbankkonnektor aus.

Unterstützte Datenbanken

Je nach Anwendungsnutzung (Cloud oder On-Premise) kann BellaDati eine Verbindung zu diesen SQL-Datenbanken herstellen.

Tip

Die Unterstützung für die Datenbank, die nicht im Folgenden aufgeführt ist, kann bei Bedarf hinzugefügt werden.

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 und höher

5.1.13

 

PostgreSQL

8 und höher

9.0-801-jdbc4

 

Microsoft SQL Server

MSSQL 2008, MSSQL 2008 R2, MSSQL 2008 Express, MS SQL Server 2012, MS SQL Server 2014 and higher

sqljdbc4.1

 

SAP Max DB

7.3 und höher

7.4.4 Build 003-000-002-502

 
SAP HANA
alle

SAP In-Memory Database JDBC Driver, 1.00.48 Build 0372847-1510

 
Hadoop Hive
Hadoop 2 and higher2.3.3 
Cloudera Impala
5 und höher2.5.31.1051 
Microsoft Access
alleJava SE JDBC/ODBC

Geplanter Import wird nicht unterstützt. Vor jedem Import muss die Datei erneut ausgewählt werden.

Sybase
allejconn4 
Teradata
11 und höherterajdbc4 
Firebird Jaybird 2.2.7 
Custom 

 

Unterstützt in BellaDati 2.9.6.2 und neuer.

Verwendbar, wenn eine benutzerdefinierte Verbindungszeichenfolge benötigt wird oder der Benutzer einen eigenen JDBC-Treiber für den Anwendungsserver bereitstellt.

 zwei Pflichtfelder:

  • driverClassName
  • connectionString

 Beispiel:

  • driverClassName=org.postgresql.Driver

connectionString=jdbc:postgresql://localhost:5432/belladati

Note

Die Datenbankunterstützung variiert je nach BellaDati Cloud- oder On-Premise-Integrationsumgebung.

Verbindungsparameter

Verbindungsparameter können abhängig vom ausgewählten Datenbankanbieter variieren. Die häufigsten Parameter sind die folgenden_

  • Host: IP-Adresse oder Domänenname
  • Datenbank: Datenbankname
  • Passwort
  • Nutzer

Zusätzliche Parameter können durch Klicken auf Add link im linken unteren Teil des Fensters Verbindungsparameter angegeben werden. Diese können umfassen:

  • port
  • Treiber: Wenn für verschiedene Datenbankversionen unterschiedliche Treiber benötigt werden, können Sie hier die richtige Version auswählen (z. B. Oracle).

Zusätzliche Parameter können durch Klicken auf Add link im linken unteren Teil des Fensters Verbindungsparameter angegeben werden. Diese können umfassen:

  • port: Dieser Wert muss angegeben werden
  • sshHost: Überschreibt den Parameter "host" (optional)
  • sshPort: gibt den SSH-Port an, der Standardwert ist 22 (optional)
  • sshUser
  • sshPassword

Tip

Die obigen Verbindungsparameter können je nach Datenbankanbieter variieren. Weitere Informationen finden Sie in der Dokumentation Ihres Datenbankherstellers oder in den Beispielen zu den Verbindungsparametern.

Note

Die Verbindung zur Datenbank wird sofort geprüft. Wenn ein Problem auftritt, werden Sie per Fehlermeldung informiert. Bitte überprüfen Sie auch Ihre Firewall-Einstellungen - wenn BellaDati eine Verbindung zur Datenquelle herstellen kann. *

Warning

Die direkte Verbindung mit dem localhost-Schlüsselwort oder der localhost-IP-Adresse ist aus Sicherheitsgründen deaktiviert. Bitte definieren Sie einen Alias in der hosts Datei (zB C: \ WINDOWS \ system32 \ drivers \ etc in Windows). Dann benutze Sie diesen Alias in BellaDati.

Fehlerbehebung

Wenn Sie keine Verbindung zu Ihrer Datenbank herstellen können, überprüfen Sie folgende Einstellung:

  1. Host, Port, Treiber und Datenbankname (sofern zutreffend) sind korrekt. Host sollte eine IP-Adresse oder ein Domänenname sein.
  2. Der Datenbankserver ist von dem Server aus erreichbar, auf dem BellaDati läuft. Für BellaDati Cloud bedeutet dies, dass Ihre Datenbank über das Internet erreichbar sein muss.
  3. Die Firewall des Datenbankservers erlaubt eingehende Anfragen vom BellaDati-Server am Datenbank-Port.
  4. Datenbank Benutzername und Passwort sind korrekt.


Note

Haben Sie immer noch Probleme mit der Verbindung zu Ihrer SQL-Datenbank? Bitte navigieren Sie zu einer separaten Seite, die sich auf die Fehlerbehebung dieses Problems konzentriert.

Datenbankabfrage

Es gibt zwei Möglichkeiten, die Datenbank abzufragen:

  • Datenbankermittlung
  • SQL-Abfragefenster

Datenbankermittlung

Datenbankermittlung ist ein visueller Editor zum Festlegen von Datenbankabfragen. Um Daten von Ihrer Datenbank zu erhalten:

  1. Klicken Sie auf die Tabelle, die Sie abfragen möchten. BellaDati enthält standardmäßig alle Spalten.
  2. Alle verfügbaren Spalten werden ausgewählt, um importiert zu werden. Klicken Sie auf Werte, die Sie nicht importieren möchten. Klicken Sie auf die Schaltfläche SQL aktualisieren, um die SQL-Abfrage gemäß den Änderungen zu aktualisieren. Verwenden Sie alle/aufheben, um schnell mit Spalten zu arbeiten.

 

Info

BellaDati erstellt die entsprechende SQL-Abfrage im richtigen SQL-Fenster

SQL-Abfragefenster

Für fortgeschrittene Benutzer oder Abfragen bietet BellaDati SQL Query Window an. Verwenden Sie das Abfragefenster, um die gewünschten SQL-Befehle zu erstellen (SQL-Abfrage mit Join, gespeicherten Prozeduren usw.).

Info

Klicken Sie auf die Schaltfläche "Validieren", um sicherzustellen, dass Ihr Befehl korrekt ist, bevor Sie mit der Datenzuordnung fortfahren. 

 

Gespeicherte Prozeduren verwenden

Sie können gespeicherte Prozeduren auch für den Datenimport verwenden. Gespeicherte Prozeduren sollten folgende Syntax haben:

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

Dabei ist [db] der Name der Datenbank, [sp] ist der Name der gespeicherten Prozedur, @BegDate und @EndDate sind Parameter, die von der gespeicherten Prozedur verwendet werden.

Verbindungsmodifikation

Folgende Datenquellenparameter können in der vorhandenen Datenquelle auf der Seite Dataset geändert werden:

  • Verbindungsparameter
  • SQL-Anweisung
Note

Wenn Sie die SQL-Abfrage ändern, um mehr Spalten aus der Datenbank zu extrahieren, verwenden Sie die Funktion neue Spalten abrufen. Diese Funktion fügt neue Spalten hinzu und behält frühere Einstellungen bei. Andernfalls werden die zusätzlichen Spalten nicht importiert.

Die zweite Option ist die Verwendung der Reset-Funktion. Diese Funktion setzt vorherige Einstellungen zurück und fügt neue Spalten hinzu. In diesem Fall müssen Sie neue Importeinstellungen einrichten. Andernfalls werden die zusätzlichen Spalten nicht importiert.

Tutorial video

HTML
<iframe width="560" height="315" src="https://www.youtube.com/embed/660cFs89riU" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

 

Nächste Schritte