如果連接器會從 BigQuery 擷取資料,您就可以使用 Looker Studio 進階服務來最佳化連接器。與其直接呼叫 BigQuery API,您無須直接呼叫 BigQuery API,只要提供查詢設定,Looker Studio 就會為您擷取資料和結構定義。
運作方式
使用 Looker Studio Advanced Services 的社群連接器,運作方式與一般連接器類似。
主要差異在於執行 getSchema()
和/或 getData()
函式的預期回應。這些函式可能會傳回查詢設定,而非擷取及傳回結構定義和資料。傳回查詢設定後,Looker Studio 將根據您提供的查詢設定直接擷取結構定義和/或資料。
開發連接器
使用 Looker Studio Advanced Services 的社群連接器與一般連接器相同,但有兩個例外狀況。
資訊清單參考資料
在資訊清單中,將下列屬性設為 true
。
- 如果是
getSchema()
,請使用dataStudio.advancedServices.schema
屬性 - 如果是
getData()
,請使用dataStudio.advancedServices.data
屬性
true
值表示連接器會針對個別函式傳回查詢設定,而非標準回應。
如要使用標準 getSchema()
回應自行定義結構定義,請在資訊清單中將 dataStudio.advancedServices.schema
設為 false
,或是省略這個屬性。當結構定義中的所有欄位無法以單一 BigQuery 查詢表示 (例如:當您建立多結構定義連接器時),才需要執行此操作。
由於 BigQuery 查詢將代表授權使用者執行,因此您也必須在資訊清單中加入 BigQuery OAuth 範圍 ("https://www.googleapis.com/auth/bigquery.readonly"
) 以要求授權。
以下為使用授權使用者憑證連線至 BigQuery 的連接器資訊清單:
{
"dataStudio": {
"name": "BigQuery Public Dataset Demo",
"logoUrl": "https://www.gstatic.com/images/branding/product/1x/data_connector_48dp.png",
"company": "Looker DevRel",
"companyUrl": "https://developers.google.com/looker-studio/",
"addOnUrl": "https://developers.google.com/looker-studio/",
"supportUrl": "https://developers.google.com/looker-studio/",
"description": "Use BigQuery public dataset with Looker Studio's Advanced Services.",
"advancedServices": {
"schema": true,
"data": true
}
},
"oauthScopes": ["https://www.googleapis.com/auth/bigquery.readonly"]
}
如果您使用服務帳戶存取 BigQuery,那麼資訊清單中不需要 bigquery.readonly
OAuth 範圍。不過,應該將範圍加入服務帳戶的範圍清單。
getData
和 getSchema
參考資源
使用 Looker Studio Advanced Services 的連接器會傳回 getSchema()
和/或 getData()
的查詢設定物件。視資料來源而定,這項設定可能需要額外屬性。
以下範例說明如何使用 DataStudioApp 服務建立這個設定物件:
var bqTypes = DataStudioApp.createCommunityConnector().BigQueryParameterType;
var configuration = DataStudioApp.createCommunityConnector().newBigQueryConfig()
// BigQuery billing project's Id.
.setBillingProjectId('billingProjectId')
// The query that will be executed.
.setQuery('myQueryString')
// Set to `true` to use StandardSQL.
.setUseStandardSql(true)
// The accessToken used for service execution.
.setAccessToken('myAccessToken')
// Adding a `STRING` query parameter. Other supported types are `BOOL`,
// `FLOAT64`, and `INT64`.
.addQueryParameter('myUrlParameterName', bqTypes.STRING, 'myUrlParameterValue')
.build();
getSchema()
和 getData()
函式範例
var sqlString = "" +
"SELECT " +
" _TABLE_SUFFIX AS yyyymm, " +
" ROUND(SUM(IF(fcp.start < @fast_fcp, fcp.density, 0)), 4) AS fast_fcp, " +
" ROUND(SUM(IF(fcp.start >= 1000 AND fcp.start < 3000, fcp.density, 0)), 4) AS avg_fcp, " +
" ROUND(SUM(IF(fcp.start >= 3000, fcp.density, 0)), 4) AS slow_fcp " +
"FROM " +
" `chrome-ux-report.all.*`, " +
" UNNEST(first_contentful_paint.histogram.bin) AS fcp " +
"WHERE " +
" origin = @url " +
"GROUP BY " +
" yyyymm " +
"ORDER BY " +
" yyyymm ";
function getQueryConfig(request) {
var url = (request.configParams && request.configParams.url);
var projectId = (request.configParams && request.configParams.projectId);
var authToken = ScriptApp.getOAuthToken();
return DataStudioApp.createCommunityConnector().newBigQueryConfig()
.setAccessToken(authToken)
.setUseStandardSql(true)
.setBillingProjectId(projectId)
.setQuery(sqlString)
.addQueryParameter('url', bqTypes.STRING, url)
.addQueryParameter('fast_fcp', bqTypes.INT64, '' + 1000)
.build();
}
function getSchema(request) {
return getQueryConfig(request);
}
function getData(request) {
return getQueryConfig(request)
}