Strumento Python
Versione:
2023.1
Last modified: May 30, 2023
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, eseguire Alteryx.helpper informazioni sulle funzioni utili:
from ayx import AlteryxAlteryx.help()
Anche se Designer accetta codice Python personalizzato, Alteryx non fornisce il supporto per il codice Python personalizzato.
Compatibilità della galleria pubblica Alteryx
Avete intenzione di pubblicare il vostro flusso di lavoro su gallery.alteryx.com? In primo luogo, richiedere un'esenzione. Questa restrizione non si applica alle istanze private di Alteryx Server e Alteryx Gallery.
Inizia
La finestra di configurazione dello strumento Python è simile al notebook di Jupyter. Se non si ha familiarità con notebooks di Jupyter,passare a Guida> Tour dell'interfaccia utente o Guida>Guida di Notebook. Per assistenza codice, vedere i riferimenti aggiuntivi nellaGuida.
Anche se lo strumento imita l'interfaccia Jupyter Notebook, alcune opzioni potrebbero comportarsi in modo diverso da quello previsto.
Installare i pacchetti di data science necessari
Lo strumento Python include questi pacchetti di data science:
- ayx: Alteryx API
- jupyter: metapacchetto Jupyter
- matplotlib:pacchetto del tracciato Python
- numpy: NumPy, elaborazione di matrici per numeri, stringhe, record e oggetti
- panda: potenti strutture di dati per l'analisi dei dati, serie temporali e statistiche
- richieste: HTTP per gli esseri umani
- scikit-learn: un set di moduli Python per l'apprendimento automatico e il data mining
- scipy: SciPy, libreria scientifica per Python
- six: utilità compatibili con Python 2 e 3
- SQLAlchemy: raccolta di astrazioni di database
- statsmodels: calcoli statistici e modelli per Python
Installazione aggiuntiva del pacchetto
A seconda della versione di Designer in uso, è possibile installare pacchetti aggiuntivi con la funzione Alteryx.installPackages. Ad esempio, installare keras:
Python
from ayx import Package
Package.installPackages("keras")
È possibile installare pacchetti Python aggiuntivi solo se si esegue Designer come amministratore. Gli utenti non amministratori non possono installare pacchetti Python aggiuntivi.
Collegare gli Input
Lo strumento Python accetta molteplici input. Dopo aver connesso gli input, è necessario eseguire il flusso di lavoro per memorizzare nella cache i flussi di dati in ingresso. Per accedere a una connessione dati in ingresso, attenersi alla seguente procedura:
Importare la libreria Alteryx:
Python
from ayx import Alteryx
Accedere alla connessione e fornire una variabile da utilizzare come riferimento dati:
Python
# Use the method this method to read data from the reference. Replace "CONNECTION_NAME" with the name of your connection.
data1 = Alteryx.read("CONNECTION_NAME")
# Read in all connections and reference the returned zero-index array. Replace "INDEX_NUMBER" with the appropriate index number from the array.
Alteryx.read(Alteryx.getIncomingConnectionNames()[INDEX_NUMBER])
Eseguire il flusso di lavoro prima di iniziare a lavorare con lo strumento Python. In questo modo i dati vengono memorizzati nella cache e resi accessibili allo strumento.
Lo strumento Python considera i dati come un DataFrame Panda. Per ulteriori informazioni, visitare pandas.pydata.org.
Configurare lo strumento
Impostare la modalità di esecuzione del flusso di lavoro
È possibile utilizzare due modalità per lavorare con lo strumento Python:
- Utilizzare la modalità Interattivaper avviare lo sviluppo.
- Utilizzare la modalità Produzioneper migliorare la velocità quando è stato completato lo sviluppo e si desidera eseguire il codice tramite un interprete Python standard.
Modalità interattiva
Fare clic sul pulsante Interattivo. Utilizzare questa modalità per lo sviluppo. Questa modalità consente di interagire con i dati in ingresso tramite Jupyter Notebook senza dover rieseguire il flusso di lavoro per visualizzare i risultati del codice.
Quando si esegue il flusso di lavoro, Designer esegue le attività seguenti:
- Designer memorizza nella cache una copia dei dati in ingresso e li rende disponibili allo strumento Python.
- Shell di Jupyter esegue il codice nel notebook.
- Se il codice chiama il metodo , shell di Jupyter invia i risultati tramite gli ancoraggi di output.
- Jupyter notebook visualizza tutti gli errori, gli avvisi e le istruzioni di stampa, proprio come quando si seleziona Esegui tutto.
Modalità di produzione
Fare clic sul pulsanteProduzione. Utilizzare questa modalità per i modelli in produzione. In questa modalità, Designer consolida tutte le celle Python da Jupyter Notebook in un unico script di sola lettura. Designer passa lo script all'interprete Python.
Quando si esegue il flusso di lavoro, Designer esegue le attività seguenti:
- Ignora shell Jupyter, quindi esegue lo script di sola lettura tramite un interprete Python standard.
- Non visualizza errori, avvisi e rendiconti di stampa.
Per modificare lo script della modalità Produzione, fare clic su modalitàInterattiva, poi modificare le celle nel Jupyter Notebook. Dopo aver completato le modifiche, fare clic su modalità Produzione.
Impostare il formato di archiviazione dei dati
Lo strumento Python ha due opzioni di formato: SQLite e YXDB.
SQLite
- Fate clic sul menu Alteryxnella finestra di configurazione dello strumento Python.
- Selezionare sostituisci SQlite.
YXDB
Seguire questi passaggi per utilizzare il formato di archiviazione dati YXDB.
- Fate clic sul menu Alteryxnella finestra di configurazione dello strumento Python.
- Deselezionare Sostituzione Sqliteper rimuovere il segno di spunta.
| SQLite | YXDB | |
|---|---|---|
| Blob | Supporto | Supporto |
| Oggetti spaziali | Supporto | Passare oggetti spaziali tra lo strumento Python e altri strumenti. Usare i contrassegni dei metadati quando si crea output di oggetti spaziali dallo strumento Python. |
| Limitazione delle colonne | Il limite è 2000 | Senza limiti |
| Nota sui valori nulli | Supporto | Designer converte colonne numeriche o byte nel tipo di dati float64, ad esempio float di precisione doppia. |
Se non si modifica la disposizione delle righe o se si utilizza GeoSpatial Python, Alteryx consiglia di tagliare i dati GeoSpatial dal set di dati e di aggiungerli nuovamente dopo lo strumento Python. La ragione di ciò è la conversione dal testo e verso il testo binario e geo spaziale è lenta
Importare un file o una directory
È possibile importare un file o una directory in due modi:
- Utilizzate la funzione importa nel menu Alteryxper importare singoli script Python o Jupyter Notebook.
- Utilizzare il comando importa per importare una directory.
Seguire questi passaggi per importare uno script Python o Jupyter Notebook con la funzione d'importazione:
- Fare clic sul menu Alteryx.
- Selezionare Importa script.
- Fare clic su Scegli file.
- Selezionare unfile .py o .ipynb e selezionareImporta.
Utilizzare il menu Kernel
Emettere qualsiasi di questi comandi dal menu Kernel:
- Per interrompere l'elaborazione selezionare Interrompi.
- Per riavviare l'elaborazione selezionare Riavvia.
- Per cancellare la cartella di lavoro dei risultati immediati selezionare Riconnetti.
- Il kernel di modifica non fornisce funzionalità.
- Alteryx consiglia di non selezionare Arresta.
Seguire le pratiche migliori
Queste procedure consigliate consentono di utilizzare correttamente lo strumento Python:
Utilizzare il metodo Alteryx.getWorkflowConstantquando si fa riferimento a una costante del flusso di lavoro, ad esempio Engine.WorkflowDirectory. In caso contrario, il risultato o l'output del comando sostituisce in modo permanente il comando nel proprio Jupyter Notebook quando si esegue il codice.
Evitare di utilizzare i wrapper %nelle costanti del flusso di lavoro. Invece, ad esempio, utilizzare questa opzione per chiamare il Engine.WorkflowDirectory:
from ayx import Alteryx
Alteryx.getWorkflowConstant("Engine.WorkflowDirectory")
Output dei dati dallo strumento
Utilizzare il metodo Alteryx.writeper restituire i dati dallo strumento.
Per inviare dati ad altri strumenti nell'area di disegno, usa il metodo in questo modo:
Python
# Replace "PANDAS_DF" with your data, in DataFrame form.
# Replace "OUTPUT_ANCHOR_NUM" with the number of your output anchor.
Alteryx.write(PANDAS_DATAFRAME, OUTPUT_ANCHOR_NUM)
Il metodo Alteryx.writeaccetta solo Pandas DataFrames. Se si dispone di dati in un altro formato, utilizzare la libreria Pandas per convertirlo in un DataFrame. La libreria Pandas è già installata come parte di Designer. Puoi accedervi nel Jupyter Notebook con import pandas.
È possibile inviare fino a cinque DataFrame agli ancoraggi di output.