DDL 파일 업로드(오프라인 워크플로)

이 워크플로에서 AWS 변환은 업로드된 DDL 파일에서 스키마를 완전히 현대화하므로 데이터베이스에 직접 연결할 필요가 없습니다. SQL Server에 대해 제공된 추출 스크립트를 실행하고, 결과 스키마 파일을 업로드하고, AWS 변환은 스키마를 검색, 평가, 변환 및 Amazon Aurora PostgreSQL에 배포합니다. 데이터베이스를 직접 연결에 노출할 수 없거나 네트워크 액세스 권한을 부여하기 전에 타당성 평가 및 스키마 변환을 원하는 경우이 워크플로를 선택합니다.

중요

오프라인 워크플로는 스키마만 변환하고 배포합니다. 실제 데이터는 마이그레이션하지 않습니다. 가능한 경우 합성 테스트 데이터를 생성하여 대상을 검증할 수 있습니다. 실제 데이터를 마이그레이션해야 하는 경우 AWS DMS 콘솔을 사용하여 새 데이터 마이그레이션 프로젝트를 생성합니다.

오프라인 워크플로의 사전 조건

• 지원되는 SQL Server 버전(2008 R2~2022, 모든 에디션).

• PowerShell 7 이상에서 추출 스크립트를 실행합니다. PowerShell은 Windows에 사전 설치되어 있습니다. macOS 또는 Linux에서 PowerShell 7+를 설치하고를 사용하여 스크립트를 실행합니다pwsh. Microsoft 설치 안내서를 참조하십시오.

• PATH에서 사용할 수 있는 sqlcmd 유틸리티입니다. sqlcmd 유틸리티를 참조하세요.

• 최소 VIEW SERVER STATE 및 VIEW ANY DEFINITION 권한이 있는 SQL Server 인증 로그인(사용자 이름 및 암호). 스크립트는 Windows 또는 도메인 인증을 지원하지 않습니다.

• IAM Identity Center 또는 IAM 인증이 활성화된 후기 단계의 AWS 계정(Aurora PostgreSQL 대상 생성 및 변환된 스키마 배포).

• 스키마 분석 및 변환 단계에서 AWS 는에 대한 인바운드 또는 아웃바운드 데이터베이스 연결이 필요하지 않습니다.

워크플로 단계

1. DDL 파일 업로드 - AWS 변환은 채팅에서 추출 스크립트에 대한 다운로드 버튼을 제공합니다. SQL Server에 대해 스크립트를 다운로드하고 실행합니다. 선택적으로 쉼표로 구분된 포함 목록(대소문자 비구분)이 있는 특정 데이터베이스로 추출을 제한합니다. 스크립트는 .zip SQL DDL 파일의 타임스탬프를 생성합니다. 채팅 업로드 버튼을 사용하여 .zip (또는 개별 .sql 파일)을 업로드합니다.

2. 검색 - AWS 변환은 업로드된 파일을 구문 분석하고 데이터베이스별로 그룹화된 데이터베이스 객체(테이블, 저장 프로시저, 뷰, 트리거, 인덱스, 제약 조건, 시퀀스 등)를 카탈로그화합니다. 데이터베이스별 요약을 검토하고 평가할 데이터베이스를 선택합니다. 일부 문을 구문 분석할 수 없는 경우 AWS 변환은 문제를 보고하고 구문 분석된 객체를 계속 사용하거나, 특정 데이터베이스를 선택하거나, 수정된 파일을 업로드할 수 있습니다.

3. 평가 - AWS 변환은 선택한 데이터베이스의 변환 가능성을 평가하고 실행 요약, 데이터베이스당 객체 요약 및 level-of-effort(LOE) 추정치가 포함된 다운로드 가능한 보고서를 생성합니다. LOE 점수를 사용자 지정하거나, 추가 파일을 업로드하거나, 변환을 진행합니다.

4. 스키마 변환 - AWS 변환은 SQL Server 스키마(T-SQL 저장 프로시저 포함)를 한 번에 하나의 데이터베이스인 Aurora PostgreSQL로 변환합니다. 단일 데이터베이스가 자동으로 변환됩니다. 데이터베이스가 여러 개인 경우 변환할 데이터베이스를 선택합니다. 데이터베이스는 독립적으로 병렬로 변환됩니다.

5. 대상 프로비저닝 - 변환된 각 데이터베이스에 대해 AWS 변환은 AWS 계정에 Amazon Aurora PostgreSQL 클러스터를 생성하거나 재사용합니다. 안내 프롬프트를 통해 네트워킹 및 대상 구성을 선택합니다.

6. 스키마 배포 - AWS 변환은 변환된 스키마를 Aurora 클러스터에 적용합니다. 배포 후 채팅 또는 IDE의 나머지 객체를 수정하거나 합성 테스트 데이터(사용 가능한 경우)를 생성하거나 완료합니다.

7. 애플리케이션 코드 현대화(선택 사항) - AWS 변환은 Aurora PostgreSQL에서 작동하도록 연결된 .NET 6+ 애플리케이션을 업데이트할 수 있습니다. 이 서비스는 소스 코드의 데이터베이스 연결을 업데이트하고 사람이 감독하는 통합 워크플로에서 Aurora PostgreSQL과 호환되도록 Entity Framework 및 ADO.NET ORM 코드를 수정합니다. GitHub 및 GitLab용 AWS CodeConnections 또는 PAT(Personal Access Token)를 사용하여 소스 코드 리포지토리를 연결하거나 소스 코드가 포함된 zip 파일에 S3 URI를 제공합니다.

참고

Amazon Aurora PostgreSQL은이 워크플로에서 지원되는 유일한 대상 엔진입니다.

오프라인 워크플로에 대한 서비스 제한

오프라인 워크플로에는 다음과 같은 기본 제한이 적용됩니다. 일부 제한은 계정별로 구성할 수 있습니다. AWS 계정 팀에 문의하여 증가를 요청하십시오.

Limit	기본값	적용 대상
작업당 업로드 크기	1,024MB(1GB), 작업의 모든 업로드에서 누적	DDL 파일 업로드
월별로 변환된 데이터베이스	계정당 10	스키마 변환
데이터베이스당 저장 프로시저	250	스키마 변환
동시 스키마 변환	한 번에 데이터베이스 5개	스키마 변환
동시 실행 작업	5	계정당

• 업로드 크기 제한은 작업당 누적 예산입니다. 입력 설정을 재설정하면 예산이 지워집니다(이렇게 하면 이미 업로드된 파일이 삭제되고 동일한 작업 내에서 검색 및 평가가 다시 실행됨).

• 변환할 데이터베이스를 5개 이상 선택하면 추가 데이터베이스가 대기열에 추가되고 변환 실행이 완료되면 자동으로 시작됩니다.

• stored-procedure-per-database 제한으로 인해 평가가 차단되지 않으며 스키마 변환만 영향을 받습니다.

오프라인 워크플로 문제 해결

추출 스크립트

• pwsh: command not found (macOS/Linux) - PowerShell 7+가 설치되지 않았습니다. 이를 설치하고를 실행합니다pwsh ./ExtractDatabaseMetadata.ps1.

• 참조 오류 sqlcmd- sqlcmd 유틸리티가 PATH에 없습니다. 이를 설치하고 PATH에 있는지 확인합니다.

• 로그인 또는 권한 오류 - VIEW SERVER STATE 및에서 SQL Server 인증 로그인을 사용합니다VIEW ANY DEFINITION. Windows/도메인 인증은 지원되지 않습니다.

• 내보낸 일부 데이터베이스만 - 포함 목록에서 범위를 좁혔습니다. 없이 다시 실행하거나 올바른 쉼표로 구분된 데이터베이스 이름을 지정합니다.

업로드

• 크기 메시지와 함께 업로드가 거부됨 - 작업당 업로드 예산을 초과했습니다. 더 작은 파일을 업로드하거나 에이전트에게 입력 설정을 재설정하여 동일한 작업 내에서 예산을 지우도록 요청합니다. 에이전트에게 추정하는 대신 현재 남은 예산을 요청합니다.

• 파일 수락되지 않음 - 스크립트에서 .zip 생성된 또는 개별 .sql 파일을 업로드합니다. 여러 파일을 단일 아카이브로 압축합니다.

Discovery

• SQL 구문 문제가 감지됨 - 문제 보고서를 다운로드합니다. 오류가 없는 섹션의 객체는 여전히 카탈로그화되어 있습니다. 구문 분석된 객체를 계속하려면를 선택하고, 특정 데이터베이스를 선택하거나, 수정된 파일을 업로드합니다.

• 일반 이름으로 그룹화된 객체 - 구문 분석기가 USE [Database] 문을 찾을 수 없습니다. 메시지가 표시되면 올바른 데이터베이스 이름을 입력합니다.

• 객체를 찾을 수 없음 - 파일에 CREATE 문이 없거나 모두 구문 분석에 실패했습니다. 유효한 DDL을 다시 업로드합니다.

평가

• LOE 추정치 조회 -를 선택하여 LOE 점수를 사용자 지정하고, 템플릿을 편집하고, 다시 업로드하여 평가를 다시 생성합니다.

• 누락된 객체 - 추가 SQL 파일을 업로드하도록 선택합니다. 검색 및 평가가 자동으로 다시 실행됩니다.

스키마 변환

• 데이터베이스 변환 실패 - AWS 변환은 이유를 보고합니다. 에 재시도를 요청하는 회신. 해당 데이터베이스에 대해 변환이 다시 시작됩니다.

• 응답이 잘못된 데이터베이스로 이동 - 여러 데이터베이스가 입력을 기다리는 경우 메시지가 있는 데이터베이스를 지정합니다. 를 사용하여 특정 데이터베이스를 처리할 수 있습니다@DatabaseName:.

대상 프로비저닝 및 배포

• Aurora 클러스터를 생성할 수 없음 - 안내형 자격 증명 및 네트워킹 프롬프트를 완료하고 계정에 Aurora PostgreSQL을 생성할 수 있는 권한이 있는지 확인합니다.

• 일부 객체가 배포되지 않음 - 배포 후 옵션을 사용하여 채팅 또는 IDE의 나머지 객체를 수정한 다음 재배포합니다.