As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Funções escalares
<a name="sql-functions-scalar"></a>

 As funções escalares usam um ou mais valores de entrada e retornam um único valor de saída. Eles são amplamente usados em SQL (Structured Query Language) para manipulação e recuperação de dados, melhorando a eficiência das tarefas de processamento de dados. 

**Topics**
+ [Funções de dados nulos](sql-functions-null.md)
+ [Funções de string](sql-functions-string.md)
+ [Funções matemáticas](sql-functions-math.md)
+ [Funções de data e hora](sql-functions-date.md)
+ [Funções de conversão de tipos](sql-functions-type-conv.md)

# Funções de dados nulos
<a name="sql-functions-null"></a>

 As funções de dados nulos manipulam ou manipulam valores NULL, que representam a ausência de um valor. As funções permitem que você NULLs substitua por outros valores, verifique se um valor é NULL ou execute operações que manipulam de uma NULLs maneira específica. 


|  **Função**  |  **Assinatura**  |  **Descrição**  | 
| --- | --- | --- | 
|  `COALESCE`  |   COALESCE (expressão 1, expressão 2,..., expressão N)   |  Se todas as expressões forem avaliadas como nulas, COALESCE retornará null. As expressões devem ser do mesmo tipo.  | 

**Example de uma função COALESCE**  

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

# Funções de string
<a name="sql-functions-string"></a>

 As funções de string são ferramentas integradas usadas para manipular e processar dados de texto. Eles permitem tarefas como concatenação, extração, formatação e pesquisa em cadeias de caracteres. Essas funções são essenciais para limpar, transformar e analisar dados baseados em texto em um banco de dados. 


**Funções de string**  

|  **Função**  |  **Assinatura**  |  **Descrição**  | 
| --- | --- | --- | 
|  `LENGTH`  |   COMPRIMENTO (string)   |  Retorna o comprimento da string.  | 
|  `CONCAT`  |   CONCAT (string, string)   |  Concatena argumentos em uma string.  | 
|  `SUBSTR`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-string.html)  |  Retorna uma das seguintes opções: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-string.html) Usa indexação baseada em 1 para o parâmetro inicial.  | 
|  `UPPER`  |   UPPER (sequência de caracteres)   |  Converte os caracteres na string de entrada em maiúsculas.  | 
|  `LOWER`  |   LOWER (sequência de caracteres)   |  Converte os caracteres na string de entrada em minúsculas.  | 
|  `TRIM`  |   TRIM (sequência de caracteres)   |  Remove qualquer caractere de espaço do início, do fim ou dos dois lados da string.  | 
|  `LTRIM`  |   LTRIM (sequência de caracteres)   |  Remove qualquer caractere de espaço do início da string.  | 
|  `RTRIM`  |   RTRIM (sequência de caracteres)   |  Remove qualquer caractere de espaço do final da string.  | 
|  `STR_REPLACE`  |   STR\$1REPLACE (string, de, para)   |  Substitui todas as ocorrências da substring especificada por outra substring especificada.  | 

Exemplos de todas as funções:


|  **Função**  |  **Exemplo**  | 
| --- | --- | 
|  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/pt_br/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`   | 

## Operador de concatenação
<a name="sql-operators-concatenation"></a>

 O operador de concatenação`||`, ou operador de tubulação, une duas cadeias de caracteres. Ele fornece uma alternativa à `CONCAT` função e é mais legível ao combinar várias cadeias de caracteres.

**Example do operador de concatenação**  

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

# Funções matemáticas
<a name="sql-functions-math"></a>

 As funções matemáticas são operações matemáticas predefinidas usadas em consultas SQL para realizar cálculos em dados numéricos. Eles fornecem maneiras de manipular e transformar dados sem precisar extraí-los do banco de dados e processá-los separadamente. 


**Funções matemáticas**  

|  **Função**  |  **Assinatura**  |  **Descrição**  | 
| --- | --- | --- | 
|  `POWER`  |  POTÊNCIA (int\$1double, int\$1double)  |  Retorna o valor do primeiro argumento elevado à potência do segundo argumento.  | 
|  `ROUND`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-math.html)  |  Arredonda para o número inteiro mais próximo.  | 
|  `FLOOR`  |   PISO (int\$1double)   |  Retorna o maior número inteiro não maior que o valor fornecido.  | 

Exemplos de todas as funções:


|  **Função**  |  **Exemplo**  | 
| --- | --- | 
|  POWER  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-math.html)  | 
|  ROUND  |   `ROUND (32.12435, 3)`   | 
|  FLOOR  |   `FLOOR (21.2)`   | 

# Funções de data e hora
<a name="sql-functions-date"></a>

 As funções de data e hora funcionam com datas e horas. Essas funções permitem a extração de componentes específicos de uma data, realizar cálculos e manipular valores de data.

Os identificadores permitidos nessas funções são:
+ YEAR
+ MONTH
+ DAY
+ HOUR
+ MINUTE
+ SECOND


|  **Função**  |  **Assinatura**  |  **Descrição**  | 
| --- | --- | --- | 
|  `NOW`  |   AGORA ()   |  Retorna o timestamp atual com precisão de milissegundos. Ele fornece a hora exata no momento em que é executado em uma consulta.  | 
|  `DATE_ADD`  |  DATE\$1ADD (identificador, intervalo\$1duração, coluna)  |  Retorna a soma de a date/time e um número de days/hours, or of a date/time and date/time intervalos.  | 
|  `DATE_SUB`  |  DATE\$1SUB (identificador, intervalo\$1duração, coluna)  |  Retorna a diferença entre um date/time e um número de days/hours, or between a date/time and date/time intervalos.  | 
|  `TIMESTAMP_ADD`  |  TIMESTAMP\$1ADD (identificador, intervalo\$1duração, coluna)  |  Adiciona um intervalo de tempo, nas unidades de tempo fornecidas, a uma expressão de data e hora.  | 
|  `TIMESTAMP_SUB`  |  TIMESTAMP\$1SUB (identificador, intervalo\$1duração, coluna)  |  Subtrai um intervalo de tempo, nas unidades de tempo fornecidas, de uma expressão de data e hora.  | 
|  `CAST`  |  CAST (expressão AS, padrão TIMESTAMP FORMAT)  |  Converte uma expressão de string em um timestamp usando o padrão de formato especificado. Os padrões comuns incluem `'yyyy-MM-dd HH:mm:ss'` o formato padrão de data e hora. Por exemplo, `SELECT CAST('2023-12-25 14:30:00' AS TIMESTAMP) AS converted_timestamp`.  | 

**Example de uma consulta SQL usando as funções listadas:**  

```
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
```

# Funções de conversão de tipos
<a name="sql-functions-type-conv"></a>

 As funções de conversão de tipo são usadas para alterar o tipo de dados de um valor de um para outro. Eles são essenciais para garantir a compatibilidade dos dados e realizar operações que exigem dados em um formato específico. 


|  **Função**  |  **Assinatura**  |  **Descrição**  | 
| --- | --- | --- | 
|  `TO_DATE`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `TO_TIMESTAMP`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `TO_TIME`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `CAST`  |  ELENCO (<expression>AS<data type>)  |  Converte uma entidade ou expressão que é avaliada como um único valor, de um tipo para outro. Os tipos de dados compatíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 

**Example de uma consulta SQL usando as funções listadas:**  

```
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
```