Transformação Rename

Renomeia uma coluna com um nome específico.

OBSERVAÇÃO: os nomes das colunas não diferenciam maiúsculas e minúsculas. Eles precisam começar com uma letra e podem conter valores alfanuméricos e sublinhados (_). Espaços não são permitidos.

Outras formas de renomear:

  • É mais fácil mudar o nome das colunas por meio da interface do usuário. Clique duas vezes no nome da coluna ou selecione Rename... no menu suspenso da coluna. Esse comando é processado como etapas de receita que usam a transformação rename. Consulte Renomear uma coluna.
  • É possível que as transformações que geram novas colunas aceitem o parâmetro as, que permite especificar o nome da nova coluna. O uso do parâmetro as evita a etapa extra de adicionar uma transformação rename após a geração da coluna. Consulte Transformação Derive.

Uso básico

rename col: OldName to: 'NewName'

Resultado: muda o nome da coluna OldName para NewName.

Parâmetros

rename: col: column_ref to:column_ref

ParâmetroObrigatório?Transform BuilderTipo de dadosDescrição
colSColunastringNome da coluna a renomear
toSNovo nomestringNovo nome da coluna

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

col

Identifica a coluna na qual aplicar a transformação. Você pode especificar apenas uma coluna.

Observações sobre o uso:

Obrigatório?Tipo de dados
SimString (nome da coluna)

to

Identifica o nome da coluna que será renomeada.

  • Não há suporte para vários nomes de colunas.

O valor da nova coluna é do tipo string e precisa ficar entre aspas simples. Veja o exemplo anterior.

O novo nome da coluna:

  • precisa começar com uma letra;
  • pode conter somente letras, números ou sublinhados;
  • precisa ser exclusivo em comparações indiferentes a maiúsculas com outros nomes de colunas.

Observações sobre o uso:

Obrigatório?Tipo de dados
SimString

Exemplos

Renomear várias colunas

No conjunto de dados a seguir, as colunas de comprimento não incluem nenhuma unidade de medida.

Dica: para o consumo downstream, o nome de qualquer coluna que contenha uma medida precisa incluir as unidades de medida. Evite incluir unidades de medida em valores de células, porque isso força a coluna a ser reescrita como o tipo "String".

Origem:

ObjectLengthXLengthYLengthZ
ObjA102030
ObjB345
ObjC6912

Transformação:

Talvez você saiba que as unidades são centímetros. Você pode renomear usando o seguinte comando:

rename col:LengthX to:'LengthX_cm'

Dica: você pode copiar a transformação acima e depois colá-la novamente no Transform Builder e modificá-la.

Agora, vamos converter as unidades de medida em polegadas. Você pode usar a transformação derive para converter valores e gerar um novo nome de coluna:

derive value: (LengthX_cm * 0.393701) as:'LengthX_in'

Podemos reformatar os valores gerados usando transformações como a seguinte, que arredonda os resultados para dois pontos decimais:

set col:LengthX_in value:NUMFORMAT(LengthX_in, '##.00')

OBSERVAÇÃO: a transformação set não é compatível com o parâmetro as.

Repita as etapas acima para as outras colunas de comprimento.

Resultados:

ObjectLengthX_cmLengthY_cmLengthZ_cmLengthX_inLengthY_inLengthZ_in
ObjA1020303,947,8711,81
ObjB3451,181,571,97
ObjC69122,363,544,72

Você pode descartar as colunas originais, se necessário.

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.