저장된 쿼리 관리

이 문서에서는 저장된 쿼리 및 기존 저장된 쿼리를 관리하는 방법을 설명합니다.

저장된 쿼리

다음 섹션에서 저장된 쿼리를 관리하는 방법을 알아보세요. 저장된 쿼리는 Dataform으로 구동되는 BigQuery Studio 코드 애셋입니다.

필수 권한

저장된 쿼리를 관리하려면 다음 Identity and Access Management(IAM) 역할이 필요합니다.

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

저장된 쿼리에 대한 액세스 권한 부여

다른 사용자에게 저장된 쿼리에 대한 액세스 권한을 부여하려면 해당 사용자를 적절한 IAM 역할에 추가하세요.

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

    BigQuery로 이동

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

  3. 저장된 쿼리 옆에 있는 작업 보기를 클릭한 후 공유 > 권한 관리를 클릭합니다.

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

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

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

    • 코드 소유자: 삭제 또는 공유를 포함하여 저장된 쿼리에 대한 모든 작업을 수행할 수 있습니다.
    • 코드 편집자: 쿼리를 수정할 수 있습니다.
    • 코드 뷰어: 쿼리를 볼 수 있습니다.

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

  8. 저장을 클릭합니다.

  9. 저장된 쿼리 정보로 돌아가려면 닫기를 클릭합니다.

저장된 쿼리 공유

저장된 쿼리에 대한 링크를 생성하고 공유하여 저장된 쿼리를 다른 사용자와 공유합니다. 저장된 쿼리를 사용자가 볼 수 있으려면 먼저 해당 사용자에게 저장된 쿼리에 대한 액세스 권한을 부여해야 합니다.

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

저장된 쿼리를 공유하려면 쿼리에 용도를 설명하는 주석을 포함하는 것이 좋습니다.

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

    BigQuery로 이동

  2. 탐색기 창에서 프로젝트와 쿼리 폴더를 펼치고 필요한 경우 공유 쿼리 폴더를 펼칩니다. 공유하려는 저장된 쿼리를 찾습니다.

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

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

저장된 쿼리 모두 보기

프로젝트의 모든 저장된 쿼리 목록을 보려면 다음 안내를 따르세요.

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

    BigQuery로 이동

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

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

저장된 쿼리 메타데이터 보기

저장된 쿼리 메타데이터를 보려면 다음 단계를 수행합니다.

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

    BigQuery로 이동

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

  3. 요약 창에서 사용되는 리전 및 마지막으로 수정된 날짜 등 저장된 쿼리에 대한 정보를 확인합니다.

저장된 쿼리 버전으로 작업

다음 섹션에서 저장된 쿼리의 버전을 보고 비교하고 복원하는 방법을 알아보세요.

저장된 쿼리 버전 보기

저장된 쿼리 버전을 보려면 다음 단계를 따르세요.

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

    BigQuery로 이동

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

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

저장된 쿼리 버전 비교

저장된 쿼리 버전을 비교하려면 다음 단계를 따르세요.

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

    BigQuery로 이동

  2. 탐색기 창에서 프로젝트와 쿼리 폴더를 펼치고 필요한 경우 공유 쿼리 폴더를 펼칩니다. 버전 정보를 비교할 저장된 쿼리의 이름을 클릭합니다.

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

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

저장된 쿼리 버전 복원

다음 옵션 중 하나를 사용하여 저장된 쿼리 버전을 복원합니다. 비교 창에서 복원하면 복원 여부를 선택하기 전에 저장된 쿼리의 이전 버전을 현재 버전과 비교할 수 있습니다.

활동 창

  1. 탐색기 창에서 프로젝트와 쿼리 폴더를 펼치고 필요한 경우 공유 쿼리 폴더를 펼칩니다. 이전 버전을 복원할 저장된 쿼리 이름을 클릭합니다.
  2. 활동 창을 선택합니다.
  3. 복원할 저장된 쿼리 버전 옆에 있는 작업 보기를 클릭한 후 복원을 클릭합니다.
  4. 확인을 클릭하여 작업을 확인합니다.

비교 창

  1. 탐색기 창에서 프로젝트와 쿼리 폴더를 펼치고 필요한 경우 공유 쿼리 폴더를 펼칩니다. 이전 버전을 복원할 저장된 쿼리 이름을 클릭합니다.
  2. 활동 창을 선택합니다.
  3. 저장된 쿼리 버전 옆에 있는 작업 보기를 클릭한 후 비교를 클릭합니다. 선택한 저장된 쿼리 버전을 가장 최근에 저장된 쿼리 버전과 비교하는 비교 창이 열립니다.
  4. 비교 후 이전에 저장된 쿼리 버전을 복원하려면 복원을 클릭합니다.
  5. 확인을 클릭하여 작업을 확인합니다.

저장된 쿼리 다운로드

저장된 쿼리를 다운로드하려면 다음 단계를 수행합니다.

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

    BigQuery로 이동

  2. 탐색기 창에서 프로젝트와 쿼리 폴더를 펼치고 필요한 경우 공유 쿼리 폴더를 펼칩니다. 저장된 쿼리의 이름을 클릭하여 엽니다.

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

저장된 쿼리 삭제

저장된 쿼리를 삭제하려면 다음 단계를 수행합니다.

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

    BigQuery로 이동

  2. 탐색기 창에서 프로젝트와 쿼리 폴더를 펼치고 필요한 경우 공유 쿼리 폴더를 펼칩니다. 삭제하려는 저장된 쿼리를 찾습니다.

  3. 저장된 쿼리 옆에 있는 작업 보기를 클릭한 후 삭제를 클릭합니다.

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

  5. Delete(삭제)를 클릭합니다.

기존 저장된 쿼리

다음 섹션에서 기존 저장된 쿼리를 관리하는 방법을 알아보세요.

기존 저장된 쿼리 공유

프로젝트 또는 공개 상태인 기존 저장된 쿼리를 공유할 수 있습니다. 프로젝트 공개 상태를 사용하면 필요한 권한을 가진 주 구성원이 쿼리를 보거나, 업데이트하거나, 삭제할 수 있습니다. 공개 상태가 공개인 경우 쿼리 링크가 있는 모든 사용자가 쿼리를 볼 수 있지만 업데이트하거나 삭제하지는 못합니다.

기존 저장된 쿼리에 대한 링크를 생성하고 공유하여 기존 저장된 쿼리를 다른 사용자와 공유합니다.

기존 공유 쿼리를 실행하려면 사용자에게 쿼리에서 액세스하는 데이터에 대한 액세스 권한이 있어야 합니다. 자세한 내용은 데이터 세트에 대한 액세스 권한 부여를 참조하세요.

기존 저장된 쿼리를 공유하려면 쿼리에 용도를 설명하는 주석을 포함하는 것이 좋습니다.

  1. 탐색기 창에서 프로젝트와 (기존) 쿼리 폴더를 펼친 후 공유할 기존 저장된 쿼리를 찾습니다.
  2. 쿼리 옆에 있는 작업 보기를 클릭한 후 링크 가져오기를 클릭합니다.
  3. 쿼리 액세스 권한을 부여하려는 사용자와 링크를 공유합니다.

기존 저장된 쿼리 마이그레이션

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

    BigQuery로 이동

  2. 탐색기 창에서 프로젝트와 (기존) 쿼리 폴더를 펼치고 필요한 경우 프로젝트 쿼리 폴더를 펼칩니다.

  3. 기존 저장된 쿼리의 이름을 클릭하여 엽니다.

  4. 쿼리 저장(기존) > 쿼리를 다른 이름으로 저장...을 클릭합니다.

  5. 쿼리 저장 대화상자에 이름을 입력하고 쿼리 위치를 선택합니다.

  6. 저장을 클릭합니다.

기존 저장된 쿼리 삭제

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

    BigQuery로 이동

  2. 탐색기 창에서 프로젝트와 (기존) 쿼리 폴더를 펼치고 필요한 경우 프로젝트 쿼리 폴더를 펼칩니다.

  3. 삭제하려는 기존 저장된 쿼리를 찾습니다.

  4. 쿼리 옆에 있는 작업 보기를 클릭한 후 삭제를 클릭합니다.

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

  6. Delete(삭제)를 클릭합니다.