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

# SQL 코드 편집기를 사용하여 구성된 테이블 쿼리
<a name="use-sql-editor"></a>

쿼리를 할 수 있는 구성원은 SQL 코드 편집기에서 SQL 코드를 작성하여 수동으로 쿼리를 작성할 수 있습니다. SQL 코드 편집기는 AWS Clean Rooms 콘솔의 **분석** 탭에 있는 **분석** 섹션에 있습니다.

SQL 코드 편집기가 기본적으로 표시됩니다. 분석 빌더를 사용하여 쿼리를 작성하려면 [분석 빌더로 쿼리](query-data-analysis-builder.md)을 참조하세요.

**중요**  
코드 편집기에서 SQL 쿼리 작성을 시작한 다음 **분석 빌더 UI**를 켜면 쿼리가 저장되지 않습니다.

AWS Clean Rooms 는 많은 SQL 명령, 함수 및 조건을 지원합니다. 자세한 내용은 [AWS Clean Rooms SQL 참조](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)의 섹션을 참조하세요.

**작은 정보**  
쿼리 실행 도중 예정된 유지 관리가 실행되면 쿼리는 종료 후 롤백됩니다. 쿼리를 다시 시작해야 합니다.

**SQL 코드 편집기를 사용하여 구성된 테이블을 쿼리하려면**

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) AWS Clean Rooms 콘솔을 엽니다.

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

1. **사용자의 멤버 자격** 상태가 **쿼리 실행**인 공동 작업을 선택합니다.

1. **분석** 탭의 **테이블**에서 테이블 목록 및 관련 분석 규칙 유형(**집계 분석 규칙**, **목록 분석 규칙** 또는 **사용자 지정 분석 규칙**)을 확인합니다.
**참고**  
목록에 예상한 테이블이 보이지 않는 경우 다음과 같은 이유가 있을 수 있습니다.  
테이블이 [연결](associate-configured-table.md)되지 않았습니다.
테이블에는 [분석 규칙이 구성](add-analysis-rule.md)되어 있지 않습니다.

1. (선택 사항) 테이블의 스키마와 분석 규칙 컨트롤을 보려면 더하기 기호 아이콘(**\$1**)을 선택하여 테이블을 확장합니다.

1. **분석** 섹션의 **분석 모드에서** **SQL 코드 쓰기**를 선택합니다.
**참고**  
**분석** 섹션은 결과를 받을 수 있는 구성원과 쿼리 컴퓨팅 비용을 지불해야 하는 구성원이 활성 구성원으로 공동 작업에 참여한 경우에만 표시됩니다.

1. SQL 코드 편집기에 쿼리를 입력하여 쿼리를 작성합니다.

   지원되는 SQL 명령 및 함수에 대한 자세한 내용은 [AWS Clean Rooms SQL 참조를 참조하세요.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)

   다음 옵션을 사용하여 쿼리를 빌드할 수도 있습니다.

------
#### [ Use an example query ]

   예제 쿼리를 사용하려면

   1. 테이블 옆의 세로로 된 세 점을 선택합니다.

   1. **편집기에 삽입**에서 **예제 쿼리**를 선택합니다.
**참고**  
**예제 쿼리**를 삽입하면 편집기에 이미 있는 쿼리에 추가됩니다.

      쿼리 예제가 나타납니다. 테이블 아래에 나열된 모든 **테이블**이 쿼리에 포함됩니다.

   1. 쿼리에서 자리 표시자 값을 편집합니다.

------
#### [ Insert column names or functions ]

   열 이름 또는 함수를 삽입하려면

   1. 열 옆에 있는 세 개의 수직 점을 선택합니다.

   1. **편집기에 삽입**에서 **열 이름**을 선택합니다.

   1. 열에 허용되는 함수를 수동으로 삽입하려면 

      1. 열 옆에 있는 세 개의 수직 점을 선택합니다.

      1. **편집기에서 삽입**을 선택합니다.

      1. 허용된 함수의 이름(예: INNER JOIN, SUM DISTINCT, 또는 SUMCOUNT)을 선택합니다.

   1. **Ctrl** \$1 **Space**를 눌러 코드 편집기에서 테이블 스키마를 볼 수 있습니다.
**참고**  
쿼리가 가능한 구성원은 구성된 각 테이블 연결의 파티션 열을 보고 사용할 수 있습니다. 구성된 AWS Glue 테이블의 기반이 되는 테이블에서 파티션 열에 파티션 열로 레이블이 지정되어 있는지 확인합니다.

   1. 쿼리에서 자리 표시자 값을 편집합니다.

------

1. 지원되는 **작업자 유형**과 **작업자 수**를 지정합니다.

   인스턴스 유형과 SQL 쿼리를 실행할 인스턴스(작업자) 수를 선택할 수 있습니다.

   CR.1X의 경우 최대 128명의 작업자 또는 최소 4명의 작업자를 선택할 수 있습니다.

   CR.4X의 경우 최대 32명의 작업자 또는 최소 4명의 작업자를 선택할 수 있습니다.

   다음 표를 사용하여 사용 사례에 필요한 유형과 수 또는 작업자를 결정합니다.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/clean-rooms/latest/userguide/use-sql-editor.html)
**참고**  
작업자 유형과 작업자 수가 다르면 관련 비용이 발생합니다. 요금에 대한 자세한 내용은 [AWS Clean Rooms 요금을](https://aws.amazon.com/clean-rooms/pricing/) 참조하세요.

1. **결과 전송 대상**에서 결과를 받을 수 있는 사람을 지정합니다.
**참고**  
결과를 수신하려면 공동 작업 구성원을 결과 수신자로 구성해야 하며 공동 작업의 활성 참가자여야 합니다(**상태: 활성**).

1. (쿼리만 가능한 구성원) **기본 결과 설정 사용 확인란이 기본적으로 선택되어 있습니다**. 기본 결과 설정을 유지하려면이 옵션을 선택한 상태로 유지합니다.

   이 쿼리에 대해 다른 결과 설정을 지정하려면 **기본 결과 설정 사용** 확인란의 선택을 취소한 후 다음을 선택합니다.

   1. **결과 형식**(**CSV** 또는 **PARQUET**)

   1. **결과 파일**(**단일** 또는 **다중**)

   1. **Amazon S3의 결과 대상**

   결과를 받을 수 있는 각 멤버는 Amazon S3에서 다른 **결과 형식**, **결과 파일** 및 결과 대상을 지정할 수 있습니다. ** Amazon S3**

1. **Spark 속성을** 지정하려면:

   1. **Spark 속성**을 확장합니다.

   1. **Spark 속성 추가**를 선택합니다.

   1. **Spark 속성** 대화 상자의 드롭다운 목록에서 **속성 이름을** 선택하고 **값을** 입력합니다.

   다음 표에서는 각 속성에 대한 정의를 제공합니다.

   Spark 속성에 대한 자세한 내용은 Apache Spark 설명서의 Spark [속성을](https://spark.apache.org/docs/latest/configuration.html#spark-properties) 참조하세요.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/clean-rooms/latest/userguide/use-sql-editor.html)

1. **실행**을 선택합니다.
**참고**  
결과를 받을 수 있는 구성원이 쿼리 결과 설정을 구성하지 않은 경우 쿼리를 실행할 수 없습니다.

1. **결과**를 확인합니다.

   자세한 내용은 [분석 결과 수신 및 사용](receive-query-results.md) 단원을 참조하십시오.

1. 계속해서 매개변수를 조정하고 쿼리를 다시 실행하거나 **\$1** 버튼을 선택하여 새 탭에서 새 쿼리를 시작합니다.

**참고**  
AWS Clean Rooms 는 명확한 오류 메시징을 제공하는 것을 목표로 합니다. 오류 메시지에 문제 해결에 도움이 되는 세부 정보가 충분하지 않은 경우 계정 팀에 문의하세요. 오류 발생 경위에 대한 설명과 오류 메시지(식별자 포함)를 제공하세요. 자세한 내용은 [문제 해결 AWS Clean Rooms](troubleshooting.md) 단원을 참조하십시오.