Skip to main content

Python integrado ao Alteryx

Visão geral

A plataforma Alteryx contém uma versão incorporada do Python para dar suporte a várias funções dos produtos. A versão no Alteryx não afeta outras versões que você possa ter instaladas em seu computador. Às vezes, é preciso atualizar essa versão do Python no Alteryx. Você pode ver essa atualização de versão refletida na ferramenta Python (Jupyter Notebook) e nas outras ferramentas que usam o SDK do Python no Alteryx. Os conectores de dados baseados em Python incluem Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive e Microsoft Dynamics CRM.

Compatibilidade com o Python no Alteryx

Versão do Alteryx

Versão do Python integrado

Ambiente virtual

2026.1

3.13.11

A ferramenta Python no Designer agora usa um ambiente virtual integrado em vez da configuração anterior baseada em Miniconda. Essa atualização simplifica o gerenciamento de dependências e reduz o tamanho dos arquivos relacionados ao Python durante a instalação.

Na versão 2025.2, o diretório miniconda3 herdado e todos os componentes conda restantes foram removidos, completando a transição para um ambiente mais simplificado e sustentável.

2025.1 (atualização estável)–2025.2

3.10.18

A ferramenta Python no Designer agora usa um ambiente virtual integrado em vez da configuração anterior baseada em Miniconda. Essa atualização simplifica o gerenciamento de dependências e reduz o tamanho dos arquivos relacionados ao Python durante a instalação.

Na versão 2025.2, o diretório miniconda3 herdado e todos os componentes conda restantes serão removidos, completando a transição para um ambiente sustentável mais simplificado.

2025.1

3.10.15

Padrão (Conda para o SDK v1)

Se seu fluxo de trabalho incluir referências ao diretório \Miniconda3\Envs\DesignerBaseTools_vEnv, ele precisará ser atualizado para usar o interpretador em \Python\Envs\DesignerBaseTools_vEnv para evitar que o fluxo de trabalho falhe.

2024.1 até 2024.2

3.10.13

Conda

2023.2

3.8.16

Conda

2020.4 até 2023.1

3.8.5

Conda

2019.3 até 2020.3

3.6.8

Conda

Anterior à 2019.3

3.6.0

Padrão

Perguntas frequentes sobre a atualização do Python 3.13 (Alteryx Designer e Server versão 2026.1)

Para obter detalhes relacionados à atualização do Python 3.13, acesse Perguntas frequentes sobre a atualização do Python 3.13 para obter informações relacionadas à atualização para o Python 3.13.11 (associada à versão 2026.1 do Alteryx Designer e Server).

Esta é uma iniciativa de produto que atualiza o Alteryx Designer e o Server do Python v3.8.16 para o Python v3.10.13. Isso ocorre porque o Python não é mais compatível com a v3.8. A Alteryx deve seguir para manter a conformidade com as medidas de segurança. A segurança é fundamental na Alteryx e devemos atualizar o Designer para o Python 3.10 até a versão 2024.1 (início de maio de 2024).

Todos os clientes que usam ferramentas do Designer que dependem do Python. Isso inclui conectores de dados, ferramentas do SDK criadas por parceiros, ferramentas do SDK personalizadas, a ferramenta Python e as ferramentas do Intelligence Suite.

As ferramentas do Designer que dependem do Python devem ser atualizadas para funcionar com o Python 3.10.13 ou elas não funcionarão no Designer e no Server 24.1.

Se você tiver uma ferramenta SDK do Python em seu fluxo de trabalho em uma versão anterior à versão 24.1 do Alteryx, essa versão da ferramenta SDK não funcionará com a versão 24.1. Para avançar, você precisa...

  • Instalar uma nova versão da ferramenta SDK que seja compatível com a versão 24.1.

  • Atualizar seu fluxo de trabalho para usar a nova versão da ferramenta.

  • Republicar o fluxo de trabalho no Alteryx Server.

Como os usuários podem querer testar fluxos de trabalho com ferramentas atualizadas, os clientes do Server que preferem testar novos fluxos de trabalho em um único ambiente sandbox podem querer criar um ambiente sandbox separado para testar a versão 24.1. Com um ambiente separado, você pode continuar os testes atuais do fluxo de trabalho com as ferramentas existentes (antes de migrar para a "Produção") e usar o novo ambiente para testar as novas ferramentas com a versão 24.1. Essa é uma configuração necessária, pois os conectores baseados em Python na versão 24.1 não funcionam com versões anteriores do Alteryx e vice-versa.

Sim, os usuários de sua ferramenta personalizada precisarão baixar e instalar a versão mais recente da ferramenta depois que você concluir a atualização do Python. Você pode publicar a versão mais recente da sua ferramenta na Galeria da Comunidade ou enviar uma atualização para o Alteryx Marketplace, se aplicável.

Vamos atualizar o Python do Designer da versão 3.8.16 para a 3.10.13 para a versão 2024.1, planejada para maio de 2024. Por isso, solicitamos que parceiros e clientes atualizem suas ferramentas do SDK para a versão 3.10.13 do Python antes de instalar o Alteryx Designer 2024.1.

As instruções de atualização passo a passo sobre como atualizar suas ferramentas para a versão 3.10.13 do Python estão disponíveis. Acesse Instruções para atualizar ferramentas personalizadas para o Python 3.10.

Em caso de perguntas adicionais, acesse o fórum de desenvolvedores do Alteryx IO e publique-as lá. Além disso, atualizaremos este documento regularmente à medida que mais materiais estiverem disponíveis.

As perguntas frequentes abaixo estão relacionadas à atualização para o Python 3.8.5 associada à versão 2020.4 do Alteryx Designer e Server.

  • Se você instalou uma ferramenta YXI personalizada em uma versão anterior do Designer, essa ferramenta não mais funcionará adequadamente devido a referências de versão Python incompatíveis dentro das dependências do módulo da ferramenta.

  • Também é possível que a ferramenta tenha dependências de módulo Python que não são mais compatíveis com a nova versão do Python, ou que use aspectos da linguagem Python que não têm mais suporte.

  • Script de atualização:

    Fornecemos um Script de atualização do Python incorporado para que você possa ver uma lista de ferramentas em sua máquina ou em seu servidor que podem ser afetadas. Esse script pode ser utilizado por usuários do Alteryx e por administradores do Server que estão considerando atualizar para a versão 2020.4 (e futuras), ou que já fizeram o upgrade e precisam de assistência para solucionar problemas em fluxos de trabalho que contenham ferramentas baseadas no SDK do Python.

  • Se você instalou uma ferramenta YXI personalizada e depois atualizou para o Designer 20.4, uma mensagem de erro irá alertá-lo sobre o problema e você não poderá executar um fluxo de trabalho que contenha essa ferramenta.

  • Isso afeta fluxos de trabalho em todos os produtos Alteryx.

  • Faça um inventário de todas as ferramentas e versões que você possui. Há dois caminhos de arquivo para encontrar essas informações dependendo da sua instalação.

    • Para instalações elevadas (em execução como administrador), navegue até Dados de programa (oculto) > Alteryx > Ferramentas.

    • Para instalações não elevadas, navegue até Usuários > [Usuário] > Dados de aplicativo (oculto) > Roaming > Alteryx > Ferramentas.

  • Há seis conectores de dados baseados em Python: Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive e Microsoft Dynamics CRM. Isso garante que você identifique qual versão precisará reinstalar. Talvez nem todos os conectores de dados falhem, mas recomendamos que você reinstale todas as versões de todos os conectores que tenham fluxos de trabalho ativos.

  • Se uma ferramenta não exigir nenhuma atualização para se tornar compatível com o Python 3.8, anote a versão e o local específicos da ferramenta. Certifique-se de localizar o pacote YXI da ferramenta antes de excluí-la, pois esse processo requer a reinstalação do pacote da ferramenta. Em seguida, recomendamos que você exclua o diretório da ferramenta e seus arquivos e, em seguida, reinstale o YXI para a ferramenta. Antes de reinstalar o YXI, não abra nenhum fluxo de trabalho que use a ferramenta, pois isso pode causar um comportamento desconhecido no fluxo.

  • Algumas ferramentas podem continuar a funcionar sem essa etapa, mas é altamente recomendado que você siga as instruções fornecidas aqui.

  • Você deve seguir essas instruções para todas as ferramentas em todas as máquinas, para todos os diretórios de instalação. Se você usa instalações de não administrador e de administrador, certifique-se de ter atualizado todos os possíveis locais em que a ferramenta está presente.

  • Se uma ferramenta exigir quaisquer atualizações para resolver diferenças de uso, problemas de dependência ou pacotes com novos arquivos WHL, você precisará receber uma nova ferramenta do desenvolvedor da ferramenta. Na maioria dos casos, esse tipo de ferramenta é criada por parceiros, mas também pode ser uma ferramenta mais antiga criada pela Alteryx ou até mesmo uma ferramenta encontrada na Comunidade ou na Galeria.

Não, atualizamos essas ferramentas como parte do esforço de atualização do Python. Elas devem funcionar automaticamente.

  • Você não deve notar nenhuma alteração na ferramenta Python nem na ferramenta Insights, que usam Python, mas não o SDK do Python. Porém, como os pacotes subjacentes estão sendo atualizados, como o pandas, pode haver alguns casos em que o código não é mais compatível com a versão do Python.

  • Você pode ter algum problema com seu código Python na ferramenta Python se ele usar uma funcionalidade para a qual não há mais suporte. Nesse caso, você precisa atualizar o código para ser compatível com o Python 3.8. Pode ter havido alterações entre as versões 3.7 e 3.8. Você pode encontrá-las nos links a seguir:

  • Você não deverá encontrar erros se: (1) tiver feito upload de um fluxo de trabalho com uma ferramenta baseada em SDK do Python da versão 20.3 para um Server atualizado para a 20.4, (2) o código subjacente for o mesmo e (3) você tiver corrigido seu fluxo de trabalho com a ferramenta baseada em Python reinstalando o mesmo arquivo YXI no Server. Todas as ferramentas baseadas em Python com fluxos de trabalho ativos devem ser reinstaladas no Server.

  • O fluxo de trabalho faz referência ao nome e à versão das ferramentas, não à versão do Python.

  • Se a ferramenta tiver sido reempacotada e uma nova versão tiver sido criada para dar suporte à 20.4, haverá incompatibilidades de versão entre as ferramentas, e a ferramenta precisará ser atualizada no Server ou no Designer.

  • Também atualizamos a versão do Python incorporada no Alteryx Analytics Hub para 3.8.5. Assim como no Server, as versões podem ser diferentes entre o Designer e o Alteryx Analytics Hub. Você precisará reinstalar o YXI se estiver usando um que tenha versões de dependência incompatíveis.

  • Se um usuário licenciou tanto o Alteryx Analytics Hub quanto o Alteryx Intelligence Suite, ele precisa instalar o Alteryx Analytics Hub para atualizar a partir da versão estável 20.2 e, em seguida, instalar o Alteryx Intelligence Suite usando o download da 20.4, disponível próximo ao AAH em downloads.alteryx.com. Depois disso, é preciso reinstalar os YXIs.

Sim. A versão do Python será incompatível com as versões 20.3 e anteriores, e com as 20.4 e posteriores. Independentemente de quando decidir atualizar, você precisa atualizar as ferramentas YXI para que elas sejam compatíveis.

Sim. Se você não reinstalar nenhuma ferramenta Python, poderá reverter para um estado anterior sem problemas. Depois de atualizar as ferramentas Python, você deve continuar esse processo para trocar as versões. Por exemplo, se você atualizar da 20.3 para a 20.4 e reinstalar o Salesforce, mas depois voltar para a 20.3, seria necessário reinstalar o Salesforce novamente.

  • Não. Se você usar ferramentas baseadas no SDK do Python, não. Se não usar, provavelmente não terá nenhum problema com múltiplas versões instaladas.

  • Você pode continuar a usar instalações de não administrador e de administrador da mesma versão do Alteryx.

Crie um ticket para o suporte ao cliente no link a seguir se precisar de mais assistência: https://community.alteryx.com/t5/Support/bd-p/SupportPage.

Perguntas frequentes para desenvolvedores Python

Recomendamos que os parceiros e criadores de ferramentas atualizem suas instalações locais e testem todas as ferramentas criadas. Elas podem usar módulos com versões que não são mais compatíveis com o Python 3.8 ou sintaxe que não é mais compatível.

Se sua ferramenta usa arquivos WHL, você precisa reempacotar a ferramenta com seus arquivos WHL em um ambiente Python 3.8 e republicar a ferramenta para que os usuários possam acessá-la.

Se um criador de ferramentas estiver usando o ayx-plugin-sdk versão Beta que foi atualizado para a 20.4, ele precisará atualizar esse pacote para a versão mais recente para que continue funcionando.

Vários módulos foram atualizados no Snakeplane para oferecer suporte ao Python 3.8.5, incluindo numpy e pandas. Em alguns casos, talvez seja necessário atualizar o Snakeplane para que suas ferramentas funcionem.