资源:TransferConfig
该资源表示数据传输配置。转移作业配置包含执行数据转移作业所需的所有元数据。例如,destinationDatasetId
指定数据应存储在何处。创建新转移作业配置时,系统会根据需要创建指定的 destinationDatasetId
,并将其提供给相应的数据源服务帐号。
JSON 表示法 | |
---|---|
{ "name": string, "displayName": string, "dataSourceId": string, "params": { object }, "schedule": string, "scheduleOptions": { object ( |
字段 | |
---|---|
name |
转移作业配置的资源名称。转移作业配置名称采用 |
displayName |
用户为数据转移作业指定的显示名。 |
dataSourceId |
数据源 ID。 创建数据转移作业后,就无法再更改该 ID。 |
params |
特定于数据转移作业的参数。 |
schedule |
数据转移作业时间表。如果数据源不支持自定义时间表,则此字段应为空。如果此字段为空,系统会使用该数据源的默认值。指定的时间采用世界协调时间 (UTC)。有效格式的示例: |
scheduleOptions |
自定义数据转移作业时间表的选项。 |
dataRefreshWindowDays |
自动刷新数据时所对应的回溯天数。 例如,如果 |
disabled |
表示此配置是否处于停用状态。 如果设置为 true,则系统不会为指定转移作业安排任何运行。 |
updateTime |
仅供输出。数据传输修改时间。对于输入,服务器会忽略该项。 |
nextRunTime |
仅供输出。数据转移作业的下次运行时间。 |
state |
仅供输出。最近更新的转移作业运行的状态。 |
userId |
已弃用。用户的唯一 ID,转移作业由其他方代表该用户完成。 |
datasetRegion |
仅供输出。BigQuery 数据集所在的地区。 |
notificationPubsubTopic |
Pub/Sub 主题,系统将在与此转移作业配置关联的转移作业运行完成后通过该主题发送通知。 |
emailPreferences |
电子邮件通知将根据这些偏好设置发送到拥有此转移作业配置的用户的电子邮件地址。 |
destinationDatasetId |
BigQuery 目标数据集 ID。 |
ScheduleOptions
自定义数据转移作业时间表的选项。
JSON 表示法 | |
---|---|
{ "disableAutoScheduling": boolean, "startTime": string, "endTime": string } |
字段 | |
---|---|
disableAutoScheduling |
如果为 true,则系统不会为此配置自动安排数据转移作业运行。您可以使用 transferConfigs.startManualRuns API 临时启动运行。如果停用自动安排功能,则系统将忽略 TransferConfig.schedule 字段。 |
startTime |
指定开始安排转移作业运行的时间。系统将根据时间表字符串中定义的定期重复模式在开始时间或之后安排第一次运行。开始时间可以随时更改。可以手动触发数据转移作业的时间不受此选项的限制。 |
endTime |
定义停止安排转移作业运行的时间。转移作业运行不能安排在结束时间或之后。结束时间可以随时更改。可以手动触发数据转移作业的时间不受此选项的限制。 |
方法 |
|
---|---|
|
创建新的数据转移作业配置。 |
|
删除数据转移作业配置,包括任何关联的转移作业运行和日志。 |
|
返回有关数据转移作业配置的信息。 |
|
返回有关项目中所有数据转移作业的信息。 |
|
更新数据转移作业配置。 |
(deprecated) |
为某个时间范围 [start_time, end_time] 创建转移作业运行。 |
|
现在开始手动执行转移作业运行,其 schedule_time 等于当前时间。 |