Skip to main content

Overview

Graph Builder is a feature that creates graphs from multiple Corvic Tables, enabling you to build knowledge graphs, property graphs, bipartite graphs, heterogeneous graphs, homogeneous graphs, and temporal (dynamic) graphs. This feature allows you to design custom graph schemas by connecting Corvic Tables through foreign key constraints, creating a graph view on your data.
Watch tutorial: ▶️ Custom Knowledge Graph - Learn how to build custom knowledge graphs from your data

Category

Corvic Tables - This feature is designed to work with Corvic Tables, enabling you to create graph structures that serve as views on your tabular data.

Input

Corvic Tables - The Graph Builder feature accepts multiple Corvic Tables as input. Select two or more Corvic Tables from your data room that are connected by foreign key relationships.
The input requires more than one Corvic Table connected by foreign key constraints. At least one input Corvic Table must contain a foreign key relationship to another selected Corvic Table in order to build the graph structure.
Graph Type Support: Only undirected graphs are supported at this time. Directed graph support will be available in future releases.

Output

Corvic Graph - The Graph Builder feature produces a Corvic Graph that serves as a view on your Corvic Tables. The output graph includes:
  • Graph Structure: Nodes and edges representing entities and relationships from your Corvic Tables
  • Custom Schema: Graph schema designed based on foreign key relationships between input tables
  • Graph Types: Supports knowledge graphs, property graphs, bipartite graphs, heterogeneous graphs, homogeneous graphs, and temporal (dynamic) graphs
The output Corvic Graph provides a graph-based view of your tabular data, enabling graph-based analysis, relationship traversal, and graph neural network embeddings. The graph structure is defined by the foreign key relationships between your input Corvic Tables.

Parameters

ParameterTypeRequiredDescription
input_tablesarrayYesThe Corvic Tables to build the graph from. Select two or more Corvic Tables from your data room. The tables must be connected by foreign key relationships. At least one table must contain a foreign key that references another selected table.
output_namestringNoOptional custom name for the output Corvic Graph. If not provided, a default name will be automatically generated based on the input Corvic Table names.

Schema Design

The graph schema is automatically designed based on foreign key constraints between your input Corvic Tables:
  • Nodes: Represent entities from your Corvic Tables
  • Edges: Represent relationships defined by foreign key constraints
  • Properties: Node and edge properties are derived from columns in your Corvic Tables
  • Graph Type: Determined by the structure and relationships in your data

Usage Example

To use Graph Builder in a Data App:
  1. Add multiple Corvic Tables to the Data App canvas
  2. Ensure the tables are connected by foreign key relationships
  3. Click the ”+” button next to one of the Corvic Tables
  4. Select “Graph Builder” from the actions menu
  5. Select the input Corvic Tables (two or more) that you want to connect
  6. Review the automatically detected foreign key relationships
  7. Optionally modify the graph schema or rearrange table relationships
  8. Optionally provide a name for the output Corvic Graph
  9. Run the Data App to execute the graph building
  10. Review the generated Corvic Graph structure