변환 규칙 생성 변환 규칙 검색 변환 규칙 편집 변환 규칙 형식 변환 규칙 예제

DMS Schema Conversion의 변환 규칙

변환 규칙을 사용하면 DMS Schema Conversion이 데이터베이스 객체를 변환하여 기본 이름 지정 및 데이터 유형 매핑을 재정의하는 방법을 사용자 지정할 수 있습니다. 이러한 규칙을 데이터베이스, 스키마, 테이블, 뷰, 열, 함수 반환 값, 루틴 파라미터 및 로컬 변수에 적용할 수 있습니다.

예를 들면, 소스 스키마에 test_TABLE_NAME이라는 테이블 집합이 있다고 가정해 보세요. 대상 스키마의 접두사 test_를 접두사 demo_로 변경하는 규칙을 설정할 수 있습니다.

다음 작업을 수행하는 변환 규칙을 생성할 수 있습니다.

접두사 추가, 제거 또는 교체
접미사 추가, 제거 또는 교체
열의 데이터 유형, 함수 반환 값, 루틴 파라미터 또는 로컬 변수 변경
객체 이름을 소문자 또는 대문자로 변환
객체 이름 바꾸기

변환 규칙 생성

DMS Schema Conversion은 변환 규칙을 마이그레이션 프로젝트의 일부로 저장합니다. 변환 규칙을 정의하려면 마이그레이션 프로젝트를 생성하거나 수정할 때 rules 배열이 있는 객체가 포함된 JSON 문자열로 전달합니다. 배열의 각 요소는 별도의 규칙 객체를 나타냅니다. 마이그레이션 프로젝트는 최대 512개의 변환 규칙(최대 128KB)을 지원합니다.

변환 규칙이 있는 배열의 구조는 다음과 같습니다.


{
  "rules": [
    {
      Rule object 1
    },
    {
      Rule object 2
    },
    ...
    {
      Rule object N
    }
  ]
}

프로젝트에 여러 변환 규칙을 추가할 수 있습니다. 변환 중에 DMS Schema Conversion은 변환 규칙을 추가한 순서와 동일한 순서로 적용합니다.

여러 규칙이 동일한 객체를 대상으로 하는 경우 동작은 작업 유형에 따라 달라집니다. 작업 유형이 다른 규칙이 모두 적용됩니다. 예를 들어 add-prefix 규칙과 add-suffix 규칙이 모두 적용됩니다. 작업 유형이 동일한 규칙은 서로 재정의되며 마지막 규칙만 적용됩니다.

변환 규칙을 생성하려면 다음 방법 중 하나를 사용합니다.

AWS Management Console

콘솔을 사용하여 변환 규칙을 생성하려면

마이그레이션 프로젝트 생성 페이지에서 변환 규칙 추가를 선택합니다. 자세한 내용은 마이그레이션 프로젝트 생성 단원을 참조하십시오.
규칙 대상에서이 규칙이 적용되는 데이터베이스 객체 유형을 선택합니다. 콘솔 마법사는 schema, table및 column 대상을 지원합니다. database 또는와 같은 다른 대상을 사용하려면 콘솔 또는 AWS CLI에서 JSON 편집기를 view사용합니다.
소스 스키마에서 스키마 입력을 선택합니다. 그런 다음이 규칙이 적용되는 소스 스키마, 테이블 및 열을 지정합니다. 정확한 이름을 사용하여 객체 하나를 선택하거나 백분율 기호(%)가 있는 패턴을 와일드카드로 사용하여 문자 수와 일치시킬 수 있습니다.
작업에서 수행할 작업을 선택합니다.
규칙 작업에 따라 추가 값을 입력합니다.
- add-prefix 또는 add-suffix - 추가할 텍스트를 입력합니다.
- remove-prefix 또는 remove-suffix - 제거할 텍스트를 입력합니다.
- replace-prefix 또는 replace-suffix - 기존 텍스트와 대체 텍스트를 입력합니다.
- rename - 객체의 새 이름을 입력합니다.
- convert-uppercase 또는 convert-lowercase - 추가 값이 필요하지 않습니다.
- change-data-type - 대상 데이터 유형 이름과 선택적으로 정밀도, 규모 또는 길이를 입력합니다.
변환 규칙 추가를 선택하여 다른 변환 규칙을 추가합니다.

규칙 추가를 완료한 후 마이그레이션 프로젝트 생성을 선택합니다.

AWS CLI

AWS CLI를 사용하여 변환 규칙을 추가하려면 다음 명령 중 하나와 함께 --transformation-rules 파라미터를 사용합니다.

create-migration-project - 새 마이그레이션 프로젝트를 생성할 때.
modify-migration-project – 기존 마이그레이션 프로젝트의 경우.

다음 예시에서는 기존 마이그레이션 프로젝트에 변환 규칙을 추가합니다.


aws dms modify-migration-project \
  --migration-project-identifier migration_project_arn \
  --transformation-rules 'json_rules'

특정 AWS 리전에서이 명령을 실행하려면와 같은 --region 파라미터를 추가합니다--region us-west-2.

기존 변환 규칙을 편집, 복제 또는 제거하려면 섹션을 참조하세요변환 규칙 편집.

변환 규칙 검색

AWS 관리 콘솔 또는 AWS CLI를 사용하여 기존 DMS Schema Conversion 마이그레이션 프로젝트에서 변환 규칙을 검색할 수 있습니다.

변환 규칙 편집

마이그레이션 프로젝트에서 변환 규칙을 편집, 추가 또는 제거하려면 다음 방법 중 하나를 사용합니다.

변환 규칙 형식

변환 규칙은 JSON 객체 필드를 사용하여 소스 객체를 대상에 상응하는 객체로 변환하는 방법을 정의합니다. 각 규칙 유형은 특정 필드 세트를 사용합니다. 작업에 적용되는 필드만 포함합니다.

다음 JSON 객체는 DMS Schema Conversion 변환 규칙을 설명합니다.


{
  "rule-type": "transformation",
  "rule-id": rule_id,
  "rule-name": "rule_name",
  "rule-action": "rule_action",
  "rule-target": "rule_target",
  "object-locator": {
    [ "database-name": "database_name", ]
    [ "schema-name": "schema_name", ]
    [ "table-name": "table_name", ]
    [ "column-name": "column_name", ]
    [ "parent": "parent_name", ]
    [ "function-name": "function_name", ]
    [ "procedure-name": "procedure_name", ]
    [ "parameter-name": "parameter_name", ]
    [ "local-variable-name": "local_variable_name", ]
    [ "type": "source_data_type", ]
    [ "precision": source_precision, ]
    [ "scale": source_scale, ]
    [ "length": source_length ]
  },
  [ "value": "rule_value", ]
  [ "old-value": "rule_old_value", ]
  [ "data-type": {
    "type": "data_type_name",
    [ "precision": data_type_precision, ]
    [ "scale": data_type_scale, ]
    [ "length": data_type_length ]
  } ]
}

다음 표에서는 각 파라미터를 설명합니다.

파라미터	가능한 값	설명
`rule-type`	`transformation`	객체 로케이터에서 지정한 각 객체에 규칙을 적용하는 값입니다. 모든 변환 규칙에 대해이 값을 로 설정합니다`transformation`. 필수 파라미터.
`rule-id`	숫자(정수) 값입니다.	규칙을 식별하기 위한 고유한 숫자 값입니다. 필수 파라미터.
`rule-name`	영숫자 값입니다.	규칙을 식별하기 위한 고유한 이름입니다. 필수 파라미터.
`rule-action`	`add-prefix`, `remove-prefix`, `replace-prefix`, `add-suffix`, `remove-suffix`, `replace-suffix`, `convert-uppercase`, `convert-lowercase`, `rename`, `change-data-type`	객체에 적용할 변환. 모든 변환 규칙 작업은 대소문자를 구분합니다. 접두사 작업: `add-prefix` - 이름의 시작 부분에 지정된 텍스트를 추가합니다. `remove-prefix` - 이름의 시작 부분에서 지정된 텍스트를 제거합니다. `replace-prefix` - 기존 접두사를 새 접두사로 바꿉니다. 접미사 작업: `add-suffix` - 이름 끝에 지정된 텍스트를 추가합니다. `remove-suffix` - 이름 끝에서 지정된 텍스트를 제거합니다. `replace-suffix` - 기존 접미사를 새 접미사로 바꿉니다. 사례 변환: `convert-uppercase` - 이름의 모든 문자를 대문자로 변환합니다. `convert-lowercase` - 이름의 모든 문자를 소문자로 변환합니다. 직접 수정: `rename` - 이름을 완전히 새로 지정된 값으로 변경합니다. `change-data-type` - 열 또는 로컬 변수의 데이터 형식을 다른 데이터 형식으로 수정합니다. 범위: 접두사, 접미사, 이름 바꾸기 및 대/소문자 변환 작업을 스키마, 테이블 및 열에 적용할 수 있습니다. `change-data-type` 작업은 열, 함수 반환 값, 루틴 파라미터 및 로컬 변수에만 적용됩니다. 필수 파라미터.
`rule-target`	`database`, `schema`, `table`, `view`, `column`, `function result`, `routine parameter`, `local variable`	규칙이 적용될 객체의 유형입니다. `database` - 데이터베이스. `schema` - 데이터베이스 스키마입니다. `table` - 데이터베이스 테이블. `view` - 데이터베이스 보기. `column` - 데이터베이스 테이블 또는 뷰 열. `function result` - 함수 반환 값입니다. `routine parameter` - 저장 프로시저 또는 함수 파라미터입니다. `local variable` - 저장 프로시저 또는 함수 내의 로컬 변수입니다. 필수 파라미터.
`object-locator`	JSON 객체입니다.	규칙이 적용되는 소스 데이터베이스 객체를 식별하는 객체입니다. 각 `object-locator` 객체 필드에서 값의 전체 또는 일부에 대해 백분율 기호(`%`)를 와일드카드로 사용할 수 있습니다. 객체에는 다음 문자열 필드가 포함됩니다. `database-name` `schema-name` `table-name` `column-name` `parent` `function-name` `procedure-name` `parameter-name` `local-variable-name` `type` `precision` `scale` `length` 변환 규칙의 테이블 또는 열 이름과 같은 모든 객체 이름은 대/소문자를 구분합니다. 다음 섹션에서는 각 객체 필드를 설명합니다. 필수 파라미터.
`object-locator \| database-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스의 이름입니다. 데이터베이스 아키텍처가 데이터베이스에서 객체의 최상위 컨테이너로 시작되는 데이터베이스 공급업체에 적용됩니다. 예: Microsoft SQL Server, SAP ASE. 선택적 JSON 객체 필드입니다.
`object-locator \| schema-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 스키마의 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| table-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 테이블의 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| column-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 테이블 열의 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| parent`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	`function-name` 또는와 같이 지정된 객체의 상위인 소스 데이터베이스 객체의 이름입니다`procedure-name`. 일부 공급업체의 데이터베이스에서 규칙이 적용되는 객체는 하위 객체일 수 있으며 상위 객체를 지정해야 합니다. 예를 들어 Oracle에서 패키징된 함수입니다. 여기서 상위는 패키지 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| function-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 함수의 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| procedure-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 프로시저의 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| parameter-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 함수 또는 프로시저 파라미터의 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| local-variable-name`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	소스 데이터베이스 함수 또는 프로시저 내의 로컬 변수 이름입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| type`	영숫자 값입니다.	일치시킬 소스 데이터 유형 이름입니다. 이 필드를 사용하여 특정 데이터 형식의 객체에만 규칙을 적용합니다. 선택적 JSON 객체 필드입니다.
`object-locator \| precision`	숫자(정수) 값입니다.	일치시킬 소스 데이터 유형의 정밀도입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| scale`	숫자(정수) 값입니다.	일치시킬 소스 데이터 유형의 규모입니다. 선택적 JSON 객체 필드입니다.
`object-locator \| length`	숫자(정수) 값입니다.	일치시킬 소스 데이터 유형의 길이입니다. 선택적 JSON 객체 필드입니다.
`value`	대상 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	변환 작업에 사용되는 텍스트 값입니다. `add-prefix` 및에 대해 추가할 텍스트를 `add-suffix`지정합니다. `remove-prefix` 및의 경우 제거할 텍스트를 `remove-suffix`지정합니다. `replace-prefix` 및의 경우 대체 텍스트를 `replace-suffix`지정합니다. 의 경우 새 이름을 `rename`지정합니다. `convert-uppercase`, `convert-lowercase`및를 제외한 모든 작업에 필요합니다`change-data-type`.
`old-value`	소스 데이터베이스의 이름 지정 규칙을 따르는 영숫자 값입니다.	객체 이름에서 찾고 바꿀 기존 값입니다. `replace-prefix` 및와 같은 작업에 필요합니다`replace-suffix`. 선택적 파라미터입니다.
`data-type`	JSON 객체입니다.	가 일 때 대체 데이터 형식 속성을 설명하는 객체`rule-action`입니다`change-data-type`. 객체는 다음 필드를 포함합니다. `type` : 문자열 `precision` : 숫자 `scale` : 숫자 `length` : 숫자 다음 섹션에서는 각 객체 필드를 설명합니다. 선택적 파라미터입니다.
`data-type \| type`	영숫자 값입니다.	가 인 경우 대상 데이터베이스 열에 대한 대체 데이터 형식의 이름`rule-action`입니다`change-data-type`. 유효한 대상 데이터베이스 데이터 형식이어야 합니다. 필수 JSON 객체 필드입니다.
`data-type \| precision`	숫자(정수) 값입니다.	가 인 경우 대상 데이터베이스에 대한 대체 데이터 유형의 정밀도`rule-action`입니다`change-data-type`. 선택적 JSON 객체 필드입니다.
`data-type \| scale`	숫자(정수) 값입니다.	가 인 경우 대상 데이터베이스에 대한 대체 데이터 형식의 규모`rule-action`입니다`change-data-type`. 선택적 JSON 객체 필드입니다.
`data-type \| length`	숫자(정수) 값입니다.	가 인 경우 대상 데이터베이스에 대한 대체 데이터 형식의 길이`rule-action`입니다`change-data-type`. 선택적 JSON 객체 필드입니다.