O MaxCompute SQL oferece suporte a duas categorias de funções: integradas e definidas pelo usuário (UDFs). As funções integradas atendem prontamente a tarefas comuns de processamento e agregação de dados. Se elas não atenderem aos seus requisitos, use as APIs Java ou Python para criar UDFs com lógica personalizada.
Funções integradas
As funções integradas estão prontas para uso em qualquer instrução MaxCompute SQL, sem necessidade de configuração prévia. Elas executam tarefas frequentes, como manipulação de strings, operações matemáticas, processamento de datas e agregações.
Para consultar a lista completa, visualize Built-in functions.
Funções definidas pelo usuário (UDFs)
As UDFs estendem o MaxCompute com lógica personalizada escrita em Java ou Python. Use-as quando as funções integradas não cobrirem suas necessidades específicas.
O MaxCompute oferece suporte a três tipos de UDFs:
|
Tipo |
Descrição |
|
Função escalar definida pelo usuário (UDF) |
Recebe uma linha de entrada e retorna uma linha de saída. Ideal para transformações no nível da linha. |
|
Função de agregação definida pelo usuário (UDAF) |
Processa várias linhas de entrada e retorna um único resultado. Recomendada para lógicas de agregação personalizadas, como médias ponderadas ou cálculos estatísticos complexos. |
|
Função com valor de tabela definida pelo usuário (UDTF) |
Aceita uma linha de entrada e devolve zero ou mais linhas de saída. Indicada quando uma única linha de entrada precisa gerar múltiplas linhas de saída. |
Após o registro, chame uma UDF da mesma forma que uma função integrada, informando o nome e os parâmetros na instrução SQL.
Desenvolver e registrar uma UDF
Para disponibilizar uma UDF no MaxCompute SQL:
Escreva o código da UDF com a API de UDF do MaxCompute.
Empacote o código compilando-o em um pacote JAR (para UDFs Java).
Faça upload do pacote para o MaxCompute como recurso.
Registre a UDF no MaxCompute informando um nome e a referência ao recurso.
Para obter instruções detalhadas, crie Create a UDF.