Skip to main content

Alteryx integriertes Python

Überblick

Die Alteryx-Plattform enthält eine integrierte Python-Version zur Unterstützung mehrerer Funktionen der Produkte. Die Version in Alteryx hat keinen Einfluss auf andere Versionen, die Sie möglicherweise auf Ihrem Computer installiert haben. Alteryx muss diese Version von Python von Zeit zu Zeit aktualisieren. Möglicherweise wird diese Versionsaktualisierung im Jupyter Python-Tool und anderen Tools angezeigt, die das Alteryx Python SDK verwenden. Zu den Python-basierten Datenkonnektoren gehören Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive und Microsoft Dynamics CRM.

Alteryx Python-Kompatibilität

Alteryx-Version

Integrierte Python-Version

Virtuelle Umgebung

2025.1 (Stable Update) and Newer

3.10.18

The Python tool in Designer now uses a built-in virtual environment instead of the previous Miniconda-based setup. This update simplifies dependency management and reduces the size of Python-related files during installation.

In version 25.2, the legacy miniconda3 directory and all remaining conda components will be removed, completing the transition to a more streamlined and maintainable environment.

2025.1

3.10.15

Standard (Conda for v1 SDK)

If your workflow includes references to the \Miniconda3\Envs\DesignerBaseTools_vEnv directory, it needs to be updated to use the interpreter in \Python\Envs\DesignerBaseTools_vEnv to prevent the workflow from failing.

Ab 2024.1*

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

Vor 2019.3

3.6.0

Standard

Häufig gestellte Fragen zum Python 3.10 Upgrade (Alteryx Designer- und Server-Version 2024.1)

Haftungsausschluss

Wir werden dieses Dokument monatlich aktualisieren, sobald weitere Informationen verfügbar sind.

Dies ist eine Produktinitiative, die Alteryx Designer und Server von Python v3.8.16 auf Python v3.10.13 aktualisiert. Dies liegt daran, dass Python v3.8 nicht mehr unterstützt. Alteryx muss hinterherziehen, um die Sicherheitsmaßnahmen einzuhalten. Die Sicherheit ist bei Alteryx von höchster Priorität, und wir müssen Designer bis zur Version 2024.1 (Anfang Mai 2024) auf Python 3.10 aktualisieren.

Alle Kunden, die Designer-Tools verwenden, die auf Python basieren. Dazu gehören Datenkonnektoren, von Partnern erstellte SDK-Tools, benutzerdefinierte SDK-Tools, das Python-Tool und Intelligence Suite-Tools.

Designer-Tools, die auf Python basieren, müssen auf Python 3.10.13 aktualisiert werden, da sie andernfalls in Designer und Server 24.1 nicht funktionieren werden.

Wenn Sie ein Python-SDK-Tool in Ihrem Workflow in einer Alteryx-Version vor 24.1 haben, funktioniert diese Version des SDK-Tools nicht mit 24.1. Um fortzufahren, müssen Sie:

  • eine neue Version des SDK-Tools installieren, die mit 24.1 kompatibel ist.

  • Aktualisieren Sie Ihren Workflow, um die neue Version des Tools zu verwenden.

  • Veröffentlichen Sie den Workflow erneut auf Alteryx Server.

Da Benutzer:innen Workflows mit aktualisierten Tools testen möchten, sollten Server-Kund:innen, die neue Workflows bevorzugt in einer einzigen Sandbox-Umgebung testen möchten, möglicherweise eine separate Sandbox-Umgebung zum Testen von 24.1 erstellen. Mit einer separaten Umgebung können Sie die aktuellen Workflow-Tests mit vorhandenen Tools (vor der Migration zur Produktion) fortsetzen und die neue Umgebung verwenden, um neue Tools mit 24.1 zu testen. Diese Einrichtung ist erforderlich, da Python-basierte Konnektoren der Version 24.1 nicht mit früheren Alteryx-Versionen kompatibel sind und umgekehrt.

Ja, Benutzer:innen Ihres benutzerdefinierten Tools müssen die neueste Version Ihres Tools herunterladen und installieren, nachdem Sie das Python-Upgrade abgeschlossen haben. Sie können gegebenenfalls die neueste Version Ihres Tools in der Community Gallery veröffentlichen oder ein Update an Alteryx Marketplace senden.

Wir werden die Python-Version von Designer von 3.8.16 auf 3.10.13 für die Version 2024.1 aktualisieren, die für Mai 2024 geplant ist. Deshalb bitten wir unsere Partner:innen und Kund:innen, ihre SDK-Tools vor der Installation von Alteryx Designer 2024.1 auf die Python-Version 3.10.13 zu aktualisieren.

Wenn Sie weitere Fragen haben, können Sie diese im Alteryx IO Developer Forum veröffentlichen. Wir werden dieses Dokument außerdem regelmäßig aktualisieren, da weitere Materialien verfügbar sind.

Häufig gestellte Fragen zum Python 3.8.5-Upgrade (Alteryx Designer- und Server-Version 2020.4)

Die folgenden häufig gestellten Fragen beziehen sich auf das Upgrade auf Python 3.8.5 im Zusammenhang mit der Version 2020.4 von Alteryx Designer und Server.

  • Wenn Sie benutzerdefinierte YXI-Tools in einer früheren Version von Designer installiert haben, funktioniert dieses Tool nicht mehr ordnungsgemäß. Das liegt an inkompatiblen Python-Versionsverweisen innerhalb der Tool-Modul-Abhängigkeiten.

  • Es ist auch möglich, dass das Tool Python-Modul-Abhängigkeiten aufweist, die nicht mehr kompatibel sind, oder Aspekte der Python-Sprache verwendet, die in der neuen Python-Version nicht mehr unterstützt werden.

  • Upgrade-Skript:

    Wir haben ein Skript zum Upgrade der integrierten Python-Version zur Verfügung gestellt, mit dem Sie eine Liste der Tools sehen können, die sich auf Ihren Rechner oder Server auswirken könnten. Dieses Skript kann sowohl von Alteryx-Benutzern als auch von Server-Administratoren verwendet werden, die ein Upgrade auf 2020.4 (und zukünftige Versionen) in Erwägung ziehen oder dieses bereits durchgeführt haben und Unterstützung bei der Fehlerbehebung von Workflows benötigen, die auf Python SDK basierende Tools enthalten.

  • Wenn Sie zuvor benutzerdefinierte YXI-Tools installiert und auf Designer 20.4 aktualisiert haben, werden Sie durch eine Fehlermeldung auf das Problem aufmerksam gemacht, und Sie können keinen Workflow ausführen, der das jeweilige Tool enthält.

  • Dies wirkt sich auf die Workflows aller Alteryx-Produkte aus.

  • Nehmen Sie eine Bestandsaufnahme all Ihrer Tools und Versionen vor. Es gibt je nach Ihrer Installation zwei Dateipfade, um diese Informationen zu finden.

    • Navigieren Sie bei Installationen mit erhöhten Berechtigungen (die als Administrator ausgeführt werden) zu Program Data (versteckt) > Alteryx > Tools.

    • Navigieren Sie bei Installationen ohne erhöhte Berechtigungen zu Users > [Benutzername] > App Data (versteckt) > Roaming > Alteryx > Tools.

  • Es gibt sechs Python-basierte Datenkonnektoren: Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive und Microsoft Dynamics CRM. Dadurch wird sichergestellt, dass Sie jederzeit wissen, welche Version Sie neu installieren müssen. Auch wenn nicht alle Datenkonnektoren fehlschlagen, empfehlen wir dringend, jede Version jedes Konnektors, der aktive Workflows hat, neu zu installieren.

  • Wenn ein Tool keine Aktualisierung benötigt, um mit Python 3.8 kompatibel zu sein, notieren Sie sich die spezifische Tool-Version und den Speicherort. Stellen Sie sicher, dass Sie das YXI-Paket für das Tool vor dem Löschen des Tools finden können, da dieser Vorgang eine Neuinstallation des Tool-Pakets erfordert. Dann empfehlen wir, dass Sie das Tool-Verzeichnis und die enthaltenen Dateien löschen und anschließend die YXI für das Tool neu installieren. Öffnen Sie vor der Neuinstallation der YXI keine Workflows, die das Tool verwenden, da dies zu einem unbekannten Verhalten im Workflow führen könnte.

  • Einige Tools funktionieren möglicherweise auch ohne diesen Schritt, aber wir empfehlen Ihnen dringend, die Anweisungen zu befolgen, die wir Ihnen hier zur Verfügung gestellt haben.

  • Sie müssen diese Anweisungen für jedes Tool auf jedem Rechner sowie für jedes Installationsverzeichnis befolgen. Wenn Sie eine Kombination aus Installationen mit und ohne Administratorrechte verwenden, stellen Sie sicher, dass Sie alle Speicherorte, an denen das Tool installiert ist, aktualisiert haben.

  • Wenn ein Tool Aktualisierungen benötigt, um Nutzungsunterschiede, Abhängigkeitsprobleme oder Pakete mit neuen WHL-Dateien zu beheben, müssen Sie ein neues Tool vom Tool-Entwickler beziehen. In den meisten Fällen handelt es sich dabei um ein von Partnern entwickeltes Tool, es kann sich jedoch auch um ein älteres Tool von Alteryx oder sogar um ein Tool handeln, das sich auf Community oder Gallery befindet.

Nein, wir haben diese Tools im Rahmen des Python-Upgrades aktualisiert. Sie sollten automatisch funktionieren.

  • Sie sollten keine Änderungen weder im Python- noch im Insights-Tool bemerken, die beide Python verwenden, aber nicht das Python SDK. Da zugrunde liegende Pakete wie Pandas aktualisiert werden, kann es in einigen Fällen vorkommen, dass der Code nicht mehr mit der Python-Version kompatibel ist.

  • Es können Probleme mit Ihrem Python-Code im Python-Tool auftreten, wenn er Funktionen verwendet, die nicht mehr unterstützt werden. Wenn das der Fall ist, müssen Sie den Code aktualisieren, um mit Python 3.8 kompatibel zu sein. Möglicherweise gab es Änderungen zwischen 3.7 und 3.8. Beide sind hier verlinkt:

  • Es sollte kein Fehler auftreten, wenn (1) Sie einen Workflow mit einem Python SDK-basierten Tool von 20.3 auf einen Server hochgeladen haben, der auf 20.4 aktualisiert wurde, (2) der zugrunde liegende Code derselbe ist und (3) Sie Ihren Python-basierten Tool-Workflow durch Neuinstallation derselben YXI-Datei auf dem Server repariert haben. Jedes Python-basierte Tool, das aktive Workflows hat, sollte auf dem Server neu installiert werden.

  • Der Workflow verweist auf einen Tool-Namen und eine Tool-Version, nicht auf die Python-Version.

  • Wenn das Tool neu gepackt und eine neue Version zur Unterstützung von 20.4 erstellt wurde, gibt es Versionsinkompatibilitäten zwischen den Tools, und das Tool müsste für Server oder Designer aktualisiert werden.

  • Wir haben auch die integrierte Python-Version für Alteryx Analytics Hub auf 3.8.5 aktualisiert. Wie bei Server kann die Version zwischen Designer und Alteryx Analytics Hub unterschiedlich sein. Sie müssen die YXI neu installieren, wenn Sie eine Version mit inkompatiblen Abhängigkeitsversionen verwendet haben.

  • Wenn ein Benutzer sowohl Alteryx Analytics Hub als auch Alteryx Intelligence Suite lizenziert hat, muss er Alteryx Analytics Hub installieren, um ein Upgrade von der stabilen Version 20.2 durchzuführen, und anschließend Alteryx Intelligence Suite mit dem 20.4-Download installieren, der neben AAH auf downloads.alteryx.com verfügbar ist. Installieren Sie anschließend die YXIs neu.

Ja. Die Python-Version ist inkompatibel mit Version 20.3 und älteren Versionen sowie 20.4 und höher. Unabhängig davon, wann Sie ein Upgrade durchführen, müssen Sie die YXI-Tools aktualisieren, um die Kompatibilität zu gewährleisten.

Ja. Wenn Sie keine Python-Tools neu installieren, sollten Sie in der Lage sein, ohne Probleme zu einem früheren Status zurückzukehren. Nachdem Sie die Python-Tools aktualisiert haben, müssen Sie diesen Vorgang fortsetzen, um die Version zu wechseln. Wenn Sie beispielsweise ein Upgrade von 20.3 auf 20.4 durchführen und Salesforce neu installieren, aber dann zu 20.3 zurückkehren, müssen Sie Salesforce erneut installieren.

  • Nicht, wenn Sie Python SDK-basierte Tools verwenden. Ist das nicht der Fall, werden Sie wahrscheinlich keine Probleme haben, wenn mehrere Versionen installiert sind.

  • Sie können weiterhin eine Nicht-Admin- und eine Admin-Installation derselben Alteryx-Version verwenden.

Erstellen Sie ein Kunden-Support-Ticket unter der folgenden URL, wenn Sie zusätzliche Hilfe benötigen: https://community.alteryx.com/t5/Support/bd-p/SupportPage.

Häufig gestellte Fragen von Python-Entwicklern

Wir empfehlen Partnern und Tool-Entwicklern, ihre lokalen Installationen zu aktualisieren und alle von ihnen erstellten Tools zu testen. Sie könnten Module mit Versionen verwenden, die nicht mehr mit Python 3.8 kompatibel sind oder deren Syntax nicht mehr unterstützt wird.

Wenn Ihr Tool WHL-Dateien verwendet, müssen Sie das Tool mit seinen WHL-Dateien in einer Python-3.8-Umgebung neu paketieren und das Tool erneut veröffentlichen, damit Benutzer:innen darauf zugreifen können.

Wenn Tool-Entwickler die Beta-Version von ayx-plugin-sdk verwenden, die für 20.4 aktualisiert wurde, müssen sie dieses Paket auf die neueste Version aktualisieren, damit es weiterhin funktioniert.

Mehrere Module wurden in Snakeplane aktualisiert, um Python 3.8.5 zu unterstützen, einschließlich Numpy und Pandas. In einigen Fällen müssen Sie Snakeplane möglicherweise aktualisieren, damit Ihre Tools funktionieren.