MD Software
MillenniumBrokerMacros do Broker

Formatação de dados

Funções de Tratamento de Valores Nulos

#NULL_TO_N

  • Descrição: Transforma campos numéricos com valor nulo em um valor padrão definido.
  • Utilidade: Prevenir valores nulos em campos numéricos, garantindo um valor padrão.

Sintaxe:

#NULL_TO_N(campo_numérico, valor_padrão)

Exemplo:

SELECT #NULL_TO_N(numero, 1) AS valor FROM DUAL;

#NULL_TO_S

  • Descrição: Transforma campos do tipo texto com valor nulo ou vazio em um valor padrão.
  • Utilidade: Prevenir valores nulos ou vazios em campos de texto.

Sintaxe:

#NULL_TO_S(campo_texto, valor_padrão)

Exemplo:

SELECT #NULL_TO_S(nome, 'ZE') AS nome FROM DUAL;

#NULL_TO_Z

  • Descrição: Transforma campos numéricos com valor nulo em zero.
  • Utilidade: Padronizar campos numéricos nulos com o valor zero.

Sintaxe:

#NULL_TO_Z(campo_numérico)

Exemplo:

SELECT #NULL_TO_Z(numero) AS valor FROM DUAL;

Funções para Inserção de Valores em Consultas

#REPLACE

  • Descrição: Substitui o nome de uma variável pelo seu valor literal em comandos SQL.
  • Utilidade: Facilitar a inserção de valores fixos ou variáveis em consultas.

Sintaxe:

#REPLACE(variável)

Exemplos:

SELECT * FROM #REPLACE(tabela);
SELECT * FROM produtos WHERE produto = #REPLACE(produto);
SELECT #REPLACE(campos) FROM produtos;

#REPLACETR

  • Descrição: Similar ao #REPLACE, mas formata a string para uso com o operador LIKE, adicionando % no início e no fim.
  • Utilidade: Realizar buscas que utilizam LIKE com curingas.

Sintaxe:

#REPLACETR(variável)

Exemplo:

SELECT * FROM clientes WHERE nome LIKE #REPLACETR(nome);

#REPLACET

  • Descrição: Similar ao #REPLACE, mas formata valores de texto e data, adicionando aspas simples.
  • Utilidade: Inserir valores de texto ou data em consultas de forma segura.

Sintaxe:

#REPLACET(variável)

Exemplo:

SELECT * FROM clientes WHERE nome = #REPLACET(nome);

Funções de Formatação de Dados

#REPLACEFMT

  • Descrição: Formata um valor utilizando uma máscara específica.
  • Utilidade: Exibir valores formatados, como CPF ou CNPJ.

Sintaxe:

#REPLACEFMT(campo, 'máscara')

Exemplo:

SELECT #REPLACEFMT(CPF, '###.###.###-##') AS cpf FROM GERADORES;

#REPLACEUFMT

  • Descrição: Remove a formatação de um valor, mantendo apenas os números.
  • Utilidade: Limpar formatações para operações que exigem apenas números.

Sintaxe:

#REPLACEUFMT(campo)

Exemplo:

SELECT #REPLACEUFMT(CPF) FROM GERADORES;

Funções de Tradução e Seleção Condicional

#TRANSLATE

  • Descrição: Transforma valores de um campo conforme um mapeamento pré-definido.
  • Utilidade: Traduzir códigos em descrições mais amigáveis.

Sintaxe:

#TRANSLATE(campo, 'valor1':'resultado1', 'valor2':'resultado2', ..., else:'resultado_padrão')

Exemplo:

SELECT #TRANSLATE(tipo_sexo, 'M':'Masculino', 'F':'Feminino', else:'Indefinido') FROM geradores;

#SELECT

  • Descrição: Retorna um valor condicional para um campo, funcionando de forma semelhante à cláusula CASE WHEN.
  • Utilidade: Realizar operações condicionais em consultas SQL.

Sintaxe:

#SELECT(expressão, 'valor1':'resultado1', 'valor2':'resultado2', ..., else:'resultado_padrão')

Exemplo:

SELECT nome, #SELECT(tipo_sexo, 'M':'Homem', 'F':'Mulher', else:'Indeterminado') AS Sexo FROM CLIENTES;

On this page