1. プロパティ・グラフのグラフ開発者ガイド
  2. SQLプロパティ・グラフ
  3. APEXグラフ・ビジュアライゼーション・プラグインを使用したSQLグラフ問合せのビジュアル化
  4. APEXグラフ・ビジュアライゼーション・プラグインの概要

8.2 APEXグラフ・ビジュアライゼーション・プラグインの概要

この項は、APEXアプリケーションでグラフ・ビジュアライゼーション・プラグインを初めて使用する場合に役立ちます。

使用を開始する前に、APEXワークスペースが次の要件を満たしていることを確認してください:
  • このプラグインのインポート先となるターゲット・アプリケーションが存在すること。
  • ターゲット・アプリケーションがOracle Database 23aiに接続されていること。
  • ビジュアライゼーションに使用するSQLプロパティ・グラフがデフォルトのデータベース・スキーマに存在すること。

    SQLワークショップ・コンポーネント内のコマンド・エディタを使用すると、CREATE PROPERTY GRAPH DDL文でSQLプロパティ・グラフを作成できます(コマンド・エディタの使用を参照)。

  1. Oracle APEX GitHubリポジトリからグラフ・ビジュアライゼーション(プレビュー)プラグイン(region_type_plugin_graphviz.sql)をダウンロードします。
  2. 自分のAPEXワークスペースにサインインします(ワークスペースへのサインインを参照)。
  3. APEXワークスペースにDBMS_GVTパッケージを作成します。
    1. Oracle APEX GitHubリポジトリからoptional-23ai-only/gvt_sqlgraph_to_json.sqlファイルをダウンロードします。
    2. APEXワークスペースでgvt_sqlgraph_to_json.SQLスクリプトをアップロードし実行します(SQLスクリプトのアップロードを参照)。
  4. ダウンロードしたプラグイン・スクリプト(region_type_plugin_graphviz.sql)ファイルをターゲットAPEXアプリケーションにインポートします(プラグインのインポートを参照)。
  5. アプリケーション・ページにこのプラグインを実装して様々なグラフ・ビジュアライゼーションを実行します。

    次の基本的な例では、グラフ・ビジュアライゼーション・プラグインを使用してデータベース内にあるグラフをビジュアル化する手順を説明します。

    1. ページ・デザイナでアプリケーション・ページを開きます。
    2. ページ・デザイナの左ペインで「レンダリング」タブを選択します。
    3. 既存のコンポーネントを右クリックし、新しいリージョン・コンポーネントを追加します。
    4. 新しいリージョンを選択し、ページ・デザイナの右ペインにある「プロパティ・エディタ」の「リージョン」タブで次の属性を構成します。
      1. 識別の「タイトル」を入力します。
      2. 識別の「タイプ」としてグラフ・ビジュアライゼーション(プレビュー)を選択します。
      3. ソースの「場所」として「ローカル・データベース」を選択します。
      4. 「タイプ」の値を選択します。

        タイプ値として「SQL問合せ」または「プロパティ・グラフ」を選択できます。

      5. グラフ・データを取得するSQLグラフ問合せを埋め込みます。

        前のステップで選択したタイプに応じて、次の例で示すように問合せを指定できます:

        • SQL問合せ:次のようにSQLグラフ問合せ入力を指定します:
          SELECT *
  FROM GRAPH_TABLE (
           BANK_SQL_PG
           MATCH (a IS account) -[e IS transfer]-> (b IS account)
           WHERE a.id = 816
           COLUMNS(vertex_id(a) AS id_a, edge_id(e) AS id_e, vertex_id(b) AS id_b)
       )
        • プロパティ・グラフ:次のようにSQLグラフ問合せを指定します:
          • グラフ名: SQLプロパティ・グラフ名を選択します。
          • Match句:グラフ問合せのMATCH句を入力します。たとえば:

            (a IS account) -[e IS transfer]-> (b IS account)

          • Columns句:グラフ問合せのCOLUMNS句を入力します。たとえば:

            (vertex_id(a) AS id_a, edge_id(e) AS id_e, vertex_id(b) AS id_b)

          • WHERE句:オプションで、問合せのWHERE句を入力します。たとえば、a.id = 816です。
    5. アプリケーション・ページを実行して、このプラグインによってレンダリングされたグラフをビジュアル化します。

      図8-1 APEXアプリケーションでのSQLグラフ問合せのビジュアル化

      図8-1の説明が続きます
      「図8-1 APEXアプリケーションでのSQLグラフ問合せのビジュアル化」の説明

      ヒント:

      「高さ」属性を使用してビジュアライゼーション・パネルのサイズを制御できます。
  6. オプションで、前述のグラフ・ビジュアライゼーションにページ区切りを実装する必要がある場合は次の手順を実行します:
    1. APEXアプリケーション内のグラフ・ビジュアライゼーション・コンポーネントについて、「プロパティ・エディタ」の「属性」タブでSQL問合せでページ区切りをサポートする設定をオンにします。
    2. プロパティ・エディタの「属性」タブで、「ページ・サイズ」の値を設定します。
    3. アプリケーション・ページを保存し再実行します。
      グラフがページ区切りでレンダリングされます。
  7. オプションで、Sample Graph VisualizationsアプリケーションをOracle APEX GitHubリポジトリからインポートして実行できます。

親トピック: APEXグラフ・ビジュアライゼーション・プラグインを使用したSQLグラフ問合せのビジュアル化

8.2.1 APEXでのSample Graph Visualizationsアプリケーションのインポート

Sample Graph Visualizationsアプリケーションでは、グラフ・ビジュアライゼーション・プラグインの使用例を実際に確認できます。

次の手順を実行してSample Graph Visualizationsアプリケーションをインポートします。
  1. Sample Graph VisualizationsアプリケーションをOracle APEX GitHubリポジトリからダウンロードします。
  2. DBMS_GVTパッケージがAPEXワークスペースにまだ追加されていない場合は、作成します。
    1. Oracle APEX GitHubリポジトリからoptional-23ai-only/gvt_sqlgraph_to_json.sqlファイルをダウンロードします。
    2. APEXワークスペースでgvt_sqlgraph_to_json.SQLスクリプトをアップロードし実行します(SQLスクリプトのアップロードを参照)。
  3. アプリケーションのインポートでの手順に従って、APEXインスタンスにsample-apps/sample-graph-visualizations/sample-graph-visualizations_23ai.sqlをインポートしてアプリケーションをインストールします。
    このサンプル・アプリケーションは、インストールした後に直接実行できます。

    図8-2 Sample Graph Visualizationのホーム・ページ

    図8-2の説明が続きます
    「図8-2 Sample Graph Visualizationのホーム・ページ」の説明

    また、このサンプル・アプリケーションにはセキュアなHTTPS接続が必要であることに注意してください。セキュアな接続を無効にする場合は、次の手順を実行します。

    注意:

    本番デプロイメントでセキュアな接続を無効にすることはお薦めしません。
    1. アプリケーション・ビルダーでサンプル・アプリケーションのホームページに移動します。
    2. 「共有コンポーネント」をクリックします。
    3. 「セキュリティ」で「認証スキーム」をクリックします。
    4. 「現行」認証スキームをクリックします。
    5. セッション共有タブをクリックし、「セキュア」スイッチをオフにします。
    6. 「変更の適用」をクリックしてから、アプリケーションを実行します。

親トピック: APEXグラフ・ビジュアライゼーション・プラグインの概要