Python Gateway パート II：インストール

記事

Minoru Horita · 2020年7月6日 7m read

Open Exchange

#Artificial Intelligence (AI) #Python #Machine Learning (ML) #言語 #InterSystems IRIS

この連載記事では、InterSystemsデータプラットフォーム用のPython Gatewayについて説明します。また、InterSystems IRISからPythonコードなどを実行します。このプロジェクトは、InterSystems IRIS環境にPythonの力を与えます。

任意のPythonコードを実行する
InterSystems IRISからPythonへのシームレスなデータ転送
Python相互運用アダプタでインテリジェントな相互運用ビジネスプロセスを構築する
InterSystems IRISからのPythonコンテキストの保存、調査、変更、復元

その他の記事

現時点での連載計画です（変更される可能性があります）。

パート I：概要、展望、紹介
パート II：インストールとトラブルシューティング <-- 現在、この記事を参照しています
パート III：基本機能
パート IV：相互運用アダプタ
パート V：Execute関数
パート VI：動的ゲートウェイ
パート VII：プロキシゲートウェイ
パート VIII：使用事例とML Toolkit

インストール

この記事はPython Gatewayをインストールするのに役立ちます。Python Gatewayをインストールして使用する方法はいくつか存在します。

ホスト
Windows
Linux
Mac
Docker
作成済みのイメージをプルする
独自のイメージをビルドする

インストール方法に関係なく、コードが必要になります。コードはリリースページでしかダウンロードできません。リリースページにはテスト済みの安定版リリースが公開されていますので、最新のものを入手してください。現在のバージョンは0.7ですが、将来的には新しいものになるでしょう。リポジトリをクローンまたはダウンロードせず、最新のリリースをダウンロードしてください。

ホスト

ホストOSにPython Gatewayをインストールする場合は、先に（OSに関係なく）Pythonをインストールする必要があります。

Python 3.6.7（64ビット版）をインストールします。 Pythonはデフォルトの推奨場所にインストールすることをお勧めします。
dill モジュールを、pip install dill でインストールします。
ObjectScript コード（すなわち、do $system.OBJ.ImportDir("C:\InterSystems\Repos\Python\isc\py\","*.cls","c",,1)）をProduction（Ensembleが有効な）名前空間に読み込みます。既存の名前空間呼び出しを本番環境で有効にする場合は、write ##class(%EnsembleMgr).EnableNamespace($Namespace, 1) にします。
コールアウトDLL/SO/DYLIBをInterSystems IRISインストール環境の bin フォルダに置きます。ライブラリファイルは write ##class(isc.py.Callout).GetLib() によって返されるパスに置く必要があります。

Windows

PYTHONHOME 環境変数がPython 3.6.7を参照していることを確認します。
SYSTEM PATH 環境変数に PYTHONHOME 変数（またはその参照先ディレクトリ）が含まれていることを確認します。

Linux

SYSTEM PATH 環境変数に /usr/lib および /usr/lib/x86_64-linux-gnu が含まれていることを確認します（最初にあるのが望ましい）。 /etc/environment ファイルを使用して環境変数を設定します。
undefined symbol: _Py_TrueStruct というエラーが発生した場合はTroubleshooting（トラブルシューティング）セクションを確認して PythonLib プロパティを指定してください。

Mac

Python.orgのPython 3.6.7のみが現在サポートされています。 PATH 変数を確認してください。

環境変数を変更した場合は、InterSystems製品を再起動してください。

Docker

コンテナを使用することには次のような多くのメリットがあります。

- 移植性

- 効率性

- 分離

- 軽量

- 不変性

Dockerの詳細については、こちらの連載記事をご覧ください。

Python GatewayのDockerビルドはすべて2019.1のコンテナをベースにしています。

作成済みのイメージをプルする

docker run -d -p 52773:52773 --name irispy intersystemscommunity/irispy:latest を実行してプルし、Python GatewayをInterSystems IRIS Community Edition上で実行してください。それだけです。

独自のイメージをビルドする

Dockerイメージをビルドするには、リポジトリのルートで次を実行します：docker build --force-rm --tag intersystemscommunity/irispy:latest イメージはデフォルトで intersystems/iris:2019.1.0.510.0-1 イメージにビルドされますが、これは IMAGE 変数を指定することで変更できます。InterSystems IRIS Community Editionからビルドするには、次を実行します：docker build --build-arg IMAGE=store/intersystems/iris:2019.1.0.510.0-community --force-rm --tag intersystemscommunity/irispy:latest

その後、次のコマンドでDockerイメージを実行できます。

docker run -d \ 

  -p 52773:52773 \ 

  -v /<HOST-DIR-WITH-iris.key>/:/mount \ 

  --name irispy \ 

  intersystemscommunity/irispy:latest \ 

  --key /mount/iris.key

InterSystems IRIS Community Editionベースのイメージを実行している場合はキーの指定を省略できます。

Dockerの注意事項

Dockerに関するいくつかの情報を掲載しておきます。

テストプロセス isc.py.test.Process はイメージのアーティファクトを一時ディレクトリに保存します。このパスはマウントされているディレクトリに変更できます。そのためには Correlation Matrix: Graph 呼び出しのアノテーションを編集し、f.savefig 関数に有効なファイルパスを指定してください。
ターミナルアクセスの場合は、docker exec -it irispy sh を実行します。
SuperUser/SYS または Admin/SYS のユーザー名/パスワードの組み合わせでSMPにアクセスしてください。
コンテナを停止するには、docker stop irispy && docker rm --force irispy を実行してください。

インストールの検証

Python Gatewayをインストールした後は動作確認を行います。以下のコマンドを実行してください。

set sc = ##class(isc.py.Callout).Setup()  

set sc = ##class(isc.py.Main).SimpleString("x='HELLO'", "x", , .var) 

write var

Python 変数 xの値 HELLO が出力されるはずです。戻り値のステータスがエラーの場合、または var が空の場合はreadmeのtroubleshooting（トラブルシューティング）セクションを確認してください。

まとめ

Python Gatewayは迅速かつ簡単にインストールできます。 Dockerに精通している方は最新のイメージを入手してください。そうでない場合は、InterSystems IRISの主なOS（Windows、Linux、Mac）用のキットがあります。次の記事では、Python Gatewayの使用を開始します。

図解入りガイド

ML Toolkitユーザーグループには、図解入りのインストールガイドもあります。 ML Toolkitユーザーグループは、InterSystems社のGitHub組織の一部として設定されている非公開GitHubリポジトリです。このリポジトリは、ML Toolkitコンポーネントをインストール、学習、またはすでに使用している外部ユーザーを対象としています。 ML Toolkitユーザーグループに参加するには、以下の内容を含む簡単なメールを MLToolkit@intersystems.com 宛に送信してください（グループメンバーが議論中にあなたを認識して特定するために必要です）。

GitHubのユーザー名
氏名（英文字表記の名前、姓の順）
組織（勤務先、通学先、または在宅勤務）
役職（組織での実際の役職、「学生」、または「無所属」）
国（本拠地としている国）

続けて「Python Gateway パート III：基本機能」をお読みください。

また、前のパート「Python Gateway パート I：はじめに」も確認してください。

InterSystems Open Exchangeで関連アプリケーションを確認してください。

InterSystems Open Exchangeで関連アプリケーションを確認してください

@Eduard Lebedyukさんが書いた元の記事へ