Criar uma função Python - : Central de Documentação do Alibaba Cloud

Pré-requisitos

Crie um processo de negócios. Para mais informações, consulte Criar e gerenciar processos de negócios.

Informações básicas

No DataService Studio, você cria, testa e publica funções. Após a publicação, associe a função a uma API. A função atua como filtro para processar os parâmetros de solicitação ou os dados de resposta da API. Isso permite consultas complexas e atende a diversos cenários de negócios.

Limitações

Adquira o DataWorks Professional Edition ou uma edição superior para usar funções Python e o recurso de filtro.
As funções Python devem executar no grupo de recursos compartilhado do DataService Studio.
As funções Python estão em refatoração. Não é possível criar, clonar ou publicar novas funções Python. Se precisar usar o recurso de função, utilize uma função Aviator. Para mais informações, consulte Criar uma função Aviator.
Ao usar uma função como filtro de API, tanto o filtro de pré-processamento quanto o de pós-processamento devem ser funções Python.
O uso de funções Python como filtros está sujeito às seguintes restrições:
- Os filtros aceitam apenas a sintaxe do Python 3.0.
- Os filtros aceitam apenas os seguintes módulos: import json,time,random,pickle,re,math.
- Os filtros exigem a assinatura de função def handler(event,context):.

Estrutura da função

# -*- coding: utf-8 -*-
# event (str): The API result if used as a filter, or your parameters in other cases.
# context: Contains environment information. This parameter is currently not in use.
# Supported import modules: json, time, random, pickle, re, math.
# Do not modify the function name.
import json
def handler(event,context):
    # Load the string into a JSON object.
    obj = json.loads(event)
    # Add your code here.
    # End of custom code.
    return obj

Modifique este modelo de função e altere os nomes dos parâmetros de entrada conforme necessário.

Parameter 1 [context]: Contains the API execution context. This parameter is not currently used.  
Parameter 2 [event]: Contains the API request parameters or the result from the previous filter.

Nota

O sistema converte os parâmetros de solicitação da API ou a saída do filtro anterior em uma string JSON e a transmite para o parâmetro event. Cada value no objeto JSON deve ser uma string.
Um filtro de pré-processamento gera um mapa de chave-valor que a instrução SQL subsequente usa como parâmetro de entrada. Portanto, o mapa deve ter profundidade 1 (mapa plano).

Acessar o DataService Studio

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.

Criar uma função

No painel Service Development, passe o mouse sobre o ícone e clique em Create Function > Create Python Function.

Como alternativa, localize o processo de negócios desejado, clique com o botão direito em Function e selecione Create > Create Python Function.

Na caixa de diálogo Create Python Function, configure os parâmetros.

Parâmetro	Descrição
Function Name	Nome da função. Limite de 256 caracteres.
Function Template	Apenas o modelo Python3 Standard v1 é compatível.
Runtime Environment	Apenas o Python 3.0 é compatível.
Function Description	Descrição da função. Limite de 512 caracteres.
Location	Pasta onde a função será armazenada.

Clique em Confirm.
Configure a função na página de edição.
1. Na seção Edit Code, insira o código da função.
2. Na seção Environment Configuration, defina a Memory e o Timeout.
Clique no ícone Salvar na barra de ferramentas.

Próximas etapas

Após criar a função, teste-a e implante-a. Para mais detalhes, consulte Testar, implantar e usar uma função e Implantar uma função.
Após implantar a função, associe-a a uma API e use-a como pré-filtro ou pós-filtro para processar parâmetros de solicitação e dados de resposta. Para mais informações, consulte Usar uma função como filtro de API.