Skip to main content

data_sources

Creates, updates, deletes, gets or lists a data_sources resource.

Overview

Namedata_sources
TypeResource
Idgoogle.bigquerydatatransfer.data_sources

Fields

NameDatatypeDescription
namestringOutput only. Data source resource name.
descriptionstringUser friendly data source description string.
authorizationTypestringIndicates the type of authorization.
clientIdstringData source client id which should be used to receive refresh token.
dataRefreshTypestringSpecifies whether the data source supports automatic data refresh for the past few days, and how it's supported. For some data sources, data might not be complete until a few days later, so it's useful to refresh data automatically.
dataSourceIdstringData source id.
defaultDataRefreshWindowDaysintegerDefault data refresh window on days. Only meaningful when data_refresh_type = SLIDING_WINDOW.
defaultSchedulestringDefault data transfer schedule. Examples of valid schedules include: 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15, and first sunday of quarter 00:00.
displayNamestringUser friendly data source name.
helpUrlstringUrl for the help document for this data source.
manualRunsDisabledbooleanDisables backfilling and manual run scheduling for the data source.
minimumScheduleIntervalstringThe minimum interval for scheduler to schedule runs.
parametersarrayData source parameters.
scopesarrayApi auth scopes for which refresh token needs to be obtained. These are scopes needed by a data source to prepare data and ingest them into BigQuery, e.g., https://www.googleapis.com/auth/bigquery
supportsCustomSchedulebooleanSpecifies whether the data source supports a user defined schedule, or operates on the default schedule. When set to true, user can override default schedule.
supportsMultipleTransfersbooleanDeprecated. This field has no effect.
transferTypestringDeprecated. This field has no effect.
updateDeadlineSecondsintegerThe number of seconds to wait for an update from the data source before the Data Transfer Service marks the transfer as FAILED.

Methods

NameAccessible byRequired ParamsDescription
projects_data_sources_getSELECTdataSourcesId, projectsIdRetrieves a supported data source and returns its settings.
projects_data_sources_listSELECTprojectsIdLists supported data sources and returns their settings.
projects_locations_data_sources_getSELECTdataSourcesId, locationsId, projectsIdRetrieves a supported data source and returns its settings.
projects_locations_data_sources_listSELECTlocationsId, projectsIdLists supported data sources and returns their settings.
projects_data_sources_check_valid_credsEXECdataSourcesId, projectsIdReturns true if valid credentials exist for the given data source and requesting user.
projects_locations_data_sources_check_valid_credsEXECdataSourcesId, locationsId, projectsIdReturns true if valid credentials exist for the given data source and requesting user.

SELECT examples

Lists supported data sources and returns their settings.

SELECT
name,
description,
authorizationType,
clientId,
dataRefreshType,
dataSourceId,
defaultDataRefreshWindowDays,
defaultSchedule,
displayName,
helpUrl,
manualRunsDisabled,
minimumScheduleInterval,
parameters,
scopes,
supportsCustomSchedule,
supportsMultipleTransfers,
transferType,
updateDeadlineSeconds
FROM google.bigquerydatatransfer.data_sources
WHERE projectsId = '{{ projectsId }}';