BigQuery API 종속 항목 관리

이 문서에서는 BigQuery가 종속되는 Google Cloud 서비스 및 API를 설명합니다. 또한 이러한 서비스를 사용 중지할 때 BigQuery 동작에 미치는 영향을 설명합니다. 프로젝트에서 서비스를 사용 설정하거나 중지하기 전에 이 문서를 검토하세요.

일부 서비스는 생성하는 모든 Google Cloud 프로젝트에서 기본적으로 사용 설정됩니다. BigQuery를 사용하는 모든 프로젝트에는 다른 API가 자동으로 사용 설정됩니다. Google Cloud 나머지 서비스의 기능을 사용하려면 명시적으로 사용 설정해야 합니다. 자세한 내용은 다음 리소스를 참조하세요.

이 문서는 관리자를 대상으로 합니다.

기본적으로 사용 설정된 서비스

다음 서비스는 모든 새Google Cloud 프로젝트에 기본적으로 사용 설정됩니다.

서비스 이 기능을 사용하는 기능 이 서비스 사용 중지 시 영향
analyticshub.googleapis.com
  • 데이터 교환, 등록정보, 데이터 클린룸 또는 구독을 만들거나 관리할 수 없습니다.
  • 다른 제공업체가 만든 거래소 또는 등록정보를 검색하고 탐색할 수 없습니다.
  • 생성된 구독이 유지되지만 액세스할 수 없습니다.
  • BigQuery API가 사용 설정되어 있는 한 연결된 데이터 세트에 액세스할 수 있습니다.
  • 새 구독을 만들 수 없음
bigqueryconnection.googleapis.com
  • 외부 연결은 관리할 수 없습니다.
  • 원격 모델을 만들 수 없습니다.
  • 원격 함수를 만들 수 없습니다.
  • BigLake 테이블과 객체 테이블은 쿼리할 수 없습니다.
bigquerymigration.googleapis.com
  • 이전 태스크 또는 평가를 만들 수 없습니다.
  • 기존 과제 또는 평가를 사용할 수 없습니다.

참고: 일반적으로 데이터 이전을 완료한 후 이 서비스를 사용 중지할 수 있습니다.
bigquerydatapolicy.googleapis.com
  • 데이터 마스킹 정책을 관리할 수 없습니다.
  • 데이터 마스킹 정책은 삭제되지 않지만 데이터 마스킹이 적용된 테이블에 대한 쿼리가 실패합니다.
bigqueryreservation.googleapis.com
  • 용량 약정, 예약 또는 할당을 만들거나 관리할 수 없습니다.
  • 슬롯 사용량을 모니터링할 수 없습니다.
  • 재해 복구 장애 조치는 사용할 수 없습니다.
  • 슬롯 자동 확장이 중지됩니다.
bigquerystorage.googleapis.com
dataform.googleapis.com
  • 파이프라인, 저장된 쿼리, Colab 노트북, 데이터 캔버스, 데이터 준비 또는 Dataform 프로젝트를 만들 수 없습니다.
  • 기존의 예약된 파이프라인, 노트북 또는 Dataform 프로젝트가 중지됩니다.
  • 기존 파이프라인, 저장된 쿼리, Colab 노트북, 데이터 캔버스, 데이터 준비 또는 Dataform 프로젝트에 액세스할 수 없게 됩니다.
dataplex.googleapis.com
  • BigQuery 데이터 애셋 검색을 사용할 수 없습니다.
  • 등록정보 검색을 공유할 수 없습니다.
  • 새 프로필 통계, 데이터 품질 스캔 또는 검색어 추천을 만들거나 이전에 만든 항목에 액세스할 수 없습니다.
  • 계보 그래프에서는 데이터 애셋 세부정보를 볼 수 없습니다.
  • 데이터 캔버스에서는 데이터 애셋을 검색할 수 없습니다.

BigQuery Unified API에서 사용 설정된 서비스

BigQuery Unified API (bigqueryunified.googleapis.com)에는 다양한 BigQuery 기능이 작동하는 데 필요한 선별된 서비스 모음이 포함되어 있습니다. BigQuery Unified API를 사용 설정하면 이러한 모든 서비스가 동시에 활성화됩니다. Google은 이 컬렉션의 서비스를 업데이트할 수 있으며, 이러한 서비스는 이 API가 사용 설정된 프로젝트에서 자동으로 사용 설정됩니다. 개별 서비스와 API를 사용 중지할 수 있습니다.

bigqueryunified.googleapis.com 사용 설정에 관한 자세한 내용은 서비스 사용 설정 및 중지를 참고하세요.

서비스 이 기능을 사용하는 기능 이 서비스 사용 중지 시 영향
aiplatform.googleapis.com
  • 노트북을 실행할 수 없습니다.
  • 기존의 모든 BigQuery ML 원격 모델이 작동을 중지합니다.
  • 기존 노트북은 계속 액세스하여 수정할 수 있습니다.
bigqueryunified.googleapis.com
  • 이 문서에 나열된 BigQuery 종속 서비스(cloudaicompanion, composer, datalineage API 제외)를 원클릭으로 활성화합니다.
  • 프로젝트에서 새 BigQuery 종속 항목이 사용 설정되었는지 확인합니다.
  • 향후 종속 항목은 프로젝트에서 자동으로 사용 설정되지 않습니다.
compute.googleapis.com
  • Google Compute Engine은 Dataproc 및 Vertex AI에서 제공하는 모든 기능을 위한 런타임 환경을 제공합니다.
  • Colab 노트북, 원격 ML 모델, Apache Spark, SparkSQL, PySpark 작업이 중지됩니다.
  • 소스 코드는 계속 사용할 수 있습니다.
  • Dataproc API가 사용 중지됩니다.
dataproc.googleapis.com
  • 오픈소스 데이터 분석을 실행하기 위해 Dataproc 클러스터를 만들 수 없습니다.
  • Dataproc Serverless 워크로드를 실행할 수 없습니다.
  • BigQuery 워크로드에서는 Spark를 실행할 수 없습니다.
datastream.googleapis.com
  • 모든 데이터 스트림이 일시중지되어 액세스할 수 없습니다.

기본적으로 사용 중지된 서비스

해당 기능을 사용하려면 다음 서비스를 수동으로 사용 설정해야 합니다.

서비스 이 기능을 사용하는 기능 이 서비스 사용 중지 시 영향
cloudaicompanion.googleapis.com
  • BigQuery의 Gemini 기능
composer.googleapis.com
  • 기존 Cloud Composer DAG가 예약 페이지에 표시되지 않고 중지됩니다.
  • 기존 Cloud Composer 환경이 작동하지 않게 되고, 작동을 멈추며, 오류 상태를 반환합니다.
datalineage.googleapis.com
  • 프로젝트에 데이터 계보가 캡처되지 않았습니다.
  • 계보 그래프를 볼 수 없습니다.

BigQuery 코드 애셋 수동 사용 설정

BigQuery에서 노트북 및 저장된 쿼리와 같은 코드 애셋을 관리하려면 다음 API를 사용 설정해야 합니다.

  • Compute Engine API
  • Dataform API
  • Vertex AI API

2024년 3월 이전에는 이러한 API가 기본적으로 자동으로 사용 설정되지 않았습니다. 이러한 API의 상태에 따라 달라지는 2024년 3월 이전의 자동화 스크립트를 만든 경우 스크립트를 업데이트해야 할 수 있습니다. 이러한 API가 이미 사용 설정되어 있으면 BigQuery의 탐색기 창에 새 Notebooks 및 Queries 폴더가 표시됩니다.

시작하기 전에

코드 애셋 관리를 수동으로 사용 설정하려면 Identity and Access Management (IAM) 소유자 (roles/owner) 역할이 있어야 합니다.

BigQuery 코드 애셋 수동 사용 설정

코드 확장 애셋에 필요한 API 종속 항목을 사용 설정하려면 다음 단계를 따르세요.

  1. BigQuery 페이지로 이동합니다.

    BigQuery로 이동

  2. Studio의 편집기 창 탭 표시줄에서 + 기호 옆에 있는 화살표 드롭다운을 클릭하고 Notebook 위로 포인터를 가져간 다음 BigQuery 템플릿을 선택합니다.

  3. 편집기 창의 탭 표시줄 아래에 표시되는 배너에서 사용 설정을 클릭합니다.

    배너가 표시되지 않으면 필요한 IAM 소유자 역할이 있는지 확인합니다.

  4. 기능 사용 설정 창의 핵심 기능 API 섹션에서 다음을 실행합니다.

    1. 코드 애셋의 버전 기록 및 공유를 사용 설정하려면 버전 기록 및 공유 섹션에서 사용 설정을 클릭합니다.
    2. 노트북을 사용 설정하려면 Python 노트북에서 모두 사용 설정을 클릭합니다.
    3. API가 사용 설정되면 다음을 클릭합니다.

  5. (선택사항): 권한 섹션에서 사용자 권한을 설정합니다.

    • 주 구성원에게 코드 애셋을 만들고 생성한 코드 애셋을 읽고 수정하고 설정할 수 있는 권한을 부여하려면 크리에이터 필드에 사용자 또는 그룹 이름을 입력합니다.
    • 주 구성원에게 공유된 모든 코드 애셋을 읽고 수정하고 설정할 수 있는 권한을 부여하려면 소유자 필드에 사용자 또는 그룹 이름을 입력합니다.

  6. 다음을 클릭합니다.

  7. (선택사항): 추가 API 섹션에서 모두 사용 설정을 클릭하면, BigQuery DataFrames을 사용하여 BigQuery 원격 절차를 만드는 데 필요한 API를 사용 설정할 수 있습니다.

  8. 추가 API를 사용 설정하지 않으려면 닫기를 클릭하여 기능 사용 설정 창을 닫습니다.

코드 애셋에 대한 액세스 제한

리소스 서비스 사용량 제한 조직 정책 제약조건을 설정하여 추가 API의 사용 설정을 방지할 수 있습니다. 언제든지 선택한 API를 사용 중지할 수 있습니다.

다음 단계

  • 서비스를 관리하는 방법을 알아보려면 Google Cloud 서비스 사용 설정 및 중지를 참고하세요.
  • 조직 정책 제약조건을 사용하여 세부적인 수준에서 API 액세스를 관리하는 방법은 리소스 사용량 제한을 참고하세요.
  • BigQuery의 Identity and Access Management (IAM) 역할 및 권한으로 서비스에 대한 액세스를 제어하는 방법을 알아보려면 BigQuery IAM 역할 및 권한을 참고하세요.