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

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

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

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 ファイルの構造

各 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 の場合、次のフォルダーに PROPERTIES ファイルを配置します。

My Tableau Repository/Datasources

Tableau Server の PROPERTIES ファイルを有効にするには、ファイルを各 Server ノードの次のフォルダーに配置します。

  • Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
  • Linux: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/

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

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

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

関連項目

「ネイティブ コネクタの接続文字列のカスタマイズ」(新しいウィンドウでリンクが開く) – Tableau コミュニティのこの記事では、odbc-connect-string-extras カスタマイズを使用してネイティブ コネクタによる接続を変更する方法を説明します。

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

ありがとうございます!