oracle.pg.nosql

Class OraclePropertyGraphUtils

java.lang.Object

oracle.pg.common.OraclePropertyGraphUtilsBase

oracle.pg.nosql.OraclePropertyGraphUtils

All Implemented Interfaces:

MesgConsts

public class OraclePropertyGraphUtils
extends OraclePropertyGraphUtilsBase

This class contains utility functions to help manage property graphs stored in an Oracle NoSQL Database.

Field Summary

Fields inherited from interface oracle.pg.common.MesgConsts

ERR_ARG_CANNOT_BE_NULL, ERR_CODE_NOT_IN_LIST, ERR_DOP_CONSTRAINT, ERR_E_AUTO_IDX_MUST_SOLR_OR_LUCENE, ERR_E_AUTO_IDX_NOT_EXIST, ERR_E_DS_MUSTBE_FILE_OR_IS, ERR_E_MAX_LINE_CONSTRAINT, ERR_EDGE_DIR_NOT_BOTH, ERR_EDGE_WORK_TBL_NOT_CLEAN, ERR_GRAPH_NAME_CANT_BENULL, ERR_HIT_EXCEPTION, ERR_HIT_INTERRUPT, ERR_HIT_IO, ERR_HIT_OPGE, ERR_HIT_PARSEE, ERR_ID_CANNOT_BE_NULL, ERR_IDX_KEY_CANNOT_BE_NULL, ERR_IDX_KEY_NOT_NULL, ERR_IDX_KEYS_NOT_NULL, ERR_IN_DS_EDGE_CANTBE_NULL, ERR_IN_DS_VERT_CANTBE_NULL, ERR_IN_E_FLAT_DOESNT_EXIST, ERR_IN_V_FLAT_DOESNT_EXIST, ERR_INPUT_LIST_NOT_NULL, ERR_INPUT_NOT_NULL, ERR_INVALID_CHANGE_ACTION, ERR_INVALID_NUM_FIELDS, ERR_INVALID_NUM_NOARG, ERR_INVALID_NUMBER, ERR_INVALID_VAL, ERR_KEY_CANNOT_BE_ID, ERR_KEY_CANNOT_BE_NULL, ERR_KEY_CANNOT_BE_NULL_EMPTY, ERR_KEY_NOT_SET_TO, ERR_NO_ELEM_TO_BE_CONSUMED, ERR_NO_OP_SUPPORTED, ERR_NOT_IMPLEMENTED_YET, ERR_NOT_ORACLE_V_E, ERR_NUM_PART_CONSTRAINT, ERR_OFFSET_CONSTRAINT, ERR_OFFSET_E_MUST_BE_POS, ERR_OFFSET_V_MUST_BE_POS, ERR_OPT_FLAG_EDGE_INVALID, ERR_OPT_FLAG_VERT_INVALID, ERR_ORA_TEXT_INVALID_KEY, ERR_ORA_TEXT_ONLY_AUTO, ERR_OUTPUT_LIST_NOT_NULL, ERR_PG_ALREADY_EXISTS, ERR_PG_NOT_EMPTY, ERR_PG_NOT_NULL, ERR_SIZE_MUST_BE_POS, ERR_TIMEOUT_TAB_CREATION, ERR_TXT_IDX_NOT_FOUND, ERR_TYPE_ID_NOT_RECO, ERR_UNSUPPORTED_VAL_TYP, ERR_USER_REQ_OP_CANCEL, ERR_V_AUTO_IDX_MUST_SOLR_OR_LUCENE, ERR_V_AUTO_IDX_NOT_EXIST, ERR_V_DS_MUSTBE_FILE_OR_IS, ERR_V_MAX_LINE_CONSTRAINT, ERR_VALUE_CANNOT_BE_NULL, INFO_EMP_K_NO_P_VAL, INFO_NUL_K_NO_P_VAL

Constructor Summary

Constructors

Constructor and Description
OraclePropertyGraphUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static void	dropPropertyGraph(oracle.kv.KVStoreConfig kvStoreConfig, String szGraphName) Drops the specified property graph (including its associated tables).
static void	dropPropertyGraph(oracle.kv.KVStoreConfig kvStoreConfig, String szGraphName, String username, String password) Drops the specified property graph (including its associated tables).
static void	dropPropertyGraph(OraclePropertyGraph opg) Drops the specified property graph (including its associated tables).
static void	exportFlatFiles(OraclePropertyGraph pg, OutputStream osVertex, OutputStream osEdge, int dop, boolean append) This function exports a given property graph into two flat files: one for vertices and the other for edges.
static void	exportFlatFiles(OraclePropertyGraph pg, String vertexFileName, String edgeFileName, boolean append) This function exports a given property graph into two flat files: one for vertices and the other for edges.
static void	exportFlatFiles(OraclePropertyGraph pg, String vertexFileName, String edgeFileName, int dop, boolean append) This function exports a given property graph into two flat files: one for vertices and the other for edges.
static List<String>	getGraphNames(oracle.kv.KVStoreConfig kvsc) List all the names of the property graphs stored in the given database
static void	quietlyCloseConnections(oracle.kv.KVStoreConfig[] connections) Quietly closes an array KVStoreConfig objects storing all the configurations used to connect to an Oracle NoSQL Database
static void	quietlyCloseKVStore(OraclePropertyGraph opg) Quietly close the KVStore object handling a connection to an Oracle NoSQL Database associated to the given property graph

Methods inherited from class oracle.pg.common.OraclePropertyGraphUtilsBase

compareFiles, convertCSV2OPE, convertCSV2OPE, convertCSV2OPE, convertCSV2OPE, convertCSV2OPE, convertCSV2OPE, convertCSV2OPV, convertCSV2OPV, convertCSV2OPV, convertCSV2OPV, convertRDBMSTable2OPE, convertRDBMSTable2OPE, convertRDBMSTable2OPV, escape, exportEdges, exportFlatFiles, exportFlatFiles, exportFlatFiles, exportGML, exportGML, exportGraphML, exportGraphML, exportGraphSON, exportGraphSON, exportVertices, handleGZipInputStream, importGML, importGML, importGraphML, importGraphML, importGraphSON, importGraphSON, listify, quietlyClose, quietlyClose, quietlyClose, quietlyCloseResultSet, quietlyCloseResultSetAndStmt, quietlyCloseResultSetAndStmt, quietlyCloseStmt, quietlyShutdown, size, unescape, writeValue

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OraclePropertyGraphUtils

public OraclePropertyGraphUtils()

Method Detail

dropPropertyGraph

public static void dropPropertyGraph(oracle.kv.KVStoreConfig kvStoreConfig,
                     String szGraphName)
                              throws IOException,
                                     Exception

Drops the specified property graph (including its associated tables). This operation cannot be undone.

Parameters:

kvStoreConfig - configuration for Oracle NoSQL Database

szGraphName - name of the property graph.

Throws:

IOException

Exception

dropPropertyGraph

public static void dropPropertyGraph(oracle.kv.KVStoreConfig kvStoreConfig,
                     String szGraphName,
                     String username,
                     String password)
                              throws IOException,
                                     Exception

Drops the specified property graph (including its associated tables). This operation cannot be undone.

Parameters:

kvStoreConfig - configuration for Oracle NoSQL Database

szGraphName - name of the property graph.

username - name of the user

password - password of the user

Throws:

IOException

Exception

dropPropertyGraph

public static void dropPropertyGraph(OraclePropertyGraph opg)
                              throws IOException,
                                     Exception

Drops the specified property graph (including its associated tables). This operation cannot be undone.

Parameters:

opg - an instance of OraclePropertyGraph

Throws:

IOException

Exception

exportFlatFiles

public static void exportFlatFiles(OraclePropertyGraph pg,
                   OutputStream osVertex,
                   OutputStream osEdge,
                   int dop,
                   boolean append)
                            throws IOException,
                                   FileNotFoundException,
                                   InterruptedException

This function exports a given property graph into two flat files: one for vertices and the other for edges.

Parameters:

pg - the property graph that will be exported into flat files

osVertex - an OutputStream object for the vertex flat file

osEdge - an OutputStream object for the edge flat file

dop - the degree of parallelism used when writing the data into the flat files. This will use multiple threads to optimize writing performance.

append - if false, overwrite the existing flat files removing all existing data.

Throws:

IOException

FileNotFoundException

InterruptedException

exportFlatFiles

public static final void exportFlatFiles(OraclePropertyGraph pg,
                   String vertexFileName,
                   String edgeFileName,
                   boolean append)
                                  throws IOException,
                                         FileNotFoundException,
                                         InterruptedException

This function exports a given property graph into two flat files: one for vertices and the other for edges.

Parameters:

pg - the property graph that will be exported into flat files

vertexFileName - the name of the vertex flat file e.g. graph.opv

edgeFileName - the name of the edge flat file e.g. graph.ope

append - if false, overwrite the existing flat files removing all existing data.

Throws:

InterruptedException

IOException

FileNotFoundException

exportFlatFiles

public static final void exportFlatFiles(OraclePropertyGraph pg,
                   String vertexFileName,
                   String edgeFileName,
                   int dop,
                   boolean append)
                                  throws IOException,
                                         FileNotFoundException,
                                         InterruptedException

This function exports a given property graph into two flat files: one for vertices and the other for edges.

Parameters:

pg - the property graph that will be exported into flat files

vertexFileName - the name of the vertex flat file e.g. graph.opv

edgeFileName - the name of the edge flat file e.g. graph.ope

dop - the degree of parallelism used when writing the data into the flat files. This will use multiple threads to optimize writing performance.

append - if false, overwrite the existing flat files removing all existing data.

Throws:

InterruptedException

IOException

FileNotFoundException

getGraphNames

public static List<String> getGraphNames(oracle.kv.KVStoreConfig kvsc)
                                  throws OraclePropertyGraphException

List all the names of the property graphs stored in the given database

Parameters:

kvsc - a KVStoreConfig object

Returns:

a list of Strings with the names of the property graphs in the database.

Throws:

OraclePropertyGraphException

quietlyCloseConnections

public static void quietlyCloseConnections(oracle.kv.KVStoreConfig[] connections)

Quietly closes an array KVStoreConfig objects storing all the configurations used to connect to an Oracle NoSQL Database

Parameters:

connections - an array of KVStoreConfig objects.

quietlyCloseKVStore

public static void quietlyCloseKVStore(OraclePropertyGraph opg)

Quietly close the KVStore object handling a connection to an Oracle NoSQL Database associated to the given property graph

Parameters:

opg - an OraclePropertyGraph object.