Aurora MySQL에 대한 메이저 버전 업그레이드 사전 확인

사전 확인 쿼리가 성공적으로 완료됨. 비호환성이 감지되지 않음.

{
  "id": "auroraUpgradeCheckIndexLengthLimitOnTinytext",
  "title": "Check for the tables with indexes defined with prefix length greater than 255 bytes on tiny text columns",
  "status": "OK",
  "detectedProblems": []
},

사전 확인 쿼리가 성공적으로 완료됨. 한 가지 오류가 감지됨.

{
  "id": "auroraUpgradeCheckForPrefixIndexOnGeometryColumns",
  "title": "Check for geometry columns on prefix indexes",
  "status": "OK",
  "description": "Consider dropping the prefix indexes of geometry columns and restart the upgrade.",
  "detectedProblems": [
      {
        "level": "Error",
        "dbObject": "test25.sbtest1",
        "description": "Table `test25`.`sbtest1` has an index `idx_t1` on geometry column/s. Mysql 8.0 does not support this type of index on a geometry column https://dev.mysql.com/worklog/task/?id=11808. To upgrade to MySQL 8.0, Run 'DROP INDEX `idx_t1` ON `test25`.`sbtest1`;"
      },
 }

사전 확인에 성공하거나 실패하면 경고를 반환할 수 있음.

여기서 사전 확인 쿼리가 성공적으로 완료됨. 두 개의 경고가 감지됨.

{
  "id": "zeroDatesCheck",
  "title": "Zero Date, Datetime, and Timestamp values",
  "status": "OK",
  "description": "Warning: By default zero date/datetime/timestamp values are no longer allowed in MySQL, as of 5.7.8 NO_ZERO_IN_DATE and NO_ZERO_DATE are included in SQL_MODE by default. These modes should be used with strict mode as they will be merged with strict mode in a future release. If you do not include these modes in your SQL_MODE setting, you are able to insert date/datetime/timestamp values that contain zeros. It is strongly advised to replace zero values with valid ones, as they may not work correctly in the future.",
  "documentationLink": "https://lefred.be/content/mysql-8-0-and-wrong-dates/",
  "detectedProblems": [
      {
        "level": "Warning",
        "dbObject": "global.sql_mode",
        "description": "does not contain either NO_ZERO_DATE or NO_ZERO_IN_DATE which allows insertion of zero dates"
      },
      {
        "level": "Warning",
        "dbObject": "session.sql_mode",
        "description": " of 10 session(s) does not contain either NO_ZERO_DATE or NO_ZERO_IN_DATE which allows insertion of zero dates"
      }
    ]
}

오류로 인해 사전 확인 쿼리가 실패했으므로 비호환성을 확인할 수 없음.

{
  "id": "auroraUpgradeCheckForDatafilePathInconsistency",
  "title": "Check for inconsistency related to ibd file path.",
  "status": "ERROR",
  "description": "Can't connect to MySQL server on 'localhost:3306' (111) at 13/08/2024 12:22:20 UTC. This failure can occur due to low memory available on the instance for executing upgrade prechecks. Please check 'FreeableMemory' Cloudwatch metric to verify the available memory on the instance while executing prechecks. If instance ran out of memory, we recommend to retry the upgrade on a higher instance class."
}

이 오류는 예기치 않은 인스턴스 재시작 또는 실행 중에 데이터베이스에서 호환성 사전 확인 쿼리가 중단되어 발생할 수 있습니다. 예를 들어 더 작은 DB 인스턴스 클래스에서는 인스턴스에서 사용 가능한 메모리가 부족할 때 이러한 현상이 발생할 수 있습니다.

FreeableMemory Amazon CloudWatch 지표를 사용하여 사전 확인을 실행하는 동안 인스턴스에서 사용 가능한 메모리를 확인할 수 있습니다. 인스턴스의 메모리가 부족하면 더 큰 DB 인스턴스 클래스에서 업그레이드를 다시 시도하는 것이 좋습니다. 경우에 따라 블루/그린 배포를 사용할 수 있습니다. 이를 통해 프로덕션 워크로드와 관계없이 ‘그린’ DB 클러스터에서 사전 확인 및 업그레이드를 실행할 수 있으며, 시스템 리소스도 사용합니다.

자세한 내용은 Aurora MySQL 데이터베이스의 메모리 사용량 문제 해결 단원을 참조하십시오.

호환성 사전 확인에는 소스 및 대상 Aurora MySQL 버전에 대한 정보와 사전 확인 출력 끝부분의 오류, 경고 및 알림 수 요약도 포함됩니다.

예를 들어 다음 출력은 Aurora MySQL 2.11.6에서 Aurora MySQL 3.07.1로 업그레이드하려고 시도했음을 보여줍니다. 업그레이드에서 오류 1개, 경고 3개가 반환되었으며 알림은 반환되지 않았습니다. 오류가 반환되면 업그레이드를 진행할 수 없으므로 routineSyntaxCheck 호환성 문제를 해결하고 업그레이드를 다시 시도해야 합니다.

{
  "serverAddress": "/tmp%2Fmysql.sock",
  "serverVersion": "5.7.12 - MySQL Community Server (GPL)",
  "targetVersion": "8.0.36",
  "auroraServerVersion": "2.11.6",
  "auroraTargetVersion": "3.07.1",
  "outfilePath": "/rdsdbdata/tmp/PreChecker.log",
  "checksPerformed": [{
      ... output for each individual precheck ...
      .
      .
      {
        "id": "oldTemporalCheck",
        "title": "Usage of old temporal type",
        "status": "OK",
          "detectedProblems": []
      },
      {
        "id": "routinesSyntaxCheck",
        "title": "MySQL 8.0 syntax check for routine-like objects",
        "status": "OK",
        "description": "The following objects did not pass a syntax check with the latest MySQL 8.0 grammar. A common reason is that they reference names that conflict with new reserved keywords. You must update these routine definitions and `quote` any such references before upgrading.",
        "documentationLink": "https://dev.mysql.com/doc/refman/en/keywords.html",
        "detectedProblems": [{
            "level": "Error",
            "dbObject": "test.select_res_word",
            "description": "at line 2,18: unexpected token 'except'"
        }]
      },
      .
      .
      .
      {
        "id": "zeroDatesCheck",
        "title": "Zero Date, Datetime, and Timestamp values",
        "status": "OK",
        "description": "Warning: By default zero date/datetime/timestamp values are no longer allowed in MySQL, as of 5.7.8 NO_ZERO_IN_DATE and NO_ZERO_DATE are included in SQL_MODE by default. These modes should be used with strict mode as they will be merged with strict mode in a future release. If you do not include these modes in your SQL_MODE setting, you are able to insert date/datetime/timestamp values that contain zeros. It is strongly advised to replace zero values with valid ones, as they may not work correctly in the future.",
        "documentationLink": "https://lefred.be/content/mysql-8-0-and-wrong-dates/",
        "detectedProblems": [{
            "level": "Warning",
            "dbObject": "global.sql_mode",
            "description": "does not contain either NO_ZERO_DATE or NO_ZERO_IN_DATE which allows insertion of zero dates"
            },
            {
            "level": "Warning",
            "dbObject": "session.sql_mode",
            "description": " of 8 session(s) does not contain either NO_ZERO_DATE or NO_ZERO_IN_DATE which allows insertion of zero dates"
            }
          ]
       },
       .
       .
       .
  }],
  "errorCount": 1,
  "warningCount": 3,
  "noticeCount": 0,
  "Summary": "1 errors were found. Please correct these issues before upgrading to avoid compatibility issues."
}