管理设置 - 连接

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

查看连接

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

“数据库”标签页

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

您可以点击公共 IP 地址，查看允许来自 Looker 实例的网络流量所需的 IP 地址列表。来自 Looker 的所有网络流量都将来自列出的某个 IP 地址，具体取决于托管 Looker 实例的区域。禁止来自这些 IP 地址和其他可信 IP 地址的数据库流量是限制数据访问的一种简单方法。

下表介绍了 Databases 标签页中的元素：

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

SSH 服务器标签页

如果实例部署在 Kubernetes 基础架构上，并且启用了向 SSH 服务器添加 SSH 服务器配置信息的功能，则可以使用 SSH 服务器选项。如果您的 Looker 实例未启用此选项，但您希望启用它，请与您的 Looker 客户经理联系，或在 Looker 的帮助中心打开支持请求。

创建 SSH 隧道时，Looker 会自动选择 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 服务器标签页中，点击添加服务器
  2. 在右上角的未命名服务器字段中，输入 SSH 服务器配置的名称。
  3. 点击下载密钥，将公钥下载到文本文件。请务必保存此文件以备后用。
  4. 在服务器用户名字段中，输入 Looker 用于连接到 SSH 服务器的用户名。
  5. 在服务器 IP 地址或主机名字段中，输入 SSH 服务器 IP 地址或主机名。
  6. 在服务器端口字段中，输入用于连接到 SSH 服务器的端口号。
  7. 将下载的公钥添加到 SSH 服务器上已获授权的密钥文件中。如需了解详情和查看示例，请参阅使用 SSH 服务器文档页面。
  8. 确保将适当的 Looker IP 地址添加到 SSH 服务器上的许可名单中，以便 Looker 能够连接到 SSH 服务器。
  9. 点击测试与请求指纹以验证您与 SSH 服务器的连接。
  10. 查看新的 SSH 配置。在此屏幕上，您还可以下载或查看公钥以及查看 SSH 服务器配置的唯一指纹。

要修改现有 SSH 服务器配置，请点击目标 SSH 服务器所在行中的三点状选项菜单，然后选择服务器详细信息。

测试与 SSH 服务器的连接

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

  1. 点击所需 SSH 服务器所在行中的三点状菜单。
  2. 选择测试连接。

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

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

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

  1. 点击所需 SSH 服务器所在行中的三点状菜单。
  2. 选择 Add Connection。

Looker 会显示连接设置页面，其中的 SSH 服务器会列在 SSH 服务器字段中。

删除 SSH 服务器配置

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

  1. 点击 SSH 服务器所在行中的三点状菜单以将其删除。
  2. 选择删除服务器。

测试连接

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

每个连接测试都包含一系列状态检查，用于告知您 Looker 是否能够成功使用数据库连接。例如：

潜在问题以黄色显示；错误以红色显示。如果连接“通过”，则会显示为绿色。

使用 OAuth 的数据库连接（例如 Snowflake 和 Google BigQuery）要求用户登录。如果您在测试上述任一连接时未登录 OAuth 用户帐号，Looker 会显示包含登录链接的警告。点击该链接以输入您的 OAuth 凭据或允许 Looker 访问您的 OAuth 帐号信息。

您可以查看以下状态：

  • 单个连接（通过点击该连接最右侧的测试）
  • 点击页面顶部的 Test All Connections 按钮，测试所有连接

常见的混淆原因有以下两种：

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

Looker 无需通过这些检查即可正常运行。不过，您确实需要它们传递才能使用永久性派生表，这是一项非常重要的建模功能。

添加连接

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

修改连接

要修改现有连接，请点击每个连接最右侧的修改按钮。系统会显示您用于创建连接的页面（如将 Looker 连接到数据库文档页面所述），但其中已填写了相关信息。根据需要进行更改，然后点击 Update Connection。

适用于所有连接的操作

所有连接都提供在每个连接最右侧的齿轮下拉菜单中：

选项 说明
SQL Runner 此选项可让您转到 Looker 的 SQL Runner，并且已选择正确的连接和架构。
探索 此选项会显示系统为您生成的基本“探索”选项列表。它们并非基于您的自定义数据模型，但可让您对连接表中的原始数据进行一些快速报告。这通常仅适用于建模之前了解表格内容，而非实际数据分析。
删除 要删除现有连接，请点击连接最右侧的齿轮图标，然后选择删除。您可以确认删除，但一旦删除便无法撤消。如果不小心删除了某个连接，系统将停用使用该连接的所有查询。但是，如果您重新创建同名的新连接，则功能将恢复。

可对某些连接执行的操作

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

选项 说明
显示表格 此选项会转到 Looker 探索页面，您可在该页面根据连接的元数据创建 Looker 报告。虽然此选项从选定的架构名称、表名称和列数开始，但您可以像处理任何其他 Looker 报告一样操纵它。
显示数据库 此选项会转到 Looker 探索页面，您可在该页面根据连接的元数据创建 Looker 报告。虽然此选项从选定的架构名称、清单名称、表数和列数开始，但您可以像处理任何其他 Looker 报告一样操作它。
显示进程 此选项可让您转到 Looker 探索页面，在该页面上，您可以根据基于此连接的进程、这些进程的运行状态、运行时长以及其他信息创建 Looker 报告。这有助于了解 Looker 运行缓慢或查询完全没有运行的原因。
显示 PDT 事件日志 此选项会转到 Looker 探索页面，您可在该页面根据派生的此关联表活动创建 Looker 报告。我们的永久性派生表文档页面对可用字段进行了更详细的说明。