Função LOG

Calcula o logaritmo do primeiro argumento com uma base do segundo.
  • O primeiro argumento pode ser um literal decimal ou inteiro ou uma referência a uma coluna com valores numéricos.
  • O segundo argumento, a base, precisa ser um valor inteiro ou uma referência de coluna.

Uso básico

Exemplo de literal numérico:

derive type:single value: LOG(49, 7)

Resultado: gera uma coluna contendo o valor de 7x = 49, que tem como resultado 2.

Exemplo de referência da coluna:

derive type:single value: LOG(MyValue, 5) as: 'log_MyValue'

Resultado: gera a nova coluna log_MyValue contendo o expoente elevado a 5 para gerar a coluna MyValue.

Sintaxe

derive type:single value: LOG(result_numeric_value, base_numeric_value)

ArgumentoObrigatório?Tipo de dadosDescrição
result_numeric_valueSstring, decimal ou número inteiroNome da coluna ou literal decimal ou inteiro gerado pela função LOG
base_numeric_valueSstring, decimal ou número inteiroNome da coluna ou literal decimal ou inteiro que serve de base para calcular a função LOG

Para mais informações sobre os padrões de sintaxe, consulte as Notas sobre a sintaxe da documentação da linguagem.

result_numeric_value

Nome da coluna ou literal numérico. O valor precisa ser maior que 0.

  • Valores de entrada ausentes geram resultados ausentes.
  • Os valores numéricos literais não devem ser colocados entre aspas. Os valores entre aspas são tratados como strings.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimString (referência de coluna) ou literal inteiro ou decimal49

base_numeric_value

Nome da coluna ou literal inteiro usado para o cálculo exponencial.

OBSERVAÇÃO: este valor de base precisa ser um número inteiro positivo. Se ele não for especificado, 10 será usado como o valor de base.

  • Valores de entrada ausentes geram resultados ausentes.
  • Os valores numéricos literais não devem ser colocados entre aspas. Os valores entre aspas são tratados como strings.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
NãoString (referência de coluna) ou literal inteiro ou decimal7

Exemplos

Exemplo - Funções exponenciais

A seguir, temos um exemplo do funcionamento conjunto de funções exponenciais. Essas funções incluem os seguintes itens:

Fonte:

rowNumX
1-2
21
30
41
52
63
74
85

Transformação:

derive type:single value: EXP (X) as: 'expX'

derive type:single value: LN (expX) as: 'ln_expX'

derive type:single value: LOG (X) as: 'logX'

derive type:single value: POW (10,logX) as: 'pow_logX'


Resultados:

Na tabela a seguir, (null value) indica que um valor nulo foi gerado para o cálculo.

rowNumXexpXln_expXlogXpow_logX
1-20.1353352832366127-2(null value)(null value)
2-10.1353352832366127-0,9999999999999998(null value)(null value)
3010(null value)0
412.718281828459045101
527.389056098930649520.301029995663981141.9999999999999998
6320.08553692318766830.477121254719662443
7454.5981500331442340.60205999132796233.999999999999999
85148.4131591025765750.69897000433601874.999999999999999

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.