Looker Studio 進階服務

如果連接器會從 BigQuery 擷取資料，您就可以使用 Looker Studio 進階服務來最佳化連接器。與其直接呼叫 BigQuery API，您無須直接呼叫 BigQuery API，只要提供查詢設定，Looker Studio 就會為您擷取資料和結構定義。

運作方式

使用 Looker Studio Advanced Services 的社群連接器，運作方式與一般連接器類似。

主要差異在於執行 getSchema() 和/或 getData() 函式的預期回應。這些函式可能會傳回查詢設定，而非擷取及傳回結構定義和資料。傳回查詢設定後，Looker Studio 將根據您提供的查詢設定直接擷取結構定義和/或資料。

開發連接器

使用 Looker Studio Advanced Services 的社群連接器與一般連接器相同，但有兩個例外狀況。

  1. 其他資訊清單鍵
  2. getSchema() 和/或 getData() 提供的其他回應

資訊清單參考資料

在資訊清單中，將下列屬性設為 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)
}