oracle.dmt.odm.task
Class ModelImportTask

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

All Implemented Interfaces:

java.io.Serializable

public class ModelImportTask

extends MiningTask

An instance of ModelImportTask is used to import standard format mining models to the database. ODM supports importing models in the PMML2.0 standard format.

ODM supports importing the following models:

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

This class supports importing a mining model from 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 from which the model needs to be imported.

Import fails if the table cell location is not valid or model is not supported for import.

Since:

ODM 9.2.0

See Also:

Serialized Form

Constructor Summary

ModelImportTask(java.lang.String outputModelName, LocationCellAccessData importModelLocation, MiningStandardType miningStandardType)
Creates a ModelImportTask object given the MiningStandard 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	getImportModelLocation() Returns the import location cell of the mining model.
MiningStandardType	getMiningStandardType() Returns the import model mining standard type.
java.lang.String	getOutputModelName() Returns the output model name of the import mining task.
static ModelImportTask	restore(Connection dmsConn, java.lang.String taskName) Restores the user-specified mining import task object from the DMS.

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

ModelImportTask

public ModelImportTask(java.lang.String outputModelName,
LocationCellAccessData importModelLocation,
MiningStandardType miningStandardType)
                throws InvalidArgumentException,
ODMException

Creates a ModelImportTask object given the MiningStandard 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:

importModelLocation - Location of the import model table cell

outputModelName - Name of the output mining model

miningStandardType - Import model's mining standard type. ODM supports PMML2.0 standard

Throws:

InvalidArgumentException - is thrown
- when the outputModelName/importModelLocation/miningStandardType are null
- when the outputModelName length >25 bytes

InvalidArgumentException

ODMException

Method Detail

getImportModelLocation

public LocationCellAccessData getImportModelLocation()

Returns the import location cell of the mining model.

getMiningStandardType

public MiningStandardType getMiningStandardType()

Returns the import model mining standard type.

getOutputModelName

public java.lang.String getOutputModelName()

Returns the output model name of the import mining task.

restore

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

Restores the user-specified mining import task object from the DMS.

Parameters:

dmsConn - Data mining server connection>

taskName - Name of the model import task.

Returns:

restored ModelImportTask.

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