> ## 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.
> ClickHouse 공식 커넥터 사용 시 Tableau 연결에 관한 팁입니다.
# 연결 팁
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
## Initial SQL 탭
Advanced 탭에서 *Set Session ID* 확인란이 활성화되어 있으면(기본적으로 활성화됨) 다음을 사용해 세션 수준 [설정](/ko/reference/settings/session-settings)을 지정할 수 있습니다.
```text theme={null}
SET my_setting=value;
```
## Advanced 탭
99%의 경우 Advanced 탭은 필요하지 않지만, 나머지 1%의 경우에는 다음 설정을 사용할 수 있습니다:
* **사용자 지정 connection 매개변수**. 기본적으로 `socket_timeout`이 이미 지정되어 있으며, 일부 추출 작업을 업데이트하는 데 매우 오랜 시간이 걸리는 경우 이 매개변수를 변경해야 할 수 있습니다. 이 매개변수 값은 밀리초 단위로 지정합니다. 나머지 매개변수는 [여기](https://github.com/ClickHouse/clickhouse-jdbc/blob/master/clickhouse-client/src/main/java/com/clickhouse/client/config/ClickHouseClientOption.java)에서 확인할 수 있으며, 이 필드에 쉼표로 구분하여 추가하십시오
* **JDBC 드라이버 custom\_http\_params**. 이 필드에서는 [드라이버의 `custom_http_params` 매개변수](https://github.com/ClickHouse/clickhouse-jdbc#configuration)에 값을 전달하여 ClickHouse connection string에 일부 매개변수를 추가할 수 있습니다. 예를 들어, *Set Session ID* 체크박스를 활성화하면 `session_id`는 다음과 같이 지정됩니다
* **JDBC 드라이버 `typeMappings`**. 이 필드에서는 [ClickHouse 데이터 타입을 JDBC 드라이버가 사용하는 Java 데이터 타입으로 매핑하는 목록을 전달할 수 있습니다](https://github.com/ClickHouse/clickhouse-jdbc#configuration). 커넥터는 이 매개변수 덕분에 큰 정수를 문자열로 자동 표시하며, 사용자 지정 매핑 세트를 전달해 이를 변경할 수 있습니다 *(이유는 모르겠습니다)*. 예시는 다음과 같습니다
```text theme={null}
UInt256=java.lang.Double,Int256=java.lang.Double
```
매핑에 대한 자세한 내용은 해당 섹션을 참조하십시오
* **JDBC 드라이버 URL 매개변수**. 이 필드에서는 `jdbcCompliance`와 같은 나머지 [드라이버 매개변수](https://github.com/ClickHouse/clickhouse-jdbc#configuration)를 전달할 수 있습니다. 매개변수 값은 URL 인코딩 형식으로 전달해야 하며, `custom_http_params` 또는 `typeMappings`를 이 필드와 Advanced 탭의 이전 필드에 함께 전달하는 경우 Advanced 탭의 앞선 두 필드 값이 더 높은 우선순위를 가집니다
* **Set Session ID** 체크박스. Initial SQL 탭에서 세션 수준 설정을 지정하는 데 필요하며, `"tableau-jdbc-connector-*{timestamp}*-*{number}*"` 형식으로 timestamp와 의사 난수를 사용해 `session_id`를 생성합니다
## UInt64, Int128, (U)Int256 데이터 타입에 대한 제한적 지원
기본적으로 드라이버는 *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)* 또는 시각화의 세부 수준을 지정하는 *차원*으로 사용되므로, 이러한 용도에는 잘 작동합니다.
```text theme={null}
COUNTD([myUInt256]) // 이것도 잘 작동합니다!
```
UInt64 필드가 있는 테이블에서 데이터 미리 보기(View data)를 사용해도 이제 오류가 표시되지 않습니다.