BigQuery Data Transfer V1 Client - Class TransferRun (2.1.5)

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
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

hasScheduleTime

clearScheduleTime

setScheduleTime

Minimum time after which a transfer run can be started.

Parameter
Name
Description
Returns
Type
Description
$this

getRunTime

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

Returns
Type
Description

hasRunTime

clearRunTime

setRunTime

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

Parameter
Name
Description
Returns
Type
Description
$this

getErrorStatus

Status of the transfer run.

Returns
Type
Description

hasErrorStatus

clearErrorStatus

setErrorStatus

Status of the transfer run.

Parameter
Name
Description
Returns
Type
Description
$this

getStartTime

Output only. Time when transfer run was started.

Parameter ignored by server for input requests.

Returns
Type
Description

hasStartTime

clearStartTime

setStartTime

Output only. Time when transfer run was started.

Parameter ignored by server for input requests.

Parameter
Name
Description
Returns
Type
Description
$this

getEndTime

Output only. Time when transfer run ended.

Parameter ignored by server for input requests.

Returns
Type
Description

hasEndTime

clearEndTime

setEndTime

Output only. Time when transfer run ended.

Parameter ignored by server for input requests.

Parameter
Name
Description
Returns
Type
Description
$this

getUpdateTime

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

Returns
Type
Description

hasUpdateTime

clearUpdateTime

setUpdateTime

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

Parameter
Name
Description
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

hasParams

clearParams

setParams

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

Parameter
Name
Description
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

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
Returns
Type
Description
$this

getDestination

Returns
Type
Description
string
Design a Mobile Site
View Site in Mobile | Classic
Share by: