InterSystems IRIS の基礎 ： IDE の接続

ライセンス付与されたインスタンスの導入

インターシステムズから 1 つ以上のライセンスを購入した場合は、以下のいずれかの方法を使用して、ライセンス付与された InterSystems IRIS インスタンスを導入できます。

• InterSystems Kubernetes Operator

• InterSystems IRIS コンテナ・イメージ

• InterSystems IRIS インストール・キット

コンテナ・イメージまたはインストール・キットから導入する場合、構成マージ機能を使用して自動導入をサポートできます。

無料の評価版インスタンスの導入

まだ InterSystems IRIS ユーザではない場合は、無料の評価版インスタンスを導入することで、InterSystems IRIS のさまざまな機能の詳細を確認し、お好みの言語とツールおよび独自のコードを使用してそれらの機能を試してみることができます。これを行うには、以下のような方法があります。

• パブリック・クラウド・ノードで、Google Cloud Platform、Microsoft Azure、または Amazon Web Services のアカウントを作成するか、いずれかにログインして、プラットフォームのマーケットプレイスのページに進み、InterSystems IRIS を検索します。

• 任意のシステムのコンテナで、InterSystems Container Registry (ICR)Opens in a new tab または Docker HubOpens in a new tab から Community Edition イメージをプルします。

InterSystems Kubernetes Operator

Kubernetes の導入に、必要に応じて外部 IP アドレスを使用して、ポッドとポッドに含まれるコンテナをネットワークに公開するサービスOpens in a new tabを含めることができます。IKO で導入する InterSystems IRIS トポロジに関係なく、プライマリ・データ・ノード (シャード・クラスタのデータ・ノード 1、分散キャッシュ・クラスタのデータ・サーバ、またはスタンドアロン・インスタンス) を公開するためのサービスが常に作成されます。このサービスを使用して、プライマリ・データ・ノード上の InterSystems IRIS インスタンスのスーパーサーバ・ポート (1972) または Web サーバ・ポート (80) に接続する方法の詳細は、"InterSystems Kubernetes Operator の使用" の "IrisCluster への接続Opens in a new tab" を参照してください。

IDE 接続または管理ポータルに必要な認証情報には、事前定義のユーザ・アカウントの 1 つと configSource フィールドで指定した構成マージ・ファイル内の PasswordHashOpens in a new tab パラメータを使用して設定した既定のパスワード、あるいはインスタンスに以前追加したアカウントとパスワードを使用します。

プライマリ・データ・ノード・インスタンスのターミナルを開くには、以下のコマンドを使用します。

kubectl exec -it IrisCluster_name-data-0 iris terminal IRIS

導入がミラーリングされている場合は、代わりにポッド名 IrisCluster_name-data-0–0 を使用して、現在のプライマリでターミナルを開きます。インターシステムズのどのコンテナでも、インスタンス名は常に IRIS です。InterSystems IRIS コンテナの外部から docker exec を使用して発行されたコマンド、および結果的に kubectl exec は、コンテナ内部で irisowner として実行Opens in a new tabされ、認証を必要としないため、ターミナルにログインする必要はありません。

すべての InterSystems IRIS インスタンスに存在する USER ネームスペースには常に IDE を接続できますが、管理ポータルを使用して以前作成した別のネームスペースに接続することもできます。

コンテナに導入された InterSystems IRIS

"コンテナ内でのインターシステムズ製品の実行" の "Web ゲートウェイ・コンテナを使用した Web アクセスOpens in a new tab" で詳細に説明しているように、InterSystems IRIS 管理ポータルは組み込みの Web アプリケーションであるため、これをブラウザにロードするには、Web サーバおよびインターシステムズの Web ゲートウェイが必要です。ただし、複数の InterSystems IRIS コンテナとやり取りするよう構成されている単一の Web ゲートウェイ・インスタンスでは、すべてのインスタンスに共通するアプリケーションの要求を特定のインスタンスに転送することはできません。

管理ポータルからコンテナ化された InterSystems IRIS インスタンスにアクセスできるようにする簡単な方法の 1 つとして、各 InterSystems IRIS コンテナに専用の Web ゲートウェイ・コンテナ (Web サーバも含む) を実行する方法があります。専用の Web ゲートウェイ・コンテナは、ペアになっている InterSystems IRIS コンテナとのみやり取りするよう構成されます。これは、Web サーバ層が必要な導入の場合、さらに Web ゲートウェイ・コンテナを追加する必要があります。専用の Web ゲートウェイ・コンテナおよび Web サーバ・ノードの Web ゲートウェイ・コンテナを実行する方法、および管理ポータルからコンテナ化された InterSystems IRIS インスタンスにアクセスできるようにするその他の方法に関する詳細と手順は、"Web ゲートウェイ・コンテナの実行オプションOpens in a new tab" を参照してください。

IDE 接続または管理ポータルに必要な認証情報には、事前定義のユーザ・アカウントの 1 つとコンテナの作成時に設定した既定のパスワードOpens in a new tab、あるいはインスタンスに以前追加したアカウントとパスワードを使用します。

コンテナ内のインスタンスのターミナルを開くには、コンテナ内で docker exec コマンドを使用して iris terminal コマンドを実行するか、コンテナ内で docker exec を使用してシェルを開き、そのシェルから iris terminal を実行できます。使用例は、"InterSystems IRIS の導入と操作" の "InterSystems ターミナルを使用した操作" を参照してください。インターシステムズのどのコンテナでも、インスタンス名は常に IRIS です。InterSystems IRIS コンテナの外部から docker exec を使用して発行したコマンドは、コンテナ内部で irisowner として実行Opens in a new tabされ、認証を必要としないため、ターミナルにログインする必要はありません。

すべての InterSystems IRIS インスタンスに存在する USER ネームスペースには常に IDE を接続できますが、管理ポータルを使用して以前作成した別のネームスペースに接続することもできます。

キットからインストールされた InterSystems IRIS

キットからインストールする InterSystems IRIS インスタンスの場合、ホスト ID はインスタンスが実行されているシステムのホスト名と IP アドレスです。ローカルにインストールする場合は localhost を使用できます。

InterSystems IRIS のインストールでは、スーパーサーバのポートは既定で 1972 に設定されます。ただし、1 つのシステムに InterSystems IRIS のインスタンスを複数インストールしている場合は、インスタンスのスーパーサーバのポート番号は変わります。すべてのインスタンスのポート番号を表示するには、オペレーティング・システムのコマンド行で iris listOpens in a new tab コマンドを使用します。

管理ポータルを開くには、すべてのシステムで、"Web ゲートウェイ・ガイド" の "Web サーバを使用した管理ポータルおよび他の組み込みの Web アプリケーションへのアクセスOpens in a new tab" に記載されている URL を使用できます。Windows システムの場合、Web ゲートウェイおよび Web サーバが正しく構成されていれば、システム トレイにある InterSystems IRIS のアイコンをクリックして [管理ポータル] を選択することで、管理ポータルを開くことができます。

インストールしたインスタンスのターミナルを開くには、次の操作を行います。

• Windows システムの場合、InterSystems IRIS ランチャー・メニューOpens in a new tabの [ターミナル] オプションを選択できます。

• すべてのシステムで、オペレーティング・システムのコマンド行で、引数としてインスタンス名を指定して iris terminalOpens in a new tab コマンドを使用できます。インスタンス名は、インスタンスをインストールした際に設定され、変更することはできません。インスタンス名を表示するには、iris list コマンドを使用します。

すべての目的で、資格情報には、事前定義のユーザ・アカウントOpens in a new tabの 1 つと既定のパスワード SYS (これらのアカウントの 1 つにログインすると、直ちにパスワードを変更するよう求められます)、またはインスタンスに以前追加したアカウントとパスワードを使用します。

すべての InterSystems IRIS インスタンスに存在する USER ネームスペースには常に IDE を接続できますが、管理ポータルを使用して以前作成した別のネームスペースに接続することもできます。

InterSystems IRIS Community Edition

Community Edition インスタンスで管理ポータルにアクセスする方法の詳細は (この点に関しては、他のタイプのインスタンスと異なります)、"InterSystems IRIS の導入と操作" の "管理ポータルを使用した操作Opens in a new tab" を参照してください。

任意の Community Edition インスタンスのターミナルを開く方法の詳細は、"InterSystems IRIS の導入と操作" の "InterSystems ターミナルを使用した操作" を参照してください。

IDE 接続および管理ポータルに必要な認証情報には、事前定義のユーザ・アカウントOpens in a new tabの 1 つと、クラウド・ノードに初めて接続した際のパスワードの変更Opens in a new tabで指定した新しい既定のパスワード、または既定パスワード SYS (独自のシステムにいるか、最初にノードに接続せずにクラウド・インスタンスにログインした場合) を使用します。SYS を使用する場合、使用しているアカウントのパスワードをすぐに変更するよう求められます。インスタンスで以前作成したアカウントを使用することもできます。

すべての InterSystems IRIS インスタンスに存在する USER ネームスペースには常に IDE を接続できますが、管理ポータルを使用して以前作成した別のネームスペースに接続することもできます。

InterSystems Learning Labs

InterSystems Learning Labs の構成に含まれるコンテナ化された InterSystems IRIS インスタンスへの接続はすべて Learning Labs の起動時に設定され、以下の必要な接続情報はすべて起動ページに表示されます。

• 統合 IDE の URL。

• すべての目的で使用できる一連の資格情報。

• 管理ポータルの URL。

• Web サーバのポート番号 (常に 80)。

• [外部接続] の下に表示されるサーバの IP アドレスおよびスーパーサーバのポート番号 ([InterSystems IP] および [InterSystems ポート] というラベルが付いている)。これらを使用して IDE (InterSystems スタジオや Object Script 拡張機能付きの Visual Studio Code など) をインスタンスに接続できます。

統合 IDE でターミナルのオプションは [InterSystems] メニューから使用できる (管理ポータルのオプションも同様) ので、常にインスタンス名に気を配る必要はありません。

Visual Studio Code

Visual Studio Code (VS Code) は、Microsoft によって開発された、Windows、Linux、および macOS 向けの無料のソース・コード・エディタです。VS Code は、.NET IDE、Python IDE、または JavaScript IDE としてすぐに InterSystems IRIS で使用できますが、提供されている拡張機能を使用すると、VS Code を利用して ObjectScript でコードを開発することも可能です。このコードは、クライアント・システムに保存されてバージョン管理され、InterSystems IRIS サーバでコンパイル、実行、およびデバッグされます。VS Codeは、InterSystems IRIS インスタンスが実行されているプラットフォームに関係なく、ホストの DNS 名か IP アドレス、インスタンス名、およびインスタンスの Web サーバのポート番号を使用して、あらゆる InterSystems IRIS インスタンスに接続できます。インストールと使用の手順は、"Use Visual Studio Code as a Development Environment for InterSystems ApplicationsOpens in a new tab" を参照してください。

スタジオ

InterSystems IRIS アプリケーション開発者はスタジオ IDE を使用することもできます。スタジオ IDE は、Windows システム上で動作するクライアント・アプリケーションです。詳細は、"スタジオの使用法" を参照してください。スタジオは、インスタンスが実行されているプラットフォームに関係なく、ホストの DNS 名か IP アドレス、インスタンス名、およびインスタンスのスーパーサーバのポート番号 (既定で 1972 ですが、システムに複数のインスタンスがインストールされている場合は異なる可能性があります) を使用して、あらゆる InterSystems IRIS インスタンスに接続できます。

Visual Studio Code

Visual Studio Code を InterSystems IRIS に接続するには、以下の手順を使用します (必要に応じて GitHub にログインします)。

1. Web ブラウザで、https://github.com/intersystems/Samples-java-helloworldOpens in a new tab をダウンロードまたは複製します。

2. Visual Studio Code で、[ファイル]→[フォルダーを開く] を使用して、GitHub から最近ダウンロードまたは複製したフォルダを開きます。

3. src/main/java.com.intersystems.samples.helloworld.java を選択して開きます。

4. メイン・メソッドの上部にある変数宣言でインスタンスのユーザ名、パスワード、IP アドレス、およびスーパーサーバのポートを構成します ("InterSystems IRIS 接続情報" を参照)。これらの値は、jdbc:IRIS://ipAddress:webserverPort/namespace (例 ： jdbc:IRIS://12.345.678.910:1972/USER) の形式の InterSystems JDBC 接続文字列の作成に使用します。

5. [表示]→[端末] を使用して端末を開き、以下のコマンドを実行します。

   javac -cp ".:intersystems-jdbc-3.2.0.jar" HelloWorld.java
   java -cp ".:intersystems-jdbc-3.2.0.jar" HelloWorld
   
   

   

6. [出力] ペインに、以下のメッセージが表示されます。"Hello World! You have successfully connected to InterSystems IRIS via JDBC."

Eclipse

Eclipse を InterSystems IRIS に接続するには、以下の手順を使用します (必要に応じて、各ダイアログの次のパネルに進むには、[次へ] をクリックします)。

まず、サンプル・パッケージをインポートします。

1. [ファイル]→[インポート]→[Git]→[Git からプロジェクト] を選択します。

2. [URI の複製] を選択します。https://github.com/intersystems/Samples-java-helloworldOpens in a new tab をコピーして、[URI] フィールドに貼り付けます。

3. [master] ブランチを選択し、ローカル・ストレージを構成して、[Import existing Eclipse projects] を選択します。

4. [終了] をクリックしてインポートを確定します。

次に、サンプル・コードを更新して、実行します。

1. [samples-java-helloworld]→[src]→[main.java.com.intersystems.samples]→[HelloWorld.java] を開き、以下のように変更します。

   1. 上部にあるパッケージ宣言を [package main.java.com.intersystems.samples;] に変更します。

   2. メイン・メソッドの上部にある変数宣言でインスタンスのユーザ名、パスワード、IP アドレス、およびポートを構成します ("InterSystems IRIS 接続情報" を参照)。これらの値は、jdbc:IRIS://ipAddress:superserverPort/namespace (例 ： jdbc:IRIS://12.345.678.910:1972/USER) の形式の InterSystems JDBC 接続文字列の作成に使用します。

2. [実行]→[実行] を選択して、コードを実行します。

3. [コンソール] タブに、以下のメッセージが表示されます。"Hello World! You have successfully connected to InterSystems IRIS via JDBC."

成功しなかった場合は、以下の手順を実行して、Java 実行環境が適切に設定されていることを確認します。

1. [パッケージ・エクスプローラー] ペインで [samples-java-helloworld] プロジェクトを右クリックして、[ビルド・パス]→[ビルド・パスの構成...] を選択します。

2. [ライブラリー] タブで、[ライブラリーの追加]→[JRE システム・ライブラリ]→[実行環境] を選択し、[JRE-1.1 (jre 1.8.0_172)] などの実行環境を選択します。[完了]、[適用して閉じる] を順にクリックします。

IntelliJ

IntellliJ を InterSystems IRIS に接続するには、以下の手順を使用します (必要に応じて、各ダイアログの次のパネルに進むには、[Next] をクリックします)。

まず、サンプル・プロジェクトを作成します。

1. [VCS]→[Checkout from Version Control]→[Git] を選択します。

2. [Clone Repository] ダイアログで以下の操作を行います。

   1. https://github.com/intersystems/Samples-java-helloworldOpens in a new tab をコピーして、[Clone URI] フィールドに貼り付けます。

   2. [Directory] フィールドに、ローカル GitHub リポジトリの作成場所へのパスを入力します。

3. [Clone] をクリックし、このソースに基づいてプロジェクトを作成することを確認するポップアップで [Yes] を選択します。

次に、サンプル・コードを更新して、実行します。

1. src/main/java.com.intersystems.samples.helloworld.java を開き、メイン・メソッドの上部にある変数宣言でインスタンスのユーザ名、パスワード、IP アドレス、およびポートを構成します ("InterSystems IRIS 接続情報" を参照)。これらの値は、jdbc:IRIS://ipAddress:superserverPort/namespace (例 ： jdbc:IRIS://12.345.678.910:1972/USER) の形式の InterSystems JDBC 接続文字列の作成に使用します。

2. [Project] ペインで、[HelloWorld.java] を右クリックして、[Run ‘HelloWorld.main()’] を選択します。

3. [出力] ペインに、以下のメッセージが表示されます。"Hello World! You have successfully connected to InterSystems IRIS via JDBC."

成功しなかった場合は、以下の手順を実行して、Java 実行環境が適切に設定されていることを確認します。

1. [Build Path]→[Build Project] を選択します。

2. 構成を編集し、メイン・クラスに [com.intersystems.samples.HelloWorld] を選択して、新しいアプリケーション構成を追加します。

3. エラー "Error:java: invalid source release: 9" が表示されたら、以下の場所でプロジェクト SDK とプロジェクト言語レベルを 1.8 に変更します。

   • [File]→[Project Structure]→[Project Settings]

   • [File]→[Project Structure]→[Module Settings]→[Sources: Language Level] タブ

   • [File]→[Project Structure]→[Module Settings]→[Dependencies: Module SDK] タブ

NetBeans

NetBeans を InterSystems IRIS に接続するには、以下の手順を使用します (必要に応じて、各ダイアログの次のパネルに進むには、[次] をクリックします)。

まず、サンプル・プロジェクトを作成します。

1. [チーム]→[Git]→[クローン] を選択します。

2. https://github.com/intersystems/Samples-java-helloworldOpens in a new tab をコピーして、[リポジトリURL] フィールドに貼り付けます。

3. フェッチする分岐として [Master] を選択し、ローカル GitHub リポジトリの作成場所を選択して、[終了] をクリックします。

次に、サンプル・コードを更新して、実行します。

1. HelloWorld.java を開き、メイン・メソッドの上部にある変数宣言でインスタンスのユーザ名、パスワード、IP アドレス、およびポートを構成します ("InterSystems IRIS 接続情報" を参照)。これらの値は、jdbc:IRIS://ipAddress:superserverPort/namespace (例 ： jdbc:IRIS://12.345.678.910:1972/USER) の形式の InterSystems JDBC 接続文字列の作成に使用します。

2. [プロジェクト] ペインで、[依存性] フォルダを開き、[intersystems-jdbc-3.0.0.jar] を右クリックして、[アーティファクトを手動でインストール] を選択します。最近複製したフォルダに移動して、[intersystems-jdbc-3.0.0.jar] を選択し、[ローカルにインストール] をクリックします。

3. [プロジェクト] ペインで HelloWorld.java を右クリックして、[ファイルの実行] を選択します。

4. [出力] ペインに、以下のメッセージが表示されます。"Hello World! You have successfully connected to InterSystems IRIS via JDBC."

Visual Studio

Visual Studio を InterSystems IRIS に接続するには、以下の手順を使用します (必要に応じて GitHub にログインします)。

まず、サンプル・ソリューションを作成します。

1. [表示]→[チーム エクスプローラー] を選択します。

2. [チーム エクスプローラー – 接続] ペインで、[ローカル Git リポジトリ]→[複製] を選択し、https://github.com/intersystems/Samples-dotnet-helloworldOpens in a new tab をコピーして [URL] ボックスに貼り付け、[複製] をクリックします。

次に、サンプル・コードを更新して、実行します。

1. HelloWorld.sln をダブルクリックしてソリューション内のファイルを表示し、helloworld.cs を開きます。

2. 変数宣言を使用して、インスタンスのユーザ名、パスワード、IP アドレス、およびポートを構成します ("InterSystems IRIS 接続情報" を参照)。

3. F5 キーを押して、プログラムを実行します。

4. コマンド・ウィンドウに、以下のメッセージが表示されます。"Hello World! You have successfully connected to InterSystems IRIS.Press any key to continue."

Visual Studio Code

ObjectScript 拡張機能を利用すると、InterSystems IRIS で Visual Studio Code を使用して ObjectScript コードを開発できます。詳細は、"ObjectScript IDE" を参照してください。

Visual Studio Code を InterSystems IRIS に接続するには、以下の手順を使用します (必要に応じて GitHub にログインします)。

1. Web ブラウザで、https://github.com/intersystems/Samples-dotnet-helloworldOpens in a new tab をダウンロードまたは複製します。

2. Visual Studio Code で、[ファイル]→[フォルダーを開く] を使用して、GitHub から最近ダウンロードまたは複製したフォルダを開きます。

3. [samples-dotnet-helloworld] を展開し、[helloworld.cs] を選択します。

4. 変数宣言を使用して、インスタンスのユーザ名、パスワード、IP アドレス、およびポートを構成します ("InterSystems IRIS 接続情報" を参照)。

5. [表示]→[端末] を使用して端末を開き、以下のコマンドを実行します。

   csc /reference:InterSystems.Data.IRISClient.dll helloworld.cs
   .\helloworld.exe
   

   

6. [出力] ペインに、以下のメッセージが表示されます。"Hello World! You have successfully connected to InterSystems IRIS.Press any key to continue."