BigQuery Data Transfer Service V1 API - Class Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig (v1.2.0)

Reference documentation and code samples for the BigQuery Data Transfer Service V1 API class Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig.

Represents a data transfer configuration. A transfer configuration contains all metadata needed to perform a data transfer. For example, destination_dataset_id specifies where data should be stored. When a new transfer configuration is created, the specified destination_dataset_id is created when needed and shared with the appropriate data source service account.

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#data_refresh_window_days

def data_refresh_window_days() -> ::Integer
Returns
  • (::Integer) — The number of days to look back to automatically refresh the data. For example, if data_refresh_window_days = 10, then every day BigQuery reingests data for [today-10, today-1], rather than ingesting data for just [today-1]. Only valid if the data source supports the feature. Set the value to 0 to use the default value.

#data_refresh_window_days=

def data_refresh_window_days=(value) -> ::Integer
Parameter
  • value (::Integer) — The number of days to look back to automatically refresh the data. For example, if data_refresh_window_days = 10, then every day BigQuery reingests data for [today-10, today-1], rather than ingesting data for just [today-1]. Only valid if the data source supports the feature. Set the value to 0 to use the default value.
Returns
  • (::Integer) — The number of days to look back to automatically refresh the data. For example, if data_refresh_window_days = 10, then every day BigQuery reingests data for [today-10, today-1], rather than ingesting data for just [today-1]. Only valid if the data source supports the feature. Set the value to 0 to use the default value.

#data_source_id

def data_source_id() -> ::String
Returns
  • (::String) — Data source ID. This cannot be changed once data transfer is created. The full list of available data source IDs can be returned through an API call: https://cloud.google.com/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.dataSources/list

#data_source_id=

def data_source_id=(value) -> ::String
Parameter
  • value (::String) — Data source ID. This cannot be changed once data transfer is created. The full list of available data source IDs can be returned through an API call: https://cloud.google.com/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.dataSources/list
Returns
  • (::String) — Data source ID. This cannot be changed once data transfer is created. The full list of available data source IDs can be returned through an API call: https://cloud.google.com/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.dataSources/list

#dataset_region

def dataset_region() -> ::String
Returns
  • (::String) — Output only. Region in which BigQuery dataset is located.

#destination_dataset_id

def destination_dataset_id() -> ::String
Returns
  • (::String) — The BigQuery target dataset id.

#destination_dataset_id=

def destination_dataset_id=(value) -> ::String
Parameter
  • value (::String) — The BigQuery target dataset id.
Returns
  • (::String) — The BigQuery target dataset id.

#disabled

def disabled() -> ::Boolean
Returns
  • (::Boolean) — Is this config disabled. When set to true, no runs will be scheduled for this transfer config.

#disabled=

def disabled=(value) -> ::Boolean
Parameter
  • value (::Boolean) — Is this config disabled. When set to true, no runs will be scheduled for this transfer config.
Returns
  • (::Boolean) — Is this config disabled. When set to true, no runs will be scheduled for this transfer config.

#display_name

def display_name() -> ::String
Returns
  • (::String) — User specified display name for the data transfer.

#display_name=

def display_name=(value) -> ::String
Parameter
  • value (::String) — User specified display name for the data transfer.
Returns
  • (::String) — User specified display name for the data transfer.

#email_preferences

def email_preferences() -> ::Google::Cloud::Bigquery::DataTransfer::V1::EmailPreferences
Returns

#email_preferences=

def email_preferences=(value) -> ::Google::Cloud::Bigquery::DataTransfer::V1::EmailPreferences
Parameter
Returns

#encryption_configuration

def encryption_configuration() -> ::Google::Cloud::Bigquery::DataTransfer::V1::EncryptionConfiguration
Returns
  • (::Google::Cloud::Bigquery::DataTransfer::V1::EncryptionConfiguration) — The encryption configuration part. Currently, it is only used for the optional KMS key name. The BigQuery service account of your project must be granted permissions to use the key. Read methods will return the key name applied in effect. Write methods will apply the key if it is present, or otherwise try to apply project default keys if it is absent.

#encryption_configuration=

def encryption_configuration=(value) -> ::Google::Cloud::Bigquery::DataTransfer::V1::EncryptionConfiguration
Parameter
  • value (::Google::Cloud::Bigquery::DataTransfer::V1::EncryptionConfiguration) — The encryption configuration part. Currently, it is only used for the optional KMS key name. The BigQuery service account of your project must be granted permissions to use the key. Read methods will return the key name applied in effect. Write methods will apply the key if it is present, or otherwise try to apply project default keys if it is absent.
Returns
  • (::Google::Cloud::Bigquery::DataTransfer::V1::EncryptionConfiguration) — The encryption configuration part. Currently, it is only used for the optional KMS key name. The BigQuery service account of your project must be granted permissions to use the key. Read methods will return the key name applied in effect. Write methods will apply the key if it is present, or otherwise try to apply project default keys if it is absent.

#error

def error() -> ::Google::Rpc::Status
Returns
  • (::Google::Rpc::Status) — Output only. Error code with detailed information about reason of the latest config failure.

#name

def name() -> ::String
Returns
  • (::String) — Identifier. The resource name of the transfer config. Transfer config names have the form either projects/{project_id}/locations/{region}/transferConfigs/{config_id} or projects/{project_id}/transferConfigs/{config_id}, where config_id is usually a UUID, even though it is not guaranteed or required. The name is ignored when creating a transfer config.

#name=

def name=(value) -> ::String
Parameter
  • value (::String) — Identifier. The resource name of the transfer config. Transfer config names have the form either projects/{project_id}/locations/{region}/transferConfigs/{config_id} or projects/{project_id}/transferConfigs/{config_id}, where config_id is usually a UUID, even though it is not guaranteed or required. The name is ignored when creating a transfer config.
Returns
  • (::String) — Identifier. The resource name of the transfer config. Transfer config names have the form either projects/{project_id}/locations/{region}/transferConfigs/{config_id} or projects/{project_id}/transferConfigs/{config_id}, where config_id is usually a UUID, even though it is not guaranteed or required. The name is ignored when creating a transfer config.

#next_run_time

def next_run_time() -> ::Google::Protobuf::Timestamp
Returns

#notification_pubsub_topic

def notification_pubsub_topic() -> ::String
Returns
  • (::String) — Pub/Sub topic where notifications will be sent after transfer runs associated with this transfer config finish.

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

#notification_pubsub_topic=

def notification_pubsub_topic=(value) -> ::String
Parameter
  • value (::String) — Pub/Sub topic where notifications will be sent after transfer runs associated with this transfer config finish.

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

Returns
  • (::String) — Pub/Sub topic where notifications will be sent after transfer runs associated with this transfer config finish.

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

#owner_info

def owner_info() -> ::Google::Cloud::Bigquery::DataTransfer::V1::UserInfo
Returns
  • (::Google::Cloud::Bigquery::DataTransfer::V1::UserInfo) — Output only. Information about the user whose credentials are used to transfer data. Populated only for transferConfigs.get requests. In case the user information is not available, this field will not be populated.

#params

def params() -> ::Google::Protobuf::Struct
Returns
  • (::Google::Protobuf::Struct) — 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

#params=

def params=(value) -> ::Google::Protobuf::Struct
Parameter
  • value (::Google::Protobuf::Struct) — 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
  • (::Google::Protobuf::Struct) — 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

#schedule

def schedule() -> ::String
Returns
  • (::String) — Data transfer schedule. If the data source does not support a custom schedule, this should be empty. If it is empty, the default value for the data source will be used. The specified times are in UTC. Examples of valid format: 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15, and first sunday of quarter 00:00. See more explanation about the format here: https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format

    NOTE: The minimum interval time between recurring transfers depends on the data source; refer to the documentation for your data source.

#schedule=

def schedule=(value) -> ::String
Parameter
  • value (::String) — Data transfer schedule. If the data source does not support a custom schedule, this should be empty. If it is empty, the default value for the data source will be used. The specified times are in UTC. Examples of valid format: 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15, and first sunday of quarter 00:00. See more explanation about the format here: https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format

    NOTE: The minimum interval time between recurring transfers depends on the data source; refer to the documentation for your data source.

Returns
  • (::String) — Data transfer schedule. If the data source does not support a custom schedule, this should be empty. If it is empty, the default value for the data source will be used. The specified times are in UTC. Examples of valid format: 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15, and first sunday of quarter 00:00. See more explanation about the format here: https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format

    NOTE: The minimum interval time between recurring transfers depends on the data source; refer to the documentation for your data source.

#schedule_options

def schedule_options() -> ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleOptions
Returns

#schedule_options=

def schedule_options=(value) -> ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleOptions
Parameter
Returns

#schedule_options_v2

def schedule_options_v2() -> ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleOptionsV2
Returns

#schedule_options_v2=

def schedule_options_v2=(value) -> ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleOptionsV2
Parameter
Returns

#state

def state() -> ::Google::Cloud::Bigquery::DataTransfer::V1::TransferState
Returns

#update_time

def update_time() -> ::Google::Protobuf::Timestamp
Returns

#user_id

def user_id() -> ::Integer
Returns
  • (::Integer) — Deprecated. Unique ID of the user on whose behalf transfer is done.

#user_id=

def user_id=(value) -> ::Integer
Parameter
  • value (::Integer) — Deprecated. Unique ID of the user on whose behalf transfer is done.
Returns
  • (::Integer) — Deprecated. Unique ID of the user on whose behalf transfer is done.