连接到 PostgreSQL

PostgreSQL 是一款开源关系型数据库管理系统 (RDBMS)，由全球志愿者团队开发。

借助 PostgreSQL 连接器，您可以在 Looker Studio 中访问基于 PostgreSQL 的数据库中的数据。

如何连接到 PostgreSQL

该连接器使用 PostgreSQL JDBC 驱动程序将 Looker Studio 数据源关联到单个 PostgreSQL 数据库表。

支持的版本

我们已在以下 PostgreSQL 版本上测试过 Looker Studio：

  • 9.6
  • 10
  • 11
  • 12
  • 13
  • 14

如果您在使用受支持的版本时遇到问题，请在 Looker Studio 帮助社区中告知我们。您可以在问题跟踪器中添加功能请求并为其投票。

如需连接

  1. 登录 Looker 数据洞察。
  2. 在 Looker 数据洞察首页的左上角，点击 创建，然后选择数据源。
  3. 选择 PostgreSQL 连接器。
  4. 使用其中一种连接选项配置对数据库的访问权限。
  5. 点击AUTHENTICATE。您将看到相应数据库中的表列表。
  6. 选择一个表格。
  7. 点击连接。

现在，您可以将表格中的所有列作为报告中的字段进行访问。

连接选项

基本

如需使用主机名或 IP 地址进行连接，您需要提供以下信息：

  • 主机名或 IP 地址
  • 端口（可选）
  • 数据库
  • 用户名
  • 密码

JDBC 网址

如需使用 JDBC 网址进行连接，请提供以下连接信息：

  • JDBC 网址
    • 示例 jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
  • 密码

如果您使用 JDBC 主机名选项，可以确保该主机名可通过 Whois 等公共 DNS 查找工具访问。

如需使用 IPv6 字面地址进行连接，请将该地址放在方括号中。例如：jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

启用 SSL

Looker Studio 支持使用 TLS（传输层安全协议）与服务器建立安全（加密）连接。TLS 也称为 SSL（安全套接字层）。如需启用安全连接，请勾选启用 SSL，然后提供 SSL 配置文件。

Looker Studio 不需要此设置，但您的数据库配置可能需要此设置。如需了解详情，请咨询您的数据库供应商。

启用客户端身份验证

选中此框后，您可以上传客户端私钥和客户端证书（如果需要访问数据库）。

Looker Studio 不需要此设置，但您的数据库配置可能需要此设置。如需了解详情，请咨询您的数据库供应商。

注意：Looker Studio 需要 PKCS-8 客户端密钥格式。

详细了解 PostgreSQL 安全连接。

自定义查询

选择自定义查询选项，以提供 SQL 查询，而不是连接到单个表。Looker Studio 会将此自定义 SQL 用作所生成的每个数据库查询的内部 select 语句。

例如，以下代码将无法正常运行，因为它包含多个 SQL 语句：


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

Looker Studio 中的查询可能会在 3 到 5 分钟后超时。如果自定义查询超时，请尝试以下方法来解决问题：

  • 简化查询，以便更快地运行。
  • 在数据库中运行查询，并将结果存储在单独的表中。连接数据源中的新表。

备注

支持的数据类型

PostgreSQL 连接器支持以下数据类型：

  • 数字
  • 基于字符，
  • 布尔值
  • 日期/时间（不包括间隔）

如果 Looker Studio 遇到不受支持类型的列，则不会为该列创建字段。

详细了解 PostgreSQL 数据类型。

防火墙和数据库访问权限

如需允许 Looker Studio 连接到防火墙后面的数据库并查询这些数据库，您需要开放对以下某个 IP 地址的访问权限。您可能还需要将数据库配置为接受来自这些地址的流量。如需了解相关说明，请参阅您使用的特定数据库的文档。

IP 地址

  • 142.251.74.0/23

  • 2001:4860:4807::/48（可选，适用于支持 IPv6 的平台）

使用 PostgreSQL 连接器时，请注意以下网络限制：

  • Looker Studio 不支持通过专用 IP 连接到 Cloud SQL 上的 PostgreSQL。

  • PostgreSQL 连接器在连接到 Cloud SQL PostgreSQL 实例时不会使用 Cloud SQL 代理。如果您要连接到 Cloud SQL PostgreSQL 实例，则需要将列出的 IP 添加到授权网络列表中。请参阅 Cloud SQL 文档。

PostgreSQL 连接器的限制

  • 不支持通过 SSL 连接到 AlloyDB 数据源，因为 AlloyDB 不支持导出证书授权机构 (CA) 证书。

  • 不支持选择 public 架构之外的表。不过，您可以选择自定义查询选项，编写包含任何架构中的表的查询。

  • 使用此连接器时，每个查询最多可查询 15 万行。如果超出此限制，系统会截断数据。

  • 列标题（字段名称）只能使用 ASCII 字符。不支持非 ASCII 字符。

问题排查

如需查看常见错误消息的列表以及解决这些错误的步骤，请参阅 Looker Studio 问题排查指南。

创建数据源