自己学習メモインデックス

IBM i (旧AS400）の自己学習メモ　インデックス

概要

データ転送ツールを利用したデータの取得では、手順が多くかなり面倒なことが多いです。
もちろんWRKQRYやSTRSQLでも対象のデータを調査することは可能ですが、5250の画面ではどうしても大量のデータで多くのカラムのデータを参照することは向いていません。
EclipseのプラグインであるDBeaverを利用して、AS400に接続してSQLを実行することで、5250の画面に依存しないデータの調査や取得を簡単に実現したいと思います。

ここではPUB400.comを利用している前提の手順です。
自社の環境で利用する場合、ホスト名の部分や、ポート番号などが異なりますのでその辺は読み替えてください。

環境情報

Eclipse 2020-03
DBeaver

DBeaverを利用したAS400への接続設定

Eclipseの環境構築

EclipseのAll in oneパッケージとなっているPleiades All in Oneを利用します。
https://mergedoc.osdn.jp/

Windows版であればzipを解凍してすぐ使えますし、Mac版ではdmgファイルを使ってインストールを進めるだけで利用可能です。
細かい手順については割愛します。

EclipseにDBeaverのインストール

Eclipseを起動して、[ヘルプ] -> [Eclipseマーケットプレース]を選択し、検索ボックスに「DBeaver」と入力してEnter
出てきたDBeaverの[インストール]ボタンを押下してインストールする。

インストールが完了すると、Eclipseの再起動を求められるので再起動しておくこと。

EclipseのパースペクティブにDBeaverを追加して表示する

[ウインドウ] -> [パースペクティブ] -> [パースペクティブを開く] -> [その他]を選択
[DBeaver]を選択して[開く]ボタンを押下

下図の赤枠のDBeaverパースペクティブが選択されている状態（DBeaverパースペクティブが表示されている状態）にすればOK。

AS400へ接続するためのDBeaverの設定

まずDBeaverで接続情報を設定する前に、プロジェクトを作成する必要があります。
プロジェクトビューの[プロジェクトの作成]ボタンを押下

任意のプロジェクト名を入力して[完了]ボタンを押下

作成したプロジェクト名を右クリック -> [作成] -> [接続]

左ペインの[すべて]を選択した状態で、検索ボックスに"DB2"と入力して検索し、
DB2 iSeries/AS 400を選択して[次へ]ボタンを押下

以下の設定をする

JDBC URL
- jdbc:as400://PUB400.com;libraries=YAMAGUCHI1;
- JDBC URL自体は、手入力する必要はありません。以下のホストとデータベース/スキーマの設定をすることで自動生成されます。
ホスト
- PUB400.com
- 自社の環境であればそれに合わせてください。ホスト名で名前解決できない環境の場合は、IPアドレスを入力してください。
ポート
- デフォルトでは446です。PUB400.comでは変更する必要はありません。
データベース/スキーマ
- YAMAGUCHI1
- PUB400.comで利用している自分のライブラリを指定します。（PF/LFのオブジェクトが格納されているライブラリ）
ユーザー名
- ログインユーザー名
パスワード
- ログインパスワード

上記設定は、Eclipseの環境で適切なJDBCドライバのクラスパスが参照できていて、利用できる状態で初めて有効な設定となります。
Eclipseを新規インストールしたばかりの状態だと、AS400JDBCDriverのクラスが利用できる状態でないため、JDBCドライバをダウンロードしておく必要があります。

[ドライバの設定を編集]ボタンを押下し、表示された画面の[ダウンロードと更新]ボタンを押下する。

[ダウンロード]ボタンを押下する

これで適切なJDBCドライバがダウンロードされます。
以上の手続きが完了したら[OK]ボタンを押下して設定を完了します。

DBeaverを利用してAS400に接続してSQLを実行

上記手順まで完了すると、AS400への接続情報が登録できているので、プロジェクトビューの
[プロジェクト名] -> [Connections] -> [DB2 iSeries/AS 400...]が追加されている状態となります。
これを右クリック -> [接続する]を選択してAS400へ接続する。

接続が完了すると下図のようにデータベース情報が展開できて、例えばテーブルの一覧などが確認できます。

F3キーを押下すると新規でSQLエディターを開くことができます。
開いたSQLエディタに任意のSQLを入力し、実行ボタンを押下すると、画面下部のビューに実行結果が表示されます。

Eclipseにマーケットプレイスが無い場合

この記事ではPleiades all in oneを利用しているためマーケットプレイスは利用可能でしたが、
マーケットプレイス自体もプラグインなので、デフォルトでインストールされていないプレーンなEclipseを導入している場合は、マーケットプレイスが無い場合もあるようです。

https://www.eclipse.org/downloads/
からダウンロードしてWindows10環境にセットアップしてみましたが、マーケットプレイスがあったため、再現はできませんでした。

なので、参考となる情報だけ記載します。
https://ex1.m-yabe.com/archives/3919

この記事にあるように、Eclipseのヘルプ -> 新規ソフトウェアのインストールから、
http://download.eclipse.org/mpc/neon/ のURLを追加して、
EPPマーケットプレイス・クライアンスプラグインをインストールすることでマーケットプレイスが出てくるようです。

Windows環境でのEclipse＋DBeaver

Windows環境でもあまり苦労せず（特にJavaを別途インストールしてセットアップするなどの苦労をせず）に、
Eclipse環境を構築可能な、Pleiades all in oneで用意してくれているEclipse環境を前提に、
Windows10環境でEclipseの環境構築をしてマーケットプレイスを利用するところまでの手順参考までに記載します。

まず下記サイトにアクセスします。
https://mergedoc.osdn.jp/

アクセスしたら、Eclipse 2020をクリックします。

JavaのFull EditionのDownloadボタンをクリックします。

Downloadが完了したら、任意のディレクトリにEclipseを解凍します。
※解凍する際にいくつか注意点があるため、Pleiadesのサイトの注意書きをよく読んでください。

ポイントとしては

注意書きにある通り 7-Zip を使って解凍する。
展開されるファイルのフルパスが２６０文字を超えると正常に動作しないため、深いディレクトリ階層には解凍しない。
- 例えばデスクトップなどに展開すると、パスが深くなってしまうため、CやDドライブ直下にEclipseなどのディレクトリを作り、そこに展開する。

Eclipseを起動して、[ヘルプ] -> [Eclipseマーケットプレース]を選択し、検索ボックスに「DBeaver」と入力してEnter
出てきたDBeaverの[インストール]ボタンを押下してインストールする。

ここから先は、本記事の内容の通りに「DBeaver」を設定すればOKです。