# UDF 쿼리 구문을 사용한 쿼리
<a name="udf-query-syntax"></a>

`USING EXTERNAL FUNCTION` 절은 쿼리의 후속 `SELECT` 문에서 참조할 수 있는 단일 UDF 또는 여러 UDF를 지정합니다. UDF의 메서드 이름과 UDF를 호스팅하는 Lambda 함수의 이름이 필요합니다. Lambda 함수 이름 대신 Lambda ARN을 사용할 수 있습니다. 크로스 계정 시나리오에서는 Lambda ARN이 필요합니다.

## 시놉시스
<a name="udf-synopsis"></a>

```
USING EXTERNAL FUNCTION UDF_name(variable1 data_type[, variable2 data_type][,...])
RETURNS data_type
LAMBDA 'lambda_function_name_or_ARN'
[, EXTERNAL FUNCTION UDF_name2(variable1 data_type[, variable2 data_type][,...]) 
RETURNS data_type 
LAMBDA 'lambda_function_name_or_ARN'[,...]]
SELECT  [...] UDF_name(expression) [, UDF_name2(expression)] [...]
```

## 파라미터
<a name="udf-parameters"></a>

**USING EXTERNAL FUNCTION *UDF\$1name*(*variable1* *data\$1type*[, *variable2* *data\$1type*][,...])**  
*UDF\$1name*은 참조된 Lambda 함수 내에서 Java 메서드에 해당하는 UDF의 이름을 지정합니다. 각 *variable data\$1type*은 UDF가 입력으로 수락하는 명명된 변수와 해당 데이터 형식을 지정합니다. *data\$1type*은 다음 표에 나열된 지원되는 Athena 데이터 형식 중 하나여야 하며 해당 Java 데이터 형식에 매핑되어야 합니다.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/udf-query-syntax.html)

**RETURNS *data\$1type***  
`data_type`은 UDF가 출력으로 반환하는 SQL 데이터 형식을 지정합니다. 위의 표에 나열된 Athena 데이터 형식이 지원됩니다. `DECIMAL` 데이터 형식의 경우 *precision*과 *scale*이 정수인 `RETURNS DECIMAL(precision, scale)` 구문을 사용합니다.

**LAMBDA '*lambda\$1function*'**  
*lambda\$1function*은 UDF를 실행할 때 호출되는 Lambda 함수의 이름을 지정합니다.

**SELECT [...] *UDF\$1name*(*expression*) [...]**  
UDF에 값을 전달하고 결과를 반환하는 `SELECT` 쿼리입니다. *UDF\$1name*은 사용할 UDF를 지정하며, 값을 전달하기 위해 평가되는 *expression*이 뒤에 옵니다. 전달되고 반환되는 값은 `USING EXTERNAL FUNCTION` 절의 UDF에 대해 지정된 해당 데이터 유형과 일치해야 합니다.

### 예제
<a name="udf-examples"></a>

GitHub의 [AthenaUDFHandler.java](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-udfs/src/main/java/com/amazonaws/athena/connectors/udfs/AthenaUDFHandler.java) 코드에 기반한 쿼리 예제는 GitHub [Amazon Athena UDF 커넥터](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-udfs)페이지를 참조하세요.