메인 콘텐츠로 건너뛰기

​
Initial SQL 탭

Advanced 탭에서 Set Session ID 확인란이 활성화되어 있으면(기본적으로 활성화됨) 다음을 사용해 세션 수준 설정을 지정할 수 있습니다. 
SET my_setting=value;

​
Advanced 탭

99%의 경우 Advanced 탭은 필요하지 않지만, 나머지 1%의 경우에는 다음 설정을 사용할 수 있습니다:
  • 사용자 지정 connection 매개변수. 기본적으로 socket_timeout이 이미 지정되어 있으며, 일부 추출 작업을 업데이트하는 데 매우 오랜 시간이 걸리는 경우 이 매개변수를 변경해야 할 수 있습니다. 이 매개변수 값은 밀리초 단위로 지정합니다. 나머지 매개변수는 여기에서 확인할 수 있으며, 이 필드에 쉼표로 구분하여 추가하십시오
  • JDBC 드라이버 custom_http_params. 이 필드에서는 드라이버의 custom_http_params 매개변수에 값을 전달하여 ClickHouse connection string에 일부 매개변수를 추가할 수 있습니다. 예를 들어, Set Session ID 체크박스를 활성화하면 session_id는 다음과 같이 지정됩니다
  • JDBC 드라이버 typeMappings. 이 필드에서는 ClickHouse 데이터 타입을 JDBC 드라이버가 사용하는 Java 데이터 타입으로 매핑하는 목록을 전달할 수 있습니다. 커넥터는 이 매개변수 덕분에 큰 정수를 문자열로 자동 표시하며, 사용자 지정 매핑 세트를 전달해 이를 변경할 수 있습니다 (이유는 모르겠습니다). 예시는 다음과 같습니다 
    UInt256=java.lang.Double,Int256=java.lang.Double
    매핑에 대한 자세한 내용은 해당 섹션을 참조하십시오
  • JDBC 드라이버 URL 매개변수. 이 필드에서는 jdbcCompliance와 같은 나머지 드라이버 매개변수를 전달할 수 있습니다. 매개변수 값은 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 타입의 필드를 문자열로 표시하지만, 변환하지는 않고 표시만 합니다. 즉, 다음 계산 필드를 작성하려고 하면 오류가 발생합니다 
LEFT([myUInt256], 2) // 오류!
큰 Integer 필드를 문자열처럼 처리하려면 해당 필드를 STR() 함수로 명시적으로 감싸야 합니다 
LEFT(STR([myUInt256]), 2) // 정상 작동!
그러나 이러한 필드는 대부분 고유 값의 개수를 찾는 데 (Yandex.Metrica의 Watch ID, Visit ID 같은 ID) 또는 시각화의 세부 수준을 지정하는 차원으로 사용되므로, 이러한 용도에는 잘 작동합니다. 
COUNTD([myUInt256]) // 이것도 잘 작동합니다!
UInt64 필드가 있는 테이블에서 데이터 미리 보기(View data)를 사용해도 이제 오류가 표시되지 않습니다.
마지막 수정일 2026년 6월 10일