:Criar uma função Python

Pré-requisitos

Crie um processo de negócios. Para mais detalhes, consulte Crie e gerencie processos de negócios.

Informações básicas

No DataService Studio, você pode criar, testar e publicar funções. Em seguida, associe uma função publicada a uma API como filtro para processar os parâmetros de solicitação ou os resultados de resposta da API. Esse recurso oferece suporte a consultas complexas de API e permite adaptação a diferentes cenários de negócios.

Limites

• Para usar funções e filtros Python, adquira o DataWorks Professional Edition ou superior.

• As funções Python devem ser executadas em um grupo de recursos compartilhados do DataService Studio.

• As funções Python estão sendo redesenhadas. Atualmente, não é possível criar, clonar ou publicar novas funções Python. Se precisar de funcionalidades de função, recomendamos o uso de funções Aviator. Para mais detalhes, consulte Crie uma função Aviator.

• Ao usar funções como filtros de API, o pré-filtro e o pós-filtro devem ser do mesmo tipo. Selecione funções Python para ambos. No momento, não é possível usar tipos de função diferentes para o pré-filtro e o pós-filtro da mesma API.

• Os seguintes limites se aplicam ao uso de uma função Python como filtro:

  • O filtro aceita apenas a sintaxe Python 3.0.

  • O filtro aceita apenas import json,time,random,pickle,re,math.

  • O filtro exige o nome da função e a assinatura def handler(event,context):.

Estrutura da função

# -*- coding: utf-8 -*-
# event (str) : in filter it is the API result, in other cases, it is your param
# context : some environment information, temporarily useless
# import module limit: json,time,random,pickle,re,math
# do not modify function name
import json
def handler(event,context):
    # load str to json object
    obj = json.loads(event)
    # add your code here
    # end add
    return obj

Parameter 1 [context]: A string that contains the API execution context. It is currently empty and not in use.
Parameter 2 [event]: A string that contains the API request parameters or the output of the previous filter.

Acessar o DataService Studio

Faça login no DataWorks console. Na região de destino, 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

1. Na página Service Development, passe o ponteiro sobre o ícone e clique em Create Function > Create Python Function.

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

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

   Parâmetro	Descrição
   Function Name	Nome da função personalizada. Pode conter até 256 caracteres.
   Function Template	Apenas o modelo Python3 Standard v1 é aceito.
   Runtime Environment	Somente Python 3.0 é aceito.
   Function Description	Breve descrição da função. Pode conter até 512 caracteres.
   Location	Diretório onde a função será armazenada.

3. Clique em Confirm.

4. Configure a função na página de edição de função.

   1. Insira o código da função na área Edit Code.

   2. Na área Environment Configuration, defina Memory e Timeout.

5. Clique no ícone na barra de ferramentas.

Próximas etapas

• Após criar a função, teste-a e implante-a. Para mais informações, consulte Test, deploy, and use a function e Deploy a function.

• Depois de implantar a função, associe-a a uma API e utilize-a como pré-filtro ou pós-filtro para processar parâmetros de solicitação e dados de resposta. Para mais informações, consulte Use a function as an API filter.