複製先前的工作和修改通常比從頭開始撰寫內容更容易。 常見 JOIN
語句或複雜 CASE
表示式尤其如此。 隨著查詢清單的成長,很難記住哪些查詢包含您需要的語句。 您也可以建立包含插入點的查詢程式碼片段,其中包含用戶可在運行時間取代的佔位文字。
查詢代碼段是您可以使用自動完成來共用和觸發的查詢區段。 使用下列項目的查詢代碼段:
- 頻繁
JOIN
語句 - 複雜的條款,例如
WITH
或CASE
。 - 條件式格式設定
以下是片段的範例:
--Simple snippet
WHERE fare_amount > 100
--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}
--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}
--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}
建立查詢程式片段
您可以從 SQL、筆記本或檔案編輯器建立查詢代碼段。 請遵循下列步驟:
在 新 SQL 編輯器中,單擊
,然後單擊 檢視。
在筆記本或檔案編輯器中,按兩下 [ 檢視]。
按一下查詢代碼段。
點選 建立查詢代碼段。
在「替換」欄位中,輸入片段名稱。 撰寫使用代碼段的查詢時,您將使用此名稱。
(選用) 輸入描述。
在 [片段] 欄位中,輸入片段。
按一下 建立。
使用查詢片段
查詢代碼段可以用於任何 SQL 查詢。 您可以在 SQL 編輯器、筆記本 SQL 資料格、SQL 檔案和 AI/BI 儀表板的查詢中存取查詢片段。
以下是一個簡單的查詢範例,您可以使用這些查詢片段:
--Simple query
SELECT * FROM samples.nyctaxi.trips
使用以下步驟將查詢程式碼片段與此查詢一起使用:
開啟 SQL 編輯器。
在 [SQL 編輯器查詢] 窗格中輸入您的查詢。
開始輸入查詢代碼段的名稱,然後從 [自動完成] 視窗中選取它。
在 SQL 編輯器中,您也可以用
Control+Space
手動開啟視窗並選取程式碼片段。使用查詢代碼段中的
WHERE
子句來執行查詢。中使用的片段
使用查詢程式碼片段中的插入點
您可以使用一個美元符號和大括弧來包裝整數標籤順序 ${}
,以設置插入點。 前面加上冒號 :
的文字佔位元可以是選擇性的,但對不熟悉你片段的使用者很有用。 在具有您先前建立之插入點的查詢代碼段中, ${1:value}
是具有佔位符的插入點,而且 ${1:100}
是一個插入點,其中包含您可以在運行時間覆寫之佔位符的預設值。 當 Databricks SQL 呈現程式碼片段時,會移除美元符號 $
和大括號 {}
,然後將單詞 value
或預設值 100
反白顯示以供替換。
當有多個插入點時,插入點游標會跳至第一個插入點,要求輸入所需的值。 當您按下 Tab
時,插入號會跳到下一個可輸入值的插入點。 當您再次按下 Tab
時,游標會跳到下一個插入點的位置,直到抵達最後一個插入點。
注意
插入點 ${0}
具有零值,始終是定位順序中的最後一個位置。
要使用查詢搭配插入點查詢片段,請按照以下步驟進行:
開啟 SQL 編輯器。
在 [SQL 編輯器查詢] 窗格中輸入您的查詢。
輸入查詢代碼段名稱的前三個字母,然後選取含有插入點且不含預設值的查詢代碼段。
查詢片段會新增至查詢,而文字插入點位置會跳至插入點。
請輸入
WHERE
子句的一個值,例如200
。或者,使用查詢代碼段中的
WHERE
子句執行查詢。重複上述步驟,但使用預設值選取具有插入點的查詢代碼段。
使用插入點查詢片段進行查詢,包含預設值
重複上述步驟,但選取具有多個插入點的查詢代碼段。
使用包含多個插入點的插入點查詢代碼段
輸入第一個插入點的值,按 Tab 鍵跳到下一個插入點並輸入值,然後按 Tab 鍵跳到最後的插入點並輸入值。