将 Looker 连接到您的数据库

保护和配置数据库后，您就可以将数据库连接到 Looker 了。

您可以在 Looker 的将数据库连接到 Looker 页面上创建数据库连接。您可以通过以下两种方式打开将数据库连接到 Looker 页面：

  • 点击 主菜单图标，选择管理，然后从管理控制台面板的数据库部分中选择连接。在连接页面上，点击添加连接按钮。
  • 点击主导航菜单中的创建按钮，然后选择连接菜单项。

本页面介绍了 Looker 在将数据库连接到 Looker 页面上显示的常见字段。该页面上显示的确切字段取决于您的方言设置。

如需了解如何将用户属性应用于连接设置，请参阅用户属性文档页面的连接部分。

“数据库连接设置”包含以下四个部分：

常规设置

名称

您想要引用的连接名称。您需要在 LookML 模型的 connection 参数中使用此数据库连接名称。数据库连接名称也是在 Looker 的连接 “管理”页面上标识连接的方式。请勿在此设置中使用任何文件夹的名称。此值无需与数据库中的任何内容匹配；Name 是一个标签，用于在 Looker 界面中标识此连接。

SQL 方言

与您的连接匹配的 SQL 方言。请务必选择正确的值，以便您看到正确的连接选项，并且 Looker 可以将您的 LookML 正确转换为 SQL。

使用最新的驱动程序版本

默认情况下，Looker 始终使用适用于您的数据库方言的最新版本 JDBC 驱动程序连接到您的数据库。如果您选择的数据库方言有多个受 Looker 支持的 JDBC 驱动程序版本，您可以停用使用最新驱动程序版本切换开关，为连接选择更早的 JDBC 驱动程序版本。如果您想选择较低版本的 JDBC 驱动程序，可以为连接停用使用最新驱动程序版本切换开关，然后从驱动程序版本下拉菜单中选择驱动程序版本。

如果您选择较早的 JDBC 驱动程序版本，Looker 将继续使用该较早版本，直到 Looker 不再支持该版本。

在以下两种情况下，Looker 将停止支持某个驱动程序版本：

  • Looker 支持已移除该驱动程序版本。在这种情况下，连接将使用 Looker 支持的该方言的最早驱动程序版本。
  • 由于 Looker 回滚，驱动程序版本尚不存在。在这种情况下，连接将使用回滚版本支持的最新驱动程序版本。

如果 Looker 不再支持您选择的驱动程序版本，Looker 会在修改数据库连接页面上的驱动程序版本字段下显示一条提醒，告知您所选驱动程序版本不再受支持。该提醒还会告知您 Looker 用于连接的驱动程序版本。如需清除此提醒，请从驱动程序版本下拉菜单中选择受支持的 JDBC 驱动程序版本，或启用使用最新驱动程序版本切换开关以使用最新驱动程序版本。

项目范围

选择连接是应能够用于所有项目，还是仅用于一个项目：

  • 所有项目：实例上的所有 LookML 项目都可以访问该连接，因此可以在该项目中模型文件的 connection 参数中指定连接名称。
  • 所选项目：实例上只有一个 LookML 项目可以访问该连接。选择此选项后，“连接”屏幕会显示实例中项目的下拉菜单。选择可以访问此连接的项目。

将此选项与以下权限搭配使用，可委托连接管理和模型配置：

状态详细信息

展开状态详情部分，测试连接设置。

数据库设置

启用 SSH 服务器

只有当实例部署在 Kubernetes 基础设施上，并且向 Looker 实例中添加 SSH 服务器配置信息的功能已启用时，SSH 服务器选项才可用。如果您的 Looker 实例未启用此选项，而您想启用，请与 Google Cloud 销售专家联系，或提交支持请求。如果您开启启用 SSH 服务器选项，Looker 将显示 SSH 服务器和 SSH 隧道字段。

SSH 服务器

您无法指定 localhost 端口；SSH 服务器会自动为您选择 localhost 端口。如果您需要创建需要指定 localhost 端口的 SSH 连接，请提交支持请求。

从下拉列表中选择 SSH 服务器配置。必须选择 SSH 服务器才能选择或创建合适的 SSH 隧道。您可以在连接面板的 SSH 服务器标签页中创建新的 SSH 服务器。

SSH 隧道

从下拉列表中选择现有的 SSH 隧道，或者如果您想使用主机名和端口或本地端口创建新的 SSH 隧道，请点击创建新隧道图标。

主机名

Looker 应该用于连接到数据库主机的数据库主机名。

如果您与 Looker 分析师合作配置了到数据库的 SSH 隧道，请在主机字段中输入 "localhost"。如果您将用户属性应用于主机字段，则该用户属性的用户访问权限级别不能设置为可修改。如果您配置了 SSH 隧道来连接到数据库，则无法将用户属性应用于远程主机：端口字段。

端口

Looker 应该用于连接到数据库主机的数据库端口。

如果您与 Looker 分析师合作配置了到数据库的 SSH 隧道，请在端口字段中输入重定向到数据库的端口号，该端口号应由 Looker 分析师提供。

本地端口

默认情况下，Looker 会自动为 SSH 隧道选择可用的本地端口。如需手动选择本地端口，请选择手动输入，然后在自定义本地端口字段中输入端口号。确保您的实例上有可用的本地端口。

结算项目 ID（仅限 Google BigQuery）

结算项目 ID 是 Google Cloud 项目 ID。如需了解详情，请参阅 Google BigQuery 文档页面。

存储项目 ID（仅限 Google BigQuery）

存储项目 ID 的名称（如果您将计算和存储分别放在不同的项目中）。如果 LookML 开发者在 LookML 视图、探索或联接的 sql_table_name 参数中指定了完全限定的表名称，则您可以查询其他 Google Cloud 项目中的数据集。如需了解详情，请参阅 Google BigQuery 文档页面。

主数据集（仅限 Google BigQuery）

您希望 Looker 在查询数据库时默认使用的数据集的名称。如需了解详情，请参阅 Google BigQuery 文档页面。

数据库名称

主机上的数据库的名称。例如，您可能有一个主机名为 my-instance.us-east-1.redshift.amazonaws.com 的主机，其中有一个名为 sales_info 的数据库。您需要在此字段中输入 sales_info。如果同一主机上有多个数据库，您可能需要创建多个连接才能使用这些数据库（MySQL 除外，在 MySQL 中，“数据库”一词的含义与大多数 SQL 方言略有不同）。

默认架构

未指定架构时 Looker 使用的默认架构。这适用于您使用 SQL Runner 时、LookML 项目生成期间以及查询表时。

身份验证设置

对于 Google BigQuery、Snowflake、Trino 和 Databricks 连接，请选择您希望 Looker 用于访问数据库的身份验证类型：

  • 对于 Google BigQuery 连接，您可以选择配置 OAuth 或服务账号，供 Looker 用于向数据库进行身份验证。
  • 对于 Snowflake、Trino 和 Databricks 连接，您可以选择配置 OAuth 或数据库账号，供 Looker 用于向数据库进行身份验证。

使用 OAuth 时，用户必须登录数据库才能从 Looker 发出查询。当用户在 Looker 中启动 OAuth 授权流程时，Looker 会显示授权 OAuth 连接对话框，通知用户授权连接后，Looker 实例可以代表他们访问数据，并且具有特权的 Looker 用户（例如管理员或开发者）可能会看到他们的数据。用户必须选择授权才能继续进入 OAuth 登录页面。同意信息存储在浏览器的本地存储空间中；如果本地存储空间被清除，则用户下次启动 OAuth 授权流程时，该对话框会再次出现。如需详细了解如何在与 Looker 的连接上配置 OAuth，请参阅 Google BigQuery、Snowflake、Trino 或 Databricks 连接过程。

用户名

Looker 可用于连接到数据库的数据库用户账号中的用户名。

密码

Looker 可用于连接到数据库的数据库用户账号密码。

展开状态详情部分，测试连接设置。

可选设置

每个节点的连接数上限

您可以在此处设置 Looker 可与您的数据库建立的连接数上限。在大多数情况下，您需要设置 Looker 可针对数据库同时运行的查询数量。Looker 还会预留最多三个连接用于终止查询。如果连接池非常小，Looker 将预留较少的连接。

请谨慎设置此值。如果该值过高，则可能会使数据库过载。如果该值过低，则查询必须共享少量连接，这可能会导致许多查询对用户而言显得很慢，因为这些查询必须等待其他较早的查询返回。

默认值（因 SQL 方言而异）通常是一个合理的起点。大多数数据库也都有自己的设置，用于指定它们将接受的连接数上限。如果您的数据库配置限制了连接数，请确保每个节点的最大连接数值等于或低于数据库的限制。

连接池超时时间

如果用户请求的连接数超过了每个节点的最大连接数设置，则这些请求将等待其他请求完成后再执行。请求的最长等待时间在此处配置。默认设置为 120 秒。

请谨慎设置此值。如果设置得太低，用户可能会发现自己的查询被取消，因为其他用户的查询没有足够的时间完成。如果设置得过高，可能会导致大量查询积压，从而导致用户等待很长时间。默认值通常是一个合理的起点。

此连接的并发查询数上限

此可选值限制了 Looker 一次向此数据库连接提交的并发查询数量。如果有更多并发请求到达，要求使用相同的连接，Looker 会将这些请求排入内部队列，并按顺序处理。设置此值会覆盖现有的每个节点的连接数上限值。

此连接的每用户并发查询数上限

此可选值限制了 Looker 一次向此数据库连接提交的来自同一用户的并发查询数。如果有更多并发请求到达，要求使用相同的连接，Looker 会将这些请求排入内部队列，并按顺序处理。默认值由数据库方言设置，通常为 25。

此连接的每用户并发查询数上限设置适用于为其设置的单个连接。此设置会覆盖连接的实例级 per-user-query-limit 启动选项。

由于此连接的每用户并发查询数上限设置会覆盖 per-user-query-limit 设置，因此请务必了解这些设置有何不同：

  • 此连接的每用户并发查询数上限设置适用于每个用户和每个连接，但不适用于每个节点。此连接的每用户并发查询数上限设置适用于用户在整个 Looker 实例中针对该连接的并发查询。对于集群化 Looker 实例，您为此连接的每用户并发查询数上限设置的值会除以 Looker 集群中的节点数，以确定用户可以在每个节点上运行的并发查询数。

    例如，如果您有一个 5 节点集群，并将此值设置为 15，则每个节点将允许每个用户对此连接执行 3 个并发查询 (15 / 5 = 3)，所有节点总共执行 15 个查询。

  • per-user-query-limit 启动选项适用于每个用户、每个连接和每个节点。

    例如，如果您有一个 5 节点集群，其 per-user-query-limit 为 15，则每个节点将允许每个用户对此连接执行 15 个并发查询，所有节点总共允许 75 个查询 (15 * 5 = 75)。

因此，对于集群化 Looker 实例，为此连接的每用户并发查询数上限应用值可能会影响用户的查询性能。

其他 JDBC 参数

Java 数据库连接 (JDBC) 驱动程序是管理 Looker 与数据库之间连接的软件组件。

当数据库的 JDBC 驱动程序启动从 Looker 到数据库的连接时，该驱动程序会创建一个包含一组参数的网址，例如主机、端口、数据库或仓库，以及其他特定于方言的参数。为数据库设置连接时，您可以指定 Looker 在与数据库驱动程序通信时应包含的其他 JDBC 参数。根据您的方言和特定参数，JDBC 参数可能由 JDBC 驱动程序处理，也可能传递到您的数据库。

为了确保连接安全，Looker 针对每种数据库方言支持的 JDBC 参数设置了许可清单。

  • 如果您尝试使用不受支持的 JDBC 参数创建或更新连接，Looker 会显示一条出错提示，其中会显示不允许使用的参数。
  • 如果您现有的连接包含不受支持的 JDBC 参数，Looker 将移除这些参数，然后连接到您的数据库。

如需查看所用方言支持的 JDBC 参数列表，请参阅所用方言的数据库配置说明页面中的“支持的 JDBC 参数”部分。

如需在 JDBC 参数中引用用户属性，请使用 Liquid 模板语法：_user_attributes['name_of_attribute']。请参阅以下示例：

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

维护时间表

Looker 重新生成器会检查基于 sql_trigger_value 的数据组和永久性表（包括汇总表和永久性派生表）。根据这些检查，Looker 重新生成器会从数据库的底层存储架构中重新构建或删除永久性表。

维护时间表值用于设置 Looker 重新生成器的 cron 间隔。Looker 重新生成器会启动一个重新生成器周期，以按 cron 间隔检查数据组和永久性表。如果 Looker 重新生成器周期在下一个 cron 间隔仍在进行中，则 Looker 重新生成器将完成正在进行的重新生成器周期，然后等待后续 cron 间隔开始下一个重新生成器周期。

维护时间表设置接受 cron 表达式。默认值为 */5 * * * *，这意味着如果上一个重新生成器周期已完成，Looker 重新生成器周期将以 5 分钟为间隔启动一个周期。如果上一个重新生成器周期尚未完成，Looker 重新生成器将在其周期完成后的下一个五分钟时间间隔内启动。

默认间隔时间为 5 分钟，这也是维护时间表支持的最频繁间隔时间。Looker 不会强制执行维护时间表的最大间隔，这意味着您可以将 Looker 重新生成器周期之间的间隔延长至 cron 表达式可以指定的时间。请注意，Looker 重新生成器周期越长，缓存和永久表中的数据新鲜度就越低。

Looker 重新生成器在一个周期内完成所有检查和 PDT 重新构建后，会等待下一个 cron 间隔时间，然后启动下一个周期。如果 PDT 构建过程耗时较长，Looker 重新生成器周期之间可能会有较长的间隔。其他因素也可能会影响重新构建表所需的时间，如 Looker 中的派生表页面上的实现永久表的重要注意事项部分所述。

如果您的数据库并非全天候运行，您可能需要将检查限制在数据库运行的时间段内。下面是一些其他 cron 表达式：

cron 表达式 定义
*/5 8-17 * * MON-FRI 在周一至周五的营业时间内，每隔 5 分钟检查一次数据组和 PDT
*/5 8-17 * * * 在营业时间内，每天每隔 5 分钟检查一次数据组和 PDT
0 8-17 * * MON-FRI 在周一至周五的营业时间内，每小时检查一次数据组和 PDT
1 3 * * * 每天凌晨 3:01 检查数据组和 PDT

创建 cron 表达式时，请注意以下几点：

  • Looker 使用 parse-cron v0.1.3，该版本不支持在 cron 表达式中使用 ?。
  • cron 表达式使用 Looker 应用时区来确定何时进行检查。
  • 如果 PDT 未构建，请将 cron 字符串重置回默认值 */5 * * * *。

以下是一些可帮助您创建 cron 字符串的资源：

停用连接

借助停用连接选项，Looker 管理员可以在数据库出现下游问题时暂时关闭连接，而无需手动终止查询或允许查询保留在查询队列中。

启用停用连接切换开关后，Looker 不会向数据库发送任何查询，而是会向用户返回一条出错提示，指出连接已停用。

数据库问题解决后，Looker 管理员可以关闭停用连接切换开关。重新启用连接后，所有查询都将再次按预期运行。

SSL

选择是否要使用 SSL 加密来保护在 Looker 和数据库之间传输的数据。SSL 只是可用于保护数据的选项之一；启用安全的数据库访问文档页面上介绍了其他安全选项。

验证 SSL

选择是否需要验证连接使用的 SSL 证书。如果需要验证，则签署 SSL 证书的 SSL 证书授权机构 (CA) 必须来自客户端的可信来源列表。如果 CA 不是可信来源，则不会建立数据库连接。

如果未选中此复选框，则连接仍会使用 SSL 加密，但不需要验证 SSL 连接，因此当 CA 不在客户端的受信任来源列表中时，也可以建立连接。

预缓存表和列

在 SQL Runner 中，选择连接和架构后，系统会预加载所有表信息。这样，SQL Runner 就能在您点击表名称后快速显示表列。不过，对于包含许多表或非常大的表的连接和架构，您可能不希望 SQL Runner 预加载所有信息。

如果您希望 SQL Runner 仅在选择表时加载表信息，则可以取消选中预缓存表和列选项，以停用 SQL Runner 针对连接的预加载功能。

提取并缓存架构

对于某些 SQL 编写功能（例如汇总感知），Looker 会使用数据库的信息架构来优化 SQL 编写。如果信息架构未缓存，Looker 可能偶尔需要阻止向数据库写入 SQL，以便能够提取信息架构。对于 Denodo 方言或使用 Hadoop 分布式文件系统 (HDFS) 的方言，提取信息架构可能需要很长时间，从而严重影响 Looker 查询的性能。如果您知道信息架构速度较慢，则可以为连接停用提取和缓存架构选项。停用此功能会阻止 Looker 针对某些功能进行 SQL 优化，因此您应启用提取和缓存架构选项，除非您知道连接的信息架构特别慢。

费用估算值

费用估算切换开关仅适用于以下数据库连接：

费用估算切换开关可为连接启用以下功能：

如需了解详情，请参阅在 Looker 中探索数据文档页面。

数据库连接池

对于支持数据库连接池的方言，此功能允许 Looker 通过 JDBC 驱动程序使用连接池。数据库连接池可提高查询性能；新查询无需创建新的数据库连接，而是可以使用连接池中的现有连接。连接池功能可确保在查询执行后清理连接，并在查询执行结束后可供重复使用。如需了解详情，请参阅数据库连接池文档页面。

永久性派生表 (PDT) 设置

如果启用了 PDT，则会显示以下设置。

启用 PDT

开启启用 PDT 切换开关，以启用永久性派生表。启用 PDT 后，连接窗口会显示其他 PDT 字段和 PDT 覆盖部分。仅当数据库方言支持使用 PDT 时，Looker 才会显示启用 PDT 切换开关。

关于 PDT，请注意以下几点：

  • 使用 OAuth 的 Snowflake 连接不支持 PDT。
  • 在连接上停用 PDT 不会停用与 PDT 关联的数据组。即使您停用 PDT，现有数据组仍会针对数据库运行其 sql_trigger 查询。如果您想阻止数据组针对数据库运行其 sql_trigger 查询，则必须从 LookML 项目中删除或注释掉 datagroup 参数，或者您可以更新连接的维护时间表设置，以便 Looker 极少或从不检查 PDT 和数据组。
  • 对于 Snowflake 连接，Looker 会将 AUTOCOMMIT 参数的值设置为 TRUE（Snowflake 的默认值）。Looker 运行的 SQL 命令需要 AUTOCOMMIT，以维护其 PDT 注册系统。

临时数据库

虽然此数据库标记为临时数据库，但您应根据自己的 SQL 方言输入数据库名称或架构名称，Looker 应使用该名称来创建永久性派生表。您应提前配置此数据库或架构，并授予适当的写入权限。在数据库配置说明文档页面上，选择您的数据库方言，以查看该方言的说明。

每个连接都必须有自己的临时数据库或架构；临时数据库或架构无法在连接之间共享。

PDT 构建器连接数上限

借助 PDT 构建器连接数上限设置，您可以指定 Looker 重新生成器可以在数据库连接上启动的并发表构建数量。PDT 构建器连接数上限设置仅适用于 Looker 重新生成器为其启动重新构建的表类型：

  • 触发器持久性表（使用 datagroup_trigger 或 sql_trigger_value 持久性策略的永久性派生表和汇总表格）。
  • 使用 persist_for 策略的永久表，但仅当 persist_for 表属于派生表级联，且依赖于使用 datagroup_trigger 或 sql_trigger_value 持久化策略的表时。在这种情况下，Looker 重新生成器将重新构建 persist_for 表，因为需要该表来重新构建级联中的另一个表。否则，重新生成器不会为 persist_for 表启动构建。

PDT 构建器连接数上限设置默认为 1，但最高可设置为 100。不过，该值不能高于每个节点的最大连接数字段中设置的值，也不能高于 Looker 的启动选项中设置的 per-user-query-limit。

请谨慎设置此值。如果该值过高，可能会导致数据库过载。如果该值较低，则长时间运行的 PDT 或汇总表格可能会延迟其他永久表的创建，或减慢连接上的其他查询。支持多租户的数据库（例如 BigQuery、Snowflake 和 Redshift）在处理并行查询构建时可能具有更高的性能。

如果您想提高 PDT 构建器连接数上限设置，最佳做法是先将其提高 1。如果出现任何异常行为，请将其重新设置为默认值 1。否则，如果查询性能未受到影响，您可以继续以 1 为增量逐步提高该设置，并在每次增加后验证性能，然后再进一步提高该设置。

请注意关于 PDT 构建器连接数上限设置的以下事项：

  • PDT 构建器连接数上限设置仅适用于重新构建表所需的连接，不适用于触发器检查所需的连接。触发器检查是一种查询，用于检查是否触发了表的持久化策略；由于这些触发器检查查询始终按顺序运行，因此 PDT 构建器连接数上限设置不适用。
  • 在集群化 Looker 实例中，重新生成器仅在主节点上运行。PDT 构建器连接数上限设置仅适用于主节点，因此会设置整个集群的限制。
  • PDT 构建器连接数上限设置不适用于以下类型的表。这些类型的表是连续构建的：
    • 通过 persist_for 参数保留的表（除非该表被使用 datagroup_trigger 或 sql_trigger_value 策略的表所依赖）。
    • 开发模式下的表。
    • 使用重新构建派生表并运行选项重新构建的表。
    • 在依赖关系级联中，一个表依赖于另一个表。表无法与其所依赖的表同时构建。例如，如果 table_B 依赖于 table_A，则 table_A 必须先完成重新构建，然后 table_B 才能开始重新构建。

重试失败的 PDT 构建

重试失败的 PDT 构建切换开关用于配置 Looker 重新生成器如何尝试重新构建在上一个重新生成器周期中失败的触发器持久性表。Looker 重新生成器是一个进程，它会根据 Maintenance Schedule（维护时间表）连接设置中配置的时间间隔，重新构建触发器持久性表（PDT 和汇总表格）。启用重试失败的 PDT 构建切换开关后，Looker 重新生成器会尝试重新构建在上一个重新生成器周期中失败的 PDT，即使未满足 PDT 的触发条件也是如此。停用此设置后，Looker 重新生成器仅会在满足 PDT 的触发条件时尝试重新构建之前失败的 PDT。重试失败的 PDT 构建默认处于停用状态。

如需详细了解 Looker 重新生成器，请参阅 Looker 中的派生表文档页面。

PDT API 控制

PDT API 控制切换开关决定了是否可以对此连接使用 start_pdt_build、check_pdt_build 和 stop_pdt_build API 调用。如果 PDT API 控制切换开关处于停用状态，则这些 API 调用在引用此连接上的 PDT 时会失败。PDT API 控制切换开关默认处于停用状态。

启用 PDT 覆盖

如果您的数据库支持永久性派生表，并且您已在连接设置中开启启用 PDT 切换开关，Looker 会显示 PDT 替换 切换开关。启用 PDT 覆盖切换开关，以显示 PDT 覆盖部分，您可以在其中输入单独的专用于 PDT 进程的 JDBC 参数（主机、端口、数据库、用户名、密码、架构、其他参数和连接后语句）。这在很多方面都很有价值：

  • 通过为 PDT 进程创建单独的数据库用户，即使您为数据库登录凭证分配了用户属性或为数据库连接使用了 OAuth，也可以在 Looker 项目中使用 PDT。
  • PDT 进程可以通过具有更高优先级的单独数据库用户进行身份验证。这样，数据库就可以优先处理 PDT 作业，而不是不太重要的用户查询。
  • 您可以撤消标准 Looker 数据库连接的写入权限，并仅向 PDT 进程用于身份验证的特殊用户授予该权限。对于大多数组织而言，这是一种更好的安全策略。
  • 对于 Snowflake 等数据库，PDT 进程可以路由到不与其他 Looker 用户共享的更强大的硬件。这样，PDT 就可以快速构建，而无需承担全天候运行昂贵硬件的费用。

例如，在将用户名和密码字段设置为用户属性的连接上，PDT 替换部分可以创建具有自己的密码的单独用户 (pdt_user)。采用此配置后，系统会执行以下操作：

  • 每个用户都可以使用其用户属性分配的个人凭证访问数据库。
  • pdt_user 账号将用于所有 PDT 流程，其访问权限级别适合 PDT 创建和更新。
  • 用户查询流量和 PDT 进程流量可以快速区分，以便使用系统活动进行监控等。

数据库时区

您的数据库用于存储基于时间的信息的时区。Looker 需要知道这一点，以便为用户转换时间值，从而更轻松地理解和使用基于时间的数据。如需了解详情，请参阅使用时区设置文档页面。

查询时区

只有在停用了用户自选时区的情况下，查询时区选项才会显示。

停用用户自选时区后，查询时区是用户在查询基于时间的数据时显示的时区，也是 Looker 将基于时间的数据从数据库时区转换到的时区。

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

展开状态详情部分，测试连接设置。

查看

输入所有数据库连接设置后，您可以查看并测试连接，以确保其配置正确。

测试连接设置

您可以点击连接设置页面底部状态详情部分中的测试连接按钮，测试连接设置。

如果 Looker 显示可以连接，请按连接以创建连接。然后，您的数据库连接会添加到 Looker 连接 管理页面上的列表中。

管理员可以随时测试连接，只需点击连接管理页面上连接列表旁边的测试按钮即可，如连接文档页面所述。

如果您已将一个或多个连接参数值设置为用户属性，则系统会显示以用户身份测试选项。选择一个用户，然后点击测试，以验证数据库能否以此用户身份连接并运行查询。

问题排查

如果您的连接未通过一项或多项测试，请注意以下事项：

  • 如果您在 Atlas 上运行 Mongo 3.6 或更早版本，并且遇到通信链路故障，请参阅 Mongo 连接器文档页面。
  • 如需接收有关临时架构和 PDT 的成功连接消息，您必须在设置 Looker 数据库时允许该功能。如需了解如何执行此操作，请参阅数据库配置说明文档页面。
  • 使用 OAuth 的数据库连接（例如 Snowflake、Google BigQuery、Trino 和 Databricks）需要用户登录。如果您在测试其中一个连接时未登录 OAuth 用户账号，Looker 会显示一条警告，其中包含登录链接。点击该链接，在授权 OAuth 连接对话框中选择授权（如果出现提示），然后输入您的 OAuth 凭据，以允许 Looker 访问您的 OAuth 账号信息。
  • 对于客户托管的 Looker 实例，请参阅测试客户托管实例的数据库连接文档页面，获取问题排查提示。

后续步骤

将数据库连接到 Looker 后，您就可以为用户配置登录选项了。