BigQuery 테이블의 데이터 계보 추적

BigQuery 테이블의 데이터 계보 추적

이 문서에서는 BigQuery 테이블에서 데이터 계보를 추적하는 방법을 설명합니다. 데이터 계보는 데이터 출처, 변환 방식, 시간 경과에 따른 이동 위치를 추적하는 프로세스입니다. 데이터 계보를 파악하는 것은 규정 준수를 보장하고 데이터 문제를 해결하며 근본 원인 분석을 수행하는 데 매우 중요합니다.

이 빠른 시작에서는 BigQuery 테이블의 데이터 계보를 시작하는 방법을 설명합니다.

1. 공개적으로 사용 가능한 new_york_taxi_trips 데이터 세트에서 테이블 2개를 복사합니다.

2. 두 테이블의 총 택시 탑승객 수를 새 테이블로 결합합니다.

3. 세 가지 작업 모두에 대한 계보 시각화 그래프를 봅니다.

시작하기 전에

프로젝트를 설정합니다.

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Dataplex, BigQuery, and Data Lineage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Dataplex, BigQuery, and Data Lineage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

주의: 데이터 계보는 서비스별이 아닌 프로젝트별로 사용 설정됩니다. Data Lineage API를 사용 설정하면 제품 수준 계보 제어에 따라 프로젝트의 여러 Google Cloud 서비스에 계보 정보가 자동으로 보고됩니다. 자세한 내용은 데이터 계보 고려사항을 참조하세요.

필수 역할

계보 시각화 그래프를 보는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

• Dataplex Universal Catalog 리소스 프로젝트에 대한 Dataplex 카탈로그 뷰어(roles/dataplex.catalogViewer) 역할
• BigQuery를 사용하는 프로젝트에 대한 데이터 계보 뷰어(roles/datalineage.viewer) 역할
• BigQuery를 사용하는 프로젝트에 대한 BigQuery 데이터 뷰어(roles/bigquery.dataViewer) 역할

역할 부여 방법에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할 또는 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

프로젝트에 공개 데이터 세트 추가

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

   BigQuery로 이동

2. 왼쪽 창에서 탐색기를 클릭합니다.

   

   왼쪽 창이 표시되지 않으면 왼쪽 창 펼치기를 클릭하여 창을 엽니다.

3. 탐색기 창에서 데이터 추가를 클릭합니다.

4. 데이터 추가 창에서 공개 데이터 세트를 선택합니다.

5. Marketplace 창에서 NYC TLC Trips를 검색하고 NYC TLC Trips 결과를 클릭합니다.

6. 데이터 세트 보기를 클릭합니다.

이렇게 하면 공개 데이터 세트의 프로젝트가 탐색기 창에서 볼 수 있는 참조로 추가됩니다. 세부정보 창에는 데이터 세트 ID, 데이터 위치, 최종 수정 날짜와 같은 정보가 포함된 데이터 세트 정보가 표시됩니다.

프로젝트에서 데이터 세트 만들기

1. 왼쪽 창에서 탐색기를 클릭합니다.

   

2. 탐색기 창에서 데이터 세트를 만들 프로젝트를 선택합니다.

3. 작업을 클릭하고 데이터 세트 만들기를 클릭합니다.

4. 데이터 세트 만들기 페이지의 데이터 세트 ID 필드에 data_lineage_demo를 입력합니다. 다른 필드는 기본값 그대로 둡니다.

5. 데이터 세트 만들기를 클릭합니다.

6. 탐색기 창에서 데이터 세트를 클릭한 후 새로 추가된 data_lineage_demo를 클릭합니다.

세부정보 창에 데이터 세트 정보가 표시됩니다.

데이터 세트에 공개적으로 액세스할 수 있는 테이블 2개 복사

1. 쿼리 편집기를 엽니다. 세부정보 창에서 data_lineage_demo 탭 옆에 있는 (새 쿼리 작성)를 클릭합니다. 이 단계에서 Untitled 탭이 생성됩니다.

2. 쿼리 편집기에서 다음 쿼리를 입력하여 첫 번째 테이블을 복사합니다. PROJECT_ID를 프로젝트 식별자로 바꿉니다.

   CREATE TABLE `PROJECT_ID.data_lineage_demo.nyc_green_trips_2021`
   COPY `bigquery-public-data.new_york_taxi_trips.tlc_green_trips_2021`
   

3. 실행을 클릭합니다. 이 단계에서 nyc_green_trips_2021이라는 첫 번째 테이블이 생성됩니다.

4. 쿼리 결과 창에서 테이블로 이동을 클릭합니다. 이 단계에서 첫 번째 테이블의 콘텐츠가 표시됩니다.

5. 쿼리 편집기에서 이전 쿼리를 다음 쿼리로 교체하여 두 번째 테이블을 복사합니다. PROJECT_ID를 프로젝트 식별자로 바꿉니다.

   CREATE TABLE `PROJECT_ID.data_lineage_demo.nyc_green_trips_2022`
   COPY `bigquery-public-data.new_york_taxi_trips.tlc_green_trips_2022`
   

6. 실행을 클릭합니다. 이 단계에서 nyc_green_trips_2022라는 두 번째 테이블이 생성됩니다.

7. 쿼리 결과 창에서 테이블로 이동을 클릭합니다. 이 단계에서 두 번째 테이블의 콘텐츠가 표시됩니다.

새 테이블로 데이터 집계

1. 쿼리 편집기에서 다음 쿼리를 입력합니다. PROJECT_ID를 프로젝트 식별자로 바꿉니다.

   CREATE TABLE `PROJECT_ID.data_lineage_demo.total_green_trips_22_21`
   AS SELECT vendor_id, COUNT(*) AS number_of_trips
   FROM (
        SELECT vendor_id FROM `PROJECT_ID.data_lineage_demo.nyc_green_trips_2022`
        UNION ALL
        SELECT vendor_id FROM `PROJECT_ID.data_lineage_demo.nyc_green_trips_2021`
   )
   GROUP BY vendor_id
   

2. 실행을 클릭합니다. 이 단계에서 total_green_trips_22_21이라는 결합 테이블이 생성됩니다.

3. 쿼리 결과 창에서 테이블로 이동을 클릭합니다. 이 단계에서 결합된 테이블이 표시됩니다.

Dataplex Universal Catalog에서 계보 그래프 보기

1. Google Cloud 콘솔에서 Dataplex Universal Catalog 검색 페이지로 이동합니다.

   검색 페이지로 이동

2. 검색 플랫폼 선택에서 검색 모드로 Dataplex Universal Catalog를 선택합니다.

3. 검색 창에 total_green_trips_22_21을 입력하고 검색을 클릭합니다.

4. 결과 목록에서 total_green_trips_22_21을 클릭합니다. 이 단계에서 BigQuery 테이블 세부정보 탭이 표시됩니다.

5. 계보 탭을 클릭합니다.

참고: 자동 계보에서 이러한 변경사항을 선택하는 데 다소 시간이 걸릴 수 있습니다. 아직 계보 그래프가 표시되지 않으면 몇 분 후에 다시 확인하세요.



그림 1. 노드 세부정보가 포함된 데이터 계보

계보 그래프에서 각 직사각형 노드는 테이블, 즉 원본 테이블, 복사된 테이블 또는 결합된 테이블 중 하나를 나타냅니다. 다음을 수행하면 됩니다.

• 테이블 원본을 표시하거나 숨기려면 +(펼치기) 또는 -(접기)를 클릭합니다.

• 테이블 정보를 표시하려면 노드를 클릭합니다. 이 단계에서 노드 세부정보 창이 표시됩니다.

• 프로세스 정보를 표시하려면 를 클릭합니다. 이 단계에서 소스 테이블을 대상 테이블로 변환한 작업을 보여주는 프로세스 세부정보 창이 표시됩니다.



그림 2. 프로세스 세부정보가 포함된 데이터 계보

삭제

이 페이지에서 사용한 리소스에 대한 비용이 Google Cloud 계정에 청구되지 않게 하려면 다음 단계를 수행합니다.

프로젝트 삭제

주의: 프로젝트를 삭제하면 다음과 같은 결과가 발생합니다.

• 프로젝트의 모든 항목이 삭제됩니다. 이 문서의 작업에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
• 커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.

여러 아키텍처, 튜토리얼 또는 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

데이터 세트 삭제

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

   BigQuery로 이동

2. 왼쪽 창에서 탐색기를 클릭합니다.

   

3. 탐색기 창에서 생성된 data_lineage_demo 데이터 세트를 검색합니다.

4. 데이터 세트를 클릭한 후 삭제를 클릭합니다.

5. 삭제 작업을 확인합니다.

다음 단계

• 데이터 계보 자세히 알아보기
• BigQuery 쿼리를 실행하는 방법 알아보기
• 데이터 계보 사용 방법 알아보기
• Dataplex Universal Catalog 가격 책정 알아보기