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

# 스칼라 함수
<a name="sql-functions-scalar"></a>

 스칼라 함수는 하나 이상의 입력 값을 가져와 단일 출력 값을 반환합니다. SQL(구조화된 쿼리 언어)에서 데이터 조작 및 검색에 널리 사용되므로 데이터 처리 작업의 효율성이 향상됩니다.

**Topics**
+ [Null 데이터 함수](sql-functions-null.md)
+ [문자열 함수](sql-functions-string.md)
+ [수학 함수](sql-functions-math.md)
+ [날짜 시간 함수](sql-functions-date.md)
+ [유형 변환 함수](sql-functions-type-conv.md)

# Null 데이터 함수
<a name="sql-functions-null"></a>

 Null 데이터 함수는 값이 없음을 나타내는 NULL 값을 처리하거나 조작합니다. 함수를 사용하면 NULLs을 다른 값으로 바꾸거나, 값이 NULL인지 확인하거나, 특정 방식으로 NULLs 처리하는 작업을 수행할 수 있습니다.


|  **함수**  |  **Signature**  |  **설명**  | 
| --- | --- | --- | 
|  `COALESCE`  |   COALESCE(expression1, expression2, ..., expressionN)   |  모든 표현식이 null로 평가되면 COALESCE는 null을 반환합니다. 표현식은 유형이 동일해야 합니다.  | 

**Example COALESCE 함수의**  

```
SELECT COALESCE (l.double_value, 100) AS non_double_value FROM latest_value_time_series AS l LIMIT 1
```

# 문자열 함수
<a name="sql-functions-string"></a>

 문자열 함수는 텍스트 데이터를 조작하고 처리하는 데 사용되는 기본 도구입니다. 문자열 내에서 연결, 추출, 형식 지정 및 검색과 같은 작업을 활성화합니다. 이러한 함수는 데이터베이스 내에서 텍스트 기반 데이터를 정리, 변환 및 분석하는 데 필수적입니다.


**문자열 함수**  

|  **함수**  |  **Signature**  |  **설명**  | 
| --- | --- | --- | 
|  `LENGTH`  |   길이(문자열)   |  문자열의 길이를 반환합니다.  | 
|  `CONCAT`  |   CONCAT(문자열, 문자열)   |  문자열의 인수를 연결합니다.  | 
|  `SUBSTR`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-string.html)  |  다음 중 하나를 반환합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-string.html) 시작 파라미터에 1 기반 인덱싱을 사용합니다.  | 
|  `UPPER`  |   UPPER(문자열)   |  입력 문자열의 문자를 대문자로 변환합니다.  | 
|  `LOWER`  |   LOWER(문자열)   |  입력 문자열의 문자를 소문자로 변환합니다.  | 
|  `TRIM`  |   TRIM(문자열)   |  문자열의 시작, 끝 또는 양쪽에서 공백 문자를 제거합니다.  | 
|  `LTRIM`  |   LTRIM(문자열)   |  문자열의 시작 부분에서 공백 문자를 제거합니다.  | 
|  `RTRIM`  |   RTRIM(문자열)   |  문자열 끝에서 공백 문자를 제거합니다.  | 
|  `STR_REPLACE`  |   STR\$1REPLACE(문자열, 시작, 종료)   |  지정된 하위 문자열의 모든 발생을 다른 지정된 하위 문자열로 바꿉니다.  | 

모든 함수의 예:


|  **함수**  |  **예제**  | 
| --- | --- | 
|  LENGTH  |  `SELECT LENGTH(a.asset_id) AS asset_id_length FROM asset AS a`  | 
|  CONCAT  |   `SELECT CONCAT(p.property_id, p.property_name) FROM asset_property AS p`   | 
|  SUBSTR  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-string.html)  | 
|  UPPER  |   `SELECT UPPER(d.string_value) AS up_string FROM raw_time_series AS d`   | 
|  LOWER  |   `SELECT LOWER(d.string_value) AS low_string FROM raw_time_series AS d`   | 
|  TRIM  |   `SELECT TRIM(d.string_value) AS tm_string FROM raw_time_series AS d`   | 
|  LTRIM  |   `SELECT LTRIM(d.string_value) AS ltrim_string FROM raw_time_series AS d`   | 
|  RTRIM  |   `SELECT RTRIM(d.string_value) AS rtrim_string FROM raw_time_series AS d`   | 
|  STR\$1REPLACE  |   `SELECT STR_REPLACE(d.string_value, 'abc', 'def') AS replaced_string FROM raw_time_series AS d`   | 

## 연결 연산자
<a name="sql-operators-concatenation"></a>

 연결 연산자 `||`또는 파이프 연산자는 두 문자열을 함께 조인합니다. `CONCAT` 함수에 대한 대안을 제공하며 여러 문자열을 결합할 때 더 읽기 쉽습니다.

**Example 연결 연산자의**  

```
SELECT a.asset_name || ' - ' || p.property_name 
  AS full_name
  FROM asset a, asset_property p
```

# 수학 함수
<a name="sql-functions-math"></a>

 수학 함수는 SQL 쿼리 내에서 숫자 데이터에 대한 계산을 수행하는 데 사용되는 사전 정의된 수학 작업입니다. 데이터베이스에서 데이터를 추출하여 별도로 처리할 필요 없이 데이터를 조작하고 변환할 수 있는 방법을 제공합니다.


**수학 함수**  

|  **함수**  |  **Signature**  |  **설명**  | 
| --- | --- | --- | 
|  `POWER`  |  POWER(int\$1double, int\$1double)  |  두 번째 인수의 출력에 대해 제기된 첫 번째 인수의 값을 반환합니다.  | 
|  `ROUND`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-math.html)  |  가장 가까운 정수로 반올림합니다.  | 
|  `FLOOR`  |   바닥(int\$1double)   |  지정된 값보다 크지 않은 가장 큰 정수를 반환합니다.  | 

모든 함수의 예:


|  **함수**  |  **예제**  | 
| --- | --- | 
|  POWER  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-math.html)  | 
|  ROUND  |   `ROUND (32.12435, 3)`   | 
|  FLOOR  |   `FLOOR (21.2)`   | 

# 날짜 시간 함수
<a name="sql-functions-date"></a>

 날짜 시간 함수는 날짜 및 시간과 함께 작동합니다. 이러한 함수를 사용하면 날짜의 특정 구성 요소를 추출하고, 계산을 수행하고, 날짜 값을 조작할 수 있습니다.

이러한 함수에서 허용되는 식별자는 다음과 같습니다.
+ YEAR
+ MONTH
+ DAY
+ 시간
+ 분
+ SECOND


|  **함수**  |  **Signature**  |  **설명**  | 
| --- | --- | --- | 
|  `NOW`  |   지금()   |  현재 타임스탬프를 밀리초 정밀도로 반환합니다. 쿼리 내에서 실행되는 정확한 시간을 제공합니다.  | 
|  `DATE_ADD`  |  DATE\$1ADD(식별자, interval\$1duration, 열)  |  날짜/시간과 일/시간 수 또는 날짜/시간 및 날짜/시간 간격의 합계를 반환합니다.  | 
|  `DATE_SUB`  |  DATE\$1SUB(식별자, interval\$1duration, 열)  |  날짜/시간과 일/시간 수 간의 차이 또는 날짜/시간과 날짜/시간 간격 간의 차이를 반환합니다.  | 
|  `TIMESTAMP_ADD`  |  TIMESTAMP\$1ADD(식별자, interval\$1duration, 열)  |  지정된 시간 단위로 날짜/시간 표현식에 시간 간격을 추가합니다.  | 
|  `TIMESTAMP_SUB`  |  TIMESTAMP\$1SUB(식별자, interval\$1duration, 열)  |  지정된 시간 단위의 시간 간격을 날짜/시간 표현식에서 뺍니다.  | 
|  `CAST`  |  CAST(Expression AS TIMESTAMP FORMAT 패턴)  |  지정된 형식 패턴을 사용하여 문자열 표현식을 타임스탬프로 변환합니다. 일반적인 패턴에는 표준 날짜/시간 형식`'yyyy-MM-dd HH:mm:ss'`에 대한가 포함됩니다. 예: `SELECT CAST('2023-12-25 14:30:00' AS TIMESTAMP) AS converted_timestamp`  | 

**Example 나열된 함수를 사용하는 SQL 쿼리의 :**  

```
SELECT r.asset_id, r.int_value,
  date_add(DAY, 7, r.event_timestamp) AS date_in_future,
  date_sub(YEAR, 2, r.event_timestamp) AS date_in_past,
  timestamp_add(DAY, 2, r.event_timestamp) AS timestamp_in_future,
  timestamp_sub(DAY, 2, r.event_timestamp) AS timestamp_in_past,
  now() AS time_now
FROM raw_time_series AS r
```

# 유형 변환 함수
<a name="sql-functions-type-conv"></a>

 유형 변환 함수는 값의 데이터 유형을 한에서 다른 로 변경하는 데 사용됩니다. 이는 데이터 호환성을 보장하고 특정 형식의 데이터가 필요한 작업을 수행하는 데 필수적입니다.


|  **함수**  |  **Signature**  |  **설명**  | 
| --- | --- | --- | 
|  `TO_DATE`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `TO_TIMESTAMP`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `TO_TIME`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `CAST`  |  CAST(<expression> AS <data type>)  |  한 유형에서 다른 유형으로 단일 값으로 평가되는 개체 또는 표현식을 변환합니다. 지원되는 데이터 형식은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 

**Example 나열된 함수를 사용하는 SQL 쿼리의 :**  

```
SELECT TO_TIMESTAMP (100) AS timestamp_value,
  TO_DATE(r.event_timestamp) AS date_value,
  TO_TIME(r.event_timestamp) AS time_value
FROM raw_time_series AS r
```