Looker 連接器需求、限制、功能支援和疑難排解總覽

本頁面將說明 Looker Studio 中的 Looker 連接器,主題包括:

Looker 執行個體需求

如要在 Looker Studio 中使用 Looker 連接器設定 Looker 資料來源,請先確認 Looker 執行個體符合下列需求:

Looker 連接器的限制

Looker 連接器有下列限制,可能會限制可連線的 Looker 執行個體和模型類型:

  • Looker 連接器無法連線至客戶代管的 Looker 執行個體。
  • 如果 Looker 模型非常龐大 (通常是指有超過 100 個探索),在建立資料來源的過程中可能會發生長時間延遲或逾時。
  • 查詢逾時時間為 5 分鐘。對 Looker 資料來源執行的查詢,結果最多只能有 5,000 列。
  • 下載的資料最多只能有 5,000 列。

支援 Looker Studio 功能

Looker 資料來源可能不支援或僅部分支援下列 Looker Studio 功能:

  • 欄位數量:在表格圖表中,最多可加入 100 個維度和 100 個指標
  • 資料下載、排程、快訊和匯出:
    • 如果報表是使用來自 Looker (Google Cloud Core) 執行個體的 Looker 資料建立,且該執行個體使用私人連線或設定為使用虛擬私有雲 (VPC) IP 位址,則不支援下載、排程、快訊和資料匯出功能。如要進一步瞭解 Looker (Google Cloud Core) 執行個體網路,請參閱「Looker (Google Cloud Core) 網路選項」說明文件。
    • 如果報表是使用 Looker (原始) 執行個體的 Looker 資料建立,且該執行個體已設定使用 IP 允許清單,則不支援下載、排定時間、設定快訊和匯出資料。
  • 計算欄位:使用 Looker 連接器建立的資料來源支援部分 Looker Studio 函式,可用於計算欄位。這些函式只能套用至維度。

    計算結果欄位支援的函式

    名稱 類型 說明 語法
    ABS 算術 傳回數字的絕對值。瞭解詳情 ABS(X)
    ACOS 算術 傳回 X 的反餘弦函數。瞭解詳情 ACOS(X)
    ASIN 算術 傳回 X 的反正弦函數。瞭解詳情 ASIN(X)
    ATAN 算術 傳回 X 的反正切函數。瞭解詳情 ATAN(X)
    AVG 匯總 傳回所有 X 值的平均值。瞭解詳情 AVG(X)
    CASE (Simple) 條件式 比較 input_expression 與每個連續 WHEN 子句的 expression_to_match,並在比較為 true 時傳回第一個 result瞭解詳情
        CASE input_expression
        WHEN expression_to_match THEN result
        [WHEN expression_to_match THEN result]
        [...]
        [ELSE result]
        END
    CASE 條件式 評估每個連續 WHEN 子句的 condition,並傳回 condition 為 true 的第一個 result;不會評估任何剩餘的 WHEN 和 ELSE 子句。如果所有條件都是 false 或 NULL,就會傳回 else_result (如果有的話);如果沒有,則傳回 NULL瞭解詳情
        CASE
        WHEN condition THEN result
        [WHEN condition THEN result]
        [...]
        [ELSE else_result]
        END
    CAST 其他 將欄位或運算式轉換為 TYPE。CAST 內不得有匯總欄位。TYPE 可以是 NUMBERTEXTDATETIME瞭解詳情 CAST(field_expression AS TYPE)
    CEIL 算術 傳回大於 X 的最接近整數。舉例來說,如果 X 的值為 v,則 CEIL(X) 大於或等於 v。瞭解詳情 CEIL(X)
    COALESCE 條件式 會傳回在欄位清單中找到的第一個非遺漏值。瞭解詳情 COALESCE(field_expression[,field_expression, ...])
    CONCAT 文字 傳回 X 和 Y 串連值的文字。瞭解詳情 CONCAT(X, Y)
    CONTAINS_TEXT 文字 如果 X 包含文字,則傳回 true,否則傳回 false。需區分大小寫,瞭解詳情 CONTAINS_TEXT(X, text)
    COS 算術 傳回 X 的餘弦函數。瞭解詳情 COS(X)
    COUNT_DISTINCT 匯總 傳回 X 的不重複值數量。瞭解詳情 COUNT_DISTINCT(X)
    CURRENT_DATE 日期 傳回預設時區的目前日期。瞭解詳情 CURRENT_DATE()
    CURRENT_DATETIME 日期 傳回預設時區的目前日期和時間。瞭解詳情 CURRENT_DATETIME()
    DATE 日期 根據數字或是 Date & Time 欄位或運算式,來建立 Date 欄位或值。瞭解詳情 DATE(year, month, day)
    DATE_DIFF 日期 傳回 X 和 Y 之間的天數差 (X - Y)。瞭解詳情 DATE_DIFF(X, Y)
    DATE_FROM_UNIX_DATE 日期 將整數解讀為從 1970-01-01 算起的天數。瞭解詳情 DATE_FROM_UNIX_DATE(integer)
    DATETIME 日期 根據數字來建立日期和時間欄位或值。瞭解詳情 DATETIME(year, month, day, hour, minute, second)
    DATETIME_ADD 日期 在日期中加上指定時間間隔。接受的 part 值包括 SECONDMINUTEHOURDAYMONTHYEAR瞭解詳情 DATETIME_ADD(datetime_expression, INTERVAL integer part)
    DATETIME_DIFF 日期 傳回兩個日期之間的部分邊界數。接受的 part 值包括 SECONDMINUTEHOURDAYMONTHYEAR瞭解詳情 DATETIME_DIFF(date_expression, date_expression, part)
    DATETIME_SUB 日期 從日期中減去指定時間間隔。接受的 part 值包括 SECONDMINUTEHOURDAYMONTHYEAR瞭解詳情 DATETIME_SUB(datetime_expression, INTERVAL integer part)
    DATETIME_TRUNC 日期 將日期截斷至指定精細程度。接受的 part 值包括 SECONDMINUTEHOURDAYMONTHYEAR瞭解詳情 DATETIME_TRUNC(date_expression, part)
    DAY 日期 傳回日期或日期和時間的星期幾。瞭解詳情 Day(date_expression)
    EXTRACT 日期 傳回日期或日期和時間的一部分。可接受的 part 值包括 DAYMONTHYEAR瞭解詳情 EXTRACT(part FROM date_expression)
    FLOOR 算術 傳回小於 X 的最接近整數。舉例來說,如果值 X 是 v,則 FLOOR(X) 等於或小於 v。瞭解詳情 FLOOR(X)
    HOUR 日期 傳回日期和時間的小時。瞭解詳情 HOUR(datetime_expression)
    IF 條件式 如果 condition 為 true,則傳回 true_result,否則傳回 false_result。如果 condition 為 true,就不會評估 false_result。如果 condition 是 false 或 NULL,就不會評估 true_result瞭解詳情 IF(condition, true_result, false_result)
    IFNULL 條件式 如果輸入為空值,則傳回結果;否則傳回輸入值。瞭解詳情 IFNULL(input_expression, null_result)
    LEFT_TEXT  文字 傳回 X 開頭的幾個字元。字元數由 length 指定。瞭解詳情 LEFT_TEXT(X, length)
    LENGTH 文字 傳回 X 中的字元數。瞭解詳情 LENGTH(X)
    LOG 算術 依基底 2 傳回 X 的對數。瞭解詳情 LOG(X)
    LOG10 算術 依基底 10 傳回 X 的對數。瞭解詳情 LOG10(X)
    LOWER 文字 將 X 轉換為小寫。瞭解詳情 LOWER(X)
    MAX 匯總 傳回 X 的最大值。瞭解詳情 MAX(X)
    MEDIAN 匯總 傳回所有 X 值的中位數。瞭解詳情 MEDIAN(X)
    MIN 匯總 傳回 X 的最小值。瞭解詳情 MIN(X)
    MINUTE 日期 傳回特定日期和時間的分鐘部分。瞭解詳情 MINUTE(datetime_expression)
    MONTH 日期 傳回 Date & Time 值中的月份。瞭解詳情 MONTH(date_expression)
    NULLIF 條件式 如果輸入內容符合運算式,就會傳回 NULL,否則會傳回輸入內容。瞭解詳情 NULLIF(input_expression, expression_to_match)
    POWER 算術 傳回 X 的 Y 次方。瞭解詳情 POWER(X, Y)
    REPLACE 文字 傳回 X 的副本,並將 X 中所有出現的 Y 換成 Z瞭解詳情 REPLACE(X, Y, Z)
    RIGHT_TEXT  文字 傳回 X 結尾的幾個字元。字元數由 length 指定。瞭解詳情 RIGHT_TEXT(X, length)
    ROUND 算術 傳回四捨五入至 Y 位數精確度的 X瞭解詳情 ROUND(X, Y)
    SECOND 日期 傳回特定日期和時間的秒鐘部分。瞭解詳情 SECOND(datetime_expression)
    SIN 算術 傳回 X 的正弦函數。瞭解詳情 SIN(X)
    SQRT 算術 傳回 X 的平方根。請注意,X 不得為負數。瞭解詳情 SQRT(X)
    SUBSTR 文字 傳回 X 的子字串。子字串從「開始索引」開始,長度為「長度」個字元。瞭解詳情 SUBSTR(X, start index, length)
    SUM 匯總 傳回所有 X 值的總和。瞭解詳情 SUM(X)
    TAN 算術 傳回 X 的正切函數。瞭解詳情 TAN(X)
    TODAY 日期 傳回預設時區的目前日期。瞭解詳情 TODAY()
    UNIX_DATE 日期 傳回從 1970 年 1 月 1 日算起的天數。瞭解詳情 UNIX_DATE(date_expression)
    UPPER 文字 X 轉換為大寫。瞭解詳情 UPPER(X)
    YEAR 日期 傳回特定日期的年份。瞭解詳情 YEAR(Date)

疑難排解

問題 解析度
Looker Studio 顯示下列錯誤訊息:「需要授權」 按照「在 Looker Studio 中查看及使用 Looker 資料」一文的說明,授權 Looker 連接器連結所有必要帳戶。
Looker Studio 顯示 HTTP 400 錯誤
Looker Studio 會顯示以下錯誤訊息:「無法連線至 Looker 執行個體」
  • 確認 Looker 執行個體網址正確無誤,且沒有尾隨空格。
  • Looker 連接器僅適用於 Looker 執行個體的特定設定和版本
  • 如果 Looker (原始版) 執行個體已啟用「啟用許可清單」功能,可能需要進行特殊設定,請與支援團隊聯絡
  • 確認 Looker 執行個體中的 API 主機網址設定正確無誤。
Looker Studio 會顯示下列錯誤訊息:「找不到任何探索」 選取其他 Looker 模型。
現有報表圖表損毀
Looker Studio 嘗試擷取「探索」資料時顯示錯誤 與支援團隊聯絡或造訪 Looker Studio 社群
下載的報表不會顯示圖表 請要求 Looker 管理員授予資料來源 (即 Looker 探索) 基礎 LookML 模型的 download_with_limitdownload_without_limit 權限。這項權限僅適用於 Looker Studio Pro 使用者。
匯出的檔案不會顯示圖表 請要求 Looker 管理員授予資料來源 (即 Looker 探索) 基礎 LookML 模型的 download_with_limitdownload_without_limit 權限。這項權限僅適用於 Looker Studio Pro 使用者。
排定傳送的報表未顯示圖表 如果您擁有報表傳送權,但 Looker 權限不足,無法查看傳送報表中所參照的至少一個模型,請要求 Looker 管理員授予資料來源基礎 LookML 模型的 schedule_look_emails 權限。這項權限僅適用於 Looker Studio Pro 使用者。

如果您是報表收件者並收到這則訊息,請通知報表寄件者。
下載報表時,Looker Studio 會顯示下列錯誤:

權限不足,系統不會下載某些使用 Looker 模型的圖表。請要求 Looker 管理員授予權限。
請要求 Looker 管理員授予您報表基礎 LookML 模型的 download_with_limitdownload_without_limit 權限。這項權限僅適用於 Looker Studio Pro 使用者。
排定報表傳送時間時,Looker Studio 會顯示下列錯誤:

權限不足,定期報表不會顯示某些使用 Looker 資料的圖表。請要求 Looker 管理員授予權限。
請要求 Looker 管理員授予您報表基礎 LookML 模型的 schedule_look_emails 權限。這項權限僅適用於 Looker Studio Pro 使用者。
Looker Studio 會在報表排程清單中顯示下列錯誤:

傳送的報表中可能缺少部分 Looker 資料。請要求 Looker 管理員授予權限,以便在這份報表中傳送所有資料。
請要求 Looker 管理員授予您報表基礎 LookML 模型的 schedule_look_emails 權限。這項權限僅適用於 Looker Studio Pro 使用者。

回報問題

如要回報 Looker 連接器問題,請與支援團隊聯絡。

如果您是 Looker Studio Pro 客戶,且遇到與 Looker 連接器以外的 Looker Studio 功能相關問題,請與 Cloud Customer Care 團隊聯絡。

如果您使用的是免費版 Looker Studio,請在 Looker Studio 社群中發布問題或疑難。