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

機械翻訳について

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

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

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

Oracle APEX GitHubリポジトリからグラフ・ビジュアライゼーション(プレビュー)プラグインをダウンロードします。
Autonomous DatabaseインスタンスのAPEXワークスペースにサインインします。
「Oracle APEXアプリケーション・ビルダー・ユーザーズ・ガイド」の「プラグインのインポート」のステップに従って、ダウンロードしたプラグイン・スクリプト(region_type_plugin_graphviz.sql)ファイルをターゲットAPEXアプリケーションにインポートします。
アプリケーション・ページにプラグインを実装して、グラフ・ビジュアライゼーションを実行します。
次の基本的な例では、グラフ・ビジュアライゼーション・プラグインを使用して、Autonomous Databaseインスタンスに存在するグラフをビジュアル化するステップについて説明します。
1. 「ページ・デザイナ」でアプリケーション・ページを開きます。
2. ページ・デザイナの左ペインで「レンダリング」タブを選択します。
3. 既存のコンポーネントを右クリックし、新しいリージョン・コンポーネントを追加します。
4. 新しいリージョンを選択し、ページ・デザイナの右ペインにある「プロパティ・エディタ」の「リージョン」タブで次の属性を構成します:
  1. ID 「タイトル」を入力します。
  2. Identification 「タイプ」として「グラフ・ビジュアライゼーション(プレビュー)」を選択します。
  3. ソース「ロケーション」を「ローカル・データベース」として選択します。
  4. 「SQL問合せ」として「タイプ」を選択します。
  5. ORA_PGQL_TO_JSON PL/SQLファンクションでPGQL問合せをラップするSQL問合せを実行して、グラフ・データを取得します。
    たとえば:
```
SELECT 
  ORA_PGQL_TO_JSON(query => 'SELECT e FROM MATCH
    (e:employees) ON OEHR_EMPLOYESS LIMIT 20') 
  FROM DUAL;
```
    次の点に注意してください。
    - プラグインは、頂点およびエッジ情報を含む入力グラフ・データをJSON形式でのみ受け入れます。これは、PGQL問合せを入力として受け取り、グラフ出力をJSON構造で返すORA_PGQL_TO_JSON PL/SQL関数でサポートされています。
    - PGQL問合せで参照されるグラフは、Autonomous Databaseインスタンスに存在する必要があります。
5. アプリケーション・ページを実行して、プラグインによってレンダリングされたグラフをビジュアル化します。
  「図apex_basic_graph.pngの説明」
オプションで、前述のグラフ・ビジュアライゼーションにページ区切りを実装する場合は、次のステップを実行します:
1. APEXアプリケーション内のグラフ・ビジュアライゼーション・コンポーネントについて、「プロパティ・エディタ」の「属性」タブでSQL問合せでページ区切りをサポートする設定をオンにします。
2. 次のサンプル・コードに示すように、SQL問合せでORA_PGQL_TO_JSONファンクションをコールするときに、page_startおよびpage_sizeパラメータをバインドします:
```
SELECT 
  ORA_PGQL_TO_JSON(query => 'SELECT e FROM MATCH
    (e:employees) ON OEHR_EMPLOYESS LIMIT 20',:page_start,:page_size) 
  AS result FROM DUAL;
```
3. プロパティ・エディタの「属性」タブで、「ページ・サイズ」値を設定します。
  page_start値は自動的に設定されます。
4. アプリケーション・ページを保存して再実行します。
  グラフはページ区切りでレンダリングされます。
オプションで、Oracle APEX GitHubリポジトリから「サンプル・グラフのビジュアライゼーション」アプリケーションをダウンロードします。
このアプリケーションは、グラフ・ビジュアライゼーション・プラグインの使用方法を示します。
1. アプリケーションのインポートのステップに従って、ダウンロードしたsample-apps/sample-graph-visualizations/sample-graph-visualizations_19adb.sqlをAPEXインスタンスにインポートします。
2. アプリケーション・ビルダーのアプリケーションのホーム・ページからサンプル・アプリケーションを実行します。