管理员设置 - 关联

如需访问连接 页面,请打开管理 菜单,然后在数据库 下选择连接

查看连接

连接 页面上,您可以查看数据库连接以及允许网络流量所需的 IP 地址。如果您的实例已启用创建新数据库的功能,您还可以添加新连接。

“数据库”标签页

数据库 标签页显示了您定义的数据库连接的基本信息。如果您的实例已启用创建新数据库的功能,该标签页还会显示您创建的所有 Looker 托管连接。您还可以通过数据库 标签页测试这些连接的状态并修改其配置。

您可以点击 Public IP Addresses (公共 IP 地址)来查看允许来自 Looker 实例的网络流量所需的 IP 地址列表。来自 Looker 的所有网络流量都将来自列出的 IP 地址之一,具体取决于 Looker 实例的托管区域。禁止来自数据库的流量(来自这些 IP 地址和其他受信任 IP 地址的流量除外)是一种限制数据访问权限的方式。

下表介绍了数据库 标签页中的元素:

说明
名称 您选择的连接名称,用于 connection LookML 参数。测试连接时,Looker 会在连接名称下显示状态检查列表。
数据库 Looker 在使用此连接时将查询的数据库的名称。
范围 连接是否可用于所有项目,还是仅可用于一个特定项目。
SSH 服务器 用于创建与数据库的 SSH 隧道的 SSH 服务器配置的名称。只有在 Looker 实例中启用了 SSH 服务器 标签页时,此列才会显示。
SSL 您是否使用 SSL 加密来保护 Looker 和数据库之间传输的数据(除了 SSL 之外,还有其他安全选项)。
类型 数据库连接的 SQL 方言。
操作 您可以对连接执行的操作:测试连接、修改连接、查看其他信息有关连接的信息、跳转到连接的探索的链接列表,或删除连接。如果您的实例已启用创建新数据库的功能,您还可以将其他数据源中的数据添加到任何 Looker 托管连接

“SSH 服务器”标签页

SSH 服务器 标签页不适用于 Looker (Google Cloud Core) 实例。

只有当 Looker(原始)实例部署在 Kubernetes 基础设施上,并且向 Looker 实例中添加 SSH 服务器配置信息的功能已启用时,SSH 服务器 选项才可用。如果您的 Looker 实例未启用此选项,但您想启用它,请与销售专家 Google Cloud 联系或提交支持请求

Looker 会在创建 SSH 隧道时自动为您选择 localhost 端口;您无法指定 localhost 端口。

与 PrestoDB 或 Trino 数据库的 SSH 连接可能需要额外的数据库配置。启用 SSL 后,PrestoDB 或 Trino 数据库默认监听端口 443。如需建立 SSH 隧道,Looker 必须将 localhost 端口设置为 443,而该端口已由 Looker 使用。这会导致 SSH 隧道设置失败。如需解决此问题,请将 PrestoDB 或 Trino 数据库配置为在启用 SSL 时监听端口 443 以外的端口。

SSH 服务器 标签页列出了您添加的 SSH 服务器配置,指明了与 SSH 服务器的连接状态,并列出了使用每个 SSH 服务器的数据库连接。您还可以通过 SSH 服务器 标签页 测试与 SSH 服务器的连接,以及 添加或修改 SSH 服务器配置

下表介绍了SSH 服务器 标签页中的元素:

说明
服务器名称 您选择的 SSH 服务器配置的名称,用于连接到数据库。
连接 连接到 SSH 服务器的数据库连接列表。点击数据库连接会打开该数据库连接的修改连接 页面。
三点状选项 菜单 您可以对 SSH 服务器配置执行的操作:测试与 SSH 服务器的连接向 SSH 服务器添加数据库连接修改 SSH 服务器配置,或删除 SSH 服务器配置。

添加或修改 SSH 服务器配置

如需添加新的 SSH 服务器配置,请执行以下操作:

  1. SSH 服务器 标签页中,点击 Add Server (添加服务器)
  2. 在右上角的 Unnamed Server (未命名服务器)字段中,输入 SSH 服务器配置的名称。
  3. 点击 Download Key (下载密钥)可将公钥下载到文本文件中。请务必保存此文件,以备日后使用。
  4. Server Username (服务器用户名)字段中,输入 Looker 将用于连接到 SSH 服务器的用户名。
  5. Server IP Address or Hostname (服务器 IP 地址或主机名)字段中,输入 SSH 服务器 IP 地址或主机名。
  6. Server Port (服务器端口)字段中,输入用于连接到 SSH 服务器的端口号。
  7. 将下载的公钥添加到 SSH 服务器上的授权密钥文件。如需了解详情和示例,请参阅使用 SSH 服务器文档页面。
  8. 确保将相应的 Looker IP 地址添加到许可名单 中,以便 Looker 可以连接到 SSH 服务器。
  9. 点击 Test &Request Fingerprint (测试并请求指纹)以验证与 SSH 服务器的连接。
  10. 查看新的 SSH 配置。在此屏幕上,您还可以下载或查看公钥,以及查看 SSH 服务器配置的唯一指纹。

如需修改现有的 SSH 服务器配置,请点击所选 SSH 服务器所在行的三点状选项 菜单,然后选择 Server Details (服务器详细信息)。

测试与 SSH 服务器的连接

如需测试与 SSH 服务器的所有数据库连接,请执行以下操作:

  1. 点击所选 SSH 服务器所在行的三点状选项 菜单。
  2. 选择 Test Connections (测试连接)。

Looker 将使用该 SSH 服务器测试所有数据库连接,并在连接测试通过的服务器名称和所有连接旁边显示绿色对勾标记。红色感叹号图标表示连接测试失败。

向 SSH 服务器添加数据库连接

如需使用 SSH 服务器添加新的数据库连接,请执行以下操作:

  1. 点击所选 SSH 服务器所在行的三点状选项 菜单。
  2. 选择 Add Connection (添加连接)。

Looker 会显示 **连接设置** 页面,其中 **SSH 服务器** 字段中列出了 SSH 服务器。

删除 SSH 服务器配置

如需删除 SSH 服务器配置,请执行以下操作:

  1. 点击要删除的 SSH 服务器所在行的三点状选项 菜单。
  2. 选择 Delete Server (删除服务器)。

测试连接

Looker 可让您测试现有连接,以确保它们正常运行。您还可以在添加连接时对其进行测试,如将 Looker 连接到数据库文档页面中所述。

每个连接测试都包含一个状态检查列表,用于告知您 Looker 是否可以成功使用数据库连接。

潜在问题以黄色显示;错误以红色显示。如果连接“通过”测试,则以绿色显示。

使用 OAuth 的数据库连接(例如 SnowflakeGoogle BigQuery)需要用户登录。如果您在测试其中一个连接时未登录 OAuth 用户账号,Looker 将显示一条警告,其中包含 Log In (登录)链接。点击该链接可输入 OAuth 凭据,或允许 Looker 访问您的 OAuth 账号信息。

您可以检查以下内容的状态:

  • 单个连接:点击该连接最右侧的 Test (测试)
  • 所有连接:点击页面顶部的 Test All Connections (测试所有连接)按钮

以下两项检查通常会引起混淆:

  • 可以找到临时架构
  • 可以使用永久性派生表

Looker 正常运行不需要通过这些检查。但是,您需要通过这些检查才能使用永久性派生表,而永久性派生表是非常有价值的建模功能。

添加连接

如需添加新的数据库连接,请按照将 Looker 连接到数据库文档页面中所述的步骤操作。

修改连接

如需修改现有连接,请打开连接 页面,方法是选择管理 菜单,然后在数据库 下选择连接 。点击连接的 Edit (修改)按钮。系统会显示用于创建连接的同一页面(如将 Looker 连接到数据库文档页面中所述),但相关信息已填写完毕。进行任何必要的更改,然后点击 Update Connection (更新连接)。

适用于所有连接的操作

所有连接都提供以下选项,这些选项位于每个连接最右侧的齿轮形下拉菜单中:

选项 说明
SQL Runner 此选项会将您带到 Looker 的 SQL Runner,并已选择正确的连接和架构。
探索 此选项会将您带到连接的基本自动生成的探索选项列表。这些选项不是基于您的自定义数据模型,但它们支持对连接表中的原始数据进行一些快速报告。这通常仅用于在建模之前了解表内容,而不是用于实际数据分析。
删除 如需删除现有连接,请点击连接最右侧的齿轮形下拉菜单,然后选择 Delete (删除)。系统会提示您确认删除,但确认后无法撤消。意外删除连接会停用使用该连接的所有查询。但是,如果您重新创建同名的新连接,功能将会恢复。

适用于部分连接的操作

根据连接方言,连接右侧的齿轮形下拉菜单可能会提供以下其他选项:

选项 说明
显示表 此选项会将您带到 Looker 探索页面,您可以在该页面上根据连接的元数据创建 Looker 探索查询。虽然此选项以架构名称、表名称和列计数(已选择)开头,但您可以像使用任何其他 Looker 探索一样使用它。
显示数据库 此选项会将您带到 Looker 探索页面,您可以在该页面上根据连接的元数据创建 Looker 探索查询。虽然此选项以架构名称、目录名称、表计数和列计数(已选择)开头,但您可以像使用任何其他 Looker 探索一样使用它。
显示进程 此选项会将您带到 Looker 探索页面,您可以在该页面上根据此连接上运行的进程、进程所处的状态、进程的运行时间以及其他信息创建 Looker 探索查询。如果 Looker 运行缓慢或查询根本未运行,这有助于确定原因。
显示 PDT 事件日志 此选项会将您带到 Looker 探索页面,您可以在该页面上根据此连接的派生表活动创建 Looker 探索查询。我们的永久性派生表文档页面更详细地介绍了可用字段。