노트북 관리
이 문서에서는 노트북을 보고, 비교하고, 복원하고, 예약하고, 삭제하는 방법을 비롯하여 BigQuery의 Colab Enterprise 노트북을 관리하는 방법을 설명합니다.
노트북은 Dataform으로 구동되는 BigQuery Studio 코드 애셋입니다.
노트북을 사용하려면 먼저 애셋 관리에 BigQuery Studio 사용 설정을 수행해야 합니다.
필수 권한
노트북을 공유하려면 다음 Identity and Access Management(IAM) 역할이 필요합니다.
- BigQuery 작업 사용자(
roles/bigquery.jobUser) - BigQuery 읽기 세션 사용자(
roles/bigquery.readSessionUser) - 리소스 수준의 코드 소유자(
roles/dataform.codeOwner)
노트북을 저장하고 삭제하려면 다음 IAM 역할이 필요합니다.
- BigQuery 작업 사용자(
roles/bigquery.jobUser) - BigQuery 읽기 세션 사용자(
roles/bigquery.readSessionUser) - 코드 소유자(
roles/dataform.codeOwner) 또는 코드 편집자(roles/dataform.codeEditor)
노트북 버전을 사용하여 작업하려면 다음 IAM 역할이 필요합니다.
- BigQuery 작업 사용자(
roles/bigquery.jobUser) - BigQuery 읽기 세션 사용자(
roles/bigquery.readSessionUser) 다음 역할 중 하나가 필요합니다.
노트북 일정(미리보기)을 만들려면 다음 역할이 필요합니다.
- Dataform 관리자(
roles/dataform.admin) - BigQuery 읽기 세션 사용자(
roles/bigquery.readSessionUser) 또는 BigQuery Studio 사용자(roles/bigquery.studioUser)
노트북 일정(미리보기)을 수정하려면 Dataform 편집자(roles/dataform.editor) 역할이 필요합니다.
노트북 일정(미리보기)을 보려면 Dataform 뷰어 (roles/dataform.viewer) 역할이 필요합니다.
BigQuery IAM에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.
노트북에 대한 액세스 권한 부여
다른 사용자에게 노트북에 대한 액세스 권한을 부여하려면 해당 사용자를 적절한 IAM 역할에 추가하세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 액세스 권한을 부여할 노트북을 찾습니다.
노트북 옆에 있는 작업 보기를 클릭한 후 공유 > 권한 관리를 클릭합니다.
권한 관리 창에서 사용자/그룹 추가를 클릭합니다.
새 주 구성원 필드에 주 구성원을 입력합니다.
역할 목록에서 다음 역할 중 하나를 선택합니다.
선택사항: 역할 및 고급 공유 설정의 전체 목록을 보려면 고급 공유를 클릭합니다.
저장을 클릭합니다.
노트북 정보 페이지로 돌아가려면 닫기를 클릭합니다.
노트북 공유
노트북을 다른 사용자와 공유하려면 노트북 링크를 생성하여 공유하면 됩니다. 공유한 노트북을 다른 사용자가 볼 수 있으려면 먼저 노트북에 대한 액세스 권한을 부여해야 합니다.
노트북을 실행하려면 사용자에게 노트북이 액세스하는 데이터에 대한 액세스 권한이 있어야 합니다. 자세한 내용은 데이터 세트에 대한 액세스 권한 부여를 참조하세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 공유할 노트북을 찾습니다.
노트북 옆에 있는 작업 보기를 클릭한 후 공유 > 링크 복사를 클릭합니다.
다른 사용자와 링크를 공유합니다.
모든 노트북 보기
프로젝트의 모든 노트북 목록을 보려면 다음 안내를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 Notebooks 옆에 있는 작업 보기를 클릭한 후 다음 중 하나를 수행합니다.
- 현재 탭에서 목록을 열려면 모두 표시를 클릭합니다.
- 목록을 새 탭에서 열려면 모두 표시 > 새 탭을 클릭합니다.
- 분할 탭에서 목록을 열려면 모두 표시 > 분할 탭을 클릭합니다.
노트북 메타데이터 보기
노트북 메타데이터를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 메타데이터를 보려는 노트북의 이름을 클릭합니다.
요약 창에서 데이터에 사용되는 리전 및 마지막으로 수정된 날짜 등 노트북에 대한 정보를 확인합니다.
노트북 버전으로 작업하기
다음 섹션에서 노트북 버전을 보고 비교하고 복원하는 방법을 알아보세요.
노트북 버전 보기
노트북 버전을 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 활동을 보려는 노트북의 이름을 클릭합니다.
활동 탭을 클릭하여 날짜 기준 내림차순으로 정렬된 노트북 버전 목록을 확인합니다.
노트북 버전 비교
노트북 버전을 비교하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 버전 정보를 비교할 노트북의 이름을 클릭합니다.
활동 탭에서 노트북 버전 옆에 있는 작업 보기를 클릭한 후 비교를 클릭합니다.
업데이트 기록 창에서 버전 드롭다운을 사용하여 비교할 버전을 선택합니다.
(선택사항): 노트북 소스 코드를 비교하려면 원시 소스 체크박스를 선택합니다.
(선택사항): 별도의 창 대신 버전 인라인을 비교하려면 인라인 비교 체크박스를 선택합니다.
(선택사항): 노트북에서 명령어 결과를 숨기려면 출력 표시 체크박스를 선택 취소합니다.
노트북 버전 복원
다음 옵션 중 하나를 사용하여 노트북 버전을 복원합니다. 업데이트 기록 창에서 복원하면 이전 버전을 복원하기 전에 노트북의 현재 버전과 이전 버전을 비교할 수 있습니다. 노트북을 복원하면 현재 버전을 덮어쓰는 대신 새 버전의 노트북이 생성됩니다. 버전 기록은 손실되지 않습니다.
활동 창
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 이전 버전을 복원할 노트북의 이름을 클릭합니다.
활동 창을 선택합니다.
복원할 노트북 버전 옆에 있는 작업 보기를 클릭한 후 복원을 클릭합니다.
확인을 클릭합니다.
버전 기록
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 이전 버전을 복원할 노트북의 이름을 클릭합니다.
활동 창을 선택합니다.
노트북 버전 옆에 있는 작업 보기를 클릭한 후 비교를 클릭합니다.
업데이트 기록 창에서 버전 드롭다운 옆에 있는 작업 보기를 클릭한 후 버전 복원을 클릭합니다.
확인을 클릭합니다.
노트북 다운로드
노트북을 다운로드하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 다운로드할 노트북의 이름을 클릭합니다.
다운로드를 클릭합니다.
노트북 예약
노트북 예약에 관한 의견을 보내려면 bigquery-notebooks-scheduling-support@google.com으로 이메일을 보내세요.
예를 들어 ML 모델을 학습시키거나, 외부 API를 호출하거나, BigQuery DataFrames 코드를 실행하기 위해 지정된 시간과 빈도로 자동으로 실행되도록 노트북을 예약할 수 있습니다.
노트북에 대한 변경사항은 자동으로 저장되지만 자신과 노트북에 액세스할 수 있는 사용자만 이용할 수 있습니다. 새 버전의 노트북으로 일정을 업데이트하려면 노트북을 배포해야 합니다. 노트북을 배포하면 현재 버전의 노트북으로 일정이 업데이트됩니다. 일정은 배포된 최신 버전의 노트북을 실행합니다.
각 노트북 일정은 일정 생성 중에 선택하는 커스텀 Dataform 서비스 계정에 의해 실행됩니다. Dataform의 서비스 계정 유형에 관한 자세한 내용은 Dataform의 서비스 계정 정보를 참조하세요.
Dataform은 예약된 노트북 실행의 출력을 예약 생성 중에 선택한 Cloud Storage 버킷에 씁니다.
노트북 일정은 표준 E2 런타임을 사용합니다. 런타임에 대한 Colab Enterprise 요금이 청구됩니다. E2 머신 유형에 따라 런타임 처리 요금이 청구됩니다. 표준 E2 런타임의 가격 책정에 관한 자세한 내용은 Colab Enterprise 가격 책정을 참조하세요.
노트북 예약 사용 설정
노트북을 예약하려면 노트북 예약에 사용할 커스텀 Dataform 서비스 계정에 다음 역할을 부여해야 합니다.
- 노트북 실행자 사용자(
roles/aiplatform.notebookExecutorUser) - 프로젝트에 대한 단일 역할 부여에 따라 선택한 프로젝트의 커스텀 Dataform 서비스 계정에 노트북 실행자 사용자 역할을 부여합니다.
- 스토리지 관리자(
roles/storage.admin) - 버킷 수준 정책에 주 구성원 추가에 따라 예약된 노트북 실행의 출력을 저장하는 데 사용할 Cloud Storage 버킷에 커스텀 Dataform 서비스 계정을 주 구성원으로 추가하고 이 주 구성원에게 스토리지 관리자 역할을 부여합니다.
- 서비스 계정 사용자(
roles/iam.serviceAccountUser) - 서비스 계정에 단일 역할 부여에 따라 커스텀 Dataform 서비스 계정을 자체 주 구성원으로 추가합니다. 즉, 동일한 커스텀 Dataform 서비스 계정에 커스텀 Dataform 서비스 계정을 주 구성원으로 추가합니다. 그런 다음 이 주 구성원에게 서비스 계정 사용자 역할을 부여합니다.
또한 기본 Dataform 서비스 계정에 다음 역할을 부여해야 합니다.
- 서비스 계정 토큰 생성자(
roles/iam.serviceAccountTokenCreator) - 커스텀 Dataform 서비스 계정에 토큰 생성 액세스 권한 부여에 따라 기본 Dataform 서비스 계정을 커스텀 Dataform 서비스 계정에 주 구성원으로 추가하고 이 주 구성원에게 서비스 계정 토큰 생성자 역할을 부여합니다.
Dataform의 서비스 계정에 대한 자세한 내용은 Dataform의 서비스 계정 정보를 참조하세요.
일정 만들기
노트북을 예약하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 예약할 노트북의 이름을 클릭합니다.
일정을 클릭합니다.
노트북 예약 창의 일정 이름 필드에 일정의 이름을 입력합니다.
런타임 템플릿 필드에서 런타임을 선택합니다.
서비스 계정 필드에서 커스텀 Dataform 서비스 계정을 선택합니다.
Cloud Storage 버킷 필드에서 찾아보기를 클릭하고 Cloud Storage 버킷을 선택하거나 만듭니다.
선택한 커스텀 Dataform 서비스 계정에 선택한 버킷의 스토리지 관리자 IAM 역할이 부여되어야 합니다. 자세한 내용은 노트북 예약 사용 설정을 참조하세요.
일정 빈도 섹션에서 다음을 수행합니다.
- 반복 드롭다운에서 예약된 노트북 실행 빈도를 선택합니다.
- 시간 필드에 예약된 노트북 실행 시간을 입력합니다.
- 시간대 드롭다운에서 일정의 시간대를 선택합니다.
일정 만들기를 클릭합니다.
일정을 만들면 현재 버전의 노트북이 자동으로 배포됩니다. 새 버전의 노트북으로 일정을 업데이트하려면 노트북을 배포합니다.
노트북의 최신 배포 버전이 선택된 시간과 빈도로 실행됩니다.
노트북 배포
노트북을 배포하면 현재 버전의 노트북으로 일정이 업데이트됩니다. 일정은 배포된 최신 버전의 노트북을 실행합니다.
노트북을 배포하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 선택한 노트북의 이름을 클릭합니다.
배포를 클릭합니다.
해당 일정이 노트북의 현재 버전으로 업데이트됩니다. 노트북의 최신 배포 버전이 예약된 시간에 실행됩니다.
일정 세부정보 보기
선택한 노트북의 일정 세부정보를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 선택한 노트북의 이름을 클릭합니다.
일정 보기를 클릭합니다.
이전 실행 보기
선택한 노트북 일정의 이전 실행을 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 선택한 노트북의 이름을 클릭합니다.
일정 보기를 클릭한 다음 이전 실행 보기를 클릭합니다.
일정 사용 중지
일정을 삭제하지 않고 선택한 노트북의 예약된 실행을 일시중지하려면 일정을 사용 중지하면 됩니다.
선택한 노트북의 일정을 사용 중지하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 선택한 노트북의 이름을 클릭합니다.
일정 보기를 클릭합니다.
일정 세부정보 테이블의 일정 상태 행에서 일정 사용 설정됨 전환 버튼을 클릭합니다.
일정 사용 설정
사용 중지된 일정의 예약된 실행을 재개하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 선택한 노트북의 이름을 클릭합니다.
일정 보기를 클릭합니다.
일정 세부정보 테이블의 일정 상태 행에서 일정 사용 중지됨 전환 버튼을 클릭합니다.
일정 수정
일정을 수정하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 선택한 노트북의 이름을 클릭합니다.
일정 보기를 클릭한 다음 수정을 클릭합니다.
노트북 예약 대화상자에서 일정을 수정한 다음 일정 업데이트를 클릭합니다.
모든 일정 보기
프로젝트의 모든 노트북 일정을 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 조정 페이지로 이동합니다.
선택사항: 일정 및 이전 실행에 대한 세부정보를 보려면 일정의 이름을 클릭합니다.
일정 삭제
선택한 노트북의 일정을 영구적으로 삭제하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 조정 페이지로 이동합니다.
모든 일정 목록에서 삭제하려는 일정이 포함된 행을 선택합니다.
선택사항: 여러 일정을 한 번에 삭제하려면 여러 행을 선택합니다.
삭제를 클릭합니다.
대화상자가 표시되면 삭제를 클릭합니다.
노트북 삭제
노트북을 삭제하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.
탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 삭제할 노트북을 찾습니다.
노트북 옆에 있는 작업 보기를 클릭한 후 삭제를 클릭합니다.
삭제를 확인하려면 대화상자에
delete를 입력합니다.삭제를 클릭합니다.
문제 해결
자세한 내용은 Colab Enterprise 문제 해결을 참조하세요.
다음 단계
- BigQuery의 Colab Enterprise 노트북 자세히 알아보기
- 노트북을 만드는 방법 알아보기