Documentação do Oracle Cloud Infrastructure

Ir para o conteúdo principal

Referência de Funções (Pipeline)

As funções a seguir são usadas com os operadores de expressão e decisão em um pipeline.

Funções Aritméticas


Função	Descrição	Exemplo
`ABS(numeric)`	Retorna a potência absoluta do valor `numeric`.	`ABS(-1)`
`CEIL(numeric)`	Retorna o menor inteiro não maior que o valor `numeric`	`CEIL(-1,2)`
`EXP(numeric)`	Retorna E elevado à potência de `numeric`. A constante e é igual a `2.71828182845904`, a base do logaritmo natural.	`EXP(2)`
`FLOOR(numeric)`	Retorna o maior inteiro não maior que o valor `numeric`.	`FLOOR(-1,2)`
`MOD(numeric1, numeric2)`	Retorna o resto depois que `numeric1` é dividido por `numeric2`.	`MOD(8,2)`
`POW(numeric1, numeric2)`	Eleva `numeric1` à potência de `numeric2`.	`POW(2,3)`
`ROUND(numeric1, numeric2)`	Retorna `numeric1` arredondado para `numeric2` casas decimais.	`ROUND(2.5,0)`
`TRUNC(numeric1, numeric2)`	Retorna `numeric1` truncado em `numeric2` casas decimais.	`TRUNC(2.5,0)`
`TO_NUMBER(expr[, format, locale])`	Converte um `expr` em um número, com base em `format` e em `locale` opcional fornecidos. A configuração regional padrão é `en-US`. Tags de idioma suportadas. Padrões de formato suportados: `0`: Um dígito `#`: Um dígito, zero mostra como ausente `.`: Espaço reservado para separador decimal `,`: Espaço reservado para separador de agrupamento `E`: Separa mantissa e expoente para formatos exponenciais `-`: Prefixo negativo padrão `¤`: Sinal de moeda; substituído pelo símbolo de moeda; se duplo, substituído pelo símbolo de moeda internacional; se presente em um padrão, o separador decimal monetário é usado no lugar do separador decimal	`TO_NUMBER('5467.12') returns` retorna `5467.12` `TO_NUMBER('-USD45,677.7', '¤¤##,###.#', 'en-US')` retorna `-45677.7`
`FORMAT_NUMBER(value, format)`	Retorna uma representação formatada do valor fornecido.	`FORMAT_NUMBER(123.4567, '^-09.3f')` retorna `0123.4570`

Funções Condicionais


Função	Descrição	Exemplo
`NULLIF(value, value)`	Retorna nulo se os dois valores forem iguais, caso contrário, retorna o primeiro valor.	`NULLIF('ABC','XYZ')` retorna `ABC`
`ISNULL(value)`	Verifica o valor nulo.	`ISNULL('ABC')` retorna `false`
`ISNOTNULL(value)`	Verifica se há valor não nulo.	`ISNOTNULL('ABC')` retorna `true`

Funções de Date e Hora


Função	Descrição	Exemplo
`CURRENT_DATE`	Retorna a data atual.	`CURRENT_DATE` retorna a data de hoje
`CURRENT_TIMESTAMP`	Retorna a data e hora atuais com o fuso horário da sessão.	`CURRENT_TIMESTAMP` retorna a data de hoje e a hora atual
`DATE_ADD(date, number)`	Retorna a data que é o `number` especificado de dias após o `date` especificado.	`DATE_ADD('2017-07-30', 1)` retorna `2017-07-31`
`DATE_SUB(date, number)`	Retorna a data que é o `number` especificado de dias antes do `date` especificado.	`DATE_SUB('2017-07-30', 1)` retorna `2017-07-29`
`DATE_FORMAT(expr, format[, locale])`	Formata uma `expr` de Data, com base no `format` e no `locale` opcional fornecidos. A configuração regional padrão é `en-US`. Tags de idioma suportadas. Nas expressões do pipeline, `format` deve usar os códigos de formato strftime.	`DATE_FORMAT(2020-10-13, '%d-%m-%Y')` retorna `'13-10-2020'`. O primeiro argumento é um objeto Date que representa 13 de outubro de 2020. `DATE_FORMAT(2018-junio-17, '%d/%B/%y', 'es-ES')` retorna `'17/junio/18'`
`WEEKOFYEAR(date)`	Retorna a semana da data no ano.	`WEEKOFYEAR('2022-07-28')` retorna `30` `WEEKOFYEAR('2022-07-28 13:24:30')` retorna `30`
`TO_DATE(string, format_string[, localeStr])`	Faz parsing da expressão de string com a expressão `format_string` para uma data. A configuração regional é opcional. O padrão é `en-US`. Tags de idioma suportadas. Nas expressões do pipeline, `format_string` deve usar os códigos de formato strftime.	Exemplos de código de formato: `'%a %d-%m-%Y'` retorna `Tue 10-12-2019` `'%a %d/%m/%Y'` retorna `Tue 10/12/2019` `'%a %d/%m/%y'` retorna `Tue 10/12/19` `TO_DATE('12 June 2018', '%m/%d/%Y')` retorna `06/12/2018`
`TO_TIMESTAMP(expr, format_string[, localeStr])`	Converte um `expr` de VARCHAR em um valor de TIMESTAMP, com base no valor `format_string` e no valor `localeStr` opcional fornecidos. Nas expressões do pipeline, `format_string` deve usar os códigos de formato strftime.	`TO_TIMESTAMP('2020-10-10 11:10:10', '%A %d-%m-%Y, %H:%M:%S')` retorna um objeto TIMESTAMP que representa `Saturday 10-10-2020, 11:10:10`
`MONTHS_BETWEEN(start_date_expr, end_date_expr)`	Retorna o número de meses entre `start_date_expr` e `end_date_expr`. `start_date_expr` e `end_date_expr` podem ser uma data, um timestamp ou uma string com um formato `yyyy-MM-dd` ou `yyyy-MM-dd HH:mm:ss.SSS` Um número inteiro será retornado se as duas datas forem o mesmo dia do mês ou se ambas forem o último dia em seus respectivos meses. Caso contrário, a diferença será calculada com base em 31 dias por mês.	`MONTHS_BETWEEN('2022-01-01', '2022-01-31')` retorna 1 `MONTHS_BETWEEN('2022-07-28', '2020-07-25')` retorna 24 `MONTHS_BETWEEN('2022-07-28 13:24:30', '2020-07-25 13:24:30')` retorna 24

Funções Hierárquicas


Função	Descrição	Exemplo
`TO_MAP(string,column[,string,column]*)`	Cria uma nova coluna do tipo Map. As colunas de entrada devem ser agrupadas como pares de chave/valor. As colunas de chave de entrada não podem ser nulas e devem ter todas o mesmo tipo de dados. As colunas de valor de entrada devem todas ter o mesmo tipo de dados.	`TO_MAP('Ename',Expression_1.attribute1)` retorna uma coluna de tipo Map: `{"ENAME" -> 100}` `TO_MAP('block', EXPRESSION_1.MYSOURCE.address.block, 'unit', EXPRESSION_1.MYSOURCE.address.unit)` retorna uma coluna de tipo Map: `{"block" -> 1,"unit" -> 1}`
`TO_STRUCT(string,column[,string,column]*)`	Cria uma nova coluna do tipo Struct. As colunas de entrada devem ser agrupadas como pares de chave/valor.	`TO_STRUCT('Ename',Expression_1.attribute1)` retorna `{100}` `TO_STRUCT('Id',Expression_1.attribute1, 'Name', Expression_1.attribute2)` retorna `{100, "John"}`
`TO_ARRAY(column[,column]*)`	Cria uma nova coluna como tipo Array. As colunas de entrada devem todas ter o mesmo tipo de dados.	`TO_Array(Expression_1.attribute1)` retorna `[100]` `TO_ARRAY(EXPRESSION_1.attribute2,EXPRESSION_1.attribute3)` retorna `["John","Friend"]`

Funções do Operador (Comparação)


Função	Descrição	Exemplo
`AND`	O operador lógico AND. Retorna verdadeiro se os dois operandos forem verdadeiros; caso contrário, retorna falso.	(x = 10 AND y = 20) retorna "true" se x for igual a 10 e y for igual a 20. Se um dos dois não for verdadeiro, retornará "false"
`OR`	O operador lógico OR. Retorna verdadeiro se um operando for verdadeiro ou ambos forem verdadeiros; caso contrário, retorna falso.	(x = 10 OR y = 20) retorna "false" se x não for igual a 10 e também y não for igual a 20. Se um for verdadeiro, retornará "true"
`NOT`	O operador lógico NOT.
`IN`	Testa se uma expressão corresponde a uma lista de valores.	`FILTER_2.ORDERS.ORDER_ID IN (1003, 1007)`
`=`	Verifica a igualdade. Retorna verdadeiro se expr1 for igual a expr2; caso contrário, retorna falso.	x = 10 retorna "true" quando o valor de x é 10, caso contrário, retorna "false"
`>`	Verifica uma expressão maior que. Retorna verdadeiro se expr1 for maior que expr2.	x > 10 retorna "true" se o valor de x for maior que 10, caso contrário, retorna "false"
`>=`	Testa uma expressão maior que ou igual a. Retorna verdadeiro se expr1 for maior ou igual a expr2.	x > =10 retorna "true" se o valor de x for maior ou igual a 10, caso contrário, retorna "false"
`<`	Testa uma expressão menor que. Retorna verdadeiro se expr1 for menor que expr2.	x < 10 retorna "true" se o valor de x for menor que 10, caso contrário, retornará "false"
`<=`	Testa uma expressão menor que ou igual a. Retorna verdadeiro se expr1 for menor ou igual a expr2.	x <= 10 retorna "true" se o valor de x for menor que 10, caso contrário, retorna "false"

Funções da String


Funções	Descrição	Exemplo
`CAST(value AS type)`	Retorna o valor especificado no tipo especificado.	`CAST("10" AS INT)` retorna `10`
`CONCAT(string, string)`	Retorna os valores combinados de strings ou colunas	`CONCAT('Oracle','SQL')` retorna `OracleSQL`
`LOWER(string)`	Retorna a string com todas as letras alteradas para minúsculas.	`LOWER('ORACLE')` retorna `oracle`
`LENGTH(string)`	Retorna o tamanho do caractere da string ou o número de bytes de dados binários. O tamanho da string inclui espaços à direita.	`LENGTH('Oracle')` retorna `6`
`LTRIM(string)`	Retorna a string com espaços à esquerda removidos.	`LTRIM(' Oracle')`
`REGEXP_EXTRACT(string, regexp[, RegexGroupIdx])`	Extrai um grupo que corresponde à expressão regular.	`REGEXP_EXTRACT('22;33;44', '([0-9.]);([0-9.]);([0-9.]*)', 1)` retorna `22`
`REGEXP_SUBSTR(string, regexp[, RegexGroupIdx])`	Pesquisa e extrai a string que corresponde a um padrão de expressão regular da string de entrada. Se o índice do grupo de captura opcional for informado, a função extrairá o grupo específico.	`REGEXP_SUBSTR('https://www.oracle.com/products', 'https://([[:alnum:]]+\.?){3,4}/?')` retorna `https://www.oracle.com` `REGEXP_SUBSTR('22;33;44', '([0-9.]);([0-9.]);([0-9.]*)', 1)` retorna `22`
`REGEXP_REPLACE(string, regexp, rep])`	Substitui todas as substrings da string que correspondem à expressão regular pelo rep
`REPLACE(string, search, replacement)`	Substitui todas as ocorrências de `search` por `replacement`. Se `search` não for encontrado na string, ela será retornada inalterada. Se `replacement` não for especificado ou for uma string vazia, nada substituirá `search` que é removido de `string`.	`REPLACE('input string value', 'input', 'output')` retorna "`output string value`". Por exemplo: `REPLACE('ABCabc', 'abc', 'DEF')` retorna `ABCDEF`
`RTRIM(string)`	Retorna a string com espaços à esquerda removidos da direita.	`RTRIM('Oracle ')`
`SUBSTRING(string, start_position[, substring_length])`	Retorna a substring de `string` começando no `start_position` fornecido com o tamanho `substring_length`. A numeração da posição de deslocamento começa com 0.	`SUBSTRING('Hello Oracle', 6, 6)` retorna `Oracle`
`TO_CHAR(expr[, format_string])`	Converte uma data em uma string, com base no formato. Converte um número em uma string; nenhum formato é necessário. Nas expressões do pipeline, `format_string` deve usar os códigos de formato strftime.	`TO_CHAR(123)` retorna `123` `TO_CHAR(Date'2020-10-30', '%m/%d/%Y')` retorna `10/30/2020`. O primeiro argumento é um objeto de Data que representa 30 de outubro de 2020.
`TRIM(string)`	Retorna uma string com os caracteres de espaço à esquerda removidos.	`TRIM(' ORACLE ')` retorna `ORACLE`
`UPPER(string)`	Retorna uma string com todas as letras alteradas para maiúsculas.	`UPPER('oracle')` retorna `ORACLE`
`json_path(json_string, json_filter_path)`	Extrai um valor de uma estrutura JSON.	`CAST(json_path(SYS.RESPONSE_PAYLOAD, '$.key') AS String)` retorna o valor da string do campo "key" em `RESPONSE_PAYLOAD`