Skip to main content

Python tool Pythonツール

Pythonツールの更新

2026.2 Designerリリースより、PythonツールはAMP Engineにネイティブ対応します。

2026.1 Designerリリースより、Pythonツールでインタラクティブモードは使用できなくなりました。

Python開発が、本番環境優先の実行モデルでサポートされるようになりました。これにより、ワークフローを実行する前に、ツールまたは任意の外部統合開発環境(IDE)でPythonスクリプトを直接編集できます。

ユーザーロール要件

ユーザーロール*

ツール/機能へのアクセス

フルユーザー

✓

ベーシックユーザー

X

*Alteryx Oneプロフェッショナルエディションおよびエンタープライズエディションをご契約中で、Designerバージョン2025.1以降をお使いのお客様に適用されます。

Python ツールは、Python ユーザー向けのコードエディターです。このツールを使用する前に、Python を習熟しておく必要があります。from ayx import AlteryxでAlteryx Pythonパッケージをインポートした後、DesignerのPythonツールで使用できる関数の詳細については、Alteryx Pythonの関数を参照してください。

重要

Designerはユーザーが作成したPythonコードを受け入れますが、Alteryxではユーザーが作成したPythonコードをサポートしていません。

ツールごとに学習

このツールには「ツールごとに学習」があります。サンプルワークフローをご覧いただき、Designerからこのサンプルやその他の多くのサンプルに直接アクセスする方法をご確認ください。

開始する

Pythonツール設定ウィンドウを使用して、Pythonスクリプトを入力またはインポートします。コードについては、Alteryx Pythonの関数の追加資料を参照してください。

必要なデータサイエンスパッケージのインストール

Python ツールには、次のデータサイエンスパッケージが含まれています。

  • ayx: ワークフローおよびDesignerランタイムとやり取りするAlteryx Python API。

  • ayx_python_sdk: PythonでAlteryxツールを構築および拡張するためのソフトウェア開発キット(SDK)。

  • numpy: Pythonで数値計算と配列処理を行うコアパッケージ。

  • pandas: データ分析、時系列、表の処理のためのデータ構造。

  • scipy: 最適化、統計、信号処理、高度な数学のための科学計算ライブラリ。

  • scikit-learn: 分類、回帰、クラスタリング、モデル評価のための機械学習ライブラリ。

  • statsmodels: 回帰と仮説テストのための統計モデリングと計量経済学ライブラリ。

  • pyarrow: 列指向データ処理とApache Arrowとの相互運用性(ParquetやIPCなど)のための高性能ライブラリ。

  • SQLAlchemy: Pythonのリレーショナルデータベース用のデータベース抽象化およびオブジェクトリレーショナルマッピング(ORM)ツールキット。

  • pyodbc: エンタープライズデータベース用のODBCコネクタ。

  • requests: APIとWebサービスを呼び出すためのHTTPライブラリ。

  • matplotlib: 静的なグラフと可視化のためのプロットライブラリ。

  • plotly: インタラクティブなチャートとダッシュボード用の可視化ライブラリ。

  • plotly: インタラクティブなチャートとダッシュボード用の可視化ライブラリ。

  • dash: Pythonで分析用Webアプリケーションを構築するためのフレームワーク。

追加のパッケージインストール

使用するDesignerのバージョンに応じて、Alteryx.installPackagesの関数を使用して追加のパッケージをインストールできます。たとえば、kerasをインストールする場合は、次のコマンドを実行します。

from ayx import Package

Package.installPackages("keras")

追加のPythonパッケージをインストールできるのは、Designerを管理者として実行している場合のみです。管理者以外のユーザーは、追加のPythonパッケージをインストールできません。

ツールの設定

Pythonツール設定ウィンドウを使用してベース環境を選択し、Pythonスクリプトを入力できます。

環境

[環境]ドロップダウンを使用して、ベース環境を選択します。既定の環境はDesignerBaseTools_vEnvです。

カスタム環境の構築

Pythonツールで使用するカスタム環境を作成することもできます。カスタム環境で依存関係を指定し、その環境を使用するようにPythonツールを設定できます。これにより、パッケージの迅速なインポートが可能になるとともに、DesignerでPythonツールを使用するためのより効率的で管理しやすいアプローチが提供されます。

カスタム環境を使用する場合は、次の手順に従ってください。

  1. 次のフォルダーに移動します(Designerの管理者バージョン)。

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

  2. designerbasetools_venvフォルダーをコピーします。

  3. コピーしたフォルダーの名前を新しいカーネルの名前に変更します。

  4. 名前を変更したフォルダーで、kernel.jsonを開きます。

  5. display_nameの値を更新します。

    • Pythonツール設定の[環境]メニューに表示するカーネル名に設定します。

    • 表示名には、カスタム環境を含むフォルダー名と同じ名前を指定することはできません。

  6. 次の値は変更しないでください。

    • argv: Jupyterは、environmentでPythonを実行するためにこれを使用します。テストでは変更しないでください。

    • language: Pythonのままにします。

    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. kernel.jsonを保存してDesignerに戻ります。

  8. 次の方法でカーネルリストを更新します。

    • Pythonツールをクリックしてオフにし、もう一度ツールを選択します。

    • 新しいカーネルが表示されない場合は、Designerを閉じて再度開きます。

別のPythonインタープリターを使用する(オプション)

重要

カスタムPython環境の管理には、uvをお勧めします。

別のPythonインタープリターを使用するようにカスタム環境を設定できます。これを行うと、インストールした独自のパッケージを使って、完全に独立したPython環境を利用できます。カスタム環境で別のPythonインタープリターを使用するには、次の手順を実行します。

  1. カスタムカーネルフォルダーにあるkernel.jsonを開きます。

  2. argvリストの最初のエントリを更新して、カスタム環境のPython実行可能ファイルのファイルパスを指定します。

    argvエントリが更新されたkenrel.jsonの例:

    {
      "argv": [
        "C:\\Users\\<username>\\alteryx_envs\\myenv\\Scripts\\python.exe",
        "-m",
        "ipykernel_launcher",
        "-f",
        "{connection_file}"
      ],
      "display_name": "MyCustomEnv",
      "language": "python"
    }
  3. kernel.jsonファイルを保存し、Designerのカーネルリストを更新します。

    • Pythonツールをクリックしてオフにし、もう一度ツールを選択します。

    • 新しいカーネルが表示されない場合は、Designerを閉じて再度開きます。

カスタム環境にAYXパッケージを追加する

重要

カスタムPython環境を使用している場合は、ayxパッケージが使用可能であることを確認する必要があります。ayxパッケージは、PythonツールがDesignerワークフローとやり取り(データの読み取りや書き込みなど)をするために必要になります。

ayxパッケージをカスタム環境に追加するには、次の手順を実行します。

  1. 既定のenvironment内のwheelsディレクトリを見つけます。

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

  2. ayxフォルダー全体をコピーします。

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

最後に、ayxパッケージが正常にインストールされたことを確認するために、環境を有効化して次のコマンドを実行します。

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

Pythonスクリプト

設定ウィンドウの[Python Script]フィールドを使用して、Pythonスクリプトを入力または貼り付けます。スクリプトをインポートすることもできます。スクリプトエディターで作業するには、次のオプションを使用できます。

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

    • 検索フィールドにテキストを入力し、検索条件をカスタマイズします。

      • [大文字と小文字を区別(Alt + C)]。入力テキストの大文字と小文字に一致するテキストのみを検索します。「READ」ではなく「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.

      • 上矢印と下矢印を使用して、一致項目を順に切り替えます。

      • Find in Selection (Alt + L): Select to find in the current line.

    • Replaceフィールドにテキストを入力すると、Findフィールドに入力したテキストを置き換えます。

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

      • Replace (Enter): Replace one instance of the found text with the text in the Replace field.

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

  • Copy: Select the copy icon to copy the full current editor contents, including edits made since the last workflow save.

  • Comment and Uncomment: Select the # icon to comment or uncomment the current line or selected non-blank lines without changing indentation.

  • 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.

Alteryx Pythonの関数

from ayx import Alteryxを実行すると、Alteryxパッケージの多くの関数を使用できるようになります。これらの関数を使用すると、AlteryxとJupyterの間でデータを渡すことができます。

使用可能な関数、説明、例については、Alteryx Pythonの関数を参照してください。

重要

Python ツールは、データを Pandas データフレームとして扱います。詳細については、pandas.pydata.orgを参照してください。

ワークフローデータへの接続

Python ツールは複数入力に対応します。入力を接続した後、Alteryx.read関数を使用して、ワークフローデータをPandas DataFrameとしてツールに取り込むことができます。その後、Pythonを使用してデータを変換し、最後にAlteryx .writeを使用してPythonツールからデータを出力できます。

Alteryxライブラリで使用できるすべての関数の一覧については、Alteryx Pythonの関数を参照してください。

注意事項と制限事項

Pandasのstring dtype

Alteryx DesignerのPythonツールは、pandasの「string」dtypeをサポートしていません。DataFrameを正常に書き出すために、標準の「object」dtypeを使用することをお勧めします。

IPython

バージョン2026.1のPythonツールのアップデートにより、IPythonのインタラクティブ機能に依存した使い方は、DesignerでのPythonツールの意図された機能とは互換性がなくなりました。

IPython機能は、主にインタラクティブな探索をサポートしており、Designer内で実行される本番ワークフローにはあまり向いていません。

そのため、次のようになります。

  • Alteryxは、IPython固有の機能との互換性を維持しません。

  • IPython機能に依存するワークフローは、バージョン2026.1以前と同じようには動作しない可能性があります。

  • これらの機能が必要な場合は、IPython環境でDesignerの外部からコードを実行する必要があります。

自動設定を無効にすると、Pythonツールがスクリプトを読み込まない

[ユーザー設定]で[自動設定を無効にする]をオンにすると、26.1より前に作成されたワークフローをDesignerバージョン2026.1で開いたときに、バージョン26.1より前に作成されたPythonツールのスクリプトコンテンツが読み込まれません。

この問題に対処するには、[ユーザー設定]で[自動設定を無効にする]をオフにしてから、ワークフローを再度開きます。これにより、ツールはスクリプトコンテンツを変換して読み込めるようになります。

  • この問題の影響を受けるのは、Designerバージョン2026.1より前に作成されたPythonツールのみになります。

  • [自動設定を無効にする]がオフになっている場合(既定設定)は、この問題は発生しません。