노트북 관리

이 문서에서는 노트북을 보고, 비교하고, 복원하고, 삭제하는 방법을 비롯하여 BigQuery의 Colab Enterprise 노트북을 관리하는 방법을 설명합니다.

이 문서에서는 Dataplex에서 노트북 메타데이터를 보고 관리하는 방법도 설명합니다.

노트북은 Dataform으로 구동되는 BigQuery Studio 코드 애셋입니다.

시작하기 전에

1. 노트북 만들기
2. Dataplex에서 노트북 메타데이터를 관리하려면 Google Cloud 프로젝트에서 Dataplex API가 사용 설정되어 있는지 확인합니다.

필수 권한

노트북을 공유하려면 다음 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)

• 다음 역할 중 하나가 필요합니다.

  • 코드 소유자(roles/dataform.codeOwner)
  • 코드 편집자(roles/dataform.codeEditor)
  • 코드 뷰어(roles/dataform.codeViewer)

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

Dataplex에서 노트북 메타데이터를 관리하려면 필요한 Dataplex 역할이 있는지 확인합니다.

노트북에 대한 액세스 권한 부여

다른 사용자에게 노트북에 대한 액세스 권한을 부여하려면 해당 사용자를 적절한 IAM 역할에 추가하세요.

중요: 노트북에 액세스할 수 있는 사용자는 이 출력에 자신이 액세스할 수 없는 데이터가 포함되어 있더라도 노트북의 코드로 생성된 모든 출력을 볼 수 있습니다. 저장된 출력이 공유되지 않도록 하려면 노트북 출력 저장을 사용 중지합니다.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 액세스 권한을 부여할 노트북을 찾습니다.

3. 노트북 옆에 있는 작업 보기를 클릭한 후 공유 > 권한 관리를 클릭합니다.

4. 권한 관리 창에서 사용자/그룹 추가를 클릭합니다.

5. 새 주 구성원 필드에 주 구성원을 입력합니다.

6. 역할 목록에서 다음 역할 중 하나를 선택합니다.

   • 코드 소유자: 삭제 또는 공유를 포함하여 노트북에서 모든 작업을 수행할 수 있습니다.
   • 코드 편집자: 노트북을 수정할 수 있습니다.
   • 코드 뷰어: 노트북을 볼 수 있습니다.
   참고: 또한 주 구성원이 노트북을 실행하기 위해서는 노트북 런타임 사용자(roles/aiplatform.notebookRuntimeUser) 및 BigQuery 사용자(roles/bigquery.user) 역할이 있어야 합니다.

7. 선택사항: 역할 및 고급 공유 설정의 전체 목록을 보려면 고급 공유를 클릭합니다.

8. 저장을 클릭합니다.

9. 노트북 정보 페이지로 돌아가려면 닫기를 클릭합니다.

노트북 공유

노트북을 다른 사용자와 공유하려면 노트북 링크를 생성하여 공유하면 됩니다. 공유한 노트북을 다른 사용자가 볼 수 있으려면 먼저 노트북에 대한 액세스 권한을 부여해야 합니다.

노트북을 실행하려면 사용자에게 노트북이 액세스하는 데이터에 대한 액세스 권한이 있어야 합니다. 자세한 내용은 데이터 세트에 대한 액세스 권한 부여를 참조하세요.

중요: 노트북에 액세스할 수 있는 사용자는 이 출력에 자신이 액세스할 수 없는 데이터가 포함되어 있더라도 노트북의 코드로 생성된 모든 출력을 볼 수 있습니다. 저장된 출력이 공유되지 않도록 하려면 노트북 출력 저장을 사용 중지합니다.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 공유할 노트북을 찾습니다.

3. 노트북 옆에 있는 작업 보기를 클릭한 후 공유 > 링크 복사를 클릭합니다.

4. 다른 사용자와 링크를 공유합니다.

모든 노트북 보기

프로젝트의 모든 노트북 목록을 보려면 다음 안내를 따르세요.

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

   BigQuery로 이동

2. 탐색기 창에서 Notebooks 옆에 있는 작업 보기를 클릭한 후 다음 중 하나를 수행합니다.

• 현재 탭에서 목록을 열려면 모두 표시를 클릭합니다.
• 목록을 새 탭에서 열려면 모두 표시 > 새 탭을 클릭합니다.
• 분할 탭에서 목록을 열려면 모두 표시 > 분할 탭을 클릭합니다.

노트북 메타데이터 보기

노트북 메타데이터를 보려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 메타데이터를 보려는 노트북의 이름을 클릭합니다.

3. 요약 창에서 데이터에 사용되는 리전 및 마지막으로 수정된 날짜 등 노트북에 대한 정보를 확인합니다.

노트북 버전 사용

다음 섹션에서 노트북 버전을 보고 비교하고 복원하는 방법을 알아보세요.

노트북 버전 보기

노트북 버전을 보려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 활동을 보려는 노트북의 이름을 클릭합니다.

3. 활동 탭을 클릭하여 날짜 기준 내림차순으로 정렬된 노트북 버전 목록을 확인합니다.

노트북 버전 비교

노트북 버전을 비교하려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 버전 정보를 비교하려는 노트북의 이름을 클릭합니다.

3. 활동 탭에서 노트북 버전 옆에 있는 작업 보기를 클릭한 후 비교를 클릭합니다. 선택한 노트북 버전을 현재 노트북 버전과 비교하는 비교 창이 열립니다.

4. (선택사항): 별도의 창 대신 버전을 인라인 비교하려면 비교를 클릭한 다음 인라인을 클릭합니다.

5. (선택사항): 버전의 소스 코드를 비교하려면 비교를 클릭한 다음 원시 소스 표시를 클릭합니다.

6. (선택사항): 노트북에서 명령어 출력을 숨기려면 비교를 클릭한 다음 출력 표시를 선택 해제합니다.

노트북 버전 복원

다음 옵션 중 하나를 사용하여 노트북 버전을 복원합니다. 업데이트 기록 창에서 복원하면 이전 버전을 복원하기 전에 노트북의 현재 버전과 이전 버전을 비교할 수 있습니다. 노트북을 복원하면 현재 버전을 덮어쓰는 대신 새 버전의 노트북이 생성됩니다. 버전 기록은 손실되지 않습니다.

활동 창

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 이전 버전을 복원할 노트북의 이름을 클릭합니다.

3. 활동 창을 선택합니다.

4. 복원할 노트북 버전 옆에 있는 작업 보기를 클릭한 후 복원을 클릭합니다.

5. 확인을 클릭합니다.

비교 창

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 이전 버전을 복원할 노트북의 이름을 클릭합니다.

3. 활동 창을 선택합니다.

4. 노트북 버전 옆에 있는 작업 보기를 클릭한 후 비교를 클릭합니다. 선택한 노트북 버전을 가장 최근 노트북 버전과 비교하는 비교 창이 열립니다.

5. 비교한 후 이전 노트북 버전을 복원하려면 복원을 클릭합니다.

6. 확인을 클릭합니다.

노트북 다운로드

노트북을 다운로드하려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 다운로드할 노트북의 이름을 클릭합니다.

3. 다운로드를 클릭합니다.

노트북 삭제

노트북을 삭제하려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 탐색기 창에서 프로젝트와 Notebooks 폴더를 펼치고 필요한 경우 공유 노트북 폴더를 펼칩니다. 삭제할 노트북을 찾습니다.

3. 노트북 옆에 있는 작업 보기를 클릭한 후 삭제를 클릭합니다.

4. 삭제를 확인하려면 대화상자에 delete를 입력합니다.

5. 삭제를 클릭합니다.

Dataplex에서 메타데이터 관리

Dataplex를 사용하면 노트북의 메타데이터를 저장하고 관리할 수 있습니다. 노트북은 추가 구성 없이 기본적으로 Dataplex에서 사용할 수 있습니다.

Dataplex를 사용하여 모든 BigQuery 위치에서 노트북을 관리할 수 있습니다. Dataplex에서 노트북을 관리할 때는 Dataplex 할당량 및 한도 및 Dataplex 가격 책정이 적용됩니다.

Dataplex는 다음 메타데이터를 노트북에서 자동으로 가져옵니다.

• 데이터 애셋 이름
• 데이터 애셋 상위 요소
• 데이터 애셋 위치
• 데이터 애셋 유형
• 해당 Google Cloud 프로젝트

Dataplex는 노트북을 다음과 같은 항목 값으로 항목으로 로깅합니다.

시스템 항목 그룹

노트북의 시스템 항목 그룹은 @dataform입니다. Dataplex에서 노트북 항목의 세부정보를 보려면 dataform 시스템 항목 그룹을 확인해야 합니다. 항목 그룹의 모든 항목 목록을 보는 방법에 관한 안내는 Dataplex 문서의 항목 그룹 세부정보 보기를 참고하세요.

시스템 항목 유형

노트북의 시스템 항목 유형은 dataform-code-asset입니다. 노트북 세부정보를 보려면 dataform-code-asset 시스템 항목 유형을 확인하고, 측정기준 기반 필터로 결과를 필터링하고, dataform-code-asset 측정기준 내의 type 필드를 NOTEBOOK로 설정해야 합니다. 그런 다음 선택한 노트북의 항목을 선택합니다. 선택한 항목 유형의 세부정보를 보는 방법에 관한 안내는 Dataplex 문서의 항목 유형의 세부정보 보기를 참고하세요. 선택한 항목의 세부정보를 보는 방법에 관한 안내는 Dataplex 문서의 항목 세부정보 보기를 참고하세요.

시스템 관점 유형

노트북의 시스템 측면 유형은 dataform-code-asset입니다. 관점으로 노트북 항목에 주석을 추가하여 Dataplex의 노트북에 추가 컨텍스트를 제공하려면 dataform-code-asset 관점 유형을 확인하고, 관점 기반 필터로 결과를 필터링하고, dataform-code-asset 관점 내의 type 필드를 NOTEBOOK로 설정합니다. 관점으로 항목에 주석을 추가하는 방법에 관한 안내는 Dataplex 문서의 관점 관리 및 메타데이터 보강을 참고하세요.

유형

데이터 캔버스의 유형은 NOTEBOOK입니다. 이 유형을 사용하면 측정기준 기반 필터에서 aspect:dataplex-types.global.dataform-code-asset.type=NOTEBOOK 쿼리를 사용하여 dataform-code-asset 시스템 항목 유형 및 dataform-code-asset 측정기준 유형의 노트북을 필터링할 수 있습니다.

Dataplex에서 애셋을 검색하는 방법에 관한 안내는 Dataplex 문서의 Dataplex에서 데이터 애셋 검색을 참고하세요.

문제 해결

자세한 내용은 Colab Enterprise 문제 해결을 참고하세요.

다음 단계

• BigQuery의 Colab Enterprise 노트북 자세히 알아보기
• 노트북을 만드는 방법 알아보기
• 노트북을 조정하는 방법을 알아보세요.