public sealed class TransferConfig : IMessage<TransferConfig>, IEquatable<TransferConfig>, IDeepCloneable<TransferConfig>, IBufferMessage, IMessage
Reference documentation and code samples for the Google BigQuery Data Transfer v1 API class 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.
Implements
IMessageTransferConfig, IEquatableTransferConfig, IDeepCloneableTransferConfig, IBufferMessage, IMessageNamespace
Google.Cloud.BigQuery.DataTransfer.V1Assembly
Google.Cloud.BigQuery.DataTransfer.V1.dll
Constructors
TransferConfig()
public TransferConfig()
TransferConfig(TransferConfig)
public TransferConfig(TransferConfig other)
Parameter | |
---|---|
Name | Description |
other | TransferConfig |
Properties
DataRefreshWindowDays
public int DataRefreshWindowDays { get; set; }
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.
Property Value | |
---|---|
Type | Description |
int |
DataSourceId
public string DataSourceId { get; set; }
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
Property Value | |
---|---|
Type | Description |
string |
DatasetRegion
public string DatasetRegion { get; set; }
Output only. Region in which BigQuery dataset is located.
Property Value | |
---|---|
Type | Description |
string |
DestinationCase
public TransferConfig.DestinationOneofCase DestinationCase { get; }
Property Value | |
---|---|
Type | Description |
TransferConfigDestinationOneofCase |
DestinationDatasetId
public string DestinationDatasetId { get; set; }
The BigQuery target dataset id.
Property Value | |
---|---|
Type | Description |
string |
Disabled
public bool Disabled { get; set; }
Is this config disabled. When set to true, no runs are scheduled for a given transfer.
Property Value | |
---|---|
Type | Description |
bool |
DisplayName
public string DisplayName { get; set; }
User specified display name for the data transfer.
Property Value | |
---|---|
Type | Description |
string |
EmailPreferences
public EmailPreferences EmailPreferences { get; set; }
Email notifications will be sent according to these preferences to the email address of the user who owns this transfer config.
Property Value | |
---|---|
Type | Description |
EmailPreferences |
EncryptionConfiguration
public EncryptionConfiguration EncryptionConfiguration { get; set; }
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.
Property Value | |
---|---|
Type | Description |
EncryptionConfiguration |
HasDestinationDatasetId
public bool HasDestinationDatasetId { get; }
Gets whether the "destination_dataset_id" field is set
Property Value | |
---|---|
Type | Description |
bool |
Name
public string Name { get; set; }
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.
Property Value | |
---|---|
Type | Description |
string |
NextRunTime
public Timestamp NextRunTime { get; set; }
Output only. Next time when data transfer will run.
Property Value | |
---|---|
Type | Description |
Timestamp |
NotificationPubsubTopic
public string NotificationPubsubTopic { get; set; }
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}
Property Value | |
---|---|
Type | Description |
string |
OwnerInfo
public UserInfo OwnerInfo { get; set; }
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.
Property Value | |
---|---|
Type | Description |
UserInfo |
Params
public Struct Params { get; set; }
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
Property Value | |
---|---|
Type | Description |
Struct |
Schedule
public string Schedule { get; set; }
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.
Property Value | |
---|---|
Type | Description |
string |
ScheduleOptions
public ScheduleOptions ScheduleOptions { get; set; }
Options customizing the data transfer schedule.
Property Value | |
---|---|
Type | Description |
ScheduleOptions |
State
public TransferState State { get; set; }
Output only. State of the most recently updated transfer run.
Property Value | |
---|---|
Type | Description |
TransferState |
TransferConfigName
public TransferConfigName TransferConfigName { get; set; }
TransferConfigName-typed view over the Name resource name property.
Property Value | |
---|---|
Type | Description |
TransferConfigName |
UpdateTime
public Timestamp UpdateTime { get; set; }
Output only. Data transfer modification time. Ignored by server on input.
Property Value | |
---|---|
Type | Description |
Timestamp |
UserId
public long UserId { get; set; }
Deprecated. Unique ID of the user on whose behalf transfer is done.
Property Value | |
---|---|
Type | Description |
long |