Tableau에서 Google BigQuery(JDBC)를 사용한 고급 설정

Google BigQuery JDBC 드라이버의 고급 설정에 있는 옵션은 다음과 같습니다. BigQuery의 ODBC 드라이버 및 JDBC 드라이버에서 설치 및 구성 가이드를 참조하세요.

아래의 설명은 Google BigQuery 및 Tableau: 모범 사례 백서에서 발췌한 것입니다.

큰 결과 데이터 집합 사용
- 이 확인란을 선택하면 허용 최대 요청 응답(즉, 결과) 크기를 늘릴 수 있습니다. 기본적으로 BigQuery는 모든 요청에 대해 최대 응답 크기를 강제합니다(구체적인 제한값은 할당량 및 제한
  참조). 큰 결과 집합 지원을 사용하지 않는 경우 쿼리를 실행하면 “Response too large to return(응답이 너무 커서 반환할 수 없음)” 같은 오류 메시지가 표시될 수 있습니다.
- “Enable Large Result Dataset(큰 결과 데이터 집합 사용)” 버튼을 선택하고 “Large Result Dataset(큰 결과 데이터 집합)” 테이블의 이름을 지정하면 쿼리 크기 및 쿼리 결과 크기에 관계없이 모든 쿼리 결과를 테이블에 기록하고 읽습니다. 따라서 다음 쿼리에는 결과 캐시를 사용할 수 없으며 요청한 모든 쿼리에 대해 요금이 청구됩니다.

Storage API( High Throughput API) 사용
- 쿼리에서 많은 양의 데이터를 반환할 것으로 예상되는 경우 이 옵션을 선택하면 커넥터가 결과 집합을 더 효율적으로 처리할 수 있습니다. 이렇게 하면 커넥터가 BigQuery Storage API를 사용하므로 BigQuery API보다 더 많은 양을 처리할 수 있습니다. 쿼리하려는 BigQuery 프로젝트에는 BigQuery Storage API를 사용해야 하며 BigQuery Storage API의 요금은 BigQuery API의 요금과 다릅니다.
- 이 기능을 사용하면 커넥터는 수신하는 결과 집합 테이블의 행 수와 모든 결과를 검색하는 데 필요한 페이지 수를 확인합니다. 행 수와 페이지 수가 “High Throughput 활성화 비율” 및 “High Throughput 최소 테이블” 매개 변수(아래 참조)에 정의된 임곗값을 초과할 경우 커넥터는 BigQuery Storage API를 사용하도록 전환합니다. 커넥터가 검색을 위해 BigQuery Storage API를 초기화하는 데 문제가 발생하는 경우 사용 권한 문제가 없는 한 다시 BigQuery API를 사용하게 됩니다. 최상의 성능을 유지하려면 이 기능을 지정된 대상 데이터 집합 또는 테이블과 함께 사용하지 마세요.
- 커넥터는 다음 매개 변수의 값에 따라 큰 결과 집합을 보다 효율적으로 전송하기 위해 High Throughput API로 전환합니다.

High Throughput 활성화 비율
- 쿼리 결과의 페이지 수가 이 값을 초과하고 결과의 행 수가 High Throughput 최소 테이블 값을 초과하는 경우 커넥터는 BigQuery API 대신 BigQuery Storage API를 사용하도록 전환합니다. 기본값은 3입니다. 페이지 크기의 기본값은 MaxResults 드라이버 매개 변수에서 정한 대로 10,000행입니다(커넥터는 해당 매개 변수를 수정할 수 있는 기능을 제공하지 않음).

High Throughput 최소 테이블 크기
- 쿼리 결과의 테이블 행 수가 이 값을 초과하고 결과의 페이지 수가 High Throughput 활성화 비율 값을 초과하는 경우 커넥터는 BigQuery API 대신 BigQuery Storage API를 사용하도록 전환합니다. 기본값은 100입니다.