在「管理」面板的「使用者」部分,「使用者」頁面會列出 Looker 執行個體上的所有使用者帳戶。
查看及搜尋使用者
「使用者」頁面會顯示下列資訊:

分頁會依類型將使用者分組:
- 「Standard Users」(標準使用者) 分頁會顯示直接登入 Looker 的使用者,無論是透過一般驗證程序或 Looker API。
- 「Embed Users」(嵌入使用者) 分頁會顯示透過第三方應用程式驗證的已簽署嵌入使用者。
- 「服務帳戶」分頁會顯示僅限 API 的服務帳戶,這些帳戶是透過 Looker API 使用 API 金鑰進行驗證。
- 「Looker 支援」分頁會顯示已獲得 Looker 執行個體存取權的 Looker 支援分析師。
「Filter List」(篩選清單) 欄位會限制顯示的使用者。您可以依使用者 ID、名稱或電子郵件地址篩選。如要依使用者 ID 篩選,請輸入使用者 ID 來顯示該使用者。輸入名稱和電子郵件地址時,只要輸入任何字串,系統就會顯示名稱或電子郵件地址包含該字串的所有使用者。「篩選器清單」取代了舊版「使用者」頁面的搜尋功能。
按一下「使用者」欄標題,即可依使用者名稱遞增或遞減排序表格。
每列會列出使用者的名稱、ID 和電子郵件地址,並包含一個圖示,指出使用者的存取權類型。將游標懸停在圖示上,即可查看圖示代表的意義。
按一下該列即可編輯使用者。如果使用者圖示上有鎖頭,表示無法編輯。這些使用者是由系統建立 (例如「所有使用者」群組的成員),或由 LDAP、SAML 或 OpenID Connect 通訊協定從外部管理。
「Active Credential」(有效憑證) 欄會列出使用者對 Looker 執行個體的存取權類型。這個資料欄只會顯示在「標準使用者」分頁。
「群組」欄會列出使用者所屬的所有群組。
「角色」欄會列出指派給使用者的所有角色。
按一下三點圖示「選項」選單,即可停用使用者、以使用者身分執行 sudo 或刪除使用者。
新增標準使用者
如要新增標準使用者,請完成下列步驟:
- 按一下「Add」按鈕,開啟下拉式選單。
- 按一下「使用者」選單項目,開啟「新增使用者」頁面。
- 在「新增使用者」頁面的「電子郵件地址」欄位中,輸入或貼上以半形逗號分隔的電子郵件地址清單。
- 在「Groups」欄位中,選取要指派給使用者的群組。如要查看群組清單,請在「群組」欄位中輸入文字,系統會顯示所有包含該文字的群組名稱。
- 在「角色」欄位中,選取要指派給使用者的角色。
- 按一下「儲存」按鈕建立使用者。如果您勾選了「傳送設定電子郵件」核取方塊,系統也會傳送註冊電子郵件。
建立僅限 API 的服務帳戶
您可以在 Looker 執行個體的「使用者」頁面,建立僅限 API 帳戶 (通常稱為服務帳戶)。這些帳戶可以獲得 Looker 管理員角色和 Looker API 憑證。不過,這類帳戶無法透過使用者介面登入 Looker。
最佳做法是為 API 指令碼建立專屬服務帳戶,每個指令碼一個服務帳戶。這樣一來,您就能為服務帳戶設定一組特定權限,讓指令碼「只能」執行其功能。舉例來說,如果 API 指令碼會執行查詢,您可以建立具備 access_data 權限的服務帳戶,但不授予其他權限。
API 指令碼專用的服務帳戶可區隔指令碼的存取權,提高安全性。此外,如需停止指令碼,可以停用 (或刪除) 該指令碼的服務帳戶。刪除任何使用者帳戶前,請務必詳閱本頁的「移除使用者存取權」一節。
服務帳戶會根據其角色使用授權。如果服務帳戶獲派多個角色,則會使用這些角色中最高層級的授權。舉例來說,如果服務帳戶同時具備檢視者和開發人員權限,則會使用開發人員授權。
如要新增服務帳戶,請按照下列步驟操作:
- 按一下「Add」按鈕,開啟下拉式選單。
- 按一下「Service Account」選單項目,開啟「Add a new Service Account」頁面。
- 在「Service Account Name」(服務帳戶名稱) 欄位中,輸入服務帳戶名稱。
- 「Create default set of API credentials」切換按鈕預設為啟用。如果不想為帳戶建立 API 憑證,請按一下切換鈕停用這個選項。
- 選取要指派給服務帳戶的群組和角色。
- 按一下 [Save] 按鈕。
您可以在「使用者」頁面的「服務帳戶」分頁中,查看及編輯現有服務帳戶。如要編輯服務帳戶,請按一下服務帳戶列,顯示「編輯使用者」頁面。在「編輯使用者」頁面中,您可以執行下列操作:
將使用者帳戶遷移至服務帳戶
在 Looker (原始) 執行個體中,某些標準使用者帳戶可以遷移至僅限 API 服務帳戶。標準使用者帳戶必須符合下列所有條件,才能進行遷移:
- 帳戶並未使用 Google、SAML 或 OpenID Connect 等識別資訊提供者,做為 Looker 的驗證方法。
- 帳戶未設定電子郵件憑證密碼。
- 使用者在過去七天內未登入 Looker 執行個體。
Looker 會在「使用者」頁面「標準使用者」分頁的「使用者」欄中,標記符合這些條件的標準使用者。此外,「使用者」頁面頂端會顯示橫幅,指出部分標準使用者可能是服務帳戶。
如果標準使用者帳戶符合遷移條件,可以透過下列兩種方式遷移至服務帳戶:
在符合條件的使用者帳戶列中,三點圖示「選項」選單會顯示「遷移」選項。選取該選單項目後,「遷移使用者」對話方塊就會開啟。按一下「遷移」即可遷移使用者。按一下「取消」即可關閉對話方塊,不進行遷移。
按一下合格使用者帳戶所在列,前往「編輯使用者」頁面。在「Edit User」(編輯使用者) 頁面底部,按一下「Migrate」(遷移) 按鈕。在顯示的對話方塊中,按一下「確定」確認遷移,或按一下「取消」退出對話方塊,不進行遷移。
如果使用者帳戶不符合遷移條件,系統就不會顯示該使用者的遷移選項。不過,如果使用者已設定電子郵件和密碼登入方式 (系統會顯示「傳送重設連結」按鈕,而非「傳送設定連結」按鈕),Looker 會在使用者連續七天沒有任何活動時,自動觸發遷移提示。管理員可以使用 DELETE /users/{user_id}/credentials_email API 端點移除電子郵件憑證,這樣帳戶就能立即符合遷移資格,不必等待七天。
將使用者帳戶遷移至服務帳戶不會建立 API 憑證,但與使用者帳戶相關聯的 API 憑證會遷移至服務帳戶。
編輯使用者
如要編輯使用者,請按一下使用者所在的列。在「Edit User」(編輯使用者) 頁面中,視需要調整下列設定。
帳戶
啟用或停用使用者帳戶。建議您停用使用者帳戶,而非刪除。這個欄位只會顯示標準使用者和服務帳戶。
名字
新增或編輯使用者的名字 (如適用)。這個欄位不一定要填寫,但有助於整理資料。這個欄位只會顯示給標準使用者和嵌入使用者。
姓氏
新增或編輯使用者的姓氏 (如有)。這個欄位不一定要填寫,但有助於整理資料。這個欄位只會顯示給標準使用者和嵌入使用者。
服務帳戶名稱
編輯服務帳戶名稱。這個欄位只會顯示在服務帳戶中。
電子郵件
新增或編輯使用者的電子郵件地址。使用者登入 Looker 時,電子郵件地址會做為使用者名稱。這個欄位只會顯示給標準使用者。
語言代碼
「Locale」欄位會設定使用者的使用者介面語言和模型語言代碼。這個欄位只會顯示給標準使用者。
如要讓使用者以特定語言查看某些使用者介面 (UI) 文字,Looker 支援下表所示的 UI 翻譯。在「語言代碼」欄位中輸入代碼。
如要讓使用者查看一或多個資料模型的本地化版本,請在「Locale」欄位中輸入該語言代碼的模型字串檔案標題。
如要讓使用者同時查看模型本地化和 Looker 內建的使用者介面翻譯,模型字串檔案的名稱應與下表中的適當語言代碼相同,且該代碼應輸入至「語言代碼」欄位。
如要確認「語言代碼」設定,請按一下頁面底部的「儲存」。
| 語言 | 語言代碼和字串檔案名稱 |
|---|---|
| 英文 | en |
| 捷克文 | cs_CZ |
| 德文 | de_DE |
| 西班牙文 (西班牙) | es_ES |
| 芬蘭文 | fi_FI |
| 法文 (加拿大) | fr_CA |
| 法文 (法國) | fr_FR |
| 北印度文 | hi_IN |
| 義大利文 | it_IT |
| 日文 | ja_JP |
| 韓文 | ko_KR |
| 立陶宛文 | lt_LT |
| 挪威文 (Bokmål) | nb_NO |
| 荷蘭文 | nl_NL |
| 波蘭文 | pl_PL |
| 巴西葡萄牙文 | pt_BR |
| 葡萄牙文 | pt_PT |
| 俄文 | ru_RU |
| 瑞典文 | sv_SE |
| 泰文 | th_TH |
| 土耳其文 | tr_TR |
| 烏克蘭文 | uk_UA |
| 簡體中文 | zh_CN |
| 繁體中文 | zh_TW |
如果使用者未設定「語言代碼」,Looker 會使用「管理員」面板「本地化」頁面中選擇的語言代碼做為預設語言代碼;如果該頁面未設定語言代碼,Looker 預設會使用 en。
設定自訂語言代碼
Looker 開發人員可以建立自訂語言代碼,僅用於模型本地化。自訂語言代碼是由模型本地化程序中建立的字串檔案標題指定。如要將自訂語言代碼套用至使用者,請按照下列步驟操作:
在「Locale」欄位中輸入自訂語言代碼。開始在欄位中輸入內容時,任何預先存在的文字都會消失。
按一下「建立『<您的自訂語言代碼>』」。
按一下頁面底部的「儲存」。該代碼會新增至使用者的語言代碼下拉式選單。
Looker UI 不支援自訂語言代碼。如果您在使用者的「Locale」欄位中使用自訂語言代碼,該使用者的 UI 會預設為執行個體語言代碼中設定的語言。
數字格式
Looker 預設的數字格式設定為 1,234.56,適用於資料表和圖表中的數字。不過,數字格式可以設為下列任一選項:
- 1,234.56:千位數以半形逗號分隔,小數以半形句號分隔
- 1.234,56:千位分隔符號為句號,小數分隔符號為半形逗號
- 1 234,56:千位分隔符號為空格,小數分隔符號為半形逗號
如要進一步瞭解並查看使用「數字格式」設定的範例,請參閱「本地化數字格式」說明文件頁面。
這個欄位只會顯示給標準使用者。
時區
如果您已在 Looker 執行個體啟用使用者專屬時區,可以選取這位使用者在 Looker 執行查詢時要使用的時區。
傳送設定連結/傳送重設連結
如果使用者從未登入,這個按鈕會標示為「傳送設定連結」。如果使用者先前已登入,這個按鈕會標示為「傳送重設連結」。如需設定或重設密碼,請點選這個按鈕,系統會將連結傳送至您先前指定的使用者電子郵件地址。請參閱「密碼規定」說明文件頁面,瞭解如何在 Looker 中指定密碼複雜度規定。如果使用者未在一小時內重設密碼,重設連結就會失效。
這個欄位只會顯示給標準使用者。
雙重驗證密鑰
如果執行個體已啟用雙重驗證 (2FA),就會顯示這個選項。按一下「Reset」按鈕,即可重設使用者的雙重驗證。這樣一來,使用者下次嘗試登入 Looker 執行個體時,Looker 就會提示他們使用 Google Authenticator 驗證器應用程式重新掃描 QR code。
這個欄位只會顯示給標準使用者。
API 金鑰
API 金鑰用於存取 Looker API。API 金鑰的權限與建立金鑰的使用者帳戶或服務帳戶相同。
API 金鑰是在 Looker 中建立,由用戶端 ID 和用戶端密鑰組成。Looker 必須使用 API 金鑰,才能透過 Looker API 執行指令。
這個欄位只會顯示標準使用者和服務帳戶。
個別標準使用者
管理員無法為個別標準使用者建立 API 金鑰。不過,管理員可以啟用或停用使用者的 API 金鑰管理功能。
如要啟用或停用使用者管理 API 金鑰的功能,請依序前往「管理」>「使用者」>「編輯使用者」頁面,然後使用「API 金鑰」欄位,啟用或停用使用者為其使用者帳戶建立、查看及刪除 API 金鑰的功能。
使用者獲准管理 API 金鑰後,就能在「帳戶」頁面執行這項操作。
Looker 管理員可以透過「使用者」系統活動探索中的「可管理 API3 憑證」欄位,監控哪些使用者有權管理 API 金鑰。Looker 管理員可以在「使用者」系統活動探索中,使用「具有 API 憑證」欄位,監控哪些使用者擁有 API 金鑰。
使用者設定 API 金鑰後,管理面板「使用者」頁面的「有效憑證」欄,就會顯示「API」(以及他們擁有的任何其他類型 Looker 憑證)。Looker 管理員也可以點選「查看 API 金鑰」按鈕,開啟使用者的「API 金鑰」頁面,查看使用者 API 金鑰的用戶端 ID,但無法查看用戶端密鑰。
僅限 API 的服務帳戶
Looker 管理員會管理僅限 API 服務帳戶的 API 金鑰。
如要為僅限 API 的服務帳戶產生 API 金鑰,請依序前往「管理」>「使用者」>「編輯使用者」頁面,然後在「API 金鑰」部分點選「管理」按鈕。「API 金鑰」頁面隨即開啟,並顯示現有的 API 金鑰。點選「Create New API Key」按鈕,產生新的 API 金鑰。
群組
列出使用者所屬的群組。如要將使用者加入新群組,請從下拉式選單中選取群組;如要將使用者從群組中移除,請在清單中按一下群組名稱旁的 X。
您也可以在管理面板的群組頁面中,將使用者加入群組。
角色
列出指派給使用者的角色。如要為使用者新增角色,請從下拉式選單中選取角色;如要移除使用者的角色,請在清單中按一下角色名稱旁的 X。
您也可以在「Roles」(角色) 管理頁面新增角色。
使用者屬性
設定及取消設定使用者的使用者屬性值。指派給個別使用者的值,一律會覆寫因群組成員身分而指派的值。無法編輯系統設定。
疑難排解儲存使用者時發生的 500 錯誤
如果您嘗試在「編輯使用者」頁面儲存使用者設定檔 (例如新增角色、群組或使用者屬性),卻遇到 500 Internal Server Error,可能的原因之一是查詢參數限制。
原因
在「Edit User」(編輯使用者) 頁面儲存使用者個人資料時,系統會透過 POST 要求的酬載傳送角色、群組和使用者屬性。如果 Looker 執行個體設定了大量這類參數,總數可能會超過系統預設的查詢參數限制 (具體來說是 4,096 個)。如果超過這個門檻,伺服器會傳回 500 錯誤。
解決方法和解決方案
如要解決或避開這項錯誤,請嘗試下列任一做法:
- 使用「角色」管理頁面或 API 指派角色:如要快速指派角色,且不觸發這項錯誤,請前往「角色」頁面,編輯角色並將使用者新增至該角色。或者,您也可以使用 Looker API
set_user_roles方法。 - 清除未使用的使用者屬性:如要解決根本問題,讓「編輯使用者」UI 正常運作,請減少執行個體中設定的使用者屬性總數。如要刪除未使用的使用者屬性,請前往「使用者屬性」管理頁面,或使用 Looker API。
移除使用者存取權
如要移除使用者帳戶或服務帳戶的 Looker 存取權,可以停用或刪除帳戶。在大多數情況下,最佳做法是停用帳戶。
下表說明停用和刪除帳戶的差異:
| 說明 | 已停用 | 已刪除 |
|---|---|---|
| 使用者可以登入 Looker 執行個體 | 否 | 否 |
| 使用者的個人資料夾 | 仍然存在 | 已刪除 |
| 使用者個人資料夾中的 Look 圖表和資訊主頁 | 仍然存在 | 已移至「垃圾桶」資料夾 |
| 使用者儲存至共用資料夾的 Look 和資訊主頁 | 仍存在於共用資料夾中 | 仍存在於共用資料夾中 |
| 使用者建立的排程 | 已停用時間表 | 刪除排程 |
| 根據使用者內容建立,但由其他使用者建立的排程 | 排程會繼續執行 | 使用者的內容會遭到刪除,根據該內容建立的排程也會刪除 |
| 將使用者列為收件者,且由其他使用者建立、可將內容傳送至外部電子郵件帳戶的排程 | 排程會繼續正常執行及傳送 (使用者會被視為外部使用者) | 排程會繼續正常執行及傳送 (系統會將該使用者視為外部使用者) |
| 已啟用「以收件者的身分執行排程」,且將使用者列為收件者的排程 | 排程會繼續執行,但下次執行時無法傳送給已停用的使用者 | 排程會繼續執行,但無法傳送給所有使用者,並顯示錯誤 run_as_recipient was specified on ScheduledPlan but recipient is not a Looker user |
| 使用者建立的白板 | 仍然存在 | 仍然存在 |
| 使用者建立的快訊 | 保持啟用狀態,但除非管理員自行指派,否則無法透過設定快訊的資訊主頁查看或編輯。管理員可以前往「管理」管理面板的「快訊」管理頁面,編輯或自行指派快訊。 | 快訊會立即從資訊主頁和「管理面板」中的「快訊」管理頁面中刪除。 |
| 使用者的歷來用量資訊 | 保留 | 大部分會刪除 |
停用使用者
如要防止使用者帳戶或服務帳戶存取 Looker,最佳做法通常是停用帳戶。停用帳戶後,系統會保留帳戶的使用記錄和個人內容。如要進一步瞭解停用和刪除帳戶之間的差異,請參閱本頁「移除使用者存取權」一節中的表格。
如果您使用的是 Looker (Google Cloud Core) 執行個體,停用使用者不會影響該使用者的 IAM 權限。移除 Looker IAM 權限,確保使用者無法存取執行個體。
如要停用帳戶,請在使用者資料列右側的三點圖示「選項」選單中,選取「停用」。

刪除使用者
建議您停用使用者帳戶,而非刪除使用者。這樣一來,使用者就無法登入,但其資訊、內容和記錄仍會保留。如要進一步瞭解停用和刪除使用者之間的差異,請參閱本頁「移除使用者存取權」一節中的表格。
如果您使用的是 Looker (Google Cloud Core) 執行個體,刪除使用者不會影響該使用者的 IAM 權限。移除 Looker IAM 權限,確保使用者無法存取執行個體。
如要刪除帳戶,請執行下列任一操作:
- 在帳戶列右側的三點圖示「選項」選單中,選取「刪除」。
- 在帳戶的「編輯使用者」頁面,點選「刪除」按鈕。

模擬 (sudoing) 使用者
您可以使用 sudo 模式,以其他使用者的身分瀏覽 Looker,並享有該使用者的所有權限和功能。
Sudoing 也是一種實用的方法,可用來驗證您是否已正確設定權限和其他功能,或在使用者提交及推送變更前,查看其 LookML 開發。
您必須同時具備 see_users 和 sudo 權限,才能以其他使用者的身分執行 sudo。管理員可以 sudo 為任何其他使用者,包括其他管理員。非管理員使用者只能以其他非管理員使用者的身分執行 sudo。
如要模擬使用者,請在使用者資料列右側的三點圖示「選項」選單中,選取「模擬這位超級使用者」:

畫面頂端的列會警告您處於 sudoed 狀態。這樣就能退出 sudoed 狀態。在這種狀態下所做的任何變更,都會影響您模擬的使用者。
如果您處於開發模式,其他使用者必須等到您將變更部署至正式環境後,才能看到變更。如果您尚未部署變更供其他使用者查看,則以其他使用者身分執行 sudo 時,就不會看到變更。
以其他使用者身分執行 sudo 時,請注意以下幾點:
如果以已簽署嵌入使用者的身分執行 sudo,並直接與 Looker 執行個體互動,而非透過嵌入式 iframe,可能會導致非預期的結果。除了常規權限的限制外,已簽署的嵌入使用者也會受到嵌入 iframe 的限制。不過,如果使用者以已簽署嵌入使用者的身分執行 sudo,並在 iframe 外部互動,則可能不會受到這些限制。
如果資料庫連線使用 OAuth,例如 Snowflake、Google BigQuery、Trino 和 Databricks,管理員以其他使用者身分執行 sudo 時,會使用該使用者的 OAuth 存取權杖執行查詢。使用者在 Looker 授權 OAuth 資料庫連線時,「授權 OAuth 連線」對話方塊會通知他們,管理員或開發人員等具備權限的 Looker 使用者,可能可以查看他們的資料。如果使用者的存取權杖已過期,管理員無法代表 sudoed 使用者建立新權杖,使用者必須登入資料庫並重新授權 Looker。
當您以其他使用者身分執行 sudo 時,系統不會向您顯示該使用者的 API 金鑰。
您只能以標準使用者身分執行 sudo,無法以服務帳戶身分執行。