변환 문제 및 패턴 참조

변환 작업공간은 모든 변환 문제를 그룹 및 카테고리로 집계하여 변환 오류 및 경고를 수정하는 계획을 세우는 데 도움이 됩니다. 각 카테고리는 문제를 해결하기 위해 수행해야 할 수 있는 작업 유형 (검토, 리팩터링, 데이터 유형 조정)을 나타냅니다. 그룹은 하위 수준에서 특정 사례를 구분하므로 추가 집계를 제공합니다.

그림 1. 변환 문제 그룹 및 카테고리가 표시된 변환 작업공간 개요 화면

다음 표에는 스키마 변환 중에 발생할 수 있는 모든 변환 문제 그룹이 나와 있습니다.

문제 그룹 ID	설명
입력 문제 (CW_01)
CW_OP0101	잘못된 소스 코드
	잠재적 근본 원인 이 그룹의 오류는 Database Migration Service에서 알 수 없는 문법이 발생하거나 Oracle 소스 코드가 유효하지 않은 경우에 자주 발생합니다(예: 저장 프로시저에 END; 키워드가 누락됨).
	가능한 완화 조치 소스 Oracle 데이터베이스에서 잘못된 객체를 수정합니다. 그런 다음 Database Migration Service에서 소스 스키마 스냅샷을 새로고침하고 스키마 변환 프로세스를 다시 시도합니다. 또는 이전에서 객체를 제외할 수 있습니다.
CW_OP0102	참조된 객체 없음
	잠재적 근본 원인 Database Migration Service는 소스 트리에 있는 객체의 메타데이터를 사용하여 종속 객체의 코드 변환 품질을 개선합니다. 코드가 소스 스키마에 포함되지 않은 객체를 참조하는 경우 Database Migration Service에서 누락된 참조 열, 속성 또는 객체의 구조나 데이터 유형을 확인할 수 없으므로 변환 문제가 발생할 수 있습니다. 이 그룹에서 발생할 수 있는 오류에는 사용자 정의 유형 (UDT)의 잘못된 데이터 유형 또는 열, 매개변수, 변수의 기본 VARCHAR 데이터 유형이 포함됩니다.
	가능한 완화 조치 모든 참조 객체가 Database Migration Service 소스 트리에 추가되었는지 확인하거나 누락된 종속 항목의 소스 데이터 모델에 대한 지식을 바탕으로 PostgreSQL 코드를 수동으로 조정합니다.
CW_OP0103	기본 키가 없는 테이블
	잠재적 근본 원인 Database Migration Service를 사용하려면 모든 테이블에 기본 키가 있어야 합니다. 기본 키가 없는 테이블의 경우 Database Migration Service는 rowid라는 NUMERIC 열을 대상 PostgreSQL 테이블에 추가합니다. 이 열은 소스 Oracle ROWID 유사 열의 해당 숫자 값으로 채워집니다. 마이그레이션 후 INSERT 문이 실패하지 않도록 Database Migration Service는 시퀀스를 만들고 이를 사용하여 rowid 열을 자동 증가시킵니다.
	가능한 완화 조치 이전 후 rowid 열을 유지하거나 삭제할 수 있습니다.
지원되지 않는 소스 기능 (CW_02)
CW_OP0200	지원되지 않는 Oracle 기본 제공 기능
	잠재적 근본 원인 지원되지 않는 기본 제공 Oracle 기능을 사용하고 있을 수 있습니다.
	가능한 완화 조치 PostgreSQL에서 유사한 기능을 찾아 변환된 코드를 적절하게 수정합니다. 경우에 따라 PostgreSQL용 Cloud SQL 및 PostgreSQL용 AlloyDB 마이그레이션 모두에 사용할 수 있는 Orafce 확장 프로그램에서 누락된 기능을 제공할 수 있습니다.
CW_OP0201	SQLCODE 지원되지 않음
	잠재적 근본 원인 Oracle SQLCODE 함수는 변환에 지원되지 않습니다. SQLCODE는 INTEGER를 반환하는 반면 PostgreSQL에서 가장 가까운 상응하는 함수는 TEXT 값을 반환하는 SQLSTATE 함수입니다.
	가능한 완화 조치 소스 코드가 정수를 반환하는 SQLCODE에 의존하지 않는 경우 (예: SQLCODE가 VARCHAR2 열에만 로깅되거나 DBMS_OUTPUT 메시지와 함께 로깅되는 경우) PostgreSQL 코드에서 SQLSTATE를 안전하게 사용할 수 있습니다. 소스 코드가 정수를 반환하는 SQLCODE에 의존하는 경우(예: NUMBER 또는 INTEGER 변수와 함께 사용하거나 SQLCODE 반환 값을 매개변수 또는 열로 저장하는 경우) 변환된 코드를 리팩터링해야 합니다.
CW_OP0203	지원되지 않는 Oracle SQL 함수
	잠재적 근본 원인 일부 Oracle 기본 제공 함수는 Database Migration Service에서 변환을 지원하지 않습니다. 일부 함수는 PostgreSQL에 상응하는 함수가 있을 수 있고(예: ASCII), 다른 함수는 이름은 같지만 사양이 다를 수 있습니다 (예: REGEXP% 함수). 일부 함수는 아예 존재하지 않을 수도 있습니다.
	가능한 완화 조치 오류를 발생시킨 Oracle 함수를 검사합니다. PostgreSQL에서 동일한 동작을 하는 함수가 있는 경우 마이그레이션 후 변환된 코드가 동일하게 작동하므로 오류 메시지를 무시해도 됩니다. 함수의 이름이 동일하지만 다르게 작동하거나 PostgreSQL에 존재하지 않는 경우 변환된 코드를 수정할 수 있습니다. 대상 데이터베이스에 동일한 이름의 사용자 정의 함수 (UDF)를 만듭니다. 소스의 함수 호출을 동등한 표현식으로 바꿉니다. Gemini로 향상된 변환 지원을 사용합니다. 자세한 내용은 Gemini 지원을 사용하여 SQL Server 코드 및 스키마 변환을 참조하세요. 일부 Oracle 데이터베이스 함수 또는 기능은 Orafce와 같은 확장 프로그램으로 복제될 수 있습니다. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요.
CW_OP0204	Oracle 기본 제공 패키지가 완전히 지원되지 않음
	잠재적 근본 원인 Database Migration Service는 특정 Oracle 기본 제공 패키지를 지원하지만 DBMS_STATS, DBMS_UTILITY, DBMS_SQL 등 많은 패키지는 완전한 변환 지원이 없습니다.
	가능한 완화 조치 지원되지 않는 패키지를 사용하는 경우 다음 작업을 수행해야 할 수 있습니다. 코드를 변경합니다. 예를 들어 DBMS_STATS.GATHER_TABLE_STATS 대신 ANALYZE와 같은 더 간단한 명령어를 사용할 수 있습니다. UTL_FILE 및 DBMS_AQ와 같은 패키지는 PostgreSQL에서 쉽게 복제할 수 없으므로 리팩터링이 필요할 수 있습니다. 일부 Oracle 데이터베이스 함수 또는 기능은 Orafce와 같은 확장 프로그램으로 복제될 수 있습니다. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요.
CW_OP0205	변환에 지원되지 않는 Oracle 데이터 유형
	잠재적 근본 원인 일부 Oracle 데이터 유형은 현재 변환 또는 데이터 이동에 지원되지 않습니다.
	가능한 완화 조치 대부분의 경우 PostgreSQL에는 상응하는 데이터 유형이 있습니다. 변환 매핑 파일을 사용하여 변환 로직을 맞춤설정하고 지원되지 않는 Oracle 데이터 유형을 필요한 PostgreSQL 데이터 유형으로 변환할 수 있습니다. 데이터 유형 지원에 대한 자세한 내용은 변환 작업공간 - 개요 및 지원되는 객체를 참조하세요.
CW_OP0206	이름 충돌
	잠재적 근본 원인 이 그룹은 여러 데이터베이스 객체 (예: 테이블, 구체화된 뷰)가 대상 데이터베이스에서 동일한 이름을 사용하도록 변환되는 문제를 포착합니다. 예를 들어 이름의 대소문자만 다른 소스 객체가 있는 경우 이 문제가 발생할 수 있습니다. Oracle 객체 이름은 대소문자를 구분하지 않지만 PostgreSQL은 대소문자를 구분하므로 객체 이름은 동일한 문자열을 사용하도록 변환됩니다.
	가능한 완화 조치 소스 데이터베이스에서 직접 또는 변환 작업공간 편집기의 변환된 스키마에서 충돌하는 객체의 이름을 바꿉니다. RENAME_* 지시문과 함께 변환 매핑 파일을 사용할 수도 있습니다.
지원되지 않는 소스 특성 (CW_03)
CW_OP0300	지원되지 않는 소스 특성
	잠재적 근본 원인 이 그룹은 변환이 지원되지 않는 Oracle 기능과 관련된 모든 일반적인 문제를 포착합니다. 이 그룹의 문제는 다른 더 구체적인 문제 그룹에 속하지 않습니다.
	가능한 완화 조치 일부 Oracle 데이터베이스 함수 또는 기능은 Orafce와 같은 확장 프로그램으로 복제될 수 있습니다. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정합니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0301	지원되지 않는 스키마 객체 유형
	잠재적 근본 원인 PostgreSQL에 적절한 상응 항목이 없으므로 Database Migration Service는 코드 변환에 특정 Oracle 스키마 객체 유형을 지원하지 않습니다. 예를 들어 색인 구성 테이블 (IOT), 텍스트 검색 색인 또는 사용자 정의 유형 (UDT)의 본문이 있습니다.
	가능한 완화 조치 Database Migration Service는 지원되지 않는 객체를 가장 가까운 PostgreSQL 상응 항목으로 변환합니다. 예를 들어 IOT는 기본 키 제약조건이 있는 일반 테이블이 되고 텍스트 검색 색인은 B-트리 색인으로 변환됩니다. 이러한 변환으로 인해 원래 객체 유형과 관련된 기능이 손실될 수 있습니다.
CW_OP0302	지원되지 않는 PL/SQL 기능
	잠재적 근본 원인 이 그룹은 변환에 지원되지 않는 PL/SQL 기능과 관련된 모든 일반적인 문제를 포착합니다. 이 그룹의 문제는 다른 더 구체적인 문제 그룹에 속하지 않습니다.
	가능한 완화 조치 일부 Oracle 데이터베이스 함수 또는 기능은 Orafce와 같은 확장 프로그램으로 복제될 수 있습니다. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정합니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0303	지원되지 않는 일괄 바인딩
	잠재적 근본 원인 Database Migration Service 코드 변환은 현재 BULK COLLECT, FORALL, SAVE EXCEPTIONS와 같은 Oracle 대량 바인딩 기능을 지원하지 않습니다.
	가능한 완화 조치 이 문제를 해결하려면 일괄 결합 기능을 사용하는 코드를 수정해야 합니다. PostgreSQL과 Oracle 아키텍처의 차이점과 사용 사례에 따라 PostgreSQL에서 배열 처리가 필요한지 여부를 고려해야 할 수 있습니다. PostgreSQL에서 Oracle 일괄 결합 작업에 접근하는 방법에는 여러 가지가 있습니다. 사용은 특정 시나리오에 따라 다르므로 Gemini 기반 변환 지원을 사용하여 특정 요구사항을 처리하는 것이 좋습니다. 다음은 시작하는 데 도움이 되는 몇 가지 추천 예시입니다. 전체 BULK COLLECT(LIMIT 없음)의 경우 ARRAY_AGG 함수를 사용해 볼 수 있습니다. LIMIT가 있는 BULK COLLECT의 경우 CURSOR FOR LOOP를 사용하여 배열의 행 배치를 로드하고 처리할 수 있습니다. 하지만 기능 변경이 허용되는 경우 더 간단한 대안은 CURSOR FOR LOOP를 사용하여 한 번에 한 행씩 처리하는 것입니다 (배열에 로드하는 대신). FORALL 작업의 경우 배열 처리를 사용하도록 선택하면 UNNEST를 사용하여 집합 기반 DML을 시도할 수 있습니다. SAVE EXCEPTIONS의 경우 PostgreSQL에 상응하는 절이 없으므로 행 기반 CURSOR FOR LOOP 내에 예외 핸들러를 작성해야 할 수 있습니다.
CW_OP0304	지원되지 않는 컬렉션
	잠재적 근본 원인 Database Migration Service 코드 변환은 Oracle 컬렉션을 부분적으로 지원합니다.
	가능한 완화 조치 이에 따라 변환된 PostgreSQL 코드를 수정해야 합니다. 컬렉션 문제를 해결할 때 PostgreSQL 배열은 희소하지 않다는 점에 유의하세요. 요소를 희소하게 할당하면 PostgreSQL 배열은 Oracle 배열과 다른 결과 및 카디널리티 수를 반환할 수 있습니다. PostgreSQL은 문자열 색인 배열을 지원하지 않으므로 데이터의 특성에 따라 JSON/JSONB 또는 hstore 확장 프로그램이 적합할 수 있습니다.
CW_OP0305	지원되지 않는 파이프라인 함수
	잠재적 근본 원인 Database Migration Service에서는 파이프라인 함수가 지원되지 않습니다.
	가능한 완화 조치 Oracle 파이프라인 함수를 PostgreSQL 집합 반환 함수로 바꿀 수 있습니다. 사용 사례와 관련된 방식으로 코드를 조정하는 것이 좋습니다. 다음은 시작하는 데 도움이 되는 몇 가지 예입니다. 파이프라인 함수의 rowtype을 정의하는 소스 Oracle 객체 또는 레코드 유형에서 변환된 PostgreSQL 유형 (UDT)을 참조합니다. 그런 다음 특정 사례에 따라 PostgreSQL 함수의 반환 절을 RETURNS SETOF <type name> 또는 RETURNS TABLE로 수정합니다. 변환된 PIPE ROW 코드의 반환 값을 RETURN NEXT <row or record variable>로 바꿉니다. Oracle 함수의 RETURN 절에 사용되는 소스 파이프라인 함수의 컬렉션 유형은 PostgreSQL에서 필요하지 않습니다.
CW_OP0306	지원되지 않는 동적 SQL
	잠재적 근본 원인 Database Migration Service는 동적 SQL 변환을 부분적으로 지원합니다. Oracle EXECUTE IMMEDIATE, OPEN FOR, USING/INTO 키워드는 이에 상응하는 PostgreSQL로 올바르게 변환되지만 실제 동적 SQL, DML 또는 DDL 문자열은 변환되지 않습니다.
	가능한 완화 조치 요구사항에 맞게 변환된 코드를 수정해야 합니다. 동적 SQL을 처리하려면 Gemini 기반 변환 지원을 사용하는 것이 좋습니다.
CW_OP0307	CONNECT BY 옵션은 지원되지 않음
	잠재적 근본 원인 대부분의 CONNECT BY 연산자, 함수, 의사 열은 Database Migration Service에서 지원되며 PostgreSQL 재귀 공통 테이블 표현식 (CTE)으로 변환됩니다. 하지만 주의가 필요한 특정 예외가 있습니다. 예를 들어 ORDER SIBLINGS BY 절은 오름차순으로만 지원됩니다.
	가능한 완화 조치 내림차순의 ORDER SIBLINGS BY 절을 간단한 방식으로 복제할 수 없으므로 오름차순으로 작동하도록 코드를 재구성해야 할 수 있습니다. CONNECT BY 연산자와 관련하여 보고된 문제를 검토하고 필요한 경우 코드를 조정합니다. 이러한 수정 작업을 신속하게 처리하려면 Gemini 기반 자동 변환 기능을 살펴보는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0308	지원되지 않는 JSON
	잠재적 근본 원인 Database Migration Service가 데이터 이동 및 코드 변환을 위해 JSON를 지원하는 방식에는 특정 제한사항이 있습니다. JSONB은 데이터 이동에 지원되지 않습니다. 코드 변환은 Oracle의 JSON 쿼리 함수 또는 연산자 (예: JSON_TABLE, JSON_QUERY, JSON_OBJECT[AGG], JSON_ARRAYAGG, JSON_PATCH)를 지원하지 않습니다. 21c 이전 Oracle 버전에서는 VARCHAR2, CLOB 또는 BLOB 열에 JSON 데이터를 저장하고 IS JSON 조건으로 확인할 수 있습니다. Database Migration Service는 이 조건의 변환을 지원하지 않습니다.
	가능한 완화 조치 VARCHAR2, CLOB 또는 BLOB 열에 저장된 JSON 데이터를 PostgreSQL로 이동하려면 MODIFY_TYPE 지시어를 사용하여 변환 매핑 파일을 작성해야 할 수 있습니다. 예를 들면 다음과 같습니다. MODIFY_TYPE SOURCE_TABLE_NAME:BLOB_COLUMN_NAME_WITH_JSON_DATA:JSON 변환 매핑 파일에 대한 자세한 내용은 변환 매핑 파일을 참조하세요. Oracle JSON 함수 및 연산자를 PostgreSQL로 변환하려면 JSONB_ARRAY_ELEMENTS, JSON_AGG와 같은 PostgreSQL 함수를 사용할 수 있습니다. 자세한 내용은 PostgreSQL 문서의 JSON 함수 및 연산자를 참조하세요.
CW_OP0309	잠금 및 트랜잭션 문제
	잠재적 근본 원인 Database Migration Service 코드 변환은 LOCK 또는 SAVEPOINT 문을 지원하지 않습니다. PostgreSQL은 SAVEPOINT를 지원하지 않습니다.
	가능한 완화 조치 Oracle에서 SAVEPOINT 블록을 분할하여 ROLLBACK 문을 사용하는 PostgreSQL에서 트랜잭션 블록을 분리합니다. DBMS_LOCK를 구현하려면 PostgreSQL pg_dbms_lock 확장 프로그램을 사용합니다. 이 확장 프로그램은 Oracle DBMS_LOCK 패키지의 기능을 에뮬레이션하여 Oracle 사용자 정의 잠금을 PostgreSQL로 쉽게 마이그레이션할 수 있도록 지원합니다.
CW_OP0310	지원되지 않는 XML
	잠재적 근본 원인 Database Migration Service는 Oracle XMLTYPE 또는 관련 XML 함수 및 연산자를 지원하지 않습니다.
	가능한 완화 조치 Database Migration Service는 XMLTYPE을 직접 지원하지 않지만 데이터 이동을 위해 BLOB, CLOB, NVARCHAR2 또는 VARCHAR2 열을 XML로 맞춤설정할 수 있습니다. PostgreSQL은 XML 기능을 지원합니다. XML 데이터를 이전하려면 다음 단계를 따르세요. XML 데이터에 대한 MODIFY_TYPE 지시문으로 변환 매핑 파일을 만듭니다. 예를 들면 다음과 같습니다. MODIFY_TYPE SOURCE_TABLE_NAME:BLOB_COLUMN_NAME_WITH_XML_DATA:XML 변환 매핑 파일에 대한 자세한 내용은 변환 매핑 파일을 참조하세요. 마이그레이션 작업을 시작합니다. 이 프로세스는 XMLTYPE 유형의 열에 있는 데이터를 제외한 모든 데이터를 Oracle에서 PostgreSQL로 마이그레이션합니다. 이러한 열은 PostgreSQL에서 NULL 값으로 채워집니다. Oracle에서 XMLTYPE 열만 선택하여 PostgreSQL에서 외래 테이블을 만듭니다. 소스 테이블의 기본 키 열을 포함합니다. 외부 테이블의 XML 데이터를 원래 PostgreSQL 테이블에 병합합니다. PostgreSQL이 XMLTYPE와 함께 작동하는 방식에 대한 자세한 내용은 PostgreSQL 문서의 XML 함수를 참조하세요.
CW_OP0312	PIVOT 지원되지 않음
	잠재적 근본 원인 Database Migration Service는 코드 변환을 위한 PIVOT 및 UNPIVOT 전치 연산자를 지원하지 않습니다.
	가능한 완화 조치 tablefunc 확장 프로그램을 사용하거나 소스 PIVOT 표현식을 조건부 집계로 다시 작성하여 PostgreSQL에서 PIVOT 전치를 수행할 수 있습니다. 예를 들면 다음과 같습니다. SUM(CASE WHEN <condition> THEN <value> ELSE 0 END) COUNT(CASE WHEN <condition> THEN 1 END) PostgreSQL에서 다양한 방법으로 열 집합에서 키-값 쌍을 만드는 UNPIVOT 전치를 만들 수 있습니다. LATERAL 조인을 VALUES 집합과 결합합니다. 예를 들면 SELECT ... FROM <table> CROSS JOIN LATERAL (VALUES ('<column1-name>', <column1>), ('<column2-name>', <column2>) AS u(column_name, column_value))입니다. ARRAY와 함께 UNNEST 사용 예를 들면 SELECT ..., UNNEST(ARRAY['<column1-name>', '<column2-name>']) AS column_name, UNNEST(ARRAY[column1, column2]) AS column_value FROM <table>입니다.
CW_OP0313	지원되지 않는 ALTER 문 옵션
	잠재적 근본 원인 Database Migration Service는 변환을 위해 (동적 SQL에서 자주 실행되는) ALTER 문을 사용하지 않습니다.
	가능한 완화 조치 Oracle ALTER 문을 PostgreSQL의 SET 명령어로 바꿉니다. 이러한 수정 작업을 신속하게 처리하려면 Gemini 기반 자동 변환 기능을 살펴보는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0314	지원되지 않는 SQL 기능
	잠재적 근본 원인 이 그룹은 변환이 지원되지 않는 SQL 기능과 관련된 모든 일반적인 문제를 포착합니다. 이 그룹의 문제는 다른 더 구체적인 문제 그룹에 속하지 않습니다. 예를 들면 데이터베이스 이벤트 트리거, GRANT 문, 다중 테이블 INSERT 작업, 인라인 뷰(INSERT INTO (SELECT ... FROM ...))의 DML, 측면 뷰가 있습니다.
	가능한 완화 조치 Orafce 확장 프로그램으로 기능을 복제해 보세요. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정합니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
지원되지 않는 문법 (CW_04)
CW_OP0400	지원되지 않는 문법
	잠재적 근본 원인 이 그룹은 지원되지 않는 Oracle SQL 또는 PL/SQL 문법과 관련된 모든 일반적인 문제를 포착합니다. 이 그룹의 문제는 다른 더 구체적인 문제 그룹에 속하지 않습니다.
	가능한 완화 조치 PostgreSQL과 기능적으로 동일한 PostgreSQL 구문을 사용하도록 코드를 변경합니다. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정하는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0401	지원되지 않는 SQL 문법
	잠재적 근본 원인 소스 코드에서 Database Migration Service에서 지원되지 않는 SQL 문법 또는 요소를 사용합니다. 예를 들어 Oracle TO_DATE 함수의 NLS_LANG 매개변수는 지원되지 않습니다.
	가능한 완화 조치 일부 Oracle 데이터베이스 함수 또는 기능은 Orafce와 같은 확장 프로그램으로 복제될 수 있습니다. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정합니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0402	지원되지 않는 PL/SQL 문법
	잠재적 근본 원인 소스 코드에서 Database Migration Service에서 지원되지 않는 PL/SQL 문법 또는 요소를 사용합니다. 예를 들어 레코드 기반 INSERT 문 (예: INSERT INTO table VALUES r_variable) 및 PRAGMA RESTRICT_REFERENCES는 지원되지 않습니다.
	가능한 완화 조치 PostgreSQL과 기능적으로 동일한 PostgreSQL 구문을 사용하도록 코드를 변경합니다. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정하는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0403	지원되지 않는 날짜 및 타임스탬프 문법
	잠재적 근본 원인 Database Migration Service는 지원되지 않는 날짜 또는 타임스탬프 문법, 작업 또는 표현식에 대해 오류 또는 경고를 발생시킬 수 있습니다. 이러한 문제의 예로는 일치하지 않는 데이터 유형 간의 비교 또는 타임스탬프에서 TZH:TZM 형식 모델 사용이 있습니다. 지원되는 객체 및 데이터 유형에 대한 자세한 내용은 변환 작업공간 정보를 참조하세요.
	가능한 완화 조치 PostgreSQL에 상응하는 표현식을 사용하여 대부분의 날짜 및 타임스탬프 표현식을 다시 만들 수 있습니다. 이러한 수정 작업을 신속하게 처리하려면 Gemini 기반 자동 변환 기능을 살펴보는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0404	Oracle의 예외 처리 문법 중 지원되지 않는 요소
	잠재적 근본 원인 Database Migration Service 코드 변환은 다음 Oracle PL/SQL 예외 문법 요소를 지원하지 않습니다. 리터럴 -20nnn 코드 대신 변수 오류 코드와 함께 RAISE_APPLICATION_ERROR를 사용합니다. 오류 코드 인수가 있는 SQLERRM 사용. 이 문법은 PostgreSQL에서 지원되지 않습니다.
	가능한 완화 조치 변환된 코드에서 이러한 문제를 수동으로 해결해야 합니다. 이러한 수정 작업을 신속하게 처리하려면 Gemini 기반 자동 변환 기능을 살펴보는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
데이터 유형 및 변환 (CW_05)
CW_OP0500	데이터 유형 및 변환 문제
	잠재적 근본 원인 Database Migration Service는 컨텍스트 (예: 유형 비교 표현식에서 발생하는 변환 문제)를 기준으로 변환 문제를 그룹화할 수 있습니다. CW_OP0500 그룹은 다른 문제 그룹에 속하지 않는 모든 일반 데이터 유형 변환 문제를 캡처합니다.
	가능한 완화 조치 대부분의 경우 Database Migration Service는 변환된 PostgreSQL 코드에서 ERROR_UNIMPLEMENTED 또는 ERROR_TYPE 메시지를 내보냅니다. 관련 데이터 유형에 대한 지식을 바탕으로 이 오류를 해결합니다.
CW_OP0501	날짜 형식 모델 문제
	잠재적 근본 원인 형식 모델을 기반으로 날짜 또는 타임스탬프 표현식을 문자열로 변환하거나 문자열에서 변환할 때 경고 또는 문제가 발생할 수 있습니다. Database Migration Service는 Oracle 소스 코드의 변환에서 명시적 날짜 또는 타임스탬프 형식 모델을 제외할 때 기본 모델 (현재 DD-MON-RR)을 사용합니다. 암시적 변환에 대해 내보낸 형식 모델이 동일한 표현식의 명시적 형식 모델과 충돌하는 경우 변환된 코드에 문제가 발생할 수 있습니다. Oracle RR 형식과 PostgreSQL YY 형식의 차이로 인해 데이터가 영향을 받을 수 있는 경우에도 이 문제가 발생할 수 있습니다.
	가능한 완화 조치 변환 작업공간에서 변환된 PostgreSQL 표현식을 검토하고 검증합니다.
CW_OP0502	숫자 형식 모델 문제
	잠재적 근본 원인 Database Migration Service는 모든 Oracle 형식 모델을 지원하지 않습니다. 예를 들어 'L' 또는 'X'는 지원되지 않습니다. Oracle 형식 모델을 기반으로 문자열을 숫자로 변환하는 코드에서 문제나 경고가 발생할 수 있습니다.
	가능한 완화 조치 PostgreSQL에 상응하는 항목이 없는 Oracle 형식 모델의 경우 표현식 또는 형식 모델을 리팩터링해야 할 수 있습니다. 이러한 수정 작업을 신속하게 처리하려면 Gemini 기반 자동 변환 기능을 살펴보는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0503	데이터 유형 변환 문제
	잠재적 근본 원인 지원되지 않거나 부정확한 데이터 유형 변환으로 인해 오류가 발생할 수 있습니다. Database Migration Service는 일반적으로 ERROR_UNIMPLEMENTED를 내보냅니다. 이는 일반적으로 메타데이터가 누락되었거나 불완전하기 때문입니다. Database Migration Service에 유형을 변환하기에 충분한 정보가 없을 수 있습니다(예: 함수 인수 또는 프로시져 매개변수).
	가능한 완화 조치 올바른 데이터 유형 변환을 위해 PostgreSQL 코드를 조정합니다. 이러한 수정에는 참조된 속성, 변수, 열에 대한 지식이 필요합니다.
CW_OP0504	비교 문제
	잠재적 근본 원인 Database Migration Service에 데이터 비교 표현식을 변환할 때 데이터 유형에 대한 메타데이터나 정보가 충분하지 않을 수 있습니다. 예를 들어 사용자 정의 유형 (UDT)을 NULL과 비교할 때 발생할 수 있습니다.
	가능한 완화 조치 변환된 PostgreSQL 표현식을 검토하고 문제를 해결합니다. 이러한 수정 작업을 신속하게 처리하려면 Gemini 기반 자동 변환 기능을 살펴보는 것이 좋습니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
잠재적인 기능적 차이 (CW_06)
이 카테고리의 문제는 Oracle 소스 코드가 가장 가까운 PostgreSQL 상응 코드로 올바르게 변환되었지만 결과 코드에 검토가 필요한 사소한 의미론적 또는 기능적 차이가 있을 수 있는 경우를 나타냅니다. 이는 Oracle과 PostgreSQL이 데이터 유형, 형식 또는 객체를 처리하는 방식의 차이로 인해 발생합니다. 언뜻 보면 이 카테고리는 데이터 유형 및 변환 (CW_05) 카테고리의 문제와 중복되는 것처럼 보일 수 있지만 서로 다른 문제를 나타냅니다. CW_05에는 Database Migration Service가 Oracle 코드를 PostgreSQL에 상응하는 코드로 변환할 수 없는 알려진 문제가 포함되어 있습니다.
CW_OP0601	날짜 형식 모델 검토
	잠재적 근본 원인 대부분의 Oracle 날짜 및 타임스탬프 형식 모델은 PostgreSQL에 적절한 상응 항목이 있으므로 변환된 코드에는 의미론적 또는 기능적 차이가 없습니다. 일부 모델은 정확히 일치하지 않으며 동작이 다릅니다. 한 가지 예시는 PostgreSQL YY 형식으로 변환되는 Oracle RR 형식입니다.
	가능한 완화 조치 변환된 코드가 예상대로 작동하는지 확인하기 위해 형식 모델 변환으로 표현식을 검토하고 검증합니다.
CW_OP0602	숫자 형식 모델 검토
	잠재적 근본 원인 대부분의 소스 숫자 형식 모델에는 PostgreSQL에 상응하는 모델이 있으므로 변환된 코드에는 의미론적 또는 기능적 차이가 없습니다. 하지만 일부 형식 모델은 정확히 일치하지 않거나 약간 다르게 작동할 수 있습니다.
	가능한 완화 조치 변환된 코드가 예상대로 작동하는지 확인하기 위해 형식 모델 변환이 있는 표현식을 검토하고 검증합니다.
CW_OP0603	예외 코드 검토
	잠재적 근본 원인 -20000~-20999 범위의 오류 코드와 함께 RAISE_APPLICATION_ERROR를 사용하면 Database Migration Service가 이를 CW0000~CW999 범위의 SQLSTATE가 있는 PostgreSQL RAISE EXCEPTION로 변환합니다. 변환은 소스 오류 코드의 마지막 3자리를 유지하고 앞에 CW를 추가합니다.
	가능한 완화 조치 이 동작을 검토하여 필요에 적합한지 확인하세요. 이 검토는 소스 오류 코드가 애플리케이션, 지원팀 또는 문서에 의미가 있는 경우에만 필요합니다. 오류 코드 값 자체가 의미가 없으면 이 경고를 무시해도 됩니다.
CW_OP0604	예외 메시지 검토
	잠재적 근본 원인 SQLERRM 함수는 Oracle PL/SQL과 PostgreSQL 모두에 있지만 각 엔진에서 다른 오류 텍스트를 반환할 수 있습니다. 예를 들어 Oracle에서 0으로 나누면 오류 텍스트 ORA-01476: divisor is equal to zero가 반환되지만 PostgreSQL에서는 ERROR: division by zero가 반환됩니다.
	가능한 완화 조치 애플리케이션, 지원 인프라 또는 문서가 오류 텍스트에 종속된 경우 변환을 검토하세요. 그렇지 않으면 이 차이를 무시해도 됩니다.
CW_OP0605	Oracle 기본 제공 함수 에뮬레이션 검토
	잠재적 근본 원인 Database Migration Service 코드 및 스키마 변환은 PostgreSQL에 상응하는 Oracle 함수 동작을 제공하는 것을 목표로 하지만 결과가 시나리오에 항상 만족스럽지 않을 수 있습니다. 따라서 변환 작업공간은 검토가 필요할 수 있는 함수 변환에 대한 자문 경고를 항상 제공합니다.
	가능한 완화 조치 변환 작업공간에서 CW_OP0605 문제 그룹에 경고를 표시하는 객체를 검토하는 것이 좋습니다.
CW_OP0606	외래 키 열 데이터 유형 검토
	잠재적 근본 원인 Database Migration Service가 상위 객체와 하위 객체 간에 일치하지 않는 데이터 유형 사양을 식별했습니다 (예: 상위 열이 NUMBER(4)이고 하위 열이 NUMBER(10)인 경우).
	가능한 완화 조치 대부분의 경우 약간의 데이터 유형 불일치는 데이터베이스 기능에 문제를 일으키지 않습니다. 하지만 변환된 데이터 모델에 불일치가 있는지 검토하는 것이 좋습니다.
기능적 검토 권장 (CW_07)
CW_OP0701	기능적 검토 권장
	잠재적 근본 원인 이 그룹은 Oracle 및 PostgreSQL 코드의 잠재적인 기능 차이와 관련된 모든 일반적인 문제를 포착합니다. 이 그룹의 문제는 다른 더 구체적인 문제 그룹에 속하지 않습니다.
	가능한 완화 조치 일부 Oracle 데이터베이스 함수 또는 기능은 Orafce와 같은 확장 프로그램으로 복제될 수 있습니다. 대상 데이터베이스에서 지원되는 확장 프로그램에 대한 자세한 내용은 지원되는 데이터베이스 확장 프로그램을 참조하세요. Gemini 기반 자동 변환 기능을 살펴보고 코드를 조정합니다. 자세한 내용은 Gemini 지원을 사용하여 Oracle 코드 및 스키마 변환을 참조하세요.
CW_OP0702	Oracle 기본 제공 함수 에뮬레이션 검토
	잠재적 근본 원인 대부분의 Oracle 기본 제공 함수는 PostgreSQL에 직접 상응하는 함수가 없습니다. 마이그레이션에서 이 문제를 완화하기 위해 Database Migration Service는 다양한 SQL 표현식을 사용하여 코드를 변환하여 PostgreSQL에서 동일한 기능 동작을 생성합니다. 경우에 따라 변환된 표현식이 복잡할 수 있습니다. Database Migration Service는 CW_OP0702 그룹에서 경고를 표시하여 발생 가능한 문제를 강조 표시하고 함수가 표현식으로 에뮬레이션되었음을 알립니다.
	가능한 완화 조치 변환된 코드를 검토하여 변환된 함수가 PostgreSQL 환경에서 예상대로 작동하는지 확인합니다.
리팩터링 필요 (CW_08)
CW_OP0801	자율 트랜잭션 리팩터링 필요
	잠재적 근본 원인 PostgreSQL은 자율 트랜잭션을 지원하지 않습니다.
	가능한 완화 조치 dblink, pg_background 또는 PL/Proxy 확장 프로그램을 사용하여 PostgreSQL에서 자율 트랜잭션을 수행할 수 있습니다. 이러한 확장 프로그램 중 하나로 수행된 데이터베이스 호출은 다른 세션에서 실행되므로 자율 트랜잭션을 생성합니다.
CW_OP0802	데이터베이스 링크 리팩터링 필요
	잠재적 근본 원인 Database Migration Service는 Oracle 데이터베이스 링크를 지원하지 않습니다. 링크를 사용하는 객체는 리팩터링이 필요합니다.
	가능한 완화 조치 데이터베이스 링크의 대상에 따라 dblink, postgres_fdw, oracle_fdw 또는 PL/Proxy와 같은 데이터베이스 확장 프로그램을 사용하여 PostgreSQL에서 동등한 기능을 구현할 수 있습니다.
CW_OP0803	고급 큐 리팩터링 필요
	잠재적 근본 원인 Oracle Advanced Queuing 패키지 (DBMS_AQ, DBMS_AQADM)에는 PostgreSQL에 상응하는 패키지가 없으며 리팩터링이 필요합니다.
	가능한 완화 조치 다음 옵션을 고려하세요. 큐 기능을 데이터베이스에서 애플리케이션 계층으로 리팩터링합니다. PostgreSQL 테이블, 알림, 트리거를 사용하여 동일한 동작을 구현합니다. 추가 지원이 필요한 경우 기술 솔루션팀 담당자에게 문의하세요.
CW_OP0804	데이터베이스 이메일 리팩터링 필요
	잠재적 근본 원인 PostgreSQL용 AlloyDB는 데이터베이스에서 직접 이메일을 전송하는 것을 지원하지 않습니다. 이 기능을 사용 설정하는 확장 프로그램도 지원되지 않습니다. 따라서 Database Migration Service는 UTL_SMTP 패키지 사용을 변환하지 않습니다.
	가능한 완화 조치 데이터베이스 이메일 코드를 리팩터링하고 이메일 전송 책임을 애플리케이션 계층으로 이동합니다. 데이터베이스를 사용하여 이메일 전송이 필요한 조건을 캡처할 수 있습니다. 구현 예시로는 이메일 세부정보를 전용 테이블에 쓰는 것이 있습니다. 이 테이블은 Cloud Run Functions 함수로 폴링하고 실제 SMTP 처리를 처리하는 이메일 큐로도 작동할 수 있습니다.
CW_OP0805	작업 및 예약 리팩터링 필요
	잠재적 근본 원인 DBMS_JOB 및 DBMS_SCHEDULER Oracle 패키지는 Database Migration Service에서 변환되지 않습니다. 이러한 패키지를 참조하는 코드를 리팩터링해야 합니다.
	가능한 완화 조치 종속 항목이 없는 간단한 작업의 경우 pg_cron 확장 프로그램을 사용하여 대상 PostgreSQL 데이터베이스에서 예약된 작업을 수동으로 만들 수 있습니다. pg_cron에서 지원하지 않는 더 복잡한 일정의 경우 애플리케이션 수준 또는 서드 파티 스케줄러를 사용해야 할 수 있습니다.
CW_OP0806	파일 I/O 리팩터링 필요
	잠재적 근본 원인 Database Migration Service는 Oracle UTL_FILE 패키지를 지원하지 않습니다. 이 패키지를 참조하는 코드를 리팩터링해야 합니다. Orafce 확장 프로그램에는 UTL_FILE 에뮬레이션이 포함되지만 제한된 파일 I/O 기능으로 인해 Google 관리 PostgreSQL 환경에서 작동하지 않을 수 있습니다.
	가능한 완화 조치 UTL_FILE에 대한 종속 항목을 삭제하도록 코드를 리팩터링합니다. PostgreSQL용 AlloyDB에는 파일 I/O 기능에 대한 특정 제한사항이 있으므로 대상 데이터베이스에서 이 동작을 직접 구현할 수 없습니다. VPC의 Compute Engine VM에 orafce 확장 프로그램과 함께 PostgreSQL을 설치하는 것이 대안이 될 수 있습니다. 그런 다음 대상 데이터베이스에서 PL/Proxy 확장 프로그램을 사용하여 Compute Engine VM의 데이터베이스에서 실행되는 PostgreSQL 호환 UTL_FILE 버전을 호출할 수 있습니다.
CW_OP0807	동의어
	잠재적 근본 원인 PostgreSQL은 동의어를 지원하지 않습니다. 코드 객체의 경우 Database Migration Service는 동의어 참조를 소스 스키마 및 객체 이름으로 자동으로 바꿉니다. 데이터베이스 애플리케이션 사용자의 읽기 전용 스키마와 같이 코드 객체 외부에서 동의어를 사용하는 경우 수동으로 변환해야 합니다.
	가능한 완화 조치 코드 객체 외부에서 동의어를 사용하려면 PostgreSQL SEARCH_PATH 매개변수를 사용하거나 쿼리 객체에 뷰를 사용하도록 코드를 리팩터링하면 됩니다.
CW_OP0808	전역 임시 테이블 리팩터링 필요
	잠재적 근본 원인 이 문제 그룹은 Database Migration Service가 Oracle 소스 코드에서 전역 임시 테이블을 감지했다는 경고입니다. 전역 임시 테이블을 마이그레이션하려면 대상 데이터베이스에 pgtt PostgreSQL 확장 프로그램이 설치되고 생성되어 있어야 합니다.
	가능한 완화 조치 대상 데이터베이스에 pgtt PostgreSQL 확장 프로그램이 설치되고 생성되었는지 확인하는 것이 좋습니다.
Gemini 검토 추천 (CW_99)
CW_AI9900	Gemini 추천 검토
	잠재적 근본 원인: 이 문제 그룹은 Gemini로 향상된 코드 변환과 관련된 모든 일반적인 오류와 경고를 포착합니다.
	가능한 완화 조치: 여기에 표시된 문제가 항상 실제 문제를 가리키는 것은 아니지만, 모든 Gemini 개선 전환을 검토하여 기대치와 일치하는지 확인하는 것이 좋습니다.
CW_AI9901	AI 증강 코드 검토
	잠재적 근본 원인: 이 DDL 코드는 Gemini로 향상된 기능으로 변환되었으며 정확성을 위해 검토가 필요할 수 있습니다.
	가능한 완화 조치 AI 증강으로 변환된 코드를 신중하게 검토하여 최종 결과가 소스 스키마의 기능과 일치하는지 확인하는 것이 좋습니다.
CW_AI9902	인용
	잠재적인 근본 원인: Gemini 기반 추천에는 여러 소스에서 인용한 콘텐츠가 포함될 수 있습니다. 특정 인용에는 라이선스 제한이 적용될 수 있습니다. 변환된 코드에 인용이 있는지 검토하는 것이 좋습니다.
일반 변환 문제 (CW_00)
CW_OP0000	메타데이터 변환 문제입니다.
	잠재적 근본 원인: 이 그룹은 다른 구체적인 문제 그룹에 속하지 않는 모든 전환 문제를 포착합니다.
	가능한 완화 조치 소스 데이터 모델에 대한 지식을 바탕으로 변환된 코드를 검토하고 필요에 따라 코드를 조정하는 것이 좋습니다.
CW_OP0001	메타데이터 변환 문제입니다.
	잠재적 근본 원인: 이 그룹은 다른 더 구체적인 문제 그룹에 속하지 않는 모든 메타데이터 추적 문제를 포착합니다.
	가능한 완화 조치: 이 그룹의 문제 예시는 일반적으로 변환된 PostgreSQL의 데이터 유형에 문제를 일으킬 수 있는 컴파일 오류 또는 경고와 관련이 있습니다. 소스 데이터 모델에 대한 지식을 바탕으로 변환된 코드를 검토하고 잘못된 참조를 조정하는 것이 좋습니다.
CW_OP0002	지원팀에 문의하세요.
	잠재적 근본 원인 특수한 극단적 사례에서는 유효한 Oracle 소스 객체에 내부 오류가 발생할 수 있습니다. 이 경우 지원팀에 문의하여 추가 지원을 받으세요.
CW_OP0003	일반 변환 문제
	잠재적 근본 원인 이 그룹에는 다른 구체적인 문제 카테고리나 그룹에 속하지 않는 모든 문제가 포함됩니다.
	가능한 완화 조치 소스 데이터 모델 및 코드에 대한 지식을 바탕으로 변환된 코드를 검토하고 필요에 따라 조정하는 것이 좋습니다.