InterSystems IRIS お試し環境 専用 IDE の使い方ガ...

29
Try IRISIDE の使い方 1 InterSystems IRIS お試し環境 専用 IDE の使い方ガイド 2019 10 インターシステムズジャパン株式会社

Transcript of InterSystems IRIS お試し環境 専用 IDE の使い方ガ...

Page 1: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

1

InterSystems IRISお試し環境

専用 IDEの使い方ガイド

2019年 10月

インターシステムズジャパン株式会社

Page 2: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

2

目次

[1] はじめに ....................................................................................................................................................................................4

[2] プライベートクラウドの InterSystems IRISお試し環境を使ってみる ..............................................................................................................5

[3] InterSystems IRIS お試し環境専用 IDEの使い方 ...............................................................................................................................6

1) IDEで試せること ~Trial Version:InterSystems IRIS™ Data Platformの内容(/README.md)について~ .............................................7

2) プロジェクトの構造 (例:Multimodel QuickStarts for .NET) .................................................................................................................9

3) InterSystems メニュー詳細 ....................................................................................................................................................... 10

4) Multimodel QuickStart for .Net の使い方 ................................................................................................................................... 11

5) Multlmodel QuickStart for Java ............................................................................................................................................... 15

6) Multi-Model QuickStart for Python ........................................................................................................................................... 18

7) 他の QuickStartのサンプルを IDEに取り込む ................................................................................................................................. 21

8) システム統合ツールを試す .......................................................................................................................................................... 27

図表目次

図 1 InterSystems IRISお試し環境構築のための画面(プライベートクラウド) ...................................................................................................5

図 2 IDE:InterSystems メニュー詳細 ................................................................................................................................................ 10

図 3 Multimodel QuickStart for .NET:サンプル実行例......................................................................................................................... 12

図 4 Multimodel QuickStart for .NET:サンプル実行(Native API) ........................................................................................................... 13

図 5 Multimodel QuickStarts for .NET:作成したデータの確認(管理ポータル) .............................................................................................. 14

図 6 Multimodel QuickStarts for Javaの使い方 ................................................................................................................................ 15

図 7 Multimodel QuickStarts for Java:サンプル実行例 ....................................................................................................................... 16

図 8 Multimodel QuickStarts for Java:サンプル実行例(Native API) ...................................................................................................... 17

図 9 Multimodel QuickStart for Pythonの使い方 .............................................................................................................................. 18

図 10 Multimodel QuickStarts for Python:サンプル実行例 .................................................................................................................. 19

図 11 Multimodel QuickStarts for Python:サンプル実行例(Native API) ................................................................................................. 20

図 12 git clone で他のサンプルを IDEに取り込む方法(Node.js QuickStartsの例) ...................................................................................... 21

図 13 Node.js QuickStarts README.mdの実行手順 .......................................................................................................................... 22

Page 3: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

3

図 14 Node.js QuickStarts:サンプル実行前の接続情報修正 ................................................................................................................... 23

図 15 IRISお試し環境:接続情報確認ページ ........................................................................................................................................ 24

図 16 IRISお試し環境:オンラインラーニング本登録までの流れ ................................................................................................................... 25

図 17 Node.js QuickStarts:サンプル実行例 ...................................................................................................................................... 26

図 18 Interoperability QuickStarts:プロダクション .............................................................................................................................. 27

図 19 Interoperability QuickStarts:テスト ....................................................................................................................................... 28

図 20 Interoperability QuickStarts:メッセージトレースでの確認 .............................................................................................................. 29

Page 4: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

4

[1] はじめに

InterSystems 教育サービスでは、InterSystems IRIS をはじめ、弊社製品をお手元の環境ですぐにご体験いただけるよう、演習環境付きオンラインラーニングを各種ご用

意しています。

本資料では、オンラインラーニングの中でも、5分前後でお試しいただける「QuickStarts」 と InterSystems IRISのお試し環境作成方法、お試し環境に用意されるWebベ

ースの IDEの使い方、サンプルプログラムの実行方法を解説します。

IRISのお試し環境について

ローカルへのインストールは不要でクラウド上に InterSystems IRIS Community Edition 1 のインストール環境を作成頂けます。

お試し環境はご選択いただけます。

InterSystemsオンラインラーニングが提供するプライベートクラウドを利用する場合

環境作成時、お名前、メールアドレス、国名を指定いただければ、クリック 1回でお試し環境を作成できます。

また、作成した環境は 30日(申請いただければ 90日)間利用可能ですが、OS、CPU、ハードディスク/メモリサイズはご選択いただけません。

3大クラウドのマーケットプレイスを利用する場合

InterSystems IRIS Community Edition をご選択いただければ IRISの利用料は無料です。

お好みの OS、CPU、ハードディスク/メモリサイズの構成で IRISをご利用いただけます(クラウド使用料はお客様負担)。

各環境の利用方法については、こちらをご参照ください(ビデオは日本語字幕に切り替えできます。方法はこちらをご参照ください。)。

InterSystems IRIS についてさらに学びたい方は、開発者向け情報 もご参照ください。

1 InterSystems IRIS Community Edition は、無料でお試しいただけます。

【制限有】 同時接続 5ユーザ、ユーザ DB 1個まで、DBサイズは 10GBまで、8 コアまで、シャーディング/ECP/ミラーリング利用不可、サポート無

上記制限以外は、テーブル作成やデータのロード、Javaや.NETからのアクセス、NLPなど、すべての機能をお試しいただけます。

無料 GCP使用料のみ Azure使用料のみ AWS使用料のみ

InterSystems IRIS Community Edition利用価格

Page 5: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

5

[2] プライベートクラウドの InterSystems IRISお試し環境を使ってみる

こちらのページにアクセスし、お名前(姓、名)、メールアドレスを英字でご記入いただき ボタンをクリックするだけで IRISのお試し環境が作成できます

(構築完了までに数分かかります)。

図 1 InterSystems IRISお試し環境構築のための画面(プライベートクラウド)

以降のページでは、お試し環境専用 IDEの使い方について解説します。

Page 6: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

6

[3] InterSystems IRIS お試し環境専用 IDEの使い方

環境作成が終了すると、ブラウザ上に上図のような IDEが表示されます。

次ページでは、最初に表示される Trial Version:InterSystems IRIS™ Data Platform の内容(/README.md の中身)を簡単にご説明します。

ログインが完了すると専用のIDEが開きます。

ターミナルウィンドウ(サンプル実行時に使用します)

QuickStartsのサンプルなどが用意されています。

環境作成後の画面

Page 7: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

7

1) IDEで試せること ~Trial Version:InterSystems IRIS™ Data Platformの内容(/README.md)について~

IRIS お試し環境に用意される Web ベースの IDE を利用して、IRIS に接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

す。また、QuickStartsで提供している GitHub上のサンプルコードを取り込みながら、コード詳細や実行方法を確認することもできます。

【ご注意】 30日(申請すれば 90日)間限定の利用環境のため、ライブシステムの構築や本番環境にあるようなデータのアップロードなどは行わないでください。

ブラウザを閉じた後に再度 IDE を開くことができるように、ブックマークに登録

しておいてください。もし、忘れた場合は、InterSystems Labs のページへア

クセスすると IDEの URLや接続環境の説明を再度ご確認いただけます。

IDE のサンプルだけでなく、もっと IRIS について詳しく学習したい場合は、

QuickStarts 「What is InterSystems IRIS?」をご参照ください。

QuickStarts に含まれるビデオの中には、日本語字幕付きのものも用意され

ています。右図にある のアイコンをクリックし「Japanese」を選択する

と日本語字幕へ切り替えることができます。ぜひご利用ください。

IDEに用意されているサンプルを通して、以下の内容をお試しいただけます。

試したいこと 対象プロジェクト

各言語から IRISへの接続方法を知りたい プロジェクト[Samples-言語名-helloworld]

IRISのマルチモデルを体験したい

※マルチモデルデータベースについて概要は「Multi-

Model QuickStart!」のビデオもぜひご参照ください

.NET開発者向けプロジェクト[quickstarts-multimodel-dotnet] 詳細は P11をご参照ください。

Java開発者向けプロジェクト[quickstarts-multimodel-java] 詳細は P15をご参照ください。

Python開発者向けプロジェクト[quickstarts-multimodel-python] 詳細は P をご参照ください。

その他言語(Python/Node.js)については QuickStartsから取得できます。詳細は P21をご参照ください。

システム統合について試したい Sharedフォルダ以下の[Samples-Integration-RedLights]お Interoperability QuickStart と、お試し

環境のプロダクションをご参照ください。詳細については P27「8)システム統合ツールを試す」をご参照ください。

使い方詳細は後述します(または各プロジェクト用フォルダ内の「README.md」にをご参照ください)。

1. のアイコンをクリック2. janapese [cc] を選択

Page 8: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

8

用意された環境には、サンプルデータがインポートされています。詳細は以下の通りです。

テーブル定義詳細やデータの確認は、IRISの管理ポータルから確認できます。

IDE メニュー → InterSystems → InterSystems IRIS Management Portal → [システムエクスプローラ] → [SQL] → スキーマ名:Demo

テーブル名/クラス名 内容

Demo.Stock MultiModel QuickStartで利用する

Demo.PetShop SQL QuickStartで利用する

Demo.RedLights クラスについては、Interoperability QuickStart で使用しているプロダクション定義用クラスです。詳細は P27[8)システム統合ツールを試す] をご参

照ください。

IRISの管理ポータルやWeb ターミナルを開くときのユーザ名、パスワードは以下の内容が初期設定されています。

Username : tech

Password : demo

パスワードは管理ポータルから変更できます。

IDE メニュー → InterSystems → InterSystems IRIS Management Portal → [システム管理] → [セキュリティ] → [ユーザ] → ユーザ名

Page 9: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

9

2) プロジェクトの構造 (例:Multimodel QuickStarts for .NET)

画面左側はプロジェクトウィンドウで、オンラインラーニングの「Multimodel QuickStarts」で紹介している .NET、Java、Python のサンプルプログラム一式がプロジェクトとし

て用意されています。接続先情報を変更すればそのまま動作します。具体的な操作方法は、各プロジェクトフォルダ内の README.mdに記載されています。

以降のページで、README.mdに記載されている手順を簡単にご説明します(実際の操作環境では、README.mdに記載のあるスクリプト例を参考に実行してください)。

プロジェクトの構造 Multimodel QuickStartsで使用しているC#.NETのサンプルを試せるプロジェクト

Multimodel QuickStartsで使用しているJava、Pythonのサンプルを試せるプロジェクト

各言語からIRISへの接続のみを記述したサンプルコードが用意されています(上から順番に.NET、Java、Node.js、Python)。ドキュメントの「機能紹介(FirstLook)」やオンラインラーニングのQuickStartsをご覧いただきながら、お好みのコードを追加して試すこともできます。

プロジェクトのサンプルコードの動かし方、関連するオンラインラーニング情報が記載されています。

QuickStartsのサンプルを

プロジェクトに追加する

こともできます(詳細は

後述します)。

Page 10: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

10

3) InterSystems メニュー詳細

IDEには、構築した InterSystems IRISの管理ポータルにアクセスするメニュー、Web ターミナルを開くメニューが用意されています。

図 2 IDE:InterSystems メニュー詳細

また、オンラインラーニング、QuickStartsページへのリンクも用意があります。

ドキュメントへのリンクは、英語ドキュメントをポイントしています。日本語最新ドキュメントは https://docs.intersystems.com/iris/latestj

でアクセスできます。

Webターミナルを開きます(ObjectScriptのコマンドが実行できるターミナルが開きます)。

管理ポータルを開きます。

オンラインラーニングの各ページを開きます。

ドキュメントのFirst Looks(機能紹介)のページを開きます。

InterSystemsメニュー 詳細

Page 11: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

11

4) Multimodel QuickStart for .Net の使い方

マルチモデルについての詳細は、https://learning.intersystems.com/course/view.php?name=Multimodel をご参照ください。

2. ガイドが表示されます。

1. 試したいQuickStarts

のフォルダを展開し、「README.md」をクリックします。

このサンプルでは、.NETからInterSystems IRIS Data Platformへのマルチモデルアクセスをお試しいただけます。

マルチモデルについて詳細は、こちら(https://bit.ly/33pIDhh)から学習できます。※日本語字幕切り替え付きのビデオあり

.NETからInterSytems IRISへ3手法(オブジェクト(XEP)/リレーショナル/Native)を使用したアクセスを試します。サンプルでは、Airportデータをオブジェクトアクセスで格納し、SQLで情報取得、空港間の経路情報を処理するため Native API を使用してカスタムデータ構造を作成しています。

左画面(QuickStarts)の使い方 と

Multimodel QuickStart for .NETの使い方

サンプルコードを実行する方法は以下の通り。1. サンプルコードのあるディレクトリに移動します。

cd /home/project/quickstarts-multimodel-dotnet

2. 画面下のターミナルウィンドウで、以下実行します。dotnet run

Page 12: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

12

図 3 Multimodel QuickStart for .NET:サンプル実行例

次ページは Native APIでのデータ登録と取得のテスト実行例をご紹介します。

Multimodel QuickStart for .NET サンプル実行例

root ~ $ cd /home/project/quickstarts-multimodel-dotnet

root ~/quickstarts-multimodel-dotnet $ dotnet run

Welcome to .NET Core!

---------------------

Learn more about .NET Core: https://aka.ms/dotnet-docs

<省略>

ASP.NET Core

------------

Successfully installed the ASP.NET Core HTTPS Development Certificate.

To trust the certificate run 'dotnet dev-certs https --trust' (Windows and macOS only). For establishing trust on other platforms

refer to the platform specific documentation.

For more information on configuring HTTPS see https://go.microsoft.com/fwlink/?linkid=848054.

Connected to InterSystems IRIS

Generating airport table...

Stored 5 airports

Name Code Location

Austin–Bergstrom International AUS Austin, TX 78719

Boston Logan International BOS Boston, MA 02128

Chicago O'hare International ORD Chicago, IL 60666

Philadelphia International PHL Philadelphia, PA 19153

San Francisco International SFO San Francisco, CA 94128

root /home/project/quickstarts-multimodel-dotnet $

XEP(オブジェクト)を使用してデータを登録し、SQL(ADO.NET)を使用して以下SQLの実行結果を出力しています。SELECT name, code, location->city, location->state, location->zip

FROM demo.airport

詳細は、MultiModelQS.csをご参照ください。

開発環境に.NET Coreをしているため、dotnet run の実行で初回のみメッセージが表示されます。

Page 13: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

13

図 4 Multimodel QuickStart for .NET:サンプル実行(Native API)

MultiModelQS.csを開き、以下のコメントを外し、保存します(Ctrl+Sで保存できます)。

// storeAirfare(irisNative);// checkAirfare(irisNative);

root ~/quickstarts-multimodel-dotnet $ dotnet runConnected to InterSystems IRIS

Generating airport table...

Stored 5 airports

Name Code LocationAustin–Bergstrom International AUS Austin, TX 78719

Boston Logan International BOS Boston, MA 02128

Chicago O'hare International ORD Chicago, IL 60666

Philadelphia International PHL Philadelphia, PA 19153

San Francisco International SFO San Francisco, CA 94128Stored fare and distance data in ^airport global.

Enter departure airport: (e.g. BOS)BOS

Enter destination airport: (e.g. AUS)AUS

The distance in miles between BOS and AUS is: 1698.

The following routes exist for this path:

- AA150: 450 USD- AA290: 550 USD

root ~/quickstarts-multimodel-dotnet $

dotnet runを実行し、

Departure airport に BOS

Destination airport に AUSを指定すると指定空港間のマイルと経路を出力します。ご参考:^airportグローバルを作成しています。次ページの管理ポータルの利用例から「グローバル」を選択すると ^airport の中身を確認できます。

Page 14: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

14

図 5 Multimodel QuickStarts for .NET:作成したデータの確認(管理ポータル)

Multimodel QuickStart for .NETのサンプルで作成したデータを管理ポータルで確認

Page 15: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

15

5) Multlmodel QuickStart for Java

図 6 Multimodel QuickStarts for Javaの使い方

マルチモデルについての詳細は、https://learning.intersystems.com/course/view.php?name=Multimodel をご参照ください。

Multimodel QuickStart for Java の使い方 このサンプルでは、JavaからInterSytsems IRIS Data Platform

へのマルチモデルアクセスをお試しいただけます。

マルチモデルについて詳細は、こちら(https://bit.ly/33pIDhh)から学習できます。※日本語字幕切り替え付きのビデオあり

JavaからInterSytems IRISへ3手法(オブジェクト(XEP)/リレーショナル/Native)を使用したアクセスを試します。サンプルでは、Airportデータをオブジェクトアクセスで格納し、SQLで情報取得、空港間の経路情報を処理するため Native API を使用してカスタムデータ構造を作成しています。

サンプルコードを実行する方法は以下の通り。1. 画面下のターミナルウィンドウで、ソースコードをコンパイルするため以下実行します。

cd /home/project/quickstarts-multimodel-java/src

javac -cp ".:../lib/intersystems-jdbc-3.0.0.jar:../lib/intersystems-xep-3.0.0.jar" multimodelQS.java2. multimodelQSを実行します。

java -cp ".:../lib/intersystems-xep-3.0.0.jar:../lib/intersystems-jdbc-3.0.0.jar" multimodelQS

Page 16: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

16

図 7 Multimodel QuickStarts for Java:サンプル実行例

Multimodel QuickStart for Java サンプル実行例

root ~ $ cd /home/project/quickstarts-multimodel-java/src

root ~/quickstarts-multimodel-java/src $ javac -cp ".:../lib/intersystems-jdbc-

3.0.0.jar:../lib/intersystems-xep-3.0.0.jar" multimodelQS.java

root ~/quickstarts-multimodel-java/src $ java -cp ".:../lib/intersystems-xep-3.0.0.jar:../lib/intersystems-jdbc-3.0.0.jar" multimodelQS

Connected to InterSystems IRIS via JDBC.

Generating airport table...

Stored 5 airports

Name Code LocationAustin-Bergstrom International AUS Austin, TX 78719

Boston Logan International BOS Boston, MA 02128

Chicago O'hare International ORD Chicago, IL 60666

Philadelphia International PHL Philadelphia, PA 19153

San Francisco International SFO San Francisco, CA 94128root ~/quickstarts-multimodel-java/src $

XEP(オブジェクト)を使用してデータを登録し、SQL(ADO.NET)を使用して以下SQLの実行結果を出力しています。SELECT name, code, location->city,

location->state, location->zip

FROM demo.airport

詳細は、multimodelQS.java をご参照ください。

Page 17: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

17

図 8 Multimodel QuickStarts for Java:サンプル実行例(Native API)

Multimodel QuickStart for Java Native APIサンプル実行

1. multimodelQS.javaを開きます。 2. storeAirfare(irisNative);

checkAirfare(irisNative);

のコメントを外し保存します(Ctrl+Sで保存できます)。

3. コンパイルを行った後、実行します。

4. Native APIを利用して、グローバル変数^airportを作成し、空港間の距離を格納します。「Enter departure airport」に BOS

「Enter destination airport」に AUS

を指定してEnterすると、BOS-AUS間の距離がマイルで表示されます(1698マイル)。

Page 18: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

18

6) Multi-Model QuickStart for Python

図 9 Multimodel QuickStart for Pythonの使い方

マルチモデルについての詳細は、https://learning.intersystems.com/course/view.php?name=Multimodel をご参照ください。

サンプル実行例、Native APIのサンプル実行例については次ページ以降をご参照ください。

Multimodel QuickStart for Python の使い方 このサンプルでは、PythonからInterSystems IRIS Data Platform へのマルチモデルアクセスをお試しいただけます。

InterSystems IRIS driver for Native APIとPyODBCの

インストールを行うため、画面下部のターミナルを使用して以下のコマンドを実行してください。

このサンプルは、Multi-Model QuickStartを使用しています。Python アプリケーションから InterSystems IRIS へのリレーショナルアクセスと NativeAPI についてお試しいただけます。サンプルでは、SQLを使用してAirportデータの登録と情報取得を行い、 Native API を使用して空港間の経路情報を処理するためカスタムデータ構造を作成しています。

1が完了したら python multimodelQS.py を実行します。

Page 19: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

19

図 10 Multimodel QuickStarts for Python:サンプル実行例

Native APIを試すサンプルコードの使用方法は次ページをご参照ください。

root ~ $ cd /home/project/quickstarts-multimodel-python

root ~/quickstarts-multimodel-python $ pip install nativeAPI_wheel/irisnative-1.0.0-cp34-abi3-linux_x86_64.whl

The directory '/home/project/.cache/pip/http' or its parent directory is not owned by the current user and the

cache has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.

The directory '/home/project/.cache/pip' or its parent directory is not owned by the current user and caching

wheels has been disabled. check the permissions and owner of that directory. If executing pip with sudo, you may

want sudo's -H flag.

Processing ./nativeAPI_wheel/irisnative-1.0.0-cp34-abi3-linux_x86_64.whlInstalling collected packages: irisnative

Successfully installed irisnative-1.0.0

root ~/quickstarts-multimodel-python $ odbcinst -i -d -f pyodbc_wheel/odbcinst.ini

odbcinst: Driver installed. Usage count increased to 1.

Target directory is /etc

root ~/quickstarts-multimodel-python $ python multimodelQS.pyConnected to InterSystems IRIS

Name Code Location

Boston Logan International BOS Boston, MA 02128

Philadelphia International PHL Philadelphia, PA 19153

Austin-Bergstrom International AUS Austin, TX 78719San Francisco International SFO San Francisco, CA 94128

Chicago O'hare International ORD Chicago, IL 60666

root ~/quickstarts-multimodel-pyt

InterSystems IRISのNative API用ドライバとPyODBCをインストールします。

サンプルプログラムを実行します。

SQLでデータを登録し、以下SQLの実行結果を出力しています。SELECT name, code, location->city, location-

>state, location->zip

FROM demo.airport

詳細は、multimodelQS.py をご参照ください。

Page 20: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

20

図 11 Multimodel QuickStarts for Python:サンプル実行例(Native API)

Multimodel QuickStart for Python Native APIサンプル実行

1. multimodelQS.pyを開きます。

2. storeAirfare(iris_Native);

checkAirfare(iris_Native);

のコメントを外し保存します(Ctrl+Sで保存できます)。

3. 実行します。python multimodelQS.ps

4. Native APIを利用して、グローバル変数^airportを作成し、空港間の距離を格納します。「Enter departure airport」に BOS

「Enter destination airport」に AUS

を指定してEnterすると、BOS-AUS間の距離がマイルで表示されます(1698マイル)。

Page 21: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

21

7) 他の QuickStartのサンプルを IDEに取り込む

Gitに公開中の QuickStart Node.js のサンプルを取り込む方法をご紹介します。ソースの URLは https://github.com/intersystems/quickstarts-nodejs です。

図 12 git clone で他のサンプルを IDEに取り込む方法(Node.js QuickStartsの例)

root ~ $ git clone https://github.com/intersystems/quickstarts-nodejs

Cloning into 'quickstarts-nodejs'...

remote: Enumerating objects: 78, done.

remote: Total 78 (delta 0), reused 0 (delta 0), pack-reused 78Unpacking objects: 100% (78/78), done.

root ~ $

git clone で他の公開されているサンプルをIDEに取り込む

git cloneにより、quickstarts-nodejsがツリーに追加されます。フォルダを展開し、README.mdを開き、ターミナルで指定コマンドを実行します。

Page 22: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

22

図 13 Node.js QuickStarts README.mdの実行手順

root ~ $ cd quickstarts-nodejs/Solutions

root ~/quickstarts-nodejs/Solutions $ npm install --save intersystems-iris-native

npm WARN [email protected] No description

+ [email protected]

added 1 package and audited 1 package in 0.896s

found 0 vulnerabilities

root ~/quickstarts-nodejs/Solutions $ npm install readline-syncnpm WARN [email protected] No description

+ [email protected]

added 1 package from 1 contributor and audited 2 packages in 0.725s

found 0 vulnerabilities

root ~/quickstarts-nodejs/Solutions $ npm install file-system

npm WARN [email protected] No description

+ [email protected] 3 packages from 1 contributor and audited 6 packages in 1.132s

found 0 vulnerabilities

root ~/quickstarts-nodejs/Solutions $

Node.js QuickStart README.md の実行例

Page 23: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

23

図 14 Node.js QuickStarts:サンプル実行前の接続情報修正

IRISお試し環境をご利用の方は、以下ページにログインすると現在のお試し環境のアクセス情報をご確認いただけます(次ページもご参照ください。)。

https://learning.intersystems.com/course/view.php?name=Java%20Build

Node.js QuickStart サンプルjs 実行ための接続先情報修正

connections.configの接続情報を修正します。

Page 24: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

24

図 15 IRISお試し環境:接続情報確認ページ

IRIS お試し環境作成時に登録したメールアドレスでログインできますが、オンラインラーニング未登録の方は、大変お手数ですが次ページの手順でご登録いただき、ログ

インを行ってください。

2. Log in からログインします。

1. 展開します

ログイン後、接続情報が表示されます。

Page 25: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

25

図 16 IRISお試し環境:オンラインラーニング本登録までの流れ

ユーザ登録が完了したらオンラインラーニングにログインし、こちらのページの「Launch InterSystems IRIS」から接続情報をご確認ください。

2. IRISお試し環境でご記入いただいた

メールアドレスを指定し、「私はロボットではありません」にチェックを入れ質問に回答し、「Continue」ボタンを押下します。

3. 入力されたメールに仮パスワードが記載されているのでログイン画面に戻り、ログインを行います。

4. ログイン画面でメールアドレスと仮パスワードを入力すると、本登録用情報入力画面が表示されます。*印は必須項目です。ご登録後、参照ページにアクセスします。

1. Forgot Password のリンクより、IRISお試し環境作成時のメールアドレスを指定して仮パスワードを発行画面に移動します。

Page 26: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

26

サンプル実行例は以下の通りです(例は、nodeplaystocksTask5.js の実行例)。

図 17 Node.js QuickStarts:サンプル実行例

Node.js QuickStart サンプルjsの実行

root ~/quickstarts-nodejs/Solutions $ node nodeplaystocksTask5.js

platform = linux: debianConnected to InterSystems IRIS1. Test

2. Store Stock Data3. View stock data

4. Generate Trades5. Call routines6. Quit

What would you like to do? 2Storing stock data using Native API...

Stored natively successfully. Execution time: 0.4250ms1. Test2. Store Stock Data

3. View stock data4. Generate Trades

5. Call routines6. QuitWhat would you like to do? 5

on InterSystems IRIS version: IRIS for UNIX (Ubuntu Server LTS for x86-64 Containers) 2019.2 (Build 100U) Wed May 12019 18:06:59 EDT1. Test

2. Store Stock Data3. View stock data4. Generate Trades

5. Call routines6. Quit

What would you like to do? 6Exited

Page 27: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

27

8) システム統合ツールを試す

InterSystems IRISの統合ツールを使用して、データを簡単に共有、調整、変換など行えます。お試しいただくためには、InterSystems IRIS Management Portal(管理

ポータル)→[Interoperability]→[構成]→[プロダクション] メニューを開きます。

図 18 Interoperability QuickStarts:プロダクション

サンプル環境では、トラフィックカメラから赤信号時に通過した車のデータが Demo.RedLights プロダクションへ渡されます(プロダクションは IRIS が開始すると同時に開始し

ています)。送信されてくるデータ(車の通過地点、ナンバープレート、日付時刻、車種)の内容に合わせ、交通違反のチケットアプリケーションへの登録を行うか、行わないかを

判断する仕組みを取り入れています2。

サンプルでは、車種が「ambulance(救急車)」「police(パトカー)」「firetruck(消防車)」の場合は、ホワイトリストとして登録し、交通違反のチケットアプリケーションへの登録

は行われないように設定しています。

この流れを確認するためには、サンプルデータを指定フォルダに配置し処理を実行した後、メッセージトレースを使用して内容を確認します。

図解は次ページをご参照ください。

2 詳細は、Interoperability QuickStartsのビデオをご参照ください。

Page 28: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

28

図 19 Interoperability QuickStarts:テスト

データの流れを確認するため、管理ポータル→[Interoperability]→[表示]→[メッセージ] からトレース画面で流れを確認します。

直近 4件分のトレースを確認します。パトカーの時だけ、TicketApplication を呼び出していないことがわかります。

図解は次ページをご参照ください。

/shared/Samples-Integration-RedLights/data/SampleFiles

にあるCSVファイルをコピーし(Ctrl+C)以下フォルダに貼り付けます。/shared/Samples-Integration-RedLights/data/in

SL1LLLのナンバーの車種はパトカーのため、TicketApplicationへは登録されない予定です。

Page 29: InterSystems IRIS お試し環境 専用 IDE の使い方ガ …IRISお試し環境に用意されるWebベースのIDEを利用して、IRISに接続するクライアント側(.NET/Java/Node.js/Python)サンプルコードや実行方法を確認できま

【Try IRIS】 IDEの使い方

29

図 20 Interoperability QuickStarts:メッセージトレースでの確認

SL1LLLのナンバーの車種はパトカーのため、TicketApplicationを呼び出していません。