ビジネスインテリジェンスツールが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 datavirtuality

mm/mms

JDBC protocol, mm for simple channel and mms for secure channel

host

Server where the CData Virtuality Server is installed

port

Port on which the CData Virtuality Server is listening for incoming JDBC connections. Default: 31000 for simple connection/31001 for secure connection

[;prop-name=prop-value]

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

ApplicationName

string

Name of the client application; allows the administrator to identify the connections

FetchSize

int

Size of the resultset. Default: 500. ⇐0 indicates that the default should be used

partialResultsMode

boolean

Enable/disable partial results mode. Default: FALSE

autoCommitTxn

string

Only applies when autoCommit is set to TRUE. This determines how an executed command must be transactionally wrapped inside the CData Virtuality engine to maintain the data integrity.

Possible values:

  • ON: always wrap the command in a distributed transaction

  • OFF: never wrap the command in a distributed transaction

  • DETECT (default): if the executed command spans more than one source, it automatically uses distributed transaction

disableLocalTxn

boolean

If TRUE, the autoCommit setting, commit, and rollback will be ignored for local transactions. Default: FALSE

user

string

User name

Password

string

User password

ansiQuotedIdentifiers

boolean

Sets the parsing behaviour for double-quoted entries in SQL. If set to TRUE, parses doubled quoted entries as identifiers. If set to FALSE, then double-quoted values that are valid string literals will be parsed as string literals. Default: TRUE

version

integer

Version number of the VDB

resultSetCacheMode

boolean

ResultSet caching is turned on/off. Default: FALSE

autoFailover

boolean

If TRUE, will automatically select a new server instance after a communication exception. Default: FALSE. This is typically not needed when connections are managed, as the connection can be purged from the pool. If TRUE in embedded mode, connections will reconnect to a newer VDB of the same name/version

SHOWPLAN

string

(typically not set as a connection property)

Possible values:

  • ON: returns the query plan along with the results

  • DEBUG: additionally prints the query planner debug information in the log and returns it with the results. Both the plan and the log are available through JDBC API extensions

  • OFF (default)

NoExec

string

(typically not set as a connection property)

Possible values:

  • ON: prevents query execution, but parsing and planning will still occur

  • OFF (default)

QueryTimeout

integer

Default query timeout in seconds. Must be >= 0. 0 indicates no timeout. Can be overridden by Statement.setQueryTimeout. Default: 0

useJDBC4ColumnNameAndLabelSemantics

boolean

A change was made in JDBC4 to return unaliased column names as the ResultSetMetadata column name. Before this, if a column alias was used, it was returned as the column name. Setting this property to FALSE will enable backwards compatibility with JDBC3 and earlier. Default: TRUE

jaasName

string

JAAS configuration name. Only applies when configuring a GSS authentication. Default: DVClient

kerberosServicePrincipleName

string

Kerberos principal name. Only applies when configuring a GSS authentication. Default: DVServer/hostname

encryptRequest

boolean

Only applies to non-SSL socket connections. When set to TRUE, the request message and any associate payload will be encrypted using the connection encryptor. Default: FALSE

disableResultSetFetchSize

boolean

In some situations, tooling may choose undesirable fetch sizes for processing results. To disable honouring ResultSet.setFetchSize, set to TRUE. Default: FALSE

loginTimeout

integer

Login timeout in seconds. Must be >= 0. 0 indicates no specific timeout, but other timeouts may apply. An exception will be thrown if a connection cannot be created in approximately the timeout value. A default of 0 does not mean that the login will wait indefinitely. Typically if an active VDB cannot be found, the login will fail at that time. Local connections that specify a VDB version, however, can wait by default for up to the time specified in the  org.teiid.clientVdbLoadTimeoutMillis[org.teiid.clientVdbLoadTimeoutMillis property

reportAsViews

boolean

If TRUE, the CData Virtuality Server will report views as a VIEW table type. If FALSE, views will be reported as a TABLE. Default: TRUE

removeQuotesFromCatalog 

boolean

When set to TRUE, double quotes around the catalog name are removed to load the correct metadata

useDvRoles 

boolean

When set to TRUE, CData Virtuality roles are used to get permission for SSO users

removeQuotesFromCatalog and useDvRoles properties available since v4.2

Example Using the SQuirrel SQL Client

この例では、ファイルが別途ダウンロードされ、ツールのフォルダに置かれている場合にドライバーを追加する方法を示しています。CData Virtuality Suite がインストールされている場合、Suite のDrivers フォルダにファイルパスを指定することができます。

  1. Squirrel を開き、ドライバーの '+' 記号を押すか、メニューのドライバー → 新規ドライバーを使用します。
  2. ドライバーの名前を設定します(「dv」など)。
  3. URLの例を入力してください:jdbc:datavirtuality:datavirtuality@mm://localhost:31000.

  4. Extra Class Path タブに切り替え、Add をクリックし、ファイルシステムでdatavirtuality-jdbc.jar ファイルを探します(この例では、ツールのフォルダに置かれています):

  5.  リストドライバーをクリックします。クラス名フィールドにはcom.datavirtuality.dv.jdbc.Driverを入力してください。
  6. OK をクリックして、ドライバーの設定を保存します。
  7. Alias タブをクリックし、+ 記号を押してエイリアスを追加します。
  8. URL選択フィールドで、ステップ2で設定したエイリアス名(この例では、dv)を選択します。
    このステップではこのように表示されます:

  9. 認証情報を入力して接続します。