기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# PySpark 분석 템플릿 생성
<a name="create-pyspark-analysis-template"></a>

**참고**  
파라미터는 임의의 콘텐츠를 포함할 수 있는 사용자 제공 문자열입니다.  
코드를 검토하여 분석에서 예상치 못한 동작을 방지하기 위해 파라미터가 안전하게 처리되는지 확인합니다.
제출 시 제공되는 파라미터 값에 관계없이 안전하게 작동하도록 파라미터 처리를 설계합니다.

**사전 조건**

 PySpark 분석 템플릿을 생성하기 전에 다음이 있어야 합니다.
+ 활성 AWS Clean Rooms 공동 작업의 멤버십
+ 활성 공동 작업에서 구성된 테이블 하나 이상에 대한 액세스
+ 분석 템플릿을 생성할 수 있는 권한
+ Python 사용자 스크립트 및 S3에 생성 및 저장된 가상 환경
  + S3 버킷에 버전 관리가 활성화되어 있습니다. 자세한 내용은 [ S3 버킷에서 버전 관리 사용을 참조하세요](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html).
  + S3 버킷은 업로드된 아티팩트에 대한 SHA-256 체크섬을 계산할 수 있습니다. 자세한 내용은 [체크섬 사용을 참조하세요](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html).
+ S3 버킷에서 코드를 읽을 수 있는 권한

  필요한 서비스 역할 생성에 대한 자세한 내용은 섹션을 참조하세요[서비스 역할을 생성하여 S3 버킷에서 코드 읽기(PySpark 분석 템플릿 역할)](setting-up-roles.md#create-role-pyspark-analysis-template).

다음 절차에서는 [AWS Clean Rooms 콘솔](https://console.aws.amazon.com/cleanrooms/home)을 사용하여 PySpark 분석 템플릿을 생성하는 프로세스를 설명합니다. 사용자 스크립트와 가상 환경 파일을 이미 생성하고 사용자 스크립트와 가상 환경 파일을 Amazon S3 버킷에 저장했다고 가정합니다.

**참고**  
PySpark 분석 템플릿을 생성하는 구성원도 결과를 수신하는 구성원이어야 합니다.

SDK를 사용하여 PySpark 분석 템플릿을 생성하는 방법에 대한 자세한 내용은 [AWS Clean Rooms API 참조](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)를 참조하세요. AWS SDKs

**PySpark 분석 템플릿을 생성하려면**

1. 에 로그인 AWS Management Console 하고 공동 작업 생성자 역할을 AWS 계정 할를 사용하여 [AWS Clean Rooms 콘솔](https://console.aws.amazon.com/cleanrooms/home)을 엽니다.

1. 왼쪽 탐색 창에서 **공동 작업**을 선택합니다.

1. 공동 작업을 선택합니다.

1. **템플릿** 탭에서 **직접 생성한 분석 템플릿 섹션**으로 이동합니다.

1. **분석 템플릿 생성**을 선택합니다.

1. **분석 템플릿 생성** 페이지의 **세부 정보**에서 

   1. 분석 템플릿의 **이름을** 입력합니다.

   1. (선택 사항) **설명**을 입력합니다.

   1. **형식**에서 **PySpark** 옵션을 선택합니다.

1. **정의**의 경우,

   1. 계속하기 전에 **사전 조건을** 검토하고 각 사전 조건이 충족되었는지 확인합니다.

   1. **진입점 파일에** S3 버킷을 입력하거나 ** S3 찾아보**기를 선택합니다.

   1. (선택 사항) **라이브러리 파일에** S3 버킷을 입력하거나 ** S3 찾아보**기를 선택합니다.

1. **파라미터 - 선택 사항**에서 분석 템플릿을 재사용할 수 있도록 파라미터를 추가하려면:

   1. **Add parameter(파라미터 추가)**를 선택합니다.

   1. **파라미터 이름을** 입력합니다.

      파라미터 이름은 문자 또는 밑줄로 시작하고 그 뒤에 영숫자 또는 밑줄이 와야 합니다.

   1. **유형의** 경우 PySpark 분석 템플릿에 대해 지원되는 유일한 유형으로 **STRING**이 자동으로 선택됩니다.

   1. (선택 사항) 파라미터의 **기본값을** 입력합니다.

      기본값을 제공하면 작업 실행기는 파라미터 값을 명시적으로 제공하지 않고 작업을 실행할 때이 값을 사용할 수 있습니다.

   1. 파라미터를 더 추가하려면 **다른 파라미터 추가**를 선택하고 이전 단계를 반복합니다.
**참고**  
PySpark 분석 템플릿당 최대 50개의 파라미터를 정의할 수 있습니다. 각 파라미터 값은 최대 1,000자일 수 있습니다.

1. **정의에서 참조되는 테이블의** 경우 
   + 정의에서 참조되는 모든 테이블이 공동 작업에 연결된 경우:
     + **정의에서 참조된 모든 테이블이 공동 작업 확인란에 연결된** 상태로 둡니다.
     + **공동 작업과 연결된 테이블**에서 정의에서 참조되는 모든 연결된 테이블을 선택합니다.
   + 정의에서 참조되는 모든 테이블이 공동 작업에 연결되지 않은 경우:
     + **정의에서 참조된 모든 테이블이 공동 작업과 연결되었습니다 확인란의** 선택을 취소합니다.
     + **공동 작업과 연결된 테이블**에서 정의에서 참조되는 모든 연결된 테이블을 선택합니다.
     + **나중에 연결될 테이블에** 테이블 이름을 입력합니다.
     + **다른 테이블 나열**을 선택하여 다른 테이블을 나열합니다.

1. **오류 메시지 구성**에서 다음 중 하나를 선택합니다.
   + **기본 오류 메시지** - 기본 데이터를 노출하지 않고 기본 오류 메시지를 반환합니다. 프로덕션 워크로드에 권장됩니다.
   + **자세한 오류 메시지** - 더 빠른 문제 해결을 위해 자세한 오류 메시지를 반환합니다. 개발 및 테스트 환경에서 권장됩니다. 개인 식별 정보(PII)를 포함한 민감한 데이터를 노출할 수 있습니다.
**참고**  
**세부 오류 메시지를** 사용하는 경우 모든 데이터 공급자 멤버가 템플릿에 대해이 설정을 승인해야 합니다.

1. 드롭다운 목록에서 **기존 서비스 역할 이름을 선택하여 서비스** **액세스** 권한을 지정합니다.

   1. 역할을 나열할 권한이 있는 경우 역할 목록이 표시됩니다.

      역할을 나열할 수 있는 권한이 없는 경우 사용하려는 역할의 Amazon 리소스 이름(ARN)을 입력할 수 있습니다.

   1. **IAM에서 보기** 외부 링크를 선택하여 서비스 역할을 확인합니다.

      기존 서비스 역할이 없는 경우 **기존 서비스 역할 사용** 옵션을 사용할 수 없습니다.

      기본적으로 AWS Clean Rooms 는 필요한 권한을 추가하기 위해 기존 역할 정책을 업데이트하려고 시도하지 않습니다.
**참고**  
AWS Clean Rooms 에는 분석 규칙에 따라 쿼리할 수 있는 권한이 필요합니다. 권한에 대한 자세한 내용은 섹션을 AWS Clean Rooms참조하세요[AWS 에 대한 관리형 정책 AWS Clean Rooms](security-iam-awsmanpol.md).
역할에에 대한 충분한 권한이 없는 경우 역할에에 대한 충분한 권한이 없다는 오류 메시지가 AWS Clean Rooms표시됩니다 AWS Clean Rooms. 계속하기 전에 역할 정책을 추가해야 합니다.
역할 정책을 수정할 수 없는 경우 AWS Clean Rooms 에서 서비스 역할에 대한 정책을 찾을 수 없다는 오류 메시지가 나타납니다.

1. 구성된 테이블 리소스에 대해 **태그**를 활성화하려면 **새 태그 추가**를 선택한 다음 **키**와 **값** 쌍을 입력합니다.

1. **생성(Create)**을 선택합니다.

1. 이제 공동 작업 구성원에게 [분석 템플릿을 검토할](review-analysis-template.md) 수 있음을 알릴 준비가 되었습니다. (자체 데이터를 쿼리하려는 경우 선택 사항)

**중요**  
분석 템플릿을 생성한 후에는 아티팩트(사용자 스크립트 또는 가상 환경)를 수정하거나 제거하지 마십시오.  
이렇게 하면 다음이 수행됩니다.  
이 템플릿을 사용하는 향후 모든 분석 작업이 실패합니다.
새 아티팩트가 포함된 새 분석 템플릿을 생성해야 합니다.
이전에 완료된 분석 작업에는 영향을 주지 않습니다.