REST 리소스: projects.transferConfigs

리소스: TransferConfig

데이터 전송 구성을 나타냅니다. 전송 구성에는 데이터 전송을 수행하는 데 필요한 모든 메타데이터가 포함됩니다. 예를 들어 destinationDatasetId는 데이터가 저장되어야 하는 위치를 지정합니다. 새 전송 구성을 만들 때 필요한 경우 지정된 destinationDatasetId가 생성되고 적절한 데이터 소스 서비스 계정과 공유됩니다.

JSON 표현

{
  "name": string,
  "destinationDatasetId": string,
  "displayName": string,
  "dataSourceId": string,
  "params": {
    object
  },
  "schedule": string,
  "dataRefreshWindowDays": number,
  "disabled": boolean,
  "updateTime": string,
  "nextRunTime": string,
  "state": enum(TransferState),
  "userId": string,
  "datasetRegion": string,
  "partnerToken": string,
  "partnerConnectionInfo": {
    object
  }
}
필드
name

string

전송 구성의 리소스 이름입니다. 전송 구성 이름의 형식은 projects/{projectId}/locations/{region}/transferConfigs/{configId}입니다. 이름은 CreateTransferConfigRequest에 지정된 configId를 기반으로 projectId 및 리전과 함께 자동으로 생성됩니다. configId를 제공하지 않으면 일반적으로 configId에 해당하는 uuid가 생성되지만 반드시 그렇거나 그래야 하는 것은 아닙니다.

destinationDatasetId

string

BigQuery 대상 데이터 세트 ID입니다.

displayName

string

데이터 전송의 사용자 지정 표시 이름입니다.

dataSourceId

string

데이터 소스 ID입니다. 데이터 전송이 생성된 후에는 변경할 수 없습니다.

params

object (Struct format)

데이터 전송별 매개변수입니다.

schedule

string

데이터 전송 일정. 데이터 소스가 커스텀 일정을 지원하지 않는 경우 비어 있어야 합니다. 비어 있으면 데이터 소스의 기본값이 사용됩니다. 지정된 시간은 UTC 형식입니다. 유효한 형식의 예를 들면 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15, first sunday of quarter 00:00입니다. 형식에 대한 자세한 설명은 https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format을 참조하세요. 참고: 단위는 최소 8시간이거나 빈도가 더 낮아야 합니다.

dataRefreshWindowDays

number

데이터를 자동으로 새로 고치기 위해 확인할 과거의 날짜 수입니다. 예를 들어 dataRefreshWindowDays = 10이면 BigQuery는 매일 [오늘-1]의 데이터만 수집하지 않고 [오늘-10, 오늘-1]의 데이터를 다시 수집합니다. 데이터 소스가 이 기능을 지원하는 경우에만 유효합니다. 기본값을 사용하려면 이 값을 0으로 설정합니다.

disabled

boolean

이 구성의 사용이 중지되었는지 여부입니다. true로 설정하면 지정된 전송의 실행이 예약되지 않습니다.

updateTime

string (Timestamp format)

출력 전용. 데이터 전송 수정 시간입니다. 입력 시 서버에서 무시됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"

nextRunTime

string (Timestamp format)

출력 전용. 다음에 데이터 전송이 실행되는 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"

state

enum(TransferState)

출력 전용. 가장 최근에 업데이트된 전송 실행의 상태입니다.

userId

string (int64 format)

지원이 중단되었습니다. 전송이 처리되는 사용자의 고유 ID입니다.

datasetRegion

string

출력 전용. BigQuery 데이터 세트가 있는 리전입니다.

partnerToken

string

외부 파트너 측에 저장된 전송 설정을 식별하는 데 사용되는 고유 식별자입니다. 토큰은 DTS에 표시되지 않으며 파트너만 해석할 수 있습니다. 파트너 데이터 소스는 구성 ID와 토큰 간의 매핑을 만들어 전송 구성/실행이 올바른지 확인해야 합니다.

partnerConnectionInfo

object (Struct format)

파트너 데이터 소스에서 관리하는 전송 설정. 키-값 쌍으로 저장되며 DTS UI 표시용으로만 사용됩니다. '매개변수'와 함께 저장하지 않아야 하는 두 가지 이유는 다음과 같습니다. - 연결 정보는 파트너가 제공하며 고정 매개변수와 달리 DTS UI에서 수정할 수 없습니다. 구분을 위해 DataSourceParameter에 다른 부울을 추가하면 혼동을 줄 수 있습니다. - 연결 정보는 임의의 키-값 쌍일 수 있습니다. 이를 매개변수 필드에 추가하려면 파트너가 데이터 소스 정의에 관련 정의를 제공해야 합니다. 파트너는 이러한 상황을 피하는 것이 유리합니다.

메서드

create

새 데이터 전송 구성을 만듭니다.

delete

연결된 전송 실행 및 로그를 포함하여 데이터 전송 구성을 삭제합니다.

get

데이터 전송 구성 정보를 반환합니다.

list

프로젝트의 모든 데이터 전송 정보를 반환합니다.

patch

데이터 전송 구성을 업데이트합니다.

scheduleRuns

시간 범위 [start_time, end_time]의 전송 실행을 만듭니다.