ビジネスインテリジェンスツールがJDBC プロトコルを使用する場合、CData Virtuality Server に含まれる特別なJDBC ドライバーをインストールするか、当社のWeb サーバーからダウンロードする必要があります。このマニュアルでは、その取り付け方と例を説明します。
Driver Installation
ドライバーはdatavirtuality-jdbc.jarというファイルに含まれています。CData Virtuality Suite がインストールされている場合は、..\CData Virtuality Suite\Driversにあります。インストールされていない場合は、サーバーからファイルをダウンロードできます。
ドライバーをインストールするには、ツール設定にドライバーを追加し、そのファイルパスを指定する必要があります。ドライバーファイルを別途ダウンロードした場合は、任意のフォルダ(ツールのフォルダなど)に置くことができます。
接続の設定には、ドライバークラスとJDBC URLを知っている必要があります。このドライバーのドライバー・クラスはcom.datavirtuality.dv.jdbc.Driver
で、JDBC URL はjdbc:datavirtuality:<vdb-name>@mm[s]://<host>:<port>
[;prop-name=prop-value]
のようになります。
JDBCのURLは以下のとおりです:
- 単純な接続文字列:
jdbc:datavirtuality:datavirtuality@mm://localhost:31000
- SSL接続文字列(推奨):
jdbc:datavirtuality:datavirtuality@mms://localhost:31001
URLコンポーネント:
Component | Description |
---|---|
<vdb-name> | Name of the VDB you are connecting to. Primary VDB is called |
| JDBC protocol, |
| Server where the CData Virtuality Server is installed |
| Port on which the CData Virtuality Server is listening for incoming JDBC connections. Default: |
| Optional component where you can supply any number of name-value pairs separated by semi-colon [;]. For a list of all compatible URL properties, see URL Connection Properties below. Property values should be URL encoded if they contain reserved characters, e.g. (’?’, '=', ';', etc.) |
host
and port
may be a comma-separated list to specify multiple hosts
URL Connection Properties
次の表は、CData Virtuality JDBC Driver URL 接続文字列、またはCData Virtuality JDBC Data Sources クラスで使用できるすべての接続プロパティを示しています。
Property | Type | Description |
---|---|---|
|
| Name of the client application; allows the administrator to identify the connections |
|
| Size of the resultset. Default: |
|
| Enable/disable partial results mode. Default: |
|
| Only applies when Possible values:
|
|
| If |
|
| User name |
|
| User password |
|
| Sets the parsing behaviour for double-quoted entries in SQL. If set to |
|
| Version number of the VDB |
|
| ResultSet caching is turned on/off. Default: |
|
| If |
|
| (typically not set as a connection property) Possible values:
|
|
| (typically not set as a connection property) Possible values:
|
|
| Default query timeout in seconds. Must be >= 0. |
|
| A change was made in JDBC4 to return unaliased column names as the |
|
| JAAS configuration name. Only applies when configuring a GSS authentication. Default: |
|
| Kerberos principal name. Only applies when configuring a GSS authentication. Default: |
|
| Only applies to non-SSL socket connections. When set to |
|
| In some situations, tooling may choose undesirable fetch sizes for processing results. To disable honouring |
|
| Login timeout in seconds. Must be >= 0. |
|
| If |
|
| When set to |
|
| When set to |
removeQuotesFromCatalog
and useDvRoles
properties available since v4.2
Example Using the SQuirrel SQL Client
この例では、ファイルが別途ダウンロードされ、ツールのフォルダに置かれている場合にドライバーを追加する方法を示しています。CData Virtuality Suite がインストールされている場合、Suite のDrivers フォルダにファイルパスを指定することができます。
- Squirrel を開き、ドライバーの '+' 記号を押すか、メニューのドライバー → 新規ドライバーを使用します。
- ドライバーの名前を設定します(「dv」など)。
URLの例を入力してください:
jdbc:datavirtuality:datavirtuality@mm://localhost:31000.
- Extra Class Path タブに切り替え、Add をクリックし、ファイルシステムでdatavirtuality-jdbc.jar ファイルを探します(この例では、ツールのフォルダに置かれています):
- リストドライバーをクリックします。クラス名フィールドには
com.datavirtuality.dv.jdbc.Driver
を入力してください。 - OK をクリックして、ドライバーの設定を保存します。
- Alias タブをクリックし、+ 記号を押してエイリアスを追加します。
- URL選択フィールドで、ステップ2で設定したエイリアス名(この例では、
dv
)を選択します。
このステップではこのように表示されます: - 認証情報を入力して接続します。