機械翻訳について

APEXグラフ・ビジュアライゼーション・プラグインの開始(Oracle Database 23ai)

Oracle Database 23aiを使用して、Autonomous DatabaseインスタンスのAPEXアプリケーションでAPEXグラフ・ビジュアライゼーション・プラグインを開始します。

始める前に、「APEXグラフ・ビジュアライゼーション・プラグインを使用するための前提条件」で説明されている前提条件を満たしていることを確認してください。

1. Oracle APEX GitHubリポジトリからグラフ・ビジュアライゼーション(プレビュー)プラグイン(region_type_plugin_graphviz.sql)をダウンロードします。
2. Autonomous Databaseインスタンスで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. ID 「タイトル」を入力します。
      2. Identification 「タイプ」として「グラフ・ビジュアライゼーション(プレビュー)」を選択します。
      3. ソース「ロケーション」を「ローカル・データベース」として選択します。
      4. 「タイプ」の値を選択します。

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

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

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

         • SQL問合せ:次のようにSQLグラフ問合せ入力を指定します:

           SELECT *
             FROM GRAPH_TABLE (
                      BANK_SQL_PG
                      MATCH (a IS accounts) -[e IS transfers]-> (b IS accounts)
                      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 accounts) -[e IS transfers]-> (b IS accounts)

           • 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. アプリケーション・ページを実行して、このプラグインによってレンダリングされたグラフをビジュアル化します。
      
      図apex_gviz_basic_graph.pngの説明

      ノート:

      Oracle Database 23aiのAPEXグラフ・ビジュアライゼーション・プラグインでは、DATEまたはTIMESTAMPデータ型の頂点キーまたはエッジ・キーを使用するグラフはサポートされていません。 DATEまたはTIMESTAMPキーでグラフのグラフ問合せ結果を視覚化すると、グラフ・データのサブセットのみが表示される場合があります。
6. オプションで、前述のグラフ・ビジュアライゼーションにページ区切りを実装する場合は、次のステップを実行します:
   1. APEXアプリケーション内のグラフ・ビジュアライゼーション・コンポーネントについて、「プロパティ・エディタ」の「属性」タブでSQL問合せでページ区切りをサポートする設定をオンにします。
   2. プロパティ・エディタの「属性」タブで、「ページ・サイズ」値を設定します。
   3. アプリケーション・ページを保存して再実行します。
      グラフはページ区切りでレンダリングされます。
7. オプションで、Sample Graph VisualizationsアプリケーションをOracle APEX GitHubリポジトリからインポートして実行できます。
   1. アプリケーションのインポートでの手順に従って、APEXインスタンスにsample-apps/sample-graph-visualizations/sample-graph-visualizations_23ai.sqlをインポートしてアプリケーションをインストールします。
      サンプル・アプリケーションをインストールする場合は、サポートするオブジェクトをインストールするためのCREATE VIEW権限があることを確認してください。

      このサンプル・アプリケーションは、インストールした後に直接実行できます。

      
      図apex_sample_graph_viz.pngの説明

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

      注意:

      本番デプロイメントでセキュアな接続を無効にすることはお薦めしません。

      1. アプリケーション・ビルダーでサンプル・アプリケーションのホームページに移動します。
      2. 「共有コンポーネント」をクリックします。
      3. 「セキュリティ」で「認証スキーム」をクリックします。
      4. 「現行」認証スキームをクリックします。
      5. セッション共有タブをクリックし、「セキュア」スイッチをオフにします。
      6. 「変更の適用」をクリックしてから、アプリケーションを実行します。