共用方式為


查詢片段

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

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

  • 頻繁 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}

建立查詢片段

使用以下步驟來建立程式碼片段,這些是程式碼片段的範例:

  1. 點擊工作區上方列中的使用者名稱,然後從下拉式清單中選擇select設定

  2. 單擊 [開發人員] 索引標籤。

  3. SQL 查詢代碼段旁 點擊 [管理]

  4. 點選 建立查詢代碼段

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

  6. 選擇性地輸入描述。

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

  8. 按一下 建立

    查詢片段

在查詢中使用查詢片段

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

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

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

  1. 開啟 SQL 編輯器

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

  3. 輸入片段名稱的前 3 個字母,然後從自動完成功能中選擇一個片段 windowselect。 您也可以手動開啟 window,方法是按壓 Option + Space 和 select 一下。

    查詢選擇代碼片段

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

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

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

您可以使用一個美元符號和大括弧來包裝整數標籤順序 ${},以設置插入點。 前面加上冒號 :的文字佔位元可以是選擇性的,但對不熟悉你片段的使用者很有用。 在您先前建立的查詢片段中,${1:value} 是具有佔位符的插入點,${1:100} 是可以在執行時被您覆寫的佔位符的預設值的插入點。 當 Databricks SQL 轉譯代碼段時,會移除美元符號 $ 和大括弧符號 {},並將要取代的文字 value 或預設文字 100 反白顯示。

當有多個插入點時,文字插入符號會跳到第一個插入點,以提示輸入所需的值。 當您按下 Tab時,克拉會跳至下一個值的下一個插入點。 當您再次按下 Tab 時,游標會跳到下一個插入點,直到到達最後一個插入點。

注意

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

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

  1. 開啟 SQL 編輯器

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

  3. 輸入查詢代碼段名稱的前 3 個字母,然後在插入點未設定預設值的情況下使用 select 插入查詢代碼段。

    查詢片段會新增至查詢,而文字插入游標會移至插入點。

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

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

  5. 可以選擇使用查詢代碼段中的 WHERE 子句來執行查詢。

  6. 重複上述步驟,但 select 使用預設值來搭配插入點進行查詢片段。

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

  7. 重複上述步驟,但對具有多個插入點的查詢片段進行 select。

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

  8. 輸入第一個插入點的值,按 Tab 鍵前往下一個插入點並輸入值,再按 Tab 鍵前往最終插入點並輸入值。