Alteryx 埋め込み Python
概要
Alteryx プラットフォームには Python が組み込まれており、製品の複数の機能をサポートします。Alteryx の Python のバージョンは、PC にインストールされている他のバージョンの Python には影響しません。Alteryxでは、必要に応じてPythonのバージョンアップグレードを行っています。Jupyter Python ツールやその他の Alteryx Python SDK を使用しているツールにバージョンの更新が反映されている場合があります。Pythonベースのデータコネクタには、Salesforce、Google BigQuery、Microsoft Azure Data Lake Store、Microsoft Power BI、Microsoft OneDrive、Microsoft Dynamics CRMなどがあります。
Alteryx Python の互換性
Alteryx リリース | 埋め込み Python のバージョン | 仮想環境 |
|---|---|---|
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 |
2025.1 | 3.10.15 | Standard (Conda for v1 SDK) If your workflow includes references to the |
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 |
2019.3 より前 | 3.6.0 | 標準 |
Python 3.10アップグレードに関するFAQ (2024.1 Alteryx DesignerおよびServerリリース)
免責事項
このドキュメントは、詳細情報が更新されるタイミングで毎月更新されます。
これは、Alteryx DesignerとServerをPython v3.8.16からPython v3.10.13にアップグレードするための製品イニシアティブになります。この背景には、Pythonによるv3.8のサポート終了があります。Alteryxは、セキュリティ対策に準拠し続けるためにこれに従う必要があります。Alteryxではセキュリティが最優先事項であり、2024.1リリース(2024年5月上旬)までにDesignerをPython 3.10にアップグレードする必要があります。
Pythonに依存するDesignerツールを使用するすべてのお客様が知っておく必要があります。これには、データコネクタ、パートナーが構築したSDKツール、カスタム構築のSDKツール、Pythonツール、Intelligence Suiteツールが含まれます。
Pythonに依存するDesignerツールは、Python 3.10.13で動作するようにアップグレードする必要があります。アップグレードしないと、DesignerおよびServer 24.1では動作しません。
24.1 Alteryxリリースより前のバージョンのワークフローにPython SDKツールがある場合、そのバージョンのSDKツールは24.1では動作しません。動作させるには、次の手順を実行する必要があります。
24.1と互換性のある新しいバージョンのSDKツールをインストールする。
ワークフローを更新して、新しいバージョンのツールを使用する。
ワークフローをAlteryx Serverに再公開する。
アップグレードされたツールを使用してワークフローをテストする場合、通常は単一のサンドボックス環境で新しいワークフローをテストするServerユーザーも、別のサンドボックス環境を作成して24.1をテストすることをお勧めします。1つの環境で引き続き現在のワークフローを既存のツールでテストし(本番環境に移行する前)、新しく作成した環境では新しいツールを24.1でテストします。24.1 Pythonベースのコネクタは、それ以前のバージョンのAlteryxでは動作せず、またその逆も同様であるため、これは必要な設定になります。
はい。他者のカスタムツールを使用するユーザーは、カスタムツールの作成者がPythonのアップグレードを完了した後に、ツールの最新バージョンをダウンロードしてインストールする必要があります。カスタムツールの作成者は、コミュニティGalleryに最新バージョンのツールを投稿するか、該当する場合はAlteryx Marketplaceに更新を送信します。
2024年5月に予定されている2024.1リリースで、DesignerのPythonバージョンを3.8.16から3.10.13にアップグレードします。このため、パートナー様とお客様は、Alteryx Designer 2024.1をインストールする前に、SDKツールをPythonバージョン3.10.13にアップグレードするようお願いいたします。
ツールをPythonバージョン3.10.13にアップグレードする方法についてのステップバイステップのアップグレード手順が用意されています。カスタムツールをPython 3.10にアップデートする手順をご覧ください。
その他に質問がある場合は、Alteryx IO開発者フォーラムにアクセスしてご質問を投稿してください。また、その他の資料が利用可能になり次第、このドキュメントを定期的に更新します。
Python 3.8.5アップグレードに関するFAQ (2020.4 Alteryx DesignerおよびServerリリース)
以下は、2020.4 Alteryx DesignerおよびServerリリースに関連した、Python 3.8.5へのアップグレードに関するFAQです。
以前のバージョンの Designer に YXI カスタムツールをインストールした場合、ツールモジュールの依存関係において Python のバージョン参照に互換性がないため、該当ツールは正常に機能しなくなります。
また、ツールに含まれているPythonのモジュール依存関係に互換性がなくなっている場合や、新しいPythonバージョンで使用しているPython言語の要素がすでにサポートされなくなっている可能性もあります。
アップグレードスクリプト:
PCやサーバーに影響を与える可能性のあるツールの一覧を確認できるよう、当社では埋め込みPythonのアップグレードスクリプトを提供しています。このスクリプトは、Alteryx ユーザーおよびサーバー管理者を対象としており、2020.4 (または今後リリース予定のバージョン) へのアップグレードを検討している場合や、すでにアップグレード済みで、Python SDK ベースのツールを使用したワークフローのトラブルシューティングについて支援を必要としている場合に活用できます。
以前に YXI カスタムツールをインストールしていて、その環境で Designer 20.4 にアップグレードした場合は、問題を示すエラーメッセージが表示され、該当ツールを含むワークフローを実行できなくなります。
これはすべての Alteryx 製品のワークフローに影響します。
所有しているすべてのツールとバージョンを確認してください。この情報を検索するためのファイルパスは、インストール方法に応じて 2 種類あります。
昇格インストール(管理者として実行)の場合は、[Program Data] (非表示) > [ Alteryx] > [Tools]に移動します。
非昇格インストールの場合は、[Users] > 「ユーザー名」 > [App Data ] (非表示) > [Roaming] > [Alteryx] > [Tools]に移動します。
Python ベースのデータコネクタには、Salesforce、Google BigQuery、Microsoft Azure Data Lake Store、Microsoft Power BI、Microsoft OneDrive、Microsoft Dynamics CRM の 6 種類があります。これにより、再インストールが必要なバージョンを追跡できます。すべてのデータコネクタに問題が発生するわけではありませんが、アクティブなワークフローがあるコネクタについては、全バージョンの全コネクタを再インストールすることを強く推奨します。
ツールに Python 3.8 との互換性を備えるための更新が不要な場合は、該当ツールのバージョンと場所を記録しておきます。このプロセスではツールパッケージの再インストールが必要になるため、ツールを削除する前に該当ツールの YXI パッケージの場所を確認してください。次に、ツールディレクトリと中のファイルを削除してからツールの YXI を再インストールすることを推奨します。YXI を再インストールする前に、該当ツールを使用するワークフローを開かないでください。ワークフローで不明な動作が発生する可能性があります。
この手順を実行しなくても問題なく動作するツールもあるかもしれませんが、ここで説明した手順に従うことを強く推奨します。
この手順は、各 PC の各ツールのインストールディレクトリごとに実行する必要があります。非昇格インストールと昇格インストールを使用している場合は、ツールが存在する可能性のあるすべての場所が更新されていることを確認してください。
使用方法の不一致、依存関係の問題、または新しい WHL ファイル形式のパッケージを解決するためにツールの更新が必要な場合は、ツール開発者から新しいツールを受け取る必要があります。ほとんどの場合はパートナーが作成したツールになりますが、Alteryxで構築された古いツールやコミュニティやGalleryで見つけたツールの場合もあります。
いいえ。Python アップグレード作業の一環として、これらのツールもアップグレードされているので、自動で動作します。
Pythonツールとインサイトツールに変更はありません。これらはPythonを使用していますが、Python SDKは使用していません。ただし、pandas のようなベースとなるパッケージが更新されているために、コードと Python バージョンの互換性がなくなる場合があります。
Python ツールの Python コードがすでにサポートされていない機能を使用していた場合、問題が発生することがあります。その場合は、Python 3.8 との互換性を確保するため、コードを更新する必要があります。3.7 と 3.8 の間に変更があるかもしれません。以下は両方のリンクです。
(1) 20.3 から Python SDK ベースのツールを使用し、20.4 にアップグレードされた Server にワークフローをアップロードした場合、(2) ベースとなるコードが同じである場合、(3) 同一の YXI ファイルを Server に再インストールして Python ベースのツールワークフローを修正した場合、エラーは発生しません。アクティブなワークフローを含む Python ベースのツールはすべて、Server に再インストールする必要があります。
ワークフローは Python バージョンではなく、ツール名とツールバージョンを参照します。
20.4 をサポートするためにツールが再パッケージ化され、新しいバージョンが作成されている場合、ツール間でバージョンの非互換性が発生するため、Server または Designer でツールを更新する必要があります。
Alteryx Analytics Hub に含まれる、埋め込み Python のバージョンも 3.8.5 にアップグレードされています。Server と同様、Designer と Alteryx Analytics Hub のバージョンが異なる場合があります。依存関係に互換性のないバージョンを使用している場合は、YXI を再インストールする必要があります。
ユーザーが Alteryx Analytics Hub と Alteryx Intelligence Suite の両方のライセンスを取得している場合、ユーザーは Alteryx Analytics Hub をインストールして 20.2 安定版リリースからアップグレードし、その後 20.4 ダウンロードを使用して Alteryx Intelligence Suite をインストールする必要があります。ダウンロードは downloads.alteryx.com の AAH の横にあります。その後、YXI を再インストールします。
はい。20.3以前のバージョンと20.4以降のバージョンでは、Pythonのバージョンに互換性がなくなります。アップグレードのタイミングに関係なく、YXI ツールを更新して互換性を確保する必要があります。
はい。Python ツールを再インストールしていない場合は、問題なく以前の状態に戻すことができます。Python ツールの更新後は、バージョンを切り替えるプロセスを続行する必要があります。たとえば、20.3 から 20.4 にアップグレードして Salesforce を再インストールした後で 20.3 に戻した場合は、Salesforce を再インストールする必要があります。
いいえ。Python SDK ベースのツールを使用している場合はできません。そうでない場合は、複数のバージョンがインストールされていても問題が発生することはほとんどありません。
引き続き、同一のAlteryxバージョンの非昇格インストールと昇格インストールを使用することはできます。
インストールは成功します。問題があるとすれば、未インストールの Python ベースのツールはすべて、更新されるまで 20.4 では動作しない点です。ツールが更新されると、Python 3.8 ベースではない古いインストール (20.4 よりも古いバージョンの Alteryx) では動作しなくなります。
1台のPCに複数のバージョンをインストールする方法の詳細については、https://community.alteryx.com/t5/Alteryx-Designer-Knowledge-Base/How-to-install-two-versions-of-Designer-on-the-same-machine/ta-p/454948を参照してください。
さらにサポートが必要な場合は、https://community.alteryx.com/t5/Support/bd-p/SupportPage でカスタマーサポートチケットを作成してください。
Python開発者向けのFAQ
ツール開発者やパートナーは、ローカルインストールをアップグレードし、開発したすべてのツールをテストすることを推奨します。Python 3.8 と互換性がなくなったモジュールや、サポートされなくなった構文を使用している可能性があります。
ツールがWHLファイルを使用している場合は、Python 3.8環境のWHLファイルを使用してツールを再パッケージ化し、ユーザーがアクセスできるようにツールを再公開する必要があります。
ツール開発者が20.4用に更新されたベータリリースのayx-plugin-SDKを使用している場合、ツールが引き続き動作するようにするには、このパッケージを最新バージョンに更新する必要があります。
Snakeplane では、numpy や pandas など、Python 3.8.5 をサポートするために複数のモジュールが更新されました。場合によっては、ツールを動作させるために Snakeplane の更新が必要になることがあります。