Função LEFT

Corresponde ao conjunto de caracteres mais à esquerda de uma string, conforme especificado pelo parâmetro. A string pode ser especificada como uma referência de coluna ou um literal de string.
  • Como a função LEFT faz a correspondência com base em valores numéricos fixos, as alterações no comprimento ou na estrutura de um campo de dados podem impedir a execução correta de sua receita.
  • A função LEFT requer um valor inteiro para que o número de caracteres corresponda. Se for necessário combinar strings usando padrões, use a transformação STARTSWITH. Consulte Função STARTSWITH.

Uso básico

Exemplo de referência de coluna:

derive type:single value:LEFT(MyName,3)

Saída: as três primeiras letras do valor da coluna MyName são gravadas na nova coluna.

Exemplo de literal de string:

derive type:single value:LEFT('Hello, World',5)

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

Sintaxe

derive type:single value:LEFT(column_string,char_count)

ArgumentoObrigatório?Tipo de dadosDescrição
column_stringSstringNome da coluna ou literal de string a ser aplicado à função
char_countSinteiro (positivo)Contagem de caracteres desde o início do valor a incluir na correspondência

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

column_string

Nome de coluna ou constante de string a ser pesquisada.

  • 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

char_count

Contagem de caracteres desde o início da string a incluir na correspondência.

  • O valor tem que ser um inteiro não negativo. Se o valor for 0, a correspondência não funcionará para todas as strings.
  • Se esse valor for maior que o comprimento da string, a correspondência será a string inteira.
  • As referências a colunas do tipo de dados inteiro não estão disponíveis.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimInteiro (não negativo)5

Exemplos

Exemplo: tipo de licença do motorista

Origem:

Um número de licença de motorista da Califórnia é um caractere alfabético seguido de sete dígitos (por exemplo, A1234567). Veja a seguir um conjunto de valores de licença de motorista da Califórnia:

LastNameLicenseID
AbleA1234567
BakerB5555555
CharlieC0123456

O valor LicenseID contém a classe de licença como o primeiro caractere do valor. Por exemplo, a licença de Baker é uma licença comercial categoria B.

Transformação:

Para extrair o tipo de licença em uma coluna separada, você pode usar a seguinte transformação:

derive type:single value:LEFT(LicenseID,1)

Resultados:

LastNameLicenseIDleft_LicenseID
AbleA1234567A
BakerB5555555B
CharlieC0123456C

Você pode renomear a nova coluna para LicenseType.

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.