參數 是為整個視覺資料準備所定義的命名值。 你可以在 SQL 和 Python 運算子程式碼中引用參數,在支援的運算子設定欄位,以及啟用或停用運算子的表達式中。 參數讓你能在不同環境下執行相同的視覺資料準備,例如開發時的測試目錄和生產環境的生產目錄。
定義參數
要管理參數,請在左側窗格選擇參數。 每個參數都有一個值,當你定義它時會設定。 當視覺資料準備依照排程或工作執行時,你可以覆寫該值。 參見 生產環境中的覆寫參數值。
從運算符中引用參數
你如何參考參數取決於你在哪裡使用它:
-
SQL 運算子:使用命名參數標記語法,例如
:environment。 請參見使用命名參數標記。 -
Python 運算子:呼叫
dbutils.widgets.get(),例如dbutils.widgets.get("environment")。 請參見 Widgets 工具(dbutils.widgets)。 -
支援的運算子設定欄位:在運算子的設定面板中,選擇右上角的 參數 。 選擇一個欄位並輸入如
:source_table的表達式。 支援欄位包括:- 資料來源: 表格、 檔案路徑與 檔案格式。
- 輸出:目錄、架構、資料表、檢視、卷、檔案名稱及寫入模式。
- 極限: 極限。
- 合併:設定操作、合併策略、依名稱合併及允許缺失欄位。
當你開啟 SQL 或 Python 操作符進行編輯時,Lakeflow Designer 會展示如何在原始碼編輯器上方參考可用參數的範例。
將參數與固定文字結合
在 Source 或 Output 運算子的參數運算式中,使用 :parameter_name 取代整個值。 要將參數與固定文字結合,請將文字包圍在單引號中並使用 ||。 例如,以下的來源 表 表達式構造一個完全限定的表名稱:
:catalog || '.' || :schema || '.' || :table
啟用或停用參數運算元
你可以用參數來啟用或停用任何已設定的運算子。 在 參數窗 格中,選擇 「停用 」並輸入布林運算式。 例如, :skip_operator 當參數為 true時 使 運算子失效。 已停用的運算子不會產生任何輸出列。
若要手動啟用或停用操作員,請參見 「重新命名、複製、刪除及停用操作員」。
生產中的覆蓋參數值
執行時,視覺資料準備器無論以互動式或工作方式讀取參數,都能以相同方式讀取,因此同一個檔案能在所有環境中運作,無需更改。 為每種環境提供不同的數值如下:
-
在使用者介面中為工作建立排程時:可為每個排程覆寫參數值。 例如,將相同的視覺資料準備排程在每天中午執行,參數
environment設為test,下午 2 點再執行一次,參數environment設為production。 把 排班當作一份工作來看。 -
使用 bundle 部署時:透過工作的
parameters設定參數值,並使用 bundle 目標為不同環境提供不同的值。 開發與生產目標的捆綁則允許你將同一個工作部署到具有特定環境設定的不同環境。 請參閱 宣告式自動化套件的部署模式 與 宣告式自動化套件的配置。