Class TransferConfig.Builder (2.31.0)

public static final class TransferConfig.Builder extends GeneratedMessageV3.Builder<TransferConfig.Builder> implements TransferConfigOrBuilder

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.

Protobuf type google.cloud.bigquery.datatransfer.v1.TransferConfig

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public TransferConfig.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
TransferConfig.Builder
Overrides

build()

public TransferConfig build()
Returns
TypeDescription
TransferConfig

buildPartial()

public TransferConfig buildPartial()
Returns
TypeDescription
TransferConfig

clear()

public TransferConfig.Builder clear()
Returns
TypeDescription
TransferConfig.Builder
Overrides

clearDataRefreshWindowDays()

public TransferConfig.Builder clearDataRefreshWindowDays()

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.

int32 data_refresh_window_days = 12;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearDataSourceId()

public TransferConfig.Builder clearDataSourceId()

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

string data_source_id = 5;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearDatasetRegion()

public TransferConfig.Builder clearDatasetRegion()

Output only. Region in which BigQuery dataset is located.

string dataset_region = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearDestination()

public TransferConfig.Builder clearDestination()
Returns
TypeDescription
TransferConfig.Builder

clearDestinationDatasetId()

public TransferConfig.Builder clearDestinationDatasetId()

The BigQuery target dataset id.

string destination_dataset_id = 2;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearDisabled()

public TransferConfig.Builder clearDisabled()

Is this config disabled. When set to true, no runs are scheduled for a given transfer.

bool disabled = 13;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearDisplayName()

public TransferConfig.Builder clearDisplayName()

User specified display name for the data transfer.

string display_name = 3;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearEmailPreferences()

public TransferConfig.Builder clearEmailPreferences()

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Returns
TypeDescription
TransferConfig.Builder

clearEncryptionConfiguration()

public TransferConfig.Builder clearEncryptionConfiguration()

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Returns
TypeDescription
TransferConfig.Builder

clearField(Descriptors.FieldDescriptor field)

public TransferConfig.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
TransferConfig.Builder
Overrides

clearName()

public TransferConfig.Builder clearName()

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.

string name = 1;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearNextRunTime()

public TransferConfig.Builder clearNextRunTime()

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TransferConfig.Builder

clearNotificationPubsubTopic()

public TransferConfig.Builder clearNotificationPubsubTopic()

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}/topics/{topic}

string notification_pubsub_topic = 15;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public TransferConfig.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
TransferConfig.Builder
Overrides

clearOwnerInfo()

public TransferConfig.Builder clearOwnerInfo()

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TransferConfig.Builder

clearParams()

public TransferConfig.Builder clearParams()

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

.google.protobuf.Struct params = 9;

Returns
TypeDescription
TransferConfig.Builder

clearSchedule()

public TransferConfig.Builder clearSchedule()

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.

string schedule = 7;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearScheduleOptions()

public TransferConfig.Builder clearScheduleOptions()

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Returns
TypeDescription
TransferConfig.Builder

clearState()

public TransferConfig.Builder clearState()

Output only. State of the most recently updated transfer run.

.google.cloud.bigquery.datatransfer.v1.TransferState state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clearUpdateTime()

public TransferConfig.Builder clearUpdateTime()

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TransferConfig.Builder

clearUserId()

public TransferConfig.Builder clearUserId()

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

int64 user_id = 11;

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

clone()

public TransferConfig.Builder clone()
Returns
TypeDescription
TransferConfig.Builder
Overrides

getDataRefreshWindowDays()

public int getDataRefreshWindowDays()

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.

int32 data_refresh_window_days = 12;

Returns
TypeDescription
int

The dataRefreshWindowDays.

getDataSourceId()

public String getDataSourceId()

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

string data_source_id = 5;

Returns
TypeDescription
String

The dataSourceId.

getDataSourceIdBytes()

public ByteString getDataSourceIdBytes()

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

string data_source_id = 5;

Returns
TypeDescription
ByteString

The bytes for dataSourceId.

getDatasetRegion()

public String getDatasetRegion()

Output only. Region in which BigQuery dataset is located.

string dataset_region = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
String

The datasetRegion.

getDatasetRegionBytes()

public ByteString getDatasetRegionBytes()

Output only. Region in which BigQuery dataset is located.

string dataset_region = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ByteString

The bytes for datasetRegion.

getDefaultInstanceForType()

public TransferConfig getDefaultInstanceForType()
Returns
TypeDescription
TransferConfig

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getDestinationCase()

public TransferConfig.DestinationCase getDestinationCase()
Returns
TypeDescription
TransferConfig.DestinationCase

getDestinationDatasetId()

public String getDestinationDatasetId()

The BigQuery target dataset id.

string destination_dataset_id = 2;

Returns
TypeDescription
String

The destinationDatasetId.

getDestinationDatasetIdBytes()

public ByteString getDestinationDatasetIdBytes()

The BigQuery target dataset id.

string destination_dataset_id = 2;

Returns
TypeDescription
ByteString

The bytes for destinationDatasetId.

getDisabled()

public boolean getDisabled()

Is this config disabled. When set to true, no runs are scheduled for a given transfer.

bool disabled = 13;

Returns
TypeDescription
boolean

The disabled.

getDisplayName()

public String getDisplayName()

User specified display name for the data transfer.

string display_name = 3;

Returns
TypeDescription
String

The displayName.

getDisplayNameBytes()

public ByteString getDisplayNameBytes()

User specified display name for the data transfer.

string display_name = 3;

Returns
TypeDescription
ByteString

The bytes for displayName.

getEmailPreferences()

public EmailPreferences getEmailPreferences()

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Returns
TypeDescription
EmailPreferences

The emailPreferences.

getEmailPreferencesBuilder()

public EmailPreferences.Builder getEmailPreferencesBuilder()

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Returns
TypeDescription
EmailPreferences.Builder

getEmailPreferencesOrBuilder()

public EmailPreferencesOrBuilder getEmailPreferencesOrBuilder()

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Returns
TypeDescription
EmailPreferencesOrBuilder

getEncryptionConfiguration()

public EncryptionConfiguration getEncryptionConfiguration()

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Returns
TypeDescription
EncryptionConfiguration

The encryptionConfiguration.

getEncryptionConfigurationBuilder()

public EncryptionConfiguration.Builder getEncryptionConfigurationBuilder()

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Returns
TypeDescription
EncryptionConfiguration.Builder

getEncryptionConfigurationOrBuilder()

public EncryptionConfigurationOrBuilder getEncryptionConfigurationOrBuilder()

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Returns
TypeDescription
EncryptionConfigurationOrBuilder

getName()

public String getName()

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.

string name = 1;

Returns
TypeDescription
String

The name.

getNameBytes()

public ByteString getNameBytes()

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.

string name = 1;

Returns
TypeDescription
ByteString

The bytes for name.

getNextRunTime()

public Timestamp getNextRunTime()

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Timestamp

The nextRunTime.

getNextRunTimeBuilder()

public Timestamp.Builder getNextRunTimeBuilder()

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Builder

getNextRunTimeOrBuilder()

public TimestampOrBuilder getNextRunTimeOrBuilder()

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TimestampOrBuilder

getNotificationPubsubTopic()

public String getNotificationPubsubTopic()

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}/topics/{topic}

string notification_pubsub_topic = 15;

Returns
TypeDescription
String

The notificationPubsubTopic.

getNotificationPubsubTopicBytes()

public ByteString getNotificationPubsubTopicBytes()

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}/topics/{topic}

string notification_pubsub_topic = 15;

Returns
TypeDescription
ByteString

The bytes for notificationPubsubTopic.

getOwnerInfo()

public UserInfo getOwnerInfo()

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
UserInfo

The ownerInfo.

getOwnerInfoBuilder()

public UserInfo.Builder getOwnerInfoBuilder()

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
UserInfo.Builder

getOwnerInfoOrBuilder()

public UserInfoOrBuilder getOwnerInfoOrBuilder()

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
UserInfoOrBuilder

getParams()

public Struct getParams()

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

.google.protobuf.Struct params = 9;

Returns
TypeDescription
Struct

The params.

getParamsBuilder()

public Struct.Builder getParamsBuilder()

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

.google.protobuf.Struct params = 9;

Returns
TypeDescription
Builder

getParamsOrBuilder()

public StructOrBuilder getParamsOrBuilder()

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

.google.protobuf.Struct params = 9;

Returns
TypeDescription
StructOrBuilder

getSchedule()

public String getSchedule()

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.

string schedule = 7;

Returns
TypeDescription
String

The schedule.

getScheduleBytes()

public ByteString getScheduleBytes()

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.

string schedule = 7;

Returns
TypeDescription
ByteString

The bytes for schedule.

getScheduleOptions()

public ScheduleOptions getScheduleOptions()

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Returns
TypeDescription
ScheduleOptions

The scheduleOptions.

getScheduleOptionsBuilder()

public ScheduleOptions.Builder getScheduleOptionsBuilder()

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Returns
TypeDescription
ScheduleOptions.Builder

getScheduleOptionsOrBuilder()

public ScheduleOptionsOrBuilder getScheduleOptionsOrBuilder()

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Returns
TypeDescription
ScheduleOptionsOrBuilder

getState()

public TransferState getState()

Output only. State of the most recently updated transfer run.

.google.cloud.bigquery.datatransfer.v1.TransferState state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TransferState

The state.

getStateValue()

public int getStateValue()

Output only. State of the most recently updated transfer run.

.google.cloud.bigquery.datatransfer.v1.TransferState state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

The enum numeric value on the wire for state.

getUpdateTime()

public Timestamp getUpdateTime()

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Timestamp

The updateTime.

getUpdateTimeBuilder()

public Timestamp.Builder getUpdateTimeBuilder()

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Builder

getUpdateTimeOrBuilder()

public TimestampOrBuilder getUpdateTimeOrBuilder()

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TimestampOrBuilder

getUserId()

public long getUserId()

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

int64 user_id = 11;

Returns
TypeDescription
long

The userId.

hasDestinationDatasetId()

public boolean hasDestinationDatasetId()

The BigQuery target dataset id.

string destination_dataset_id = 2;

Returns
TypeDescription
boolean

Whether the destinationDatasetId field is set.

hasEmailPreferences()

public boolean hasEmailPreferences()

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Returns
TypeDescription
boolean

Whether the emailPreferences field is set.

hasEncryptionConfiguration()

public boolean hasEncryptionConfiguration()

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Returns
TypeDescription
boolean

Whether the encryptionConfiguration field is set.

hasNextRunTime()

public boolean hasNextRunTime()

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the nextRunTime field is set.

hasOwnerInfo()

public boolean hasOwnerInfo()

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the ownerInfo field is set.

hasParams()

public boolean hasParams()

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

.google.protobuf.Struct params = 9;

Returns
TypeDescription
boolean

Whether the params field is set.

hasScheduleOptions()

public boolean hasScheduleOptions()

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Returns
TypeDescription
boolean

Whether the scheduleOptions field is set.

hasUpdateTime()

public boolean hasUpdateTime()

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the updateTime field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeEmailPreferences(EmailPreferences value)

public TransferConfig.Builder mergeEmailPreferences(EmailPreferences value)

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Parameter
NameDescription
valueEmailPreferences
Returns
TypeDescription
TransferConfig.Builder

mergeEncryptionConfiguration(EncryptionConfiguration value)

public TransferConfig.Builder mergeEncryptionConfiguration(EncryptionConfiguration value)

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Parameter
NameDescription
valueEncryptionConfiguration
Returns
TypeDescription
TransferConfig.Builder

mergeFrom(TransferConfig other)

public TransferConfig.Builder mergeFrom(TransferConfig other)
Parameter
NameDescription
otherTransferConfig
Returns
TypeDescription
TransferConfig.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public TransferConfig.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
TransferConfig.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public TransferConfig.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
TransferConfig.Builder
Overrides

mergeNextRunTime(Timestamp value)

public TransferConfig.Builder mergeNextRunTime(Timestamp value)

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
TransferConfig.Builder

mergeOwnerInfo(UserInfo value)

public TransferConfig.Builder mergeOwnerInfo(UserInfo value)

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueUserInfo
Returns
TypeDescription
TransferConfig.Builder

mergeParams(Struct value)

public TransferConfig.Builder mergeParams(Struct value)

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

.google.protobuf.Struct params = 9;

Parameter
NameDescription
valueStruct
Returns
TypeDescription
TransferConfig.Builder

mergeScheduleOptions(ScheduleOptions value)

public TransferConfig.Builder mergeScheduleOptions(ScheduleOptions value)

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Parameter
NameDescription
valueScheduleOptions
Returns
TypeDescription
TransferConfig.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final TransferConfig.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
TransferConfig.Builder
Overrides

mergeUpdateTime(Timestamp value)

public TransferConfig.Builder mergeUpdateTime(Timestamp value)

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
TransferConfig.Builder

setDataRefreshWindowDays(int value)

public TransferConfig.Builder setDataRefreshWindowDays(int value)

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.

int32 data_refresh_window_days = 12;

Parameter
NameDescription
valueint

The dataRefreshWindowDays to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDataSourceId(String value)

public TransferConfig.Builder setDataSourceId(String value)

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

string data_source_id = 5;

Parameter
NameDescription
valueString

The dataSourceId to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDataSourceIdBytes(ByteString value)

public TransferConfig.Builder setDataSourceIdBytes(ByteString value)

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

string data_source_id = 5;

Parameter
NameDescription
valueByteString

The bytes for dataSourceId to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDatasetRegion(String value)

public TransferConfig.Builder setDatasetRegion(String value)

Output only. Region in which BigQuery dataset is located.

string dataset_region = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueString

The datasetRegion to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDatasetRegionBytes(ByteString value)

public TransferConfig.Builder setDatasetRegionBytes(ByteString value)

Output only. Region in which BigQuery dataset is located.

string dataset_region = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueByteString

The bytes for datasetRegion to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDestinationDatasetId(String value)

public TransferConfig.Builder setDestinationDatasetId(String value)

The BigQuery target dataset id.

string destination_dataset_id = 2;

Parameter
NameDescription
valueString

The destinationDatasetId to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDestinationDatasetIdBytes(ByteString value)

public TransferConfig.Builder setDestinationDatasetIdBytes(ByteString value)

The BigQuery target dataset id.

string destination_dataset_id = 2;

Parameter
NameDescription
valueByteString

The bytes for destinationDatasetId to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDisabled(boolean value)

public TransferConfig.Builder setDisabled(boolean value)

Is this config disabled. When set to true, no runs are scheduled for a given transfer.

bool disabled = 13;

Parameter
NameDescription
valueboolean

The disabled to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDisplayName(String value)

public TransferConfig.Builder setDisplayName(String value)

User specified display name for the data transfer.

string display_name = 3;

Parameter
NameDescription
valueString

The displayName to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setDisplayNameBytes(ByteString value)

public TransferConfig.Builder setDisplayNameBytes(ByteString value)

User specified display name for the data transfer.

string display_name = 3;

Parameter
NameDescription
valueByteString

The bytes for displayName to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setEmailPreferences(EmailPreferences value)

public TransferConfig.Builder setEmailPreferences(EmailPreferences value)

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Parameter
NameDescription
valueEmailPreferences
Returns
TypeDescription
TransferConfig.Builder

setEmailPreferences(EmailPreferences.Builder builderForValue)

public TransferConfig.Builder setEmailPreferences(EmailPreferences.Builder builderForValue)

Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.

.google.cloud.bigquery.datatransfer.v1.EmailPreferences email_preferences = 18;

Parameter
NameDescription
builderForValueEmailPreferences.Builder
Returns
TypeDescription
TransferConfig.Builder

setEncryptionConfiguration(EncryptionConfiguration value)

public TransferConfig.Builder setEncryptionConfiguration(EncryptionConfiguration value)

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Parameter
NameDescription
valueEncryptionConfiguration
Returns
TypeDescription
TransferConfig.Builder

setEncryptionConfiguration(EncryptionConfiguration.Builder builderForValue)

public TransferConfig.Builder setEncryptionConfiguration(EncryptionConfiguration.Builder builderForValue)

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.

.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration encryption_configuration = 28;

Parameter
NameDescription
builderForValueEncryptionConfiguration.Builder
Returns
TypeDescription
TransferConfig.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public TransferConfig.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
TransferConfig.Builder
Overrides

setName(String value)

public TransferConfig.Builder setName(String value)

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.

string name = 1;

Parameter
NameDescription
valueString

The name to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setNameBytes(ByteString value)

public TransferConfig.Builder setNameBytes(ByteString value)

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.

string name = 1;

Parameter
NameDescription
valueByteString

The bytes for name to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setNextRunTime(Timestamp value)

public TransferConfig.Builder setNextRunTime(Timestamp value)

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
TransferConfig.Builder

setNextRunTime(Timestamp.Builder builderForValue)

public TransferConfig.Builder setNextRunTime(Timestamp.Builder builderForValue)

Output only. Next time when data transfer will run.

.google.protobuf.Timestamp next_run_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
TransferConfig.Builder

setNotificationPubsubTopic(String value)

public TransferConfig.Builder setNotificationPubsubTopic(String value)

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}/topics/{topic}

string notification_pubsub_topic = 15;

Parameter
NameDescription
valueString

The notificationPubsubTopic to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setNotificationPubsubTopicBytes(ByteString value)

public TransferConfig.Builder setNotificationPubsubTopicBytes(ByteString value)

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}/topics/{topic}

string notification_pubsub_topic = 15;

Parameter
NameDescription
valueByteString

The bytes for notificationPubsubTopic to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setOwnerInfo(UserInfo value)

public TransferConfig.Builder setOwnerInfo(UserInfo value)

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueUserInfo
Returns
TypeDescription
TransferConfig.Builder

setOwnerInfo(UserInfo.Builder builderForValue)

public TransferConfig.Builder setOwnerInfo(UserInfo.Builder builderForValue)

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.

optional .google.cloud.bigquery.datatransfer.v1.UserInfo owner_info = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
builderForValueUserInfo.Builder
Returns
TypeDescription
TransferConfig.Builder

setParams(Struct value)

public TransferConfig.Builder setParams(Struct value)

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

.google.protobuf.Struct params = 9;

Parameter
NameDescription
valueStruct
Returns
TypeDescription
TransferConfig.Builder

setParams(Struct.Builder builderForValue)

public TransferConfig.Builder setParams(Struct.Builder builderForValue)

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

.google.protobuf.Struct params = 9;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
TransferConfig.Builder

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public TransferConfig.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
TransferConfig.Builder
Overrides

setSchedule(String value)

public TransferConfig.Builder setSchedule(String value)

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.

string schedule = 7;

Parameter
NameDescription
valueString

The schedule to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setScheduleBytes(ByteString value)

public TransferConfig.Builder setScheduleBytes(ByteString value)

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.

string schedule = 7;

Parameter
NameDescription
valueByteString

The bytes for schedule to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setScheduleOptions(ScheduleOptions value)

public TransferConfig.Builder setScheduleOptions(ScheduleOptions value)

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Parameter
NameDescription
valueScheduleOptions
Returns
TypeDescription
TransferConfig.Builder

setScheduleOptions(ScheduleOptions.Builder builderForValue)

public TransferConfig.Builder setScheduleOptions(ScheduleOptions.Builder builderForValue)

Options customizing the data transfer schedule.

.google.cloud.bigquery.datatransfer.v1.ScheduleOptions schedule_options = 24;

Parameter
NameDescription
builderForValueScheduleOptions.Builder
Returns
TypeDescription
TransferConfig.Builder

setState(TransferState value)

public TransferConfig.Builder setState(TransferState value)

Output only. State of the most recently updated transfer run.

.google.cloud.bigquery.datatransfer.v1.TransferState state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueTransferState

The state to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setStateValue(int value)

public TransferConfig.Builder setStateValue(int value)

Output only. State of the most recently updated transfer run.

.google.cloud.bigquery.datatransfer.v1.TransferState state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueint

The enum numeric value on the wire for state to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final TransferConfig.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
TransferConfig.Builder
Overrides

setUpdateTime(Timestamp value)

public TransferConfig.Builder setUpdateTime(Timestamp value)

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
TransferConfig.Builder

setUpdateTime(Timestamp.Builder builderForValue)

public TransferConfig.Builder setUpdateTime(Timestamp.Builder builderForValue)

Output only. Data transfer modification time. Ignored by server on input.

.google.protobuf.Timestamp update_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
TransferConfig.Builder

setUserId(long value)

public TransferConfig.Builder setUserId(long value)

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

int64 user_id = 11;

Parameter
NameDescription
valuelong

The userId to set.

Returns
TypeDescription
TransferConfig.Builder

This builder for chaining.