在「管理」面板的「一般」部分中,Looker 管理員可透過「設定」頁面,設定 Looker 的例項層級設定。部分設定僅適用於 Looker (原始版本) 執行個體,或僅適用於 Looker (Google Cloud Core) 執行個體。
設定
以下設定適用於 Looker 執行個體。
強制使用 BigQuery 唯讀範圍
啟用這項設定後,如果使用者擁有可在任何 BigQuery 連線中讀取及寫入的 OAuth 憑證,系統就會將他們登出。當使用者再次進行驗證時,Looker 會改為為這些使用者建立唯讀 OAuth 憑證。詳情請參閱「限制 Google BigQuery 連線的 OAuth 範圍,僅限讀取」一文。
授權金鑰
授權金鑰是您使用的 Looker 例項專屬的金鑰。這項設定會根據您的授權協議,啟用或停用特定 Looker 功能。
授權金鑰預設為隱藏狀態。選取眼睛圖示
即可顯示授權金鑰。主機網址
主機網址是 Looker 執行個體網址的基礎部分。這個值專門用於在排定的電子郵件和 Looker 產生的所有絕對網址中建立執行個體連結。
請根據執行個體的伺服器設定,確認主機網址設定是否適當地使用 http://
或 https://
。
變更主機網址可能會影響部分 Looker 功能。請參閱「如果 Looker 執行個體的網址異動,會發生什麼情況?」請參閱「最佳做法」頁面,進一步瞭解如何變更執行個體網址。
技術聯絡人
新增至此方塊的電子郵件地址會收到安全性更新、主要錯誤修正和新 Looker 版本的通知。電子郵件地址必須屬於有效的 Looker 使用者。如果您新增的電子郵件地址不屬於有效的 Looker 使用者 (例如發送清單的電子郵件地址),該電子郵件地址會顯示在「技術聯絡人」欄位中,但 Looker 無法將通知傳送至這個地址。
Looker 支援團隊必須取得技術聯絡人的許可,才能執行下列任一操作:
- 導致執行個體的停機時間,這可能是因為未排定版本更新、Looker 伺服器的效能變更或其他原因
- 變更 Looker 授權,可能會為您啟用新功能。
應用程式時區
在探索、Look 或資訊主頁中顯示資料時,Looker 可以將連線的 資料庫時區轉換為適合該使用者的時區。
如果啟用「使用者專屬時區」選項,管理員可以設定使用者的預設時區,使用者也可以自行設定預設時區。如果管理員或使用者未設定使用者的預設時區,系統會為該使用者採用「應用程式時區」,且該使用者查詢的所有時間資料都會轉換為「應用程式時區」。
應用程式時區設定也會用於內容提交的預設時區。用於排程的時區不會影響查詢傳回的時間資料,只會影響資料傳送的時間。
詳情請參閱「使用時區設定」說明文件頁面。
功能設定
以下功能設定可用於 Looker 執行個體。
封閉系統
封閉式系統設定可與群組搭配使用,避免某個群組的使用者得知其他群組的使用者。這通常適用於多租戶安裝作業。
使用者在 Looker 中可能會看到其他使用者的地點包括:
- Looker 的「管理」部分中的「使用者」頁面
- Looker 主選單「資料夾」部分的「使用者資料夾」,如果他們至少已獲得其他使用者個人資料夾的查看存取權
- 「管理存取權」彈出式視窗,是資料夾管理的一部分
啟用「封閉系統」設定後,非管理員使用者如果沒有 see_users
權限,就只能看到與自己位於相同群組的使用者,以及自己所屬的群組。
管理員和已獲授予 see_users
權限的使用者,都可以查看執行個體上的所有使用者和群組。
登入同意聲明設定
啟用「登入同意聲明設定」後,凡是嘗試登入 Looker 執行個體的使用者,都會看見同意畫面。同意畫面會顯示您在「訊息設定」欄位中輸入的訊息,並要求使用者按一下同意畫面上的「我同意」按鈕,才能登入執行個體。啟用「登入同意聲明設定」後,系統就會顯示「訊息設定」欄位。
訊息設定
如果已啟用「登入同意聲明設定」選項,請在「訊息設定」欄位中輸入訊息,系統會向所有嘗試登入 Looker 執行個體的使用者顯示這則訊息。只有在啟用登入同意設定後,這個欄位才會顯示。
預設私人個人資料夾
啟用「預設私人個人資料夾」後,使用者的個人資料夾預設只會顯示給該使用者和 Looker 管理員。根據預設,其他使用者不會在「People」資料夾中看到該資料夾,而且資料夾中的內容不會顯示在看板或內容搜尋中。
如果您想提供個人資料夾的存取權,可以透過個人資料夾的齒輪選單中的「管理存取權」選項,為其他使用者或使用者群組新增存取權。
如果停用「預設私人個人資料夾」選項,「所有使用者」群組中的所有 Looker 使用者都能查看使用者的個人資料夾。
新帳戶通知
您可以啟用或停用「新帳戶通知」設定。啟用這項設定之後,如有新 Looker 帳戶建立,所有 Looker 管理員使用者都會收到電子郵件。(已簽署嵌入使用者除外;建立已簽署嵌入使用者時,系統不會產生電子郵件)。這封電子郵件會包含新使用者的電子郵件地址。
應用程式內指南
應用程式內指南可讓 Looker 透過教學課程、橫幅、快訊和問卷調查,與應用程式中的使用者進行溝通。這些通訊內容可協助使用者充分運用平台、提醒使用者新功能、取得平台使用者意見回饋,以及邀請使用者參加訓練課程和活動,瞭解如何更有效地使用 Looker。
管理員可以選擇為自己的執行個體停用指南,這樣做會為該執行個體的所有使用者停用指南。您無法針對特定使用者選擇關閉應用程式內指南。Looker 不會向嵌入式使用者或私人品牌例中的非管理員使用者顯示應用程式內指南。
指南由 Looker 的客戶體驗團隊設計及部署,且會隨時間變動。Looker 會使用第三方軟體 (Pendo) JavaScript 提供指南。Looker 會審查個別指南,並將其加入允許清單。從 Pendo 擷取指南時,Looker 會使用 SHA-256 完整性雜湊,驗證指南是否未變更。如果指南在 Looker 審查後有任何變更,Looker 就會禁止使用變更後的指南。如果使用者的瀏覽器無法連線至 Pendo 伺服器,系統就不會顯示指南。
新手上路
啟用這項設定後,登入新 Looker 執行個體的 Looker 管理員和開發人員,就會看到 Looker 新手上路說明,引導使用者完成四個主要步驟,以便使用 Looker 執行個體:
- 新增連線
- 建立專案
- 視需要編輯專案檔案
- 探索資料
管理員或開發人員完成完整指南後,系統就會停止顯示。
必須啟用應用程式內指南設定,才能使用新手上路選項。
Cookie 通知橫幅
啟用這項設定後,系統會向執行個體的所有使用者顯示 Cookie 通知橫幅。這項設定預設為停用。
如果 Looker 執行個體必須遵守歐盟的資料保護法規,建議您啟用這項設定。
精選搜尋
啟用精選搜尋功能後,使用者就能在共用資料夾、個人資料夾和看板中搜尋內容。儲存在其他使用者個人資料夾中的內容,只有在該內容已固定到看板時,才會納入搜尋結果。搜尋結果只會顯示其他使用者個人資料夾中的內容。使用者可以在搜尋對話方塊中選取「精選搜尋」功能名稱旁的切換鈕,選擇排除個人資料夾中的內容。
限制「自動重新整理資訊主頁」選項
啟用這項設定後,只有 Looker 管理員才能在使用者定義的資訊主頁上啟用「自動重新整理資訊主頁」選項。這麼做可防止非管理員使用者自動更新資訊主頁和資訊主頁資訊方塊的資料。自動重新整理資訊主頁資料可能會對某些資料庫系統造成重大負擔。
Google Cloud 專案編號
如要啟用應用程式內支援功能,您必須提供 Google Cloud 專案編號。您可以透過 Cloud 總覽頁面取得這個值,在 console_name_short 中。
這項變更最多可能需要兩小時才會生效。如要立即實施變更,請在輸入 Google Cloud 專案編號後,按一下「License Key」設定旁的「Update」按鈕。
如果您還沒有 Google Cloud Looker 專案,可以按照建立 Google Cloud 專案指南或更深入的建立及管理專案說明文件建立專案。
使用 Gravatar
啟用這項設定後,使用者選單會顯示「個人資料相片」選項,讓使用者使用 Gravatar 應用程式選取或建立帳戶的顯示圖片。
使用者專屬時區
新增連線時,您可以指定資料庫儲存時間資訊的時區,做為資料庫時區。
啟用「使用者專屬時區」後,系統會為每位使用者指派一個時區,並在使用者查看查詢結果或解讀篩選器時,將以時間為準的資料從「資料庫時區」轉換為使用者的時區。
在停用使用者專屬時區的情況下,Looker 會將所有使用者的以時間為準資料轉換為查詢時區值。
詳情請參閱「使用時區設定」說明文件頁面。
預設圖表顏色
每個 Looker 例項都必須有預設的色彩集合。您可以使用「預設圖表顏色」設定,為圖表定義預設顏色集合,也可以建立新的顏色集合,用於執行個體。您可以選取現有的色彩組合,或建立自訂色彩組合。
選取現有的色彩組合
如要將現有的色彩集合設為預設值,請從下拉式選單中選擇色彩集合,然後按一下「更新」。注意:設定新的預設顏色集合後,所有使用預設顏色集合的 Look 和資訊主頁都會更新圖表。使用其他顏色集合或自訂調色盤儲存的視覺化圖表不會受到影響。
您可以直接在下拉式選單下方,查看每個系列的首個類別、序列和漸層色版。這些調色盤會用於設定圖表的預設值。如要查看顏色集合中的所有調色盤,請參閱「顏色集合」說明文件頁面。
建立自訂顏色集合
如要建立自訂色彩集合,請按照下列步驟操作:
- 從「預設圖表可視化顏色」集合下拉式選單中,選取最後一個「新顏色集合」選項。
- 在「名稱」欄位中為新集合命名。
- 按一下每個調色盤,開啟「Colors in Palette」選單。
- 在「調色盤中的顏色」選單中選取個別顏色,即可逐一編輯,或選取「全部編輯」一次編輯所有顏色。
- 針對每個色票重複執行步驟 3 和 4。
- 編輯完新的色彩集合後,按一下「建立」。
顏色值可以以十六進位字串的格式表示,例如 #2ca6cd
,也可以使用 CSS 顏色名稱,例如 mediumblue
。或者,您也可以按一下色盤,開啟顏色挑選器,然後選取色調。如果選擇編輯所有顏色,請在每個顏色名稱之間使用半形逗號分隔。如要新增或移除顏色,請按一下「+」或「-」符號。
新的收藏集會自動成為執行個體的預設值,但您可以視需要選擇其他預設值。
任何新自訂顏色集合的集合 ID 和調色盤 ID 皆以各個集合的名稱為依據。這樣一來,如果兩個執行個體都含有相同名稱的自訂集合,LookML 資訊主頁就能在各執行個體中一致顯示。
刪除自訂顏色集合
如要刪除自訂顏色集合,請從下拉式選單中選取該集合,然後點選隨即顯示的「刪除」按鈕。您無法刪除 Looker 內建的色彩集合。
從 CDN 載入資產
這個選項僅適用於客戶代管的執行個體。由於 Looker 託管的執行個體一律會從 CDN 載入資產,因此您無法為這些執行個體停用這項設定。
CDN 代表「內容傳遞聯播網」。CDN 是一種伺服器網路,可在多個地理位置儲存內容,藉此縮短使用者網頁載入時間。您的資料絕不會儲存在這些伺服器上,只有 Looker 專屬項目 (例如圖片) 會儲存在 CDN 中。
您可以啟用或停用「Load Assets from CDN」設定。啟用後,Looker 網頁的載入速度應會加快。
在瀏覽器快取中保留資產
啟用這項設定後,系統就會在個別使用者的瀏覽器儲存空間中快取靜態資產 (例如 JavaScript 檔案和字型)。這樣一來,瀏覽器就不需要繼續從 Looker 伺服器重新載入這些素材資源,因此後續的導覽速度會加快。
行動應用程式存取權
啟用這項設定後,使用者就能透過 Looker 行動應用程式和 Looker (舊版) 應用程式,登入執行個體中的 Looker 帳戶。停用這項設定後,所有現有的行動工作階段都會終止。
強制執行行動驗證
啟用這項設定後,使用者每次在行動裝置上開啟應用程式時,都必須登入 Looker 行動應用程式和 Looker (舊版) 應用程式。
此外,使用者在行動應用程式閒置 60 分鐘後,系統會將他們登出。
資料政策
您可以為 Looker 執行個體設定下列資料政策。
公開網址
您可以啟用或停用「公開網址」設定。啟用這項設定後,具備適當權限的 Looker 使用者就能產生公開網址,存取 Looker 資料。
預訂內容的電子郵件網域許可清單
這項設定可讓 Looker 管理員定義使用者可透過電子郵件傳送 Looker 內容 (Look、資訊主頁、含有顯示效果的查詢) 或警示通知的電子郵件網域。
如要限制只有特定網域的電子郵件地址才能接收內容和警告通知,請以 domain.suffix
的格式輸入網域。舉例來說,如要限制電子郵件只傳送給 gmail.com
和 friendly_domain.org
網域的電子郵件,您可以在「預定內容的電子郵件網域許可清單」欄位中指定這些網域,然後授予使用者 schedule_look_emails
權限。
如要進一步瞭解這項設定和使用者權限對 Looker 內容和快訊通知的影響,請參閱本頁的「權限總覽」一節。
looker_internal_email_domain_allowlist
使用者屬性
除了全域「排定內容的電子郵件網域許可清單」欄位中列出的電子郵件網域,您也可以使用 looker_internal_email_domain_allowlist
user attribute,在各群組層級指定電子郵件網域。使用者屬性接受的字串格式與排定內容的電子郵件網域許可清單管理員設定相同。
如果群組指派多個電子郵件網域組合 (例如透過多個群組的成員資格),該群組的成員就能傳送電子郵件給指派給每個使用者屬性值的所有網域,以及排定內容的電子郵件網域許可清單管理員設定中列出的網域。換句話說,群組可傳送電子郵件的電子郵件網域組合,是「Email Domain Allowlist for Scheduled Content」欄位所列電子郵件網域組合,加上 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_emails 和 create_alerts |
可將內容和快訊通知傳送至自己的電子郵件地址、同個 Looker 例項的其他使用者電子郵件地址,或 friendly_domain.org 網域的電子郵件地址 |
可透過電子郵件將內容和警示通知傳送至任何電子郵件地址 | |
僅使用 schedule_external_look_emails |
可將電子郵件內容傳送至任何電子郵件地址 | 可將電子郵件內容傳送至任何電子郵件地址 | |
schedule_external_look_emails 和 create_alerts |
可透過電子郵件將內容和警示通知傳送至任何電子郵件地址 | 可透過電子郵件將內容和警示通知傳送至任何電子郵件地址 | |
已簽署的嵌入 | 僅使用 schedule_look_emails |
可將電子郵件內容傳送至使用 friendly_domain.org 網域的電子郵件地址 |
無法透過電子郵件傳送任何 Looker 內容 |
schedule_look_emails 和 create_alerts |
可將內容和警告通知電子郵件傳送至使用 friendly_domain.org 網域的電子郵件地址 |
無法透過電子郵件傳送任何 Looker 內容或快訊通知 | |
schedule_external_look_emails |
可將電子郵件內容傳送至任何電子郵件地址 | 可將電子郵件內容傳送至任何電子郵件地址 | |
schedule_external_look_emails 和 create_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 檔案中的公式和巨集
啟用這項設定後,Looker 會在以 CSV 或 Excel 試算表格式下載的查詢中,將 '
字元置於所有可能解讀為公式或巨集的值之前。
傳出的 Webhook 權杖
如果使用者使用 webhook 提交內容 (例如資訊主頁或Look),要求就會包含可在此處設定的特殊 Looker 權杖。接收 Webhook 的伺服器可驗證要求是否含有這個值,藉此驗證 Webhook 要求的合法性。如要重設 roken,請按一下「重設」。
自動啟用 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 檔案。 |