com.esri.arcgis.geodatabase
Class IDatasetMigrationProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.IDatasetMigrationProxy
All Implemented Interfaces:
IDatasetMigration, Externalizable, Serializable

public class IDatasetMigrationProxy
extends com.esri.arcgis.interop.Dispatch
implements IDatasetMigration, Serializable

Provides access to members that migrate a dataset.

Description

The IDatasetMigration interface has methods for migrating the geometry, attribute and raster binary storage types of a dataset from an SDE data source. The migration path is based on parameters of the specified keyword.

Remarks

An exclusive schema lock should be acquired for the dataset prior to calling any of this interface's methods. An exclusive schema lock can be acquired by using the ISchemaLock interface.

The IFeatureClassStorage interface can be used with an SDE feature class to determine the type of geometry storage being used. If the geometry is migrated to a new storage type, the feature class must be re-opened for the IFeatureClassStorage to return the new value.

Consult the topic "Data migration from one storage type to another" in the ArcGIS Help system prior to migration. There are special cases to be aware of; for example, migrating from SDEBINARY to GEOGRAPHY with SQL Server is not recommended for feature classes with Z or M values.

Valid geometry migration paths for SDE/Oracle are:
Long Raw to Blob (SDEBINARY to SDELOB)
Long Raw to ST_Geometry (SDEBINARY to ST_GEOMETRY)
Blob to ST_Geometry (SDELOB to ST_GEOMETRY)
SDO_Geometry to ST_Geometry (SDO_GEOMETRY to ST_GEOMETRY)

Valid geometry migration paths for SDE/SQL Server are:
SDEBINARY to GEOMETRY
SDEBINARY to GEOGRAPHY
OGCWKB to GEOMETRY
OGCWKB to GEOGRAPHY

Valid attribute migration paths for SDE/Oracle are:
Long Raw to Blob

Valid raster migration paths for SDE/Oracle are:
Long Raw to Blob
Long Raw to ST_Raster
Blob to ST_Raster

Valid raster migration paths for SDE/PostgreSQL are:
Binary to ST_Raster

Valid raster migration paths for SDE/SQL Server are:
Binary to ST_Raster

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

See Also:
Serialized Form

Field Summary
 boolean noncastable
           
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef
 
Constructor Summary
  IDatasetMigrationProxy()
           
  IDatasetMigrationProxy(Object obj)
           
protected IDatasetMigrationProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void migrateAttributeStorage(String configurationKeyword)
          Migrate the attribute field storage.
 void migrateGeometryStorage(String configurationKeyword)
          Migrate the geometry field storage.
 void migrateRasterStorage(String configurationKeyword)
          Migrate the raster storage.
 void migrateStorage(String configurationKeyword)
          Migrate all binary field storage.
 void removeListener(String iidStr, Object theListener)
           
 
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

noncastable

public boolean noncastable
Constructor Detail

IDatasetMigrationProxy

public IDatasetMigrationProxy()

IDatasetMigrationProxy

public IDatasetMigrationProxy(Object obj)
                       throws IOException
Throws:
IOException

IDatasetMigrationProxy

protected IDatasetMigrationProxy(Object obj,
                                 String iid)
                          throws IOException
Throws:
IOException
Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
Overrides:
addListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

migrateStorage

public void migrateStorage(String configurationKeyword)
                    throws IOException,
                           AutomationException
Migrate all binary field storage.

Remarks

The MigrateStorage method will migrate all geometry, attribute and raster binaries to the parameters specified in the ConfigurationKeyword argument.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:
migrateStorage in interface IDatasetMigration
Parameters:
configurationKeyword - The configurationKeyword (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

migrateGeometryStorage

public void migrateGeometryStorage(String configurationKeyword)
                            throws IOException,
                                   AutomationException
Migrate the geometry field storage.

Remarks

The MigrateGeometryStorage method will migrate all geometry storage to the parameters specified in the ConfigurationKeyword argument.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:
migrateGeometryStorage in interface IDatasetMigration
Parameters:
configurationKeyword - The configurationKeyword (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

migrateAttributeStorage

public void migrateAttributeStorage(String configurationKeyword)
                             throws IOException,
                                    AutomationException
Migrate the attribute field storage.

Remarks

The MigrateAttributeStorage method will migrate all attribute binary storage to the parameters specified in the ConfigurationKeyword argument.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:
migrateAttributeStorage in interface IDatasetMigration
Parameters:
configurationKeyword - The configurationKeyword (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

migrateRasterStorage

public void migrateRasterStorage(String configurationKeyword)
                          throws IOException,
                                 AutomationException
Migrate the raster storage.

Remarks

The MigrateRasterStorage method will migrate all raster storage to the parameters specified in the ConfigurationKeyword argument.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:
migrateRasterStorage in interface IDatasetMigration
Parameters:
configurationKeyword - The configurationKeyword (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.