> ## 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.

> Советы по подключению Tableau при использовании официального коннектора ClickHouse.

# Советы по подключению

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">
  ## Вкладка Initial SQL
</div>

Если на вкладке Advanced установлен флажок *Set Session ID* (по умолчанию), вы можете задать [настройки](/ru/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**. Это поле позволяет добавить некоторые параметры в строку подключения ClickHouse, передав значения в [параметр драйвера `custom_http_params`](https://github.com/ClickHouse/clickhouse-jdbc#configuration). Например, именно так задается `session_id`, когда установлен флажок *Set Session ID*

* **JDBC Driver `typeMappings`**. Это поле позволяет [передать список сопоставлений типов данных ClickHouse с типами данных Java, используемыми JDBC-драйвером](https://github.com/ClickHouse/clickhouse-jdbc#configuration). Благодаря этому параметру коннектор автоматически отображает большие целые числа как строки; вы можете изменить это, передав свой набор сопоставлений *(не знаю, зачем)* с помощью
  ```text theme={null}
  UInt256=java.lang.Double,Int256=java.lang.Double
  ```
  Подробнее о сопоставлениях читайте в соответствующем разделе

* **JDBC Driver URL Parameters**. В этом поле можно передать остальные [параметры драйвера](https://github.com/ClickHouse/clickhouse-jdbc#configuration), например `jdbcCompliance`. Будьте внимательны: значения параметров должны передаваться в формате URL-encoded, а если `custom_http_params` или `typeMappings` передаются и в этом поле, и в предыдущих полях вкладки Advanced, то значения из двух предыдущих полей вкладки Advanced имеют более высокий приоритет

* Флажок **Set Session ID**. Он нужен для задания настроек на уровне сеанса на вкладке Initial SQL и генерирует `session_id` с временной меткой и псевдослучайным числом в формате `"tableau-jdbc-connector-*{timestamp}*-*{number}*"`

<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) // Ошибка!
```

Чтобы работать с большими целочисленными полями так же, как со строками, необходимо явно обернуть поле в функцию STR()

```text theme={null}
LEFT(STR([myUInt256]), 2) // Работает корректно!
```

Однако такие поля чаще всего используются для подсчета количества уникальных значений *(ID, например Watch ID и Visit ID в Yandex.Metrica)* или как *измерение* для задания детализации визуализации, и в этом случае они хорошо подходят.

```text theme={null}
COUNTD([myUInt256]) // Тоже работает отлично!
```

При использовании предварительного просмотра данных (View data) для таблицы с полями UInt64 ошибка больше не появляется.
