共用方式為

查詢片段

  • 發行項

複製先前的工作和修改通常比從頭開始撰寫內容更容易。 常見 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}

建立查詢片段

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

  1. 單擊工作區頂端列中的使用者名稱，然後從下拉式清單中選取 [[設定]。

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

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

  4. 點選 建立查詢代碼段。

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

  6. 選擇性地輸入描述。

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

  8. 按一下 建立。

    查詢片段

在查詢中使用查詢片段

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

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

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

  1. 開啟 SQL 編輯器。

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

  3. 輸入代碼段名稱的前 3 個字母，然後從自動完成視窗中選取代碼段。 您也可以手動開啟視窗，按 Option + Space 並選取片段。

    查詢選擇代碼片段

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

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

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

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

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

注意

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

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

  1. 開啟 SQL 編輯器。

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

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

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

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

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

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

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

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

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

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

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