BigQuery Data Transfer V1 Client - Class TransferRun (2.1.0)

Reference documentation and code samples for the BigQuery Data Transfer V1 Client class TransferRun.

Represents a data transfer run.

Generated from protobuf message google.cloud.bigquery.datatransfer.v1.TransferRun

Namespace

Google \ Cloud \ BigQuery \ DataTransfer \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ name`	`string` Identifier. The resource name of the transfer run. Transfer run names have the form `projects/{project_id}/locations/{location}/transferConfigs/{config_id}/runs/{run_id}`. The name is ignored when creating a transfer run.
`↳ schedule_time`	`Google\Protobuf\Timestamp` Minimum time after which a transfer run can be started.
`↳ run_time`	`Google\Protobuf\Timestamp` For batch transfer runs, specifies the date and time of the data should be ingested.
`↳ error_status`	`Google\Rpc\Status` Status of the transfer run.
`↳ start_time`	`Google\Protobuf\Timestamp` Output only. Time when transfer run was started. Parameter ignored by server for input requests.
`↳ end_time`	`Google\Protobuf\Timestamp` Output only. Time when transfer run ended. Parameter ignored by server for input requests.
`↳ update_time`	`Google\Protobuf\Timestamp` Output only. Last time the data transfer run state was updated.
`↳ params`	`Google\Protobuf\Struct` Output only. Parameters specific to each data source. For more information see the bq tab in the 'Setting up a data transfer' section for each data source. For example the parameters for Cloud Storage transfers are listed here: https://cloud.google.com/bigquery-transfer/docs/cloud-storage-transfer#bq
`↳ destination_dataset_id`	`string` Output only. The BigQuery target dataset id.
`↳ data_source_id`	`string` Output only. Data source id.
`↳ state`	`int` Data transfer run state. Ignored for input requests.
`↳ user_id`	`int\|string` Deprecated. Unique ID of the user on whose behalf transfer is done.
`↳ schedule`	`string` Output only. Describes the schedule of this transfer run if it was created as part of a regular schedule. For batch transfer runs that are scheduled manually, this is empty. NOTE: the system might choose to delay the schedule depending on the current load, so `schedule_time` doesn't always match this.
`↳ notification_pubsub_topic`	`string` Output only. Pub/Sub topic where a notification will be sent after this transfer run finishes. The format for specifying a pubsub topic is: `projects/{project_id}/topics/{topic_id}`
`↳ email_preferences`	`Google\Cloud\BigQuery\DataTransfer\V1\EmailPreferences` Output only. Email notifications will be sent according to these preferences to the email address of the user who owns the transfer config this run was derived from.

getName

Identifier. The resource name of the transfer run.

Transfer run names have the form projects/{project_id}/locations/{location}/transferConfigs/{config_id}/runs/{run_id}. The name is ignored when creating a transfer run.

Returns
Type	Description
`string`

setName

Identifier. The resource name of the transfer run.

Transfer run names have the form projects/{project_id}/locations/{location}/transferConfigs/{config_id}/runs/{run_id}. The name is ignored when creating a transfer run.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getScheduleTime

Minimum time after which a transfer run can be started.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasScheduleTime

clearScheduleTime

setScheduleTime

Minimum time after which a transfer run can be started.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getRunTime

For batch transfer runs, specifies the date and time of the data should be ingested.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasRunTime

clearRunTime

setRunTime

For batch transfer runs, specifies the date and time of the data should be ingested.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getErrorStatus

Status of the transfer run.

Returns
Type	Description
`Google\Rpc\Status\|null`

hasErrorStatus

clearErrorStatus

setErrorStatus

Status of the transfer run.

Parameter
Name	Description
`var`	`Google\Rpc\Status`

Returns
Type	Description
`$this`

getStartTime

Output only. Time when transfer run was started.

Parameter ignored by server for input requests.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasStartTime

clearStartTime

setStartTime

Output only. Time when transfer run was started.

Parameter ignored by server for input requests.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getEndTime

Output only. Time when transfer run ended.

Parameter ignored by server for input requests.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasEndTime

clearEndTime

setEndTime

Output only. Time when transfer run ended.

Parameter ignored by server for input requests.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getUpdateTime

Output only. Last time the data transfer run state was updated.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Last time the data transfer run state was updated.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getParams

Output only. Parameters specific to each data source. For more information see the bq tab in the 'Setting up a data transfer' section for each data source. For example the parameters for Cloud Storage transfers are listed here: https://cloud.google.com/bigquery-transfer/docs/cloud-storage-transfer#bq

Returns
Type	Description
`Google\Protobuf\Struct\|null`

hasParams

clearParams

setParams

Parameter
Name	Description
`var`	`Google\Protobuf\Struct`

Returns
Type	Description
`$this`

getDestinationDatasetId

Output only. The BigQuery target dataset id.

Returns
Type	Description
`string`

hasDestinationDatasetId

setDestinationDatasetId

Output only. The BigQuery target dataset id.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getDataSourceId

Output only. Data source id.

Returns
Type	Description
`string`

setDataSourceId

Output only. Data source id.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getState

Data transfer run state. Ignored for input requests.

Returns
Type	Description
`int`

setState

Data transfer run state. Ignored for input requests.

Parameter
Name	Description
`var`	`int`

Returns
Type	Description
`$this`

getUserId

Deprecated. Unique ID of the user on whose behalf transfer is done.

Returns
Type	Description
`int\|string`

setUserId

Deprecated. Unique ID of the user on whose behalf transfer is done.

Parameter
Name	Description
`var`	`int\|string`

Returns
Type	Description
`$this`

getSchedule

Output only. Describes the schedule of this transfer run if it was created as part of a regular schedule. For batch transfer runs that are scheduled manually, this is empty.

NOTE: the system might choose to delay the schedule depending on the current load, so schedule_time doesn't always match this.

Returns
Type	Description
`string`

setSchedule

Output only. Describes the schedule of this transfer run if it was created as part of a regular schedule. For batch transfer runs that are scheduled manually, this is empty.

NOTE: the system might choose to delay the schedule depending on the current load, so schedule_time doesn't always match this.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getNotificationPubsubTopic

Output only. Pub/Sub topic where a notification will be sent after this transfer run finishes.

The format for specifying a pubsub topic is: projects/{project_id}/topics/{topic_id}

Returns
Type	Description
`string`

setNotificationPubsubTopic

Output only. Pub/Sub topic where a notification will be sent after this transfer run finishes.

The format for specifying a pubsub topic is: projects/{project_id}/topics/{topic_id}

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getEmailPreferences

Output only. Email notifications will be sent according to these preferences to the email address of the user who owns the transfer config this run was derived from.

Returns
Type	Description
`Google\Cloud\BigQuery\DataTransfer\V1\EmailPreferences\|null`

hasEmailPreferences

clearEmailPreferences

setEmailPreferences

Output only. Email notifications will be sent according to these preferences to the email address of the user who owns the transfer config this run was derived from.

Parameter
Name	Description
`var`	`Google\Cloud\BigQuery\DataTransfer\V1\EmailPreferences`

Returns
Type	Description
`$this`

getDestination

Returns
Type	Description
`string`