SHOW FUNCTIONS

Devuelve la lista de funciones después de aplicar un patrón regex opcional. Dado el número de funciones compatibles con Spark es bastante grande, esta instrucción junto con la función describe se puede usar para encontrar rápidamente la función y comprender su uso. La LIKE cláusula es opcional y solo se admite por compatibilidad con otros sistemas.

Sintaxis

SHOW [ function_kind ] FUNCTIONS [ [ LIKE ] { function_name | regex_pattern } ]

Parámetros

  • function_kind

    Espacio de nombres de la función en la que se va a buscar. Los espacios de nombres válidos son :

    • USER: busca las funciones entre las funciones definidas por el usuario.
    • SYSTEM: busca las funciones entre las funciones definidas por el sistema.
    • ALL: busca las funciones entre las funciones definidas por el usuario y el sistema.
  • function_name

    Nombre de una función existente en el sistema. El nombre de la función puede calificarse opcionalmente con un nombre de base de datos. Si está calificado con una base de datos, la función se resuelve a partir de la base de datos especificada por el usuario; de lo contrario, se function_name resuelve desde la base de datos actual.

    Sintaxis:[database_name.] function_name

  • regex_pattern

    Patrón de expresión regular que se usa para filtrar los resultados de la instrucción .

    • Excepto el * carácter y , el patrón funciona como una expresión | regular.
    • * solo coincide con 0 o más caracteres y se usa para separar | varias expresiones regulares diferentes, cualquiera de las cuales puede coincidir.
    • Los espacios en blanco iniciales y finales se recortan en el patrón de entrada antes del procesamiento. La coincidencia de patrones no tiene en cuenta mayúsculas de minúsculas.

Ejemplos

-- List a system function `trim` by searching both user defined and system
-- defined functions.
SHOW FUNCTIONS trim;
+--------+
|function|
+--------+
|    trim|
+--------+

-- List a system function `concat` by searching system defined functions.
SHOW SYSTEM FUNCTIONS concat;
+--------+
|function|
+--------+
|  concat|
+--------+

-- List a qualified function `max` from database `salesdb`.
SHOW SYSTEM FUNCTIONS salesdb.max;
+--------+
|function|
+--------+
|     max|
+--------+

-- List all functions starting with `t`
SHOW FUNCTIONS LIKE 't*';
+-----------------+
|         function|
+-----------------+
|              tan|
|             tanh|
|        timestamp|
|          tinyint|
|           to_csv|
|          to_date|
|          to_json|
|     to_timestamp|
|to_unix_timestamp|
| to_utc_timestamp|
|        transform|
|   transform_keys|
| transform_values|
|        translate|
|             trim|
|            trunc|
|           typeof|
+-----------------+

-- List all functions starting with `yea` or `windo`
SHOW FUNCTIONS LIKE 'yea*|windo*';
+--------+
|function|
+--------+
|  window|
|    year|
+--------+

-- Use normal regex pattern to list function names that has 4 characters
-- with `t` as the starting character.
SHOW FUNCTIONS LIKE 't[a-z][a-z][a-z]';
+--------+
|function|
+--------+
|    tanh|
|    trim|
+--------+