Integrando scripts Python

Você pode integrar scripts Analytics com scripts Python usando o comando ACLScript Python. O comando permite que você mova dados entre os dois ambientes, o que significa que um simples fluxo de trabalho de análise de dados no Analytics pode usar qualquer ambiente que seja mais adequado a uma tarefa particular.

Como funciona?

O comando Python passa uma tabela do Analytics para um script Python externo como um dataframe, aguarda enquanto o script Python é executado e em seguida, cria uma nova tabela no projeto do Analytics usando o resultado retornado do script Python. Você pode usar o comando Python tantas vezes quanto forem necessárias no decorrer de um script Analytics.

Duas funções do Pyhton estão incluídas na instalação do Analytics e você as usa no script Pytthon com dados de entrada e de saída:

• Dados de entrada acl_py_util.from_an() importa dados do Analytics para o Python

• Dados de saída acl_py_util.to_an() exporta dados do Python para o Analytics

Usando o comando Python com diferentes objetivos

O comando ACLScript Python oferece flexibilidade e pode ser usado com diferentes objetivos.

• Dados com processo de ida e volta Importe dados do Analytics para o Python, realize a análise no Python e exporte o resultado da análise de volta para o Analytics

• Enviar dados em uma direção Importe dados do Analytics para Python, realize a análise ou transformação do arquivo no Python e salve os resultados em um destino ou formato que arquivo que não seja do Analytics

• Enviar dados em uma direção Importe dados de uma fonte externa para o Python, realize a análise ou preparação do arquivo no Python e exporte os resultados para o Analytics

• Não transfira os dados No Analytics, acione o script Python para realizar uma tarefa associada ao fluxo de trabalho geral

Alinhando os scripts do Python e do Analytics

O comando ACLScript Python, e as duas funções de entrada e saída de dados, são relativamente simples de usar. No entanto, você deve ter certeza de que o comando ACLScript Python, e a lógica de script no script Python correspondente, estão alinhadas. A falta de alinhamento causa falha no processo de integração. A tabela a seguir oferece orientações.

Comando ACLScript Python	Script Python
Exporta dados	A função entrada de dados deve estar presente: acl_py_util.from_an()
Especifica que os dados são exportados com os nomes dos campos do Analytics	Qualquer nome de campo referenciado deve corresponder aos nomes de campo do Analytics
Especifica o script Python a ser executado	Deve haver um script Python com um nome correspondente e localização do caminho do arquivo
Especifica que uma tabela é retornada ao Analytics	A função saída de dados deve estar presente: acl_py_util.to_an()

Solução de problemas de uso de arquivos de log

O Analytics cria dois arquivos de log associados com o comando ACLScript Python. Os logs podem ajudar você a solucionar problemas de integração entre o Analytics e o Python, além de erros de depuração nos scripts Analytics e Python associados.

Os arquivos de log estão armazenados na pasta do projeto do Analytics:

• aclpython.log – registra mensagens de erro do Analytics quando o comando ACLScript Python falha

• acl_py_util.log – registra a saída de mensagens com informações do script Python

  acl_py_util.log é um log configurável incluído na instalação do Analytics. Para obter informações sobre como configurar e definir o log, consulte Configurar acl_py_util.log.

Execute um script Python

Use o comando ACLScript Python para executar um script Python do Analytics. A única informação necessária no comando é o caminho e o nome do arquivo do script Python que você deseja executar.

Esse comando permite que você exporte dados do Analytics para o script Python, ou retorne dados do script Python para o Analytics. No entanto, a transferência de dados não é obrigatória.

1. Caso você queira exportar dados do Analytics para um script Python, abra a tabela que contém os dados.

2. No menu principal do Analytics, selecione Analisar > Python.

3. No campo Python, especifique o caminho e o nome do arquivo do script Python que deseja executar.

   Por exemplo: C:\Python_data_analysis_scripts\testInOutput.py

   Você pode clicar em Procurar e navegar até o script Python no seu computador.

   Você pode especificar um caminho relativo ao script Python ou somente o nome do arquivo script, caso ele esteja em uma pasta do projeto do Analytics.

4. Se você está exportando dados para o Python, faça o seguinte:

   1. Clique em Selecionar campos e adicione um ou mais campos que serão incluídos no dataframe disponibilizado pelo Analytics no script Python.

      Dica

      Você também pode incluir expressões como campos no dataframe. Para criar uma expressão, clique em Expressão e use as funções, campos e operadores disponíveis na caixa de diálogo. Para obter mais informações, consulte Visão geral do Construtor de expressões.

   2. Opcional. Na seção Opções de exportação de dados, defina como você quer enviar os dados do Analytics para o script do Phyton.

      Para obter mais informações, consulte Opções de exportação de dados.

   3. Opcional. Para filtrar os registros enviados para o script do Phyton, clique em Se e use a caixa de diálogo Construtor de expressões para criar uma expressão condicional usada como filtro.

      Para mais informações sobre como criar expressões usando o Construtor de expressões, consulte Criar expressões usando o Construtor de expressões.

5. Se você está retornando dados do Python, faça o seguinte:

   1. Na caixa de texto Para, especifique um nome para a tabela que conterá os dados retornados.

      Você pode clicar em Para e usar o explorador de pastas para navegar até a pasta em que você quer armazenar o arquivo de dados de origem.

      Nota

      Os nomes de tabela do Analytics são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

   2. Selecione Usar tabela de saída se você quiser que a tabela seja aberta automaticamente após a conclusão da operação.

6. Opcional. Na guia Mais da caixa de diálogo, especifique as opções de escopo que deseja usar.

   Para obter mais informações, consulte Guia Mais.

7. Clique em OK para executar o comando.

   Se você obtiver uma mensagem de erro o comando Python, ou o script Python, falhar durante a execução, verifique se o valor Caminho Python na caixa de diálogo Opções está especificado corretamente. Para obter mais informações, consulte Adicione o caminho do ambiente virtual às Opções do Analytics.

Opções da caixa de diálogo PYCOMMAND

Opções de exportação de dados

Opção	Descrição
Exportar com nomes de campo	Use os nomes de campo da tabela do Analytics de origem como os nomes das colunas do dataframe do Python. Essa opção define a opção KEEPTITLE no comando e é obrigatória se você quiser recuperar dados usando nomes de coluna no script Python.
Separador de colunas	O caractere a ser usado como separador entre campos ao enviar dados para o Python.
Qualificador de Texto	O caractere a ser usado como qualificador de texto para identificar valores de campo ao enviar dados para o Python.

Guia Mais

Opção	Descrição
Tudo	Processa todos os registros na exibição (seleção padrão).
Primeiros	Processa a partir do primeiro registro na tabela e inclui apenas o número especificado de registros.
Próximo	Processa a partir do registro selecionado na tabela e inclui apenas o número especificado de registros. Nota O número de registros especificados nas opções Primeiros ou Próximos faz referência à ordem física ou indexada de registros em uma tabela e desconsidera qualquer filtro ou ordenação rápida aplicada na exibição. Entretanto, resultados de operações analíticas respeitam qualquer filtro. Se uma exibição for ordenada rapidamente, Próximos se comporta como Primeiros.
Enquanto	Usa uma instrução WHILE para limitar o processamento de registros na tabela principal com base em critérios. Os registros na exibição são processados somente enquanto a condição especificada avaliar como verdadeiro. Assim que a condição avaliar como falso, o processamento será encerrado e nenhum outro registro será considerado. Para obter mais informações, consulte Criar expressões usando o Construtor de expressões.