JDBC 接続のカスタマイズ

発行: 06 Feb 2018
最終修正日: 10 Jan 2024

ご質問

Amazon Athena、SAP HANA、Oracle などの一部の Tableau 名前付き接続では、ODBC ではなく、JDBC 標準が使われます。JDBC を使用して接続するには、2 つの方法があり、TDC ファイルを使用するか、または PROPERTIES ファイルを使用します。

JDBC 接続を変更して、ドライバーログを収集する方法は?

環境

Tableau Desktop
Tableau Server
Amazon Athena
Mac OS X の SAP HANA

回答

JDBC 接続のオプションを変更するには .properties ファイルを使用します。このファイルは、各接続パラメーターに対するキー値のペアを記載したプレーンテキスト文書です。ただし、このファイルを BOM 文字エンコードの UTF-8 では保存しないでください。このエンコードはファイルの先頭に文字を追加するため、Tableau がカスタマイズを適用する妨げとなります。

各キー値のペアは、区切り文字のない単独の行にある必要があります。この記事の添付ファイルの例を参照してください。ファイルを saphana.properties または athena.properties として保存し、My Tableau Repository/Datasources フォルダーに配置します。

Tableau Server で .properties ファイルを有効にするには、すべてのサーバーノードで次のディレクトリにファイルを配置する必要があります。

Windows の場合: tabsvc/vizqlserver/Datasources
Linux の場合: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/

Tableau Prep Conductor を使用する場合、ファイルが次のディレクトリにも配置されていることを確認してください。

ProgramData\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources for Windows
Windows 2021.2 以降の場合: ProgramData\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources
Windows バージョン 2021.1 以前の場合: ProgramData\Tableau\Tableau Server\data\tabsvc\flowqueryservice\Datasources
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ for Linux
Linux バージョン 2021.2 以降の場合: /var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Linux バージョン 2021.1 以前の場合: /var/opt/tableau/tableau_server/data/tabsvc/flowqueryservice/Datasources/

仮想接続の場合:

ProgramData\Tableau\Tableau Server\data\tabsvc\minerva\Datasources for Windows
Linux の場合: /var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/

このデータソースタイプへのさらなる接続では、クエリ URL にオプション値が含まれます。

詳細情報

Amazon Athena JDBC オプションキーのリスト
SAP HANA JDBC オプションキーのリスト

上記のリンクのオプションに加えて、プロキシ情報はキー proxy_host と proxy_port を使用しても指定できます。詳しくは、ナレッジベースの記事「プロキシサーバー経由で Athena に接続できない」を参照してください。

athena.properties ファイルに含まれる '\' 文字はすべてエスケープする必要があります（ファイルパスなど）。C:\Users\username の代わりに、C:\\Users\\username を使用します。

JDBC の一般的なカスタマイズについては、コミュニティフォーラム「プロパティファイルを使用した JDBC 接続のカスタマイズ」を参照してください。