Skip to main content

Python tool Strumento Python

Strumento Phyton aggiornato

A partire dalla release 2026.1 di Designer, per lo strumento Python non è più disponibile la modalità interattiva.

Ora lo sviluppo Python è supportato tramite un modello di esecuzione orientato alla produzione. Questo ti consente di modificare gli script Python direttamente nello strumento o nel tuo IDE (Integrated Development Environment) preferito esterno prima di esegui i flussi di lavoro.

Requisiti dei ruoli utente

Ruolo utente*

Accesso a strumento/funzione

Utente completo

✓

Utente base

X

*Si applica ai clienti che utilizzano le edizioni Professional ed Enterprise di Alteryx One con Designer versione 2025.1 o successiva.

Lo strumento Python è un editor di codice per gli utenti Python. Dovresti essere esperto in Python prima di usare questo strumento. Dopo aver importato il pacchetto Alteryx Python con il comando from ayx import Alteryx, leggi l'articolo Funzioni Python di Alteryx per ottenere informazioni sulle funzioni utilizzabili in Designer tramite lo strumento Python.

Importante

Sebbene Designer accetti il codice Python del cliente, Alteryx non fornisce supporto per tale codice.

Esempio di uno strumento

Lo strumento presenta l'opzione Esempio di uno strumento. Vai a Esempi di flusso di lavoro per scoprire come accedere a questo e a molti altri esempi direttamente in Designer.

Introduzione

Per inserire o importare lo script Python, usa la finestra Configurazione strumento Python. Per ottenere assistenza durante la programmazione, consulta i riferimenti aggiuntivi disponibili nella pagina Funzioni Python di Alteryx.

Installazione dei pacchetti di data science necessari

Lo strumento Python include questi pacchetti di data science:

  • ayx: API Alteryx Python che interagisce con i flussi di lavoro e con il runtime di Designer.

  • ayx_python_sdk: SDK (Software Development Kit) Python per la creazione e l'estensione degli strumenti di Alteryx.

  • numpy: pacchetto base per i calcoli numerici e l'elaborazione di array in Python.

  • pandas: strutture di dati per l'analisi dei dati, le serie temporali e l'elaborazione delle tabelle.

  • scipy: libreria di calcolo scientifico utilizzabile per operazioni di ottimizzazione, statistiche, elaborazione di segnali e funzioni matematiche avanzate.

  • scikit-learn: libreria di Machine Learning utilizzabile per operazioni di classificazione, regressione, clustering e valutazione dei modelli.

  • statsmodels: libreria di modellazione statistica ed econometria utilizzabile per operazioni di regressione e verifica delle ipotesi.

  • pyarrow: libreria ad alte prestazioni utilizzabile per operazioni di elaborazione con dati strutturati in colonne interoperabilità con Apache Arrow (ad esempio, Parquet e IPC).

  • SQLAlchemy: astrazione di database e toolkit ORM (Object-Relational Mapping) per i database relazionali in Python.

  • pyodbc: connettore ODBC per i database enterprise.

  • requests: libreria HTTP per le chiamate di API e servizi web.

  • matplotlib: libreria per il tracciamento di grafici statici e visualizzazioni.

  • plotly: libreria di visualizzazione per dashboard e grafici interattivi.

  • plotly: libreria di visualizzazione per dashboard e grafici interattivi.

  • dash: framework per la creazione di applicazioni web analitiche in Python.

Installazione aggiuntiva del pacchetto

A seconda della versione di Designer in uso, puoi installare pacchetti aggiuntivi mediante la funzione Alteryx.installPackages. Ad esempio, per installare keras, usa il comando seguente:

from ayx import Package

Package.installPackages("keras")

puoi installare pacchetti Python aggiuntivi solo quando esegui Designer come amministratore. Gli utenti non amministratori non possono installare pacchetti Python aggiuntivi.

Configurazione dello strumento

Puoi usare la finestra Configurazione dello strumento Python per selezionare l'ambiente base e di inserire gli script Python.

Ambiente

Per selezionare l'ambiente base, usa il menu a tendina Ambiente. L'ambiente predefinito è DesignerBaseTools_vEnv.

Creazione di un ambiente personalizzato

Puoi anche creare un ambiente personalizzato da utilizzare nello strumento Python. Puoi specificare le dipendenze nell'ambiente personalizzato e configurare lo strumento Python per utilizzare l'ambiente. Ciò consente di importare rapidamente i pacchetti e offre un approccio più snello ed efficiente all'uso dello strumento Python in Designer.

Se desideri utilizzare un ambiente personalizzato, attieniti alle seguenti istruzioni:

  1. Vai a questa cartella (versione Amministratore di Designer):

    C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\share\jupyter\kernels

  2. Copia la cartella designerbasetools_venv.

  3. Rinomina la cartella copiata, assegnandole il nome desiderato per il nuovo kernel.

  4. Nella cartella rinominata, apri il file kernel.json.

  5. Modifica il valore di display_name,

    • Imposta il nome del kernel che vuoi visualizzare nel menu Ambiente della finestra di configurazione dello strumento Python.

    • In genere questo valore corrisponde al nome della cartella, ma non è obbligatorio.

  6. Non modificare i valori seguenti:

    • argv: Jupyter usa questo valore al fine di eseguire Python per l'ambiente. Per i test, non modificarlo.

    • language: lascia questo valore impostato su python.

    Esempio di file kernel.json:

    {
  "argv": [
    "C:\\Program Files\\Alteryx\\bin\\Python\\envs\\DesignerBaseTools_vEnv\\Scripts\\python.exe",
    "-m",
    "ipykernel_launcher",
    "-f",
    "{connection_file}"
  ],
  "display_name": "MyCustomEnv",
  "language": "python"
}

  7. Salva kernel.json e torna a Designer.

  8. Aggiorna l'elenco del kernel:

    • Fai clic all'esterno dello strumento Python, quindi riseleziona lo strumento.

    • Se il nuovo kernel non è visualizzato, chiudi e riapri Designer.

Utilizzo di un interprete Python diverso (opzionale)

Importante

Consigliamo di utilizzare uv per gestire l'ambiente Python personalizzato.

È possibile configurare l'ambiente personalizzato in modo da utilizzare un interprete Python diverso. In questo modo puoi utilizzare un ambiente Python completamente separato con i tuoi pacchetti installati. Per utilizzare un interprete Python diverso nell'ambiente personalizzato, attieniti alla seguente procedura:

  1. Apri kernel.json nella cartella kernel personalizzata.

  2. Aggiorna la prima voce nell'elenco argv per indicare il percorso file dell'eseguibile Python dell'ambiente personalizzato.

    Esempio di kenrel.json con la voce argv aggiornata:

    {
  "argv": [
    "C:\\Users\\<username>\\alteryx_envs\\myenv\\Scripts\\python.exe",
    "-m",
    "ipykernel_launcher",
    "-f",
    "{connection_file}"
  ],
  "display_name": "MyCustomEnv",
  "language": "python"
}

  3. Salva il file kernel.json e aggiorna l'elenco kernel in Designer.

    • Fai clic all'esterno dello strumento Python, quindi riseleziona lo strumento.

    • Se il nuovo kernel non è visualizzato, chiudi e riapri Designer.

Aggiunta del pacchetto AYX all'ambiente personalizzato

Importante

Se utilizzi un ambiente Python personalizzato, devi assicurarti che il pacchetto ayx sia disponibile. Il pacchetto ayx è necessario affinché lo strumento Python interagisca con il flusso di lavoro di Designer (ad esempio, lettura e scrittura dei dati).

Per aggiungere il pacchetto ayx all'ambiente personalizzato, attieniti alla seguente procedura:

  1. Individua il pacchetto ayx nell'ambiente predefinito:

    C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\Lib\site-packages\ayx

  2. Copia l'intera cartella ayx.

  3. Incolla la cartella nella directory dei site-packages dell'ambiente personalizzato:

    <your-env>\Lib\site-packages\

Il pacchetto ayx dipende da librerie aggiuntive che potrebbero non essere installate nell'ambiente personalizzato (ad esempio, pandas). La copia del pacchetto nell'ambiente personalizzato non installa automaticamente le dipendenze.

Installa eventuali dipendenze mancanti nell'ambiente personalizzato. Per esempio:

pip install pandas

Infine, per verificare che il pacchetto ayx sia stato installato correttamente, attiva l'ambiente ed esegui questo comando:

python -c "import ayx; print('ayx installed successfully')"

Script Python

Usa il campo Script Python nella finestra Configurazione per inserire o incollare il tuo script Python. Se lo desideri, puoi anche importare uno script. A tale scopo, seleziona Sovrascrivi script/notebook, quindi cerca il file dello script o del notebook, che deve avere estensione .py (script Python) o .ipynb (notebook Python).

Funzioni Python di Alteryx

Il pacchetto Alteryx eseguito tramite il comando from ayx import Alteryx offre numerose funzioni che consentono di scambiare dati fra Alteryx e Jupyter.

Per informazioni sulle funzioni disponibili, con le descrizioni e gli esempi relativi, vai a Funzioni Python di Alteryx.

Importante

Lo strumento Python considera i dati come un DataFrame Panda. Per ulteriori informazioni, consulta pandas.pydata.org.

Connessione ai dati del flusso di lavoro

Lo strumento Python accetta molteplici input. Dopo aver connesso gli input, puoi usare la funzione Alteryx.read per importare i dati del flusso di lavoro nello strumento, sotto forma di DsataFrame Pandas. A questo punto puoi usare Python per trasformare i dati e infine la funzione Alteryx.write per scrivere i dati di output restituiti dallo strumento Python.

Per l'elenco completo delle funzioni disponibili tramite la libreria Alteryx, consulta l'articolo Funzioni Python di Alteryx.

Note e limitazioni

Pandas String Dtype

Lo strumento Python di Alteryx Designer non supporta il tipo di "stringa" pandas. Consigliamo di utilizzare il tipo di "oggetto" standard che consente di scrivere correttamente i DataFrame.

IPython

In seguito agli aggiornamenti apportati allo strumento Python nella versione 2026.1, l'utilizzo delle funzionalità interattive di IPython non è più compatibile con il funzionamento previsto dello strumento Python in Designer.

La funzionalità IPython supporta principalmente l'esplorazione interattiva, che è meno rilevante nei flussi di lavoro di produzione esegui all'interno di Designer.

Di conseguenza:

  • Alteryx non manterrà la compatibilità con le funzionalità specifiche di IPython.

  • Il comportamento dei flussi di lavoro che dipendono dalla funzionalità IPython potrebbe cambiare, rispetto a quello mostrato nelle versioni anteriori alla 2026.1.

  • Se hai comunque bisogno di queste capacità, devi eseguire il codice all'esterno di Designer, in un ambiente IPython.

Lo strumento Python non carica script con Disabilita configurazione automatica

Se attivi l'opzione Disabilita configurazione automatica in Impostazioni utente, gli strumenti Python creati prima della versione 26.1 non caricano il contenuto dello script quando apri un flusso di lavoro precedente alla versione 26.1 nella versione di Designer 2026.1.

Per risolvere questo problema, disattiva l'opzione Disabilita configurazione automatica in Impostazioni utente, quindi riapri il flusso di lavoro. Ciò consente allo strumento di convertire e caricare il contenuto dello script.

  • Questo problema interessa solo gli strumenti Python creati prima della versione 2026.1 di Designer.

  • Il problema non si verifica quando l'opzione Disabilita configurazione automatica è disattivata (impostazione predefinita).

In questa sezione: