com.esri.arcgis.geodatabase
Interface IDatasetMigration

All Superinterfaces:
Serializable
All Known Implementing Classes:
IDatasetMigrationProxy

public interface IDatasetMigration
extends Serializable

Provides access to members that migrate a dataset.

Description

This interface is new at ArcGIS 9.3.

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

Valid geometry migration paths are as follows:

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 attribute and raster migration paths are as follows:

Long Raw to Blob

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.

Product Availability

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


Method Summary
 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.
 

Method Detail

migrateStorage

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.

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

migrateGeometryStorage

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.

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

migrateAttributeStorage

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.

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

migrateRasterStorage

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.

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