管理員設定 - 連線

如要存取「Connections」頁面，請開啟「Admin」選單，然後在「Database」下方選擇「Connections」。

查看連線

在「連線」頁面，您可以查看資料庫連線，以及允許網路流量所需的 IP 位址。如果執行個體已啟用建立新資料庫的功能，您也可以新增連線。

「資料庫」分頁

「Databases」(資料庫) 分頁會顯示您定義的資料庫連線基本資訊。如果執行個體已啟用建立新資料庫的功能，這個頁面也會顯示您建立的 Looker 代管連線。您也可以在「資料庫」分頁中，測試這些連線的狀態及編輯設定。

您可以點選「Public IP Addresses」(公開 IP 位址)，查看允許 Looker 執行個體網路流量所需的 IP 位址清單。Looker 的所有網路流量都會來自列出的其中一個 IP 位址，具體取決於 Looker 執行個體的託管區域。禁止來自這些和其他信任 IP 位址以外的流量存取資料庫，是限制資料存取權的一種方式。

如果您具備管理員角色，可以點選 Looker「連線」頁面頂端的「測試連線能力」按鈕，檢查 Looker 是否能透過網路連線至主機名稱和通訊埠。詳情請參閱「Network Reachability 診斷」。

下表說明「Databases」(資料庫) 分頁中的元素：

欄 說明
名稱 您選擇的連線名稱，用於 connection LookML 參數。測試連線時，Looker 會在連線名稱下方顯示狀態檢查清單。
資料庫 使用這個連線時，Looker 會查詢的資料庫名稱。
範圍 連線是否可用於所有專案，或只能用於特定專案。
SSH 伺服器 SSH 伺服器設定的名稱，用於建立連至資料庫的 SSH 通道。只有在 Looker 執行個體啟用「SSH 伺服器」分頁時，才會顯示這個資料欄。
SSL 是否使用 SSL 加密保護 Looker 和資料庫之間傳輸的資料 (除了 SSL 之外，還有其他安全選項)。
類型 資料庫連線的 SQL 方言。
動作 您可以對連線執行的動作包括：測試連線、編輯連線、查看連線的其他資訊、跳至連線探索的連結清單，或刪除連線。如果執行個體已啟用建立新資料庫的功能，您也可以從其他資料來源新增資料至任何 Looker 管理的連線。

「SSH 伺服器」分頁

Looker (Google Cloud Core) 執行個體不提供「SSH Servers」(SSH 伺服器) 分頁。

必須符合下列條件，才能使用「SSH 伺服器」選項：Looker (原始版) 執行個體已部署於 Kubernetes 基礎架構，且您已啟用相關功能，可將 SSH 伺服器設定資訊加入 Looker 執行個體。如果您的 Looker 執行個體未啟用這個選項，但您想啟用，請聯絡 Google Cloud 銷售專員或提出支援要求。

建立 SSH 通道時，Looker 會自動選擇 localhost 通訊埠，您無法自行指定。

如要透過 SSH 連線至 PrestoDB 或 Trino 資料庫，可能需要額外設定資料庫。啟用 SSL 後，PrestoDB 或 Trino 資料庫預設會監聽通訊埠 443。為建立 SSH 通道，Looker 必須將 localhost 通訊埠設為 443，但 Looker 已在使用這個通訊埠。這會導致 SSH 通道設定失敗。如要修正問題，請設定 PrestoDB 或 Trino 資料庫，在啟用 SSL 時監聽通訊埠 443 以外的通訊埠。

「SSH Servers」(SSH 伺服器) 分頁會列出您新增的 SSH 伺服器設定、指出 SSH 伺服器的連線狀態，並列出使用各個 SSH 伺服器的資料庫連線。在「SSH 伺服器」分頁中，您也可以測試與 SSH 伺服器的連線，以及新增或編輯 SSH 伺服器設定。

下表說明「SSH Servers」(SSH 伺服器) 分頁中的元素：

欄 說明
伺服器名稱 您選擇的 SSH 伺服器設定名稱，用於連線至資料庫。
連線 連至 SSH 伺服器的資料庫連線清單。按一下資料庫連線，即可開啟該資料庫連線的「Edit Connection」(編輯連線) 頁面。
三點圖示「選項」選單 您可以對 SSH 伺服器設定執行的動作：測試與 SSH 伺服器的連線、將資料庫連線新增至 SSH 伺服器、編輯 SSH 伺服器設定，或刪除 SSH 伺服器設定。

新增或編輯 SSH 伺服器設定

如要新增 SSH 伺服器設定，請按照下列步驟操作：

  1. 在「SSH 伺服器」分頁中，按一下「Add Server」。
  2. 在右上角的「Unnamed Server」欄位中，輸入 SSH 伺服器設定的名稱。
  3. 按一下「下載金鑰」，即可將公開金鑰下載為文字檔。請務必儲存這個檔案，稍後會用到。
  4. 在「Server Username」欄位，輸入 Looker 連至 SSH 伺服器時使用的使用者名稱。
  5. 在「Server IP Address or Hostname」(伺服器 IP 位址或主機名稱) 欄位中，輸入 SSH 伺服器 IP 位址或主機名稱。
  6. 在「伺服器通訊埠」欄位中，輸入連至 SSH 伺服器時使用的通訊埠編號。
  7. 將下載的公開金鑰新增至 SSH 伺服器的授權金鑰檔案。如需更多資訊和範例，請參閱「使用 SSH 伺服器」說明文件頁面。
  8. 請務必將適當的 Looker IP 位址加入 SSH 伺服器的許可清單，Looker 才能連線至 SSH 伺服器。
  9. 按一下「Test & Request Fingerprint」，驗證與 SSH 伺服器的連線。
  10. 查看新的 SSH 設定。您也可以在這個畫面下載或查看公開金鑰，以及查看 SSH 伺服器設定的專屬指紋。

如要編輯現有的 SSH 伺服器設定，請在所選 SSH 伺服器的資料列中，按一下三點圖示「選項」選單，然後選擇「伺服器詳細資料」。

測試與 SSH 伺服器的連線

如要測試 SSH 伺服器的所有資料庫連線，請按照下列步驟操作：

  1. 在所選 SSH 伺服器所在的資料列中，按一下三點圖示「Options」(選項) 選單。
  2. 選擇「測試連線」。

Looker 會使用該 SSH 伺服器測試所有資料庫連線，並在伺服器名稱和所有通過連線測試的連線旁顯示綠色勾號。紅色驚嘆號圖示表示連線未通過測試。

將資料庫連線新增至 SSH 伺服器

如要使用 SSH 伺服器新增資料庫連線，請按照下列步驟操作：

  1. 在所選 SSH 伺服器所在的資料列中，按一下三點圖示「Options」(選項) 選單。
  2. 選擇「新增連結」。

Looker 會顯示「Connection Settings」頁面，並在「SSH Server」欄位中列出 SSH 伺服器。

刪除 SSH 伺服器設定

如要刪除 SSH 伺服器設定，請按照下列步驟操作：

  1. 在要刪除的 SSH 伺服器資料列中，按一下三點圖示「Options」(選項) 選單。
  2. 選擇「刪除伺服器」。

測試連線

Looker 可讓您測試現有連線，確保連線正常運作。您也可以在新增連線時測試連線，詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。

每項連線測試都包含狀態檢查清單，可讓您瞭解 Looker 是否能成功使用資料庫連線。

潛在問題會以黃色顯示，錯誤則以紅色顯示。如果連線「通過」，會顯示為綠色。

您可以查看下列項目的狀態：

  • 按一下連線最右側的「測試」，即可測試單一連線
  • 按一下頁面頂端的「測試所有連線」按鈕，測試所有連線

有兩項檢查常會造成混淆：

  • 可找到臨時結構定義
  • 可使用永久衍生資料表

Looker 不必通過這些檢查也能運作。不過，您必須通過這些測試，才能使用永久衍生資料表，這是一項非常實用的模型功能。

網路診斷

Looker 提供兩項工具，可協助您判斷連線問題是由網路 (例如防火牆規則或缺少路徑) 還是資料庫 (例如憑證不正確) 造成：

這兩項工具都會在 DNS 中查詢主機名稱，然後嘗試對查詢傳回的每個 IP 位址開啟 TCP 連線。由於這些工具使用 TCP 連線，而非 ICMP ping 要求，因此即使主機封鎖 ping 要求，仍可能顯示為可連線。

連線測試結果中的網路診斷

如果連線測試無法連線至資料庫，Looker 會測試下列端點，並將結果新增至錯誤訊息結尾的 Network Diagnostics: 下方：

  • 針對所有連線，為連線設定的主機和通訊埠。
  • 如果是 Amazon Athena 連線，則為連線 AWS 區域的 AWS Glue 端點 (通訊埠 443)，例如 glue.us-east-1.amazonaws.com。
  • 如果 Cloud SQL 連線的「Host」(主機) 欄位包含執行個體連線名稱 (例如 my-project:us-central1:my-instance)，則為通訊埠 443 上的 sqladmin.googleapis.com 端點。Cloud SQL 連接器會使用這個端點，取得執行個體資訊和憑證。

Looker 最多會測試每個端點的三個 IP 位址，診斷作業最多需要 3 秒。Looker 不會對使用 SSH 通道的連線執行網路診斷。

舉例來說，下列診斷結果顯示 Looker 可以連上 Athena 端點，但連至 AWS Glue 端點時逾時：

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

每個 IP 位址都會顯示下列其中一項結果：

  • success：Looker 已開啟連至 IP 位址和通訊埠的 TCP 連線。如果每個 IP 位址都顯示 success，但測試仍失敗，請檢查連線設定，例如憑證、SSL 設定和資料庫使用者授權。
  • timeout (3000ms)：Looker 在 3 秒內未收到回應。這通常代表防火牆規則、安全性群組或缺少的網路路徑捨棄了流量。
  • failed:，後面接著原因：連線遭拒或無法連上網路。舉例來說，Connection refused 表示沒有任何項目在監聽通訊埠，或防火牆拒絕連線。
  • blocked (sensitive IP)：Looker 未測試 IP 位址，因為該位址位於受限範圍內。

如果 DNS 查詢失敗，端點會顯示 DNS resolution failed:，後面接著原因。檢查主機名稱是否有錯字。如果資料庫使用私人主機名稱，請確認 Looker 可以解析該名稱。

Network Reachability 診斷

如果您具備 Looker 管理員角色，可以在新增連線前測試資料庫主機，或測試連線依附的端點，例如通訊埠 443 上的 sqladmin.googleapis.com。

如要測試 Network Reachability，請按照下列步驟操作：

  1. 在「連線」頁面中，按一下頁面頂端的「測試可連性」按鈕。
  2. 在「Network Reachability Diagnostics」(網路連線能力診斷) 對話方塊的「Hostname or Domain」(主機名稱或網域) 欄位中，輸入主機名稱或 IP 位址。
  3. 在「Port」(通訊埠) 欄位中，輸入要測試的通訊埠。預設值為 443。
  4. 按一下「Test」。

Looker 最多會測試主機名稱的五個 IP 位址，測試時間最多 3 秒。以下是「Network Reachability Diagnostics」對話方塊範例，顯示主機名稱和通訊埠的測試結果：

「Network Reachability Diagnostics」對話方塊，顯示主機名稱和通訊埠的測試結果。

對話方塊會顯示每個 IP 位址的訊息、連線成功時所需的時間 (以毫秒為單位)，以及下列其中一種狀態：

  • Connected：Looker 已開啟與 IP 位址和通訊埠的 TCP 連線。
  • 逾時：Looker 在 3 秒內未收到回應。
  • 失敗：連線遭拒或無法連上網路。訊息會顯示原因。
  • SSRF Blocked：Looker 未測試 IP 位址，因為該位址位於受限範圍。這些限制可防範伺服器端偽造要求 (SSRF)。

如果 Looker 無法解析主機名稱，或通訊埠受到限制，對話方塊會顯示錯誤訊息，而非結果。

受限制的位址和通訊埠

為保護執行個體，Looker 網路診斷不會測試下列範圍內的 IP 位址：

  • 回送、連結本機、多點傳播和其他受限位址範圍，包括中繼資料伺服器位址 169.254.169.254。
  • 私人位址範圍 (10.0.0.0/8、172.16.0.0/12 和 192.168.0.0/16)，位於僅使用公開安全連線的 Looker (Google Cloud Core) 執行個體。

此外，基於安全考量，測試連線能力功能不會測試某些受限的通訊埠，例如通訊埠 22。如果輸入其中一個通訊埠，對話方塊會顯示「Port 22 is restricted from diagnostic probing for security reasons」等訊息。

新增連結

如要新增資料庫連線，請按照「將 Looker 連線至資料庫」說明文件頁面中的步驟操作。

編輯連結

如要編輯現有連線，請選取「管理」選單，然後在「資料庫」下方選擇「連線」，開啟「連線」頁面。按一下連線的「Edit」(編輯) 按鈕。系統會顯示您用來建立連線的頁面 (如「將 Looker 連結至資料庫」說明文件頁面所述)，但相關資訊已填妥。視需要進行變更，然後按一下「Update Connection」。

所有連線可執行的動作

在每個連線最右側的齒輪下拉式選單中，所有連線都會提供下列選項：

選項 說明
SQL Runner 這個選項會將您導向 Looker 的 SQL Runner，並預先選取適當的連線和結構定義。
探索 這個選項會列出系統為連結自動產生的基本探索選項。這些圖表並非根據自訂資料模型產生，但可快速呈現連結資料表中的原始資料。這項功能通常只適用於在建模前瞭解資料表內容，不適合用於實際資料分析。
刪除 如要刪除現有連結，請按一下連結最右側的齒輪下拉式選單，然後選取「刪除」。系統會要求您確認是否要刪除，一旦確認，就無法復原。不小心刪除連線會導致使用該連線的查詢停用，並可能造成開發人員發生 LookML 驗證錯誤。不過，如果以相同名稱重新建立連線，功能就會恢復。

可對部分連結執行的動作

視連線方言而定，連線右側的齒輪下拉式選單可能會提供下列額外選項：

選項 說明
顯示表格 這個選項會將您導向 Looker 探索頁面，您可以根據連線的中繼資料建立 Looker 探索查詢。雖然這個選項一開始會選取結構定義名稱、資料表名稱和資料欄數量，但您可以像操作其他 Looker 探索一樣操作這個選項。
顯示資料庫 這個選項會將您導向 Looker 探索頁面，您可以根據連線的中繼資料建立 Looker 探索查詢。雖然這個選項一開始會選取結構定義名稱、目錄名稱、資料表數量和資料欄數量，但您可以像操作其他 Looker Explore 一樣操作。
顯示程序 這個選項會將您導向 Looker 探索頁面，您可以根據這個連線上執行的程序、程序狀態、執行時間和其他資訊，建立 Looker 探索查詢。如果 Looker 執行速度緩慢，或查詢完全無法執行，這項功能有助於判斷原因。
顯示 PDT 事件記錄檔 這個選項會將您導向 Looker 探索頁面，您可以根據這個連線的衍生資料表活動，建立 Looker 探索查詢。如要進一步瞭解可用欄位，請參閱永久衍生資料表說明文件頁面。

安全刪除資料庫連線

如果刪除 LookML 模型仍參照的資料庫連線，會導致驗證錯誤，開發人員可能無法修訂或合併分支版本。如要安全刪除連線，請按照下列步驟操作：

  1. 找出依附元件：在開發模式中，使用專案搜尋功能尋找 connection: CONNECTION_NAME，找出所有參照該連線的 LookML 模型檔案。
  2. 移除依附元件：更新這些模型檔案中的 connection 參數，指向有效的連線，或刪除不再需要的依附模型。
  3. 驗證內容：執行 Content Validator，找出並修正任何依賴使用該連線模型的 Look 或資訊主頁。
  4. 部署變更：修訂這些 LookML 變更，並部署至正式環境分支版本。
  5. 刪除連線：從正式版分支版本中移除所有參照後，依序前往「管理」 >「資料庫」 >「連線」，然後刪除連線。