Alteryx Python incorporato
Panoramica
La piattaforma Alteryx include una versione incorporata di Python per supportare più funzioni nei suoi prodotti. La versione in Alteryx non interessa altre versioni che potrebbero essere installate sul computer. Periodicamente Alteryx richiede l'aggiornamento di tale versione di Python. È possibile che l'aggiornamento della versione si rifletta nello strumento Jupyter Python e in altri strumenti che utilizzano Alteryx Python SDK. I connettori dati basati su Python includono Salesforce, Google BigQuery, Archivio Microsoft Azure Data Lake, Microsoft Power BI, Microsoft OneDrive e Microsoft Dynamics CRM.
Compatibilità con Alteryx Python
Versione Alteryx | Versione Python incorporata | Ambiente virtuale |
|---|---|---|
2025.1 (aggiornamento stabile)-2025.2 | 3.10.18 | Lo strumento Python di Designer ora utilizza un ambiente virtuale integrato al posto della precedente configurazione basata su Miniconda. Questo aggiornamento semplifica la gestione delle dipendenze e riduce le dimensioni dei file Python durante l'installazione. Nella versione 2025.2, la directory legacy |
2025.1 | 3.10.15 | Standard (Conda per SDK v1) Se il tuo flusso di lavoro include riferimenti alla directory |
2024.1-2024.2 | 3.10.13 | Conda |
2023.2 | 3.8.16 | Conda |
2020.4-2023.1 | 3.8.5 | Conda |
2019.3–2020.3 | 3.6.8 | Conda |
Prima di 2019.3 | 3.6.0 | Standard |
È un'iniziativa di prodotto che prevede l'aggiornamento di Alteryx Designer e Server da Python v3.8.16 a Python v3.10.13, perché Python non fornisce più supporto per la versione 3.8 e Alteryx deve adeguarsi al fine di garantire la conformità alle misure di sicurezza. Per Alteryx la sicurezza ha la massima priorità ed è necessario aggiornare Designer a Python 3.10 entro la release 2024.1 (rilasciata all'inizio di maggio 2024).
Tutti i clienti che utilizzano strumenti di Designer dipendenti da Python, come i connettori dati, gli strumenti dell'SDK realizzati dai partner, gli strumenti dell'SDK personalizzati, lo strumento Python e gli strumenti di Intelligence Suite.
Gli strumenti di Designer che dipendono da Python devono essere aggiornati in modo da utilizzare Python 3.10.13, altrimenti non funzioneranno nella release 24.1 di Designer e Server.
Se il flusso di lavoro utilizza uno strumento di una versione di Python SDK anteriore a quella delle release 24.1 di Alteryx, tale versione dello strumento non funzionerà con la release 24.1. Per poter procedere, devi...
Installare una versione più recente dello strumento basato sull'SDK, che sia compatibile con la release 24.1.
Aggiornare il flusso di lavoro in modo che utilizzi la versione più recente dello strumento.
Ripubblicare il flusso di lavoro su Alteryx Server.
Al fine di consentire agli utenti di testare i flussi di lavoro con gli strumenti aggiornati, i clienti che utilizzano Server e preferiscono testare i nuovi flussi di lavoro in un singolo ambiente sandbox dovrebbero creare un ambiente sandbox separato per i test della release 24.1. In questo modo, è possibile continuare a utilizzare gli strumenti preesistenti per eseguire i test dei flussi di lavoro attuali (prima di migrarli all'ambiente di produzione) e sfruttare il nuovo ambiente per testare i nuovi strumenti con la release 24.1. Questa configurazione è necessaria perché i connettori basati su Python della release 24.1 non funzionano con le versioni precedenti di Alteryx e viceversa.
Sì, dopo che avrai completato l'aggiornamento di Python, gli utenti del tuo strumento personalizzato devono scaricare e installare la versione più recente di tale strumento. Puoi pubblicare la nuova versione del tuo strumento nella Gallery della Community o inviare un aggiornamento ad Alteryx Marketplace, se applicabile.
Per la release 2024.1, che verrà rilasciata a maggio 2024, la versione di Python disponibile in Designer verrà aggiornata dalla 3.8.16 alla 3.10.13. Per tale motivo, chiediamo ai partner e ai clienti di aggiornare i loro strumenti basati sull'SDK alla versione 3.10.13 di Python prima di installare Alteryx Designer 2024.1.
Sono disponibili istruzioni passo passo che spiegano come aggiornare i tuoi strumenti alla versione 3.10.13 di Python. Vai a Istruzioni per l'aggiornamento degli strumenti personalizzati a Python 3.10.
Se vuoi porre ulteriori domande, puoi pubblicarle nel forum per gli sviluppatori di Alteryx IO. Inoltre, noi provvediamo anche ad aggiornare regolarmente il presente documento, a mano a mano che si rendono disponibili ulteriori materiali.
Le domande frequenti che seguono si riferiscono all'upgrade di Python alla versione 3.8.5, associata alle release 2020.4 di Alteryx Designer e Server.
Se hai installato gli strumenti personalizzati YXI in una versione precedente di Designer, questo strumento non funziona più correttamente a causa di riferimenti di versione Python incompatibili all'interno delle dipendenze del modulo dello strumento.
Inoltre, è possibile che le dipendenze dello strumento dal modulo Python non siano più compatibili con la nuova versione Python, o che utilizzino aspetti del linguaggio Python che non sono più supportati.
Script di aggiornamento:
Abbiamo fornito uno script di aggiornamento Python incorporato, che consente di visualizzare l'elenco degli strumenti potenzialmente interessati presenti sul tuo computer o sul server. Questo script può essere utilizzato dagli utenti Alteryx e dagli amministratori del server che stanno considerando di eseguire l'aggiornamento alla versione 2020.4 (e versioni successive) o lo hanno già fatto e necessitano di assistenza per la risoluzione dei problemi dei flussi di lavoro contenenti strumenti basati su Python SDK.
Se in precedenza sono stati installati gli strumenti personalizzati YXI e sono stati aggiornati a Designer 20.4, viene visualizzato un messaggio di errore che indica il problema e non è possibile eseguire un flusso di lavoro che contiene tale strumento.
Ciò influisce sui flussi di lavoro di tutti i prodotti Alteryx.
Ti consigliamo di tenere un inventario di tutti gli strumenti e le versioni disponibili. Esistono due percorsi di file per trovare queste informazioni, a seconda dell'installazione.
Per le installazioni con privilegi elevati (eseguite come amministratore), accedi a Dati programma (nascosto) > Alteryx > Strumenti.
Per le installazioni con privilegi non elevati, accedi a Utenti > [Utente] > Dati app (nascosto) > Roaming > Alteryx > Strumenti.
Sono disponibili sei connettori dati basati su Python: Salesforce, Google BigQuery, Archivio Microsoft Azure Data Lake, Microsoft Power BI, Microsoft OneDrive e Microsoft Dynamics CRM. In questo modo, è possibile tenere traccia della versione da reinstallare. Anche se tutti i connettori dati potrebbero non fallire, si consiglia vivamente di reinstallare ogni versione di ciascun connettore che ha flussi di lavoro attivi.
Se uno strumento non richiede alcun aggiornamento per essere compatibile con Python 3.8, prendi nota della versione e della posizione dello strumento specifico. Assicurati di poter individuare il pacchetto YXI per lo strumento prima di eliminarlo, poiché questo processo richiede la reinstallazione del pacchetto dello strumento. Quindi, ti consigliamo di eliminare la directory dello strumento e i relativi file, quindi reinstallare YXI per lo strumento. Prima di reinstallare YXI, non aprire alcun flusso di lavoro che utilizza lo strumento perché potrebbe causare comportamenti sconosciuti nel flusso di lavoro.
Alcuni strumenti potrebbero continuare a funzionare senza eseguire questo passaggio, ma ti consigliamo vivamente di seguire le istruzioni fornite qui.
È necessario seguire queste istruzioni per ogni strumento su ciascun computer, per ogni directory di installazione. Se utilizzi installazioni con privilegi non amministrativi e amministrativi, assicurati di aver aggiornato tutte le posizioni possibili in cui esiste lo strumento.
Se uno strumento richiede aggiornamenti per risolvere le differenze di utilizzo, i problemi di dipendenza o i pacchetti con nuovi file WHL, è necessario ricevere un nuovo strumento dallo sviluppatore dello strumento. Nella maggior parte dei casi, si tratta di uno strumento creato da un partner, ma potrebbe anche essere uno strumento meno recente creato da Alteryx oppure uno strumento disponibile nella Community o nella Gallery.
No, abbiamo aggiornato questi strumenti nell'ambito dell'aggiornamento Python. Dovrebbero funzionare automaticamente.
Non si dovrebbero notare cambiamenti nello strumento Python o nello strumento Insights, che utilizzano entrambi Python ma non Python SDK. Tuttavia, poiché i pacchetti sottostanti vengono aggiornati, come pandas, potrebbero verificarsi casi in cui il codice non è più compatibile con la versione Python.
Potrebbe verificarsi un problema con il codice Python nello strumento Python se utilizza funzionalità non più supportate. In questo caso, è necessario aggiornare il codice per essere compatibile con Python 3.8. Potrebbero essere state apportate modifiche tra la versione 3.7 e 3.8. Entrambe sono collegate qui:
Non si dovrebbe riscontrare un errore se (1) è stato caricato un flusso di lavoro con uno strumento basato su Python SDK dalla versione 20.3 su un server che è stato aggiornato alla 20.4, (2) il codice sottostante è lo stesso e (3) è stato corretto il flusso di lavoro dello strumento basato su Python reinstallando lo stesso file YXI sul server. Tutti gli strumenti basati su Python con flussi di lavoro attivi devono essere reinstallati sul server.
Il flusso di lavoro fa riferimento al nome e alla versione di uno strumento, non alla versione di Python.
Se lo strumento è stato convertito e viene creata una nuova versione per supportare la 20.4, tra gli strumenti saranno presenti incompatibilità di versione e lo strumento dovrà essere aggiornato in Server o Designer.
Abbiamo anche aggiornato la versione integrata di Python in Alteryx Analytics Hub alla versione 3.8.5. Come per Server, la versione può essere diversa tra Designer e Alteryx Analytics Hub. È necessario reinstallare YXI se si utilizza una versione con dipendenze incompatibili.
Se un utente ha concesso in licenza sia Alteryx Analytics Hub che Alteryx Intelligence Suite, deve installare Alteryx Analytics Hub per eseguire l'aggiornamento dalla versione stabile 20.2, quindi installare Alteryx Intelligence Suite utilizzando il download 20.4, disponibile accanto ad AAH su downloads.alteryx.com. Successivamente, reinstallare i file YXI.
Sì. La versione di Python non sarà compatibile con la versione 20.3 e precedenti e con la versione 20.4 e successive. Indipendentemente dal momento dell'aggiornamento, è necessario aggiornare gli strumenti YXI per essere compatibili.
Sì. Se non reinstalli alcuno strumento Python, dovresti poter tornare a uno stato precedente senza problemi. Dopo aver aggiornato gli strumenti Python, è necessario continuare il processo per passare da una versione all'altra. Ad esempio, se dovessi eseguire l'aggiornamento da 20.3 a 20.4 e reinstallare Salesforce, ma poi tornare alla 20.3, dovrai reinstallare Salesforce.
No, non se utilizzi strumenti basati su Python SDK. In caso contrario, molto probabilmente non si verificheranno problemi se sono installate più versioni.
È possibile continuare a utilizzare installazioni non amministrative e amministrative della stessa versione di Alteryx.
L'installazione sarà eseguita correttamente. Il problema che si potrebbe verificare è che qualsiasi strumento basato su Python non installato non funzionerà sulla versione 20.4 fino a quando non verrà aggiornato. Una volta aggiornati, gli strumenti non funzioneranno più per l'installazione che non è basata su Python 3.8 (versioni di Alteryx precedenti alla 20.4).
Per ulteriori informazioni su come installare più versioni sul computer, visita la pagina Web https://community.alteryx.com/t5/Alteryx-Designer-Knowledge-Base/How-to-install-two-versions-of-Designer-on-the-same-machine/ta-p/454948.
Crea un ticket di assistenza clienti al seguente URL se necessiti di ulteriore supporto:https://community.alteryx.com/t5/Support/bd-p/SupportPage.
Domande frequenti per gli sviluppatori Python
Si consiglia ai partner e ai creatori di strumenti di aggiornare le proprie installazioni locali e testare tutti gli strumenti creati. Potrebbero usare moduli con versioni che non sono più compatibili con Python 3.8 o una sintassi che non è più supportata.
Se lo strumento utilizza file WHL, è necessario ricompilarlo con i suoi file WHL in un ambiente Python 3.8, quindi ripubblicarlo per consentire agli utenti di accedervi.
I creatori di strumenti che utilizzano la release Beta di ayx-plugin-sdk, che è stata aggiornata per la release 20.4, devono aggiornare tale pacchetto alla versione più recente, per garantire che continui a funzionare.
Più moduli sono stati aggiornati in Snakeplane per supportare Python 3.8.5, inclusi numpy e pandas. In alcuni casi, potrebbe essere necessario aggiornare Snakeplane affinché gli strumenti funzionino.