New Features

Significant New Features in Oracle Graph Server and Client 21.4

• Enhanced support for GraphAlterationBuilder API to add empty vertex or edge providers that are not linked to any datasource.

  See Adding Additional Empty Vertex or Edge Providers for more details.

• Added Oracle functions and user defined functions (UDFs) support in PGQL queries for property graph views.

  See PGQL Features Supported in Property Graph Views for more information.

• Enhanced user friendly error reporting based on graph metadata by the PGQL parser when validating PGQL queries executed against the graph server (PGX).
• Added GNNExplainer support to leverage Graph ML explainability for Unsupervised GraphWise models in PgxML Library.

  See Explaining a Prediction for an Unsupervised GraphWise Model for more information.

• Added support for custom loss functions and batch generators for anomaly detection with Supervised GraphWise models.

  See Setting a Custom Loss Function and Batch Generator (for Anomaly Detection) for more information.

Migrating Property Graph Applications to Oracle Database 21c

From Release 21c onwards, Oracle Graph Server and Client must be installed separately. It is recommended to remove the older property graph libraries from $ORACLE_HOME. See Uninstalling Previous Versions of Property Graph Libraries for more details.

Deprecated Features

• PL/SQL API OPG_APIS.GET_SCN Function
  The PL/SQL API OPG_APIS.GET_SCN function is deprecated. Instead, to retrieve the current SCN (system change number), use the DBMS_FLASHBACK.GET_SYSTEM_CHANGE_NUMBER function:

  SELECT dbms_flashback.get_system_change_number FROM DUAL;

• OraclePgqlResultSet

  The oracle.pg.rdbms.OraclePgqlResultSet interface was deprecated in 19c and will be removed in a future release. Instead, use the standardized interface oracle.pgql.lang.ResultSet to retrieve values from a PGQL result set.

Desupported Features

• The following Java API methods, objects and fields in oracle.pgx.api are no longer supported:

  Desupported Methods:

  • PgxCollection methods:
    • addAllAsync(Collection<E> source)
    • removeAllAsync(Collection<E> source)
    • addAll(ID...ids)
    • removeAll(ID...ids)
  • PgqlResultSet methods:
    • getResults(): instead, use PgqlResultSet to directly iterate the result set
    • destroy()
  • User-defined pattern matching semantic methods:
    • PgxGraph#queryPgql(String, PatternMatchingSemantic): instead, use PgxGraph#queryPgql(String)
    • PgxSession.setPatternMatchingSemantic(..)
  • GraphMetaData constructors and related methods:
    • GraphMetaData()
    • GraphMetaData(GraphMetaData other, java.net.URI baseUri)
    • GraphMetaData(IdType vertexIdType)
    • GraphMetaData.setVertexIdType()
    • GraphMetaData.setEdgeIdType()
  • PgxSession#getAvailableSnapshots(GraphConfig): instead, use PgxSession#getAvailableSnapshots(PgxGraph)
  • All Analyst#filteredBfs and Analyst#filteredDfs methods that accepts filter parameter: instead, use the navigator parameter

  Desupported Objects

  • PgqlResult(a result of resultSet.getResults().iterator().next(): instead, use PgxResult as returned from resultSet.iterator().next()

  Desupported Fields

  • pattern_matching_semantic configuration field
• The Java API method AbstractGraphConfigBuilder#setNodeIdType in oracle.pgx.config is desupported. Instead, use AbstractGraphConfigBuilder#setVertexIdType().
• The following PyPGX classes are desupported in pypgx package. Instead, use pypgx.api.filters subpackage to access these classes:
  • EdgeFilter
  • GraphFilter
  • VertexFilter

• The following PyPGX classes are desupported in pypgx.api package. Instead, use pypgx.api.frames subpackage to access these classes:

  • PgxCsvFrameReader
  • PgxCsvFrameStorer
  • PgxDbFrameReader
  • PgxDbFrameStorer
  • PgxFrame
  • PgxFrameBuilder
  • PgxFrameColumn
  • PgxGenericFrameReader
  • PgxGenericFrameStorer
  • PgxPgbFrameReader
  • PgxPgbFrameStorer
• The following Python API packages are no longer supported:
  • common: This internal package is desupported. Few of the classes from this package are moved to the public package pypgx.api.
  • utils: This internal package is renamed to _utils.
• Graph property text search based on Apache Solr/Lucene is desupported. Instead, use Oracle Text or PGQL query expressions.
• The PGX property type DATE is desupported. Instead, use LOCAL_DATE or TIMESTAMP.
• Property Graph support for data stored in Oracle NoSQL Database is desupported.
• The two-table format is desupported.
• The Gremlin Groovy shell is desupported.
• Apache Tinkerpop API support for Oracle Database is desupported.
• Loading data from flat file formats into the property graph schema is desupported.
• Apache Groovy-based shell was deprecated in 19c and is now desupported.
• Apache HBASE and Apache HDFS on Cloudera CDH5 is desupported.