> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ClickHouse 公式コネクタを使用する際の Tableau の接続に関するヒント。

# 接続のヒント

export const ClickHouseSupportedBadge = () => {
  return <div className="ClickHouseSupportedBadge">
            <div className="ClickHouseSupportedIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <path d="M1.30762 1.39073C1.30762 1.3103 1.37465 1.22986 1.46849 1.22986H2.64824C2.72868 1.22986 2.80912 1.29689 2.80912 1.39073V14.4886C2.80912 14.5691 2.74209 14.6495 2.64824 14.6495H1.46849C1.38805 14.6495 1.30762 14.5825 1.30762 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M4.2832 1.39073C4.2832 1.3103 4.35023 1.22986 4.44408 1.22986H5.62383C5.70427 1.22986 5.7847 1.29689 5.7847 1.39073V14.4886C5.7847 14.5691 5.71767 14.6495 5.62383 14.6495H4.44408C4.36364 14.6495 4.2832 14.5825 4.2832 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M7.25977 1.39073C7.25977 1.3103 7.3268 1.22986 7.42064 1.22986H8.60039C8.68083 1.22986 8.76127 1.29689 8.76127 1.39073V14.4886C8.76127 14.5691 8.69423 14.6495 8.60039 14.6495H7.42064C7.3402 14.6495 7.25977 14.5825 7.25977 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M10.2354 1.39073C10.2354 1.3103 10.3024 1.22986 10.3962 1.22986H11.576C11.6564 1.22986 11.7369 1.29689 11.7369 1.39073V14.4886C11.7369 14.5691 11.6698 14.6495 11.576 14.6495H10.3962C10.3158 14.6495 10.2354 14.5825 10.2354 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M13.2256 6.6057C13.2256 6.52526 13.2926 6.44482 13.3865 6.44482H14.5662C14.6466 6.44482 14.7271 6.51186 14.7271 6.6057V9.27354C14.7271 9.35398 14.6601 9.43442 14.5662 9.43442H13.3865C13.306 9.43442 13.2256 9.36739 13.2256 9.27354V6.6057Z" fill="currentColor" />
                </svg>
            </div>
            ClickHouse Supported
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<div id="initial-sql-tab">
  ## 初期 SQL タブ
</div>

Advanced タブで *Set Session ID* チェックボックスが有効になっている場合 (デフォルトで有効) 、次の方法でセッションレベルの[設定](/ja/reference/settings/session-settings)を指定できます

```text theme={null}
SET my_setting=value;
```

<div id="advanced-tab">
  ## Advanced タブ
</div>

99% のケースでは Advanced タブは不要です。残りの 1% では、次の設定を使用できます。

* **カスタム接続パラメータ**。デフォルトでは `socket_timeout` がすでに指定されています。一部の抽出の更新に非常に時間がかかる場合は、このパラメータを変更する必要があることがあります。このパラメータの値はミリ秒単位で指定します。その他のパラメータは[こちら](https://github.com/ClickHouse/clickhouse-jdbc/blob/master/clickhouse-client/src/main/java/com/clickhouse/client/config/ClickHouseClientOption.java)で確認できます。このフィールドにカンマ区切りで追加してください

* **JDBC Driver custom\_http\_params**。このフィールドでは、[ドライバーの `custom_http_params` パラメータ](https://github.com/ClickHouse/clickhouse-jdbc#configuration)に値を渡すことで、ClickHouse の接続文字列に任意のパラメータを追加できます。たとえば、*Set Session ID* チェックボックスを有効にすると、`session_id` はこの方法で指定されます

* **JDBC Driver `typeMappings`**。このフィールドでは、[JDBC ドライバーで使用する Java データ型への ClickHouse データ型の型マッピング一覧を渡せます](https://github.com/ClickHouse/clickhouse-jdbc#configuration)。コネクタはこのパラメータにより大きな整数を自動的に文字列として表示しますが、次のように独自のマッピングセットを渡すことで変更できます *(理由はわかりません)*
  ```text theme={null}
  UInt256=java.lang.Double,Int256=java.lang.Double
  ```
  マッピングの詳細については、該当セクションを参照してください

* **JDBC Driver URL Parameters**。このフィールドでは、たとえば `jdbcCompliance` などの[その他のドライバーパラメータ](https://github.com/ClickHouse/clickhouse-jdbc#configuration)を渡せます。なお、パラメータ値は URL エンコード形式で渡す必要があります。また、`custom_http_params` または `typeMappings` をこのフィールドと Advanced タブ内の前のフィールドの両方で指定した場合は、Advanced タブ内の先行する 2 つのフィールドの値が優先されます

* **Set Session ID** チェックボックス。初期 SQL タブでセッションレベルの設定を行うために必要です。`\"tableau-jdbc-connector-*{timestamp}*-*{number}*\"` 形式で、タイムスタンプと疑似乱数を使った `session_id` を生成します

<div id="limited-support-for-uint64-int128-uint256-data-types">
  ## UInt64、Int128、(U)Int256 データ型のサポートは限定的です
</div>

デフォルトでは、ドライバーは *UInt64、Int128、(U)Int256* 型のフィールドを文字列として表示しますが、**変換しているのではなく、表示しているだけです**。つまり、次の計算フィールドを作成しようとすると、エラーが発生します

```text theme={null}
LEFT([myUInt256], 2) // エラー!
```

文字列と同様に大きな Integer フィールドを扱うには、そのフィールドを明示的に STR() 関数で囲む必要があります

```text theme={null}
LEFT(STR([myUInt256]), 2) // 正常に動作します！
```

ただし、このようなフィールドは、多くの場合、一意な値の数を調べるため (*(Yandex.Metrica の Watch ID や Visit ID といった ID)*) や、可視化の粒度を指定する *Dimension* として使用されるため、問題なく機能します。

```text theme={null}
COUNTD([myUInt256]) // こちらも正常に動作します！
```

UInt64 フィールドを含むテーブルのデータプレビュー (View data) を使用しても、エラーは表示されなくなりました。
