Search Console의 대량 데이터 내보내기 설정 페이지에서 현재의 대량 데이터 내보내기 상태를 시작, 중지 또는 확인할 수 있습니다.
설정 페이지를 통해 Search Console에서 BigQuery로의 대량 내보내기를 시작 또는 중지하거나 예약된 내보내기를 시작한 후 마지막으로 시도한 내보내기의 상태를 확인할 수도 있습니다.
*속성 설정 > 대량 데이터 내보내기에서 대량 데이터 내보내기 페이지로 이동할 수도 있습니다.
대량 데이터 내보내기를 시작하거나 중지하려면 Search Console의 속성에 대한 소유자 권한이 있어야 합니다.
대량 데이터 내보내기를 시작하거나 중지하려면 Search Console의 프로젝트 소유자여야 합니다.
진행 중인 대량 데이터 내보내기를 중지하려면 다음 방법을 따르세요.
- 대량 데이터 내보내기 설정 페이지를 엽니다.
- 내보내기 비활성화를 클릭합니다.
- 선택사항을 확인합니다.
- 대량 내보내기가 24시간 이내에 중지됩니다. 따라서 예약된 내보내기 중지가 실행되기 전에 프로젝트로 데이터를 한 번 더 내보낼 수 있습니다. 모든 데이터 내보내기를 즉시 중지해야 하는 경우 IAM 및 관리자 > IAM > 권한 > 주 구성원별로 보기에서 Cloud 프로젝트의 Search Console 주 구성원의 권한을 삭제하면 됩니다.
- 기존 테이블은 삭제되지 않으며 BigQuery에서 계속 사용할 수 있습니다.
- 중지된 대량 데이터 내보내기는 언제든지 다시 시작할 수 있지만 Cloud 콘솔 대상 프로젝트에서 변경된 액세스 설정이 없는지 확인해야 합니다.
대량 데이터 내보내기를 시작하거나 중지하려면 Search Console의 프로젝트 소유자여야 합니다.
이전에 실행한 대량 데이터 내보내기를 다시 시작하려면 다음 단계를 따르세요.
- 대량 데이터 내보내기 시작 안내를 따릅니다.
- 동일한 프로젝트 및 데이터 세트를 계속 사용하려면 Cloud 프로젝트 ID 및 데이터 세트 위치의 이전 값을 다시 사용합니다.
- 새 위치로 내보내려면 Google Cloud 콘솔 설정 안내를 따르고 내보내기 설정 시 원하는 위치 값을 사용합니다.
- 기존 위치로 내보내는 경우 이전 테이블이 아직 존재하면 데이터가 이전 테이블에 추가됩니다. 이전 테이블이 삭제되었다면 Search Console에서 새 테이블을 만듭니다.
Search Console 내에서 최근에 시도한 데이터 내보내기의 상태를 확인할 수 있습니다.
설정을 열면 대량 데이터 내보내기 설정 옆에 최신 상태가 표시됩니다.
클릭하여 대량 데이터 내보내기 설정 페이지를 열고 자세한 정보를 확인하세요. 데이터를 내보내는 데 지속적인 문제가 있는 경우 해당 문제에 관한 메시지가 표시됩니다. 발생 가능한 오류 및 제안된 수정사항 목록을 확인하세요.
내보내기에 실패한 후 약 1주일이 지나면 Search Console에서 해당 날짜의 데이터 내보내기 시도를 중지하고 약 한 달이 지나면 Search Console에서 모든 대량 내보내기를 중지하므로, 문제를 즉시 해결해야 합니다.
Search Console에는 가장 최근에 시도한 내보내기 상태만 표시됩니다. 내보내기 상태를 확인하려면 프로젝트의 대량 데이터 내보내기 설정 페이지를 엽니다.
성공한 내보내기의 전체 목록을 보려면 대량 내보내기의 내보내기 로그 테이블을 엽니다.
Search Console은 마지막 시도 이후에 실패한 내보내기는 기록하지 않습니다.
데이터 세트 위치 이동하기
- 대량 데이터 내보내기를 중지하고 마지막 데이터가 저장될 때까지 24시간 동안 기다립니다.
- 마지막 데이터 내보내기에 성공했는지 확인합니다.
- 새 위치에 데이터 세트를 복사합니다.
- 새 위치에서 새 대량 데이터 내보내기를 시작합니다.
데이터 내보내기
내보내기 파이프라인
대량 데이터 내보내기를 시작하면 Search Console에서 내보내기를 중지할 때까지 매일 그날의 데이터를 내보냅니다. 내보내기가 실행되는 정확한 시간은 다를 수 있습니다. 내보내기 간에 데이터 공백은 없습니다.
Search Console에 지속적인 내보내기 오류가 발생하면 예약된 대로 다음날 내보내기를 다시 시도하며 내보내지지 않은 데이터가 포함됩니다. Search Console에서는 실패한 내보내기의 데이터를 약 1주일간 보관합니다. 이후에는 Search Console에서 내보내기에 실패한 날짜의 데이터를 삭제하지만, 데이터 내보내기를 계속 실행(시도)합니다.
대량 내보내기 오류 모니터링 및 수정하기
내보내기 오류 모니터링하기
내보내기 오류가 발생하거나 오류가 테이블에서 수정될 때마다 Search Console에서 모든 속성 소유자 및 전체 사용자에게 이메일을 보냅니다(메시지는 프로젝트의 메시지 창에도 표시됨). 대량 내보내기 오류에 관한 메시지가 표시되면 프로젝트의 대량 내보내기 설정 페이지를 열어 시도한 내보내기의 상태와 세부정보를 확인하세요. 일시적인 오류(예: 서버 연결 오류)인 경우 Search Console에서 메시지를 보내지 않습니다.
Search Console에서는 마지막으로 시도한 내보내기에서 발생한 지속적인 오류도 대량 데이터 내보내기 설정 페이지에 표시합니다.
내보내기 오류는 BigQuery의 ExportLog 테이블에 기록되지 않습니다. 오류에 대한 자세한 내용은 Cloud 로그 탐색기에서 확인할 수 있습니다. search-console-data-export 텍스트를 살펴보면 관련 작업을 확인할 수 있습니다.
오류 수정 테스트하기
대량 데이터 내보내기 설정 페이지에 표시되는 문제를 해결한 후 보고서 테스트를 클릭하여 쉽게 확인 가능한 설정(예: 올바른 프로젝트 이름 및 클라우드 액세스 설정)을 테스트합니다. 테스트에 성공하면 새 내보내기가 실행되지 않습니다(내보내기는 정기적으로 예약된 간격으로만 발생함). 테스트에 성공하더라도 다음 내보내기 시도 시 오류가 발생하지 않는다고 보장할 수 없습니다. 할당량과 같은 일부 조건은 테스트되지 않기 때문입니다. 따라서 문제를 해결한 다음 약 하루 후에 가장 최근 내보내기에서 문제가 해결되었는지 다시 확인하세요.
내보내기 오류 목록
Search Console에서 보고할 만한 내보내기 오류는 다음과 같습니다.
Cloud 프로젝트가 없습니다.
프로젝트 이름을 잘못 입력하셨나요? IAM 설정 페이지 또는 프로젝트 URL에서 프로젝트 이름을 복사하세요.
데이터 세트 위치가 일치하지 않습니다.
이 프로젝트의 다른 위치에 이미 이름이 동일한 데이터 세트가 있으므로 내보내기에 요청된 데이터 세트 위치를 사용할 수 없습니다. 잘못된 위치가 제공된 경우 내보내기 설정 중에 이 오류가 발생할 수 있습니다. 지역 간 복제가 설정된 후 기본 위치가 변경되면 기존 내보내기에서도 이러한 문제가 발생할 수 있습니다.
설정 프로세스 중에 발생한 내보내기 실패를 해결하기 위한 옵션:
- 설정 양식의 위치 필드를 데이터 세트의 실제 위치와 일치하도록 수정합니다.
- 원하는 새 위치에 있는 다른 데이터 세트를 선택합니다.
위치를 변경하는 기존 내보내기의 경우 며칠 이내에 기본 변경사항을 되돌리면 데이터 손실 없이 내보내기를 복구할 수 있습니다. 대량 데이터 내보내기는 데이터 세트 위치 변경을 지원하지 않습니다.
이 대상 데이터 세트에 다른 대량 데이터 내보내기가 이미 있습니다.
동일한 데이터 세트에 두 개의 속성을 작성할 수 없습니다. Search Console 대량 내보내기마다 다른 대상 데이터 세트 또는 별도의 프로젝트를 선택하세요.
Cloud 프로젝트에 권한이 누락되었습니다.
Cloud 프로젝트에 Search Console 액세스 권한을 부여해야 합니다.
Cloud 프로젝트에 BigQuery API가 누락되었습니다.
Cloud 프로젝트에서 BigQuery를 사용 설정해야 합니다.
- 프로젝트 사이드바에서 API 및 서비스 > 사용 설정된 API 및 서비스로 이동합니다.
- + API 및 서비스 사용 설정을 클릭하고 BigQuery API와 BigQuery Storage API를 사용 설정합니다.
Cloud 프로젝트에 결제 정보가 누락되었습니다.
Cloud 프로젝트에 구성된 결제 정보가 유효해야 합니다. 그렇지 않으면 권한을 부여했더라도 작성에 실패합니다.
결제 문제에 관한 BigQuery 문서를 참고하세요.
Cloud 할당량을 초과했습니다.
대상 Cloud 프로젝트가 프로젝트 할당량을 초과했습니다.
마감 시한이 지났습니다.
내보내기를 완료하는 데 시간이 너무 오래 걸립니다. 이는 Search Console 문제일 수 있으며 직접 해결할 수 있는 문제가 아닙니다.
내보내기가 취소되었습니다.
특정 날짜의 데이터 내보내기에 여러 번 실패하여 Search Console에서 더 이상 해당 날짜의 데이터를 내보내지 않습니다.
알 수 없는 오류
알 수 없는 이유로 내보내기에 실패했습니다. 다음 내보내기 예약 일정까지 기다린 후 이 문제가 해결되었는지 확인하세요.
조직에서 금지하는 내보내기 위치입니다.
Google Cloud 프로젝트에는 선택한 위치에 BigQuery 데이터를 저장하지 못하게 하는 조직 수준 제한이 있습니다. 다른 위치를 선택하거나 프로젝트 사이트 관리자에게 제한을 변경할 수 있는지 문의하세요.
스키마 불일치
테이블이 생성되면 파티션 만료를 설정할 수 있습니다. 하지만 열을 추가하는 등 스키마를 변경해서는 안 됩니다. 스키마를 변경하면 내보내기가 실패합니다. 실수로 새 열을 추가했다면 삭제하여 문제를 해결할 수 있습니다. 그러지 않으면 테이블을 삭제해야 하며, 이 경우 데이터가 손실될 수 있습니다.
데이터 세트 ID가 잘못되었습니다
선택한 데이터 세트 이름이 잘못되었습니다. BigQuery 데이터 세트 이름 지정 문서에 따라 이름을 선택하세요.
Google Cloud의 도메인 제한 정책
클라우드 조직 정책은 도메인 또는 조직 리소스를 기반으로 리소스 공유를 제한합니다. 내보내기를 설정하려면 설정하는 동안 계정 액세스를 강제로 적용해야 합니다.
