機械翻訳について

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

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

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

1. Oracle APEX GitHubリポジトリからグラフ・ビジュアライゼーション(プレビュー)プラグイン(region_type_plugin_graphviz.sql)をダウンロードします。
2. Autonomous AI DatabaseインスタンスのAPEXワークスペースにサインインします。
3. APEXワークスペースにDBMS_GVTパッケージを作成します。
   1. Oracle APEX GitHubリポジトリからrequired-for-26ai/gvt_sqlgraph_to_json.sqlファイルをダウンロードします。
   2. APEXワークスペースでgvt_sqlgraph_to_json.SQLスクリプトをアップロードし実行します(SQLスクリプトのアップロードを参照)。
   3. Oracle APEX GitHubリポジトリからrequired-for-26ai/required_helper_functions.sqlファイルをダウンロードし、APEXワークスペースでスクリプトを実行します。
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 AI Database 26aiのAPEXグラフ・ビジュアライゼーション・プラグインでは、DATEまたはTIMESTAMPデータ型の頂点キーまたはエッジ・キーを使用するグラフはサポートされていません。 DATEまたはTIMESTAMPキーでグラフのグラフ問合せ結果を視覚化すると、グラフ・データのサブセットのみが表示される場合があります。
6. オプションで、グラフに表示する要素の数を動的に変更することによって、グラフの表示サイズを制御できます。
   表示サイズ・コントロールの表示が「外観」パネルでオンになっている場合、グラフの表示サイズが、次のようにグラフ・ビジュアライゼーションの下部に表示されます:

   
   

   
   図apex_display_size.pngの説明

   
   

   次に、この図の意味を説明します。

   • manyの頂点のうち54個: これは、54個の頂点が表示されていることを示し、manyはグラフ内の頂点の合計数を示します。
   • manyのエッジのうち46個: これは、46個のエッジが表示されていることを示し、manyはグラフ内のエッジの合計数を示します。
   • manyの要素のうち100個: これは、100個の要素が表示されていることを示し、manyはグラフ要素の合計数を示します。 初期値は、「設定」パネルの表示サイズ構成によって異なります。
7. オプションで、Sample Graph VisualizationsアプリケーションをOracle APEX GitHubリポジトリからインポートして実行できます。
   1. アプリケーションのインポートでの手順に従って、APEXインスタンスにsample-apps/sample-graph-visualizations/sample-graph-visualizations_26ai.sqlをインポートしてアプリケーションをインストールします。
      サンプル・アプリケーションをインストールする場合は、サポートするオブジェクトをインストールするためのCREATE VIEW権限があることを確認してください。

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

      
      図apex_sample_graph_viz.pngの説明

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

      注意:

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

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