Testar, publicar e usar uma função - DataWorks: Central de Documentação do Alibaba Cloud

Este tópico descreve como testar, publicar e usar uma função no DataService Studio. É possível utilizar funções como filtros para processar requisições e respostas de API.

Pré-requisitos

Antes de testar uma função, verifique se ela já foi criada e salva. Para mais informações, consulte Gerenciar funções.

Limitações

Somente o proprietário do workspace e usuários RAM com a função Workspace Administrator, Develop ou O&M podem testar funções. Para mais detalhes, acesse Adicionar um membro ao workspace e gerenciar permissões de função.

Etapa 1: Testar a função

Acesse a página Data Services.
1. Faça login no console do DataWorks. Na região desejada, clique em Data Analysis and Service > DataService Studio no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to DataService Studio.
2. Na página Service Development, localize a função em desenvolvimento na lista de funções e dê um duplo clique nela.

Na página de edição da função, clique em Test na barra de ferramentas superior.

## --- AviatorScript ---
## $0: the default name of the input param.
## Expressions must be separated by the semicolon ";".
## Example 1:
## $0.a: Get the attribute "a" from the input param "$0".
## $0.b[index]: Get the index of the array "b" from the input param "$0". The index cannot be an expression or a variable.
## Example 2:
## Input: {"keyA":[1,2],"keyB":"value"}
## Function: $0.keyA[0]=3; $0.keyB="new_value"; return $0;
## Output: {"keyA":[3,2],"keyB":"new_value"}

Na caixa de diálogo Function Test, insira os parâmetros e clique em Confirm.

O status da execução fica disponível na aba Run Results, na parte inferior. Caso o teste falhe, analise a mensagem de erro, ajuste a função conforme necessário e execute o teste novamente.

Etapa 2: Publicar a função

Após a aprovação da função nos testes, publique-a.

Na página Service Development, dê um duplo clique na função aprovada nos testes dentro da lista de funções.
Na barra de ferramentas superior, clique em Submission.
Na página de edição da função, clique em Version no painel de navegação à direita. Localize a versão com o status Can Be Published e clique em Publish na coluna Actions.

Nota
Depois de publicar a função, acesse Version no painel de navegação à direita da página de edição para consultar o histórico de publicações. Em seguida, visualize os Version Details ou clique em Roll Back.

Etapa 3: Usar a função

Casos de uso

Como pré-filtro de API, a função permite preprocessar os parâmetros da requisição durante a chamada.
Na forma de pós-filtro, possibilita o processamento adicional e a transformação da resposta da API.

Limitações

Os filtros anterior e posterior de uma API devem utilizar o mesmo tipo de função. Ambos precisam ser funções Aviator ou ambos funções Python.
O recurso de função Python está em processo de atualização. Por esse motivo, não há suporte no momento para criar, clonar ou publicar novas funções Python.

Uso como filtro de API

Na página Service Development, expanda Workflow > API.
Dê um duplo clique na API para abrir sua página de edição.
No painel de navegação à direita, clique em Filter.
Marque a caixa de seleção Use Pre-filter ou Use Post-filter. O campo Function Type vem preenchido automaticamente como Aviator Function. Abra a lista suspensa do pré-filtro ou pós-filtro para escolher uma ou mais funções. Ao adicionar múltiplas funções, elas serão executadas na ordem de inclusão para processar os parâmetros da API.
Nota
- Um filtro é composto por uma ou mais funções responsáveis por preprocessar parâmetros de requisição de API ou refinar resultados de consulta.
- Caso a função desejada não apareça na lista suspensa, confirme se ela já foi publicada. Também é possível criar e publicar uma nova função. Consulte Publicar a função para obter orientações.
Clique em Preview Responses Returned by API Operation para validar a saída do filtro.