Skip to main content

概要と前提条件

組み込み Python により、InterSystems IRIS アプリケーションをプログラミングするネイティブ・オプションとして Python を使用できるようになります。組み込み Python を使用するのが初めてである場合は、まず "組み込み Python の概要" を参照し、その後組み込み Python のより詳細な説明として、このドキュメントをお読みください。

このドキュメントは組み込み Python について学習する人すべてに役立ちますが、理解するうえで ObjectScript についてのある程度の知識を持っていることが望ましいでしょう。InterSystems IRIS および ObjectScript に不慣れな Python 開発者の場合、"サーバ側プログラミングの入門ガイド" も参照してください。

推奨される Python バージョン

組み込み Python の使用時に推奨される Python のバージョンは、実行しているプラットフォームによって異なります。ほとんどの場合は、お使いのオペレーティング・システムの Python の既定バージョンです。オペレーティング・システムと対応する Python のサポート対象バージョンの完全なリストは、"その他のサポート対象機能" を参照してください。

Note:

一部のオペレーティング・システムでは、フレキシブル Python ランタイム機能を使用して、推奨される Python バージョンをオーバーライドできます。

Microsoft Windows には、既定バージョンの Python は付属していません。また、InterSystems IRIS 2024.2 以降、Windows 用 InterSystems IRIS インストーラでは Python がインストールされなくなりました。Windows 向けに組み込み Python をセットアップする方法については、"フレキシブル Python ランタイム機能" を参照してください。

多くの UNIX ベースのオペレーティング・システムでは、既に Python がインストールされています。インストールする必要がある場合は、パッケージ・マネージャによりご使用のオペレーティング・システムに推奨されるバージョンを使用してください。以下に例を示します。

  • Ubuntu ： apt install python3

  • Red Hat Enterprise Linux または Oracle Linux ： yum install python3

  • SUSE ： zypper install python3

  • macOS ： HomebrewOpens in a new tab を使用して Python 3.11 をインストールします。

    brew install python@3.11

    また、OpenSSL の最新バージョンを使用していることも確認してください。

    brew unlink openssl
brew install openssl@3
brew link --force openssl@3

  • AIX ： AIX Toolbox for Open Source SoftwareOpens in a new tab から dnf (dandified yum) を使用して Python 3.9.18 以降をインストールします。

“Python をロードできませんでした” というエラーが表示された場合は、システムに Python がインストールされていないか、Python の予期しないバージョンが検出されたかのどちらかです。"その他のサポート対象機能" を調べて、必要なバージョンの Python がインストールされていることを確認し、必要に応じて、上記のいずれの方法で Python をインストールまたは再インストールしてください。または、フレキシブル Python ランタイム機能を使用して、推奨される Python バージョンをオーバーライドします。(すべてのプラットフォームで利用できるわけではありません。)

フレキシブル Python ランタイム機能をサポートしていないプラットフォームを使用していて、コンピュータに複数のバージョンの Python がインストールされている場合、コマンド行から組み込み Python の実行を試行すると、irispython は最初に検出された python3 実行可能ファイル (PATH 環境変数よって決まる) を実行します。必要なバージョンの実行可能ファイルが最初に検出されるように、パスのフォルダが適切に設定されていることを確認してください。irispython コマンドの使用の詳細は、"コマンド行からの Python シェルの開始" を参照してください。

必要なサービス

組み込み Python の実行時に IRIS_ACCESSDENIED エラーが発生しないようにするには、%Service_Callin を有効にします。管理ポータルで、[システム管理]→[セキュリティ]→[サービス] に移動し、[%Service_CallIn] を選択し、[サービス有効] ボックスにチェックを付けます。

フレキシブル Python ランタイム機能

フレキシブル Python ランタイム機能を使用すると、組み込み Python で使用する Python のバージョンを選択できます。フレキシブル Python ランタイムは、すべてのオペレーティング・システムでサポートされるわけではありません。この機能をサポートするプラットフォームの完全なリストは、"その他のサポート対象機能" を参照してください。

Important:

InterSystems IRIS と Python 3.13 の間には既知の不適合があるため、現時点では Python 3.13 を避けることをお勧めします。この問題は、InterSystems IRIS の今後のバージョンで対処される予定です。

Microsoft Windows では、InterSystems IRIS 2024.2 以降、インストーラでは既定のバージョンの Python がインストールされなくなりました。Python は https://www.python.org/downloads/Opens in a new tab からインストールできます。必ずカスタム・インストールを実行し、すべてのユーザに Python をインストールしてください。

Important:

Windows プラットフォーム上の InterSystems IRIS 2024.1 用インストーラは、以前は Python 3.9.5 と共に OpenSSL 3.1.4 をインストールしていました。しかし、Python.org から Python 3.9 をインストールすると、OpenSSL 1.1.1n がインストールされます。InterSystems IRIS 2024.2 上で組み込み Python と共に OpenSSL 3 を使用する必要がある場合は、Python 3.11 以上をインストールしてください。

Windows 向け InterSystems IRIS 2024.2 では、IntegratedML の AutoML 機能で Python 3.11 を使用する必要があります。

フレキシブル Python ランタイム機能をサポートする他のオペレーティング・システムでは、既定のバージョンの Python をオーバーライドできます。これは、コードを記述する場合や、既定のバージョン以外の Python に依存するパッケージを使用している場合に便利です。オペレーティング・システムの既定のバージョン以降の Python バージョンを使用する必要があります。例えば、Red Hat Enterprise Linux 9 には Python 3.9 が付属しているため、このオペレーティング・システムではバージョン 3.9 以降を使用する必要があります。

Python をインストールした後、以下の手順に従って、組み込み Python で使用する Python のバージョンを構成します。

  1. 管理ポータルで、[システム管理]→[構成]→[追加の設定]→[メモリ詳細] に移動します。

  2. [メモリ詳細設定] ページの [PythonRuntimeLibrary] の行で、[編集] をクリックします。

  3. 使用する Python ランタイム・ライブラリの場所を入力します。

    この場所は、オペレーティング・システム、Python バージョン、およびその他の要素によって異なります。

    Windows の例 ： C:\Program Files\Python311\python3.dll (Windows 上の Python 3.11)

    Linux の例 ： /usr/lib/x86_64-linux-gnu/libpython3.11.so.1.0 (x86 アーキテクチャの Ubuntu 22.04 上の Python 3.11)

  4. [保存] をクリックします。

  5. [メモリ詳細設定] ページの [PythonRuntimeLibraryVersion] の行で、[編集] をクリックします。

  6. 使用する Python ランタイム・ライブラリのバージョン番号を入力します。

    例 ： 3.11

  7. [保存] をクリックします。

詳細は、"PythonRuntimeLibrary" と "PythonRuntimeLibraryVersion" を参照してください。

Note:

Python の新しいバージョンをインストールしたが、Python ランタイム・ライブラリが見つからない場合、別個にインストールしなければならない可能性があります。例えば、Ubuntu 22.04 に Python 3.11 ランタイム・ライブラリをインストールする場合は、apt install libpython3.11 を実行します。

Microsoft Windows では、Python ランタイム・ライブラリがユーザ・ディレクトリ内にある場合 (C:\Users\<username>\AppData\Local\Programs\Python\Python311 など)、現在のユーザにのみ Python がインストールされていることを示します。予期しない結果を避けるために、すべてのユーザに Python をインストールすることをお勧めします。

手順を追った例を含め、この機能の構成方法の詳細は、"フレキシブル Python ランタイム機能の使用" を参照してください。

Python パッケージのインストールおよびインポートNext section
FeedbackOpens in a new tab