BigQuery Data Transfer V1 Client - Class TransferRun (2.0.0-RC1)

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

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