管理員設定 - 一般設定

Looker 管理員可以在「管理」面板的「一般」部分中,透過「設定」頁面設定 Looker 的例項層級設定。部分設定僅適用於 Looker (原始版本) 執行個體,或僅適用於 Looker (Google Cloud Core) 執行個體。

設定

Looker 執行個體可採用下列設定。

強制使用 BigQuery 唯讀範圍

啟用這項設定後,系統會登出具有 OAuth 憑證的使用者,這些憑證允許在任何 BigQuery 連線中讀取和寫入範圍。使用者再次驗證時,Looker 會改為為這些使用者建立唯讀 OAuth 憑證。詳情請參閱「將 OAuth 範圍限制為 Google BigQuery 連線的唯讀模式」。

授權金鑰

授權金鑰是您所用 Looker 執行個體的專屬金鑰。根據授權協議啟用或停用特定 Looker 功能。

授權金鑰預設為隱藏。選取眼睛圖示 即可顯示授權金鑰。

主機網址

主機網址是 Looker 執行個體網址的基礎部分。當系統在排定的電子郵件和 Looker 產生的所有絕對網址中建立執行個體連結時,就會使用這個網址。

請根據執行個體的伺服器設定,確認「主機網址」設定是否正確使用 http://https://

變更主機網址可能會影響部分 Looker 功能。請參閱「如果 Looker 執行個體的網址變更,會發生什麼情況?」如要進一步瞭解如何變更執行個體網址,請參閱「最佳做法」頁面。

技術聯絡人

在方塊中新增的電子郵件地址會收到安全性更新、重大錯誤修正和新版 Looker 的通知。電子郵件地址必須屬於有效的 Looker 使用者。如果您新增的電子郵件地址不屬於有效的 Looker 使用者 (例如通訊群組的電子郵件地址),該地址會顯示在「技術聯絡人」欄位中,但 Looker 無法將通知傳送至這個地址。

如要執行下列任一操作,Looker 支援團隊必須取得技術聯絡人的授權:

  • 導致執行個體停機,原因可能是非排定的版本更新、Looker 伺服器效能變更或其他原因
  • 變更 Looker 授權,可能可以為您啟用新功能。

應用程式時區

在「探索」、「Look」或資訊主頁中顯示資料時,Looker 可以將時間資料從連線的資料庫時區轉換為該使用者的適當時區。

如果啟用「使用者專屬時區」選項,管理員可以設定使用者的預設時區使用者也可以自行設定預設時區。如果管理員或使用者未設定使用者的預設時區,系統會為該使用者套用應用程式時區,且該使用者查詢的所有時間相關資料都會轉換為應用程式時區

應用程式時區設定也會做為內容傳送的預設時區。排程使用的時區不會影響查詢傳回的時間資料,只會影響資料傳送的時間。

詳情請參閱「使用時區設定」說明文件頁面。

功能設定

Looker 執行個體可使用下列功能設定。

封閉系統

封閉系統設定會與群組搭配使用,防止一個群組的使用者得知另一個群組的使用者。這項功能通常適用於多租戶安裝作業。

使用者可能會在 Looker 的下列位置看到其他使用者:

啟用「封閉系統」設定後,如果非管理員使用者沒有 see_users 權限,就只能看到與自己位於相同群組的人員,以及自己所屬的群組。

管理員和獲授 see_users 權限的使用者,都能查看執行個體中的所有使用者和群組。

啟用「登入同意聲明設定」後,凡是嘗試登入 Looker 執行個體的使用者,都會看到同意聲明畫面。同意畫面會顯示「訊息設定」欄位中輸入的訊息,使用者必須點選同意畫面上的「我同意」按鈕,才能登入執行個體。啟用「登入同意聲明設定」後,系統就會顯示「訊息設定」欄位。

訊息設定

如果啟用「登入同意聲明設定」選項,請在「訊息設定」欄位中輸入訊息,凡是嘗試登入 Looker 執行個體的使用者都會看到這則訊息。只有在啟用「登入同意聲明設定」後,這個欄位才會顯示。

預設私人個人資料夾

啟用「預設私人個人資料夾」後,根據預設,使用者的個人資料夾只會對該使用者和 Looker 管理員顯示。根據預設,其他使用者不會在「使用者資料夾」中看到該資料夾,且資料夾中的內容不會顯示在看板內容搜尋中。

如要提供個人資料夾的存取權,請透過個人資料夾齒輪選單中的「管理存取權」選項,為其他使用者或使用者群組新增存取權。

如果停用「預設私人個人資料夾」選項,「所有使用者」群組中的所有 Looker 使用者都能查看使用者的個人資料夾。

新帳戶通知

可啟用或停用「新帳戶通知」設定。啟用這項設定後,如有新的 Looker 帳戶建立,系統就會傳送電子郵件給所有 Looker 管理員使用者。(已簽署的嵌入使用者是例外狀況,建立這類使用者時不會產生電子郵件)。電子郵件會包含新使用者的電子郵件地址。

應用程式內指南

Looker 可透過應用程式內指南,在應用程式中透過教學課程、橫幅、快訊和問卷調查與使用者溝通。這些通訊內容可協助使用者充分運用平台功能、瞭解新功能、提供平台意見回饋,以及邀請使用者參加訓練和活動,學習如何更有效地使用 Looker。

管理員可以選擇為執行個體停用導覽,這樣一來,該執行個體的所有使用者都會無法使用導覽。您無法為特定使用者選擇性關閉應用程式內導覽。Looker 不會在自有品牌執行個體上,向嵌入式使用者或非管理員使用者顯示應用程式內導覽。

指南由 Looker 客戶體驗團隊設計及部署,內容會隨時間變更。Looker 會使用第三方軟體 (Pendo) JavaScript 提供導覽。Looker 會審查個別指南,並將其加入允許清單。從 Pendo 擷取導覽時,Looker 會使用 SHA-256 完整性雜湊,驗證導覽是否未經變更。如果 Looker 審查後指南有任何變更,Looker 會禁止使用變更後的指南。如果使用者的瀏覽器無法連上 Pendo 伺服器,就不會顯示導覽。

新手上路

啟用後,登入新 Looker 執行個體的 Looker 管理員和開發人員會看到 Looker 新手上路導覽,引導使用者完成四個主要步驟,充分運用 Looker 執行個體:

  1. 新增連線
  2. 建立專案
  3. 視需要編輯專案檔案
  4. 探索資料

只要管理員或開發人員完成完整指南,系統就不會再顯示。

如要使用「新手上路」選項,必須啟用「應用程式內導覽」設定。

啟用這項設定後,您執行個體的所有使用者都會看到 Cookie 通知橫幅。這項設定預設為停用。

如果您的 Looker 執行個體必須遵守歐盟資料保護法規,建議啟用這項設定。

啟用「精選搜尋」後,使用者就能在共用資料夾、個人資料夾和看板中搜尋內容。只有在其他使用者個人資料夾中的內容也釘選到記事板時,才會顯示在搜尋結果中。搜尋結果會排除僅存在其他使用者個人資料夾中的內容。使用者可以在搜尋對話方塊中,選取「精選搜尋」功能名稱旁的切換鈕,選擇排除個人資料夾中的內容。

限制「自動重新整理資訊主頁」選項

啟用這項設定後,只有 Looker 管理員才能在使用者定義的資訊主頁上啟用「自動重新整理資訊主頁」選項。這樣一來,非管理員使用者就無法自動重新整理資訊主頁和資訊主頁圖塊上的資料。自動重新整理資訊主頁資料可能會對某些資料庫系統造成重大負擔。

以全螢幕開啟圖表

啟用這項功能後,資訊主頁圖塊中的圖表就能以全螢幕模式顯示,並放大檢視。如要進一步瞭解檢視選項,請參閱「查看資訊主頁」說明文件頁面。

如要關閉資訊主頁的全螢幕和展開功能,請前往資訊主頁的「設定」選單

Google Cloud 專案編號

如要啟用應用程式內支援,您必須提供 Google Cloud 專案編號。您可以透過 console_name_short 的 Cloud 總覽頁面取得這個值。

這項變更最多可能要過兩小時才會生效。輸入 Google Cloud 專案編號後,按一下「授權金鑰」設定旁的「更新」按鈕,即可立即套用變更。

如果您還沒有 Looker 專案,可以按照建立專案指南建立及管理專案的詳細說明文件,建立專案。 Google Cloud Google Cloud

使用 Gravatar

啟用這項設定後,使用者選單會顯示「個人資料相片」選項,使用者可以透過 Gravatar 應用程式選取或建立帳戶的顯示圖片。

使用者專屬時區

新增連線時,請指定資料庫儲存時間資訊的時區,即「資料庫時區」

啟用「使用者專屬時區」後,系統會為每位使用者指派時區,並在使用者查看查詢結果或解讀篩選器時,將以時間為準的資料從「資料庫時區」轉換為使用者的時區。

停用「使用者專屬時區」後,Looker 會將所有使用者的時間資料轉換為「查詢時區」值。

詳情請參閱「使用時區設定」說明文件頁面。

預設圖表顏色

每個 Looker 執行個體都必須有預設的顏色集合。「預設圖表顏色」設定可讓您定義圖表的預設顏色集合,也能建立新的顏色集合,供執行個體使用。你可以選取現有顏色集合建立自訂顏色集合

選取現有的色彩集合

如要將現有的顏色集合設為預設,請從下拉式選單中選擇顏色集合,然後按一下「更新」。 注意:設定新的預設顏色集合後,使用預設顏色集合的 Look 和資訊主頁上的所有圖表都會更新。以其他顏色集合或自訂調色盤儲存的視覺化圖表不會受到影響。

您可以在下拉式選單下方直接查看每個系列的類別、連續和發散調色盤。這些調色盤會做為預設的視覺化設定。如要查看顏色集合中的所有調色盤,請前往「顏色集合」文件頁面。

建立自訂顏色集合

如要建立自訂顏色集合,請按照下列步驟操作:

  1. 從「預設圖表顏色」集合下拉式選單中,選取最後一個「新顏色集合」選項。
  2. 在「名稱」欄位中,為新集合指定專屬名稱。
  3. 按一下各個調色盤,開啟「調色盤中的顏色」選單。
  4. 在「調色盤中的顏色」選單中選取個別顏色,即可逐一編輯,或選取「全部編輯」一次編輯所有顏色。
  5. 針對每個調色盤重複執行步驟 3 和 4。
  6. 編輯完新的顏色集合後,按一下「建立」

顏色值可格式化為十六進位字串 (例如 #2ca6cd),或 CSS 顏色名稱 (例如 mediumblue)。或者,按一下色輪開啟顏色挑選器,然後選取所需色調。如要編輯所有顏色,請使用半形逗號分隔每個顏色名稱。如要新增或移除顏色,請按一下「+」或「-」符號。

新集合會自動成為執行個體預設集合,但您也可以選擇其他預設集合。

任何新自訂顏色集合的集合 ID 和調色盤 ID,都是以每個集合的名稱為準。如果兩個執行個體都有名稱相同的自訂集合,使用這些集合的 LookML 資訊主頁就能在執行個體之間保持一致的顯示方式。

刪除自訂顏色集合

如要刪除自訂顏色集合,請從下拉式選單中選取該集合,然後按一下隨即顯示的「刪除」按鈕。您無法刪除 Looker 內建的顏色集合。

從 CDN 載入資產

這個選項僅適用於客戶代管的執行個體。由於 Looker 託管的執行個體一律會從 CDN 載入資產,因此您無法為這些執行個體停用這項設定。

CDN 是內容傳遞聯播網的縮寫,CDN 是一組伺服器,會在多個地理位置儲存內容,以縮短使用者的網頁載入時間。這些伺服器絕不會儲存您的資料,只有 Looker 專屬項目 (例如圖片) 會儲存在 CDN 中。

「從 CDN 載入資產」設定可以啟用或停用。啟用後,Looker 頁面載入速度應該會更快。

在瀏覽器快取中保留資產

啟用這項設定後,系統會在個別使用者的瀏覽器儲存空間中快取靜態資產,例如 JavaScript 檔案和字型。這麼做可以加快後續的導覽速度,因為瀏覽器不必繼續從 Looker 伺服器重新載入這些資產。

行動應用程式存取權

啟用這項設定後,使用者就能透過 Looker 行動應用程式Looker (舊版) 應用程式,登入執行個體的 Looker 帳戶。停用這項設定後,所有現有的行動裝置工作階段都會終止。

強制執行行動驗證

啟用這項設定後,使用者每次在行動裝置上開啟 Looker 行動應用程式Looker (舊版) 應用程式時,都必須登入。

此外,使用者閒置 60 分鐘後,系統會將他們登出行動應用程式。

資料政策

Looker 執行個體可使用下列資料政策設定。

公開網址

您可以啟用或停用「公開網址」設定。啟用這項設定後,具備適當權限的 Looker 使用者可以產生公開網址,存取 Looker 資料。

預訂內容的電子郵件網域許可清單

Looker 管理員可透過這項設定,定義使用者可透過電子郵件傳送 Looker 內容 (包括 Look、資訊主頁、含視覺化效果的查詢) 或快訊通知的電子郵件網域。

如要限制只有特定網域的電子郵件地址才能接收內容和警告通知,請以「<網域>.<字尾>」的格式輸入網域domain.suffix。舉例來說,如要限制只有 gmail.comfriendly_domain.org 網域的電子郵件地址才能接收電子郵件,請在「排定內容的電子郵件網域許可清單」欄位中指定這些網域,然後授予使用者 schedule_look_emails 權限。

如要進一步瞭解這項設定和使用者權限對傳送 Looker 內容和快訊通知的影響,請參閱本頁面的「權限總覽」一節。

looker_internal_email_domain_allowlist 使用者屬性

除了全域「預定內容的電子郵件網域許可清單」欄位中包含的電子郵件網域,您也可以使用 looker_internal_email_domain_allowlist user 屬性,在群組層級指定電子郵件網域。使用者屬性接受的字串格式與「預定內容的電子郵件網域允許清單」管理員設定相同。

如果群組獲派多個電子郵件網域集 (例如透過多個群組的成員資格),該群組的成員就能將電子郵件傳送至獲派給各個使用者屬性值的網域,以及「預定內容的電子郵件網域許可清單」管理設定中列出的網域。換句話說,群組可傳送電子郵件的網域組合,是「預定內容的電子郵件網域許可清單」欄位中列出的電子郵件網域組合,以及 looker_internal_email_domain_allowlist 使用者屬性指派給群組的所有電子郵件網域組合的聯集。

權限總覽

嵌入和非嵌入使用者必須至少具備 schedule_look_emails 權限,才能透過電子郵件傳送任何 Looker 內容。如要傳送快訊通知,使用者也必須具備 create_alerts 權限。

如果嵌入式和非嵌入式使用者擁有 schedule_look_emails 權限,系統也可能會授予 schedule_external_look_emails 權限 (如要進一步瞭解權限和依附元件,請參閱「角色」說明文件頁面)。

如要瞭解使用者權限如何影響使用者可傳送 Looker 內容或快訊通知的網域,請參閱下表:

使用者類型 權限 預訂內容的電子郵件網域許可清單包含網域 friendly_domain.org 預訂內容的電子郵件網域許可清單不含任何網域
非嵌入 僅使用 schedule_look_emails 將電子郵件內容傳送至自己的電子郵件地址、同一執行個體中其他 Looker 使用者的電子郵件地址,或具有 friendly_domain.org 網域的電子郵件地址 可將電子郵件內容傳送至任何電子郵件地址
schedule_look_emailscreate_alerts 可將電子郵件內容傳送和快訊通知傳送至自己的電子郵件地址、同一執行個體中其他 Looker 使用者的電子郵件地址,或 friendly_domain.org 網域的電子郵件地址 可將內容和警告通知傳送至任何電子郵件地址
僅使用 schedule_external_look_emails 可將電子郵件內容傳送至任何電子郵件地址 可將電子郵件內容傳送至任何電子郵件地址
schedule_external_look_emailscreate_alerts 可將內容和警告通知傳送至任何電子郵件地址 可將內容和警告通知傳送至任何電子郵件地址
已簽署的嵌入內容 僅使用 schedule_look_emails 可以將電子郵件內容傳送至採用 friendly_domain.org 網域的電子郵件地址 無法透過電子郵件傳送任何 Looker 內容
schedule_look_emailscreate_alerts 可將內容和警告通知傳送至採用 friendly_domain.org 網域的電子郵件地址 無法透過電子郵件傳送任何 Looker 內容或快訊通知
schedule_external_look_emails 可將電子郵件內容傳送至任何電子郵件地址 可將電子郵件內容傳送至任何電子郵件地址
schedule_external_look_emailscreate_alerts 可將內容和警告通知傳送至任何電子郵件地址 可將內容和警告通知傳送至任何電子郵件地址

嵌入的 Looker 內容是透過專屬的嵌入使用者帳戶存取,而非透過個別使用者帳戶。使用者透過嵌入功能存取 Looker 內容時,Looker 不會知道個別使用者的電子郵件地址。

下表列出的規則有一項例外:您可以在已簽署的嵌入網址中,於 email 使用者屬性中定義嵌入使用者的電子郵件地址,並提供給 Looker。例如:

...&user_attributes={"email":"joe@domain.com"}

如果您在嵌入網址中定義 email 使用者屬性,即使嵌入使用者的電子郵件網域不在「排定內容的電子郵件網域允許清單」欄位中,或「排定內容的電子郵件網域允許清單」欄位空白,Looker 仍會允許只有 schedule_look_emails 權限的嵌入使用者將 Looker 內容傳送至自己的電子郵件地址。

資料動作的網址許可清單

這項設定可讓您定義網址 (例如 https://looker.com),供使用者處理資料動作

舉例來說,如果您將網址 https://looker.com 新增至資料動作的網址許可清單,資料動作就只能在 https://looker.com 處理。系統不允許在其他網址處理資料動作。

如果將這個欄位留空,資料動作就不會受到網址限制。不過,如果您已在資料動作中加入使用者屬性,則必須填寫這個欄位。在這種情況下,您必須提供有效的網址來處理資料動作。

在查詢結果中封鎖內嵌圖片

根據預設,Looker 不會在查詢結果中顯示 Base64 編碼的圖片。停用這項設定,即可在查詢結果中顯示 Base64 編碼的圖片。

封鎖 CSV 和 Excel 檔案中的公式和巨集

啟用這項設定後,如果以 CSV 或 Excel 試算表格式下載查詢,Looker 會在所有可能解讀為公式或巨集的值前面加上 ' 字元。

傳出的 Webhook 權杖

如果使用者透過 Webhook 傳送內容 (例如資訊主頁Look),要求會包含可在這裡設定的特殊 Looker 權杖。接收 Webhook 的伺服器隨後可以驗證要求是否含有這個值,藉此驗證 Webhook 要求的合法性。如要重設權杖,請按一下「重設」

自動啟用 Gemini in Looker 並管理使用者

對於使用開放式系統設定的所有 Looker (原始) 執行個體,系統會自動建立名為「預設 Gemini 使用者」的新使用者群組。這個群組的使用者會獲派 Gemini 角色,因此能使用 Gemini in Looker 功能。

「自動啟用 Gemini in Looker 並管理使用者」設定的狀態會對群組造成以下影響:

  • 啟用這項設定後:
    • 系統會自動將新增至執行個體的使用者加入群組。
  • 停用這項設定後:
    • 新增至執行個體的新使用者必須手動加入群組。
    • 如要從「預設 Gemini 使用者」群組移除成員,請手動移除。

2025 年 6 月 9 日的設定狀態會產生下列影響:

  • 如果這項設定是在 2025 年 6 月 9 日前啟用,所有現有使用者都會加入群組,日後新增的使用者也會加入群組。系統已自動啟用 Gemini in Looker。
  • 如果這項設定在 2025 年 6 月 9 日已停用,則必須手動將所有使用者新增至群組。系統未自動啟用 Gemini in Looker。

您可以在「管理」面板的「平台」部分,前往「Gemini in Looker」頁面手動啟用或停用這項功能。這項設定的狀態不會受到「自動啟用 Gemini in Looker 並管理使用者」設定的影響。

預設匯出格式

「預設匯出格式」設定可讓您選擇使用者下載資料時使用的預設檔案格式。使用者仍可選擇其他檔案格式。可用的格式如下:

格式 副檔名 說明
TXT .txt 產生以定位點分隔的文字檔案。
Excel 試算表 .xlsx 使用 Microsoft Excel 2007 以上版本的格式產生試算表檔案。
CSV .csv 產生以半形逗號分隔的文字檔案。
JSON .json 產生 JSON 檔案,每行一筆記錄。
HTML .html 產生基本 HTML,以類似使用者在瀏覽器中查看資料的方式顯示資料;不過,由於不會納入 Looker 的 CSS,因此格式不會完全相同。
Markdown .md 產生標準 Markdown 檔案,內含以 | 分隔的表格。