1. プロパティ・グラフのグラフ開発者ガイド
  2. グラフ・ビジュアライゼーション・アプリケーション
  3. グラフ・ビジュアライゼーション・アプリケーションの使用

21 グラフ・ビジュアライゼーション・アプリケーションの使用

グラフ・ビジュアライゼーション・アプリケーションは、グラフ・ビジュアライゼーション・ライブラリに基づいています。このインタフェースを使用すると、グラフ・サーバー(PGX)およびデータベース内のグラフに対してPGQL問合せを実行できます。

関連項目:

プロパティ・グラフのビジュアライゼーションのグラフJavaScript APIリファレンス

グラフ・ビジュアライゼーション・アプリケーションは、次の3つのタブで構成されています:

  • グラフ・サーバー: グラフ・サーバー(PGX)にロードされるグラフをビジュアル化する場合。
  • データベース(PGQLプロパティ・グラフ): データベース内のPGQLプロパティ・グラフをビジュアル化する場合。
  • データベース(SQLプロパティ・グラフ): SQLプロパティ・グラフをビジュアル化する場合。このタブ・オプションは、Oracle Database 23aiでのみサポートされています。

各タブは、インタフェースの上部の問合せエディタと下部のグラフ・ビジュアライゼーション・パネルで構成されています。

問合せレベルのすべてのアクション(問合せの実行や取消しなど)、特定のタブへのアクセス権のあるグラフのリストの表示、出力をビジュアル化するための設定の構成は、次のツールバーを使用して実行します:

図21-1 サポートされているアクション


図21-1の説明が続きます
「図21-1 サポートされているアクション」の説明

「グラフをメモリーにロード」に対するアクションは、グラフ・サーバー・タブでのみサポートされています。

グラフ・ビジュアライゼーション・パネルの右側に表示される次のツールバーを使用して、グラフ・ビジュアライゼーション問合せの結果をグラフ(デフォルト)または表形式で表示できます:

図21-2 表示形式


図21-2の説明が続きます
「図21-2 表示形式」の説明

親トピック: グラフ・ビジュアライゼーション・アプリケーション

21.1 グラフ・サーバー(PGX)にロードされたグラフに対するPGQL問合せのビジュアル化

グラフ・サーバー(PGX)にグラフを作成またはロードしてから、グラフ・ビジュアライゼーション・アプリケーションのグラフ・サーバー・タブでPGQLグラフ問合せを実行できます。

次の項では、グラフ・サーバー・タブで実行できる様々なアクションについて詳しく説明します。

グラフ・サーバー(PGX)でのプロパティ・グラフの作成

CREATE PROPERTY GRAPH PGQL文を実行して、グラフ・サーバー(PGX)にグラフを作成できます。たとえば:

図21-3 グラフ・サーバー・メモリーでのプロパティ・グラフの作成


図21-3の説明が続きます
「図21-3 グラフ・サーバー・メモリーでのプロパティ・グラフの作成」の説明

グラフが作成され、グラフ・サーバー・メモリー(PGX)にロードされます。これは、セッションの最後に破棄される一時的なグラフです。

グラフ・リストの取得アイコン(前の図で強調表示されている)をクリックすると、グラフ・サーバー・メモリーにロードされているすべてのグラフを表示できます。

グラフ・サーバー(PGX)メモリーへのデータベース・プロパティ・グラフのロード

次のステップを実行して、既存のPGQLまたはSQLプロパティ・グラフをデータベースからグラフ・サーバー(PGX)メモリーにロードすることもできます:

  1. グラフ・サーバー・タブのload_icon「グラフをメモリーにロード」アイコンをクリックします。

    アクセス権があるデータベース・グラフのリストは、次のように表示されます:

    図21-4 データベース・グラフのリスト


    図21-4の説明が続きます
    「図21-4 データベース・グラフのリスト」の説明

    SQLプロパティ・グラフは、Oracle Database 23aiに接続している場合にのみリストされることに注意してください。

  2. 目的のグラフに対してグラフのロードをクリックします。

    グラフをメモリーにロードするための確認ダイアログが開きます。

    図21-5 メモリーへのグラフのロードの確認


    図21-5の説明が続きます
    「図21-5 メモリーへのグラフのロードの確認」の説明

  3. オプションで、「拡張オプション」構成を展開する場合にクリックします。

    次の詳細オプションを構成できます:

    • 無効な辺のエラーを無視: このトグルをオンにして、頂点に接続していないすべてのエッジを無視します。
    • 同期可能: このトグルをオンにして、グラフを同期できることを確認します。
    • 最適化の対象: 次のグラフ最適化戦略のいずれかを選択します:
      • READ: 読取り集中型のシナリオ用に最適化します。
      • UPDATE: 更新集中型のシナリオ用に最適化します。
    • 並列度: 並列度を指定します。
  4. 「グラフをメモリーにロード」をクリックします。

    グラフに対する「進行中」ステータスは、グラフのロード・プロセスが開始され、グラフがメモリーに正常にロードされると、ステータスが「メモリー」に更新されることを示します。

  5. 「閉じる」をクリックし、グラフ・リストの取得アイコンをクリックして、グラフがメモリーにロードされていることを確認します。

グラフでのPGQL問合せの実行

目的のグラフにPGQL問合せを入力し、「問合せの実行」をクリックして問合せを実行できます。正常に実行されると、グラフのビジュアライゼーション結果(ノードとその接続を含む)が下部パネルに表示されます。ノードまたは接続を右クリックすると、ツールチップ情報が表示され、ノードをドラッグして移動できます。

次の図は、グラフ内の頂点から他の頂点へのすべての有向エッジを識別するサンプル問合せのビジュアライゼーションを示しています。

図21-6 PGQL問合せのビジュアル化


図21-6の説明が続きます
「図21-6 PGQL問合せのビジュアル化」の説明

親トピック: グラフ・ビジュアライゼーション・アプリケーションの使用

21.2 PGQLプロパティ・グラフに対するPGQL問合せのビジュアル化

グラフ・ビジュアライゼーション・アプリケーションのデータベース(PGQLプロパティ・グラフ)タブで、データベース内のPGQLプロパティ・グラフに対するPGQL問合せをビジュアル化できます。

グラフ・ビジュアライゼーション・アプリケーションを使用して、データベースでPGQLプロパティ・グラフを作成、問合せ、変更およびビジュアル化できます。次のPGQL操作がサポートされています。

親トピック: グラフ・ビジュアライゼーション・アプリケーションの使用

21.3 SQLプロパティ・グラフに対するグラフ問合せのビジュアル化

グラフ・ビジュアライゼーション・アプリケーションのデータベース(SQLプロパティ・グラフ)・タブで、データベース内のSQLプロパティ・グラフを問い合せてビジュアル化できます。

ただし、GRAPH_TABLE問合せの頂点およびエッジをIDとそのすべてのラベルおよびプロパティとともにビジュアル化するには、問合せで頂点IDまたはエッジID(あるいはその両方)を返す必要があります。

たとえば、次の図は、SQLプロパティ・グラフでのSQL GRAPH_TABLE問合せのビジュアライゼーションを示しています。問合せのCOLUMNS句では、VERTEX_IDおよびEDGE_ID演算子が使用されています。

ノート:

グラフ・ビジュアライゼーション・アプリケーションでは、SELECTグラフ問合せのみがサポートされています。

図21-12 SQLプロパティ・グラフでのグラフ問合せ

図21-12の説明が続きます
「図21-12 SQLプロパティ・グラフでのグラフ問合せ」の説明

グラフの名前は、SQLグラフ問合せで指定する必要があります。使用可能なグラフのリスト・アイコン(前の図で強調表示されている)をクリックすると、アクセスできるSQLプロパティ・グラフのリストを表示できます。

関連項目:

詳細は、SQLグラフ問合せを参照してください

親トピック: グラフ・ビジュアライゼーション・アプリケーションの使用

21.4 グラフ・ビジュアライゼーション・モードおよびグラフ凡例

グラフ・ビジュアライゼーションのツールバー、サポートされているグラフ・ビジュアライゼーション・モードおよびグラフ凡例(問合せの結果をグラフ形式で表示している場合)について学習します。

グラフ・ビジュアライゼーションのツールバー

グラフ・ビジュアライゼーションのツールバーは、次のようにグラフ・ビジュアライゼーション・パネルの左側に表示されます:

図21-13 グラフ・ビジュアライゼーションのツールバー


図21-13の説明が続きます
「図21-13 グラフ・ビジュアライゼーションのツールバー」の説明

ツールバーでは、次のグラフ・ビジュアライゼーション・モードがサポートされています:

  • 移動/ズーム: このモードでは、ズーム・インおよびズーム・アウトしたり、ビジュアライゼーションの別の部分に移動できます。
  • 画面に合せる: このモードは、グラフ・ビジュアライゼーション・ビューの結果のグラフを適合させます。
  • 固定モードの切替え: このモードでは、ノードのドラッグ操作を取り消すことができます。
  • グラフの操作: このモードでは、グラフ・ビジュアライゼーションを操作できます。サポートされているアクションは次のとおりです:
    • 削除: 選択した頂点をビジュアライゼーションから削除します。ツールチップから実行することもできます。
    • グループ: 選択した複数の頂点をグループ化し、それらを1つの頂点にまとめます。
    • グループ化解除: まとめた頂点のグループを選択し、それらのグループ化を解除します。
    • 元に戻す: 最後のアクションを元に戻します。
    • 再実行: 最後のアクションを再実行します。
    • リセット: 問合せの後にビジュアライゼーションを元の状態にリセットします。

グラフ・ビジュアライゼーションの凡例

グラフ・ビジュアライゼーションの凡例がグラフ・ビジュアライゼーション・パネルの右側に表示され、グラフの頂点とエッジを表す凡例アイテムが表示されます。たとえば:

図21-14 グラフの凡例


図21-14の説明が続きます
「図21-14 グラフの凡例」の説明

親トピック: グラフ・ビジュアライゼーション・アプリケーションの使用

21.5 グラフ・ビジュアライゼーションの設定

「設定」歯車アイコンをクリックして、グラフ・ビジュアライゼーションの設定ウィンドウを開くことができます。

「ビジュアライゼーション設定」ウィンドウは、「一般」および「スタイル」タブで構成されています。

一般設定の構成

頂点およびエッジ・キャプションを追加し、グラフのビジュアライゼーション設定の「一般」タブでグラフ・レイアウトおよびページ・サイズを設定できます:

図21-15 「一般」タブの構成


図21-15の説明が続きます
「図21-15 「一般」タブの構成」の説明

  • 頂点キャプションの向き: 選択した頂点プロパティが表示される場所を決定します。
  • 頂点キャプション: 頂点に表示するプロパティを決定します。

    「+追加」をクリックして頂点キャプションを追加し、必要な頂点の「ラベル」および頂点の「プロパティ」を選択します。

  • エッジ・キャプション: エッジに表示するプロパティを決定します。

    「+追加」をクリックしてエッジ・キャプションを追加し、必要なエッジの「ラベル」およびエッジの「プロパティ」を選択します。

  • 最大表示キャプション長: 切捨て前の最大キャプション長。
  • レイアウト: ノードの位置を計算し、グラフのビジュアル構造を決定します。

    サポートされるレイアウトは、円、同心、フォース(デフォルト)、グリッド、階層、事前設定、放射状、およびランダムです。

  • ページ・サイズ: 結果セットからビジュアル化するエントリの数を決定します。

頂点スタイルとエッジ・スタイルの構成

頂点およびエッジのスタイルを構成および管理して、グラフ内の頂点およびエッジの外観をカスタマイズできます。構成されているすべてのスタイルが、グラフのビジュアライゼーション設定の「スタイル」タブにリストされます。

図21-16 頂点およびエッジ・スタイルの構成


図21-16の説明が続きます
「図21-16 頂点およびエッジ・スタイルの構成」の説明

新しい頂点またはエッジ・スタイルを追加するには、必要に応じて新規頂点スタイルまたは新規エッジ・スタイルをクリックし、次の値を構成します:

  • 名前: スタイルの名前
  • 条件: 「+」をクリックして要素(頂点またはエッジ)の条件を追加し、次の値を指定します:
    • 頂点またはエッジ要素の「プロパティ」。
    • 適用する「演算子」。サポートされている演算子は次のとおりです。
      • = (等しい)
      • < (より小さい)
      • <=(以下)
      • > (より大きい)
      • >=(以上)
      • != (等しくない)
      • ~ (フィルタは正規表現)
      • * (任意: ワイルドカードと同様に、任意のものと一致)
    • プロパティおよび演算子に対して満たす必要がある「値」

    条件は必要な数だけ追加できます。条件を満たすすべての要素について、次の強調表示されたスタイル設定のいずれかを構成できます:

    • サイズ: 頂点またはエッジのサイズ
    • カラー: 頂点またはエッジの色
    • アイコン: 頂点のイメージ(エッジには適用されません)
    • ラベル: 頂点またはエッジのラベル
    • アニメーション: アニメーション(「パルス」または「フラッシュ」)およびアニメーション・サイクルの期間

次の例では、頂点スタイルの構成例を示します。

図21-17 頂点スタイルの追加


図21-17の説明が続きます
「図21-17 頂点スタイルの追加」の説明

親トピック: グラフ・ビジュアライゼーション・アプリケーションの使用