管理员设置 - 常规设置

在管理面板的常规部分中，Looker 管理员可以在设置页面上配置 Looker 的实例级设置。某些设置仅适用于 Looker（原始版本）实例，或仅适用于 Looker (Google Cloud Core) 实例。

注意： 如果您拥有的权限仅允许您访问管理面板中的特定页面（例如 manage_schedules、manage_themes 或 see_admin），但您没有管理员角色，则管理面板中可能不会显示此处所述的页面。

设置

以下设置适用于 Looker 实例。

强制使用 BigQuery 只读权限范围

启用此设置后，系统会使拥有 OAuth 凭据的用户退出登录，这些凭据允许对任何 BigQuery 连接使用读取和写入权限范围。当用户再次进行身份验证时，Looker 将改为为这些用户创建只读 OAuth 凭据。如需了解详情，请参阅将 Google BigQuery 连接的 OAuth 范围限制为只读。

许可密钥

注意： Looker (Google Cloud Core) 实例不包含此设置。

许可密钥是您所用 Looker 实例的唯一标识符。根据您的许可协议启用或停用某些 Looker 功能。

许可密钥默认处于隐藏状态。选择眼睛图标 以显示许可密钥。

主机网址

注意： Looker (Google Cloud Core) 实例不包含此设置。如需了解如何在 Looker (Google Cloud Core) 中设置自定义网域，请参阅为 Looker (Google Cloud Core) 实例设置自定义网域文档页面。

主机网址是 Looker 实例网址的基础部分。当在预定电子邮件和 Looker 生成的所有绝对网址中创建指向您实例的链接时，系统会专门使用此设置。

请确保 Host 网址 设置根据实例的服务器配置正确使用 http:// 或 https://。

更改主机网址可能会影响某些 Looker 功能。请参阅如果 Looker 实例的网址发生变化，会怎么样？最佳实践页面，详细了解如何更改实例网址。

技术联系人

注意： Looker (Google Cloud Core) 实例不包含此设置。您可以通过 Google Cloud 控制台为 Looker (Google Cloud Core) 添加技术联系人。将通知类别设置为技术。

添加到此框中的电子邮件地址将收到有关安全更新、重大 bug 修复和新 Looker 版本的通知。电子邮件地址必须属于有效的 Looker 用户。如果您添加的电子邮件地址不属于有效的 Looker 用户（例如，电子邮件分发列表的电子邮件地址），该电子邮件地址将显示在技术联系人字段中，但 Looker 无法将通知发送到此地址。

Looker 支持团队需要获得技术联系人的许可才能执行以下任何操作：

• 导致实例停机，原因可能是非计划的版本更新、Looker 服务器的性能变化或其他原因
• 更改 Looker 许可的某些方面，以便为您启用新功能。

应用时区

在探索、Look 或信息中心内显示数据时，Looker 可以将时间数据从连接的数据库时区转换为适合相应用户的时区。

如果启用了用户专用时区选项，则管理员可以设置用户的默认时区，或者用户可以设置自己的默认时区。如果管理员或用户未设置用户的默认时区，系统会为该用户使用应用时区，并且该用户查询的所有基于时间的数据都将转换为应用时区。

应用时区设置也用作内容交付的默认时区。用于安排的时间区不会影响查询返回的时间数据，只会影响发送数据交付的时间。

如需了解详情，请参阅使用时区设置文档页面。

功能配置

以下功能配置设置适用于 Looker 实例。

封闭式系统

注意： 此选项必须由 Looker（原始）启用；请与 Looker 支持团队联系以开始使用。Looker (Google Cloud Core) 实例默认已提供此选项。

封闭式系统设置与群组搭配使用，可防止一个群组中的用户了解另一个群组中的用户。这对于多租户安装通常很有用。

用户可能会在 Looker 中的以下位置看到其他用户：

• Looker 的管理部分中的“用户”页面
• Looker 主菜单的文件夹部分中的用户文件夹，前提是他们已获得对其他用户个人文件夹的至少查看权限
• “管理访问权限”弹出式窗口，这是文件夹管理的一部分

启用封闭式系统设置后，没有 see_users 权限的非管理员用户只能查看与自己同属一个组的其他用户，并且只能查看自己所属的组。

管理员和获得 see_users 权限的任何用户都可以查看实例上的所有用户和群组。

注意： 管理员可以修改文件夹公开范围，从而允许用户查看未与自己共享群组的其他用户的个人文件夹，进而覆盖封闭式系统设置。

“登录同意”配置

注意： 此设置仅适用于 Looker (Google Cloud Core) 实例。

启用后，登录同意配置会导致系统向尝试登录 Looker 实例的所有用户显示同意屏幕。同意情况征求界面将显示在消息配置字段中输入的消息，并且要求用户点击同意情况征求界面上的我同意按钮，然后才能登录实例。启用登录同意情况配置后，消息配置字段会显示出来。

消息配置

注意： 此设置仅适用于 Looker (Google Cloud Core) 实例。

如果启用了登录同意情况配置选项，请在消息配置字段中输入将向尝试登录 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 通知横幅

启用后，此设置会向您实例中的所有用户显示 Cookie 通知横幅。默认情况下，此设置处于停用状态。

如果您的 Looker 实例必须遵守欧盟的数据保护法规，我们建议您启用此设置。

精选搜索

注意： 精选搜索不适用于封闭式系统，但在其他情况下默认处于启用状态。

启用精选搜索后，用户可以搜索共享文件夹、个人文件夹和看板中的内容。只有当其他用户个人文件夹中保存的内容也固定到某个主题板时，才会包含在结果中。搜索结果将排除仅存在于其他用户的个人文件夹中的内容。用户可以在搜索对话框模态框中选择精选搜索功能名称旁边的开关，选择排除个人文件夹中的内容。

限制“自动刷新信息中心”选项

启用此设置后，只有 Looker 管理员才能在用户定义的信息中心上启用自动刷新信息中心选项。这样可以防止非管理员用户自动刷新信息中心和信息中心图块中的数据。自动刷新信息中心数据可能会给某些数据库系统带来很大的压力。

全屏可视化图表

启用后，此功能可让您在信息中心图块中以全屏模式和展开视图查看可视化图表。如需详细了解查看选项，请参阅查看信息中心文档页面。

您可以在信息中心的“设置”菜单中关闭全屏和展开功能。

Google Cloud 项目编号

必须提供 Google Cloud 项目编号才能启用应用内支持。您可以从 console_name_short 的“Cloud 概览”页面获取此值。

此更改最长可能需要两个小时才能生效。如需立即实现更改，请在输入 Google Cloud 项目编号后，点击许可密钥设置旁边的更新按钮。

如果您还没有 Looker 的 Google Cloud 项目，可以按照我们的创建 Google Cloud 项目指南或有关创建和管理项目的更深入文档来创建一个项目。

使用 Gravatar

注意： Looker (Google Cloud Core) 实例不包含此设置。

启用后，此设置会在用户菜单中显示个人资料照片选项，让用户可以使用 Gravatar 应用为其账号选择或创建头像。

用户自选时区

添加连接时，您可以指定数据库存储时间信息的时区，即数据库时区。

启用用户自选时区后，系统会为每位用户分配一个时区，并且当用户查看查询结果或解读过滤条件时，Looker 会将基于时间的数据从数据库时区转换为用户的时区。

停用用户自选时区后，Looker 会将所有用户基于时间的数据转换为查询时区值。

如需了解详情，请参阅使用时区设置文档页面。

默认可视化颜色

每个 Looker 实例都必须有一个默认的颜色集合。借助默认可视化颜色设置，您可以为可视化图表定义默认颜色集合，还可以创建新的颜色集合以供实例使用。您可以选择现有颜色集合，也可以创建自定义颜色集合。

选择现有颜色集合

如需将现有颜色集合设为默认颜色集合，请从下拉菜单中选择相应颜色集合，然后点击更新。 注意：设置新的默认颜色集合后，使用该默认颜色集合的所有 Look 和信息中心上的可视化图表都会更新。使用其他颜色集合或自定义调色板保存的可视化图表不会受到影响。

您可以在下拉菜单下方直接查看每个集合的第一个分类调色板、顺序调色板和发散调色板。这些调色板将用作可视化图表的默认调色板。如需查看颜色集合中的所有调色板，请访问颜色集合文档页面。

创建自定义颜色集合

如需创建自定义颜色集合，请按以下步骤操作：

1. 从默认可视化图表颜色集合下拉菜单中选择最后一个新颜色集合选项。
2. 在名称字段中，为新集合指定一个唯一的名称。
3. 点击每个调色板以打开调色板中的颜色菜单。
4. 在调色板中的颜色菜单中选择单个颜色以逐个修改，或选择全部修改以一次性修改所有颜色。
5. 针对每种调色板重复执行第 3 步和第 4 步。
6. 修改完新颜色集合后，点击创建。

颜色值可以采用十六进制字符串（例如 #2ca6cd）或 CSS 颜色名称（例如 mediumblue）的格式。或者，您也可以点击色轮，打开颜色选择器并从中选择一种颜色深浅。如果您选择修改所有颜色，请使用英文逗号分隔每种颜色名称。如需添加或移除颜色，请点击 + 或 - 符号。

新集合将自动成为实例默认集合，但您可以根据需要选择其他默认集合。

任何新的自定义颜色集合的集合 ID 和调色板 ID 都基于每个集合的名称。这样一来，如果两个实例具有名称相同的自定义集合，则使用这些集合的 LookML 信息中心可以在这两个实例中以一致的方式呈现。

删除自定义颜色集合

如需删除自定义颜色集合，请从下拉菜单中选择相应集合，然后点击随即显示的删除按钮。您无法删除 Looker 的内置颜色集合。

从 CDN 加载资源

此选项仅适用于客户托管的实例。由于 Looker 托管的实例始终会从 CDN 加载资源，因此您无法为这些实例停用此设置。

CDN 是 content delivery network 的缩写。CDN 是一个服务器网络，可在多个地理位置存储内容，以缩短用户的网页加载时间。您的数据绝不会存储在这些服务器上；只有 Looker 特有的项（例如图片）会存储在 CDN 上。

从 CDN 加载资源设置可以启用或停用。启用后，Looker 页面的加载速度应该会更快。

在浏览器缓存中保留资源

启用此设置后，JavaScript 文件和字体等静态资源会缓存在每位用户的浏览器存储中。这样可以加快后续导航的速度，因为浏览器无需继续从 Looker 服务器重新加载这些资源。

移动应用访问

启用此设置后，用户可以使用 Looker 移动应用和 Looker（旧版）应用登录实例中的 Looker 账号。停用此设置后，所有现有的移动会话都会终止。

使用移动应用时强制进行身份验证

启用此设置后，用户每次在移动设备上打开 Looker 移动应用和 Looker（旧版）应用时，都需要登录。

此外，用户在移动应用中处于不活动状态 60 分钟后，系统会将其退出登录。

数据政策

以下数据政策设置适用于 Looker 实例。

公开网址

您可以启用或停用公开网址设置。启用此设置后，拥有相应权限的 Looker 用户可以生成公开网址来访问 Looker 数据。

注意： 虽然公开网址无法猜测，但拥有公开网址的任何人都可以不受安全限制地访问您的数据。请谨慎使用。

针对安排的内容的电子邮件网域许可名单

注意： 在 Looker (Google Cloud Core) 实例中，您可以在 Google Cloud 控制台内为实例设置电子邮件网域许可名单。Looker (Google Cloud Core) 实例中的设置页面不包含此设置。

借助此设置，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 属性在群组级指定电子邮件网域。用户属性接受的字符串格式与预定内容电子邮件网域许可名单管理员设置相同。

如果某个群组被分配了多个电子邮件网域集（例如，通过加入多个群组），那么该群组的成员将能够向分配给每个用户属性值的所有网域发送电子邮件，以及向预定内容的电子邮件网域许可名单管理设置中列出的网域发送电子邮件。换句话说，群组可以向其发送电子邮件的电子邮件网域集是预定内容的电子邮件网域许可名单字段中列出的电子邮件网域集与通过 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":"[e-mail]"}

如果您在嵌入网址中定义了 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 (Google Cloud Core) 实例。Looker (Google Cloud Core) 实例不会自动启用 Gemini in Looker。

默认情况下，所有 Looker（原始版本）实例都会启用此设置，但托管在 EMEA 地区的实例以及加入 Looker 的扩展支持版本 (ESR) 计划的实例除外。您可以在管理面板的平台部分中，通过 Gemini in Looker 页面手动管理 Gemini in Looker 的启用状态。

对于使用开放式系统配置的所有 Looker（原始）实例，系统会自动创建一个名为 Default Gemini Users 的新用户组。此组中的用户会被分配 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。其状态不受自动启用 Gemini in Looker 并管理用户 设置的状态影响。

默认导出格式

借助默认导出格式设置，您可以选择用户选择下载数据时使用的默认文件格式。用户仍然可以选择其他文件格式。支持以下格式：

格式	文件扩展名	说明
TXT	.txt	生成以制表符分隔的文本文件。
Excel 电子表格	.xlsx	生成采用 Microsoft Excel 2007 及更高版本格式的电子表格文件。
CSV	.csv	生成以英文逗号分隔的文本文件。
JSON	.json	生成一个 JSON 文件，其中每行包含一条记录。
HTML	.html	生成基本 HTML 以显示数据，显示方式与用户在浏览器中看到的方式类似；不过，由于不包含 Looker 的 CSS，因此格式并不完全相同。
Markdown	.md	生成一个包含 | 分隔表的标准 Markdown 文件。