連線至 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 連接器。
  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

啟用安全資料傳輸層

Looker Studio 支援使用 TLS (傳輸層安全標準) 通訊協定，與伺服器建立安全 (加密) 連線。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 中的查詢可能會在 3 到 5 分鐘後逾時。如果自訂查詢逾時，請嘗試下列方法解決問題：

  • 簡化查詢，加快執行速度。
  • 在資料庫中執行查詢，並將結果儲存在另一個資料表中。在資料來源中連結新表格。

附註

支援的資料類型

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 Proxy。如果您要連線至 Cloud SQL PostgreSQL 執行個體，請將清單中的 IP 新增至已授權網路清單。請參閱 Cloud SQL 說明文件。

PostgreSQL 連接器的限制

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

  • 使用這個連接器時，每個查詢最多可查詢 150 K 列。如果超過這個限制，資料就會遭到截斷。

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

疑難排解

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

建立資料來源