2021年2月16日火曜日

ブロックチェーン表にPDFを保存し全文検索を行う

 題材の相談を受けたので、ちょっとアプリを作ってみました。作り方は以前に記事に書いてはいるので、あまり細かい実装はせず、ブロックチェーン表で可能かどうかの確認を目的とします。

結論としてはAlways Freeの21cでは、Oracle Textのauto filterに何か問題があるようで、うまく動きませんでした。ブロックチェーン表だからできない、ということではなく、ブロックチェーン表でも全文検索索引は機能するはずですが、現状ではAlways Free以外に利用可能な21cのインスタンスは無いので確認できません。

以下より作業ログです。

最初にPDFを保存するブロックチェーン表を定義します。構造はクイックSQLの以下のモデルを使います。

# prefix: trm
# semantics: default
documents
    title vc400
    document file

DDLを生成し、スクリプトを保存してから、レビューと実行を行うと、DDLの編集画面になります。DDLをブロックチェーン表となるように書き換えます。

-- create tables
create blockchain table trm_documents (
    id                             number generated by default on null as identity 
                                   constraint trm_documents_id_pk primary key,
    title                          varchar2(400),
    document                       blob,
    document_filename              varchar2(512),
    document_mimetype              varchar2(512),
    document_charset               varchar2(512),
    document_lastupd               date
)
no drop until 31 days idle no delete locked HASHING USING "SHA2_512" version "v1"
;

DDLを実行し表を作成した後、アプリケーションの作成を行い、アプリケーション作成ウィザードを起動します。作成するアプリケーションの名前を指定し(ここではPDF保存)、アプリケーションの作成をクリックします。

これで、PDF(に限らず、あらゆるファイル)のアップロードと保存、ダウンロードを行うアプリケーションが作成されました。

次に全文検索索引をブロックチェーン表に付加します。

最初に日本語レクサーを登録します。

begin
  ctx_ddl.create_preference('ja_lexer', 'JAPANESE_LEXER');
end;
/

Autonomous Databaseの場合は、ワークスペース・スキーマにCTX_DDLパッケージの実行権限が割り当たっていません。SQL Developer WebなどからADMINでサインインして実行権限を割り与えます。

grant execute on ctx_ddl to スキーマ名;

BLOB(バイナリ・データ)として登録されたファイルより、文字情報を抽出するフィルタを設定します。

begin
  ctx_ddl.create_preference('auto_filter', 'AUTO_FILTER');
  ctx_ddl.create_policy('auto_policy', 'auto_filter');
end
/

ユーザー・データストアに利用されるファイルよりテキストを抽出するプロシージャを作成します。

create or replace procedure pdf_to_text(
    rid in rowid,
    tlob in out nocopy clob
)
is
    l_title trm_documents.title%type;
    l_document trm_documents.document%type;
    l_clob clob;
begin
    for c in (select title, document from trm_documents where rowid = rid)
    loop
        if c.title is not null then
            dbms_lob.writeappend(tlob, length(c.title), c.title);
        end if;
        if dbms_lob.getlength(c.document) > 0 then
            begin
                ctx_doc.policy_filter('auto_policy', c.document, l_clob, true);
                dbms_lob.copy(tlob, l_clob, length(l_clob), length(tlob)+1, 1);
            exception
            when others then
                null;
            end;
        end if;
    end loop;
end pdf_to_text;

ユーザー・データストアtrm_documents_storeを登録します。APEXDEVとなっている部分は、作成したプロシージャpdf_to_textのオーナーに置き換えます。

begin
    ctx_ddl.create_preference('trm_documents_store', 'user_datastore'); 
    ctx_ddl.set_attribute('trm_documents_store', 'procedure', 'APEXDEV.pdf_to_text'); 
    ctx_ddl.set_attribute('trm_documents_store', 'output_type', 'CLOB');
end;

作成したユーザー・データストアを使って、全文検索索引を作成します。

create index trm_documents_sidx on trm_documents(title)
indextype is ctxsys.context 
parameters('filter ctxsys.null_filter lexer ja_lexer datastore trm_documents_store sync(on commit)');

以上で、全文検索索引の作成は完了です。

アプリケーションにすでに含まれている対話モード・レポートが全文検索索引を使用するように属性の設定を行います。

対話モード・レポートのリージョンを開き、右ペインでAttributesを開きます。詳細にOracle Text索引列の設定があるので、それに列TITLEが設定されていることを確認します。

以上で、一応動くはずなんですが、試すと検索にヒットしません。確認のため以下のコードを実行しました。

declare
l_clob clob;
begin
for c in (select * from trm_documents)
loop
ctx_doc.policy_filter('auto_policy', c.document, l_clob, true);
dbms_output.put_line(l_clob);
end loop;
end;

以下のエラーが発生します。

ORA-20000: Oracle Textエラー: DRG-11207: ユーザー・フィルタ・コマンドが状態1で終了しました。 DRG-11221: サードパーティのフィルタが、このドキュメントの破損を示しています。 ORA-06512: "CTXSYS.DRUE", 行186 ORA-06512: "CTXSYS.CTX_DOC", 行1682 ORA-06512: 行6 ORA-06512: 行6 ORA-06512: "SYS.DBMS_SQL", 行1766

このインスタンスでは普通の表でも同じエラーが発生することも確認できました。東京リージョンの19cで普通の表を対象に、同じ手順でアプリケーションを作成すると、問題なく全文検索ができるので、おそらくAlways Freeの21c固有の事象ではないかと思われます。

完

2021年2月15日月曜日

MLEのJavaScriptを動かしてみる

 JavaScriptは学習中なのですが、Oracle Database 21cのMLE(Multilingual Engine)で動かしてみました。その作業ログです。

サンプル・データセットに含まれるEMP/DEPTを使って、SQLワークショップのSQLコマンドからコードを実行します。検索(SELECT)とファンクション呼び出しだけを試してみました。

最初に実行したコードです。

const oracledb = require("mle-js-oracledb");
const sql = "SELECT * FROM EMP";
let result = oracledb.defaultConnection().execute(sql);
console.log(JSON.stringify(result));

印刷された結果です。

{
    "metaData":[{"name":"EMPNO"},{"name":"ENAME"},{"name":"JOB"},{"name":"MGR"},{"name":"HIREDATE"},{"name":"SAL"},{"name":"COMM"},{"name":"DEPTNO"}],
    "rows":[
        [7839,"中島 亜希子","社長",null,"1981-11-17T00:00:00.000Z",5000,null,10],
        [7698,"伊藤 明子","マネージャー",7839,"1981-05-01T00:00:00.000Z",2850,null,30],
        [7782,"坂本 明","マネージャー",7839,"1981-06-09T00:00:00.000Z",2450,null,10],
        [7566,"関口 晃","マネージャー",7839,"1981-04-02T00:00:00.000Z",2975,null,20],
        [7788,"新井 敦子","アナリスト",7566,"1982-12-09T00:00:00.000Z",3000,null,20],
        [7902,"石橋 敦","アナリスト",7566,"1981-12-03T00:00:00.000Z",3000,null,20],
        [7369,"村田 淳","店員",7902,"1980-12-17T00:00:00.000Z",800,null,20],
        [7499,"村上 綾子","セールス",7698,"1981-02-20T00:00:00.000Z",1600,300,30],
        [7521,"斉藤 大介","セールス",7698,"1981-02-22T00:00:00.000Z",1250,500,30],
        [7654,"高橋 大輔","セールス",7698,"1981-09-28T00:00:00.000Z",1250,1400,30],
        [7844,"金子 恵美","セールス",7698,"1981-09-08T00:00:00.000Z",1500,0,30],
        [7876,"増田 秀樹","店員",7788,"1983-01-12T00:00:00.000Z",1100,null,20],
        [7900,"佐野 英樹","店員",7698,"1981-12-03T00:00:00.000Z",950,null,30],
        [7934,"石原 裕美","店員",7782,"1982-01-23T00:00:00.000Z",1300,null,10]
    ]
}

取得された列のmetaDataと実際の列がrowsという行の配列、そしてその行も配列として列の値が返されています。従業員番号と従業員名だけを印刷するには、以下のようなコードを実行します。

const oracledb = require("mle-js-oracledb");
const sql = "SELECT * FROM EMP";
for (let row of oracledb.defaultConnection().execute(sql).rows)
{
console.log(row[0] + " " + row[1]);
}

以下が実行結果です。

7839 中島 亜希子
7698 伊藤 明子
7782 坂本 明
7566 関口 晃
7788 新井 敦子
7902 石橋 敦
7369 村田 淳
7499 村上 綾子
7521 斉藤 大介
7654 高橋 大輔
7844 金子 恵美
7876 増田 秀樹
7900 佐野 英樹
7934 石原 裕美

従業員番号7839の行だけを取り出すには、以下の指定を加えます。SQLにWHERE句を追加し、バインド変数の指定を行います。executeの第2引数として、バインド変数に割り当てる値を指定します。バインド変数の名前に関係なく、割り当ては出現順序で決まります。

const oracledb = require("mle-js-oracledb");
const sql = "SELECT * FROM EMP where empno = :empno";
for (let row of oracledb.defaultConnection().execute(sql, [7839]).rows)
{
console.log(JSON.stringify(row));
console.log(row[0] + " " + row[1] + " " + row[5]);
}

結果は以下になります。

[7839,"中島 亜希子","社長",null,"1981-11-17T00:00:00.000Z",5000,null,10]
7839 中島 亜希子 5000

給与の列SALをOracleNumber型として取り出してみます。以下では、optionsの指定を追加しています。

const oracledb = require("mle-js-oracledb");
const sql = "SELECT * FROM EMP where empno = :empno";
const options = { fetchInfo: { SAL: { type: oracledb.ORACLE_NUMBER } } };
for (let row of oracledb.defaultConnection().execute(sql, [7839], options).rows)
{
console.log(JSON.stringify(row));
console.log(row[0] + " " + row[1] + " " + row[5]);
}

結果は以下になります。

[7839,"中島 亜希子","社長",null,"1981-11-17T00:00:00.000Z",{"impl":{}},null,10]
7839 中島 亜希子 5000

row[5]としての出力では給与は5000となっていますが、JSON.stringifyをみると{"impl":{}}となっており、オブジェクトとして取り出されていることがわかります。JavaScriptのデータ型に単純にマップできない列は、ここでoptionsとして定義したように、fetchInfoとして、対象の列と、マップするオブジェクトを指定します。

モジュールmle-js-oracledbではなく、Oracle APEXが提供しているapex.connを代わりに使用してみます。

最初に以下のコードを実行します。

const sql = "SELECT * FROM EMP";
let result = apex.conn.execute(sql);
console.log(JSON.stringify(result));

結果は以下になります。

{
    "metaData":[{"name":"EMPNO"},{"name":"ENAME"},{"name":"JOB"},{"name":"MGR"},{"name":"HIREDATE"},{"name":"SAL"},{"name":"COMM"},{"name":"DEPTNO"}],
    "rows":[
        {"EMPNO":7839,"ENAME":"中島 亜希子","JOB":"社長","MGR":null,"HIREDATE":"1981-11-17T00:00:00.000Z","SAL":5000,"COMM":null,"DEPTNO":10},
        {"EMPNO":7698,"ENAME":"伊藤 明子","JOB":"マネージャー","MGR":7839,"HIREDATE":"1981-05-01T00:00:00.000Z","SAL":2850,"COMM":null,"DEPTNO":30},
        {"EMPNO":7782,"ENAME":"坂本 明","JOB":"マネージャー","MGR":7839,"HIREDATE":"1981-06-09T00:00:00.000Z","SAL":2450,"COMM":null,"DEPTNO":10},
        {"EMPNO":7566,"ENAME":"関口 晃","JOB":"マネージャー","MGR":7839,"HIREDATE":"1981-04-02T00:00:00.000Z","SAL":2975,"COMM":null,"DEPTNO":20},
        {"EMPNO":7788,"ENAME":"新井 敦子","JOB":"アナリスト","MGR":7566,"HIREDATE":"1982-12-09T00:00:00.000Z","SAL":3000,"COMM":null,"DEPTNO":20},
        {"EMPNO":7902,"ENAME":"石橋 敦","JOB":"アナリスト","MGR":7566,"HIREDATE":"1981-12-03T00:00:00.000Z","SAL":3000,"COMM":null,"DEPTNO":20},
        {"EMPNO":7369,"ENAME":"村田 淳","JOB":"店員","MGR":7902,"HIREDATE":"1980-12-17T00:00:00.000Z","SAL":800,"COMM":null,"DEPTNO":20},
        {"EMPNO":7499,"ENAME":"村上 綾子","JOB":"セールス","MGR":7698,"HIREDATE":"1981-02-20T00:00:00.000Z","SAL":1600,"COMM":300,"DEPTNO":30},
        {"EMPNO":7521,"ENAME":"斉藤 大介","JOB":"セールス","MGR":7698,"HIREDATE":"1981-02-22T00:00:00.000Z","SAL":1250,"COMM":500,"DEPTNO":30},
        {"EMPNO":7654,"ENAME":"高橋 大輔","JOB":"セールス","MGR":7698,"HIREDATE":"1981-09-28T00:00:00.000Z","SAL":1250,"COMM":1400,"DEPTNO":30},
        {"EMPNO":7844,"ENAME":"金子 恵美","JOB":"セールス","MGR":7698,"HIREDATE":"1981-09-08T00:00:00.000Z","SAL":1500,"COMM":0,"DEPTNO":30},
        {"EMPNO":7876,"ENAME":"増田 秀樹","JOB":"店員","MGR":7788,"HIREDATE":"1983-01-12T00:00:00.000Z","SAL":1100,"COMM":null,"DEPTNO":20},
        {"EMPNO":7900,"ENAME":"佐野 英樹","JOB":"店員","MGR":7698,"HIREDATE":"1981-12-03T00:00:00.000Z","SAL":950,"COMM":null,"DEPTNO":30},
        {"EMPNO":7934,"ENAME":"石原 裕美","JOB":"店員","MGR":7782,"HIREDATE":"1982-01-23T00:00:00.000Z","SAL":1300,"COMM":null,"DEPTNO":10}
    ]
}

apex.conn.executeでは、行が配列ではなくオブジェクトとして返されています。そのため、従業員番号と従業員名の一覧を出力するコードには、以下のように配列のインデックスではなく、列名を使います。

const sql = "SELECT * FROM EMP";
for (let row of oracledb.defaultConnection().execute(sql).rows)
{
console.log(row.EMPNO + " " + row.ENAME);
}

以下が実行結果です。

7839 中島 亜希子
7698 伊藤 明子
7782 坂本 明
7566 関口 晃
7788 新井 敦子
7902 石橋 敦
7369 村田 淳
7499 村上 綾子
7521 斉藤 大介
7654 高橋 大輔
7844 金子 恵美
7876 増田 秀樹
7900 佐野 英樹
7934 石原 裕美

バインド変数の割り当ても、配列ではなくオブジェクトと列名を使います。

const sql = "SELECT * FROM EMP where empno = :empno";
for (let row of apex.conn.execute(sql, { empno: 7839 }).rows)
{
console.log(JSON.stringify(row));
console.log(row.EMPNO + " " + row.ENAME + " " + row.SAL);
}

以下が実行結果です。

{"EMPNO":7839,"ENAME":"中島 亜希子","JOB":"社長","MGR":null,"HIREDATE":"1981-11-17T00:00:00.000Z","SAL":5000,"COMM":null,"DEPTNO":10}
7839 中島 亜希子 5000

型指定は同様に行います。

const sql = "SELECT * FROM EMP where empno = :empno";
const options = { fetchInfo: { SAL: { type: oracledb.ORACLE_NUMBER } } };
for (let row of apex.conn.execute(sql, { empno: 7839 }, options).rows)
{
console.log(JSON.stringify(row));
console.log(row.EMPNO + " " + row.ENAME + " " + row.SAL);
}

以下が実行結果です。

{"EMPNO":7839,"ENAME":"中島 亜希子","JOB":"社長","MGR":null,"HIREDATE":"1981-11-17T00:00:00.000Z","SAL":{"impl":{}},"COMM":null,"DEPTNO":10}
7839 中島 亜希子 5000

ファンクション呼び出しの例は以下です。

const sql = "begin :result := upper(:input); end;";
let result = apex.conn.execute(sql, {
result: { dir: apex.db.BIND_OUT },
input: {
dir: apex.db.BIND_IN,
val: "abc"
}
});
console.log(JSON.stringify(result));
console.log(result.outBinds.result);

以下が実行結果です。

{"outBinds":{"result":"ABC"}}
ABC

簡単ですが、以上です。

SQLコマンドでは確かめられないのですが、JavaScript内でページ・アイテムおよびアプリケーション・アイテムを参照するにはapex.envを使用します。

参照する方法は以下です。

var pageText = apex.env.P1_TEXT;
var appText = apex.env.G_TEXT;

設定する方法は以下です。

apex.env.P1_TEXT = 'page text';
apex.env.G_TEXT = 'app text';

Oracle APEXのアプリケーション作成の一助になれば幸いです。

完

2021年2月14日日曜日

実行時のみの環境でのデバッグ方法について

 Oracle APEXはインストール時にapexins.sqlの代わりにapxrtins.sqlを実行することで、アプリケーションの実行のみを行う環境を作ることができます。管理や開発のアプリケーションを含まず、それらの作業はすべてコマンドラインから実行します。

アプリケーションのインストール方法は、以前にこちらの記事で紹介しています。

そのような環境でアプリケーションのデバッグはどのように行うのか?という質問がありました。ひとつの方法は、Peter Raganitschさんの記事にあるような、Oracle APEXのZIPファイルに含まれるutilities/debug/以下のd0.1sq., d1.sql, d2.sql, ds.sqlなどのスクリプトを使用する方法です。ただし、これはDBにDBA権限か少なくてもAPEXの製品スキーマへ直接アクセスできる権限がないと実行できません。

APEXのセッションのデバッグ・レベルを設定するAPIとして、APEX_SESSION.SET_DEBUG、トレース・モードを設定するAPIとしてAPEX_SESSION.SET_TRACEが提供されています。このAPIと、Oracle APEXが提供している各種のビューを検索することにより、アプリケーションのデバッグができる、とのことだったので、ちょっとアプリケーションを作ってみました。

APEX_WORKSPACE_SESSIONSビューについては、デバッグ・レベル、トレース・モードを変更できるようにしていますが、それ以外は単にビューを * でselectしているだけです。

APEXが提供しているビューではありませんが、V$DIAG_TRACE_FILE_CONTENTS、V$DIAG_ALERT_EXTを表示するページも追加しています。ワークスペース・スキーマは通常、これらのビューを検索する権限は持っていないので、ページを機能させるためには管理者によって、これらのビューへのSELECT権限をGRANTしてもらう必要があります。

実行環境のみのインストールはセキュリティ面で有利なことは間違いないですが、ドイツのAPEX Connect 2018というイベントであったBuilt with APEXというセッション(11分経過くらいのスライド)によると、"Hardly anyone uses Runtime installation or protects APEX Workspace Login Page from being opened"とのことで、あまり利用されていないようです。

最近はSQLclにLiquibaseが組み込まれたりするなど、コマンド・ラインによる管理や連携方法も充実してきたので、ちゃんと検討したいテーマではあります。

作成したアプリケーションのエクスポートを以下に置きました。何かの参考になれば幸いです。

https://github.com/ujnak/apexapps/blob/master/exports/sampleapexdebug.sql

デバッグ・レベルを9まであげると、環境によっては処理がほとんど止まってしまうので、注意しましょう。

完

2021年2月13日土曜日

対話グリッドの列の値をダイアログを開いて編集する - その2

 ちょっと前に「対話グリッドの列の値をダイアログを開いて編集する」として記事を書きましたが、違う実装が出てきたので紹介します。方法の基本的なところ(インライン・ダイアログを使用する)は同じなのですが、JavaScriptのコードが違います。

違うところを記載します。

最初に対話グリッドに静的IDを設定します。ここではKVIGとしています。


対話グリッドの列VALUEにたいして、以下のJavaScript初期化コードを設定します。以下の記述は、列のタイプをHTML式として指定するのが通常ですが、その場合は、列は更新不可になります。タイプがテキスト領域のままでHTML式を適用するには、JavaScript初期化コード内のcellTemplateで指定します。クラス指定にedit-noteを含めていますが、これは動的アクションのタイミング指定で使用します。

function(options) {
    options.defaultGridColumnOptions = {
        cellTemplate: '<button type="button" class="edit-note t-Button t-Button--icon t-Button--small t-Button--link t-Button--iconLeft"><span aria-hidden="true" class="t-Icon t-Icon--left fa fa-pencil"></span>Edit Value</button>'
    }
    return options;
}

インライン・ダイアログのリージョンにページ・アイテムP1_IDを追加します。タイプは非表示とし、保護された値はOFFにします。このページ・アイテムは、選択された行のIDを保持するために使用します。


動的アクションのタイミングを変更します。選択タイプをjQueryセレクタ、jQueryセレクタとして、.edit-noteを指定します。cellTemplateとして記載したボタンを選択しています。

詳細のイベント有効範囲を動的にし、静的コンテナとして#KVIG、つまり対話グリッドのリージョンを指定しています。

Trueアクションとして実行されるJavaScriptのコードとして以下を指定します。選択した対話グリッドの列の値をインライン・ダイアログへ移入します。

let target = this.browserEvent.target,
    view = apex.region("KVIG").call("getCurrentView"),
    record = view.getContextRecord( target )[0], 
    model = view.model;
console.log("open dialog for record ", record);
$s("P1_ID", model.getRecordId(record));
$s("P1_TEXT", model.getValue(record, "VALUE"));

インライン・ダイアログ上の変更を対話グリッドの列に戻すTrueアクションには以下のJavaScriptのコードを指定します。

let view = apex.region("KVIG").call("getCurrentView"),
    model = view.model,
    text = $v("P1_TEXT"),
    record = model.getRecord($v("P1_ID"));
console.log("save notes in record ", record)
model.setValue(record, "VALUE", text);

以上で最初のGIF動画の動作になります。列のJavaScriptによる初期化コードおよびcellTemplateの指定などは、普通はわからない気がします。

アプリケーションのエクスポートを以下に置きました。

https://github.com/ujnak/apexapps/blob/master/exports/inlinedialogedit2.sql

以上です。Oracle APEXのアプリケーション開発の一助になれば幸いです。

完

Oracle Database Multilingual Engine (MLE) の記事3選

 最近、いくつかOracle Database Multilingual Engine (MLE) の記事が出てきています。

Multilingual Engine: Executing JavaScript in Oracle Database

https://medium.com/graalvm/mle-executing-javascript-in-oracle-database-c545feb1a010

ひとつめはAlina Yurenkoさん、OracleでGraalVMのDeveloper Advocateをしている方による以下の記事です。

前半でDBMS_MLEパッケージを利用したJavaScriptのコードの実行方法について、平易に解説しています。

いくつか説明を抜粋します。

  • JavaScriptのコードはPL/SQLの代替引用符(q'~と~'といった書き方)を使って記述すると、文字のエスケープを気にしなくて済みます。
  • console.log()はDBMS_OUTPUTと同じです。SERVEROUTPUTの設定の影響も受けます。
  • ひとつのデータベースのセッション中で、DBMS_MLE.create_context()を複数回呼び出すことで、複数の独立したコンテキストを生成できます。ただしメモリは消費するので、必要なときだけコンテキストは生成し、不要になったら削除しましょう。SQLカーソルのようなリソースと扱いは同じです。
  • SQLとPL/SQLを実行するためにmle-js-oracledbというJavaScriptモジュールを提供しています。
  • mle-js-oracledbは一般的なNode.js用のOracle Databaseドライバ(node-oracledb)を模して作られています。
  • Oracleの持つNUMBER型については、JavaScriptの浮動小数点型に変換すると値が変わるため、OracleNumberオブジェクトを提供しています。
後半でMultilingual Engineの実装について、簡単に解説しています。
  • GraalVM Native Imageにより、MLEのランタイムとGraalVMが提供しているJavaScriptラインタイムを共有ライブラリとして生成し、それをデータベースのプロセスが必要に応じてロードしています。
  • Cのコードと、GraalVMのNative Imageのファンクションの間でのやり取りは、とても効率的です。
  • MLE Native Imageのロードを短期間に行うため、MLEを構成する多くのJava Classはイメージをビルドする時点で初期化しています。
  • 読み出しのみを行う(メモリの)ヒープ領域はイメージのビルド時点で初期化され、データーベースのプロセス間で共用されます。そのため、全体のメモリ使用量が削減されます。
  • MLEはOracle Databaseのリソース・マネージャのポリシーによって制御されます。
  • MLEは直接OSからメモリを取得することはなく、データベースから取得します。
  • ひとつのデータベース・セッション内で複数の(MLEの)コンテキスト(Polyglot Context)が持てますが、これはGraalVM自体に組み込まれているものです。実行エンジン(Polyglot Engine)は共用しているため、メモリの使用量や実行する(同じ)JavaScriptのコードをパースする時間が短縮されます。
  • mle-js-oracledbモジュールはTruffle language interoperability protocol経由でMLE SQL Driverを呼び出しています。これにより、2つのJavaScriptのファンクション間での呼び出しと、発生するオーバーヘッドはほぼ変わりません。

MLE and the Future of Server-Side Programming in Oracle APEX



ふたつめは、Oracle APEXの開発チームに所属しているSalim Hlayelさんの記事です。

Oracle Database 21cは、Always FreeのAutonomous Databaseとしていくつかのリージョンで先行利用することができます。
  • Germany Central (Frankfurt)
  • US East (Ashburn)
  • US West (Phoenix)
  • UK South (London)
この中のAshburnで21cのAlways FreeのADBを作成し、Oracle APEXのデモでよく利用されているプロジェクトとタスクのアプリケーションにJavaScriptで記述したプロセスを追加しています。

MLEが利用可能なデータベースの作成から、Oracle APEXのアプリケーションへのJavaScriptコードの適用まで、ステップバイステップで説明しています。これからOracle APEXでサーバー側にJavaScriptでコードを書こうと検討されている方とって、とても役に立つ記事です。


JavaScript as a Server-Side Language in Oracle APEX 20.2



みっつめは、Oracle APEXの開発チームに最近加わったStefan Dobreさんによる記事です。

サーバー側でJavaScriptによるコーディングを行う利点を考察しています。
  • 単にSQLを実行するだけなら、PL/SQLの方が簡潔に書けるでしょう。
  • 正規表現についてはJavaScriptの方が互換性の心配がない。
  • JSONの扱いはJavaScriptの方が容易です。
また、彼によるとMLEのデータベース・インターフェースは(公式なAPIのドキュメンテーションはまだリリースされていない)Node.js Oracle Driverのサブセットだが、ファンクションが非同期から同期に変更されていて、そこが大きな違い、とのことです。

Oracle APEXでJavaScriptのコードを記述する際には、mle-js-bindingsといったモジュールを明示的にrequireする必要がありません。なので、どのようにMLEのコンテキストを初期化しているか説明しています。Oracle APEXのページの処理が行われる際に、色々な場所でJavaScriptのコードを記述できますが、それを実行する際にMLEのコンテキストが生成されます。そして、すでにMLEのコンテキストが生成されている場合は、それを再利用します。結果として、ページの処理1回あたり、最大1つのMLEコンテキストが生成されることになります。

MLEのコンテキスト(Oracle APEX限定かどうかは分かりませんでした)には、globalThisというオブジェクトが提供されていて、この名前空間にファンクション、オブジェクト、変数などを割り当てることができます。これはブラウザのwindowオブジェクトに似ています。PL/SQLによるプロセス記述にて同様の実装をするには、PL/SQLの場合はページ・アイテムかパッケージ変数をを使う必要があります。

最後にqrcode-generator、validator.jsそれとmarked.jsを読み込んでモジュールとして活用する方法を示しています。これらのJavaScriptのファイルを一旦、CLOBの列を持つ表に取り込んで、それから、その内容をPlolyglot.eval()を使って利用可能にしているようです。

Alinaの記事からは、JavaScriptコードはコンテキスト間では共有されるが、実行エンジンの間では共用されないように読め、また、MLEはデータベースのセッション内で複数のMLEコンテキストを持てるが、Polyglot Engineはセッション単位であると読めます。そのため、これらのJavaScriptのモジュールはOracle APEXの1ページ処理ごとに必ず1回はPolyglot.eval()が呼び出されるのではないかと思われます。

これ以降はqrcode-generator, validator.js、marked.jsを使用した実装を紹介しています。ある程度、JavaScriptにて複雑な処理を記述する場合はモジュールは利用する必要が出てくるでしょう。ですので、サーバー側でJavaScriptを使うことを検討しているのであれば、読んでおくべき記事です。

以上です。ぜひ元記事の方も参照してください。

完

2021年2月12日金曜日

同一ページのフォームと対話グリッドの処理順について

 同じページにフォームと対話グリッドのリージョンがある場合、どちらが先に処理されるのか、と質問がありました。プロセスの行の自動処理(DML)の登録順だろうと思ったのですが、確認してみました。その作業ログです。ページ作成ウィザードを使用しないフォームと対話グリッドのリージョンの作成方法の紹介にもなっています。

以下のクイックSQLのモデルにて、表TST_INSERT_ORDERを作成します。

# prefix: tst
# semantics: default
insert_order
    name vc80

モデルには含まれていませんが、主キーとして列IDが作成され、一意となる数値が自動採番されます。そのため、IDを確認することにより、行が挿入された順番が分かります。

表を作成した後、空のアプリケーションを作成します。今回は名前をInsert Order確認としました。ホーム・ページを開いて、フォームと対話グリッドのリージョンを追加します。

新規にタイプがフォームとなるリージョンを追加します。タイトルはフォームとしています。ソースの表名としてTST_INSERT_ORDERを設定します。

表名が設定されると、列が認識されます。認識された列の中から列IDに対応するページ・アイテムP1_IDを選択し、タイプを非表示、主キーをONに変更します。

フォーム・リージョンのAttributesを開き、編集を有効にします(ONにします)。

行を作成するボタンを作成します。フォーム・リージョンを手動で作成した場合、ページ作成ウィザードによる作成とは異なり、作成、変更の登録、削除、キャンセルといったボタンは作成されません(これらのボタンは、フォーム・リージョンというコンポーネントの一部ではありません)。

フォーム・リージョンにボタンを作成します。ボタン名はB_CREATE、ラベルを生成としています。動作のアクションはページの送信(つまりHTTPのPOSTが発行されます)、データベース・アクションはSQL INSERT操作を選びます。

データベース・アクションの指定は重要で、フォーム・リージョンに対応する行の自動更新(DML)プロセスは、このデータベース・アクションの指定に従ってデータベースの表操作を行います。

続いて、対話グリッドのリージョンを追加します。新規に名前を対話グリッドとしたリージョンを追加し、タイプを対話グリッド、表名にTST_INSERT_ORDERを設定します。

表名が設定されると、列が認識されます。認識された列の中から列IDを選択し、タイプを表示のみ、主キーをONに変更します。主キー列は通常は非表示にしますが、今回は挿入の順番を確認するため、列として表示させます。

 対話グリッドのリージョンのAttributesを開き、編集を有効にします(ONにします)。

以上でアプリケーションの作成は完了です。プロセス・ビューを開いて、登録されている行の自動処理(DML)の順番を確認します。

アプリケーションを実行して、何行かデータを挿入してみます。

フォームのNameにform 1、対話グリッドにgrid 1、grid 2の2行を設定し、作成をクリックします。


フォームのプロセスの方が対話グリッドより先に実行されるので、挿入順はform 1、grid 1、grid 2になります。


プロセスの処理順を入れ替え、対話グリッドのプロセスを先に実行します。

アプリケーションを実行し、フォームのNameにform 2、対話グリッドにgrid 3、grid 4の2行を設定し、作成をクリックします。

今度は対話グリッドのプロセスが先に処理されるため、挿入順はgrid 3、grid 4、form 2になります。

確認に使用したアプリケーションのエクスポートを以下に置きました。

https://github.com/ujnak/apexapps/blob/master/exports/insertorder.sql

以上になります。Oracle APEXのアプリケーション作成の一助になれば幸いです。

完

対話グリッドの列の値をダイアログを開いて編集する

 対話グリッドの列の値の編集をインプレースではなく、ダイアログを別に開いて編集したい、という話があったので実装を考えてみました。その作業ログです。


実装の準備


最初にクイックSQLの以下のモデルから、表KVT_VALUESを作成します。

# prefix: kvt
# semantics: default
values
    key vc8 /nn /unique
    value vc4000

この表をソースとした対話グリッドのページを作成します。列VALUEがダイアログを開いて編集する対象になります。

名前をKey Value編集とした空のアプリケーションを作成します。ホームのページに対話グリッドのリージョンを追加します。

Content Body以下にリージョンを追加し、タイプを対話グリッド、ソースの表名にKVT_VALUESを選択します。

列が認識されるので、その中からIDを選択して、タイプを非表示、主キーをONに変更します。

対話グリッドのリージョンのAttributesを開いて、編集を有効にします(ONにします)。

続いて、選択された値を編集するためのダイアログとなるリージョンを作成します。Content Bodyにタイプが静的コンテンツとなるリージョンを作成します。外観のテンプレートをInline Dialogに変更します。

作成した静的コンテンツのリージョンに、変更する値を保持するページ・アイテムを作成します。以下では名前をP1_TEXTと設定しています。タイプはテキスト領域、ソースのフォーム・リージョンはNULL(選択しない)、タイプもNULL、使用とセッション・ステートの保持の選択は動作に影響を与えませんが、それぞれ、セッション・ステートの値がNULLの場合のみ、リクエストごと(メモリーのみ)とし、設定された値がセッション・ステートとして取り扱われない(永続化されない)ようにしておきます。

リージョンを閉じるためのボタンを追加します。ボタン名をB_CLOSEとし、動作のアクションは動的アクションで定義を選択します。


動的アクションの定義

編集したい列VALUEをクリックしたときにインライン・ダイアログを開く様にします。最初にクリックした対象を保持する変数elemをグローバル変数として定義します。ページのプロパティに含まれる、ファンクションおよびグローバル変数の宣言として以下を記載します。

var elem;

列VALUEがクリックされたときにダイアログを開く動的アクションを定義します。このとき、クリックした列VALUEに含まれる文字列を、ダイアログ上のページ・アイテムP1_TEXTに移入します。

列VALUEをクリックしたときに動的アクションが実行されるようにタイミングを設定します。以下の例では、イベントをクリック、選択タイプを列、リージョンはキー・バリュー、列はVALUEと設定しています。

列VALUEをクリックしたときに実行されるアクションを定義します。最初に列VALUEからページ・アイテムP1_TEXTへ文字列を移入するJavaScriptのコードを実行します。アクションをJavaScriptコードの実行とし、設定のコードに以下を記述します。

elem = this.triggeringElement;
$s("P1_TEXT", $v(elem));

文字列が移入できたところで、インライン・ダイアログを開きます。リージョンを開くためのアクションを定義します。影響を受ける要素は、選択タイプがリージョン、リージョンは値編集(インライン・ダイアログのリージョン名)としています。

次に、インライン・ダイアログ上のボタンB_CLOSEをクリックしたときに実行される動的アクションを定義します。タイミングはイベントがクリック、選択タイプはボタン、ボタンはB_CLOSEとします。

ボタンのクリック時に実行されるアクションとして、ページ・アイテムP1_TEXTに設定された値を、クリックした列VALUEに戻す処理を定義します。アクションとしてJavaScriptコードの実行を選択し、設定のコードに以下を記述します。

$s(elem, $v("P1_TEXT"));

続いて、開いているリージョンを閉じるアクションを定義します。アクションとしてリージョンを閉じるを選択し、影響を受ける要素として、選択タイプをリージョン、リージョンを値編集(インライン・ダイアログのリージョン)とします。

以上で最初のGIF動画で見ることができる実装になるはずです。

動的アクションの実行が列VALUEをクリックしたときではなく、列VALUEをクリックしてテキスト領域が開いた後に、そのテキスト領域をクリックして実行されるようになっているのは、ちょっと残念な感じではあります。

最新の対話グリッドでは列のタイプにテキスト領域、Markdownエディタ、リッチ・テキスト・エディタをそのまま指定できるので、基本的にこのような実装はしないのではないかと思います。列がJSONの場合であれば、直接JSONを記述するのも大変ですし、間違える可能性も大きいので、値の取り出しに次の様なコード(名前nameと年齢ageを含むJSONを仮定しています)、

elem = this.triggeringElement;
let v = $v(elem);
let jo = JSON.parse(v);
// $s("P1_TEXT", v);
$s("P1_NAME", jo.name);
$s("P1_AGE", jo.age);

値の設定に次の様なコードを設定することで、入力の助けにはなるでしょう。

// $s(elem, $v("P1_TEXT"));
let jo = {};
jo["name"] = $v("P1_NAME");
jo["age"] = Number($v("P1_AGE"));
$s(elem, JSON.stringify(jo));

確認に使用したアプリケーションのエクスポートを以下に置いておきます。

https://github.com/ujnak/apexapps/blob/master/exports/inlinedialogedit.sql

以上で今回の記事は終了です。Oracle APEXのアプリケーション開発の一助になれば幸いです。

完