쿼리 결과를 파일로 내보내기
다른 도구에서 쿼리 결과를 공유하거나 분석하려면 Cloud de Confiance 콘솔에서 BigQuery 쿼리 결과를 로컬 파일, Google Drive, Google Sheets 또는 Cloud Storage에 저장하면 됩니다. 로컬 파일의 경우 CSV 또는 줄바꿈으로 구분된 JSON과 같은 형식을 선택할 수 있습니다.
제한사항
BigQuery는 중첩되거나 반복되는 데이터(RECORD/STRUCT 또는 ARRAY 데이터 유형)를 CSV 형식으로 내보내는 것을 지원하지 않습니다. RECORD 또는 STRUCT 필드가 깊게 중첩되지 않은 것처럼 보이더라도 BigQuery는 이를 중첩된 스키마 필드로 취급하고 스키마를 중첩할 수 없음을 나타내는 오류를 반환합니다.
쿼리 결과를 CSV 파일로 내보내려면 쿼리 열당 하나의 필드가 있는 단일 수준 구조로 쿼리를 평면화합니다. 점 표기법을 사용하여 개별 필드를 선택하여 중첩된 구조체를 평면화하거나 UNNEST 연산자를 사용하여 반복 배열을 평면화할 수 있습니다. 또는 평면화 없이 중첩되거나 반복되는 데이터를 내보내려면 줄바꿈으로 구분된 JSON과 같이 중첩된 스키마를 지원하는 형식으로 쿼리 결과를 내보냅니다.
쿼리 결과를 로컬 파일에 다운로드
bq 명령줄 도구와 BigQuery API는 쿼리 결과를 로컬 파일에 직접 다운로드하는 것을 지원하지 않습니다.
쿼리 결과를 CSV 또는 줄바꿈으로 구분된 JSON 파일로 다운로드하려면Cloud de Confiance 콘솔을 사용합니다.
Cloud de Confiance 콘솔에서 BigQuery 페이지를 엽니다.
SQL 쿼리를 클릭합니다.
쿼리 편집기 필드에 유효한 GoogleSQL 쿼리를 입력합니다.
(선택사항) 처리 위치를 변경하려면 수정 > 쿼리 설정을 클릭합니다. 기본적으로 BigQuery는 데이터 위치를 자동으로 감지합니다. 위치를 변경하려면 위치에서 자동 위치 선택 체크박스를 선택 해제한 후 리전 목록에서 리전을 지정합니다.
저장을 클릭합니다.
실행을 클릭합니다.
결과가 반환되면 결과 저장을 클릭한 다음 로컬 다운로드에서 CSV 또는 JSON을 선택합니다.
브라우저의 기본 다운로드 위치로 파일이 다운로드됩니다.
쿼리 결과를 Google Drive에 저장
bq 명령줄 도구와 BigQuery API는 쿼리 결과를 Google Drive에 직접 저장하는 것을 지원하지 않습니다.
BigQuery 결과를 Google Drive에 저장하려고 할 때 오류가 발생하면 Drive SDK API가 Google Workspace 계정에 액세스할 수 없는 것일 수 있습니다. 이 문제를 해결하려면 관리자가 Drive SDK API로 Google Drive에 액세스할 수 있도록 사용자 계정을 사용 설정해야 합니다.
쿼리 결과를 Google Drive에 저장하려면 Cloud de Confiance 콘솔을 사용합니다.
Cloud de Confiance 콘솔에서 BigQuery 페이지를 엽니다.
SQL 쿼리를 클릭합니다.
쿼리 편집기 필드에 유효한 GoogleSQL 쿼리를 입력합니다.
실행을 클릭합니다.
결과가 반환되면 결과 저장을 클릭합니다.
Google Drive에서 CSV 또는 JSONL(줄바꿈으로 구분됨)을 선택합니다. 결과를 Google Drive에 저장할 때는 대상 하위 폴더를 선택할 수 없습니다. 결과는 항상
My Drive폴더의 루트에 저장됩니다.결과를 Google Drive에 저장하는 데 몇 분 정도 걸릴 수 있습니다. 결과가 저장되면 Drive로 이동 버튼과 함께
Query result exported.알림이 표시됩니다. 파일은bq-results-TIMESTAMP-RANDOM_CHARACTERS.csv또는bq-results-TIMESTAMP-RANDOM_CHARACTERS.json형식을 사용하여My Drive에 저장됩니다.알림에서 드라이브로 이동을 클릭하여 Google Drive에서 파일을 보거나 Google Drive로 이동하여
My Drive를 엽니다.
쿼리 결과를 Google Sheets에 저장
bq 명령줄 도구와 BigQuery API는 쿼리 결과를 Google Sheets에 직접 저장하는 것을 지원하지 않습니다.
Google Sheets에서 BigQuery 결과를 열려고 할 때 오류가 발생하면 Drive SDK API가 Google Workspace 계정에 액세스하지 못할 수 있습니다. 이 문제를 해결하려면 Drive SDK API로 Google Sheets에 액세스할 수 있도록 관리자가 사용자 계정을 사용 설정해야 합니다.
쿼리 결과를 Google Sheets에 저장하려면 Cloud de Confiance 콘솔을 사용합니다.
Cloud de Confiance 콘솔에서 BigQuery 페이지를 엽니다.
SQL 쿼리를 클릭합니다.
쿼리 편집기 필드에 유효한 GoogleSQL 쿼리를 입력합니다.
(선택사항) 처리 위치를 변경하려면 수정 > 쿼리 설정을 클릭합니다. 기본적으로 BigQuery는 데이터 위치를 자동으로 감지합니다. 위치를 변경하려면 위치에서 자동 위치 선택 체크박스를 선택 해제한 후 리전 목록에서 리전을 지정합니다.
저장을 클릭합니다.
실행을 클릭합니다.
결과가 반환되면 결과 저장을 클릭한 후 Google Drive에서 Google Sheets를 선택합니다.
메시지가 표시되면 안내에 따라 사용자 계정에 로그인하고 허용을 클릭하여
My Drive폴더에 데이터를 쓸 수 있는 권한을 부여합니다.권한을 부여하면 BigQuery 클라이언트 도구가 사용자 계정에 연결되었음을 확인하는 이메일이 전송됩니다. 이메일에는 부여된 권한이 자세히 설명되어 있으며 액세스 권한을 취소하는 단계가 포함되어 있습니다.
결과가 저장되면Cloud de Confiance 콘솔의 쿼리 결과 아래에
Saved to Sheets as "results-YYYYMMDD-HHMMSS"메시지가 표시됩니다. 열기를 클릭하여 Google Sheets에서 결과를 보거나My Drive폴더에서 파일을 엽니다.
Google Sheets에서 더 큰 데이터 세트를 분석하거나 쿼리 결과를 새로고침하려면 연결된 시트 사용을 참조하세요.
Google Sheets에 결과 저장 문제 해결
BigQuery에서 Google Sheets로 데이터를 저장할 때 데이터가 Google Sheets 한도인 셀당 50,000자를 초과하면 시트의 셀이 비어 있을 수 있습니다. 이 문제를 해결하려면 GoogleSQL 쿼리에서 문자열 함수를 사용하여 긴 텍스트를 여러 열로 분할한 후 결과를 Google Sheets에 다시 저장하세요.
쿼리 결과를 Cloud Storage에 저장
다음 단계에 따라 Cloud de Confiance 콘솔에서 쿼리 결과를 Cloud Storage로 내보낼 수 있습니다.
Cloud de Confiance 콘솔에서 BigQuery 페이지를 엽니다.
SQL 쿼리를 클릭합니다.
쿼리 편집기 텍스트 영역에 유효한 GoogleSQL 쿼리를 입력합니다.
실행을 클릭합니다.
결과가 반환되면 결과 저장 > Cloud Storage를 클릭합니다.
Google Cloud Storage로 내보내기 대화상자에서
- GCS 위치에서 데이터를 내보낼 버킷, 폴더 또는 파일을 찾습니다.
- 내보내기 형식에서 내보낸 데이터 형식, CSV, JSON(줄바꿈으로 구분), Avro 또는 Parquet를 선택합니다.
- 압축에 압축 형식을 선택하거나 압축하지 않음에
None을 선택합니다.
저장을 클릭하여 쿼리 결과를 내보냅니다.
작업 진행 상황을 확인하려면 작업 기록 창을 펼치고 EXTRACT 유형의 작업을 찾습니다.
쿼리 결과 다운로드 제한
사용자가 Cloud de Confiance 콘솔에서 쿼리 결과를 다운로드하지 못하도록 하려면 다음 방법 중 하나를 사용합니다.
BigQuery 리소스 주위에 VPC 서비스 제어 경계를 구성하여 데이터 무단 반출을 방지합니다. 프로젝트가 서비스 경계로 보호되는 경우 사용자는 설정된 경계 외부로 데이터를 다운로드하거나 내보낼 수 없습니다.
Cloud Customer Care에 문의하여Cloud de Confiance 콘솔 내에서 직접 데이터 다운로드 및 내보내기 옵션을 사용 중지하는 제한된 목록에Cloud de Confiance by S3NS 프로젝트 또는 조직을 추가하도록 요청합니다.
다음 단계
- 프로그래매틱 방식으로 테이블을 JSON 파일로 내보내는 방법 알아보기
- 추출 작업의 할당량 알아보기
- BigQuery 스토리지 가격 책정 알아보기