BigQuery 기본 웹 UI 사용

새로운 BigQuery 웹 UI를 사용해 보고 의견을 보내 주세요. Google Cloud Platform Console로 마이그레이션하는 방법을 자세히 알아보세요.

개요

BigQuery는 BigQuery 리소스를 생성 및 관리하고 SQL 쿼리를 실행하는 데 사용할 수 있는 2개의 그래픽 웹 UI, 즉 GCP Console의 BigQuery 웹 UI와 기본 BigQuery 웹 UI를 제공합니다. 이 페이지에서는 기본 웹 UI를 소개합니다.

웹 UI 사용 방법에 관한 소개는 다음을 참조하세요.

시작하기 전에

기본 BigQuery 웹 UI를 사용하려면 GCP Console을 사용하여 프로젝트를 만들거나 선택해야 합니다.

  1. Google 계정에 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Google Cloud Platform 프로젝트를 선택하거나 만듭니다.

    리소스 관리 페이지로 이동

  3. BigQuery는 새 프로젝트에서 자동으로 사용 설정됩니다. 기존 프로젝트에서 BigQuery를 활성화하려면 BigQuery API를 사용 설정합니다.

    API 사용 설정

    로 이동하세요.
  4. 프로젝트에 신용 카드를 제공하지 않거나 결제를 사용 설정하지 않으려면 BigQuery에서 제공하는 샌드박스를 사용합니다. 이 주제의 단계는 프로젝트에 결제가 사용 설정되었는지 여부에 관계없이 프로젝트에 적용됩니다. 필요에 따라 결제를 사용 설정하려면 결제를 사용 설정하는 방법 알아보기를 참조하세요.

기본 웹 UI 열기

기본 웹 UI를 열려면 브라우저에 다음 URL을 입력하되 project_id는 기본 웹 UI에서 열려는 프로젝트의 ID로 바꿉니다.

https://bigquery.cloud.google.com/project_id

아래 버튼을 클릭하면 가장 최근에 액세스한 프로젝트를 사용하여 웹 UI가 열립니다.

기본 웹 UI로 이동

기본 웹 UI 개요

기본 웹 UI에는 세 개의 주요 섹션이 있습니다.

  1. 페이지 왼쪽의 탐색 창:

    탐색 창의 상단 목록에는 수행할 작업(쿼리 작성, 쿼리 기록 보기, 작업 기록 보기)을 나타내는 항목이 포함되어 있습니다.

    탐색창의 하단 목록에는 현재 프로젝트의 데이터세트 중 사용자가 액세스할 수 있는 데이터세트와 BigQuery 공개 데이터세트가 포함되어 있습니다. 데이터세트 ID나 라벨을 기준으로 필터링할 수 있는 필터 상자도 사용할 수 있습니다.

  2. 세부정보 창:
    탐색창에서 선택한 작업에 해당하는 정보가 포함되어 있습니다. 예를 들어 탐색창에서 데이터세트를 클릭하면 해당 데이터세트에 대한 정보가 세부정보 창에 표시됩니다.
  3. 쿼리 창:
    쿼리 작성을 클릭하면 세부정보 창 위에 새 쿼리 창이 추가됩니다. 더 이상 필요하지 않으면 이 창을 닫을 수 있습니다.

BigQuery 웹 UI 스크린샷

리소스 표시

탐색창에는 현재 프로젝트에서 찾아볼 수 있는 데이터세트 목록이 표시됩니다. 데이터세트 옆에 있는 데이터세트 확장 아이콘 아이콘을 클릭하거나 데이터세트 이름을 클릭하면 데이터세트가 펼쳐지면서 해당 데이터세트 내 테이블이 표시됩니다.

테이블을 클릭하면 테이블에 대한 정보가 세부정보 창에 표시됩니다. 그런 다음 이 창의 오른쪽에 있는 테이블 쿼리 버튼을 클릭하여 쿼리 상자를 해당 테이블의 기본 쿼리로 채울 수 있습니다. 직접 쿼리를 수정하여 필드를 지정하거나 원하는 대로 쿼리를 맞춤설정할 수 있습니다. 현재 선택한 테이블만 쿼리할 수 있는 것은 아닙니다. 테이블 쿼리에 대한 자세한 내용은 양방향 쿼리 실행을 참조하세요.

프로젝트 추가 및 제거

모든 BigQuery 작업은 프로젝트 내에서 수행됩니다. 현재 프로젝트의 이름은 데이터세트 목록 위의 탐색 창에서 확인할 수 있습니다. 프로젝트 내에서 수행하는 모든 작업에 대한 요금은 프로젝트에 연결된 결제 계정으로 청구됩니다. BigQuery 요금에 대한 자세한 내용은 가격 책정 페이지를 참조하세요.

기본 웹 UI에서는 다음을 수행할 수 있습니다.

  • 프로젝트 추가(또는 고정)
  • 고정된 프로젝트 삭제
  • 다른 프로젝트로 전환

프로젝트 추가

기본 웹 UI에서 프로젝트 드롭다운 메뉴를 사용하여 프로젝트를 추가하거나 '고정'할 수 있습니다.

기본 UI에 프로젝트를 추가하는 방법은 다음과 같습니다.

  1. 탐색창에서 프로젝트 이름 옆에 있는 아래쪽 화살표 아이콘(아래쪽 화살표 아이콘)을 클릭합니다.

  2. 드롭다운 메뉴에서 프로젝트 전환 > 프로젝트 표시를 클릭합니다.

  3. 프로젝트 표시 대화상자에서 다음을 수행합니다.

    • 프로젝트 ID를 입력합니다.
    • 탐색 패널에 프로젝트 표시를 선택된 상태로 둡니다.
    • 확인을 클릭하여 해당 프로젝트를 탐색 패널에 추가합니다.

      프로젝트 표시 대화상자

기본 UI에서 프로젝트 삭제

앞에서 추가(또는 '고정')한 프로젝트를 삭제하는 방법은 다음과 같습니다.

  1. 탐색창에서 프로젝트 이름 옆에 있는 아래쪽 화살표 아이콘(아래쪽 화살표 아이콘)을 클릭합니다.

  2. 드롭다운 메뉴에서 패널에서 프로젝트 삭제를 클릭합니다.

프로젝트 전환

UI에서 프로젝트를 고정하지 않고 다른 프로젝트로 전환하려는 경우 컨텍스트 메뉴를 사용할 수 있습니다.

프로젝트를 전환하는 방법은 다음과 같습니다.

  1. 탐색창에서 프로젝트 이름 옆에 있는 아래쪽 화살표 아이콘(아래쪽 화살표 아이콘)을 클릭합니다.

  2. 드롭다운 메뉴에서 프로젝트 전환을 클릭하고 목록에서 프로젝트를 선택합니다. 그러면 UI의 이전 프로젝트가 선택한 프로젝트로 바뀝니다.

공유 데이터세트 추가

다른 사용자가 사용자에게 프로젝트에 대한 액세스 권한은 부여하지 않은 채 프로젝트의 데이터세트만 공유할 수 있습니다. 이 경우 사용자는 공유 데이터세트가 포함된 프로젝트의 이름을 알려주는 이메일을 받게 됩니다. 이 프로젝트와 데이터세트가 기본 UI에 자동으로 나타나지는 않습니다.

이메일에 있는 browser tool 링크를 클릭하면 웹 UI가 열리고 해당 프로젝트가 표시됩니다. 공유 데이터세트가 포함된 프로젝트를 고정하려면 프로젝트 추가 단계를 따릅니다.

작업 및 쿼리 기록 보기

기본 웹 UI를 사용하여 작업을 실행하거나 쿼리를 실행하면 관련 기록이 탐색창에 보존됩니다. 쿼리도 일종의 작업이지만 쿼리 기록은 사용하기 쉽게 별도로 유지됩니다.

UI의 작업 및 쿼리 기록에는 지난 6개월간 제출한 모든 로드, 내보내기, 복사, 쿼리 작업(최대 1,000개 항목까지)이 포함됩니다. 작업 한도인 1,000개는 모든 작업 유형에서 누적 계산됩니다.

작업 기록 보기

작업 기록을 보려면 다음 중 한 가지 작업을 수행하세요.

  • 탐색 창의 작업 기록 링크를 클릭합니다.

  • 브라우저에 다음 URL을 입력합니다.

    https://bigquery.cloud.google.com/jobs/project_id

웹 UI를 사용하여 로드 작업을 반복할 수 있지만 내보내기 또는 복사 작업은 반복할 수 없습니다.

쿼리 기록 보기

쿼리 기록을 보려면 다음 중 하나를 수행하세요.

  • 탐색 창의 쿼리 기록 링크를 클릭합니다.

  • 브라우저에 다음 URL을 입력합니다.

    https://bigquery.cloud.google.com/queries/project_id

웹 UI를 사용하여 쿼리 작업을 반복할 수 있습니다.

작업 및 쿼리 기록 검색

쿼리 기록 또는 작업 기록을 필터링(또는 검색)하여 기준에 맞는 특정 작업만 표시할 수 있습니다. 반환되는 결과는 기본 UI를 통해 검색된 작업 풀로 제한됩니다. 기본적으로 기본 UI를 사용하면 최근 작업을 최대 1,000개까지 검색할 수 있습니다.

기록에 포함된 사용 가능한 작업을 모두 나열하려면 jobs.list API 메서드나 bq ls CLI 명령어를 사용합니다.

쿼리 또는 작업 기록을 필터링하려면 다음 안내를 따르세요.

  1. 탐색창에서 작업 기록 또는 쿼리 기록을 클릭합니다.
  2. '작업 필터링' 드롭다운을 클릭하여 필터 표현식 상자를 엽니다.
  3. 필터 표현식 상자에서 다음을 수행합니다.

    • 모든 항목을 클릭하여 필터 기준을 선택합니다.
    • 연산자 드롭다운을 클릭하고 연산자를 선택합니다. 선택한 기준에 따라 연산자 목록이 변경됩니다. 예를 들어 텍스트 기준을 선택하면 연산자 목록에 하위 문자열정규 표현식이 포함됩니다.
    • 상자에 값을 입력합니다.

      필터 표현식 작성 도구

  4. 필요한 경우 추가를 클릭하여 필터에 다른 기준을 추가합니다.

  5. 검색을 클릭합니다.

쿼리 작업을 필터링하는 데 사용할 수 있는 작업 속성은 다음과 같습니다.

  • 모든 항목 — 모든 속성입니다.
  • 작업 ID(jobid) — 작업의 고유한 비공개 ID입니다.
  • 사용자(user) - 작업을 제출한 사용자입니다.
  • 시작 시간(start) - 작업의 시작 시간을 에포크 이후의 경과 시간(밀리초)으로 나타낸 것입니다. 작업이 PENDING 상태에서 RUNNING 또는 DONE 상태로 전환된 경우 이 속성이 있습니다.
  • 종료 시간(end) - 작업의 종료 시간을 에포크 이후의 경과 시간(밀리초)으로 나타낸 것입니다. 작업이 DONE 상태이면 항상 이 속성이 있습니다.
  • 대상 테이블(dest) - 작업(로드, 복사, 쿼리)의 대상 테이블 이름입니다.
  • 쿼리 텍스트 - 제출된 SQL 쿼리의 텍스트입니다.
  • 처리한 바이트 - SQL 쿼리로 처리된 총 바이트 수입니다.
  • UDF 코드 - 맞춤 설정 함수(UDF) 코드가 포함된 인라인 리소스입니다.

로드, 복사, 추출 작업을 필터링하는 데 사용할 수 있는 작업 속성은 다음과 같습니다.

  • 모든 항목 — 모든 속성입니다.
  • 작업 ID(jobid) — 작업의 고유한 비공개 ID입니다.
  • 사용자(user) - 작업을 제출한 사용자입니다.
  • 시작 시간(start) - 작업의 시작 시간을 에포크 이후의 경과 시간(밀리초)으로 나타낸 것입니다. 작업이 PENDING 상태에서 RUNNING 또는 DONE 상태로 전환된 경우 이 속성이 있습니다.
  • 종료 시간(end) - 작업의 종료 시간을 에포크 이후의 경과 시간(밀리초)으로 나타낸 것입니다. 작업이 DONE 상태이면 항상 이 속성이 있습니다.
  • 대상 테이블(dest) - 작업(로드, 복사, 쿼리)의 대상 테이블 이름입니다.
  • 제목(title) - 기록에 표시되는 제목입니다. 예를 들어 로드 작업의 제목은 '파일을 myproject:mydataset.mytable에 업로드함'이 될 수 있습니다.
  • 유형(type) - 작업 유형입니다. 예: 로드, 쿼리, 복사 또는 추출(내보내기)
  • 복사 소스(copysrc) — 복사 작업에 사용된 소스 테이블입니다.
  • 대상 URI(desturi) — 추출(내보내기) 작업에 사용된 Cloud Storage 대상 URI입니다.
  • 소스 테이블(srctable) — 추출 작업에 사용된 소스 테이블입니다.
  • 소스 URI(srcuri) — 로드 작업에 사용된 Cloud Storage 소스 URI입니다.

쿼리 기록 정렬

또한 기본 UI에서 Queries(쿼리) 창의 Sort By(정렬 기준) 옵션을 사용하여 쿼리 기록을 정렬할 수도 있습니다. 탐색 창에서 Query History를 클릭하면 Queries 창이 열립니다.

쿼리 기록 정렬 기준 버튼

다음과 같은 정렬 옵션을 사용할 수 있습니다.

  • 날짜 - 실행 날짜를 기준으로 쿼리를 정렬합니다.
  • 기간 - 총 실행 시간을 기준으로 쿼리를 정렬합니다.
  • 기간/바이트 - 입력 바이트로 정규화된 기간을 기준으로 쿼리를 정렬합니다. 그러면 입력 크기가 서로 다른 쿼리의 실행 시간을 비교할 수 있습니다. 예를 들어 시간이 지남에 따라 증가하는 테이블 세트가 있는 경우 입력 크기의 변동에 따른 차이를 배제하고 쿼리의 효율성을 비교할 수 있습니다. 단, 입력 크기와 실행 시간 사이에는 정비례 관계가 있는 것으로 가정합니다.
  • 입력 바이트 - 읽은 바이트를 기준으로 쿼리를 정렬합니다.
  • 슬롯 시간-밀리초 - 쿼리에 사용된 모든 슬롯의 활성화 시간(밀리초) 합계를 기준으로 쿼리를 정렬합니다. 슬롯 시간-밀리초는 관찰 기간에 영향을 줄 수 있는 시스템 지연 시간이나 다른 불확실성 요인의 영향을 덜 받기 때문에 슬롯 시간-밀리초를 기준으로 정렬하면 처리 소요 시간을 보다 안정적으로 측정할 수 있습니다.
  • 슬롯 시간-밀리초/바이트 - 기간/바이트와 마찬가지로 슬롯 시간-밀리초/바이트는 슬롯 시간-밀리초의 정규화된 형식입니다.

    쿼리 기록 정렬 옵션

기본 UI 표시 제한

기본 웹 UI에는 다음과 같은 표시 제한이 적용됩니다.

  • 탐색 창에 표시할 수 있는 데이터세트 수는 최대 1,000개입니다.
  • 탐색 창에 표시할 수 있는 프로젝트당 테이블 수는 최대 30,000개입니다.

기본 UI 표시 성능 제어

드물기는 하지만, 많은 수의 테이블이 포함된 많은 수의 데이터세트가 프로젝트에 있는 경우 기본 웹 UI 성능이 영향을 받을 수 있습니다. 프로젝트에 포함된 리소스 수가 많을 경우 UI 성능을 높이려면 ?minimal 매개변수를 사용하여 프로젝트당 표시되는 리소스 수를 10,000개로 제한할 수 있습니다. 예를 들어 표시되는 리소스의 수를 제한하려면 브라우저에 다음 URL을 입력합니다.

https://bigquery.cloud.google.com/queries/project_id?minimal.

단축키

기본 웹 UI에서는 다음과 같은 단축키가 지원됩니다.

키 조합 (Windows/Linux) 키 조합 (Mac OS) 작업
Ctrl + 스페이스바 Ctrl + 스페이스바 열려 있는 쿼리가 없는 경우 새 쿼리를 작성합니다.
쿼리 편집기가 열려 있는 경우에는 현재 단어를 자동 완성합니다.
Ctrl + Enter Cmd + Enter 현재 쿼리를 실행합니다.
현재 단어를 자동 완성합니다.
Ctrl Cmd 테이블 이름을 강조표시합니다.
Ctrl + 테이블 이름 클릭 Cmd + 테이블 이름 클릭 테이블 스키마를 엽니다.
Ctrl + E Cmd + E 선택 항목으로 쿼리를 실행합니다.
Ctrl + / Cmd + / 현재 줄 또는 선택한 줄에 주석을 추가합니다.
Ctrl + Shift + F Cmd + Shift + F 쿼리 형식을 지정합니다.

예시

BigQuery 문서의 안내 가이드 섹션에서 다양한 기본 웹 UI 예를 볼 수 있습니다. 아래에는 쿼리 실행과 BigQuery 리소스 생성, 가져오기, 나열, 삭제, 수정과 같은 일반적인 웹 UI 작업을 볼 수 있는 링크가 나와 있습니다.

데이터 쿼리

기본 웹 UI를 사용하여 쿼리를 작성하고 실행하는 방법은 다음 항목을 참조하세요.

리소스 만들기

기본 웹 UI를 사용하여 리소스를 만드는 방법은 다음 항목을 참조하세요.

리소스 정보 가져오기

기본 웹 UI를 사용하여 리소스에 대한 정보를 가져오는 방법은 다음 항목을 참조하세요.

리소스 나열

기본 웹 UI를 사용하여 리소스를 나열하는 방법은 다음 항목을 참조하세요.

리소스 업데이트

기본 웹 UI를 사용하여 리소스를 업데이트하는 방법은 다음 항목을 참조하세요.

데이터 로드

기본 웹 UI를 사용하여 데이터를 로드하는 방법은 다음 항목을 참조하세요.

외부 데이터 소스 사용

기본 웹 UI를 사용하여 외부 데이터 소스의 데이터를 쿼리하는 방법은 다음 항목을 참조하세요.

데이터 내보내기

기본 웹 UI를 사용하여 데이터를 내보내는 방법은 다음 항목을 참조하세요.

BigQuery 데이터 전송 서비스 사용

기본 웹 UI와 BigQuery 데이터 전송 서비스를 함께 사용하는 방법은 다음 항목을 참조하세요.

Google Cloud Platform Console로 이동

Google Cloud Platform Console의 BigQuery 웹 UI는 2019년 4월에 일반 안정화(GA) 버전이 되었습니다. GCP Console은 나머지 Google Cloud Platform과의 일관성을 제공하며 새로운 기능의 출시를 앞당깁니다. 또한 GCP Console에는 쿼리 기록을 정렬 및 필터링하고 데이터세트를 공유하는 컨트롤과 같은 사용하기 쉬운 UI 요소가 있습니다.

이제 Google Cloud Platform Console의 BigQuery 웹 UI가 일반 안정화(GA) 버전이 되었으므로 BigQuery 기본 웹 UI에 중요한 보안 수정을 제외한 기능 업데이트 및 지원이 더 이상 제공되지 않습니다.

기본 BigQuery 웹 UI의 마이그레이션 일정은 다음과 같습니다.

  • 2019년 12월:
    기본 웹 UI에 액세스하려고 하면 GCP Console로 리디렉션됩니다. 리디렉션된 사용자는 향후 리디렉션을 선택 해제할 수 있습니다.
  • 2020년 6월:
    2020년 6월부터 Google Cloud Platform Console에서만 BigQuery 웹 UI를 사용할 수 있습니다.

기본 웹 UI의 기능 중 대부분은 이미 Google Cloud Platform Console에서 지원됩니다. 다음은 기본 웹 UI와 GCP Console 간의 주요 차이점을 요약한 것입니다.

기본 웹 UI Google Cloud Platform Console
기본 쿼리 구문은 legacy SQL입니다. 표준 SQL을 사용 설정하려면 표준 SQL 쿼리 프리픽스를 사용해야 합니다. 쿼리는 기본적으로 표준 SQL에서 실행되지만 쿼리 설정 메뉴 옵션을 사용하여 legacy SQL로 다시 전환할 수 있습니다. 맞춤설정 함수는 표준 SQL로 작성되어야 합니다.
Cloud Bigtable을 외부 데이터 소스로 사용하도록 지원합니다. 기본 웹 UI가 사용 중지되기 최소 3개월 전에 GCP Console에서 Cloud Bigtable 테이블을 쿼리할 수 있습니다.
프로젝트의 리소스 목록 새로고침을 지원합니다. 기본 웹 UI가 사용 중지되기 최소 3개월 전에 프로젝트에서 리소스 목록을 새로고침할 수 있습니다.
이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.