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

> Conseils de connexion pour Tableau lors de l’utilisation du connecteur officiel de ClickHouse.

# Conseils de connexion

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>
            Compatible avec ClickHouse
        </div>;
};

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

<div id="initial-sql-tab">
  ## Onglet SQL initial
</div>

Si la case à cocher *Définir l’ID de session* est activée dans l’onglet Avancé (par défaut), vous pouvez définir des [paramètres de session](/fr/reference/settings/session-settings) à l’aide de

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

<div id="advanced-tab">
  ## Onglet Avancé
</div>

Dans 99 % des cas, vous n'avez pas besoin de l'onglet Avancé. Pour le 1 % restant, vous pouvez utiliser les paramètres suivants :

* **Paramètres de connexion personnalisés**. Par défaut, `socket_timeout` est déjà défini. Il peut être nécessaire de modifier ce paramètre si certaines extractions prennent très longtemps à se mettre à jour. La valeur de ce paramètre est exprimée en millisecondes. Vous trouverez les autres paramètres [ici](https://github.com/ClickHouse/clickhouse-jdbc/blob/master/clickhouse-client/src/main/java/com/clickhouse/client/config/ClickHouseClientOption.java) ; ajoutez-les dans ce champ en les séparant par des virgules

* **JDBC Driver custom\_http\_params**. Ce champ vous permet d'ajouter certains paramètres à la chaîne de connexion ClickHouse en transmettant des valeurs au [`custom_http_params` du driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration). Par exemple, c'est ainsi que `session_id` est défini lorsque la case à cocher *Définir l’ID de session* est activée

* **JDBC Driver `typeMappings`**. Ce champ vous permet de [transmettre une liste de correspondances entre les types de données ClickHouse et les types de données Java utilisés par le JDBC driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration). Grâce à ce paramètre, le connector affiche automatiquement les grands entiers sous forme de chaînes. Vous pouvez modifier ce comportement en transmettant votre propre jeu de correspondances *(je ne sais pas pourquoi)* en utilisant
  ```text theme={null}
  UInt256=java.lang.Double,Int256=java.lang.Double
  ```
  Pour en savoir plus sur les correspondances, consultez la section correspondante

* **JDBC Driver URL Parameters**. Vous pouvez transmettre dans ce champ les autres [paramètres du driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration), par exemple `jdbcCompliance`. Attention : les valeurs des paramètres doivent être transmises au format URL Encoded. Si `custom_http_params` ou `typeMappings` sont transmis à la fois dans ce champ et dans les champs précédents de l'onglet Avancé, les valeurs des deux champs précédents de l'onglet Avancé sont prioritaires

* **Case à cocher Définir l’ID de session**. Elle est nécessaire pour définir des paramètres au niveau de la session dans l'onglet Onglet SQL initial et génère un `session_id` avec un timestamp et un nombre pseudo-aléatoire au format `"tableau-jdbc-connector-*{timestamp}*-*{number}*"`

<div id="limited-support-for-uint64-int128-uint256-data-types">
  ## Prise en charge limitée des types de données UInt64, Int128 et (U)Int256
</div>

Par défaut, le driver affiche les champs de types *UInt64, Int128, (U)Int256* sous forme de chaînes de caractères, **mais il se contente de les afficher, sans les convertir**. Cela signifie que lorsque vous essayez d'écrire le champ calculé suivant, vous obtenez une erreur

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

Pour traiter de grands champs de type Integer comme des chaînes de caractères, il faut encapsuler explicitement le champ dans la fonction STR()

```text theme={null}
LEFT(STR([myUInt256]), 2) // Works well!
```

Cependant, comme ces champs servent le plus souvent à déterminer le nombre de valeurs uniques *(d’identifiants comme Watch ID et Visit ID dans Yandex.Metrica)* ou comme *dimension* pour préciser le niveau de détail de la visualisation, cela fonctionne bien.

```text theme={null}
COUNTD([myUInt256]) // Works well too!
```

Lorsqu’on utilise l’aperçu des données (Voir les données) d’une table comportant des champs UInt64, aucune erreur n’apparaît désormais.
