# 사용자 지정 시각적 변환 시작하기
<a name="custom-visual-transform-getting-started"></a>

 사용자 지정 시각적 변환을 생성하려면 다음 단계를 따라야 합니다.
+  1단계. JSON 구성 파일 생성 
+  2단계. 변환 로직 구현 
+  3단계. 사용자 지정 시각적 변환 검증 
+  4단계. 필요에 따라 사용자 지정 시각적 변환 업데이트 
+  5단계. AWS Glue Studio에서 사용자 지정 시각적 변환 사용 

 Amazon S3 버킷을 설정하여 시작하고 **1단계로 진행합니다. JSON 구성 파일을 생성합니다.**

## 사전 조건
<a name="custom-visual-transform-prerequisites"></a>

 고객이 제공한 변환은 고객 AWS 계정 내에 있습니다. 해당 계정은 변환을 소유하므로 변환 내용을 보거나(검색 및 사용) 편집하거나 삭제할 수 있는 모든 권한을 가집니다.

 AWS Glue Studio에서 사용자 지정 변환을 사용하려면 다음 두 파일을 생성하여 해당 AWS 계정의 Amazon S3 자산 버킷에 업로드해야 합니다.
+  **Python 파일** - 변환 함수를 포함합니다.
+  **JSON 파일** - 변환을 설명합니다. 이 파일은 변환을 정의하는 데 필요한 구성 파일이라고도 합니다.

 파일을 함께 연결하려면 두 파일에 동일한 이름을 사용하세요. 예제: 
+  myTransform.json 
+  myTransform.py 

 선택적으로 아이콘이 포함된 **SVG 파일**을 제공하여 사용자 지정 시각적 변환에 사용자 지정 아이콘을 제공할 수 있습니다. 파일을 함께 페어링하려면 아이콘에서 동일한 이름을 사용합니다.
+  myTransform.svg 

 AWS Glue Studio에서는 각 파일 이름을 사용하여 자동으로 일치시킵니다. 기존 모듈의 파일 이름은 같을 수 없습니다.

## 변환 파일 이름에 대한 권장 규칙
<a name="custom-visual-transform-recommended-transform-file-name"></a>

 AWS Glue Studio에서는 파일을 작업 스크립트에 모듈(예: `import myTransform`)로 가져옵니다. 따라서 파일 이름은 Python 변수 이름(식별자)에 설정된 것과 동일한 이름 지정 규칙을 따라야 합니다. 특히 문자 또는 밑줄로 시작하고 그 뒤에는 문자, 숫자 및/또는 밑줄로만 구성되어야 합니다.

**참고**  
 예기치 못한 런타임 문제를 방지하려면 변환 파일 이름이 기존에 로드된 Python 모듈(예: `sys, array, copy` 등)과 충돌하지 않는지 확인하세요.

## Amazon S3 버킷 설정
<a name="custom-visual-transform-setting-up-s3"></a>

 생성된 변환은 Amazon S3에 저장되며 사용자 AWS 계정에서 소유합니다. 모든 작업 스크립트가 현재 저장되어 있는 Amazon S3 자산 폴더(예: `s3://aws-glue-assets-<accountid>-<region>/transforms`)에 파일(json 및 py)을 업로드하면 새로운 사용자 지정 시각적 변환이 자동으로 생성됩니다. 사용자 지정 아이콘을 사용하는 경우 아이콘도 업로드합니다. 기본적으로 AWS Glue Studio에서는 동일한 S3 버킷의 /transforms 폴더에서 모든 .json 파일을 읽습니다.