Google BigQuery
이 문서에서는 Tableau를 Google BigQuery에 연결하고 데이터 원본을 설정하는 방법에 대해 설명합니다.
참고: 이 문서에 나열된 일부 기능 및 사용자 지정은 Tableau Prep Builder에서 지원되지 않습니다. Prep Builder에서 데이터에 연결하는 방법에 대한 자세한 내용은 데이터에 연결(링크가 새 창에서 열림)을 참조하십시오.
시작하기 전에
시작하기 전에 다음과 같은 연결 정보를 수집하십시오.
- Google BigQuery 이메일 또는 전화 및 비밀번호
권장 사항
회사의 IT 정책을 사용하도록 사용자 지정 OAuth 클라이언트 설정
사용자 지정 OAuth 클라이언트를 사용하면 자체 IT 정책에 따라 OAuth 구성을 완전히 제어할 수 있습니다. 자체 OAuth 클라이언트를 사용하는 옵션을 통해 관리자는 Tableau 해제 주기와 Tableau의 OAuth 클라이언트 순환 일정 관리 업무에서 해방됩니다. 자체 OAuth 클라이언트를 구성하는 방법에 대한 자세한 내용은 사이트에 대해 사용자 지정 OAuth 구성을 참조하십시오.
연결한 후 데이터 원본 설정
참고: 새 Google BigQuery 데이터 원본에 서비스 계정 자격 증명을 사용하려면 Tableau Desktop에서 연결을 만들어야 합니다.
Tableau를 시작하고 연결에서 Google BigQuery를 선택합니다.
다음 2개 옵션 중 하나를 선택하여 계속합니다.
옵션 1:
- 인증에서 OAuth를 사용하여 로그인을 선택합니다.
- 로그인을 클릭합니다.
- 비밀번호를 입력하여 계속합니다.
- Tableau에서 Google BigQuery 데이터에 액세스할 수 있도록 동의를 선택합니다. 브라우저를 닫으라는 메시지가 표시됩니다.
옵션 2:
팁: Tableau Server 또는 Tableau Cloud를 게시에 사용하는 경우 사용 중인 제품에 로그인한 다음 저장된 Google BigQuery 자격 증명을 계정 설정에 추가해야 합니다. 이렇게 하면 "잘못된 자격 증명 오류"가 방지됩니다.
- 인증에서 서비스 계정(JSON) 파일을 사용하여 로그인을 선택합니다.
- 파일 경로를 입력하거나 찾아보기 단추를 사용하여 검색합니다.
- 로그인을 클릭합니다.
- 비밀번호를 입력하여 계속합니다.
- Tableau에서 Google BigQuery 데이터에 액세스할 수 있도록 동의를 선택합니다. 브라우저를 닫으라는 메시지가 표시됩니다.
데이터 원본 페이지에서 다음을 수행합니다.
(선택 사항) 페이지 상단에서 기본 데이터 원본 이름을 선택한 다음 Tableau에서 사용할 고유한 데이터 원본 이름을 입력합니다. 예를 들어 데이터 원본을 사용하는 다른 사용자가 어떤 데이터 원본에 연결해야 하는지를 쉽게 알 수 있는 데이터 원본 명명 규칙을 사용하십시오.
(선택 사항) 청구 프로젝트 드롭다운 목록에서 청구 프로젝트를 선택합니다. 청구 프로젝트를 선택하지 않으면 나머지 필드를 선택한 후 이 필드에
EmptyProject가 나타납니다.프로젝트 드롭다운 목록에서 프로젝트를 선택합니다. 또는 BigQuery의 샘플 데이터에 연결할 publicdata를 선택합니다.
데이터 집합 드롭다운 목록에서 데이터 집합을 선택합니다.
테이블 아래에서 테이블을 선택합니다.
사용자 지정 SQL을 사용하여 전체 데이터 원본이 아니라 특정 쿼리에 연결할 수 있습니다. 자세한 내용은 사용자 지정 SQL 쿼리에 연결을 참조하십시오.
참고:
- Google BigQuery가 BQL(BigQuery legacy SQL)에서 표준 SQL을 지원하도록 변경되었습니다. 통합 문서를 Tableau에서 열면 표준 SQL을 지원하도록 업그레이드됩니다.
- BigQuery의 데이터 양이 크기 때문에 라이브 연결을 수행하는 것이 좋습니다.
- Radians() 함수는 Google BigQuery에서 지원되지 않습니다.
사용자 지정 특성을 사용하여 쿼리 성능 향상
참고: 현재 Tableau Prep Builder에서 사용자 지정 특성이 지원되지 않습니다.
사용자 지정 특성을 사용하여 BigQuery에서 Tableau Cloud 및 Tableau Server로 반환되는 대규모 결과 집합과 Tableau Desktop의 성능을 향상시킬 수 있습니다.
게시된 통합 문서 또는 데이터 원본에 사용자 지정 특성을 포함시키려면 Tableau Cloud 또는 Tableau Server에 통합 문서 또는 데이터 원본을 게시하기 전에 해당 특성을 지정해야 합니다.
Google BigQuery 사용자 지정 특성 사용
사용자 지정 특성은 정수 값을 사용하며 지정된 연결의 실시간 쿼리와 추출 새로 고침에 모두 영향을 미칩니다.
다음과 같은 특성을 사용하면 대규모 결과 집합의 성능을 향상시킬 수 있습니다.
| bq-fetch-tasks | HTTP를 사용하여 데이터를 가져올 때 사용할 병렬 백그라운드 작업의 수. 기본값은 10입니다. |
| bq-large-fetch-rows | 스풀 쿼리의 각 일괄 처리에서 가져올 행 수. 기본값은 50000입니다. |
다음과 같은 특성도 사용할 수 있지만 이러한 특성은 소규모 쿼리에 사용됩니다.
| bq-fetch-rows | 비 스풀 쿼리의 각 일괄 처리에서 가져올 행 수. 기본값은 10000입니다. |
| bq-response-rows | 일괄 처리가 아닌 비 스풀 쿼리에서 반환되는 행 수. 기본값은 10000입니다. |
이 기능 설정에는 yes 또는 no 값을 사용할 수 있으며 테스트 시 유용하게 사용할 수 있습니다.
| CAP_BIGQUERY_FORCE_SPOOL_JOB | 모든 쿼리가 임시 테이블 방식을 사용하게 만듭니다. 기본값은 “no”입니다. 이 특성을 설정하려면 값을 “yes”로 변경하십시오. |
Tableau가 Google BigQuery에서 행을 반환하는 방식
Tableau에서는 BigQuery에서 행을 반환하기 위해 두 가지 방식을 사용합니다. 기본 방식은 비 스풀 방식이며 다른 방식은 임시 테이블(스풀) 방식입니다.
첫 번째 시도에서는 쿼리가 기본 방식인 비 스풀 쿼리를 사용하여 실행되며, 이 방식에서는 bq-fetch-rows 설정을 사용합니다.
결과 집합이 지나치게 큰 경우 BigQuery API가 오류를 반환하고 Tableau BigQuery 커넥터는 결과를 BigQuery 임시 테이블에 저장하는 방식으로 쿼리를 재시도합니다. 이 임시 테이블이 bq-large-fetch-rows 설정을 사용하는 스풀 작업이며 BigQuery 커넥터는 이 임시 테이블을 읽습니다.
특성을 지정하는 방법
특성을 지정하는 방법은 두 가지입니다. 하나는 Tableau 데이터 원본 사용자 지정(.tdc) 파일에 지정하는 것이고, 다른 하나는 통합 문서 또는 데이터 원본 XML에 지정하는 것입니다.
.tdc 파일에 특성 지정
Tableau Desktop에서 통합 문서 게시 또는 데이터 원본 게시 작업 중에 사용자 지정 특성을 지정하려면 다음을 수행합니다.
사용자 지정 특성을 포함하는 XML 파일을 만듭니다.
.tdc확장명으로 파일을 저장합니다(예:BigQueryCustomization.tdc).파일을
My Tableau Repository\Datasources폴더에 저장합니다.
데이터 원본이나 통합 문서를 Tableau Cloud 또는 Tableau Server에 게시할 때 Tableau Desktop에서 .tdc 파일의 사용자 지정 특성을 읽고 포함시킵니다.
중요: TDC 파일은 연결 기능을 사용자 지정하거나 데이터 연결과 관련된 문제를 진단하고 해결하는 데 활용할 수 있습니다. Tableau는 사용자가 이러한 파일을 수정할 수 있는 모든 가능성을 철저히 테스트할 수 없습니다. TDC 파일을 만들어 사용하려면 수동 편집이 필요하며, 프로덕션 환경에 배포하기 전에 철저히 테스트하는 것이 중요합니다.
대규모 추출에 대한 권장 설정이 포함된 .tdc 파일의 예
<connection-customization class='bigquery' enabled='true' version='8.0' >
<vendor name='bigquery' />
<driver name='bigquery' />
<customizations>
<customization name='bq-fetch-tasks' value='10' />
<customization name='bq-large-fetch-rows' value='10000' />
</customizations>
</connection-customization>
통합 문서 또는 데이터 원본 파일의 XML에 수동으로 특정 내장
workbook.twb 파일이나 데이터 원본 .tds 파일의 'connection' 태그 내부에 수동으로 사용자 지정 특성을 포함시킬 수 있습니다. 다음 예제에서 BigQuery 사용자 지정 특성은 쉽게 구분할 수 있도록 굵게 표시되어 있습니다.
수동으로 내장된 특성의 예
<connection CATALOG='publicdata' EXECCATALOG='some-project-123' REDIRECT_URI='some-url:2.0:oob' SCOPE='https://www.googleapis.com/auth/bigquery https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email' authentication='yes' bq-fetch-tasks='10' bq-large-fetch-rows='10000'bq_schema='samples' class='bigquery' connection-dialect='google-bql' connection-protocol='native-api' login_title='Sign in to Google BigQuery' odbc-connect-string-extras='' project='publicdata' schema='samples' server='googleapis.com/bigquery' server-oauth='' table='wikipedia' username=''>
통합 문서가 표준 SQL을 사용하는지, 아니면 레거시 SQL을 사용하는지 확인
2016년에 Google은 표준 SQL을 지원하도록 BigQuery API를 업데이트했으며 여전히 BigQuery SQL(이제 레거시 SQL이라고 함)을 지원합니다. Tableau 10.1부터 Google BigQuery 커넥터가 표준 SQL을 지원하도록 업그레이드되었으며 여전히 레거시 SQL도 지원합니다. 표준 SQL을 사용하면 BigQuery 커넥터 사용자가 세부 수준 식을 사용할 수 있고, 보다 빠르게 메타데이터 유효성을 검사할 수 있으며, 연결에서 청구 프로젝트를 선택할 수 있습니다.
이제 통합 문서를 만들 때 Tableau가 기본적으로 표준 SQL을 지원합니다. Tableau는 레거시 SQL도 지원하며, 이를 사용하려면 데이터 패널에서 레거시 SQL 사용 옵션을 사용합니다. 예를 들어 이전 버전의 Tableau Desktop을 사용하여 만든 통합 문서를 열 때 통합 문서에서 레거시 SQL을 사용하는 경우 레거시 SQL 사용 옵션이 선택됩니다.
레거시 SQL 사용 옵션을 구성하는 이유는 다음과 같습니다.
세부 수준 식을 작성하거나 다른 향상된 기능을 활용하기 위해 표준 SQL을 사용하도록 업데이트하려는 기존 통합 문서가 있습니다. 이 경우 레거시 SQL 사용 옵션을 선택하지 않아야 합니다.
레거시 SQL 뷰에 연결해야 하는 통합 문서를 만듭니다. 레거시 SQL과 표준 SQL을 혼합하여 사용할 수 없기 때문에 통합 문서가 작동하려면 레거시 SQL 사용 옵션을 선택해야 합니다.
Google BigQuery에서 뷰는 표준 SQL 또는 레거시 SQL로 작성됩니다. 표준 SQL로 작성된 뷰를 표준 SQL로 작성된 뷰에 조인하거나 레거시 SQL로 작성된 뷰를 레거시 SQL로 작성된 뷰에 조인할 수 있으며 두 SQL 중 한 버전으로 작성된 뷰를 테이블에 조인할 수 있습니다. 하지만 한 통합 문서에서 표준 SQL로 작성된 뷰와 레거시 SQL로 작성된 뷰를 조인할 수 없습니다. 뷰를 조인할 때 연결하려는 뷰에 사용되는 SQL 유형과 일치하도록 레거시 SQL 사용 확인란을 설정해야 합니다.
참고: 레거시 SQL 또는 표준 SQL을 사용하는 경우 Tableau Desktop은 중첩된 데이터에 대해 제한적인 지원만 제공합니다. 예를 들어 테이블에 중첩된 데이터가 포함되어 있고 레거시 SQL 또는 표준 SQL을 사용하는 경우 데이터 원본 페이지에서 지금 업데이트가 작동하지 않습니다.
레거시 SQL을 표준 SQL로 마이그레이션하는 것에 대한 자세한 내용은 Google Cloud Platform 웹 사이트에서 레거시 SQL에서 마이그레이션(영문)(링크가 새 창에서 열림)을 참조하십시오.
BigQuery BI Engine을 사용하여 데이터 분석
BigQuery BI Engine을 사용하면 BigQuery가 지원하는 보고서 및 대시보드를 통해 지연 시간이 짧은 분석 서비스와 대화형 분석을 빠르게 수행할 수 있습니다. BigQuery BI Engine을 Tableau와 통합하는 방법에 대한 지침을 비롯하여 자세한 내용은 Google 설명서에서 BI Engine 및 Tableau를 사용한 BigQuery 데이터 분석을 참조하십시오.
Google BigQuery 문제 해결
여러 계정에 대한 연결
웹 작성을 사용하거나 웹에 게시하는 경우 동일한 통합 문서에서 여러 Google BigQuery 계정을 사용할 수 없습니다. Desktop에서는 여러 Google BigQuery 계정에 연결할 수 있습니다.
흐름을 게시하는 경우 입력 단계에서 Google BigQuery에 연결하기 위해 사용하는 자격 증명은 Tableau Server 또는 Tableau Cloud의 Google BigQuery에 대한 내 계정 설정 페이지의 설정 탭에서 설정한 자격 증명과 일치해야 합니다. 흐름을 게시하는 경우 인증 설정에서 다른 자격 증명을 선택하거나 자격 증명을 선택하지 않으면 Tableau Server 또는 Tableau Cloud에서 해당 자격 증명과 일치하도록 흐름에 대한 연결을 편집할 때까지 흐름이 실패하고 인증 오류가 발생합니다.
Internet Explorer 11 및 Edge를 사용한 웹 작성
Internet Explorer 11 및 Edge에서는 보안되지 않은 연결(http)을 사용하여 서버에 액세스할 수 없습니다. 보안 연결(https)을 사용하거나 다른 브라우저로 전환하십시오.
참고 항목
- 데이터 원본 설정 – 이 데이터 원본에 더 많은 데이터를 추가하거나 데이터를 분석할 수 있도록 준비합니다.
- 차트 작성 및 데이터 분석 – 데이터 분석을 시작합니다.
- Google에 대한 OAuth 설정(링크가 새 창에서 열림) - Tableau Server에 대한 OAuth 연결을 구성합니다.
- OAuth 연결(링크가 새 창에서 열림) - Tableau Cloud에 대한 OAuth 연결을 구성합니다.
- Google BigQuery 및 Tableau: 모범 사례(링크가 새 창에서 열림) - Tableau 백서를 읽어 보십시오(등록 또는 로그인 필요).