Skip to main content

Python tool Strumento Python

Strumento Phyton aggiornato

A partire dalla release 2026.2 di Designer, lo strumento Python funziona in modo nativo con AMP Engine.

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 avere una buona padronanza di Python prima di utilizzare questo strumento. Dopo aver importato il pacchetto Alteryx Python tramite from ayx import Alteryx, consulta Funzioni Python di Alteryx per informazioni sulle funzioni che puoi utilizzare tramite lo strumento Python in Designer.

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.

Configura lo strumento

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

Ambiente

Utilizza l'elenco a discesa Ambiente per selezionare l'environment di base. L'environment 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.

    • Il nome visualizzato non deve corrispondere al nome della cartella che contiene l'ambiente personalizzato.

  6. Non modificare i valori seguenti:

    • argv: Jupyter lo utilizza per eseguire Python per l'environment. 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 la directory wheels nell'environment predefinito:

    C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\wheels

  2. Copia l'intera cartella ayx.

    pip install ayx --find-links "C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\wheels"

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

Utilizza il campo Python Script della Finestra Configurazione per immettere o incollare lo script Python. Puoi anche importare uno script. Sono disponibili diverse opzioni per lavorare nell'editor di script:

  • Find and Replace: Use the find and replace icon to search and replace content in your script.

    • Immetti il testo nel campo Cerca e personalizza i criteri di ricerca:

      • Match Case (Alt + C): Only find text that matches the case of the input text. Find "read", not "READ".

      • Match Whole Word (Alt + W): Only find whole words (don't return words that include the input text). For example, find "data", not "DataFrame".

      • Use Regular Expression (Alt + R): Input a regular expression to customize your search criteria.

      • Utilizza le frecce su e giù per scorrere le corrispondenze.

      • Trova nella selezione (Alt + L): Seleziona per trovare nella riga corrente.

    • Immetti il testo nel campo Replace per sostituire il testo immesso nel campo Trova.

      • Preserve Case (Alt + P): Preserve the case of the found text when replacing.

      • Replace (Invio): sostituisce un'occorrenza del testo trovato con il testo nel campo Replace.

      • Replace All (Ctrl + Alt + Enter): Replace all instances of the found text with the text in the Replace field.

  • Copia: Seleziona l'icona di copia per copiare l'intero contenuto corrente dell'editor, incluse le modifiche apportate dall'ultimo salvataggio del flusso di lavoro.

  • Commenta e Rimuovi commento: Seleziona l'icona # per commentare o rimuovere il commento dalla riga corrente o dalle righe selezionate non vuote senza modificare il rientro.

  • Import: Select to import a Python script and browse to your script or notebook file. The file must be a .py (Python script) or .ipynb (Python notebook) extension.

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 Pandas. Per ulteriori informazioni, vai a 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).