連線至 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 社群回報。您也可以在 Issue Tracker 中新增及投票給功能要求。

如要連線，請按照下列步驟操作：

  1. 登入 Looker Studio。
  2. 在 Looker Studio 首頁左上方，點選「 建立」，然後選取「資料來源」。
  3. 選取「PostgreSQL」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 (傳輸層安全標準) 通訊協定，與伺服器建立安全 (加密) 連線。傳輸層安全標準也稱為安全資料傳輸層 (SSL)。如要啟用安全連線，請勾選「Enable SSL」(啟用 SSL)，然後提供 SSL 設定檔。

Looker Studio 不會要求您進行這項設定，但資料庫設定可能需要。詳情請洽詢資料庫供應商。

啟用用戶端驗證

勾選這個方塊後，您就能上傳用戶端私密金鑰和用戶端憑證，以便存取資料庫 (如有需要)。

Looker Studio 不會要求您進行這項設定，但資料庫設定可能需要。詳情請洽詢資料庫供應商。

注意：Looker Studio 預期採用 PKCS-8 用戶端金鑰格式。

進一步瞭解 PostgreSQL 安全連線。

自訂查詢

選取「自訂查詢」選項，提供 SQL 查詢，而非連線至單一資料表。對於每個產生的資料庫查詢，Looker Studio 會使用這個自訂 SQL 做為內層選取陳述式。

舉例來說，下列程式碼無法運作，因為其中包含多個 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 不支援透過私人 IP 連線至 Cloud SQL 上的 PostgreSQL。

  • 連線至 Cloud SQL PostgreSQL 執行個體時，PostgreSQL 連接器不會使用 Cloud SQL Proxy。如果連線至 Cloud SQL PostgreSQL 執行個體，您需要將列出的 IP 位址新增至授權網路清單。請參閱 Cloud SQL 說明文件。

PostgreSQL 連接器的限制

  • AlloyDB 不支援匯出憑證授權單位 (CA) 憑證，因此無法透過 SSL 連線至 AlloyDB 資料來源。

  • 系統不支援選取 public 結構定義以外的資料表。不過，您可以選取「自訂查詢」選項，編寫包含任何結構定義中資料表的查詢。

  • 使用這個連結器時，每個查詢最多可查詢 15 萬列。如果超過這個限制，系統會截斷資料。

  • 欄標題 (欄位名稱) 只能使用 ASCII 字元。系統不支援非 ASCII 字元。

疑難排解

如需常見錯誤訊息清單和解決步驟，請參閱 Looker Studio 疑難排解指南。

建立資料來源