MaxCompute SQL admite dos categorías de funciones: las integradas y las definidas por el usuario (UDF). Las funciones integradas cubren de forma inmediata las tareas comunes de procesamiento y agregación de datos. Cuando estas no satisfacen sus necesidades, utilice las API de Java o Python para crear UDF con lógica personalizada.
Funciones integradas
Las funciones integradas están listas para usarse en cualquier instrucción de MaxCompute SQL, sin que se requiera configuración alguna. Estas resuelven tareas habituales como la manipulación de cadenas, las operaciones matemáticas, el procesamiento de fechas y la agregación.
Consulte Built-in functions para consultar la lista completa.
Funciones definidas por el usuario (UDF)
Las UDF amplían las capacidades de MaxCompute mediante lógica personalizada escrita en Java o Python. Úselas cuando las funciones integradas no cubran sus requerimientos específicos.
MaxCompute admite tres tipos de UDF:
|
Tipo |
Descripción |
|
Función escalar definida por el usuario (UDF) |
Recibe una fila de entrada y devuelve una fila de salida. Resulta adecuada para transformaciones de filas. |
|
Función de agregación definida por el usuario (UDAF) |
Procesa varias filas de entrada y devuelve un único resultado. Utilícela para lógicas de agregación personalizadas, como promedios ponderados o cálculos estadísticos complejos. |
|
Función con valor de tabla definida por el usuario (UDTF) |
Recibe una fila de entrada y genera cero o más filas de salida. Úsela cuando una sola fila de entrada deba producir varias filas de salida. |
Una vez registrada, invoque una UDF de la misma manera que una función integrada: mediante su nombre y sus parámetros dentro de una instrucción SQL.
Desarrollar y registrar una UDF
Para que una UDF esté disponible en MaxCompute SQL, siga estos pasos:
Escriba el código de la UDF con la API de UDF de MaxCompute.
Empaquete el código al compilarlo en un paquete JAR (para las UDF de Java).
Cargue el paquete en MaxCompute como un recurso.
Registre la UDF en MaxCompute con un nombre y la referencia del recurso.
Consulte Create a UDF para obtener instrucciones detalladas paso a paso.