전송 작업

BigQuery Data Transfer Service를 사용하여 전송을 만든 후 다음을 수행할 수 있습니다.

  • 전송 구성 정보 가져오기
  • 전송 구성 나열
  • 전송 실행 기록 보기
  • 로그 메시지와 같은 전송 실행 세부정보 보기
  • 전송 업데이트
  • 백필 설정
  • 사용자 인증 정보 업데이트
  • 전송 중지
  • 전송 삭제

전송 정보 가져오기

전송을 만든 후 전송 구성 정보를 가져올 수 있습니다. 구성에는 전송을 만들 때 사용자가 입력한 값이 포함됩니다.

필수 권한

전송 정보를 가져오려면 bigquery.transfers.get 권한이 필요합니다. 다음과 같은 사전 정의된 IAM 역할에는 bigquery.transfers.get 권한이 포함되어 있습니다.

  • bigquery.admin
  • bigquery.user

bigquery.transfers.get 권한이 부여된 사용자는 프로젝트의 모든 전송 정보를 볼 수 있습니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 정보 가져오기

전송 구성 정보를 가져오려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적절한 전송을 클릭합니다.

  4. 선택한 전송의 구성을 클릭합니다.

  5. 전송 구성 및 데이터 소스 세부정보가 표시됩니다. 다음 예시는 Teradata 마이그레이션의 구성 속성을 보여줍니다.

    Console에서 전송 구성

기본 UI

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적합한 전송을 클릭합니다.

  4. 전송 구성은 실행 기록 위의 속성 페이지에 나타납니다. 다음 예시는 Google Ads 전송의 구성 속성을 보여줍니다.

    전송 구성

bq

bq show 명령어를 입력하고 전송 구성 리소스 이름을 제공합니다. --format 플래그를 사용하면 출력 형식을 제어할 수 있습니다.

bq show \
--format=prettyjson \
--transfer_config resource_name

각 항목의 의미는 다음과 같습니다.

예를 들어 다음 명령어를 입력하여 전송 구성 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7을 표시합니다.

bq show \
--format=prettyjson \
--transfer_config projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

projects.locations.transferConfigs.get 메서드를 사용하고 name 매개변수를 사용하여 전송 구성을 제공합니다.

전송 구성 나열

필수 권한

프로젝트의 모든 전송 또는 전송 구성을 나열하려면 bigquery.transfers.get 권한이 필요합니다. 다음과 같은 사전 정의된 IAM 역할에는 bigquery.transfers.get 권한이 포함되어 있습니다.

  • bigquery.admin
  • bigquery.user

bigquery.transfers.get 권한이 부여된 사용자는 프로젝트의 모든 전송을 나열할 수 있습니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 나열

프로젝트에서 전송 구성을 나열하려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 프로젝트에 전송 구성이 있는 경우 전송 구성 목록이 전송 페이지에 표시됩니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다. 전송 페이지에 전송 구성이 위치별로 분류되어 나타납니다.

bq

프로젝트의 모든 전송 구성을 위치별로 나열하려면 bq ls 명령어를 입력하고 --transfer_location--transfer_config 플래그를 제공합니다. 또한 --project_id 플래그를 입력하여 특정 프로젝트를 지정할 수도 있습니다. --project_id를 지정하지 않으면 기본 프로젝트가 사용됩니다. --format 플래그를 사용하면 출력 형식을 제어할 수 있습니다.

특정 데이터 소스의 전송 구성을 나열하려면 --filter 플래그를 제공합니다.

특정 개수의 전송 구성을 페이지 번호 매김 형식으로 보려면 --max_results 플래그를 제공하여 전송 수를 제공합니다. 이 명령어는 --page_token 플래그를 사용하여 사용자가 제공하는 페이지 토큰을 반환하여 다음 n개 구성을 표시합니다.

bq ls \
--transfer_config \
--transfer_location=location \
--project_id=project_id \
--max_results=integer \
--filter=dataSourceIds:data_sources

각 항목의 의미는 다음과 같습니다.

  • location은 전송 구성 위치입니다. location은 전송을 만들 때 지정됩니다.
  • project_id는 프로젝트 ID입니다.
  • integer는 페이지당 표시되는 결과 수입니다.
  • data_sources는 다음 중 하나입니다.
    • dcm_dt: Campaign Manager
    • dcm_dt: Campaign Manager
    • google_cloud_storage: Cloud Storage
    • dfp_dt: Google Ad Manager
    • adwords: Google Ads
    • merchant_center: Google 판매자 센터
    • play: Google Play
    • doubleclick_search: Search Ads 360
    • youtube_channel: YouTube - 채널 보고서
    • youtube_content_owner: YouTube - 콘텐츠 소유자 보고서

예:

다음 명령어를 입력하여 기본 프로젝트의 미국 내 모든 전송 구성을 표시합니다. 출력은 --format 플래그를 통해 제어됩니다.

bq ls \
--format=prettyjson \
--transfer_config \
--transfer_location=us

다음 명령어를 입력하여 프로젝트 ID myproject에 대한 미국 내 모든 전송 구성을 표시합니다.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject

다음 명령어를 입력하여 최근 전송 구성 세 개를 나열합니다.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject \
--max_results=3

이 명령어는 다음 페이지 토큰을 반환합니다. 페이지 토큰을 복사하고 이를 bq ls 명령어에 제공하여 다음 3개 결과를 확인합니다.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject \
--max_results=3 \
--page_token=AB1CdEfg_hIJKL

다음 명령어를 입력하여 프로젝트 ID myproject의 Ads 및 Campaign Manager 전송 구성을 나열합니다.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject \
--filter=dataSourceIds:dcm_dt,adwords

API

projects.locations.transferConfigs.list 메서드를 사용하고 parent 매개변수를 사용하여 프로젝트 ID를 제공합니다.

실행 기록 보기

예약 전송이 실행됨에 따라 각 전송 구성의 전송 실행 성공과 실패를 포함한 실행 기록이 유지됩니다. 90일이 지난 전송 실행은 자동으로 실행 기록에서 삭제됩니다.

필수 권한

전송 구성의 실행 기록을 보려면 bigquery.transfers.get 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.user에는 bigquery.transfers.get 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

실행 기록 보기

전송 구성 실행 기록을 보려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적절한 전송을 클릭합니다.

  4. 선택한 전송에 대한 실행 기록 페이지가 표시됩니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적합한 전송을 클릭합니다.

  4. 속성 페이지의 전송 속성 아래에 실행 기록이 표시됩니다.

    실행 기록

  5. (선택 사항) 최근 일일 실행만 표시를 선택 취소하면 모든 전송 실행이 표시됩니다.

전송 실행 상태가 그래프로 표시되며 상태 열에 세부정보가 표시됩니다.

아이콘 상태
실행 성공 아이콘 전송 실행을 성공했습니다.
실행 실패 아이콘 전송 실행을 실패했습니다.
실행 경고 아이콘 전송 실행을 성공했지만 경고가 발생했습니다. 결과 테이블이 정상적으로 나타나면 실행에는 문제가 없습니다.

bq

특정 전송 구성의 전송 실행을 나열하려면 bq ls 명령어를 입력하고 --transfer_run 플래그를 제공합니다. 또한 --project_id 플래그를 입력하여 특정 프로젝트를 지정할 수도 있습니다. resource_name에 프로젝트 정보가 없으면 --project_id 값이 사용됩니다. --project_id를 지정하지 않으면 기본 프로젝트가 사용됩니다. --format 플래그를 사용하면 출력 형식을 제어할 수 있습니다.

특정 개수의 전송 실행을 보려면 --max_results 플래그를 제공합니다. 이 명령어는 --page_token 플래그를 사용하여 사용자가 제공하는 페이지 토큰을 반환하여 다음 n개 구성을 표시합니다.

실행 상태를 기준으로 전송 실행을 나열하려면 --filter 플래그를 제공합니다.

bq ls \
--transfer_run \
--max_results=integer \
--transfer_location=location \
--project_id=project_id \
--filter=states:state, ... \
resource_name

각 항목의 의미는 다음과 같습니다.

  • integer는 반환할 결과 수입니다.
  • location은 전송 구성 위치입니다. location은 전송을 만들 때 지정됩니다.
  • project_id는 프로젝트 ID입니다.
  • state, ...는 다음 중 하나이거나 쉼표로 구분된 목록입니다.
    • SUCCEEDED
    • FAILED
    • PENDING
    • RUNNING
    • CANCELLED
  • resource_name은 전송 리소스 이름입니다(또는 전송 구성이라고 함). 전송 리소스 이름을 모르면 bq ls --transfer_config --transfer_location=location 명령어를 실행하여 모든 전송을 나열합니다.

예를 들면 다음과 같습니다.

다음 명령어를 입력하여 전송 구성 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7의 최근 3회 실행 내역을 표시합니다. 출력은 --format 플래그를 통해 제어됩니다.

bq ls \
--format=prettyjson \
--transfer_run \
--max_results=3 \
--transfer_location=us \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

이 명령어는 다음 페이지 토큰을 반환합니다. 페이지 토큰을 복사하고 이를 bq ls 명령어에 제공하여 다음 3개 결과를 확인합니다.

bq ls \
--format=prettyjson \
--transfer_run \
--max_results=3 \
--page_token=AB1CdEfg_hIJKL \
--transfer_location=us \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

다음 명령어를 입력하여 전송 구성 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7의 실패한 모든 실행 내역을 표시합니다.

bq ls \
--format=prettyjson \
--transfer_run \
--filter=states:FAILED \
--transfer_location=us \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

projects.locations.transferConfigs.list 메서드를 사용하고 parent 매개변수를 사용하여 프로젝트 ID를 지정합니다.

전송 실행 세부정보 및 로그 메시지 보기

전송 실행이 실행 기록에 나타나면 로그 메시지, 경고 및 오류, 실행 이름, 시작 시간 및 종료 시간을 포함한 실행 세부정보를 확인할 수 있습니다.

필수 권한

전송 실행 세부정보를 보려면 bigquery.transfers.get 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.user에는 bigquery.transfers.get 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 실행 세부정보 보기

전송 실행 세부정보를 보려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적절한 전송을 클릭합니다.

  4. 선택한 전송에 대한 실행 기록 페이지가 표시됩니다.

  5. 전송의 개별 실행을 클릭하면 해당 전송 실행에 대한 실행 세부정보 패널이 열립니다.

  6. 실행 세부정보에서 오류 메시지를 확인합니다. 이 정보는 Google Cloud 지원에 문의하는 경우에 필요합니다. 실행 세부정보에는 로그 메시지와 경고도 포함됩니다.

    콘솔에서 세부정보 실행

기본 UI

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적합한 전송을 클릭합니다.

  4. 속성 페이지의 전송 속성 아래에 실행 기록이 표시됩니다. 세부정보를 검토할 실행을 클릭합니다.

  5. 실행 세부정보에서 실행 이름과 오류 메시지를 확인합니다. 이 정보는 Google Cloud 지원에 문의하는 경우에 필요합니다. 실행 세부정보에는 로그 메시지와 경고도 포함됩니다.

    실행 세부정보

bq

전송 실행 세부정보를 보려면 bq show 명령어를 입력하고 --transfer_run 플래그를 사용하여 전송 실행의 실행 이름을 제공합니다. --format 플래그를 사용하면 출력 형식을 제어할 수 있습니다.

bq show \
--format=prettyjson \
--transfer_run run_name

각 항목의 의미는 다음과 같습니다.

  • run_name은 전송 실행의 실행 이름입니다. 실행 이름은 bq ls 명령어를 사용하여 검색할 수 있습니다.

예를 들면 다음과 같습니다.

다음 명령어를 입력하여 전송 실행 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g의 세부정보를 표시합니다.

bq show \
--format=prettyjson \
--transfer_run \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

전송 실행의 전송 로그 메시지를 보려면 --transfer_log 플래그를 사용하여 bq ls 명령어를 입력합니다. --message_type 플래그를 사용하여 로그 메시지를 유형별로 필터링할 수 있습니다.

특정 개수의 로그 메시지를 보려면 --max_results 플래그를 제공합니다. 이 명령어는 --page_token 플래그를 사용하여 사용자가 제공하는 페이지 토큰을 반환하여 다음 n개 메시지를 표시합니다.

bq ls \
--transfer_log \
--max_results=integer \
--message_type=messageTypes:message_type \
run_name

각 항목의 의미는 다음과 같습니다.

  • integer는 반환할 로그 메시지 수입니다.
  • message_type은 보려는 로그 메시지 유형입니다(단일 값 또는 쉼표로 구분된 목록).
    • INFO
    • WARNING
    • ERROR
  • run_name은 전송 실행의 실행 이름입니다. 실행 이름은 bq ls 명령어를 사용하여 검색할 수 있습니다.

예를 들면 다음과 같습니다.

다음 명령어를 입력하여 전송 실행 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g의 처음 2개 로그 메시지를 확인합니다.

bq ls \
--transfer_log \
--max_results=2 \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

이 명령어는 다음 페이지 토큰을 반환합니다. 페이지 토큰을 복사하고 이를 bq ls 명령어에 제공하여 다음 2개 결과를 확인합니다.

bq ls \
--transfer_log \
--max_results=2 \
--page_token=AB1CdEfg_hIJKL \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

전송 실행 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g의 오류 메시지만 확인하려면 다음 명령어를 입력합니다.

bq ls \
--transfer_log \
--message_type=messageTypes:ERROR \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

API

projects.transferConfigs.runs.transferLogs.list 메서드를 사용하고 parent 매개변수를 사용하여 전송 실행의 실행 이름을 제공합니다.

전송 업데이트

전송이 추가되면 전송을 편집할 수 있습니다. 소스를 제외하고 전송 생성 중에 입력한 모든 필드를 편집할 수 있습니다.

  • 대상 데이터세트
  • 표시 이름
  • 특정 전송 유형으로 지정된 매개변수
  • 실행 알림 설정

필수 권한

전송을 업데이트하려면 bigquery.transfers.update 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.update 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 업데이트

전송을 업데이트하려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적절한 전송을 클릭합니다.

  4. 수정을 클릭하여 전송 구성을 업데이트합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적합한 전송을 클릭합니다.

  4. 수정을 클릭하여 전송 구성을 업데이트합니다.

  5. 변경이 완료되면 저장을 클릭합니다.

bq

bq update 명령어를 입력하고, --transfer_config 플래그를 사용하여 전송 구성의 리소스 이름을 제공하고, --display_name, --target_dataset, --refresh_window_days, --params 플래그를 제공합니다.

bq update \
--display_name='name' \
--target_dataset=dataset \
--params='parameters' \
--refresh_window_days=integer \
--transfer_config \
resource_name

각 항목의 의미는 다음과 같습니다.

  • name은 전송 구성의 표시 이름입니다.
  • dataset는 전송 구성의 대상 데이터 세트입니다.
  • parameters에는 JSON 형식의 전송 구성 매개변수가 포함됩니다. --params='{"param":"param_value"}'). 다음 매개변수를 수정할 수 있습니다.
    • Google Ads: customer_id
    • Campaign Manager: bucketnetwork_id
    • Google Ad Manager: bucketnetwork_code
    • Google 판매자 센터: merchant_id
    • Google Play: buckettable_suffix
    • Search Ads 360: agency_id, advertiser_id, include_removed_entities, table_filter, custom_floodlight_variables
    • YouTube 채널: table_suffix
    • YouTube 콘텐츠 소유자: content_owner_idtable_suffix
  • integer는 0에서 30 사이의 값입니다. 새로고침 창 설정에 대해서는 전송 유형 문서를 참조하세요.
  • resource_name은 전송 리소스 이름입니다(또는 전송 구성이라고 함). 전송 리소스 이름을 모르면 bq ls --transfer_config --transfer_location=location 명령어를 실행하여 모든 전송을 나열합니다.

예를 들면 다음과 같습니다.

다음 명령어를 사용하여 표시 이름, 대상 데이터세트, 새로고침 기간, Google Ads 전송 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7의 매개변수를 업데이트합니다.

bq update \
--display_name='My changed transfer' \
--target_dataset=mydataset2 \
--params='{"customer_id":"123-123-5678"}' \
--refresh_window_days=3 \
--transfer_config \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

projects.transferConfigs.patch 메서드를 사용하고 transferConfig.name 매개변수를 사용하여 전송의 리소스 이름을 제공합니다. 전송 리소스 이름을 모르면 bq ls --transfer_config --transfer_location=location 명령어를 실행하여 모든 전송을 나열하거나 projects.locations.transferConfigs.list 메서드를 호출하고 parent 매개변수를 사용하여 프로젝트 ID를 제공합니다.

백필 및 새로고침 실행 설정

새로고침

다음 유형의 전송에는 백필을 사용할 수 없습니다. 하지만 새로고침 실행을 설정할 수 있습니다.

백필

언제든지 데이터 백필을 수동으로 시작할 수 있습니다. 소스 제한 외에도 BigQuery Data Transfer Service는 백필 요청당 최대 180일을 지원합니다. 동시 백필 요청은 지원되지 않습니다.

백필에 사용할 수 있는 데이터 양에 대해서는 해당 데이터 소스의 문서를 참조하세요.

  • Campaign Manager
  • Google Ad Manager
  • Google Ads
    • Google Ads 백필을 설정하면 데이터 이동 색인 스냅샷은 하루에 한 번 촬영되며 최근 실행 날짜의 파티션에 저장됩니다. 백필을 예약하면 다음 테이블에 대한 데이터 이동 색인 스냅샷이 업데이트되지 않습니다.
      • Ad
      • AdGroup
      • AgeRange
      • Audience
      • BidGoal
      • Budget
      • Campaign
      • Criteria
      • Customer
      • Gender
      • Keyword
      • LocationBasedCampaignCriterion
      • ParentalStatus
      • Placement
      • Video
  • Google 판매자 센터(베타)
  • Google Play
  • Search Ads 360
    • Search Ads 360 백필을 설정하면 데이터 이동 색인 스냅샷은 하루에 한 번 촬영되며 최근 실행 날짜의 파티션에 저장됩니다. 백필을 예약하면 다음 테이블에 대한 데이터 이동 색인 스냅샷이 업데이트되지 않습니다.
      • Account
      • Ad
      • Advertiser
      • AdGroup
      • AdGroupTarget
      • BidStrategy
      • Campaign
      • CampaignTarget
      • FeedItem
      • FloodlightActivity
      • Keyword
      • NegativeAdGroupKeyword
      • NegativeAdGroupTarget
      • NegativeCampaignKeyword
      • NegativeCampaignTarget
      • ProductAdvertised
      • ProductGroup
      • ProductLeadAndCrossSellFloodlightStats
      • Video
      • Placement
      • Video
  • YouTube - 채널 보고서
  • YouTube - 콘텐츠 소유자 보고서

Cloud Storage 전송에는 백필을 사용할 수 없습니다. 그러나 Cloud Storage 전송의 새로고침 실행을 설정할 수 있습니다.

필수 권한

백필 예약을 위해서는 bigquery.transfers.update 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.update 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

백필 예약

백필을 예약하려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적절한 전송을 클릭합니다.

  4. 더보기 메뉴를 클릭한 다음 백필 예약을 선택합니다.

  5. 백필 예약 대화상자에서 시작일종료일을 선택합니다. 기본 BigQuery 웹 UI를 사용하여 세부적인 시간 제한을 설정할 수 있습니다.

    새로고침 날짜 설정

기본 UI

  1. BigQuery 웹 UI로 이동합니다. BigQuery 웹 UI
  2. 전송을 클릭합니다.
  3. 전송 페이지에서 적절한 전송을 클릭합니다.
  4. Schedule Backfill(백필 예약)을 클릭합니다.

    백필 예약

  5. 실행 예약 대화상자에서 다음을 수행합니다.

    • 데이터 시작일에 MM/DD/YYYY 형식으로 적절한 날짜를 입력하거나 선택합니다.
    • 데이터 종료일에 MM/DD/YYYY 형식으로 적절한 날짜를 입력하거나 선택합니다.
    • 확인을 클릭합니다.

    백필 예약

bq

bq mk 명령어를 입력하고, --transfer_run 플래그를 제공하고, --start_time--end_time을 지정합니다.

bq mk \
--transfer_run \
--start_time='start_time' \
--end_time='end_time' \
resource_name

각 항목의 의미는 다음과 같습니다.

  • start_timeend_time은 Z로 끝나거나 유효한 시간대 오프셋을 포함하는 타임스탬프입니다. 예:

    • 2017-08-19T12:11:35.00Z
    • 2017-05-25T00:00:00+00:00
  • resource_name은 전송 리소스 이름입니다(또는 전송 구성이라고 함). 전송 리소스 이름을 모르면 bq ls --transfer_config --transfer_location=location 명령어를 실행하여 모든 전송을 나열합니다.

예를 들면 다음과 같습니다.

다음 명령어를 입력하여 전송 구성 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7의 백필을 예약합니다.

bq mk \
--transfer_run \
--start_time 2017-05-25T00:00:00Z \
--end_time 2017-05-25T00:00:00Z \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

projects.locations.transferConfigs.scheduleRuns 메서드를 사용하고 parent 매개변수를 사용하여 전송 구성 리소스를 제공합니다.

사용자 인증 정보 업데이트

전송은 전송을 만든 사용자의 사용자 인증 정보를 사용합니다. 전송 구성에 연결된 사용자를 변경해야 하는 경우, 전송 사용자 인증 정보를 업데이트할 수 있습니다. 이 기능은 전송을 만든 사용자가 더 이상 조직에 없는 경우에 유용합니다.

필수 권한

사용자 인증 정보를 업데이트하려면 bigquery.transfers.update 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.update 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 사용자 인증 정보 업데이트

전송 사용자 인증 정보를 업데이트하려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 목록에서 적절한 전송을 클릭합니다.

  4. 더보기 메뉴를 클릭한 후 사용자 인증 정보 새로고침을 선택합니다.

  5. Google 계정에 로그인하고 허용을 클릭하여 보고 데이터를 확인하고 BigQuery 데이터에 액세스하고 관리할 수 있는 BigQuery Data Transfer Service 권한을 부여합니다. 권한 창을 보려면 bigquery.cloud.google.com에서 팝업을 허용해야 합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다. BigQuery 웹 UI
  2. 전송을 클릭합니다.
  3. 전송 페이지에서 적절한 전송을 클릭합니다.
  4. 사용자 인증 정보 업데이트를 클릭합니다.
  5. 메시지가 표시되면 확인을 클릭합니다.
  6. Google 계정에 로그인하고 허용을 클릭하여 보고 데이터를 확인하고 BigQuery 데이터에 액세스하고 관리할 수 있는 BigQuery Transfer Service 권한을 부여합니다. 권한 창을 보려면 bigquery.cloud.google.com에서 팝업을 허용해야 합니다.

bq

bq update 명령어를 입력하고 --transfer_config 플래그를 사용하여 전송 구성의 리소스 이름을 제공하고, --update_credentials 플래그를 제공합니다.

bq update \
--update_credentials=boolean \
--transfer_config \
resource_name

각 항목의 의미는 다음과 같습니다.

  • boolean는 전송 구성에 대한 사용자 인증 정보를 업데이트해야 하는지 여부를 나타내는 부울 값입니다.
  • resource_name은 전송 리소스 이름입니다(또는 전송 구성이라고 함). 전송 리소스 이름을 모르면 bq ls --transfer_config --transfer_location=location 명령어를 실행하여 모든 전송을 나열합니다.

예를 들면 다음과 같습니다.

다음 명령어를 입력하여 Google Ads 전송 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7의 사용자 인증 정보를 업데이트합니다.

bq update \
--update_credentials=true \
--transfer_config \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

projects.transferConfigs.patch 메서드를 사용하고 authorizationCodeupdateMask 매개변수를 제공합니다.

전송 중지

전송을 중지하면 disabled가 전송 이름에 추가됩니다. 전송을 중지하면 새 전송 실행이 예약되지 않고 새 백필이 허용되지 않습니다. 진행 중인 전송 실행은 완료됩니다.

전송을 중지해도 이미 BigQuery에 전송된 데이터는 삭제되지 않습니다. 개발자가 데이터세트를 삭제하거나 테이블을 삭제할 때까지 이전에 전송한 데이터에 대한 표준 BigQuery 스토리지 요금이 청구됩니다.

필수 권한

전송을 중지하려면 bigquery.transfers.update 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.update 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 중지

전송을 중지하려면 다음 안내를 따르세요.

콘솔

  1. Google Cloud Console에서 BigQuery 웹 UI로 이동합니다.

    Cloud Console로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 사용 중지할 목록에서 전송을 클릭합니다.

  4. 사용 중지를 클릭합니다. 전송을 다시 사용 설정하려면 사용 설정을 클릭합니다.

기본 UI

  1. 기본 BigQuery 웹 UI로 이동합니다.

    기본 BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 사용 중지할 전송을 클릭합니다.

  4. 전송 속성 페이지에서 중지됨을 클릭합니다.

    전송 중지

  5. 전송이 중지되면 저장을 클릭합니다.

bq

CLI에서는 전송 중지가 지원되지 않습니다.

API

projects.locations.transferConfigs.patch 메서드를 사용하고 projects.locations.transferConfig 리소스에서 disabledtrue로 설정합니다.

전송 삭제

전송이 삭제되면 새 전송 실행이 예약되지 않습니다. 진행 중인 전송 실행은 중지됩니다.

전송을 삭제해도 BigQuery로 이미 전송된 데이터는 삭제되지 않습니다. 개발자가 데이터세트를 삭제하거나 테이블을 삭제할 때까지 이전에 전송한 데이터에 대한 표준 BigQuery 스토리지 요금이 청구됩니다.

필수 권한

전송을 삭제하려면 bigquery.transfers.update 권한이 필요합니다. 사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.update 권한이 포함됩니다.

BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

전송 삭제

전송을 삭제하려면 다음 안내를 따르세요.

콘솔

  1. Google Cloud Console에서 BigQuery 웹 UI로 이동합니다.

    Cloud Console로 이동

  2. 전송을 클릭합니다.

  3. 전송 페이지의 삭제할 목록에서 전송을 클릭합니다.

  4. 삭제를 클릭합니다. 삭제 의도를 확인하기 위한 안전 조치로 입력란에 'delete'를 입력해야 합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.

    기본 BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 수정할 전송을 클릭합니다.

  4. 전송 속성 페이지에서 삭제를 클릭합니다.

  5. 메시지가 표시되면 확인을 클릭하여 전송을 삭제합니다.

bq

bq rm 명령어를 입력하고 전송 구성 리소스 이름을 제공합니다. -f 플래그를 사용하면 확인 없이 전송 구성을 삭제할 수 있습니다.

bq rm \
-f \
--transfer_config \
resource_name

각 항목의 의미는 다음과 같습니다.

예를 들어 다음 명령어를 입력하여 전송 구성 projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7을 표시합니다.

bq rm \
--transfer_config \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

projects.locations.transferConfigs.delete 메서드를 사용하고 name 매개변수를 사용하여 삭제하려는 리소스를 제공합니다.