既存のリレーショナル表からのプロパティ・グラフの作成

既存のリレーショナル表からの「プロパティ」グラフの作成

既存のリレーショナル表からプロパティ・グラフを作成できます。

ノート:

「PGオブジェクト」グラフ・タイプはサポートされなくなりました。「PGQLプロパティ・グラフ」または「SQLプロパティ・グラフ」を作成することをお薦めします。
SQLプロパティ・グラフは、Oracle AI Database 26aiでのみサポートされています。したがって、Oracle AI Database 26aiでAutonomous AI Databaseインスタンスを使用している場合は、SQLプロパティ・グラフを作成するオプションがあります。

また、グラフの作成時に、PGQLまたはSQLプロパティ・グラフの作成に使用されるソース表に主キーに日時データ型が含まれている場合、プロパティ・グラフ・ウィザードによって警告がスローされることにも注意してください。さらに、PGQLプロパティ・グラフの場合、表にコンポジット頂点キーが含まれている場合は、警告が発行されます。

ただし、警告を無視してプロパティ・グラフを作成することはできます。ただし、プロパティ・グラフをメモリーにロードすることはできません。

既存のリレーショナル表からプロパティ・グラフを作成するには:

グラフ・ページにナビゲートします。
「プロパティ・グラフ」タブを選択し、「グラフの作成」をクリックします。
プロパティ・グラフ・ウィザードが開き、「概要」ページが表示されます。
「グラフ名」を入力

図pg_workflow_overview.pngの説明

Graph Studioでは、グラフ名の大文字と小文字は区別されず、デフォルトで大文字に正規化されます。ただし、ステップ12で説明するように、「大/小文字の保持」トグルを使用して大/小文字の区別を有効にできます。
オプションで、グラフの「説明」を入力し、「次へ」をクリックします。
必要な「グラフ・タイプ」を選択します。
Graph Studioでは、次の2つのタイプのプロパティ・グラフの作成がサポートされています。
- SQLプロパティ・グラフ: SQLプロパティ・グラフを作成するオプションは、Oracle AI Database 26aiでAutonomous AI Databaseインスタンスを使用している場合にのみ使用できます。
- PGQLプロパティ・グラフ: PGQLプロパティ・グラフを作成するオプションは、すべてのタイプのテナンシで使用でき、すべてのデータベース・バージョンでサポートされています。
グラフの入力として必要なソース・データ表を選択し、右側の「選択」セクションに移動します。

図pg_workflow_select_tables.pngの説明

Oracleデータ型をグラフ・サーバー(PGX)データ型にマップする方法を学習するには、「PGXデータ型へのOracleデータ型のマッピング」を参照してください。
「グラフ・スキーマ」ドロップダウンを使用して、新しいグラフを作成するモードを選択します。
次のモードがサポートされています。
- 外部キー関係から:このデフォルト・モードでは、基礎となるソース・データベース表(前のステップで選択)の外部キー関係を使用して、グラフの頂点およびエッジが自動的に差し引かれます。
- 手動:このモードでは、前のステップで選択したデータベース表に基づいて、グラフの頂点およびエッジを手動で作成できます。
「次へ」をクリックします。
- グラフの頂点とエッジを手動で追加することを選択した場合は、グラフの手動作成を参照してください。
- 外部キー関係を使用してグラフを作成することを選択した場合は、グラフ定義が自動的に表示されます。例:
  図pg_workflow_define_graph.pngの説明
  前の図では、左ペインの「Vertices」セクションと「Edges」セクションに、グラフの頂点とエッジがそれぞれ表示されます。プロパティ・グラフは、右側のペインに視覚的に表示されます。
  
  必要に応じて、グラフ定義を変更できます。「デザイナ」タブでグラフ定義を更新する方法については、「グラフの手動作成」を参照してください。
  
  SQLプロパティ・グラフを作成する場合は、グラフ要素表に複数のラベルを割り当てることもできます。詳細は、「頂点表またはエッジ表への複数のラベルの割当て」を参照してください。
  
  ノート:
  頂点およびエッジ表のキーがグラフに定義されているかどうかを確認します。これらのキーは、プロパティ・グラフ・ウィザードによって自動的に生成されます。ウィザードで頂点とエッジ表のキーを生成できない場合は、これらのキーを手動で指定する必要があります。そうしないと、ウィザードはグラフ作成の次のステップに進みません。頂点およびエッジ表のキーを追加または編集する方法の詳細は、「VertexおよびEdge表キーの指定」を参照してください。
「次」をクリックして、グラフのサマリーを表示します。

図pg_workflow_summary.pngの説明

Graph Studioはグラフ定義を評価し、検証が成功した場合はグラフのサマリーを表示します。
そうしないと、エラー、警告、またはその両方が報告されることがあります:

図errors_warnings.pngの説明
エラーと警告は、グラフのタイプによって異なります。また、次の点にも注意してください。
- エラー: エラーは、エラーと警告スライダの最初に表示されます。グラフを作成するには、エラーを解決する必要があります。
- 警告: エラーの後に警告が報告されます。 Graph Studioでは、警告にもかかわらずグラフを作成できますが、グラフはメモリーにロードできません。プロパティ・グラフ作成時の警告の詳細は、「プロパティ・グラフ作成時の警告」を参照してください。
エラー・メッセージまたは警告メッセージで提供される次のいずれかのアクションを選択できます:
- 列の削除: 頂点またはエッジ表から列を削除すると、グラフ定義が更新されて再検証されます。
- 表の削除: 頂点またはエッジ表を削除すると、グラフ定義が更新されて再検証されます。
- 無視: エラーまたは警告メッセージを閉じます。警告を無視すると、グラフを作成する次のステップに進むことができます。ただし、エラーを無視しても、グラフの作成を続行できません。レポートされたすべてのエラーおよび警告が無視された場合、「エラーと警告」スライダは自動的に閉じられます。
- すべて削除: エラーまたは警告の原因となっているすべての表および列を削除し、グラフ定義が更新されて再検証されます。
- すべて無視: エラーと警告スライダを閉じます。
「グラフの作成」をクリックします。

これにより、「グラフの作成」スライダが次のように開きます:

「図create_graph.pngの説明」
オプションで、「メモリーにロード」トグルをオンまたはオフに切り替えます。
デフォルトでは、「メモリーにロード」トグルは無効になっています。グラフ定義で報告された警告を無視した場合、グラフをメモリーにロードできないため、トグルは無効のままになります。
「メモリー・グラフ・サイズの推定」も計算され、スライダに表示されます。また、コンピュート環境のステータスについては、次の点に注意してください:
- デタッチ済:
  - 推定グラフ・サイズがコンピュート環境設定で構成されているグラフ・サーバー(PGX)メモリーより小さい場合、この新しい推定値はグラフ・サーバー(PGX)のデフォルト・メモリー・プリファレンスとして自動的に保存されます。この場合、スライダには次のメッセージが追加で表示されます:
    This value will be saved as memory preference when compute environment is started.
  - 推定グラフ・サイズがコンピュート環境設定でグラフ・サーバー(PGX)に割り当てられる最大メモリーより大きい場合、次の警告がスライダに表示されます:
    A graph of this size will likely result in OutOfMemory errors during loading or analysis. Consider loading a subgraph instead.
- 添付: 推定グラフ・サイズがコンピュート環境設定で割当て可能なグラフ・サーバー(PGX)メモリーより大きい場合、次の警告がスライダに表示されます:
  A graph of this size will likely result in OutOfMemory errors during loading or analysis. Consider loading a subgraph instead.
オプションで、「大/小文字を保持」トグルをオンまたはオフに切り替えます。
デフォルトでは、このトグルはオフになっています。グラフ、プロパティおよびラベル名の大/小文字を保持する場合は、「ケースを保持」トグルを有効にします。このような場合は、ノートブックのSQLグラフ問合せで後からそれらを参照するときに、保存されている名前を引用符で囲むようにしてください。
「グラフの作成」をクリックして、propertyグラフを作成します。