describes a wizard which can be used to copy table like data from one
database to another.
Copying table data between databases can be a complex task. Especially when
it comes to matching field types in the source and in the target database,
some heuristics, and sometimes support from the user doing the operation,
are required.
The copy table wizard described by this interfaces cares for those,
and other, settings.
At initialization time, you can use this attribute to control the
initial operation in the wizard.
After the wizard has finished, you can use this attribute to determine
what operation was actually executed.
Changing this attribute while the dialog is running is not supported, the
result of such an attempt is undefined.
Throws
IllegalArgumentException
if you attempt to set an invalid operation, or if the given operation is
not supported by the target database type, e.g. if you specified
CopyTableOperation::CreateAsView where the database
does not support views.
specfies the name of the table in the destination database.
At initialization time, you can use this attribute to control the
initial table name as suggested to the user.
After the wizard has finished, you can use this attribute to determine
what table was actually created resp. to which existing table the source
table's data was appended.
Changing this attribute while the dialog is running is not supported, the
result of such an attempt is undefined.
specifies that a new primary key is to be created in the target database
At initialization time, you can specify the initial settings for the primary
key in the UI.
You cannot use this attribute to determine the primary key, possibly created
by the wizard, after it finished. The reason is that during the wizard run, the
user can define an arbitrarily complex primary key, e.g. including multiple columns,
which cannot be represented in this simple attribute anymore.
specifies that the first row should be used to identify column names.
This attribute is ignored when the source defines the column names which isn't the case when only a part of a table should be copied
e.g. in the RTF format or in the HTML format.