2023年4月7日金曜日

Oracle AI Database 26ai Free VirtualBox ApplianceでOracle APEXを使う

更新: 2026年1月30日

Oracle AI Database 26ai Freeは、VirutalBoxの仮想マシンとしても提供されています。

ダウンロード

以下が概要になります。
  • Oracle Linux 8.10
  • Oracle AI Database 23.26
  • Oracle REST Data Services 25.3
  • Oracle SQLcl 25.3
  • Oracle APEX 24.2
  • JDK 21.0.5
上記の仮想マシンをダウンロードした後、VirtualBox(今回使用したバージョンは7.2.4)にインポートして起動し、Oracle APEXの使い勝手を確認してみました。x86_64しかないため、ARMに移行しているMacユーザーは利用できません。また、残念なことにAPEXは日本語化されていませんでした。

以下より、日本語リソースをロードする方法を紹介します。手順自体は、一般的なOracle APEXの言語リソースのロード作業です。

ダウンロードしたOracle_AI_Database_26ai_Free.ovaをVirtualBoxにインポートした直後の状態から作業を始めます。

インポートした仮想マシンを起動すると、データベースとORDSも同時に起動します。ディスプレイ表示倍率を上げると、コンソールが広くなります。


ターミナルも開きますが、私の環境ではキーマップが異なり、この画面のターミナルからの作業は今ひとつでした。コンソールの外からコピぺもできません。


ネットワークポートフォワーディングの設定を確認すると、sshのポートがホストの2223に割り当てられています。


なので、ローカルのマシンのターミナルからSSHで接続し、作業をすることにします。

ssh -p 2223 oracle@localhost

~ % ssh -p 2223 oracle@localhost         

The authenticity of host '[localhost]:2223 ([127.0.0.1]:2223)' can't be established.

ED25519 key fingerprint is SHA256:KAd6f3AsAB7inP+X63xYLJWQckmqPyORYKDipVgSPCk.

This key is not known by any other names.

Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

Warning: Permanently added '[localhost]:2223' (ED25519) to the list of known hosts.

oracle@localhost's password: ********

Activate the web console with: systemctl enable --now cockpit.socket


Last login: Fri Jan 30 01:44:23 2026

[oracle@localhost ~]$ 


仮想マシンにはOracle APEXの言語リソースが含まれていません(/home/oracle/apex以下にbuilderが含まれていない)。インストールされているOracle APEXのバージョンは24.2であるため、以下のリンクより日本語リソースを含んだアーカイブをダウンロードします。

mkdir temp
cd temp
curl -OL https://download.oracle.com/otn_software/apex/apex_24.2.zip

[oracle@localhost ~]$ mkdir temp

[oracle@localhost ~]$ cd temp

[oracle@localhost temp]$ curl -OL https://download.oracle.com/otn_software/apex/apex_24.2.zip

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100  289M  100  289M    0     0  6443k      0  0:00:45  0:00:45 --:--:-- 5718k

[oracle@localhost temp]$ 


ダウンロードしたapex_24.2.zipを解凍します。

unzip -q apex_24.2.zip
ls apex

[oracle@localhost temp]$ unzip -q apex_24.2.zip 

[oracle@localhost temp]$ ls apex

LICENSE.txt                 apxdevrm_cdb.sql    apxrtins_cdb.sql

apex_rest_config.sql        apxdevrm_nocdb.sql  apxrtins_nocdb.sql

apex_rest_config_cdb.sql    apxdvins.sql        apxsilentins.sql

apex_rest_config_core.sql   apxdvins_cdb.sql    builder

apex_rest_config_nocdb.sql  apxdvins_nocdb.sql  core

apexins.sql                 apxdwngrd.sql       coreins.sql

apexins1.sql                apxpatch.sql        coreins2.sql

apexins2.sql                apxpatch_cdb.sql    coreins3.sql

apexins3.sql                apxpatch_nocdb.sql  coreins4.sql

apexins_adb.sql             apxremov.sql        coreins5.sql

apexins_adb_ext.sql         apxremov1.sql       dbcsconf.sql

apexins_cdb.sql             apxremov2.sql       dbcsins.sql

apexins_nocdb.sql           apxremov_cdb.sql    devins.sql

appins.sql                  apxremov_nocdb.sql  images

apxappcon.sql               apxrtins.sql        load_trans.sql

apxappcon_ext.sql           apxrtins1.sql       utilities

apxchpwd.sql                apxrtins2.sql

apxdevrm.sql                apxrtins3.sql

[oracle@localhost temp]$ 


日本語リソースをロードします。

cd apex
. oraenv   (ORACLE_SIDとしてFREEを指定)
export NLS_LANG=American_America.AL32UTF8
sqlplus sys/******@localhost/freepdb1 as sysdba
@load_trans JAPANESE

[oracle@localhost temp]$ cd apex

[oracle@localhost apex]$ . oraenv

ORACLE_SID = [oracle] ? FREE

The Oracle base has been set to /opt/oracle

[oracle@localhost apex]$ export NLS_LANG=American_America.AL32UTF8

[oracle@localhost apex]$ sqlplus sys/********@localhost/freepdb1 as sysdba


SQL*Plus: Release 23.26.0.0.0 - Production on Fri Jan 30 01:59:08 2026

Version 23.26.0.0.0


Copyright (c) 1982, 2025, Oracle.  All rights reserved.



Connected to:

Oracle AI Database 26ai Free Release 23.26.0.0.0 - Develop, Learn, and Run for Free

Version 23.26.0.0.0


SQL> @load_trans JAPANESE


PL/SQL procedure successfully completed.


Installing Oracle APEX translation - JAPANESE


. ORACLE

.

. Oracle APEX Hosted Development Service Installation.

..............................................................


PL/SQL procedure successfully completed.



PL/SQL procedure successfully completed.


--application/set_environment

API Last Extended:20241130

Your Current Version:20241130

This import is compatible with version: 20241130

COMPATIBLE (You should be able to run this import without issues.)

ID offset during import: 0

New ID offset for application: 0

APPLICATION 4420 - Oracle APEX Builder, Wizard Messages and Native Plug-Ins

--application/delete_application

--application/create_application

--application/user_interfaces


[中略]


--application/deployment/definition

--application/deployment/checks

--application/deployment/buildoptions

--application/end_environment

... elapsed: 5.87 sec

...done

Adjust instance settings


PL/SQL procedure successfully completed.


SQL> 


プロンプトが返ってきた時点で日本語リソースの導入は完了しています。

APEXの管理サービスには、以下のURLからアクセスできます。


日本語リソースを導入しているため、言語として日本語を選択できます。管理者のユーザー名はADMINです。パスワードは仮想マシンのコンソールで開いているWebページまたはターミナルに記載されています。


管理にサインインできます。


APEXのワークスペースとして、HR_DEVが作成済みです。ユーザーHR_ADMINでサインインできます。パスワードは仮想マシンのコンソールで開いているWebページまたはターミナルに記載されています。



APEXのアプリケーション・ビルダーが開きます。


データベース・アクション(SQL Developer Web)への接続も確認します。

http://localhost:8080/ords/sql-developer

詳細をクリックし、パス指定を開きます。

SQL Developer Webでは、ユーザーHRがあらかじめ作成されています。パスhrユーザー名hrにてサインインできます。


SQL Developer Webが開きます。


以上で、Oracle APEXのアプリケーションを開発する準備ができました。