Função PYNUMERIC( )

Retorna um valor numérico calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

Sintaxe

PYNUMERIC(ArquivoPy; FunçãoPy; decimal <; campo|valor <;...n>>)

Parâmetros

Nome	Tipo	Descrição
ArquivoPy; FunçãoPy	caractere	O nome do script do Python a ser executado, seguido por uma vírgula e o nome da função que retorna o valor: "meuScript;minhaFunção" Ao especificar o script do Python, omita a extensão do arquivo. A função chamada pode conter outras funções dentro do script ou de outros scripts. No entanto, todos os scripts executados devem ser colocados em uma pasta na variável de ambiente do sistema PYTHONPATH antes da execução. Para obter mais informações, consulte Configuração do Python para uso com o Analytics. Nota Sua PyFunção deve retornar um tipo numérico do Python.
decimal	numérico	O número de casas decimais a incluir no valor retornado. Deve ser um inteiro positivo.
campo\|valor <;...n> opcional	caractere numérico datahora lógico	Essa é uma lista de campos, expressões ou valores literais para usar como argumentos para a função do Python. Os valores são passados para a função chamada na ordem em que são especificados. Você pode incluir o número de argumentos necessário para atender à definição da função no script do Python. Nota Use a função ALLTRIM( ) para remover todos os espaços à esquerda ou à direita de entradas de caracteres: ALLTRIM(cadeia). Para obter mais informações, consulte Função ALLTRIM( ).

Nome

Tipo

Descrição

ArquivoPy; FunçãoPy

caractere

O nome do script do Python a ser executado, seguido por uma vírgula e o nome da função que retorna o valor:

"meuScript;minhaFunção"

Ao especificar o script do Python, omita a extensão do arquivo. A função chamada pode conter outras funções dentro do script ou de outros scripts. No entanto, todos os scripts executados devem ser colocados em uma pasta na variável de ambiente do sistema PYTHONPATH antes da execução.

Para obter mais informações, consulte Configuração do Python para uso com o Analytics.

Nota

Sua PyFunção deve retornar um tipo numérico do Python.

decimal

numérico

O número de casas decimais a incluir no valor retornado. Deve ser um inteiro positivo.

campo|valor <;...n>

opcional

caractere

numérico

datahora

lógico

Essa é uma lista de campos, expressões ou valores literais para usar como argumentos para a função do Python. Os valores são passados para a função chamada na ordem em que são especificados.

Você pode incluir o número de argumentos necessário para atender à definição da função no script do Python.

Nota

Use a função ALLTRIM( ) para remover todos os espaços à esquerda ou à direita de entradas de caracteres: ALLTRIM(cadeia). Para obter mais informações, consulte Função ALLTRIM( ).

Saída

Numérico.

Exemplos

Exemplos básicos

Retorna 35,00:

PYNUMERIC("hello,get_nth_percent"; 2; 80; 120; 30; 45; 30; 100; 35; 45)

Script externo do Python que retorna o valor no percentil solicitado de uma lista de valores dimensionada dinamicamente:

# conteúdo de hello.py
from math import ceil
def get_nth_percent(percentage, *values):
    input_length = len(values)
    position = ceil((percentage/100.00) * input_length)
    return values[position-1]

[ Voltar ao início ]

Guia de scripting do ACL 14.1