接続のカスタマイズと微調整

適用先: Tableau Desktop

TDC ファイルを使用して接続をカスタマイズすることができます。

JDBC ベースの接続をカスタマイズする場合は、プロパティファイルでカスタマイズすることもできます。詳細については、「PROPERTIES ファイルを使用して JDBC 接続をカスタマイズする」を参照してください。

特殊文字について

特殊文字は正しくエスケープする必要があり、エスケープが必要かどうかはその文字の位置によって異なります。たとえば、値に等号記号「=」が含まれている場合、最初の「=」よりも右側にある「=」は適切にエスケープする必要があります。

例:

ServiceLocation=Region=east;Name=prod;

は、ServiceLocation=Region\=east;Name\=prod; と記述する必要があります。

TDC ファイルを使用して接続をカスタマイズする

TDC (Tableau Datasource Customization) ファイルは、ファイル名拡張子が “.tdc” の XML ファイルです。これらのファイルは、Tableau 固有の設定をカスタマイズするために使用されます。ODBC ベースの接続では、TDC ファイルを使用して、ODBC ドライバーでサポートされる ODBC および SQL 標準の部分を定義することができます。

TDC ファイルには、ベンダー名、ドライバー名、および <connection-customization> (クラスも含む) セクションが含まれます。ネイティブコネクタの場合、ベンダー名とドライバー名は、コネクタのクラス名と一致する必要があります。ほとんどの場合、ベンダー名はドライバー名と一致します。その他のデータベースコネクタには、次の 2 つの一般的なクラス名が使用されます。

その他のデータベース (JDBC) コネクタの場合、クラス名は "genericjdbc" です。
その他のデータベース (ODBC) コネクタの場合、クラス名は "genericodbc" です。

既存のワークブックまたはデータソースファイルに有効なカスタマイズセクションが既に含まれる場合、Tableau で定義されたカスタマイズのみが使用され、TDC ファイルで定義されたカスタマイズは使用されません。

詳細については、Tableau ナレッジベースの「Tableau Server で TDC ファイルを使用する」(新しいウィンドウでリンクが開く)を参照してください。

重要: Tableau では、TDC ファイルのテストやサポートは行っていません。これらのファイルは探索するためのツールとして使用してください。そうでないと、データ接続でアドレス問題が生じることがあります。TDC ファイルを作成し維持するには、注意深く手動で編集する必要があります。これらのファイルの共有はサポートされていません。

TDC ファイルの構造

各 TDC ファイルは、次の基本構造に従います。

<connection-customization class=DSCLASS enabled='true' version='10.0'>
    <vendor name=VENDOR />
    <driver name=DRIVER />
    <customizations>
        <customization name='CAP_FAST_METADATA' value='yes'/>
        ...
    </customizations>
</connection-customization>

TDC ファイルには、次の 3 つの主要なセクションがあります。

接続カスタマイズ変数
ベンダーとドライバー名
カスタマイズ内容

connection-customization セクションには、次の項目が含まれます。

クラス: 接続してカスタマイズするデータソース。
有効化: この TDC ファイルの接続カスタマイズが適用されるかどうか。TDC ファイルでは、常に "true" に設定されます。
バージョン: Tableau はバージョン番号を無視します。

次のセクションは、この TDC ファイルのデータソースのデータベースプロバイダーのベンダー名とドライバー名を識別するため、非常に重要です。各 TDC ファイルは、1 つのタイプのデータソースにのみバインドできます。ネイティブデータソースの場合、これらの名前はどちらもデータソースクラス名と一致している必要があります (たとえば、Teradata 接続の場合は "teradata")。ODBC データソースの場合、TDC ファイルのベンダー名とドライバー名は、データベースとドライバーによって Tableau に報告される内容と一致する必要があります (たとえば、"SQLite" と "SQLite3 ODBC Driver")。

最後のセクションは、実際の接続のカスタマイズを示します。

詳細については、「Tableau JDBC 機能のカスタマイズ」を参照してください。

PROPERTIES ファイルを使用して JDBC 接続をカスタマイズする

PROPERTIES ファイルは JDBC によって使用され、JDBC ドライバーに直接渡されます。これらのファイルは、ファイル名拡張子が ".properties" のプレーンテキストファイルです。また、これらのファイルには各接続パラメーターのキーと値のペアが含まれます。

JDBC 接続で PROPERTIES ファイルを使用することは、ODBC 接続用の TDC ファイルで odbc-connect-string-extras パラメーターを使用することに似ています。

注: PROPERTIES ファイルは Latin-1 形式である必要があります (https://en.wikipedia.org/wiki/.properties(新しいウィンドウでリンクが開く) を参照してください)。ただし、ASCII 文字のみが含まれている限り、BOM (バイトオーダーマーク) なしで、ファイルを UTF-8 形式で安全に保存できます。

ファイル内で、キーと値の各ペアを、区切り記号なしで、それぞれの行に配置します。ファイルには対応するコネクタと同じ名前を付けますが、ファイル名拡張子は ".properties" です。たとえば、SAP HANA コネクタの PROPERTIES ファイルは "saphana.properties" になります。

Tableau Desktop の場合、次のディレクトリにプロパティファイルを配置します。
My Tableau Repository/Datasources

Tableau Server のプロパティファイルを有効にするには、ファイルを各 Server ノードの次のディレクトリに配置します。
Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
Linux: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/
Prep フローの場合、次のディレクトリにプロパティファイルを配置します。
Linux:
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Windows:
ProgramData\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources
ProgramData\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources
仮想接続の場合、次のディレクトリにプロパティファイルを配置します。
Linux: /var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/
Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\minerva\Datasources

ファイルを正しい場所に保存すると、プロパティは同じデータソースタイプのすべての JDBC 接続に適用されます。

JDBC ベースの接続を使用してワークブックをパブリッシュする

JDBC ベースの接続からワークブックをパブリッシュするには、Tableau Desktop コンピューターと Tableau Server コンピューターの両方に PROPERTIES ファイルのコピーを含める必要があります。

このセクションの他の記事

一番上に戻る

フィードバックをありがとうございます。

フィードバックは正常に送信されました。ありがとうございます!

Tableau Desktop と Web 作成のヘルプ