테이블 탐색기로 쿼리 만들기

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

이 기능에 대한 지원을 요청하거나 의견을 보내려면 [e-mail]으로 이메일을 보내세요.

이 문서에서는 테이블 탐색기를 사용하여 테이블 데이터를 검사하고 데이터 탐색 쿼리를 만드는 방법을 보여줍니다.

테이블 탐색기 정보

테이블 탐색기는 테이블 데이터를 시각적으로 탐색하고 선택한 테이블 필드를 기반으로 쿼리를 만들 수 있는 자동화된 방법을 제공합니다.

테이블 탐색기에서 검사할 테이블 필드를 선택합니다. 한 번에 최대 10개의 테이블 필드를 선택할 수 있습니다.

테이블 탐색기는 선택한 필드를 count 열순으로 정렬된 각 필드의 가장 일반적인 값 최대 10개 목록이 포함된 양방향 카드로 표시합니다. 자세히 살펴볼 필드와 고유한 값을 선택하여 카드와 상호작용할 수 있습니다. 테이블 탐색기는 선택사항을 기반으로 데이터 탐색 쿼리를 만듭니다.

이 쿼리를 쿼리 편집기의 새 쿼리에 복사하거나 테이블 탐색기에서 쿼리를 적용할 수 있습니다. 쿼리를 적용하면 테이블 탐색기가 쿼리를 실행하고 표시된 카드를 쿼리 결과로 새로고침합니다. 테이블 데이터 탐색을 계속하려면 새로고침한 카드에서 더 많은 필드 또는 값을 선택합니다.

제한사항

• 테이블 탐색기는 BigQuery 테이블, BigLake 테이블, 외부 테이블, 뷰에 사용할 수 있습니다.
• 테이블 탐색기를 사용하면 한 번에 하나의 테이블을 탐색할 수 있습니다. 이 기능은 여러 테이블을 동시에 탐색하거나 교차 테이블 작업(예: JOIN 작업)을 생성하는 것을 지원하지 않습니다.
• 테이블 탐색기는 테이블 필드 및 고유한 값 선택을 직접 반영하는 SQL 쿼리를 만듭니다. 테이블 탐색기에서 만든 쿼리를 실행하거나 쿼리 편집기에서 수동으로 수정할 수 있습니다. 테이블 탐색기는 SQL 쿼리를 생성, 완료 또는 설명하는 AI 기반 지원을 제공하지 않습니다.
• 열 수준 액세스 제어(ACL) 또는 제한된 사용자 권한이 있는 테이블의 테이블 데이터를 탐색하고 쿼리를 생성하려면 선택한 모든 필드에 대한 읽기 액세스 권한이 있어야 합니다. 생성된 쿼리를 실행하려면 충분한 권한이 있어야 합니다.

가격 책정

테이블 탐색기는 선택한 테이블 필드와 고유한 값을 기반으로 쿼리를 실행하여 테이블 탐색 결과를 표시합니다. 이러한 쿼리에는 컴퓨팅 가격 책정 요금이 발생합니다. 테이블 탐색기에는 테이블 필드 선택을 확인하고 쿼리 실행을 트리거하기 전에 처리될 각 쿼리의 데이터 양이 표시됩니다.

테이블 탐색기에서 생성된 쿼리를 실행하면 컴퓨팅 요금이 청구될 수도 있습니다.

BigQuery 컴퓨팅 가격 책정에 대한 자세한 내용은 가격 책정을 참고하세요.

시작하기 전에

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. Enable the BigQuery API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

7. Enable the BigQuery API.

   Enable the API

필수 역할 및 권한

테이블 탐색기를 사용하여 테이블 데이터를 보고 쿼리를 생성하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

• 프로젝트에 대한 BigQuery 작업 사용자(roles/bigquery.jobUser)
• 탐색하려는 모든 테이블과 뷰에 대한 BigQuery 데이터 뷰어(roles/bigquery.dataViewer)

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 테이블 데이터를 보고 테이블 탐색기로 쿼리를 생성하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

테이블 탐색기를 사용하여 테이블 데이터를 보고 쿼리를 생성하려면 다음 권한이 필요합니다.

• 데이터가 저장된 위치에 관계없이 쿼리를 실행 중인 프로젝트에 대한 bigquery.jobs.create 권한
• 탐색하려는 모든 테이블과 뷰에 대한 bigquery.tables.getData

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

BigQuery Identity and Access Management(IAM)에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

테이블의 데이터를 탐색하여 쿼리 만들기

테이블 데이터를 살펴보고 선택한 테이블 필드 및 값을 기반으로 쿼리를 만들려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 BigQuery Studio로 이동합니다.

   BigQuery Studio로 이동

2. Explorer 창에서 쿼리를 만들 테이블을 선택합니다.

3. 테이블 탐색기 탭을 클릭한 후 필드 선택을 클릭합니다.

4. 필드 선택 창에서 탐색할 테이블 필드를 최대 10개까지 선택합니다.

5. 파티션을 나눈 테이블의 경우 파티션 필터 섹션에서 커스텀 파티셔닝 필터를 설정합니다. 파티션 필터를 사용하면 테이블을 탐색할 때 청구 가능 비용을 줄일 수 있습니다.

   1. 커스텀 파티셔닝 필터 적용을 선택합니다.

   2. 표시된 설정 필드에서 파티셔닝 필터를 구성합니다.

   필터 설정의 표시는 시간, 일, 월, 연도 또는 범위와 같은 테이블의 파티션 유형에 따라 다릅니다.

6. 저장을 클릭합니다.

   저장을 클릭하면 BigQuery에서 쿼리를 실행하여 선택한 필드에 공통 값을 표시하고, 이로 인해 요금이 부과됩니다. 필드 선택 창 상단에서 처리될 데이터 양을 확인할 수 있습니다.

   테이블 탐색기는 선택한 필드를 Count 열순으로 정렬된 최대 10개의 가장 일반적인 값 목록의 카드로 표시합니다. 생성된 쿼리 섹션에서 동일한 데이터를 표시하기 위해 실행할 수 있는 쿼리를 확인할 수 있습니다.

7. 선택사항: 결과를 수정하려면 다음을 시도해 보세요.

   1. 표시된 선택 필드 카드에서 고유한 값을 선택하여 데이터를 추가로 필터링합니다.
   2. 모든 변경사항을 되돌리려면 재설정을 클릭합니다.
   3. 생성된 쿼리 섹션에서 쿼리에 복사를 클릭하여 생성된 코드를 쿼리 편집기의 제목이 없는 새 쿼리에 복사합니다. 새로 만든 쿼리 탭에서 쿼리를 수정, 실행, 관리할 수 있습니다.

8. 생성된 쿼리를 실행하려면 적용을 클릭합니다.

   BigQuery는 생성된 쿼리를 실행하고 표시된 카드를 쿼리 결과로 새로고침합니다.

9. 테이블 탐색을 계속하려면 새로고침된 표시된 카드에서 새 필드 또는 고유한 값을 선택합니다.

문제 해결

Access Denied: Project [project_id]: User does not have bigquery.jobs.create
permission in project [project_id].

이 오류는 주 구성원에게 프로젝트에서 쿼리 작업을 만들 수 있는 권한이 없을 때 발생합니다.

해결 방법: 관리자가 쿼리 중인 프로젝트에 대한 bigquery.jobs.create 권한을 부여해야 합니다. 쿼리된 데이터에 액세스하는 데 필요한 권한 외에도 이 권한이 필요합니다.

BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

다음 단계

• 데이터 통계로 데이터를 탐색하는 방법 알아보기
• BigQuery에서 Gemini 지원을 사용하여 쿼리를 작성하는 방법 알아보기