diff --git a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx index 40fa733d998..648f1cea3d4 100644 --- a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx +++ b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx @@ -9,8 +9,8 @@ title: "Supported platforms and databases" You can use the following database product versions with Migration Toolkit: -- PostgreSQL versions 12, 13, 14, 15, and 16 -- EDB Postgres Advanced Server versions 12, 13, 14, 15, and 16 +- PostgreSQL versions 13, 14, 15, 16, and 17 +- EDB Postgres Advanced Server versions 13, 14, 15, 16, and 17 - Oracle 11g - Oracle 12c - Oracle 18c diff --git a/product_docs/docs/migration_toolkit/55/07_invoking_mtk/08_mtk_command_options.mdx b/product_docs/docs/migration_toolkit/55/07_invoking_mtk/08_mtk_command_options.mdx index 22d8eea9795..b1e1ae155be 100644 --- a/product_docs/docs/migration_toolkit/55/07_invoking_mtk/08_mtk_command_options.mdx +++ b/product_docs/docs/migration_toolkit/55/07_invoking_mtk/08_mtk_command_options.mdx @@ -23,7 +23,7 @@ The command options that work with Migration Toolkit are grouped by their behavi | [Import options](#import-options) | -sourcedbtype, -targetdbtype, -schemaOnly, -dataOnly | | [Schema creation options](#schema-creation-options) | -dropSchema, -targetSchema | | [Schema object selection options](#schema-object-selection-options) | -allTables, -tables, -excludeTables,

-constraints, -ignoreCheckConstFilter,

-skipCKConst, -skipFKConst,

-skipColDefaultClause,

-indexes, -triggers,

-allViews, -views, -excludeViews,

-allSequences, -sequences, -excludeSequences,

-allProcs, -procs, -excludeProcs,

-allFuncs, -funcs, -excludeFuncs,

-checkFunctionBodies,

-allPackages, -packages, -excludePackages,

-allDomains,

-allQueues, -queues, -excludeQueues

-allRules,

-allgroups, -groups | -| [Migration options](#migration-options) | -truncLoad, -enableConstBeforeDataLoad,

-retryCount, -safeMode, -fastCopy,

-analyze, vacuumAnalyze, -replaceNullChar,

-copyDelimiter, -batchSize,

-cpBatchSize, -lobBatchSize,

-fetchSize, -filterProp

-customColTypeMapping, -customColTypeMappingFile | +| [Migration options](#migration-options) | -truncLoad, -enableConstBeforeDataLoad,

-retryCount, -safeMode, -fastCopy,

-analyze, vacuumAnalyze, -replaceNullChar,

-copyDelimiter, -batchSize,

-cpBatchSize, -lobBatchSize,

-fetchSize, -filterProp

-customColTypeMapping, -customColTypeMappingFile

-mapVirtualToRegular | | [Connection retry options](#connection-retry-options) | -connRetryCount, -connRetryInterval, -abortOnConnFailure | | [Oracle-specific options](#oracle-specific-options) | -allUsers, -users,

-allProfiles, -profiles,

-importPartitionAsTable,

-objectTypes,

-copyViaDBLinkOra, -allDBLinks

-allSynonyms, -allPublicSynonyms, -excludeSynonyms,

-allPrivateSynonyms, -useOraCase,

-skipUserSchemaCreation | | [Miscellaneous options](#miscellaneous-options) | -help, -logDir, -logFileCount, -logFileSize, -logBadSQL -verbose, -version | @@ -450,13 +450,13 @@ The right side specifies a condition that must be true for each row migrated. For example, this code migrates only those countries with a `COUNTRY_ID` value that isn't equal to `AR`: -### `COUNTRIES=COUNTRY_ID<>'AR'` +`COUNTRIES=COUNTRY_ID<>'AR'` This constraint applies to the COUNTRIES table. You can also specify conditions for multiple tables. However, the condition for each table must be on a new line in the property file. -### Example +Example: The following entries in the properties file migrate only the relevant data from EMPLOYEES and the DEPARTMENTS tables: @@ -464,7 +464,7 @@ The following entries in the properties file migrate only the relevant data from `DEPARTMENTS=(DEPARTMENT_ID BETWEEN 10 AND 30)` -`-customColTypeMapping ` +### `-customColTypeMapping ` Use custom type mapping to change the data type of migrated columns. The left side of each pair specifies the columns with a regular expression. The right side of each pair names the data type for that column to assume. You can include multiple pairs in a semi-colon-separated list for ``. For example, to map any column whose name ends in `ID` to type `INTEGER`, use the following custom mapping entry: @@ -482,12 +482,30 @@ On Windows, use `'\.'` to represent the `'.'` character: Alternatively, you can include multiple custom type mappings in a ``: -`-customColTypeMappingFile ` +### `-customColTypeMappingFile ` Specify each entry in the file on a separate line in a key=value pair. The left side of each pair selects the columns with a regular expression. The right side of each pair names the data type for that column to assume. When used in the ``, the `'\\'` characters act as an escape string in any operating system. +### `-mapVirtualToRegular` + +Include the `-mapVirtualToRegular` option to migrate virtual, computed or generated columns in the source database to regular columns in the target database. + +Turning virtual columns to regular columns is helpful when the expression used to compute the values in the source database column is not supported in the target database or cannot be translated into an expression supported by the target database. With this option, you can still migrate the column's values to the target, but the values will no longer be computed dynamically, as they are stored in a regular column. + +For schema migrations, including the option results in all virtual columns in the source database being migrated to regular columns in the target database. + +For data migrations, including the option extracts the computed values from all computed columns in the source database and inserts those values into regular columns in the target database. + +For example, in: + +``` +./runMTK.sh -sourcedbtype sqlserver -targetdbtype enterprisedb -mapVirtualToRegular -allTables +``` + +A column called `FullName` that is computed from other two columns called `FirstName` and `LastName` in the source database, is migrated as a regular column called `FullName` in the target database. In the target, this column is no longer dynamically generated, but displays the `FullName` value the source database had at the time the migration was performed. + ## Connection retry options Whenever there's a connection failure with the target database during a data migration, Migration Tookit attempts to reconnect to the diff --git a/product_docs/docs/migration_toolkit/55/mtk_rel_notes/index.mdx b/product_docs/docs/migration_toolkit/55/mtk_rel_notes/index.mdx index 1104b39f04c..5c131116b32 100644 --- a/product_docs/docs/migration_toolkit/55/mtk_rel_notes/index.mdx +++ b/product_docs/docs/migration_toolkit/55/mtk_rel_notes/index.mdx @@ -3,6 +3,7 @@ title: "Release notes" redirects: - ../01_whats_new/ navigation: + - mtk_55100_rel_notes - mtk_5590_rel_notes - mtk_5580_rel_notes - mtk_5570_rel_notes @@ -23,6 +24,7 @@ The Migration Toolkit documentation describes the latest version of Migration To | Version | Release Date | |---------------------------------|--------------| +| [55.10.0](mtk_55100_rel_notes) | 21 Nov 2024 | | [55.9.0](mtk_5590_rel_notes) | 21 Aug 2024 | | [55.8.0](mtk_5580_rel_notes) | 16 May 2024 | | [55.7.0](mtk_5570_rel_notes) | 13 Dec 2023 | diff --git a/product_docs/docs/migration_toolkit/55/mtk_rel_notes/mtk_55100_rel_notes.mdx b/product_docs/docs/migration_toolkit/55/mtk_rel_notes/mtk_55100_rel_notes.mdx new file mode 100644 index 00000000000..8cd5a8bf42b --- /dev/null +++ b/product_docs/docs/migration_toolkit/55/mtk_rel_notes/mtk_55100_rel_notes.mdx @@ -0,0 +1,17 @@ +--- +title: "Migration Toolkit 55.10.0 release notes" +navTitle: Version 55.10.0 +--- + +Released: 21 Nov 2024 + +New features, enhancements, bug fixes, and other changes in Migration Toolkit 55.10.0 include: + +| Type | Description | Ticket | +|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| +| Enhancement | Migration Toolkit now supports PostgreSQL version 17 and EDB Postgres Advanced Server version 17 both as a source and target database. | | +| Enhancement | Improved the handling and consistency in migrating virtual columns across different source and target database combinations.
You can now choose whether to migrate virtual columns as virtual columns or map them to regular columns in the target. See [mapVirtualToRegular](../07_invoking_mtk/08_mtk_command_options/#-mapvirtualtoregular) for more information. | #38897 | +| Bug fix | Fixed an issue that caused synonyms from all source schemas to be migrated even when only one schema was selected for migration. | #41178 | +| Bug fix | Fixed an issue where the MySQL column type `BIGINT AUTO_INCREMENT` is not mapped to the `BIGSERIAL` column type in the target PostgreSQL/EDB Postgres Advanced Server table. | | +| Bug fix | Fixed the issue where migration fails in parallel mode for a table with a primary key based on the float data type. | | +| Bug fix | Fixed an issue where the indexes are skipped from migration when multiple tables are selected for a source MySQL database. | |