CData Virtuality は標準JDBC ドライバーを提供し、外部のJava アプリケーションやJava ベースのツールからCData Virtuality Server にホストされている仮想データベースのデータにSQL でアクセスすることができます。このガイドでは、DbVisualizer を例にして接続プロセスを説明しますが、DBeaverやSQuirrelなど、データを操作するための同様の機能を提供する他のツールを使用することもできます。
For installation instructions for the JDBC Driver for Windows, please refer to the relevant section of the Windows installation guide.
For instructions for the JDBC Driver for SaaS, please contact the support team.
DbVisualizer
DbVisualizer はhere から無料でダウンロードできます。
Driver Manager Settings
DbVisualizer を起動し、メニューのTools → Driver Manager を開きます:
Driver Manager が開いたら、左上隅の+ ボタンをクリックし、Create a New Driver from Template ボタンを選択します:テンプレートのリストからCustom を選択し、ダブルクリックして次に進みます:
Custom は、Driver Manager のUser Drivers に追加されます:
Driver Settings タブで、 Name にCData Virtuality と入力します。Driver artifacts and jar files で、+ ボタンをクリックします。Add Files... を選択し、必要なJAR ファイルを探してアップロードします:
JDBC ドライバーファイル(datavirtuality-jdbc.jar)を選択します:
オンプレミスバージョンのドライバーのデフォルトの場所は、C:\CData_Virtuality_Suite\Drivers です。
DriverClass が正常にロードされたことを確認します。右上隅のX ボタンをクリックして、Driver Manager を閉じます。
Creating a Connection
+ Create a Database Connection をクリックし、Create a Connection をクリックするか、左側のDatabases タブにある+ ボタンをクリックします:
ドライバー名のリストからCData Virtuality を選択します:
Connection タブで、Database → Settings Format セクションに移動します。Settings Format で、Server Info をDatabase URL に変更します:
以下のステップバイステップガイドでは、Windows およびSaaS 環境の両方でJDBC を構成するための詳細な手順を説明します。
JDBC Configuration in Windows
JDBC URL Configuration for localhost Specification
以下の詳細を設定し、接続を構成します:
Database URL:jdbc:cdatavirtuality:datavirtuality@mm://localhost:31000
Database Userid:CData Virtuality Server のユーザー(例:admin)
Database Password:CData Virtuality Server のユーザーのパスワード(例:admin)
JDBC URL Configuration for Host Specification
以下の詳細を設定し、接続を構成します:
Database URL:jdbc:cdatavirtuality:datavirtuality@mm://{Host}:31000
SSL 接続の場合は、@mm の代わりに@mms を使用してください;Database Userid:CData Virtuality Server のユーザー(例:admin);
Database Password:CData Virtuality Server のユーザーのパスワード(例:admin)
ホスト名は、Preferences セクションで確認できます:
JDBC Configuration in SaaS
Specifying JDBC URLs in SaaS
以下の詳細を設定し、接続を構成します:
Driver URL:jdbc:cdatavirtuality:datavirtuality@mms://{Host}:{Port}
(例:c:datavirtuality@mms://aws-us-east-1.platform.datavirtuality.com:45026)
SSL 接続の場合は、@mm の代わりに@mms を使用してください;Database Userid:データベースのユーザー名(例:support_cdata_com);
Database Password:CData Virtuality Server のユーザーのパスワード
ホストの詳細は、Preferences セクションにあります:
Ports でJDBC が有効になっていることを確認します。
Connection Test
Connect ボタンをクリックし、CData Virtuality Server への接続を確立します。
接続が成功したことを確認します。
左側のDatabases タブに移動し、Connection 名(例:CData Virtuality)→ datavirtuality を開きます。
以下を含むいくつかのスキーマが見えるはずです:
INFORMATION_SCHEMA
mysql やpostgres などのデータソース
SYS システム
ビューほか:
Data Acquisition
サンプルデータベースのmysql スキーマを開きます。
To connect to the sample database, follow the instructions here.
TABLE → Customers を選択し、ダブルクリックします。
Customers テーブルの情報が右側に表示されます:
次に、複数のデータソースのテーブルを結合するSQL クエリを実行してみます。メニューバーでSQL Commander → New SQL Commander を選択します:
次のSQL クエリをコピーしてSQL エディタに貼り付けます。このクエリはMySQL のCustomers テーブルとPostgreSQL のOrders テーブルを結合します:
SELECT
"Customers.customerid"
,
"customerid"
.
"Customers.companyname"
,
"Customers.
"
Customers.address
", "
Customers.address
".
"
Customers.country
", "
Customers
".
"
Customers.city
", "
Customers
".
"
Customers.sector
", "
Customers.sector
".
"
Customers.industry
", "
Customers
".
"
Customers.city_id
", "
Customers.
"Customers.iso3_country_code"
,
"iso3_country_code"
.
"Orders.orderid"
,
"orderid"
.
"Orders.customerid"
AS
"Orders_customerid"
,
"Orders.
"
Orders.orderdate
", "
orderdate
".
"
Orders.cost
", "
Orders.cost
".
"
Orders.subtotal
", "
Orders.subtotal
".
"
Orders.taxes
", "
Orders.taxes
".
"
Orders.total
", "
Orders.total
".
"
Orders.uuid_group
", "
Orders.
"Orders.segment"
.
FROM
"mysql.Customers"
INNER
JOIN
"postgres.Orders"
ON
"Customers.customerid"
=
"Orders.customerid"
再生(Execute the buffer as an SQL script) ボタンをクリックしてSQL を実行します。クエリが正常に実行されると、エディタの下部にデータのプレビューが表示されます:
セッション終了後、接続名をダブルクリックして接続画面に戻ります。Disconnect ボタンをクリックして接続を終了します:
Installing Additional JDBC Drivers
Microsoft Dataverse、NetSuite、SAP ADS、SAP HANA、Sybase ASE、Sybase IQ、Teradata など、CData Virtuality インストールパッケージに含まれていないJDBC ドライバーのインストール方法については、Installing JDBC Drivers を参照してください。
JDBC connection string changed in v4.10: both jdbc:datavirtuality and jdbc:cdatavirtuality are acceptable