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

> Consejos de conexión para Tableau al usar el conector oficial de ClickHouse.

# Consejos de conexión

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">
  ## Pestaña Initial SQL
</div>

Si la casilla *Set Session ID* está activada en la pestaña Advanced (de forma predeterminada), puede establecer [ajustes](/es/reference/settings/session-settings) a nivel de sesión usando

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

<div id="advanced-tab">
  ## Pestaña Advanced
</div>

En el 99 % de los casos no necesitas la pestaña Advanced; para el 1 % restante, puedes usar la siguiente configuración:

* **Parámetros de conexión personalizados**. De forma predeterminada, `socket_timeout` ya está especificado; puede ser necesario cambiar este parámetro si algunas extracciones tardan mucho en actualizarse. El valor de este parámetro se especifica en milisegundos. El resto de los parámetros se puede consultar [aquí](https://github.com/ClickHouse/clickhouse-jdbc/blob/master/clickhouse-client/src/main/java/com/clickhouse/client/config/ClickHouseClientOption.java); añádelos en este campo separados por comas

* **JDBC Driver custom\_http\_params**. Este campo te permite añadir algunos parámetros a la cadena de conexión de ClickHouse pasando valores al [`custom_http_params` del driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration). Por ejemplo, así se especifica `session_id` cuando se activa la casilla *Set Session ID*

* **JDBC Driver `typeMappings`**. Este campo te permite [pasar una lista de asignaciones de tipos de datos de ClickHouse a tipos de datos de Java usados por el JDBC driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration). El connector muestra automáticamente los enteros grandes como cadenas gracias a este parámetro; puedes cambiarlo pasando tu propio conjunto de asignaciones *(no sé por qué)* usando
  ```text theme={null}
  UInt256=java.lang.Double,Int256=java.lang.Double
  ```
  Lee más sobre las asignaciones en la sección correspondiente

* **JDBC Driver URL Parameters**. En este campo puedes pasar el resto de los [parámetros del driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration), por ejemplo `jdbcCompliance`. Ten en cuenta que los valores de los parámetros deben pasarse en formato URL encoded y que, si pasas `custom_http_params` o `typeMappings` tanto en este campo como en los campos anteriores de la pestaña Advanced, los valores de esos dos campos anteriores tendrán prioridad

* Casilla **Set Session ID**. Es necesaria para establecer configuraciones a nivel de sesión en la pestaña Initial SQL; genera un `session_id` con un timestamp y un número seudoaleatorio con el formato `"tableau-jdbc-connector-*{timestamp}*-*{number}*"`

<div id="limited-support-for-uint64-int128-uint256-data-types">
  ## Compatibilidad limitada con los tipos de datos UInt64, Int128, (U)Int256
</div>

De forma predeterminada, el driver muestra los campos de tipo *UInt64, Int128, (U)Int256* como cadenas, **pero solo los muestra, no los convierte**. Esto significa que, cuando intente escribir el siguiente campo calculado, obtendrá un error

```text theme={null}
LEFT([myUInt256], 2) // ¡Error!
```

Para trabajar con campos Integer de gran tamaño igual que con cadenas, es necesario envolver explícitamente el campo en la función STR()

```text theme={null}
LEFT(STR([myUInt256]), 2) // ¡Funciona bien!
```

Sin embargo, dado que estos campos se usan con mayor frecuencia para obtener el número de valores únicos *(ID como Watch ID y Visit ID en Yandex.Metrica)* o como una *Dimensión* para especificar el nivel de detalle de la visualización, funcionan bien.

```text theme={null}
COUNTD([myUInt256]) // ¡También funciona bien!
```

Al usar la vista previa de datos (View data) de una tabla con campos UInt64, ya no aparece ningún error.
