Função TRIM

Remove um espaço em branco à esquerda e à direita de uma string. O espaçamento entre palavras não é removido.
  • Se uma string começa ou termina com espaços, guias ou outros caracteres não visíveis, eles são removidos por esta função.
  • A função TRIM não remove espaços em branco entre valores que não sejam de espaços em branco, como espaços entre palavras. Para remover esse tipo de espaço em branco, use REMOVEWHITESPACE. Consulte Função REMOVEWHITESPACE.

Uso básico

Exemplo de referência de coluna:

derive type:single value:TRIM(MyName)

Saída: o valor da coluna MyName com o espaço em branco removido do início e do final.

Exemplo de literal de string:

derive type:single value:TRIM(' Hello, World ')

Saída: a string Hello, World é gravada na nova coluna.

Sintaxe

derive type:single value:TRIM(column_string)

ArgumentoObrigatório?Tipo de dadosDescrição
column_stringSstringNome da coluna ou literal de string a ser aplicado à função

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

column_string

Nome de coluna ou constante de string a ser cortada.

  • Valores ausentes de coluna ou string geram resultados de string ausentes.
  • É necessário colocar as constantes de string entre aspas ('Hello, World').
  • Várias colunas e caracteres curinga não são aceitos.

Notas de uso:

Obrigatório?Tipo de dadosValor de exemplo
SimLiteral de string ou referência de colunamyColumn

Exemplos

Exemplo - Como cortar espaço em branco no início e no final

Neste exemplo, os valores dos espaços em branco são identificados de acordo com esta tabela. A coluna de valor ASCII identifica esse valor de caracteres ASCII que o representa.

  • O conjunto de caracteres ASCII é um método padrão para representar o teclado e os caracteres especiais no computador. Para saber mais informações sobre ASCII, consulte http://www.asciitable.com/.
ValorDefiniçãoValor ASCII
(space)barra de espaçoChar(32)
(tab)caractere de tabulaçãoChar(9)
(cr)retorno de carroChar(13)
(nl)nova linhaChar(10)

Fonte:

No conjunto de dados do exemplo a seguir, os valores de entrada são representados em mystring. Os valores na tabela acima são representados nos valores de string abaixo.

mystring
Esta é a minha string.
(space)(space) Esta é a minha string.(space)(space)
(tab)Esta é a minha string(tab)
(cr)Esta é a minha string.(cr)
(nl)Esta é a minha string.(nl)
(space)(space)(tab)Esta é a minha string.(tab)(space)(space)
(space)(space)(tab)(cr)Esta é a minha string.(cr)(tab)(space)(space)
(space)(space)(tab)(nl)(cr)Esta é a minha string.(cr)(nl)(tab)(space)(space)

Entrada:

Quando os dados CSV acima são importados para a página do Transformer, eles são representados da seguinte maneira:

mystring
Esta é a minha string.
(space)(space) Esta é a minha string.(space)(space)
"(tab)Esta é a minha string.(tab)"
"(cr)Esta é a minha string.(cr)"
"(nl)Esta é a minha string.(nl)"
"(space)(space)(tab)Esta é a minha string.(tab)(space)(space)"
"(space)(space)(tab)(cr)Esta é a minha string.(cr)(tab)(space)(space)"
"(space)(space)()(nl)(cr)Esta é a minha string.(cr)(nl)(tab)(space)(space)"

Transformação:

Observe as aspas em torno da maioria dos valores importados.

OBSERVAÇÃO: se um valor de string importado contiver tabulação, retorno de carro ou valores de nova linha, ele estará entre aspas duplas.

O primeiro passo é remover essas aspas. Selecione uma das aspas na grade de dados e, em seguida, selecionar o cartão de sugestão Replace apropriado. A transformação será semelhante a esta:

replace col: mystring on: `"` with: '' global: true

Agora, aplique a função TRIM:

derive type:single value: TRIM(mystring) as: 'trim_mystring'

Resultados:

Na coluna trim_mystring gerada, veja as strings limpas:

mystringtrim_mystring
Esta é a minha string.Esta é a minha string.
(space)(space) Esta é a minha string.(space)(space)Esta é a minha string.
"(tab)Esta é a minha string.(tab)"Esta é a minha string.
"(cr)Esta é a minha string.(cr)"Esta é a minha string.
"(nl)Esta é a minha string.(nl)"Esta é a minha string.
"(space)(space)(tab)Esta é a minha string.(tab)(space)(space)"Esta é a minha string.
"(space)(space)(tab)(cr)Esta é a minha string.(cr)(tab)(space)(space)"Esta é a minha string.
"(space)(space)()(nl)(cr)Esta é a minha string.(cr)(nl)(tab)(space)(space)"Esta é a minha string.

Dica: se as aspas duplas forem removidas, a tabulação, o retorno de carro e os valores de nova linha serão ajustados pela função TRIM.

Exemplo - Funções de limpeza de strings em conjunto

O exemplo a seguir demonstra funções que podem ser usadas para limpar strings. Essas funções incluem os seguintes itens:

  • TRIM: remova os espaços em branco no início e no final. Consulte Função TRIM.
  • REMOVEWHITESPACE: remova os espaços em branco no início e no fim da string e todos os espaços em branco entre eles. Consulte Função REMOVEWHITESPACE.
  • REMOVESYMBOLS: remova todos os caracteres que não são alfanuméricos ou espaços em branco. Consulte Função REMOVESYMBOLS.

Fonte:

No exemplo a seguir, (space) e (tab) indicam as teclas de espaço e tabulação, respectivamente. O retorno do carro e os caracteres de nova linha também estão disponíveis para as funções de espaço em branco.

Stringssource
String01esta origem(space)(space)
String02(tab)(tab)esta origem
String03(tab)(tab)esta origem(space)(space)
String04desta origem?
String05Oras, seu @#$%^&*()!
String06esta örigem
String07(space)esta örigem
String08à amanhã

Transformação:

As transformações a seguir geram novas colunas usando cada uma das funções de limpeza de strings:

derive type:single value: TRIM(source) as: 'trim_source'

derive type:single value: REMOVEWHITESPACE(source) as: 'removewhitespace_source'

derive type:single value: REMOVESYMBOLS(source) as: 'removesymbols_source'

Resultados:

Stringssourceremovesymbols_sourceremovewhitespace_sourcetrim_source
String01esta origem(space)(space) esta origem(space)(space) estaorigemesta origem
String02(tab)(tab)esta origem(tab)(tab)esta origemestaorigemesta origem
String03(tab)(tab)esta origem(space)(space)(tab)(tab)esta origem(space)(space)estaorigemesta origem
String04desta origem?estas origensdestaorigem?desta origem?
String05Oras, seu @#$%^&*()!Oras seu Oras,seu@#$%^&*()!Oras, seu @#$%^&*()!
String06esta örigemesta rigemestaörigemesta örigem
String07(space)esta örigem(space)esta rigemestaörigemesta örigem
String08à amanhã manhà ama nhãà ama nhã

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.