BigQuery 및 데이터 스튜디오에서 Colab 데이터 앱 사용

Colab 데이터 앱을 사용하면 Colab 노트북의 데이터 분석을 세련된 대화형 애플리케이션으로 변환할 수 있습니다. 이제 코드 또는 정적 보고서를 공유하는 대신 대화형 시각화, 데이터 테이블, 머신러닝 추론을 포함하는 공유 가능한 환경을 구축할 수 있습니다.

Colab 데이터 앱은 다음을 제공합니다.

셀프서비스 통계: 비즈니스 사용자는 코드 수정 없이 날짜 범위 또는 필터와 같은 매개변수를 조정하여 필요한 데이터를 볼 수 있습니다.
앱 뷰어 설정 없음: 소비자는 URL을 사용하여 앱에 액세스합니다. 콘솔을 탐색하거나 노트북을 실행할 필요가 없습니다. Google Cloud
유연성: Python 시각화 라이브러리 또는 위젯을 통합하여 맞춤설정된 복잡한 데이터 앱을 손쉽게 빌드할 수 있습니다. 시간을 절약하려면 통합 에이전트를 사용하여 코드를 생성하세요.
관리형 수명 주기: 관리자와 작성자는 공유, 버전, 리소스 사용량을 계속 제어할 수 있습니다.

시작하기 전에

계정에 로그인합니다. Google Cloud 를 처음 사용하는 경우 Google Cloud, 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

BigQuery, Dataform API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기.
API 사용 설정

새 프로젝트에서는 BigQuery API가 자동으로 사용 설정됩니다.

필요한 역할

데이터 앱을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

BigQuery 읽기 세션 사용자 (roles/bigquery.readSessionUser)
BigQuery Studio 사용자 (roles/bigquery.studioUser)

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

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

BigQuery의 Colab Enterprise를 처음 사용하는 경우 노트북 만들기 페이지의 필수 권한을 참조하세요.

제한사항

Colab 데이터 앱에는 다음 제한사항이 적용됩니다.

앱을 처음 열면 복잡성에 따라 로드하는 데 2~5분이 걸릴 수 있습니다.
대화형 세션은 30분 동안 지속됩니다. 30분이 지나면 앱이 커널과의 연결이 끊어지고 정적이 됩니다. 새 30분 세션을 시작하려면 페이지를 새로고침하거나 데이터를 새로고침하면 됩니다.
앱에 표시되는 셀과 관계없이 모든 셀이 처음부터 마지막까지 순서대로 실행됩니다. 표시되지 않는 셀이 실행되고 커널 리소스를 사용 중인 경우 커널 리소스가 해제될 때까지 앱이 응답하지 않는 것처럼 보일 수 있습니다.
데이터 액세스 또는 데이터 앱을 보는 데 서비스 계정 또는 최종 사용자 인증 정보 (EUC)를 사용할 수 없습니다.

데이터 앱의 구성요소

데이터 앱에 추가할 수 있는 구성요소는 기본 노트북에서 파생됩니다. 기존 노트북으로 작업하는 경우 기존 셀을 데이터 앱에 추가할 수 있습니다.

SQL 셀, 코드 셀, 텍스트 셀, 시각화 셀을 비롯하여 Colab 노트북에서 만들 수 있는 지원되는 셀 유형을 데이터 앱에 추가할 수 있습니다. 셀 유형을 수동으로 만들거나 Colab 데이터 과학 에이전트 또는 Gemini 를 사용하여 셀을 생성할 수 있습니다.

노트북에 다양한 셀 유형을 추가하는 방법은 다음 튜토리얼을 참고하세요.

서드 파티 라이브러리를 사용하여 컨트롤 만들기

데이터 앱은 서드 파티 위젯 라이브러리를 사용하여 만든 컨트롤을 지원합니다. 예를 들면 다음과 같습니다.

iPywidgets 또는 AnyWidget을 사용하여 노트북에 대화형 컨트롤을 추가할 수 있습니다. 위젯은 Colab 데이터 과학 에이전트를 사용하여 생성할 수 있습니다.
노트북 수준에서 위젯 셀을 연결할 수 있습니다. 노트북 시작 시 위젯을 정의하고 시각화 셀과 같은 다른 셀에서 위젯의 출력을 사용할 수 있습니다. 이를 통해 데이터 앱의 전역 필터를 설정할 수 있습니다.

데이터 앱 만들기 및 게시

기존 노트북을 사용하거나 새 노트북을 만들어 Colab 데이터 앱을 만들 수 있습니다. 다음 예에서는 Python 사용자를 위한 노트북 시작하기 템플릿을 사용하여 노트북을 생성하고 노트북에서 데이터 앱을 만듭니다.

데이터 앱을 만든 후 데이터 스튜디오에 게시하여 데이터 분석을 공유 가능한 대화형 환경으로 전환합니다.

데이터 앱을 게시할 때 기존 Colab 런타임에 연결하거나 템플릿을 사용하여 새 런타임을 만들 수 있습니다. 템플릿을 사용하면 워크로드에 따라 런타임 크기를 조정하고 유휴 종료 시간을 설정하여 비용과 앱 시작 시간의 균형을 맞출 수 있습니다.

데이터 앱을 만들고 게시하려면 다음 단계를 따르세요.

Studio 페이지로 이동합니다.

Studio로 이동
arrow drop-down 화살표 드롭다운을 클릭한 후 노트북 > 모든 템플릿을 선택합니다.
또는 BigQuery Studio 홈페이지에서 노트북 갤러리 보기 를 클릭합니다.
Python 사용자를 위한 노트북 시작하기 카드를 클릭하거나 갤러리에서 검색합니다.
템플릿이 열리면 이 템플릿 사용 을 클릭하여 템플릿을 실행 가능한 노트북으로 변환합니다.
대시보드 데이터 앱을 클릭합니다.
구성요소 창에서 체크박스를 사용하여 앱에서 셀을 추가하고 삭제할 수 있습니다.
새 구성요소를 만들려면 keyboard_backspace 노트북 을 클릭하여 노트북으로 돌아간 후 새 셀을 추가합니다.
앱의 레이아웃이 만족스러우면 게시 를 클릭합니다.
게시 페이지에서 다음을 입력합니다.
1. 이름 필드에 앱 이름을 입력합니다. 앱 이름은 앱을 만드는 데 사용된 노트북의 이름과 같을 필요가 없습니다.
2. 런타임 필드에서 기존 런타임에 연결 을 선택하고 런타임을 선택하거나 새 런타임 만들기 를 선택하고 적절한 템플릿을 선택합니다.
  
  기존 런타임에 연결을 선택하는 경우 앱을 게시하기 전에 노트북이 런타임에 연결되어 있어야 합니다.
3. 게시 를 클릭합니다.
4. 데이터 스튜디오에 Google 계정 액세스 권한을 부여하라는 메시지가 표시되면 허용 을 클릭합니다.
소스 노트북과 앱을 변경하는 경우 변경사항 게시 를 클릭하여 앱을 업데이트할 수 있습니다.
또는 데이터 스튜디오에서 more_vert 옵션 더보기 > 수정을 클릭하여 앱을 수정할 수 있습니다.

그러면 BigQuery Studio에서 소스 노트북이 열립니다.

데이터 스튜디오를 사용하여 Colab 데이터 앱을 보고 다른 사용자와 앱을 공유합니다.

앱을 볼 때 대화형 기능은 포함된 구성요소를 기반으로 합니다. 예를 들어 Matplotlib 차트는 정적이고 Colab 시각화 셀 또는 Plotly와 같은 라이브러리를 사용하여 만든 차트는 대화형입니다.

코드에 정의된 위젯과 상호작용하고 필터링 또는 출력 변경과 같은 작업에 사용할 수 있습니다. 이러한 상호작용은 사용자별로 적용할 수 있습니다.

데이터 스튜디오에서 앱을 보고 공유하려면 다음 단계를 따르세요.

데이터 스튜디오에서 앱을 보려면 데이터 앱 보기 를 클릭합니다.
앱을 공유하려면 데이터 스튜디오에서 person_add 공유를 클릭합니다.
사용자 및 그룹과 공유 페이지에서 다음을 수행합니다.
1. 사용자 및 그룹 추가 필드에 액세스 권한을 부여할 그룹과 개인을 입력합니다.
2. 지정한 사용자 및 그룹에 대한 액세스 권한 을 선택합니다.
  - 편집자: 사용자는 앱을 수정하고, 일정 및 알림을 만들고 수정하며, 다른 사용자와 앱을 공유할 수 있습니다.
  - 뷰어: 사용자는 앱을 볼 수 있지만 수정하거나 다른 사용자와 공유할 수는 없습니다.
3. 보내기 를 클릭합니다.
다른 사용자를 초대하거나, 보고서 링크를 가져오거나, 앱을 공유 또는 다운로드하려면 공유 옵션 옆에 있는 arrow_drop_down을 클릭한 후 다음 중 하나를 선택합니다.
- 초대하기
- 보고서 링크 가져오기
- 보고서 다운로드

데이터 스튜디오에서 애셋을 공유하는 방법에 대한 자세한 내용은 보고서에 다른 사용자 초대하기를 참고하세요.

데이터 앱 다시 연결 및 새로고침

대화형 세션은 30분 동안 지속됩니다. 30분이 지나면 앱이 커널과의 연결이 끊어지고 정적이 됩니다. 새 30분 세션을 시작하려면 페이지를 새로고침하거나 데이터를 새로고침하면 됩니다.

데이터를 새로고침하려면 다음 단계를 따르세요.

데이터 스튜디오에서 앱을 엽니다. 앱이 열린 상태에서 데이터 앱 보기 를 클릭합니다.
데이터 스튜디오에서 more_vert 보고서 작업 더보기 > 데이터 새로고침을 클릭합니다.

데이터 앱에서 셀을 실행하는 데 사용되는 사용자 인증 정보

기본적으로 데이터 앱은 데이터 액세스 및 시각화 렌더링에 앱 작성자의 사용자 인증 정보를 사용합니다. 모든 뷰어는 작성자의 액세스 권한을 기반으로 렌더링된 데이터 앱을 봅니다. 민감한 정보에 액세스할 수 있는 데이터 앱을 공유하기 전에 이 점을 고려하세요.

데이터 앱 삭제

데이터 스튜디오를 사용하여 데이터 앱을 삭제할 수 있습니다. 앱을 만드는 데 사용된 노트북을 삭제해도 앱이 삭제되거나 앱이 작동하지 않게 되지는 않습니다.

데이터 스튜디오에서 데이터 앱을 삭제하려면 다음 단계를 따르세요.

데이터 스튜디오에 로그인합니다.
최근 페이지에서 앱을 찾습니다.
행 끝에 있는 more_vert 옵션 더보기 > 삭제를 클릭합니다.

가격 책정

노트북의 런타임에서 코드를 실행하고 사용한 BigQuery 슬롯에 대해 요금이 청구됩니다. 자세한 내용은 Colab Enterprise 가격 책정을 참조하세요.