Table of Contents
- List of Figures
- List of Tables
- Title and Copyright Information
- Preface
- Changes in This Release for This Guide
-
Part I Getting Started with Oracle Property Graphs
- 1 Introduction to Property Graphs
- 2 Using Oracle Graph with the Autonomous Database
-
Part II SQL Property Graphs
- 3 Introduction to SQL Property Graphs
-
4
SQL DDL Statements for Property
Graphs
-
4.1
Creating a SQL Property Graph
- 4.1.1 About Vertex and Edge Graph Element Tables
- 4.1.2 About Vertex and Edge Table Keys
- 4.1.3 About Labels and Properties
- 4.1.4 Using Graph Options to Create SQL Property Graphs
- 4.1.5 Granting System and Object Privileges for SQL Property Graphs
- 4.1.6 Retrieving SQL Creation DDL Using the DBMS_METADATA Package
- 4.1.7 Limitations of Creating a SQL Property Graph
- 4.2 Revalidating a SQL Property Graph
- 4.3 Dropping a SQL Property Graph
- 4.4 JSON Support in SQL Property Graphs
-
4.1
Creating a SQL Property Graph
-
5
SQL Graph Queries
- 5.1 About Graph Pattern
- 5.2 Variable Length Path Patterns
- 5.3 Complex Path Patterns
- 5.4 Vertex and Edge Identifiers
- 5.5 Using Aggregate Functions in SQL Graph Queries
- 5.6 Running SQL Graph Queries at a Specific SCN
- 5.7 Privileges to Query a SQL Property Graph
- 5.8 Examples for SQL Graph Queries
- 5.9 Supported Features and Limitations for Querying a SQL Property Graph
- 5.10 Tuning SQL Property Graph Queries
- 5.11 Type Compatibility Rules for Determining Property Types
- 5.12 Viewing and Querying SQL Property Graphs Using SQL Developer
-
6
Loading a SQL Property Graph into the Graph
Server (PGX)
- 6.1 Loading a SQL Property Graph Using the readGraphByName API
- 6.2 Loading a Subgraph Using PGQL Queries
- 6.3 Expanding a Subgraph
- 6.4 Handling Vertex and Edge Identifiers in the Graph Server (PGX)
- 6.5 Mapping Oracle Database Types to PGX Types
- 6.6 Privileges to Load a SQL Property Graph
- 6.7 Restriction on Key Types
- 6.8 Loading SQL Property Graphs with Unsupported Key Types
- 7 Executing PGQL Queries Against SQL Property Graphs
- 8 Visualizing SQL Graph Queries Using the APEX Graph Visualization Plug-in
-
Part III PGQL Property Graphs
- 9 About PGQL Property Graphs
- 10 Loading a PGQL property graph into the Graph Server (PGX)
- 11 Quick Starts for Using PGQL Property Graphs
- 12 Getting Started with the Client Tools
-
13
Property Graph Query Language (PGQL)
- 13.1 Creating a Property Graph Using PGQL
- 13.2 Pattern Matching with PGQL
- 13.3 Edge Patterns Have a Direction with PGQL
- 13.4 Vertex and Edge Labels with PGQL
- 13.5 Variable-Length Paths with PGQL
- 13.6 Aggregation and Sorting with PGQL
- 13.7 Executing PGQL Queries Against PGQL Property Graphs
-
Part IV Installing Oracle Graph Server
(PGX) and Client
-
14
Oracle Graph Server and Client Installation
- 14.1 Before You Begin
-
14.2
Oracle Graph Server
Installation
- 14.2.1 Using the RPM Installation
- 14.2.2 Deploying Oracle Graph Server to a Web Server
-
14.2.3
User Authentication and Authorization
- 14.2.3.1 Privileges and Roles in Oracle Database
- 14.2.3.2 Basic Steps for Using an Oracle Database for Authentication
- 14.2.3.3 Prepare the Graph Server for Database Authentication
- 14.2.3.4 Store the Database Password in a Keystore
- 14.2.3.5 Adding Permissions to Publish the Graph
- 14.2.3.6 Token Expiration
- 14.2.3.7 Customizing Roles and Permissions
- 14.2.3.8 Revoking Access to the Graph Server
- 14.2.3.9 Examples of Custom Authorization Rules
- 14.2.3.10 Kerberos Enabled Authentication for the Graph Server (PGX)
- 14.3 Oracle Graph Client Installation
- 14.4 Setting Up Transport Layer Security
- 15 Getting Started with the Graph Server (PGX)
-
14
Oracle Graph Server and Client Installation
-
Part V Using the Graph Server (PGX)
-
16
Developing Applications with Graph
Analytics
- 16.1 About Vertex and Edge IDs
- 16.2 Graph Management in the Graph Server (PGX)
- 16.3 Keeping the Graph in Oracle Database Synchronized with the Graph Server
- 16.4 Optimizing Graphs for Read Versus Updates in the Graph Server (PGX)
- 16.5 Executing Built-in Algorithms
- 16.6 Using Custom PGX Graph Algorithms
- 16.7 Creating Subgraphs
- 16.8 User-Defined Functions (UDFs) in PGX
- 16.9 Using Graph Server (PGX) as a Library
-
17
Using the Machine Learning Library (PgxML) for Graphs
-
17.1
Using the DeepWalk Algorithm
- 17.1.1 Loading a Graph
- 17.1.2 Building a Minimal DeepWalk Model
- 17.1.3 Building a Customized DeepWalk Model
- 17.1.4 Training a DeepWalk Model
- 17.1.5 Getting the Loss Value For a DeepWalk Model
- 17.1.6 Computing Similar Vertices for a Given Vertex
- 17.1.7 Computing Similar Vertices for a Vertex Batch
- 17.1.8 Getting All Trained Vertex Vectors
- 17.1.9 Storing a Trained DeepWalk Model
- 17.1.10 Loading a Pre-Trained DeepWalk Model
- 17.1.11 Destroying a DeepWalk Model
-
17.2
Using the Supervised GraphWise Algorithm (Vertex Embeddings and
Classification)
- 17.2.1 Loading a Graph
- 17.2.2 Building a Minimal GraphWise Model
- 17.2.3 Advanced Hyperparameter Customization
- 17.2.4 Building a GraphWise Model Using Partitioned Graphs
- 17.2.5 Supported Property Types for Supervised GraphWise Model
- 17.2.6 Classification Versus Regression Models on Supervised GraphWise Models
- 17.2.7 Setting a Custom Loss Function and Batch Generator (for Anomaly Detection)
- 17.2.8 Training a Supervised GraphWise Model
- 17.2.9 Getting the Loss Value For a Supervised GraphWise Model
- 17.2.10 Inferring the Vertex Labels for a Supervised GraphWise Model
- 17.2.11 Evaluating the Supervised GraphWise Model Performance
- 17.2.12 Inferring Embeddings for a Supervised GraphWise Model
- 17.2.13 Storing a Trained Supervised GraphWise Model
- 17.2.14 Loading a Pre-Trained Supervised GraphWise Model
- 17.2.15 Destroying a Supervised GraphWise Model
- 17.2.16 Explaining a Prediction of a Supervised GraphWise Model
-
17.3
Using the Supervised EdgeWise
Algorithm (Edge Embeddings and Classification)
- 17.3.1 Loading a Graph
- 17.3.2 Building a Minimal Supervised EdgeWise Model
- 17.3.3 Advanced Hyperparameter Customization
- 17.3.4 Applying EdgeWise for Partitioned Graphs
- 17.3.5 Supported Property Types for Supervised EdgeWise Model
- 17.3.6 Classification Versus Regression on Supervised EdgeWise Models
- 17.3.7 Setting a Custom Loss Function and Batch Generator (for Anomaly Detection)
- 17.3.8 Setting the Edge Embedding Production Method
- 17.3.9 Training the Supervised EdgeWise Model
- 17.3.10 Getting the Loss Value for a Supervised EdgeWise Model
- 17.3.11 Inferring Edge Labels for a Supervised EdgeWise Model
- 17.3.12 Evaluating Model Performance
- 17.3.13 Inferring Embeddings for a Supervised EdgeWise Model
- 17.3.14 Storing a Supervised EdgeWise Model
- 17.3.15 Loading a Pre-Trained Supervised EdgeWise Model
- 17.3.16 Destroying a Supervised EdgeWise Model
- 17.3.17 Example: Predicting Ratings on the Movielens Dataset
-
17.4
Using the Unsupervised GraphWise
Algorithm (Vertex Embeddings)
- 17.4.1 Loading a Graph
- 17.4.2 Building a Minimal Unsupervised GraphWise Model
- 17.4.3 Advanced Hyperparameter Customization
- 17.4.4 Supported Property Types for Unsupervised GraphWise Model
- 17.4.5 Building an Unsupervised GraphWise Model Using Partitioned Graphs
- 17.4.6 Training an Unsupervised GraphWise Model
- 17.4.7 Getting the Loss Value for an Unsupervised GraphWise Model
- 17.4.8 Inferring Embeddings for an Unsupervised GraphWise Model
- 17.4.9 Storing an Unsupervised GraphWise Model
- 17.4.10 Loading a Pre-Trained Unsupervised GraphWise Model
- 17.4.11 Destroying an Unsupervised GraphWise Model
- 17.4.12 Explaining a Prediction for an Unsupervised GraphWise Model
-
17.5
Using the Unsupervised EdgeWise
Algorithm
- 17.5.1 Loading a Graph
- 17.5.2 Building a Minimal Unsupervised EdgeWise Model
- 17.5.3 Advanced Hyperparameter Customization
- 17.5.4 Supported Property Types for Unsupervised EdgeWise Model
- 17.5.5 Applying Unsupervised EdgeWise for Partitioned Graphs
- 17.5.6 Setting the Edge Combination Production Method
- 17.5.7 Training the Unsupervised EdgeWise Model
- 17.5.8 Getting the Loss Value for an Unsupervised EdgeWise Model
- 17.5.9 Inferring Embeddings for an Unsupervised EdgeWise Model
- 17.5.10 Storing an Unsupervised EdgeWise Model
- 17.5.11 Loading a Pre-Trained Unsupervised EdgeWise Model
- 17.5.12 Destroying an Unsupervised Anomaly Detection GraphWise Model
- 17.5.13 Example: Computing Edge Embeddings on the Movielens Dataset
-
17.6
Using the Unsupervised Anomaly
Detection GraphWise Algorithm (Vertex Embeddings and Anomaly Scores)
- 17.6.1 Loading a Graph
- 17.6.2 Building a Minimal Unsupervised Anomaly Detection GraphWise Model
- 17.6.3 Advanced Hyperparameter Customization
- 17.6.4 Building an Unsupervised Anomaly Detection GraphWise Model Using Partitioned Graphs
- 17.6.5 Training an Unsupervised Anomaly Detection GraphWise Model
- 17.6.6 Getting the Loss Value for an Unsupervised Anomaly Detection GraphWise Model
- 17.6.7 Inferring Embeddings for an Unsupervised Anomaly Detection GraphWise Model
- 17.6.8 Inferring Anomalies
- 17.6.9 Storing an Unsupervised Anomaly Detection GraphWise Model
- 17.6.10 Loading a Pre-Trained Unsupervised Anomaly Detection GraphWise Model
- 17.6.11 Destroying an Unsupervised Anomaly Detection GraphWise Model
-
17.7
Using the Pg2vec Algorithm
- 17.7.1 Loading a Graph
- 17.7.2 Building a Minimal Pg2vec Model
- 17.7.3 Building a Customized Pg2vec Model
- 17.7.4 Training a Pg2vec Model
- 17.7.5 Getting the Loss Value For a Pg2vec Model
- 17.7.6 Computing Similar Graphlets for a Given Graphlet
- 17.7.7 Computing Similars for a Graphlet Batch
- 17.7.8 Inferring a Graphlet Vector
- 17.7.9 Inferring Vectors for a Graphlet Batch
- 17.7.10 Storing a Trained Pg2vec Model
- 17.7.11 Loading a Pre-Trained Pg2vec Model
- 17.7.12 Destroying a Pg2vec Model
- 17.8 Model Repository and Model Stores
-
17.1
Using the DeepWalk Algorithm
-
18
Executing PGQL Queries Against the Graph
Server (PGX)
- 18.1 Getting Started with PGQL
- 18.2 Creating Property Graphs Using Options
-
18.3
Supported PGQL Features and Limitations on the
Graph Server (PGX)
- 18.3.1 Support for Selecting All Properties
- 18.3.2 Unnesting of Variable-Length Path Queries
- 18.3.3 Using INTERVAL Literals in PGQL Queries
- 18.3.4 Using Path Modes with PGQL
- 18.3.5 Support for PGQL Lateral Subqueries
- 18.3.6 Support for PGQL GRAPH_TABLE Operator
- 18.3.7 Limitations on Quantifiers
- 18.3.8 Limitations on WHERE and COST Clauses in Quantified Patterns
- 18.4 Java APIs for Executing CREATE PROPERTY GRAPH Statements
- 18.5 Python APIs for Executing CREATE PROPERTY GRAPH Statements
- 18.6 Java APIs for Executing SELECT Queries
- 18.7 Java APIs for Executing UPDATE Queries
- 18.8 PGQL Queries with Partitioned IDs
- 18.9 Security Tools for Executing PGQL Queries
- 18.10 Best Practices for Tuning PGQL Queries
- 19 REST Endpoints for the Graph Server
-
16
Developing Applications with Graph
Analytics
-
Part VI Graph Visualization Application
- 20 About the Graph Visualization Application
-
21
Using the Graph Visualization Application
- 21.1 Visualizing PGQL Queries on Graphs Loaded Into the Graph Server (PGX)
- 21.2 Visualizing PGQL Queries on PGQL Property Graphs
- 21.3 Visualizing Graph Queries on SQL Property Graphs
- 21.4 Graph Visualization Modes
- 21.5 Graph Visualization Settings
- 21.6 Using the Geographical Layout
- 21.7 Using Live Search
-
Part VII Graph Server (PGX) Advanced User
Guide
- 22 Graph Server (PGX) Configuration Options
- 23 Memory Consumption by the Graph Server (PGX)
- 24 Deploying Oracle Graph Server Behind a Load Balancer
- 25 Namespaces and Sharing
-
26
PGX Programming Guides
- 26.1 Design of the Graph Server (PGX) API
- 26.2 Data Types and Collections in the Graph Server (PGX)
- 26.3 Handling Asynchronous Requests in Graph Server (PGX)
- 26.4 Graph Client Sessions
-
26.5
Graph Mutation and Subgraphs
- 26.5.1 Altering Graphs
- 26.5.2 Simplifying and Copying Graphs
- 26.5.3 Transposing Graphs
- 26.5.4 Undirecting Graphs
- 26.5.5 Advanced Multi-Edge Handling
- 26.5.6 Creating a Subgraph
- 26.5.7 Creating a Bipartite Subgraph
- 26.5.8 Creating a Sparsified Subgraph
- 26.6 Graph Builder and Graph Change Set
- 26.7 Managing Transient Data
- 26.8 Graph Versioning
- 26.9 Labels and Properties
-
26.10
Filter Expressions
- 26.10.1 Syntax
- 26.10.2 Type System
- 26.10.3 Path Finding Filters
- 26.10.4 Subgraph Filters
-
26.10.5
Operations on Filter Expressions
- 26.10.5.1 Defining Filter Expressions
- 26.10.5.2 Defining Result Set Filters
- 26.10.5.3 Creating a Subgraph from PGQL Result Set
- 26.10.5.4 Defining Collection Filters
- 26.10.5.5 Creating a Subgraph from Collection Filters
- 26.10.5.6 Combining Filter Expressions
- 26.10.5.7 Creating a Subgraph Using Filter Expressions with Partitioned IDs
- 26.11 Advanced Task Scheduling Using Execution Environments
- 26.12 Admin API
-
26.13
PgxFrames Tabular Data-Structure
- 26.13.1 Converting PgqlResultSet to a PgxFrame
- 26.13.2 Storing a PgxFrame to a Database
- 26.13.3 Storing a PgxFrame to a CSV File
- 26.13.4 Union of PGX Frames
- 26.13.5 Joining PGX Frames
- 26.13.6 Printing the Content of a PgxFrame
- 26.13.7 Destroying a PgxFrame
- 26.13.8 Loading and Storing Vector Properties
- 26.13.9 Flattening Vector Properties
- 26.13.10 PgxFrame Helpers
- 26.13.11 Converting a PgxFrame to PgqlResultSet
- 26.13.12 PgxFrame to Pandas DataFrame Conversions
- 26.13.13 Loading a PgxFrame from a Database
- 26.13.14 Loading a PgxFrame from a CSV File
- 26.13.15 Loading a PgxFrame from Client-Side Data
- 26.13.16 Creating a Graph from Multiple PgxFrame Objects
-
27
Working with Files Using the Graph Server (PGX)
- 27.1 Loading Graph Data from Files
- 27.2 Loading Graph Data in Parallel from Multiple Files
- 27.3 Exporting Graphs Into a File
- 27.4 Exporting a Graph into Multiple Files
- 28 Log Management in the Graph Server (PGX)
-
Supplementary Information for Property Graph Support
-
A
Using the Property Graph Schema
- A.1 Property Graph Schema Objects for Oracle Database
- A.2 Data Access Layer
- A.3 Getting Started with Property Graphs
-
A.4
Using Java APIs for Property Graph Data
- A.4.1 Overview of the Java APIs
- A.4.2 Parallel Retrieval of Graph Data
- A.4.3 Using an Element Filter Callback for Subgraph Extraction
- A.4.4 Using Optimization Flags on Reads over Property Graph Data
- A.4.5 Adding and Removing Attributes of a Property Graph Subgraph
- A.4.6 Getting Property Graph Metadata
- A.4.7 Merging New Data into an Existing Property Graph
- A.4.8 Opening and Closing a Property Graph Instance
- A.4.9 Creating Vertices
- A.4.10 Creating Edges
- A.4.11 Deleting Vertices and Edges
- A.4.12 Reading a Graph from a Database into an Embedded Graph Server (PGX)
- A.4.13 Specifying Labels for Vertices
- A.4.14 Building an In-Memory Graph
- A.4.15 Dropping a Property Graph
- A.4.16 Executing PGQL Queries
- A.5 Access Control for Property Graph Data (Graph-Level and OLS)
- A.6 SQL-Based Property Graph Query and Analytics
- A.7 Creating Property Graph Views on an RDF Graph
-
A.8
Using Automatic Delta Refresh to Handle Database Changes
- A.8.1 Configuring the Graph Server (PGX) for Auto-Refresh
- A.8.2 Configuring Basic Auto-Refresh
- A.8.3 Reading the Graph Using the Graph Server (PGX) or a Java Application
- A.8.4 Checking Out a Specific Snapshot of the Graph
- A.8.5 Advanced Auto-Refresh Configuration
- A.8.6 Special Considerations When Using Auto-Refresh
- A.9 API for Loading Graphs into Memory
- A.10 Quick Start: Interactively Analyze Graph Data Stored in Property Graph Schema Objects
- A.11 Working with Property Graph Objects in SQL Developer
-
A.12
Executing PGQL Queries Against Property Graph
Schema Tables
- A.12.1 PGQL Features Supported in Property Graph Schema
- A.12.2 Creating Property Graphs through CREATE PROPERTY GRAPH Statements
- A.12.3 Dropping Property Graphs through DROP PROPERTY GRAPH Statements
-
A.12.4
Using the oracle.pg.rdbms.pgql Java Package to Execute PGQL Queries
- A.12.4.1 Basic Query Execution
- A.12.4.2 Executing PGQL Queries Using JDBC Driver
- A.12.4.3 Security Techniques for PGQL Queries
- A.12.4.4 Using a Text Index with PGQL Queries
- A.12.4.5 Obtaining the SQL Translation for a PGQL Query
- A.12.4.6 Additional Options for PGQL Translation and Execution
- A.12.4.7 Querying Another User’s Property Graph
- A.12.4.8 Using Query Optimizer Hints with PGQL
- A.12.4.9 Modifying Property Graphs through INSERT, UPDATE, and DELETE Statements
- A.12.5 Using the Python Client to Execute PGQL Queries
- A.12.6 Performance Considerations for PGQL Queries
-
A.13
OPG_APIS Package Subprograms
- A.13.1 OPG_APIS.ANALYZE_PG
- A.13.2 OPG_APIS.CF
- A.13.3 OPG_APIS.CF_CLEANUP
- A.13.4 OPG_APIS.CF_PREP
- A.13.5 OPG_APIS.CLEAR_PG
- A.13.6 OPG_APIS.CLEAR_PG_INDICES
- A.13.7 OPG_APIS.CLONE_GRAPH
- A.13.8 OPG_APIS.COUNT_TRIANGLE
- A.13.9 OPG_APIS.COUNT_TRIANGLE_CLEANUP
- A.13.10 OPG_APIS.COUNT_TRIANGLE_PREP
- A.13.11 OPG_APIS.COUNT_TRIANGLE_RENUM
- A.13.12 OPG_APIS.CREATE_EDGES_TEXT_IDX
- A.13.13 OPG_APIS.CREATE_PG
- A.13.14 OPG_APIS.CREATE_PG_SNAPSHOT_TAB
- A.13.15 OPG_APIS.CREATE_PG_TEXTIDX_TAB
- A.13.16 OPG_APIS.CREATE_STAT_TABLE
- A.13.17 OPG_APIS.CREATE_SUB_GRAPH
- A.13.18 OPG_APIS.CREATE_VERTICES_TEXT_IDX
- A.13.19 OPG_APIS.DROP_EDGES_TEXT_IDX
- A.13.20 OPG_APIS.DROP_PG
- A.13.21 OPG_APIS.DROP_PG_VIEW
- A.13.22 OPG_APIS.DROP_VERTICES_TEXT_IDX
- A.13.23 OPG_APIS.ESTIMATE_TRIANGLE_RENUM
- A.13.24 OPG_APIS.EXP_EDGE_TAB_STATS
- A.13.25 OPG_APIS.EXP_VERTEX_TAB_STATS
- A.13.26 OPG_APIS.FIND_CC_MAPPING_BASED
- A.13.27 OPG_APIS.FIND_CLUSTERS_CLEANUP
- A.13.28 OPG_APIS.FIND_CLUSTERS_PREP
- A.13.29 OPG_APIS.FIND_SP
- A.13.30 OPG_APIS.FIND_SP_CLEANUP
- A.13.31 OPG_APIS.FIND_SP_PREP
- A.13.32 OPG_APIS.GET_BUILD_ID
- A.13.33 OPG_APIS.GET_GEOMETRY_FROM_V_COL
- A.13.34 OPG_APIS.GET_GEOMETRY_FROM_V_T_COLS
- A.13.35 OPG_APIS.GET_LATLONG_FROM_V_COL
- A.13.36 OPG_APIS.GET_LATLONG_FROM_V_T_COLS
- A.13.37 OPG_APIS.GET_LONG_LAT_GEOMETRY
- A.13.38 OPG_APIS.GET_LONGLAT_FROM_V_T_COLS
- A.13.39 OPG_APIS.GET_OPG_VERSION
- A.13.40 OPG_APIS.GET_SCN
- A.13.41 OPG_APIS.GET_VERSION
- A.13.42 OPG_APIS.GET_WKTGEOMETRY_FROM_V_COL
- A.13.43 OPG_APIS.GET_WKTGEOMETRY_FROM_V_T_COLS
- A.13.44 OPG_APIS.GRANT_ACCESS
- A.13.45 OPG_APIS.IMP_EDGE_TAB_STATS
- A.13.46 OPG_APIS.IMP_VERTEX_TAB_STATS
- A.13.47 OPG_APIS.PR
- A.13.48 OPG_APIS.PR_CLEANUP
- A.13.49 OPG_APIS.PR_PREP
- A.13.50 OPG_APIS.PREPARE_TEXT_INDEX
- A.13.51 OPG_APIS.RENAME_PG
- A.13.52 OPG_APIS.SPARSIFY_GRAPH
- A.13.53 OPG_APIS.SPARSIFY_GRAPH_CLEANUP
- A.13.54 OPG_APIS.SPARSIFY_GRAPH_PREP
- A.14 OPG_GRAPHOP Package Subprograms
- B Mapping Graph Server Roles to Default Privileges
- C Disabling Transport Layer Security (TLS) in Graph Server
- D Migrating Property Graph Applications from Before Release 21c
- E Upgrading From Graph Server and Client 20.4.x to 21.x
- F Third-Party License Information for Oracle Graph Server and Client
-
A
Using the Property Graph Schema
- Index