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

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.

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.