oracle.dmt.odm.task
Class ModelExportTask

java.lang.Object
  |
  +--oracle.dmt.odm.MiningObject
        |
        +--oracle.dmt.odm.LocatableObject
              |
              +--oracle.dmt.odm.task.MiningTask
                    |
                    +--oracle.dmt.odm.task.ModelExportTask

All Implemented Interfaces:

java.io.Serializable

public class ModelExportTask

extends MiningTask

An instance of ModelExportTask is used to export ODM mining models to standard format mining model representations. ODM supports exporting model built in the DMS, to the industry standard PMML2.0 standard.

ODM supports exporting the following models:

• Association Rule Model
• Classification Model built using the Naive Bayes Algorithm

This class supports the exporting of a mining model to an XMLType table cell. Oracle database supports an SYS.XMLType datatype to store XML documents inside the database. LocationCellAccessData provides the location of the XMLType table cell to which model(s) needs to be exported.

Export fails if the specified model is not present in the DMS or table cell location is not valid or model is not supported for export.

Since:

ODM 9.2.0

See Also:

Serialized Form

Constructor Summary

ModelExportTask(java.lang.String inputModelName, LocationCellAccessData exportModelLocation, MiningStandardType miningStandardType)
Creates a ModelExportTask object given the MiningStandardType and the location of the cell (that is, row-column intersection) identified by the column name and rowid for a given schema and table name.

Method Summary

LocationCellAccessData	getExportModelLocation() Returns the export location cell of the mining model.
java.lang.String	getInputModelName() Returns the input model name of the export mining task.
MiningStandardType	getMiningStandardType() Returns the export model mining standard type.
static ModelExportTask	restore(Connection dmsConn, java.lang.String taskName) Restores the user-specified mining export task object from the database.

Methods inherited from class oracle.dmt.odm.task.MiningTask

execute, getActiveExecutionHandle, getCurrentStatus, getExecutionDuration, getExecutionHandle, getLatestExecutionHandle, getName, getStatusHistory, getTaskType, getType, listTasks, remove, rename, store, terminate, waitForCompletion, waitForCompletion

Methods inherited from class java.lang.Object

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

Constructor Detail

ModelExportTask

public ModelExportTask(java.lang.String inputModelName,
LocationCellAccessData exportModelLocation,
MiningStandardType miningStandardType)
                throws InvalidArgumentException,
ODMException

Creates a ModelExportTask object given the MiningStandardType and the location of the cell (that is, row-column intersection) identified by the column name and rowid for a given schema and table name.

Parameters:

inputModelName - Name of the input mining model in the DMS, which must be exported to the specified location

exportModelLocation - Location of the exported models table cell

Throws:

InvalidArgumentException - is thrown
- when the inputModelName/exportModelLocation/miningStandardType are null
- when the inputModelName length >25 bytes

InvalidArgumentException

ODMException

Method Detail

getExportModelLocation

public LocationCellAccessData getExportModelLocation()

Returns the export location cell of the mining model.

getMiningStandardType

public MiningStandardType getMiningStandardType()

Returns the export model mining standard type. ODM supports the PMML 2.0 standard.

getInputModelName

public java.lang.String getInputModelName()

Returns the input model name of the export mining task.

restore

public static ModelExportTask restore(Connection dmsConn,
                                      java.lang.String taskName)
                                                   throws InvalidArgumentException,
MiningTaskException,
                                                          java.sql.SQLException,
ODMException

Restores the user-specified mining export task object from the database.

Parameters:

dmsConn - Data mining server connection.

taskName - Name of the export task.

Returns:

restored ModelExportTask.

Throws:

InvalidArgumentException - is thrown
- when the dmsConn/taskName are null
- when the taskName length >64 characters

MiningTaskException - is thrown
- when the restore fails

SQLException - is thrown
- when there is a failure in JDBC calls

InvalidArgumentException

MiningTaskException

java.sql.SQLException

ODMException