REST 리소스: projects.locations.dataSourceDefinitions

리소스: DataSourceDefinition
- JSON 표현
메서드

리소스: DataSourceDefinition

데이터 소스 정의를 나타냅니다.

JSON 표현

JSON 표현
{ "name": string, "dataSource": { object(`DataSource`) }, "transferRunPubsubTopic": string, "runTimeOffset": string, "supportEmail": string, "serviceAccount": string, "disabled": boolean, "transferConfigPubsubTopic": string, "supportedLocationIds": [ string ] }


{
  "name": string,
  "dataSource": {
    object(DataSource)
  },
  "transferRunPubsubTopic": string,
  "runTimeOffset": string,
  "supportEmail": string,
  "serviceAccount": string,
  "disabled": boolean,
  "transferConfigPubsubTopic": string,
  "supportedLocationIds": [
    string
  ]
}

필드
`name`	`string` 데이터 소스 정의의 리소스 이름입니다. 데이터 소스 정의 이름의 형식은 `projects/{projectId}/locations/{location}/dataSourceDefinitions/{dataSourceId}`입니다.
`dataSource`	`object(DataSource)` 데이터 소스 메타데이터입니다.
`transferRunPubsubTopic`	`string` 전송 실행 생성 시 메시지 브로드캐스트에 사용되는 Pub/Sub 주제입니다. 이 주제와 transferConfigPubsubTopic을 모두 커스텀 주제로 설정할 수 있습니다. 기본적으로 두 주제는 모두 정의를 만들 때 제공되지 않으면 자동으로 생성됩니다. 그러나 특정 주제를 직접 설정한 경우에는 다른 주제도 직접 설정해야 합니다. transferRunPubsubTopic은 비어 있지 않은 Pub/Sub 주제여야 하지만 transferConfigPubsubTopic은 빈 값으로 설정할 수 있다는 차이점이 있습니다. transferConfigPubsubTopic의 '{location}'에 대한 주석도 여기에 적용됩니다.
`runTimeOffset`	`string (Duration format)` 작업 예약 시 runTime을 계산하기 위해 scheduleTime에 추가되는 기간입니다. 자동 예약된 전송 실행에만 적용됩니다. 알 수 없는 시간대 오프셋을 보정하기 위해 지속적인 데이터 새로고침을 지원하는 데이터 소스에서 실행을 일찍 시작하는 데 사용됩니다. 음수를 사용하면 지속적인 데이터 새로고침을 지원하지 않는 데이터 소스에 대한 실행을 늦게 시작합니다. 초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 '`s`'로 끝납니다(예: `"3.5s"`).
`supportEmail`	`string` 동의 화면 데이터가 포함된 OAuth 클라이언트 브랜드의 이메일 주소를 지원합니다.
`serviceAccount`	`string` 서비스 계정이 지정되면 BigQuery가 생성된 데이터 세트를 지정된 서비스 계정과 공유합니다. 또한 이 서비스 계정은 해당 dataSourceId의 데이터 전송 실행에 대한 상태 업데이트 및 메시지 로깅을 수행할 수 있습니다.
`disabled`	`boolean` 데이터 소스의 사용이 중지되어 있는지를 나타냅니다. true이면 dataSource가 표시되지 않습니다. 또한 API가 데이터 소스와 관련된 실행 또는 데이터 전송 구성 반환을 중지합니다. 이 설정은 whitelisted_project_ids보다 우선순위가 높습니다.
`transferConfigPubsubTopic`	`string` 전송 구성 메시지를 브로드캐스트하는 데 사용할 Pub/Sub 주제입니다. 비어 있으면 메시지가 브로드캐스트되지 않습니다. 이 주제와 transferRunPubsubTopic은 모두 정의를 만들 때 제공되지 않으면 자동으로 생성됩니다. 사용자가 소유한 transferRunPubsubTopic을 제공하는 경우 transferConfigPubsubTopic을 제공하는 것이 좋습니다. 그렇지 않으면 빈 상태로 설정됩니다. 값에 '{location}'이 있는 경우 데이터 소스가 여러 리전의 데이터 세트에 대한 메시지를 개별적으로 처리하려고 한다는 의미입니다. 여기서는 {location}을 실제 주제 이름인 실제 데이터 세트 이름으로 바꿉니다. 예를 들어 projects/connector/topics/scheduler-{location}은 projects/connector/topics/scheduler-us가 될 수 있습니다. '{location}'을 찾을 수 없는 경우 입력 값이 주제 이름으로 사용됩니다.
`supportedLocationIds[]`	`string` Pub/Sub 주제를 생성해야 하는 위치를 결정할 때 사용하도록 지원되는 location_ids. 커스텀 Pub/Sub 주제가 사용되었고 '{location}'을 포함하는 경우 '{location}'을 목록의 개별 위치로 바꾸면 location_ids를 사용하여 주제를 검증할 수 있습니다. 유효한 값은 `GET https://bigquerydatatransfer.googleapis.com/v1/{name=projects/*}/locations` 응답의 'locationId' 필드입니다. 또한 데이터 소스가 사용 가능한 모든 리전을 지원해야 하는 경우 supportedLocationIds를 'global'(단일 문자열 요소)로 설정할 수 있습니다. 'global'이 지정된 경우: 1) 데이터 소스 구현이 대상 데이터 세트의 적절한 리전에 데이터를 스테이징해야 합니다. 2) 데이터 소스 개발자는 '전역' 영역 지원의 영향(예: 네트워크 트래픽 지연 시간, 리전 간 트래픽과 관련된 잠재적 요금 등)을 알고 있어야 합니다.

메서드
`create`	데이터 소스 정의를 만듭니다.
`delete`	데이터 소스 정의가 삭제됩니다. 데이터 소스 정의를 삭제하려면 모든 리전의 사용자가 먼저 이 데이터 소스 정의와 관련된 전송 구성을 모두 삭제해야 합니다.
`get`	기존 데이터 소스 정의를 가져옵니다.
`list`	지원되는 데이터 소스 정의를 나열합니다.
`patch`	기존 데이터 소스 정의를 업데이트합니다.

REST 리소스: projects.locations.dataSourceDefinitions

리소스: DataSourceDefinition

메서드

`create`

`delete`

`get`

`list`

`patch`