ラベル PGQ の投稿を表示しています。 すべての投稿を表示
ラベル PGQ の投稿を表示しています。 すべての投稿を表示

2023年9月27日水曜日

サンプル・アプリケーションSample Graph Visualizationsの紹介

 Oracle APEXのサンプル・アプリケーションとしてSample Graph Visualizationsが追加されています。インストールできるのは、APEX 23.1以降です。

https://oracle.github.io/apex/


最近のAPEX Office HourにてOracle社のSpatial and Graph Product Management TeamのRahul Taskerさんが、APEX and Property Graphs in Oracle Database 23cという題でオンライン・セミナーをされています。録画はこちら。

Property GraphはOracle Database 23cから提供される機能ですし、その話だから使えるのはまだ先かな、と思って聞いていたところ、Jayant Sharmaさんが「Sample Graph VisualizationsはADB Serverlessでも使えるよ。」とのこと。

ということで、サンプルをダウンロードとしてAlways FreeのADB Serverlessにインストールしてみました。問題なく動きました。

アプリケーションを実行するとログイン画面が表示されます。


サインインすると、沢山のサンプルが表示されます。


Basic Graphを開いてみると、以下のように表示されます。


Graph Studioで使われているビジュアリゼーションのJavaScriptコンポーネントを、APEXのプラグインとして移植しているように見えます。


Sample Graph Visualizationsでは、グラフを表示するリージョンのタイプがGraph Visualizations (Preview)となっています。

将来は標準のリージョンになるかもしれません。


このグラフのソースとなっているQueryを確認した範囲では、ソースはverticesとedgesの属性を、それぞれ配列として含むJSONドキュメントであれば良いみたいです。つまり、必ずしもOracle Database 23cのProperty Graphの機能が無くても、このプラグインは使えます。


Stylingを開くと以下のようなグラフが確認できます。


Interactionでは、APEXの動的アクションを使った実装がされています。


Selectionでは、さらに凝った実装が行われています。


Network Evolutionでは、チャートを重ねて表示しています。


その他にSaving Graph State、Keyboard Navigation Shortcutsといったページがあります。

Oracle Database 23cにProperty Graphが実装されても、APEXで使用するにはビジュアリゼーションがネックだと思っていたので、このようなコンポーネントが使えるようになっているのは、とてもありがたいです。

ちなみにAPEX 23.1とOracle Database 23cを組み合わせた場合は、ソースのタイプとしてプロパティ・グラフを指定できるようになります。


SELECT文全体を記述する必要がなくなり、若干ソースの設定が容易になります。

以上です。

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

完

2023年4月7日金曜日

PGQLを使ったAPEXアプリを23cのSQL Property Graphで置き換えてみる

PGQLをトランスレートして生成したSQLをレポートのソースとした、Oracle APEXのアプリケーションを作成したことがあります。

PGQLの2層モードで生成されるSQLをAPEXのレポートに組み込む

Oracle Database 23cよりSQL/PGQ(Property Graph Queries)がサポートされ、グラフ形式のデータを直接扱うことができるようになりました。

以前の記事で作成したAPEXアプリケーションを、SQL/PGQを使うように見直してみます。

使用するのはこちらの記事で作成した、Oracle Database 23c FreeにOracle APEX 22.2をインストールした環境です。Oracleが提供しているVirtualBoxのAPEXを日本語化した環境でも同様に作業ができるでしょう。

ワークスペースとしてAPEXDEV(紐づいているスキーマもAPEXDEV)が作成されていることを前提とします。ワークスペースやスキーマ名が異なる場合は、APEXDEVの部分を置き換えてください。

最初にスキーマAPEXDEVにSQL Property Graphを扱う権限を与えます。

4.1.5 Granting System and Object Privileges for SQL Property Graphs
GRANT CREATE PROPERTY GRAPH, CREATE ANY PROPERTY GRAPH, 
      ALTER ANY PROPERTY GRAPH, DROP ANY PROPERTY GRAPH, 
      READ ANY PROPERTY GRAPH TO APEXDEV;

ユーザーsystemで接続し、スキーマAPEXDEVに権限を与えます。

[oracle@apex ~]$ sqlplus system/********@localhost/freepdb1


SQL*Plus: Release 23.0.0.0.0 - Developer-Release on Fri Apr 7 15:34:54 2023

Version 23.2.0.0.0


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


Last Successful login time: Fri Apr 07 2023 15:34:44 +09:00


Connected to:

Oracle Database 23c Free, Release 23.0.0.0.0 - Developer-Release

Version 23.2.0.0.0


SQL> GRANT CREATE PROPERTY GRAPH, CREATE ANY PROPERTY GRAPH, 

      ALTER ANY PROPERTY GRAPH, DROP ANY PROPERTY GRAPH, 

      READ ANY PROPERTY GRAPH TO APEXDEV;  2    3  


Grant succeeded.


SQL> exit

Disconnected from Oracle Database 23c Free, Release 23.0.0.0.0 - Developer-Release

Version 23.2.0.0.0

[oracle@apex ~]$ 


元記事ではSQLclでPGQLを使用するために、色々な作業を行っています。SQL Property Graphを使う場合は、これらの作業は不要です。

以下のSQLを実行し、頂点であるアカウントとエッジであるトランザクションを保存する表を作成します。表SQLCL_BANK_ACCTS、SQLCL_BANK_TXNSは元記事とまったく同じ表です。



作成した表にテスト・データを投入するために、ユーティリティのデータ・ジェネレータを使用します。

データ・ジェネレータでの作業も元記事とまったく同じです。同じ手順を記載するのは冗長になるため、テスト・データの準備については元記事を参照してください。


データ・ジェネレータによるテスト・データの投入が完了したところから継続します。

SQLコマンドより、表SQLCL_BANK_ACCTSに投入されたデータを確認します。

select count(*) from sqlcl_bank_accts;


表SQLCL_BANK_TXNSに投入されたデータを確認します。

select count(*) from sqlcl_bank_txns;


テスト・データより、送金元と送金先が同じ行を削除します。

delete from sqlcl_bank_txns where from_acct_id = to_acct_id;


以上でテスト・データの準備が完了しました。

この表を元にプロパティ・グラフSQLCL_BANK_GRAPHを作成します。



元記事で作成したAPEXアプリケーションをインポートします。
https://github.com/ujnak/apexapps/blob/master/exports/pgql-reports.zip

インポートしたアプリケーションを編集します。

ページ番号2のPGQL1のレポートのソースを以下に変更します。
select acct_id, count(*) as NumDeposits
from graph_table(sqlcl_bank_graph
    match
    (m is account) -[e is transfer] ->(v is account)
    columns (v.acct_id)
)
group by acct_id
order by NumDeposits desc
fetch first :P2_ROWS rows only;

ページを実行すると、以下のように表示されます。


PGQLより生成したSQLをSQL/PGQを使うように置き換えます。マニュアルの主な参照箇所は以下になります。

5 SQL GRAPH_TABLE Queries

ページ番号3のPGQL2のレポートのソースは、以下に変更します。
select from_acct_id, amount, to_acct_id, description
from graph_table(sqlcl_bank_graph
    match
    (s is account where s.acct_id member of apex_string.split_numbers(:P3_ACCT_IDS,',')) -[e is transfer]->(d is account)
    columns (s.acct_id as from_acct_id, e.amount as amount, d.acct_id as to_acct_id, e.description as description)
);

ページを実行すると、以下のように表示されます。


 PGQLからSQLを生成してレポートに組み込むより、はるかに簡単にグラフ構造のデータを活用できるようになっています。

現時点(バージョン22.2)のOracle APEXには、グラフを描画する標準のコンポーネントはありません。地理空間情報に対応しているマップ・リージョンのように、グラフ構造のデータについても専用のリージョンが提供されると、もっとグラフの使い勝手が良くなることが期待されます。

今回の変更を加えたAPEXアプリケーションのエクスポートを以下に置きました。
https://github.com/ujnak/apexapps/blob/master/exports/sqlpgq-report.zip

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

完