概要と前提条件

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

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

組み込み Python のインストール

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

組み込み Python で使用する Python のバージョンをインストールする必要がある場合は、このセクションのガイドラインに従ってください。

Important:

InterSystems IRIS では、組み込み Python で使用する場合、Python のフリー・スレッド版をサポートしていません。組み込み Python を使用している場合は、グローバル・インタプリタ・ロック (GIL) を無効にしないでください。詳細は、"Python support for free threadingOpens in a new tab" を参照してください。

Microsoft Windows には、既定バージョンの Python は付属していません。また、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 をインストールします。
例えば、以下のコマンドは Python 3.11 をインストールします。
brew install [email protected]
また、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 がインストールされている場合、コマンド行から組み込み Python の実行を試行すると、irispython は最初に検出された python3 実行可能ファイル (PATH 環境変数よって決まる) を実行します。必要なバージョンの実行可能ファイルが最初に検出されるように、パスのフォルダが適切に設定されていることを確認してください。irispython コマンドの使用の詳細は、"コマンド行からの Python シェルの開始" を参照してください。

必要なサービス

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

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

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

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

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

Important:

Windows を使用している場合は、すべてのユーザに Python をインストールするため、Python インストール・マネージャではなく Python スタンドアロン・インストーラを使用する必要があります。Windows 向けの Python インストール・マネージャでは、すべてのユーザに Python をインストールできません。

Important:

Microsoft Windows 上で組み込み Python と共に OpenSSL 3 を使用する必要がある場合は、Python 3.11 以上をインストールしてください。これにより、Python インストーラに含まれているバージョンの OpenSSL 3 がインストールされます。(組み込み Python で使用される OpenSSL のバージョンは、Windows オペレーティング・システムや InterSystems IRIS 自体で使用される他のバージョンとは独立しています。)

IntegratedML の AutoML 機能では、Python 3.11 以上を使用する必要があります。

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

管理ポータルで、[システム管理]→[構成]→[追加の設定]→[メモリ詳細] に移動します。
[メモリ詳細設定] ページの [PythonRuntimeLibrary] の行で、[編集] をクリックします。
使用する 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)
[保存] をクリックします。
[メモリ詳細設定] ページの [PythonRuntimeLibraryVersion] の行で、[編集] をクリックします。
使用する Python ランタイム・ライブラリのメジャー・バージョン番号を入力します。
例： 3.11 (3.11.x とはしません)
[保存] をクリックします。

詳細は、"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 ランタイム機能の使用" を参照してください。