Adicionar uma coluna de um exemplo no Power BI DesktopAdd a column from an example in Power BI Desktop

A partir da versão de abril de 2017 do Power BI Desktop, você poderá adicionar novas colunas de dados ao seu modelo usando o Editor de Consultas; para isso, basta fornecer um ou mais valores de exemplo na nova coluna.Starting with the April 2017 release of Power BI Desktop, you can add new columns of data to your model using Query Editor by simply providing one or more sample values for your new column. É possível criar novos exemplos de coluna a partir de uma seleção atual ou da entrada de dados baseados em todas as colunas (ou colunas selecionadas) em determinada tabela.You can create a new column example from a current selection, or from providing input based on all (or selected) columns in a given table.

Essa abordagem o ajuda a criar novas colunas de maneira rápida e fácil e é excelente nas seguintes situações:This approach helps you quickly and easily create new columns, and is great for the following situations:

  • Quando o resultado dos dados desejados na nova coluna é conhecido, mas você não tem certeza de qual transformação (ou conjunto de transformações) obterá ali.You know the data result you want in your new column, but you're not sure which transformation (or collection of transformations) will get you there.
  • Quando as transformações necessárias já são conhecidas, mas você não tem certeza de onde clicar ou selecionar na interface do usuário para ativá-las.You already know which transformations you need, but you're not sure where to click or select in the UI to make them happen.
  • Quando já se sabe tudo sobre as transformações necessárias com o uso de uma expressão de Coluna personalizada em M, mas uma (ou mais) dessas expressões não está disponível para clicar ou adicionar na interface do usuário.You know all about the transformations you need using a Custom Column expression in M, but one (or more) of those expressions aren't available to click or add in the UI.

Usar o recurso Adicionar coluna extraída de exemplo é fácil e simples.Using the add column from example feature is easy and straightforward. Nas próximas seções, veremos como isso é fácil.In the next few sections, we see just how easy it is.

Uso do Editor de Consultas para adicionar uma nova coluna extraída de exemplosUse Query Editor to add a new column from examples

Para criar uma nova coluna extraída de um exemplo, abra o Editor de Consultas.To create a new column from an example, launch Query Editor. Para fazer isso, selecione Editar consultas na faixa de opções Início no Power BI Desktop.You can do this by selecting Edit Queries from the Home ribbon in Power BI Desktop.

Neste artigo, usaremos dados do seguinte artigo da Wikipédia (trata-se de um link, portanto você pode clicar nele para acessar os dados e acompanhar o texto):In this article, we'll use data from the following Wikipedia article (it's a link, so you can click it to get the data for yourself and follow along):

Após abrir o Editor de Consultas e carregar alguns dados, você poderá começar adicionando uma coluna extraída de exemplos.Once Query Editor is launched and you have some data loaded, you can get started adding a column from examples. Para adicionar uma nova coluna, em Editor de Consultas, selecione a guia Adicionar coluna na faixa de opções e selecione Coluna extraída de exemplos.To add a new column, in Query Editor select the Add Column tab on the ribbon and select Column from Examples. Se escolher a lista suspensa, você poderá selecionar De todas as colunas (que é o padrão, se simplesmente selecionar o botão em vez de a lista suspensa) ou Da seleção.If you choose the drop-down, you can select either From All Columns (the default, if you just select the button instead of the drop-down) or select From Selection. Neste artigo, veremos como selecionar De todas as colunas.In this article, we'll walk through selecting From All Columns.

Painel Adicionar coluna extraída de exemplosThe Add Column From Examples pane

Depois de feita a seleção para adicionar uma nova coluna extraída de exemplos, será exibido um novo painel mostrando as colunas na tabela atual (talvez seja necessário rolar para visualizar todas as colunas).Once you make a selection to add a new column from examples, a new pane appears that shows the columns in the current table (you may need to scroll to see them all). A nova coluna Column1 também é exibida à direita, que é a coluna a ser criada pelo Power BI Desktop com base nos seus exemplos.The new Column1 is also shown to the right, which is the column that Power BI Desktop will create based on your examples. Abaixo do cabeçalho da nova coluna Column1, ficam as células em branco, onde é possível digitar os exemplos utilizados pelo Power BI para criar regras e transformações para corresponder ao seu exemplo.Below the new Column1 header are blank cells, where you can type in your examples that Power BI uses to create rules and transformations to match your example.

Observe também que esta é uma Etapa aplicada do painel Configurações de consulta.Notice too that this is an Applied Step in the Query Settings pane. Como sempre, o Editor de Consultas gravará suas etapas de transformação e as aplicará por ordem à consulta.As always, Query Editor will record your transformation steps and apply them to the query, in order.

Este é o painel conhecido como Adicionar colunas extraídas de exemplos e consiste em quatro áreas principais:This is called the Add Columns From Examples pane, and it consists of four primary areas:

  1. A barra Comando, que inclui uma breve descrição do recurso ou da transformação.The Command bar which includes a brief description of the feature, or the transformation.
  2. A opção Enviar comentários para ajudar o Power BI aprimorar o recurso.The Send Feedback option to help Power BI improve this feature.
  3. Os botões OK e Cancelar, com os quais é possível confirmar transformações e adicionar a coluna ou cancelar.The OK and Cancel buttons, which lets you commit your transformations and add the column, or cancel.
  4. A área da nova coluna, onde é possível digitar seus valores de amostra em qualquer uma das linhas (para fornecer o exemplo ao Power BI) relacionados a outras colunas da linha.The new column area, where you can type your sample values in any of the rows (to provide Power BI with your example), relating to other columns in that row.

Ao digitar seu exemplo na nova coluna, o Power BI fornece uma visualização de como a coluna em processo de criação será exibida com base nas transformações detectadas.As you type your example in the new column, Power BI gives you a preview of how the column it's creating will appear, based on the transformations it detects. Por exemplo, digitamos Alabama na primeira linha, que corresponde ao valor Alabama na primeira coluna da tabela.For example, we typed Alabama in the first row, corresponding to the Alabama value in the first column of the table. Basta pressionar Enter para o Power BI preencher a coluna com base nesse valor.As soon as we hit Enter Power BI fills in the column based on that value.

Logo depois, no entanto, acessamos a linha que incluía Massachusetts [E] e excluímos a última parte [E] (porque não queríamos essa parte), e o Power BI detectou a alteração e usou o exemplo para criar uma transformação.But then we went to the row that included Massachusetts[E] and deleted that last [E] portion (because we didn't want it) and Power BI detected the change, and used the example to create a transformation. Observe a explicação da transformação no painel superior central.Notice the explanation of the transform in the upper middle pane.

À medida que mais exemplos são fornecidos, o Editor de Consultas os adiciona às transformações.As you continue to provide examples, Query Editor adds to the transformations. Quando estiver satisfeito, você poderá selecionar OK para confirmar as alterações.When you're satisfied, you can select OK to commit your changes.

Consulte Adicionar coluna extraída de exemplos em açãoSee Add Column from Examples in action

Interessado em ver como isso funciona?Want to see this working? O vídeo a seguir mostra como colocar esse recurso em prática utilizando a fonte de dados fornecida no exemplo.The following video shows this feature being put to use, using the data source provided earlier in this example. Dê uma olhada e acompanhe.Take a look, and follow along for yourself!

Considerações e limitaçõesConsiderations and limitations

Há muitas transformações disponíveis quando a opção Adicionar coluna extraída de exemplos é usada, mas nem todas as transformações estão incluídas.There are many transformations that are available when using Add column from Examples, but not every transformation is included. A lista a seguir fornece todas as transformações com suporte.The following list provides all the transformations that are supported.

  • ReferênciaReference

    • Referência a uma coluna específica (incluindo cortar, limpar ou aplicar uma transformação de maiúsculas e minúsculas)Reference to a specific column (including trim, clean, and case transformations)
  • Transformações de textoText transformations

    • Combinar (dá suporte à combinação de cadeias de caracteres literais e a todos os valores da coluna)Combine (supports combination of literal strings and entire column values)
    • SubstituirReplace
    • TamanhoLength
    • ExtrairExtract
      • Primeiros caracteresFirst Characters
      • Últimos caracteresLast Characters
      • IntervaloRange
      • Texto antes do delimitadorText before Delimiter
      • Texto depois do delimitadorText after Delimiter
      • Texto entre delimitadoresText between Delimiters
      • TamanhoLength
  • As seguintes transformações de texto com suporte estão disponíveis com a versão do Power BI Desktop de novembro de 2017:The following supported text transformations are available beginning with the November 2017 release of Power BI Desktop:

    • Remover CaracteresRemove Characters
    • Manter CaracteresKeep Characters

Observação

Todas as transformações de Texto levam em consideração a necessidade potencial de cortar, limpar ou aplicar uma transformação de maiúsculas e minúsculas ao valor da coluna.All Text transformations take into account the potential need to trim, clean, or apply a case transformation to the column value.

  • Transformações de dataDate transformations

    • DiaDay
    • Dia da semanaDay of Week
    • Nome do dia da semanaDay of Week Name
    • Dia do anoDay of Year
    • MêsMonth
    • Nome do mêsMonth Name
    • Trimestre do anoQuarter of Year
    • Semana do mêsWeek of Month
    • Semana do anoWeek of Year
    • AnoYear
    • IdadeAge
    • Início do anoStart of Year
    • Fim do anoEnd of Year
    • Início do mêsStart of Month
    • Fim do mêsEnd of Month
    • Início do trimestreStart of Quarter
    • Dias do mêsDays in Month
    • Fim do trimestreEnd of Quarter
    • Início da semanaStart of Week
    • Fim da semanaEnd of Week
    • Dia do mêsDay of Month
    • Início do diaStart of Day
    • Fim do diaEnd of Day
  • Transformações de horaTime transformations

    • HoraHour
    • MinutoMinute
    • SegundoSecond
    • Para a hora localTo Local Time

Observação

Todas as transformações de Data e Hora levam em consideração a necessidade potencial de converter o valor da coluna para Data ou Hora ou Data/Hora.All Date and Time transformations take into account the potential need to convert the column value to Date or Time or DateTime.

  • Transformações de númeroNumber transformations

    • Valor absolutoAbsolute Value
    • Arco cossenoArccosine
    • Arco senoArcsine
    • Arco tangenteArctangent
    • Converter em númeroConvert to Number
    • CossenoCosine
    • CuboCube
    • DividirDivide
    • ExpoenteExponent
    • FatorialFactorial
    • Divisão de inteiroInteger Divide
    • É parIs Even
    • É ímparIs Odd
    • LnLn
    • Logaritmo de base 10Base-10 Logarithm
    • MóduloModulo
    • MultiplicarMultiply
    • Arredondar para baixoRound Down
    • Arredondar para cimaRound Up
    • SinalSign
    • SenoSin
    • Raiz quadradaSquare Root
    • QuadradoSquare
    • SubtrairSubtract
    • SomarSum
    • TangenteTangent
  • As seguintes transformações de número com suporte estão disponíveis a partir da versão do Power BI Desktop de novembro de 2017:The following supported number transformation is available beginning with the November 2017 release of Power BI Desktop:

    • Particionamento/intervalosBucketing/Ranges
  • GeralGeneral

    • Coluna CondicionalConditional Column