將 Looker 連線至資料庫

保護並設定資料庫後，即可將資料庫連線至 Looker。

您可以在 Looker 的「將資料庫連線至 Looker」頁面建立資料庫連線。您可以透過下列兩種方式開啟「將資料庫連線至 Looker」頁面：

  • 按一下「主選單」圖示 ，依序選取「管理」和「連線」(位於「管理」面板的「資料庫」部分)。在「Connections」(連線) 頁面中，按一下「Add Connection」(新增連線) 按鈕。
  • 按一下主導覽選單中的「建立」按鈕，然後選取「連線」選單項目。

本頁面說明 Looker 在「將資料庫連線至 Looker」頁面顯示的常見欄位。頁面顯示的確切欄位取決於方言設定。

如要瞭解如何將使用者屬性套用至連線設定，請參閱「使用者屬性」說明文件頁面的「連線」一節。

資料庫連線設定包含下列四個部分：

一般設定

名稱

您要使用的連線名稱。您必須在 LookML 模型的 connection 參數中使用這個資料庫連線名稱。資料庫連線名稱也是 Looker「管理」頁面中「連線」部分用來識別連線的方式。請勿使用任何資料夾名稱。這個值不需要與資料庫中的任何內容相符；Name 是在 Looker UI 中識別這個連線的標籤。

SQL 方言

與連線相符的 SQL 方言。請務必選擇正確的值，這樣系統才會顯示適用的連線選項，而 Looker 也才能正確地將 LookML 翻譯為 SQL。

使用最新版驅動程式

根據預設，Looker 一律會使用資料庫方言的最新版本 JDBC 驅動程式，連線至資料庫。如果所選資料庫方言有多個 Looker 支援的 JDBC 驅動程式版本，您可以停用「使用最新驅動程式版本」切換鈕，為連線選取較早的 JDBC 驅動程式版本。如要選取舊版 JDBC 驅動程式，請停用連線的「使用最新驅動程式版本」切換鈕，然後從「驅動程式版本」下拉式選單中選取驅動程式版本。

如果選取較舊的 JDBC 驅動程式版本，Looker 會繼續使用該版本，直到不再支援為止。

在下列兩種情況下，Looker 會停止支援驅動程式版本：

  • Looker 支援服務已移除該驅動程式版本。在這種情況下，連線會使用 Looker 支援該方言的最早驅動程式版本。
  • Looker 復原後，驅動程式版本尚未建立。在這種情況下，連線會使用復原版本支援的最新驅動程式版本。

如果 Looker 不再支援所選驅動程式版本，就會在「編輯資料庫連線」頁面的「驅動程式版本」欄位下方顯示快訊，通知您所選驅動程式版本已不受支援。快訊也會告知 Looker 用於連線的驅動程式版本。如要清除這則快訊，請從「驅動程式版本」下拉式選單中選取支援的 JDBC 驅動程式版本，或啟用「使用最新驅動程式版本」切換鈕，使用最新驅動程式版本。

專案範圍

選取連線是否能用於所有專案，或只能用於單一專案：

  • 「All Projects」：執行個體上的所有 LookML 專案都能存取連線，因此可以在專案模型檔案的 connection 參數中指定連線名稱。
  • Selected Project：執行個體上只有一個 LookML 專案可以存取連線。選取這個選項後，「連線」畫面會顯示執行個體專案的下拉式選單。選取可存取這項連結的專案。

搭配下列權限使用這個選項，即可委派連線管理和模型設定：

狀態詳細資料

展開「狀態詳細資料」部分，測試連線設定。

資料庫設定

啟用 SSH 伺服器

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

SSH 伺服器

您無法指定 localhost 通訊埠，SSH 伺服器會自動為您選擇。如要建立 SSH 連線，且必須指定 localhost 通訊埠，請提出支援要求。

從下拉式選單中選取 SSH 伺服器設定。必須有 SSH 伺服器，才能選取或建立適當的 SSH 通道。您可以在「連線」面板的「SSH 伺服器」分頁中建立新的 SSH 伺服器。

SSH 通道

從下拉式選單中選取現有的 SSH 通道，或按一下「建立新通道」圖示，使用主機名稱和通訊埠或本機通訊埠建立新的 SSH 通道。

主機名稱

Looker 連線至資料庫主機時應使用的資料庫主機名稱。

如果您與 Looker 分析師合作，設定了連至資料庫的 SSH 通道，請在「Host」(主機) 欄位中輸入 "localhost"。如果您將使用者屬性套用至「主機」欄位，則該使用者屬性的使用者存取層級不得設為「可編輯」。如果您設定 SSH 通道來連線至資料庫，就無法將使用者屬性套用至「Remote Host:Port」欄位。

通訊埠

Looker 連線至資料庫主機時應使用的資料庫通訊埠。

如果您與 Looker 分析師合作，設定了連至資料庫的 SSH 通道，請在「Port」(通訊埠) 欄位中，輸入 Looker 分析師提供的通訊埠編號，該編號會重新導向至您的資料庫。

本機通訊埠

Looker 預設會自動為 SSH 通道選取可用的本機通訊埠。如要手動選取本機通訊埠，請選取「手動輸入」，然後在「Custom Local Port」欄位輸入通訊埠編號。請確保執行個體可以使用本機通訊埠。

計費專案 ID (僅限 Google BigQuery)

報帳專案 ID 是 Google Cloud 專案 ID。詳情請參閱 Google BigQuery 說明文件頁面。

儲存空間專案 ID (僅限 Google BigQuery)

儲存空間專案 ID 的名稱 (如果您將運算和儲存空間分開在不同專案中)。如果 LookML 開發人員在 LookML 檢視表、探索或彙整的 sql_table_name 參數中，指定完整範圍的資料表名稱，您就能查詢不同 Google Cloud 專案中的資料集。詳情請參閱 Google BigQuery 說明文件頁面。

主要資料集 (僅限 Google BigQuery)

Looker 查詢資料庫時，應預設使用的資料集名稱。詳情請參閱 Google BigQuery 說明文件頁面。

資料庫名稱

主機中資料庫的名稱。舉例來說，您可能有一個主機名稱為 my-instance.us-east-1.redshift.amazonaws.com，其中有一個名為 sales_info 的資料庫。請在這個欄位輸入 sales_info。如果同一主機上有多個資料庫，您可能需要建立多個連線才能使用這些資料庫 (MySQL 除外，其中「資料庫」一詞的含義與大多數 SQL 方言略有不同)。

預設結構定義

未指定結構定義時，Looker 會使用預設結構定義。這項設定適用於使用 SQL Runner、產生 LookML 專案，以及查詢資料表時。

驗證設定

如果是 Google BigQuery、Snowflake、Trino 和 Databricks 連線，請選取 Looker 存取資料庫時要使用的驗證類型：

  • 如果是 Google BigQuery 連線，您可以選擇設定 OAuth 或服務帳戶，讓 Looker 用於向資料庫驗證。
  • 如果是 Snowflake、Trino 和 Databricks 連線，您可以選擇設定 OAuth 或資料庫帳戶，讓 Looker 用於驗證資料庫。

使用 OAuth 時，使用者必須登入資料庫，才能從 Looker 發出查詢。使用者在 Looker 中啟動 OAuth 授權流程時，Looker 會顯示「Authorize OAuth Connection」(授權 OAuth 連線) 對話方塊，通知使用者授權連線後，Looker 執行個體就能代表他們存取資料，且管理員或開發人員等具備權限的 Looker 使用者，可能可以查看他們的資料。使用者必須選取「Authorize」，才能繼續前往 OAuth 登入頁面。同意聲明資訊會儲存在瀏覽器的本機儲存空間中；如果清除本機儲存空間，下次使用者啟動 OAuth 授權流程時，對話方塊會再次顯示。如要進一步瞭解如何為 Looker 連線設定 OAuth，請參閱 Google BigQuery、Snowflake、Trino 或 Databricks 連線程序。

使用者名稱

Looker 可用來連線至資料庫的使用者帳戶名稱。

密碼

資料庫使用者帳戶的密碼，Looker 可用來連線至資料庫。

展開「狀態詳細資料」部分，測試連線設定。

選用設定

每個節點的連線數量上限

您可以在這裡設定 Looker 與資料庫建立的連線數量上限。在大多數情況下，您需要設定 Looker 可對資料庫執行的並行查詢數量。Looker 也會保留最多三個連線，用於終止查詢。如果連線集區非常小，Looker 保留的連線數量就會減少。

請謹慎設定這個值。如果值過高，資料庫可能會無法負荷。如果值太低，查詢就必須共用少量的連線。這會造成使用者查詢速度緩慢，因為必須等到先前的查詢傳回結果，才能接著處理後續查詢。

預設值 (因 SQL 方言而異) 通常是合理的起點。多數資料庫也有自己的設定，可指定接受的連線數量上限。如果資料庫設定限制連線數量，請確認「每個節點的連線數量上限」值等於或低於資料庫限制。

連線集區逾時時間

如果使用者要求的連線數量超過「每個節點的連線數量上限」設定，系統會等待其他要求完成後，再執行這些要求。您可以在這裡設定要求等待時間上限。預設值為 120 秒。

請謹慎設定這個值。如果設定過低，使用者可能會發現查詢遭到取消，因為其他使用者的查詢沒有足夠的時間完成。如果設定的值過高，可能會累積大量查詢，導致使用者必須等待很長的時間。預設值通常是合理的起點。

這個連線的並行查詢數量上限

這個選用值會限制 Looker 同時向這個資料庫連線提交的並行查詢數量。如果需要同一個連線的並行要求超過數量上限，Looker 會在內部將這類要求排入佇列並依序處理。設定這個值會覆寫現有的 每個節點的連線數量上限 值。

這個連線的個別使用者並行查詢數量上限

這個值為選填，會限制 Looker 同時向這個資料庫連線提交的個別使用者並行查詢數量。如果需要同一個連線的並行要求超過數量上限，Looker 會在內部將這類要求排入佇列並依序處理。預設值由資料庫方言設定，通常為 25。

「這個連線的個別使用者並行查詢數量上限」設定，會套用至設定這項設定的個別連線。這項設定會覆寫連線的執行個體層級 per-user-query-limit 啟動選項。

「這個連線的個別使用者並行查詢數量上限」設定會覆寫 per-user-query-limit 設定，因此請務必瞭解這些設定的差異：

  • 「這個連線的個別使用者並行查詢數量上限」設定適用於個別使用者和個別連線，但「不」適用於個別節點。「這個連線的個別使用者並行查詢數量上限」設定，適用於整個 Looker 執行個體中，使用者對該連線的並行查詢。如果是叢集 Looker 執行個體，您為「這個連線的個別使用者並行查詢數量上限」設定的值，會除以 Looker 叢集中的節點數量，決定使用者可在每個節點執行的並行查詢數量。

    舉例來說，如果您有 5 個節點的叢集，並將這個值設為 15，則每個節點會允許每位使用者對這項連線執行 3 個並行查詢 (15 / 5 = 3)，所有節點總共可執行 15 個查詢。

  • per-user-query-limit 啟動選項會套用至每位使用者、每個連線和每個節點。

    舉例來說，假設您有一個 5 節點叢集，per-user-query-limit 為 15，則每個節點會允許每位使用者在這個連線執行 15 項並行查詢，所有節點總共可執行 75 項查詢 (15 * 5 = 75)。

因此，對於叢集 Looker 執行個體，如果為「這個連線的個別使用者並行查詢數量上限」設定值，可能會影響使用者的查詢效能。

其他 JDBC 參數

Java Database Connectivity (JDBC) 驅動程式是一種軟體元件，可管理 Looker 與資料庫之間的連線。

當資料庫的 JDBC 驅動程式啟動從 Looker 到資料庫的連線時，驅動程式會建立一組參數的網址，例如主機、通訊埠、資料庫或資料倉儲，以及其他方言專屬參數。設定資料庫連線時，您可以指定 Looker 與資料庫驅動程式通訊時應包含的其他 JDBC 參數。視方言和特定參數而定，JDBC 參數可能會由 JDBC 驅動程式處理，或傳遞至資料庫。

為確保連線安全，Looker 設有許可清單，列出各資料庫方言支援的 JDBC 參數。

  • 如果嘗試使用不支援的 JDBC 參數建立或更新連線，Looker 會顯示錯誤訊息，指出不允許的參數。
  • 如果現有連線含有不支援的 JDBC 參數，Looker 會移除這些參數，然後連線至資料庫。

如要查看方言支援的 JDBC 參數清單，請參閱方言資料庫設定操作說明頁面的「支援的 JDBC 參數」一節。

如要在 JDBC 參數中參照使用者屬性，請使用 Liquid 範本語法：_user_attributes['name_of_attribute']。請參閱以下範例：

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

維護排程

Looker 再生器會檢查以 sql_trigger_value 為依據的資料群組和永久資料表 (包括匯總表格和永久衍生資料表)。根據這些檢查結果，Looker 再生器會從資料庫的臨時結構定義中，重建或捨棄永久資料表。

「維護排程」值會設定 Looker 重新產生器的 cron 間隔。Looker 再生器會啟動再生器週期，以 cron 的間隔檢查資料群組和永久資料表。如果 Looker 重新產生器週期在下一個 cron 間隔仍在進行中，Looker 重新產生器會完成進行中的重新產生器週期，然後等待後續的 cron 間隔，再開始下一個重新產生器週期。

「Maintenance Schedule」(維護時間表) 設定接受 cron 運算式。預設值為 */5 * * * *，表示如果上一個重新產生器週期已完成，Looker 重新產生器週期會每隔五分鐘啟動一次。如果上一個重新產生器週期尚未完成，Looker 重新產生器會在週期完成後的下一個五分鐘間隔啟動。

預設間隔為五分鐘，這也是維護排程支援的最短間隔。Looker 不會強制規定維護排程的最長間隔，也就是說，您可以延長 Looker 重新產生器週期之間的間隔，只要能以 cron 運算式指定即可。請注意，Looker 重新產生週期越長，快取和永久資料表中的資料更新頻率就越低。

Looker 重新產生器在一個週期內完成所有檢查和 PDT 重建作業後，會等待下一個 cron 間隔，再啟動下一個週期。如果 PDT 建構作業耗時較長，Looker 重新產生器週期之間的時間間隔可能會較長。其他因素可能會影響重建資料表所需的時間，詳情請參閱「Looker 中的衍生資料表」頁面的「導入永久資料表的重要考量事項」一節。

如果資料庫並非全天候運作，建議您將檢查時間限制在資料庫運作時段。以下是其他 cron 運算式：

cron 運算式 定義
*/5 8-17 * * MON-FRI 週一至週五的營業時間內，每 5 分鐘檢查一次資料群組和 PDT
*/5 8-17 * * * 每天營業時間內，每 5 分鐘檢查一次資料群組和 PDT
0 8-17 * * MON-FRI 在週一至週五的營業時間內，每小時檢查資料群組和 PDT
1 3 * * * 每天凌晨 3:01 檢查資料群組和 PDT

建立 cron 運算式時，請注意下列事項：

  • Looker 使用 parse-cron v0.1.3，不支援 cron 運算式中的 ?。
  • cron 運算式會使用 Looker 應用程式時區，判斷何時執行檢查。
  • 如果系統未建構 PDT，請將 cron 字串重設回預設值 */5 * * * *。

以下資源可協助您建立 cron 字串：

停用連線

如果資料庫發生下游問題，Looker 管理員可以選取「停用連線」選項，暫時關閉連線，不必手動終止查詢，或讓查詢留在查詢佇列中。

啟用「停用連線」切換鈕後，Looker 不會將任何查詢傳送至資料庫，而是會向使用者傳回連線已停用的錯誤訊息。

資料庫問題解決後，Looker 管理員可以關閉「停用連線」切換鈕。重新啟用連結後，所有查詢都會恢復正常運作。

SSL

選擇是否要使用 SSL 加密，保護在 Looker 和資料庫之間傳輸的資料。SSL 只是保護資料的其中一種選項，如要瞭解其他安全選項，請參閱「啟用安全的資料庫存取權」說明文件頁面。

驗證 SSL

選擇是否要驗證連線使用的 SSL 憑證。如果需要驗證，簽署 SSL 憑證的 SSL 憑證授權單位 (CA) 必須來自用戶端的信任來源清單。如果 CA 不是可信任的來源，系統就不會建立資料庫連線。

如果未勾選這個方塊，連線仍會使用 SSL 加密，但不需要驗證 SSL 連線，因此即使 CA 不在用戶端的信任來源清單中，仍可建立連線。

預先快取資料表和資料欄

在 SQL Runner 中，只要選取連線和結構定義，系統就會預先載入所有資料表資訊。這樣一來，只要點選資料表名稱，SQL Runner 就能快速顯示資料表資料欄。不過，如果連線和結構定義含有許多資料表或非常大的資料表，您可能不希望 SQL Runner 預先載入所有資訊。

如果希望 SQL Runner 僅在選取資料表時載入資料表資訊，可以取消選取「預先快取資料表和資料欄」選項，停用 SQL Runner 預先載入連線的功能。

擷取及快取結構定義

對於某些 SQL 撰寫功能 (例如匯總感知)，Looker 會使用資料庫的資訊結構定義，最佳化 SQL 撰寫。如果未快取資訊結構定義，Looker 有時可能必須封鎖對資料庫的 SQL 寫入作業，才能擷取資訊結構定義。如果是 Denodo 方言或使用 Hadoop 分散式檔案系統 (HDFS) 的方言，擷取資訊結構定義可能需要較長時間，進而大幅影響 Looker 查詢效能。如果您知道資訊結構定義速度緩慢，可以停用連線的「Fetch and cache schema」(擷取和快取結構定義) 選項。停用這項功能會導致 Looker 無法針對特定功能最佳化 SQL，因此除非您知道連線的資訊結構定義特別慢，否則應啟用「擷取和快取結構定義」選項。

預估費用

「費用預估」切換鈕僅適用於下列資料庫連線：

「Cost Estimate」(費用預估) 切換鈕可啟用連線的下列功能：

詳情請參閱「在 Looker 中探索資料」說明文件頁面。

保有一組資料庫連線

如果方言支援資料庫連線集區，Looker 就能透過 JDBC 驅動程式使用連線集區。資料庫連線集區可加快查詢效能；新查詢不需要建立新的資料庫連線，而是可以使用連線集區中的現有連線。連線集區功能可確保連線在查詢執行後清除，並在查詢執行結束後可供重複使用。詳情請參閱資料庫連線集區說明文件頁面。

永久衍生資料表 (PDT) 設定

啟用 PDT 後，系統會顯示下列設定。

啟用 PDT

開啟「啟用 PDT」切換鈕，啟用永久衍生資料表。啟用 PDT 後，「連線」視窗會顯示其他 PDT 欄位和「PDT 覆寫」部分。只有在資料庫方言支援使用 PDT 時，Looker 才會顯示「啟用 PDT」切換鈕。

關於 PDT，請注意下列事項：

  • 使用 OAuth 的 Snowflake 連線不支援 PDT。
  • 停用連線的 PDT，並不會停用與 PDT 相關聯的資料群組。即使停用 PDT，現有資料群組仍會對資料庫執行 sql_trigger 查詢。如要停止資料群組對資料庫執行 sql_trigger 查詢，您必須從 LookML 專案中刪除 datagroup 參數或將其註解排除，或者更新連線的「維護排程」設定，讓 Looker 很少或從不檢查 PDT 和資料群組。
  • 如果是 Snowflake 連線，Looker 會將 AUTOCOMMIT 參數的值設為 TRUE (Snowflake 的預設值)。Looker 執行 SQL 指令來維護 PDT 註冊系統時，必須使用 AUTOCOMMIT。

暫存資料庫

雖然這會標示為「暫存資料庫」，但您必須根據自己的 SQL 方言，輸入適用的資料庫名稱或結構定義名稱，以便 Looker 用來建立永久衍生資料表。請預先設定這個資料庫或結構定義，並授予適當的寫入權限。在「資料庫設定操作說明」說明文件頁面，選取資料庫方言，即可查看該方言的操作說明。

每個連線都必須有專屬的暫存資料庫或結構定義；暫存資料庫或結構定義無法在不同的連線之間共用。

PDT 建構工具連線數量上限

「PDT 建構工具連線數量上限」設定可讓您指定 Looker 再生器可透過資料庫連線啟動多少並行的資料表建構作業。「PDT 建構工具連線數量上限」設定僅適用於 Looker 再生器啟動重建作業的資料表類型：

  • 採用觸發條件的永久資料表 (使用 datagroup_trigger 或 sql_trigger_value 永久性策略的永久衍生資料表和匯總表格)。
  • 使用 persist_for 策略的永久資料表，但前提是 persist_for 資料表屬於衍生資料表串聯，且依賴該資料表的資料表使用 datagroup_trigger 或 sql_trigger_value 永久策略。在這種情況下，Looker 重新產生器會重建 persist_for 資料表，因為需要該資料表才能重建串聯中的另一個資料表。否則，再生器不會啟動 persist_for 資料表的建構作業。

「PDT 建構工具連線數量上限」設定預設為 1，但最高可設為 100。不過，這個值不得高於「Max connections per node」(每個節點的連線數量上限) 欄位中設定的值，或 Looker 啟動選項中設定的 per-user-query-limit。

請謹慎設定這個值。如果設定的值過高，資料庫可能會無法負荷。如果值偏低，執行時間較長的 PDT 或匯總表格可能會延遲建立其他永久性資料表，或減慢連線上的其他查詢。支援多用戶群架構的資料庫 (例如 BigQuery、Snowflake 和 Redshift)，在處理平行查詢建構作業時，效能可能較佳。

如要提高「Max Number of PDT Builder Connections」(PDT 建構工具連線數量上限) 設定，建議先以 1 為單位逐步增加。如果發生任何非預期行為，請將值設回預設值 1。如果查詢效能未受影響，則可繼續將設定值遞增 1，並在每次遞增後驗證效能，再進一步提高設定值。

請注意以下「PDT 建構工具連線數量上限」設定：

  • 「PDT 建構工具連線數量上限」設定僅適用於重建資料表所需的連線，不適用於觸發條件檢查所需的連線。觸發條件檢查是一種查詢，用於檢查是否觸發資料表的永久策略。由於這些觸發條件檢查查詢一律會依序執行，因此「Max Number of PDT Builder Connections」(PDT 建構工具連線數量上限) 設定不適用。
  • 在叢集 Looker 執行個體中，重新產生器只會在主要節點上執行。「Max Number of PDT Builder Connections」(PDT 建構工具連線數量上限) 設定僅適用於主要節點，因此會設定整個叢集的限制。
  • 「PDT 建構工具連線數量上限」設定不適用於下列類型的資料表。這類資料表會依序建立：
    • 透過 persist_for 參數保留的資料表 (除非資料表依附於使用 datagroup_trigger 或 sql_trigger_value 策略的資料表)。
    • 開發模式中的資料表。
    • 使用「重建衍生資料表並執行」選項重建的資料表。
    • 在依附元件串聯中，一個資料表依附於另一個資料表。資料表無法與其依附的資料表同時建構。舉例來說，如果 table_B 依附於 table_A，則 table_A 必須先完成重建，table_B 才能開始重建。

重新執行失敗的 PDT 建構作業

「重新執行失敗的 PDT 建構作業」切換鈕可設定 Looker 再生器如何嘗試重建在先前再生器週期中失敗的採用觸發條件的永久資料表。Looker 再生器會根據「維護排程」連線設定中設定的時間間隔，重新建構採用觸發條件的永久資料表 (PDT 和匯總表格)。啟用「重新執行失敗的 PDT 建構作業」切換鈕後，即使未符合 PDT 的觸發條件，Looker 重新產生器仍會嘗試重新建構在上一個重新產生器週期中失敗的 PDT。如果停用這項設定，Looker 重新產生器只會在 PDT 觸發條件符合時，嘗試重新建構先前失敗的 PDT。「重新執行失敗的 PDT 建構作業」預設為停用。

如要進一步瞭解 Looker 重新產生器，請參閱「Looker 中的衍生資料表」說明文件頁面。

PDT API 控制功能

「PDT API Control」切換鈕可決定是否能對這個連線使用 start_pdt_build、check_pdt_build 和 stop_pdt_build API 呼叫。如果停用「PDT API Control」切換鈕，這些 API 呼叫在參照這個連線上的 PDT 時就會失敗。「PDT API Control」切換鈕預設為停用。

啟用 PDT 覆寫

如果資料庫支援永久衍生資料表，且您已在連線設定中開啟「啟用 PDT」切換鈕，Looker 就會顯示「PDT 覆寫」切換鈕。啟用「PDT 覆寫」切換鈕，即可顯示「PDT 覆寫」部分，您可以在此輸入 PDT 程序專用的個別 JDBC 參數 (主機、通訊埠、資料庫、使用者名稱、密碼、結構定義、額外參數和連線後陳述式)。這項功能有許多好處：

  • 為 PDT 程序建立獨立的資料庫使用者後，即使您將使用者屬性指派給資料庫登入憑證，或使用 OAuth 建立資料庫連線，仍可在 Looker 專案中使用 PDT。
  • PDT 程序可透過優先順序較高的獨立資料庫使用者進行驗證。這樣一來，資料庫就能優先處理 PDT 工作，而非較不重要的使用者查詢。
  • 您可以撤銷標準 Looker 資料庫連線的寫入權限，並僅授予 PDT 程序用於驗證的特殊使用者。對大多數組織來說，這是更安全的策略。
  • 如果是 Snowflake 等資料庫，PDT 程序可以轉送至更強大的硬體，不與其他 Looker 使用者共用。這樣一來，PDT 就能快速建構，不必全天候執行昂貴的硬體，進而節省成本。

舉例來說，如果連線的使用者名稱和密碼欄位設為使用者屬性，「PDT 覆寫」部分可以建立獨立使用者 (pdt_user)，並設定專屬密碼。完成這項設定後，系統會執行下列操作：

  • 每位使用者都能使用使用者屬性指派的個人憑證存取資料庫。
  • pdt_user 帳戶將用於所有 PDT 程序，且具備建立及更新 PDT 的適當存取層級。
  • 使用者查詢流量和 PDT 程序流量可快速區分，以便透過系統活動進行監控等。

資料庫時區

資料庫儲存時間資訊時採用的時區。Looker 需要知道這項資訊，才能為使用者轉換時間值，讓他們更容易理解及使用時間資料。詳情請參閱「使用時區設定」說明文件頁面。

查詢時區

您必須先停用「使用者專屬時區」，系統才會顯示「查詢時區」選項。

停用「使用者專屬時區」時，「查詢時區」會是使用者查詢時間資料時顯示的時區，也是 Looker 將資料庫時區的時間資料轉換後的時區。

詳情請參閱「使用時區設定」說明文件頁面。

展開「狀態詳細資料」部分，測試連線設定。

查看

輸入所有資料庫連線設定後，您可以查看並測試連線，確認設定正確無誤。

測試連線設定

如要測試連線設定，請前往「連線設定」頁面底部的「狀態詳細資料」部分，然後點選「測試連線」按鈕。

如果 Looker 顯示「可連線」，請按下「連線」建立連線。資料庫連線就會新增至 Looker「連線」管理頁面的清單中。

管理員可以隨時測試連線，只要在「連線管理」頁面中，按一下連線清單旁的「測試」按鈕即可，詳情請參閱「連線」說明文件頁面。

如果您已將一或多個連線參數值設為使用者屬性，系統就會顯示「以使用者身分測試」選項。選取使用者，然後按一下「測試」，確認資料庫可以連線並以該使用者身分執行查詢。

疑難排解

如果連線未通過一或多項測試，請注意下列事項：

  • 如果您在 Atlas 執行 Mongo 3.6 以下版本，且收到通訊連結失敗訊息，請參閱 Mongo 連接器說明文件頁面。
  • 如要收到臨時結構定義和 PDT 的連線成功訊息，請務必在設定 Looker 資料庫時啟用該功能。如需操作說明，請參閱資料庫設定操作說明說明文件頁面。
  • 使用 OAuth 的資料庫連線 (例如 Snowflake、Google BigQuery、Trino 和 Databricks) 需要使用者登入。測試這類連線時，如果未登入 OAuth 使用者帳戶，Looker 會顯示警告和「登入」連結。點選連結，在「授權 OAuth 連線」對話方塊中選取「授權」(如有提示)，然後輸入 OAuth 憑證，讓 Looker 存取 OAuth 帳戶資訊。
  • 如果是客戶託管的 Looker 執行個體，請參閱「測試客戶託管執行個體的資料庫連線」說明文件頁面，瞭解疑難排解提示。

後續步驟

將資料庫連線至 Looker 後，即可為使用者設定登入選項。