连接到 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 Studio 首页的左上角，点击 Create（创建），然后选择 Data Source（数据源）。
  3. 选择 PostgreSQL 连接器。
  4. 使用以下任一连接选项配置对数据库的访问权限（见下文）。
  5. 点击身份验证。您会看到该数据库中的表格列表。
  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（安全套接字层）。如需启用安全连接，请选中 Enable SSL（启用 SSL），然后提供您的 SSL 配置文件。

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

启用客户端身份验证

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

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

注意：Looker Studio 期望使用 PKCS-8 客户端密钥格式。

详细了解 PostgreSQL 安全连接。

自定义查询

选择 CUSTOM QUERY 选项以提供 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 中的查询可能会在三到五分钟后超时。如果您的自定义查询超时，请尝试通过以下方法解决此问题：

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

备注

支持的数据类型

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

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

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

详细了解 PostgreSQL 数据类型。

防火墙和数据库访问

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

IP 地址

  • 142.251.74.0/23

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

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

  • Looker Studio 不支持与 Cloud SQL 上的 PostgreSQL 建立专用 IP 连接。

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

PostgreSQL 连接器的限制

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

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

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

问题排查

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

创建数据源