Migration errors

移行プロセス中、移行の概要に移行の進行状況が表示されます。エラーが発生すると、概要にエラーに関する情報が表示されます。移行の概要もログファイルに書き込まれます。

Linuxでは、ログファイルのデフォルトの場所は次のとおりです。

$HOME/.enterprisedb/migration-toolkit/logs

Windowsでは、ログファイルは次の場所に保存されます。

%HOMEDRIVE%%HOMEPATH%\.enterprisedb\migration-toolkit\logs

Migration Toolkitの-logdir <log_path>オプションを使用して、代替ログファイルの場所を指定できます。

</ div>

接続エラー

Migration Toolkitは、toolkit.properties fileの情報を使用して、ソースデータベースとターゲットデータベースに接続します。 Migration Toolkitの使用時に発生する接続エラーのほとんどは、toolkit.propertiesファイルで指定された情報に関連しています。

無効なユーザー名/パスワード

• Migration Toolkitを使用してオラクルデータベースから移行を実行しようとすると、次のエラーが表示されます。*

MTK-11009: Error Connecting Database "Oracle"
DB-1017: java.sql.SQLException: ORA-01017: invalid username/password;
logon denied
The user name or password specified in the `toolkit.properties` file is
not valid to use to connect to the Oracle source database.

このエラーを解決するには、SRC_DB_USERおよびSRC_DB_PASSWORDプロパティで移行を実行する権限を持つ有効なユーザの名前とパスワードを指定して、toolkit.propertiesファイルを編集します。

接続が拒否されました：致命的：パスワード

• Migration Toolkitで移行を実行しようとすると、次のエラーが表示されます。*

MTK-11009: Error Connecting Database "EDB Postgres EDB Postgres Advanced Server"
DB-28P01: com.edb.util.PSQLException: FATAL: password authentication
failed for user "name"

toolkit.propertiesファイルで指定されたユーザ名前またはパスワードは、 Postgresデータベースへの接続に使用するには有効ではありません。

このエラーを解決するには、TARGET_DB_USERおよびTARGET_DB_PASSWORDプロパティで移行を実行する権限を持つ有効なユーザの名前とパスワードを指定して、toolkit.propertiesファイルを編集します。

例外：ORA-28000：アカウントはロックされています

• Migration Toolkitを使用してオラクルデータベースから移行を実行しようとすると、次のエラーメッセージれます。*

MTK-11009: Error Connecting Database "Oracle"
DB-28000: java.sql.SQLException: ORA-28000: the account is locked
The Oracle account associated with the user name specified in the
toolkit.properties file is locked.

このエラーを解決するには、 オラクルサーバーでユーザアカウントのロックを解除するか、SRC_DB_USERおよびSRC_DB_PASSWORDパラメーターで移行を実行する権限を持つ有効なユーザの名前とパスワードを指定して、toolkit.propertiesファイルを編集します。

例外：oracle.jdbc。ドライバ.OracleDriver

• Migration Toolkitで移行を実行しようとすると、移行が失敗し、エラーメッセージが表示されます：*

MTK-11009: Error Connecting Database "Oracle"
java.lang.ClassNotFoundException: oracle.jdbc.driver.OracleDriver

Migration Toolkitを使用する前に、移行元のデータベースに適切なJDBCドライバをダウンロードしてインストールする必要があります。完全な手順については、Installing Source-Specific Driversを参照してください。

I / O例外：ネットワークアダプターは接続を確立できませんでした

• Migration Toolkitで移行を実行しようとすると、次のエラーが表示されます。*

MTK-11009: Error Connecting Database "Oracle"
DB-17002: java.sql.SQLException: Io exception: The
Network Adapter could not establish the connection

toolkit.propertiesファイルで指定されたソースデータベースのJDBC URLに無効な接続プロパティが含まれています。

このエラーを解決するには、を編集し、プロパティでソースデータベースの有効な接続情報を指定します。値はデータベース固有です。ソースデータベースタイプの詳細情報を参照してください。

例外：「ターゲット」データベースに指定されたURLは無効です

• Migration Toolkitで移行を実行しようとすると、次のエラーが表示されます。*

MTK-10045: The URL specified for the "target" database is invalid.
Check the connectivity credentials.

toolkit.propertiesファイルで指定されているターゲットデータベース（EDB Postgres Advanced Server ）のJDBC URLに無効な接続プロパティが含まれています。

このエラーを解決するには、TARGET_DB_URLプロパティでターゲットデータベースの有効な接続情報を指定して、toolkit.propertiesファイルを編集します。 EDB Postgres Advanced ServerのJDBC URLの形成については、Defining an EDB Postgres Advanced Server URLを参照してください。

</ div>

移行エラー

Migration Toolkitがターゲットおよびソースデータベースサーバーに正常に接続した後、次のエラーが発生する可能性があります。

エラー：最後の予想列の後の追加データ

• テーブルをオンラインで移行すると、エラーメッセージが表示されます：*

MTK-17001: Error Loading Data into Table: table_name
DB-22P04: com.edb.util.PSQLException: ERROR: extra data after last
expected column
Where: COPY table_name, line 5: "50|HR|LOS|ANGELES"

このエラーは、table_nameの列のデータにデリミタ文字が含まれている場合に発生します。このエラーを修正するには、デリミタ文字をテーブルの内容にない文字に変更します。

!!! Note * この例では、最後の列への挿入を意図したテキストLOS|ANGELESにパイプ文字（ |）があり、\ ``-copyDelimiter '|'``オプションを使用してMigration Toolkitが実行され、エラーが発生します。

テーブルへのデータローディングエラー：* TABLE_NAME *

• データのみの移行を実行すると、次のエラーが表示されます：*

MTK-17001: Error Loading Data into Table: TABLE_NAME
DB-42P01: com.edb.util.PSQLException: ERROR: relation
"schema.\ table_name" does not exist
* I also get the error:*
Trying to reload table: TABLE_NAME through bulk inserts with a batch
size of 100
MTK-17001: Error Loading Data into Table: TABLE_NAME
DB-42P01: com.edb.util.PSQLException: ERROR: relation
"schema.\ table_name" does not exist

データを移行する前に、ターゲットデータベースのデータを受信するテーブルを作成する必要があります。 TABLE_NAMEという名前のテーブルがターゲットデータベースに存在することを確認します。必要に応じてテーブルを作成し、データ移行をリトライします。

制約CONS_NAME_FKの作成エラー

• インデックスとコンストレインを含むテーブル移行を実行すると、次のエラーメッセージれます。*

MTK-15001: Error Creating Constraint EMP_DEPT_FK
DB-42P01: com.edb.util.PSQLException: ERROR: relation "hr.departments"
does not exist
Creating Constraint: EMP_JOB_FK
MTK-15001: Error Creating Constraint EMP_JOB_FK
DB-42P01: com.edb.util.PSQLException: ERROR: relation "hr.jobs" does not exist
Creating Constraint: EMP_MANAGER_FK
Schema HR imported with errors.
One or more schema objects could not be imported during the migration
process. Please review the migration output for more details.
Migration logs have been saved to
/home/user/.enterprisedb/migration-toolkit/logs
******************** Migration Summary ********************
Tables: 1 out of 1
Constraints: 4 out of 6
Total objects: 7
Successful count: 5
Failed count: 2
Invalid count: 0
List of failed objects
======================
Constraints
--------------------
1. HR.EMPLOYEES.EMP_DEPT_FK
2. HR.EMPLOYEES.EMP_JOB_FK

移行するテーブルには、ターゲットデータベースに存在しないテーブルに対する外部キー制約が含まれています。 Migration Toolkitは、外部キー制約を省略してテーブルを作成します。

Migration Toolkitコマンドに-skipFKConstオプションを含めることにより、エラーメッセージの生成を回避できます。

テーブルへのデータ読み込みエラー

• テーブル定義は既に移行済みです。データをテーブルに移行しようとすると、エラーが発生します：*

MTK-17001: Error Loading Data into Table: DEPARTMENTS
DB-22P04: com.edb.util.PSQLException: ERROR: extra data after last
expected column
Where: COPY departments, line 1: "10 Administration 200 1700"
Trying to reload table: DEPARTMENTS through bulk inserts with a batch
size of 100
MTK-17000: Batch entry 0 INSERT INTO hr.DEPARTMENTS VALUES (10,
'Administration', 200, 1700); was aborted. Call getNextException to see
the cause.
DB-42601: java.sql.BatchUpdateException: Batch entry 0 INSERT INTO
hr.DEPARTMENTS VALUES (10, 'Administration', 200, 1700); was aborted.
Call getNextException to see the cause., Skipping Batch
MTK-17000:ERROR: INSERT has more expressions than target columns
Position: 48
[DEPARTMENTS] Table Data Load Summary: Total Time(s): 0.037 Total Rows:0
Data Load Summary: Total Time (sec): 0.168 Total Rows: 0 Total Size(MB):0.0
Schema HR imported with errors.

ターゲットデータベースのテーブル定義が、移行されたデータとマッチしません。ターゲットまたはソーステーブルを変更した場合は、テーブル定義とデータに互換性があることを確認してください。

エラー：タイプに対して値が長すぎます

• テーブル定義は既に移行済みです。データをテーブルに移行しようとすると、次のエラーが表示されます。*

MTK-17001: Error Loading Data into Table: DEPARTMENTS
DB-22001: com.edb.util.PSQLException: ERROR: value too long for type
character(1)
Where: COPY departments, line 1, column location_id: "1700"
Trying to reload table: DEPARTMENTS through bulk inserts with a batch
size of 100
MTK-17000: Batch entry 0 INSERT INTO hr.DEPARTMENTS VALUES (10,
'Administration', 200, 1700); was aborted. Call getNextException to see
the cause.
DB-22001: java.sql.BatchUpdateException: Batch entry 0 INSERT INTO
hr.DEPARTMENTS VALUES (10, 'Administration', 200, 1700); was aborted.
Call getNextException to see the cause., Skipping Batch
MTK-17000:ERROR: value too long for type character(1)

ターゲットデータベースの列は、移行されたデータを受け取るのに十分なラージさではありません。この問題は、移行後にテーブル定義が変更された場合に発生する可能性があります。列名前（この例では、location_id）は、Where:で始まる行で識別されます。

場所：COPY departments, line 1, column location_id: "1700"

問題を修正するには、列サイズを調整し、移行をリトライします。

エラー：スレッドの例外：OutOfMemoryError

• MySQLデータベースから移行すると、次のエラーが発生します。*

Loading Table: big_range ...
Exception in thread "dataload_job_1" java.lang.OutOfMemoryError: Java
heap space
at com.mysql.jdbc.MysqlIO.nextRow(MysqlIO.java:1370)
at com.mysql.jdbc.MysqlIO.readSingleRowSet(MysqlIO.java:2369)
at com.mysql.jdbc.MysqlIO.getResultSet(MysqlIO.java:451)
at com.mysql.jdbc.MysqlIO.readResultsForQueryOrUpdate(MysqlIO.java:2076)
at com.mysql.jdbc.MysqlIO.readAllResults(MysqlIO.java:1451)
at com.mysql.jdbc.MysqlIO.sqlQueryDirect(MysqlIO.java:1787)
at com.mysql.jdbc.Connection.execSQL(Connection.java:3277)
at com.mysql.jdbc.Connection.execSQL(Connection.java:3206)
at com.mysql.jdbc.Statement.executeQuery(Statement.java:1232)
at com.edb.dbhandler.mysql.Data.getTableData(Data.java:90)
at com.edb.DataLoader.loadDataInFastMode(DataLoader.java:594)
at com.edb.DataLoader.run(DataLoader.java:186)
at java.lang.Thread.run(Thread.java:722)

デフォルトでは、MySQL JDBCドライバは、1回のネットワークラウンドトリップで、テーブル内のすべての行をMigration Toolkitにフェッチします。この動作は、ラージテーブルで使用可能なメモリを簡単に超える可能性があります。

問題を修正するには、移行をリトライするときにコマンドライン引数として-fetchSize 1を指定します。