本頁面由 Cloud Translation API 翻譯而成。

資料類型和語意類型

建立社群連接器時，您在結構定義需要資料類型資料類型定義了欄位的原始類型，例如 BOOLEAN、STRING、NUMBER 等

除了資料類型外，Looker Studio 也會使用語意類型。語意類型有助於說明資料代表的資訊種類。適用對象舉例來說，含有 NUMBER 資料類型的欄位在語意上可能代表貨幣金額或百分比，以及含有 STRING 資料類型的欄位，可能會具有語意代表城市如要查看可用的語意類型，請參閱語意類型說明文件

社群連接器結構定義和 Looker Studio 欄位

定義社群連接器的架構時，您可以屬性將決定該欄位的呈現方式在 Looker Studio 中使用的函式例如：

conceptType 是在連接器結構定義中使用 conceptType 屬性定義。這個屬性會決定該欄位是否會被視為維度或指標。查看指標和維度之間的差異於維度和指標：
語意類型可以屬性是在連接器結構定義中定義，或者由系統自動偵測透過 Looker Studio data type 屬性以及連接器傳回的資料值。詳情請見自動語意類型偵測的詳細資訊運作原理
「匯總類型」可決定指標值 (維度) ) 可以重新匯總。設定 semantics.isReaggregatable 屬性設為 true 會預設為 SUM 匯總，否則會已設為 Auto。您也可以為以下項目手動設定預設匯總類型：可匯總的欄位 defaultAggregationType敬上資源。

在 Looker Studio 中設定及連結連接器時，編輯器會根據您定義的方式，顯示連接器的完整架構屬性。如果您加入了語意類型，這些類型就會顯示順序如果使用自動偵測語意類型，然後會顯示原本的偵測結果欄位畫面

設定語意資訊

設定語意資訊的方法有兩種。您可以在手動偵測語意，或是仰賴 Looker Studio 自動偵測。

舉例來說，如果您的「數字」在語意上代表美元 Looker Studio 無法自動偵測這個語意類型。此外，自動語意偵測功能需要 Looker Studio 才能建立資料擷取結構定義中每個欄位的呼叫如果您要手動指定，系統就不會發出任何資料擷取呼叫。如果您知道資料的語意類型 (例如貨幣、百分比、日期等) 建議在結構定義中明確設定這個引數，以提升準確度和效能理由。

手動設定語意類型 (建議)

如果您知道自己的語意類型，可以手動定義每種類型的 semantics 詳細瞭解有哪些房源出現在欄位參考資料頁面中。如果發生以下情況：因此建議您定義手動語意類型每個欄位的 semanticType 和 semanticGroup。手動提供屬性，則無法執行自動語意類型偵測程序。如果發生以下情況：手動設定部分欄位 (非全部) 視 dataType 而定，將預設值指定為 Text、Number 或 Boolean 會為欄位指定屬性。

以下是手動設定語意的簡易結構定義範例。已將 Income 設為貨幣，Filing Year 則設為日期。

data-studio/semantics.gs

前往 GitHub 查看

var schema = [
  {
    'name': 'Income',
    'label': 'Income (in USD)',
    'dataType': 'NUMBER',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'CURRENCY',
      'semanticType': 'CURRENCY_USD'
    }
  }, {
    'name': 'Filing Year',
    'label': 'Year in which you filed the taxes.',
    'dataType': 'STRING',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'DATE_OR_TIME',
      'semanticType': 'YEAR'
    }
  }
];

手動語意類型疑難排解

如果您為基礎資料設定錯誤的語意類型，無法正常運作。這可能很難測試，但您必須能夠協助找出問題

從資料傳回 2 或 3 列 (而非所有資料列)，然後手動傳回進行搜尋。
在 Looker Studio 中僅使用目標欄位建立資料表檢查。
Geo 和 Date 欄位數量最多，因此請密切留意字串格式。

自動語意類型偵測

如果您尚未在結構定義中定義任何語意類型，則 Looker Studio 就會根據 data type 屬性和格式連接器傳回的資料值。

自動偵測程序的步驟如下：

執行 getSchema 函式社群連接器
逐批執行連接器結構定義和問題中定義的欄位值 getData 要求欄位。使用 sampleExtraction 參數執行 getData 要求設為 true，表示資料要求用於語意偵測。
視欄位資料類型和 getData 要求，請識別欄位的語意類型。

，瞭解如何調查及移除這項存取權。

處理自動語意類型偵測的選項

Looker Studio 執行社群連接器的 getData 函式時，則傳入的要求會包含 sampleExtraction 屬性，會設為 true。根據連接器只會用於 Looker Studio 識別語意類型這個欄位。該值不會用於其他用途，因此不會需要來自外部來源的實際資料。

您可以透過下列幾種方式在程式碼中改善語意類型偵測功能：

建議：傳遞預先定義的值
為最能代表語意的各個欄位傳回預先定義的值欄位類型，且 Looker Studio 能正確偵測。舉例來說，如果欄位的語意類型是 Country，則會傳回值，例如指定義大利的 IT。這種做法的另一個優點速度會快上許多，因為該應用程式不需您發出 HTTP 要求第三方資料服務
只傳回「n」筆記錄
如果您擷取資料的第三方服務支援資料列限制當要求資料時，請將一小部分資料列傳回 Looker Studio 完整資料集這樣可限制您傳送或接收的資料量 Looker Studio。
要求所有資料欄並快取回應
如果可以要求第三方服務的所有資料欄您將在第一個語意偵測要求中，並快取結果。適用對象後續的語意偵測要求會從快取中擷取資料欄值而不要向第三方服務提出額外的 HTTP 要求
不執行其他動作
您可以不按照 sampleExtraction已設為 true。這會導致語意偵測功能由於 Looker Studio 必須擷取語意偵測程序。此外，這會影響您的外部資料來源，因為許多語意偵測要求就會平行執行

用於自動語意類型偵測的識別格式

日期與時間

YYYY/MM/DD-HH:MM:SS
YYYY-MM-DD [HH:MM:SS[.uuuuuu]]
YYYY/MM/DD [HH:MM:SS[.uuuuuu]]
YYYYMMDD [HH:MM:SS[.uuuuuu]]
Sat, 24 May 2008 20:09:47 GMT
2008-05-24T20:09:47Z
時間：秒、微量、毫升和奈米的週期。