創建函數

適用於:勾選“是”磚的SQL勾選“是”Databricks運行時9.1及以上版本

創建一個SQL標量函數或表函數，該函數接受一組參數並返回一個標量值或一組行。

語法

創建［或取代］［臨時］函數［如果不存在］function_name（［function_parameter(,.．.］］）返回｛data_type|表格（column_spec(,.．.])［特征［.．.］］返回｛表達式|查詢｝function_parameterparameter_namedata_type［默認的default_expression］［評論parameter_comment］column_speccolumn_namedata_type［評論column_comment］特征｛語言SQL|［不］確定的|評論function_comment|［包含SQL|讀取SQL數據］|SQL安全定義者｝

參數

  • 或替換

    如果指定，則替換具有相同名稱和簽名(參數數量和參數類型)的函數。不能使用不同的簽名替換現有的函數。這主要用於更新函數體和函數的返回類型。不能指定此參數如果不存在．

  • 臨時

    正在創建的函數的範圍。當你指定臨時，則創建的函數在當前會話中有效且可見。目錄中沒有持久化條目。

  • 如果不存在

    如果指定，則僅在函數不存在時創建該函數。如果指定的函數已經存在於係統中，則函數創建成功(沒有拋出錯誤)。不能指定此參數或取代．

  • function_name

    函數的名稱。對於永久函數，可以選擇使用模式名限定函數名。如果名稱沒有限定，則在當前模式中創建永久函數。

  • function_parameter

    指定函數的參數。

    • parameter_name

      參數名在函數中必須是唯一的。

    • data_type

      任何支持的數據類型。

    • 默認的default_expression

      適用於:勾選“是”磚的SQL勾選“是”Databricks運行時10.4及以上

      當函數調用不為形參賦值時使用的可選默認值。default_expression必須可塑的來data_type．表達式不能引用另一個參數或包含子查詢。

      當為一個參數指定默認值時，以下所有參數也必須具有默認值。

    • 評論發表評論

      參數的可選描述。評論必須是STRING字麵值。

  • 返回data_type

    標量函數的返回數據類型。

  • 返回表(column_spec[，…])

    表函數結果的簽名。

    • column_name

      列名在簽名中必須唯一。

    • data_type

      任何支持的數據類型。

    • 評論column_comment

      列的可選描述。評論必須是STRING字麵值。

  • 返回{表達式|查詢｝

    函數體。對於標量函數，它可以是查詢或表達式。對於表函數，它隻能是一個查詢。表達式不能包含:

    在函數體中，可以通過形參的非限定名稱引用形參，也可以使用函數名限定形參。

  • 特征

    所有特征子句都是可選的。可以按任意順序指定任意數量的子句，但每個子句隻能指定一次。

    • 語言SQL

      函數的語言。SQL是唯一受支持的語言。

    • (不)確定的

      函數是否確定。當一個函數對於一組給定的參數隻返回一個結果時，它就是確定的。

    • 評論function_comment

      函數的注釋。function_comment必須是字符串字麵量。

    • 包含SQL或讀取SQL數據

      函數是直接還是間接地從表或視圖讀取數據。當函數讀取SQL數據時，不能指定包含SQL．如果兩個子句都不指定，則該屬性將從函數體派生。

    • SQL安全定義器

      函數體和任何默認表達式都使用函數所有者的授權執行。這是唯一受支持的行為。

例子

創建並使用SQL標量函數

>創建視圖t（c1，c2）作為值（0，1)，（1，2）;
——創建一個不帶參數的臨時函數。>創建臨時函數你好（）返回字符串返回“Hello World !”；>選擇你好（);你好世界！——創建帶參數的永久函數。>創建函數區域（x雙，y雙）返回雙返回x＊y；在查詢的SELECT子句中使用SQL函數。>選擇區域（c1，c2）作為區域從t；0．02．0在查詢的WHERE子句中使用SQL函數。>選擇＊從t在哪裏區域（c1，c2）>0；12編寫SQL函數。>創建函數廣場（x雙）返回雙返回區域（x，x）;>選擇c1，廣場（c1）作為廣場從t；00．011．0——創建一個非確定性函數>創建函數roll_dice（）返回INT不確定的包含SQL評論“擲一個六麵骰子”返回（蘭德（）＊6)::INT+1；——擲一個6麵骰子>選擇roll_dice（);3.

創建並使用使用默認值的函數

——擴展功能，支持可變邊數和骰子。——使用默認值來支持可變數量的參數>下降函數roll_dice；>創建函數roll_dice（num_diceINT默認的1評論擲骰子的個數(默認值:1)，num_sidesINT默認的6評論每個骰子的邊數(默認值:6)）返回INT不確定的包含SQL評論“擲一些n麵骰子”返回總（序列（1，roll_dice．num_dice，1)，0，（acc，x）->（蘭德（）＊roll_dice．num_sides)::int，acc->acc+roll_dice．num_dice）;投擲單個6麵骰子仍然有效>選擇roll_dice（);3.擲3個六麵骰子>選擇roll_dice（3.）;15——擲3個10麵骰子>選擇roll_dice（3.，10）21——創建帶有標量子查詢的SQL函數。>創建視圖分數（球員，分數）作為值（0，1)，（0，2)，（1，2)，（1，5）;>創建函數avg_score（pINT）返回浮動評論“獲得玩家的平均分”返回選擇AVG（分數）從分數在哪裏球員＝p；>選擇c1，avg_score（c1）從t；01．513.．5

創建一個SQL表函數

——製作兩個日期之間的所有工作日>創建函數工作日（開始日期，結束日期）返回表格（day_of_week字符串，一天日期）返回選擇提取（DAYOFWEEK_ISO從一天)，一天從（選擇序列（工作日．開始，工作日．結束）)作為T（天）橫向視圖爆炸（天）作為一天在哪裏提取（DAYOFWEEK_ISO從一天）之間的1和5；——返回所有工作日>選擇工作日．day_of_week，一天從工作日（日期“2022-01-01”，日期“2022-01-14”）;12022-01-0322022-01-043.2022-01-0542022-01-0652022-01-0712022-01-1022022-01-113.2022-01-1242022-01-1352022-01-14—返回來自LATERAL相關性的日期範圍的工作日>選擇工作日．＊從值（日期“2020-01-01”)，（日期“2021-01-01”)，（日期“2022-01-01”）作為開始（開始)，橫向工作日（開始，開始+時間間隔“7”天）;3.2020-01-0142020-01-0252020-01-0312020-01-0622020-01-073.2020-01-0852021-01-0112021-01-0422021-01-053.2021-01-0642021-01-0752021-01-0812022-01-0322022-01-043.2022-01-0542022-01-0652022-01-07

替換SQL函數

—替換一個SQL標量函數。>創建或取代函數廣場（x雙）返回雙返回x＊x；替換一個SQL表函數。>創建或取代函數getemps（deptnoINT）返回表格（名字字符串）返回選擇名字從員工e在哪裏e．deptno＝getemps．deptno；描述一個SQL表函數。>描述函數getemps；函數：默認的．getemps類型：表格輸入：deptnoINT返回：idINT名字字符串

請注意

不能使用不同的簽名替換現有的函數。

描述一個SQL函數

>描述函數你好；函數：你好類型：標量輸入：（）返回：字符串>描述函數區域；函數：默認的．區域類型：標量輸入：x雙y雙返回：雙>描述函數roll_dice；函數：默認的．roll_dice類型：標量輸入：num_diceINTnum_sidesINT返回：INT>描述函數擴展roll_dice；函數：默認的．roll_dice類型：標量輸入：num_diceINT默認的1擲骰子的個數(默認值:1)num_sidesINT默認的6每個骰子的麵數(默認值:6)返回：INT評論：卷一個數量的米-站骰子確定的：假數據訪問：包含SQL配置：.．.老板：的．房子@總是．贏了創建時間：坐2月1209：29：02太平洋標準時間2022身體：總（序列（1，roll_dice．num_dice，1)，0，（acc，x）->（蘭德（）＊roll_dice．num_sides)::int，acc->acc+roll_dice．num_dice）