共用方式為


查詢片段

複製先前的工作和修改通常比從頭開始撰寫內容更容易。 常見 JOIN 語句或複雜 CASE 表示式尤其如此。 隨著查詢清單的成長,很難記住哪些查詢包含您需要的語句。 您也可以建立包含插入點的查詢程式碼片段,其中包含用戶可在運行時間取代的佔位文字。

查詢代碼段是您可以使用自動完成來共用和觸發的查詢區段。 使用下列項目的查詢代碼段:

  • 頻繁 JOIN 語句
  • 複雜的條款,例如 WITHCASE
  • 條件式格式設定

以下是片段的範例:

--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、筆記本或檔案編輯器建立查詢代碼段。 請遵循下列步驟:

  1. 新 SQL 編輯器中,單擊 Kebab 功能表圖示,然後單擊 檢視

    在筆記本或檔案編輯器中,按兩下 [ 檢視]。

  2. 按一下查詢代碼段

  3. 點選 建立查詢代碼段

  4. 在「替換」欄位中,輸入片段名稱。 撰寫使用代碼段的查詢時,您將使用此名稱。

  5. (選用) 輸入描述。

  6. 在 [片段] 欄位中,輸入片段。

  7. 按一下 建立

    查詢片段

使用查詢片段

查詢代碼段可以用於任何 SQL 查詢。 您可以在 SQL 編輯器、筆記本 SQL 資料格、SQL 檔案和 AI/BI 儀表板的查詢中存取查詢片段。

以下是一個簡單的查詢範例,您可以使用這些查詢片段:

--Simple query
SELECT * FROM samples.nyctaxi.trips

使用以下步驟將查詢程式碼片段與此查詢一起使用:

  1. 開啟 SQL 編輯器

  2. 在 [SQL 編輯器查詢] 窗格中輸入您的查詢。

  3. 開始輸入查詢代碼段的名稱,然後從 [自動完成] 視窗中選取它。

    在 SQL 編輯器中,您也可以用Control+Space手動開啟視窗並選取程式碼片段。

    查詢選擇代碼片段

  4. 使用查詢代碼段中的 WHERE 子句來執行查詢。

    查詢,其中顯示查詢 中使用的片段

使用查詢程式碼片段中的插入點

您可以使用一個美元符號和大括弧來包裝整數標籤順序 ${},以設置插入點。 前面加上冒號 :的文字佔位元可以是選擇性的,但對不熟悉你片段的使用者很有用。 在具有您先前建立之插入點的查詢代碼段中, ${1:value} 是具有佔位符的插入點,而且 ${1:100} 是一個插入點,其中包含您可以在運行時間覆寫之佔位符的預設值。 當 Databricks SQL 呈現程式碼片段時,會移除美元符號 $ 和大括號 {},然後將單詞 value 或預設值 100 反白顯示以供替換。

當有多個插入點時,插入點游標會跳至第一個插入點,要求輸入所需的值。 當您按下 Tab時,插入號會跳到下一個可輸入值的插入點。 當您再次按下 Tab 時,游標會跳到下一個插入點的位置,直到抵達最後一個插入點。

注意

插入點 ${0} 具有零值,始終是定位順序中的最後一個位置。

要使用查詢搭配插入點查詢片段,請按照以下步驟進行:

  1. 開啟 SQL 編輯器

  2. 在 [SQL 編輯器查詢] 窗格中輸入您的查詢。

  3. 輸入查詢代碼段名稱的前三個字母,然後選取含有插入點且不含預設值的查詢代碼段。

    查詢片段會新增至查詢,而文字插入點位置會跳至插入點。

    使用插入點查詢代碼段進行查詢,而沒有預設值

  4. 請輸入 WHERE 子句的一個值,例如 200

  5. 或者,使用查詢代碼段中的 WHERE 子句執行查詢。

  6. 重複上述步驟,但使用預設值選取具有插入點的查詢代碼段。

    使用插入點查詢片段進行查詢,包含預設值

  7. 重複上述步驟,但選取具有多個插入點的查詢代碼段。

    使用包含多個插入點的插入點查詢代碼段 查詢

  8. 輸入第一個插入點的值,按 Tab 鍵跳到下一個插入點並輸入值,然後按 Tab 鍵跳到最後的插入點並輸入值。