저장된 쿼리 소개

BigQuery에서 저장된 쿼리를 사용하여 SQL 스크립트를 안전하게 저장, 관리, 공동작업할 수 있습니다. 쿼리 편집기에서 작업하는 동안 변경사항이 자동으로 저장되므로 실수로 작업 내용을 잃지 않습니다.

저장된 쿼리는 Dataform으로 구동되는 BigQuery Studio 코드 애셋이므로 고급 공동작업 및 버전 제어 기능을 제공합니다. 다음과 같은 작업을 할 수 있습니다.

  • 안전한 공동작업: Identity and Access Management (IAM)를 사용하여 특정 사용자 및 그룹과 저장된 쿼리를 공유합니다.
  • 변경사항 추적: 쿼리 편집기 수정사항의 자세한 버전 기록을 검토합니다.
  • 버전 관리: 이전 버전의 쿼리에서 브랜치를 만들거나 이전 버전으로 되돌려 수정사항을 안전하게 테스트합니다.

저장된 쿼리 기능은 Google Cloud 콘솔에서만 사용할 수 있습니다.

저장된 쿼리 보안

Identity and Access Management(IAM) 역할을 사용하여 저장된 쿼리에 대한 액세스를 제어합니다. 자세한 내용은 저장된 쿼리 공유 및 저장된 쿼리의 보안 고려사항을 참조하세요.

지원되는 리전

저장된 모든 쿼리는 기본 리전에 저장됩니다. 기본 리전을 업데이트하면 해당 시점 이후에 생성된 모든 쿼리의 위치가 변경됩니다. 다음 표에는 BigQuery Studio를 사용할 수 있는 리전이 나와 있습니다.

리전 설명 리전 이름 세부정보
아프리카
요하네스버그 africa-south1
미주
콜럼버스 us-east5
댈러스 us-south1 잎 아이콘 낮은 CO2
아이오와 us-central1 잎 아이콘 낮은 CO2
로스앤젤레스 us-west2
라스베이거스 us-west4
몬트리올 northamerica-northeast1 잎 아이콘 낮은 CO2
북 버지니아 us-east4
오리건 us-west1 잎 아이콘 낮은 CO2
상파울루 southamerica-east1 잎 아이콘 낮은 CO2
사우스캐롤라이나 us-east1
아시아 태평양
홍콩 asia-east2
자카르타 asia-southeast2
뭄바이 asia-south1
서울 asia-northeast3
싱가포르 asia-southeast1
시드니 australia-southeast1
타이완 asia-east1
도쿄 asia-northeast1
유럽
벨기에 europe-west1 잎 아이콘 낮은 CO2
핀란드 europe-north1 잎 아이콘 낮은 CO2
프랑크푸르트 europe-west3
런던 europe-west2 잎 아이콘 낮은 CO2
마드리드 europe-southwest1 잎 아이콘 낮은 CO2
밀라노 europe-west8 잎 아이콘 낮은 CO2
네덜란드 europe-west4 잎 아이콘 낮은 CO2
토리노 europe-west12 잎 아이콘 낮은 CO2
바르샤바 europe-central2 잎 아이콘 낮은 CO2
취리히 europe-west6 잎 아이콘 낮은 CO2
중동
담맘 me-central2
도하 me-central1
텔아비브 me-west1

할당량 및 한도

자세한 내용은 저장된 쿼리 할당량 및 한도를 참조하세요.

제한사항

저장된 쿼리에는 다음과 같은 제한사항이 있습니다.

기존 저장된 쿼리 (지원 중단됨)

기존 저장된 쿼리가 완전히 지원 중단된 후 수정하려면 BigQuery Studio로 마이그레이션해야 합니다.

기존 저장된 쿼리는 SQL을 저장하고 공유하는 이전 방법입니다. BigQuery Studio 저장된 쿼리와 달리 쿼리 텍스트와 SQL 버전 (legacy SQL 또는 GoogleSQL)만 유지합니다.

Google Cloud 콘솔에서 탐색기 창의 (기존) 쿼리 폴더에 표시됩니다. (BigQuery Studio를 사용 설정하지 않은 경우 기존 탐색기 창의 저장된 쿼리 (NUMBER) 폴더에 표시됩니다.)

저장된 기본 쿼리의 유형은 3가지입니다.

  • 개인 (): 만든 사용자에게만 표시됩니다.

    • 참고: 개인 쿼리에 민감한 정보가 포함된 경우 마이그레이션 전에 쿼리를 삭제하거나 민감한 정보를 삭제해야 합니다.

  • 프로젝트 수준 (): 필수 권한이 있는 모든 주 구성원에게 표시됩니다.

  • 공개 (): 쿼리 링크가 있는 모든 사용자에게 표시됩니다.

마이그레이션 및 액세스를 위한 IAM 역할

다음 사전 정의된 BigQuery IAM 역할에는 BigQuery Studio 저장된 쿼리로 전환하는 데 필요한 Dataform 권한이 포함되어 있습니다.

  • BigQuery 관리자(roles/bigquery.admin)에는 roles/dataform.admin 권한이 포함됩니다.
  • BigQuery 작업 사용자(roles/bigquery.jobUser) 및 BigQuery 사용자(roles/bigquery.user)에는 다음이 포함됩니다.
    • dataform.locations.get
    • dataform.locations.list
    • dataform.repositories.create
    • dataform.repositories.list

이러한 사전 정의된 역할이 없으면 필요한 권한을 요청합니다. 커스텀 역할은 자동으로 업데이트되지 않으며 수동으로 수정해야 합니다.

다음 단계