# tableau Tableau Prep (prep) - Full Documentation [Pular para o conteúdo principal](#main-content) # Adicionar mais dados na etapa de entrada **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Depois de se conectar a fontes de dados e começar a construir o fluxo, talvez você queira atualizar as conexões de dados à medida que novos dados entram. Você também pode unir colunas ou linhas de conjuntos de dados na etapa de entrada para tornar o trabalho com fontes de dados maiores mais eficiente. ## Atualizar os dados da etapa de entrada ou altere sua conexão Se os dados forem alterados em seus arquivos ou tabelas de entrada após você começar a trabalhar com o seu fluxo, é possível atualizar a etapa de entrada para introduzir os dados novos. Você também pode alterar e atualizar facilmente conexões de etapa de entrada individuais sem interromper seu fluxo. ### Atualizar a fonte de dados Em uma sessão do Tableau Prep, você tem várias opções para atualizar os dados em seu fluxo. Embora a maioria dos tipos de dados possa ser atualizada usando as opções descritas nesta seção, há algumas limitações. - **Entrada de arquivo**: você pode atualizar esses tipos de dados no Tableau Prep Builder e no Tableau Server. Você não pode atualizar este tipo de dados no Tableau Cloud. Em vez disso, você pode atualizar os dados do arquivo no Tableau Prep Builder e, em seguida, republicar o fluxo no Tableau Cloud. - **Entradas do Google Drive, One Drive, Dropbox, Box**: para atualizar esses tipos de fonte de dados, edite e substitua a conexão. #### Atualizar a fonte de dados no painel Fluxo No painel Fluxo, clique com o botão direito do mouse na etapa de entrada que quiser atualizar e selecione Atualizar no menu. ![Um menu suspenso com a opção de atualizar os selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_refresh_data.png) #### Atualizar a fonte de dados no menu superior A partir da versão 2026.1, você pode ver a última vez que uma fonte de dados foi atualizada em uma sessão de fluxo. Se a fonte de dados não foi atualizada na sessão de fluxo, o status da atualização aparece como Nunca. Quando você abrir o fluxo pela primeira vez, todas as fontes de dados na lista mostrarão o status Nunca. Esse status também não é atualizado pela execução de fluxos em uma agenda. ![No Tableau Prep, a lista de fontes de dados que estão no fluxo e a última vez que foram atualizadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_refresh_data_list.png) Selecione uma fonte de dados individual na lista para atualizá-la ou atualize todas as fontes de dados no fluxo clicando no botão Atualizar. As fontes de dados que não podem ser atualizadas usando esse método serão listadas, mas aparecerão esmaecidas. Para atualizar uma fonte de dados no menu Atualizar, siga um destes procedimentos: - No painel Fluxo no menu superior, clique no botão Atualizar para atualizar os dados de todas as etapas de entrada. Somente as fontes de dados que podem ser atualizadas usando esse método serão atualizadas. ![O ícone de atualização.](/tableau/current/pt-br/prep/pt-br/Img/prep_refresh_top_menu.png) - Para atualizar a fonte de dados de uma única etapa de entrada, clique na seta suspensa ao lado do botão Atualizar e selecione a fonte de dados na lista. ### Substituir a fonte de dados _Aplica-se a tipos de arquivo, fontes de dados e extrações no Tableau Prep Builder e na Web._ Atualize sua fonte de dados editando conexões de entrada individuais ou substituindo fontes de dados de fluxo individuais por uma fonte de dados diferente. #### Editar a conexão Use esta opção para atualizar suas credenciais ou substituir a fonte de dados pelo mesmo tipo de fonte de dados. **Observação**: para manter o desempenho, o Tableau Prep exibe amostras de grandes conjuntos de dados. Se os seus dados forem incluídos na amostra, você poderá ou não ver seus novos dados no painel Perfil. Altere as configurações de como os dados são incluídos na amostra na guia Amostra de dados na etapa de entrada, mas isso pode afetar o desempenho. Para obter mais informações sobre como definir o tamanho da amostra de dados, consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#sample). 1. No painel Conexões, clique com o botão direito do mouse ou clique em Ctrl (MacOS) na fonte de dados e selecione Editar. ![O menu do botão direito em uma conexão no painel de dados com a opção Editar destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_edit_connection.png) 2. Restabeleça sua conexão ao fazer logon no banco de dados ou ao selecionar novamente o arquivo ou a extração do Tableau. #### Substituir a conexão de entrada Substitua facilmente uma fonte de dados existente em seu fluxo por qualquer nova fonte de dados sem interromper a conexão do fluxo. Dependendo da versão do Tableau Prep, você pode arrastar e soltar uma nova fonte de dados sobre a fonte de dados antiga ou desconectar e reconectar manualmente a fonte de dados. **Arrastar e soltar para substituir a conexão de entrada** (versão 20224. e posterior) 1. No painel Conexões, arraste a nova tabela para o painel de fluxo na parte superior da etapa de entrada que deseja substituir e solte-a na opção Substituir. ![Substituir um campo no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_input_replace.png) 2. Reconfigure todas as configurações e corrija qualquer erro conforme necessário. ![Arraste e solte novas tabelas no painel de fluxo para substituir a conexão de entrada.](/tableau/current/pt-br/prep/pt-br/Img/prep_replace_input_settings.png) Desconecte e reconecte manualmente uma fonte de dados de entrada (versão 2022.3 e anteriores) 1. No painel Fluxo, clique com o botão direito do mouse na etapa de entrada que quiser atualizar e selecione Remover no menu. ![Menu ao clicar com o botão direito do mouse em uma etapa de entrada de fluxo do Tableau Prep com a opção Remover destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_refresh1.png) Isso fará com que o seu fluxo entre em um estado de erro temporariamente. ![Um fluxo sem uma etapa de entrada mostrando um estado de erro.](/tableau/current/pt-br/prep/pt-br/Img/prep_refresh2.png) 2. Conecte-se à fonte de dados nova ou atualizada. 3. Arraste a tabela até o painel Fluxo na parte superior da segunda etapa do fluxo onde deseja adicionar a etapa de entrada. Solte-a na opção Adicionar para reconectá-la ao fluxo. ![Arrastando uma conexão para a tela do Tableau Prep e soltando-a para adicionar manualmente uma etapa de entrada ao fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_refresh_remove.png) ## Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada _As uniões de linhas de entrada só podem ser editadas e criadas no Tableau Prep Builder, mas podem ser agendadas para execução na Web._ Ao trabalhar com vários arquivos ou tabelas de banco de dados de uma única fonte de dados, é possível aplicar filtros para pesquisar arquivos ou usar curingas para encontrar tabelas por meio de uma pesquisa curinga e depois unir essas linhas de dados para incluir todos os dados do arquivo ou da tabela na etapa de entrada. Para unir as linhas dos arquivos, eles devem estar no mesmo diretório ou no subdiretório. **Observação**: esta opção não está disponível para extrações do Tableau. Os novos arquivos que são adicionados à mesma pasta que corresponde aos critérios de filtragem serão incluídos automaticamente na união de linhas na próxima vez que abrir o fluxo ou executá-lo a partir da linha de comando. Os arquivos de fluxo em pacote (.tflx) não coletarão novos arquivos automaticamente pois os arquivos já estão empacotados com o fluxo. Para incluir novos arquivos de fluxos em pacote, abra o arquivo de fluxo (.tfl) no Tableau Prep Builder para coletar novos arquivos e empacotar novamente o fluxo para incluir os dados do arquivo novo. Para unir as linhas das tabelas de banco de dados, elas devem estar no mesmo banco de dados e a conexão deste deve oferecer suporte ao uso de uma pesquisa curinga. Os seguintes bancos de dados oferecem suporte a este tipo de união de linhas: - Amazon Redshift - Microsoft SQL Server - MySQL - Oracle - PostgreSQL Se adicionar ou remover arquivos ou tabelas após criar a união de linhas, é possível atualizar a etapa de entrada para atualizar o fluxo com os dados novos ou alterados. Se precisar unir dados de fontes de dados diferentes, é possível fazer isso usando uma etapa de União de linhas. Para obter mais informações sobre a criação de etapas da União de linhas, consulte [Unir linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Union). ### Arquivos de união de linhas Por padrão, o Tableau Prep Builder une todos os arquivos .csv no mesmo diretório que o arquivo .csv ao qual se conectou ou todas as planilhas no arquivo Excel ao qual se conectou. Se desejar alterar a união de linhas padrão, você pode filtrar os critérios de filtragem a seguir para encontrar os arquivos ou planilhas que deseja incluir à união de linhas: #### Critérios de filtro principal No Tableau Prep Builder versão 2022.1.1 e anterior, você pode selecionar um dos seguintes critérios: - Pesquisar em: selecione o diretório a ser usado para pesquisar por arquivos. Marque a caixa de seleção Incluir subpastas para incluir arquivos no subdiretório da pasta pai. - Arquivos: escolha incluir ou excluir os arquivos que correspondem ao critério de pesquisa curinga. - Padrão correspondente (xxx\*): insira um padrão de pesquisa curinga para encontrar arquivos que tenham esses caracteres no nome de arquivo. Por exemplo, se tiver inserido pedido\*, todos os arquivos que incluem o nome de arquivo “pedido” serão retornados. Deixe este campo em branco para incluir todos os arquivos no diretório especificado. #### Filtros adicionais _Compatível com o Tableau Prep Builder versão 2022.2.1 e posterior e para fluxos publicados no Tableau Cloud._ **Observação**: se você usar filtros adicionais em seu fluxo, o agendamento de fluxo está disponível apenas usando o Tableau Cloud. Você pode executar o fluxo manualmente no Tableau Prep Builder ou por meio da interface de linha de comando. Esse recurso não é compatível com o Tableau Server versão 2022.1 e anteriores. Começando no Tableau Prep Builder versão 2022.2.1 e posterior, as opções de filtragem na busca de arquivos para união foram alteradas. Embora você ainda especifique um diretório e um subdiretório para pesquisar, agora é possível definir vários filtros para realizar uma pesquisa mais granular. Essas opções de filtragem se aplicam aos tipos de arquivo Texto, Microsoft Excel e Estatística. Você pode selecionar vários filtros. Cada filtro é aplicado separadamente, na ordem em que você os seleciona, de cima para baixo. Os filtros não podem ser movidos uma vez adicionados, mas você pode excluir e adicionar filtros conforme necessário. ![Filtros adicionais no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_wildcard_union_filters.png) Selecione dentre os seguintes filtros:
FiltrarDescrição
Nome do arquivoSelecione Corresponder ou Não corresponder para obter um padrão de nome de arquivo. Por exemplo, "pedidos*".
Tamanho do arquivo

Filtre os arquivos selecionando um intervalo de tamanhos ou classificado por tamanho.

Intervalo de tamanhos: você pode selecionar uma das seguintes opções:

  • Especifique um intervalo de valores.
  • Selecione um operador de Menor que, Menor que ou igual a, Maior ou igual a ou Maior que e aplique-o a um único valor.

Classificado por tamanho: inclua ou exclua os N arquivos maiores ou menores.

Data de criação

Filtre os arquivos selecionando um intervalo de datas, data relativa ou classificado por data.

Intervalo de datas: você pode selecionar uma das seguintes opções:

  • Especifique um intervalo de data e hora.
  • Selecione um operador de Antes, Antes ou igual a, Depois ou igual a ou Depois e aplique-o a um único valor.

Data relativa: inclua ou exclua um intervalo exato de anos, trimestres, meses, semanas ou dias. Além disso, é possível configurar uma referência relativa a uma data específica.

Observação: os períodos de data "última" incluem a unidade de tempo atual completa, mesmo que algumas datas ainda não tenham ocorrido. Por exemplo, se você selecionar o último mês e a data atual for 7 de janeiro, o Tableau exibirá as datas de 1 a 31 de janeiro.

Classificado por data: inclui ou exclui os N arquivos mais recentes ou mais antigos.

Data de modificação

Filtre os arquivos selecionando um intervalo de datas, data relativa ou classificado por data.

Intervalo de datas: você pode selecionar uma das seguintes opções:

  • Especifique um intervalo de data e hora.
  • Selecione um operador de Antes, Antes ou igual a, Depois ou igual a ou Depois e aplique-o a um único valor.

Data relativa: inclua ou exclua um intervalo exato de anos, trimestres, meses, semanas ou dias. Além disso, é possível configurar uma referência relativa a uma data específica.

Observação: os períodos de data "última" incluem a unidade de tempo atual completa, mesmo que algumas datas ainda não tenham ocorrido. Por exemplo, se você selecionar o último mês e a data atual for 7 de janeiro, o Tableau exibirá as datas de 1 a 31 de janeiro.

Classificado por data: inclui ou exclui os N arquivos mais recentes ou mais antigos.

**Observação**: as instruções abaixo variam de acordo com a sua versão do Tableau Prep Builder. #### Criar uma união de linhas de entrada _Aplica-se ao Tableau Prep Builder versão 2021.4.1 e posteriores._ 1. Clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png) e, em Conectar, clique em Arquivo de texto para arquivos .csv, Microsoft Excel para arquivos Excel ou arquivo Estatístico para arquivos Estatísticos, em seguida selecione um arquivo a ser aberto. 2. No painel Entrada, selecione a guia Tabelas e, depois, selecione Tabelas de várias uniões de linha. ![Tabela de entrada com a origem escolhida como União de várias tabelas.](/tableau/current/pt-br/prep/pt-br/Img/prep_inputunion1.png) 3. Selecione uma pasta para pesquisar. Você também pode incluir todas as subpastas listadas em um determinado diretório para expandir sua pesquisa. 4. Clique em Adicionar filtro de arquivo e selecione uma das seguintes opções: - Nome do arquivo: insira um padrão de nome para pesquisar. - Tamanho do arquivo: pesquise por intervalo de tamanho ou classificado por tamanho. - Data de criação: pesquise por intervalo de datas, data relativa ou classificação por data. - Data de modificação: pesquise por intervalo de datas, data relativa ou classificação por data. 5. Clique em Adicionar filtro de arquivo novamente para adicionar mais filtros. Os resultados do filtro são mostrados na seção Tabelas incluídas. ![Tabela de entrada com duas tabelas incluídas.](/tableau/current/pt-br/prep/pt-br/Img/prep_inputunion2.png) 6. Clique em Aplicar para unir as linhas dos arquivos. Ao adicionar uma nova etapa ao fluxo, é possível ver todos os arquivos adicionados ao conjunto de dados no campo Caminhos do arquivo no painel Perfil. Esse campo é adicionado automaticamente. ![Ao adicionar uma nova etapa ao fluxo, é possível ver todos os arquivos adicionados ao conjunto de dados no campo Caminhos do arquivo no painel Perfil](/tableau/current/pt-br/prep/pt-br/Img/prep_inputunion3.png) Crie uma união de linhas de entrada (versão 2022.1.1 e anterior) 1. Clique no botão Adicionar conexão e no botão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png), em Conectar, clique em Arquivo de texto para arquivos .csv ou Microsoft Excel para arquivos Excel, em seguida selecione um arquivo a ser aberto. 2. No painel Entrada, selecione a guia Vários arquivos, em seguida selecione União de linhas curinga. ![Uma união de entrada usando um padrão correspondente.](/tableau/current/pt-br/prep/pt-br/Img/prep_wildcard.png) O exemplo abaixo mostra uma união de linhas de entrada usando um padrão correspondente. O sinal de adição no ícone do arquivo na etapa de entrada Orders\_Central, no painel Fluxo, indica que essa etapa inclui uma união de linhas de entrada. Os arquivos na união de linhas estão listados em Arquivos incluídos. ![Uma união de entrada usando um padrão correspondente.](/tableau/current/pt-br/prep/pt-br/Img/prep_wildcard_apply.png) 3. Use as opções de pesquisa, arquivo e padrão correspondente para encontrar os arquivos dos quais deseja unir as linhas. 4. Clique em Aplicar para unir as linhas dos arquivos. Ao adicionar uma nova etapa ao fluxo, é possível ver todos os arquivos adicionados ao conjunto de dados no campo Caminhos do arquivo no painel Perfil. Esse campo é adicionado automaticamente. ![Todos os arquivos adicionados ao conjunto de dados no campo Caminhos de arquivo no painel Perfil.](/tableau/current/pt-br/prep/pt-br/Img/prep_wildcard2.png) ### Tabelas de banco de dados de união de linhas _Com suporte no Tableau Prep Builder versão 2018.3.1 e posteriores._ **Observação**: a interface de união de entrada para tabelas de banco de dados foi atualizada no Tableau Prep Builder versão 2022.2.1. Suas opções podem parecer diferente dependendo da versão. 1. Clique no botão Adicionar conexão![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png) e, em Conectar, conecte-se a um banco de dados que ofereça suporte à união de linhas de entrada. 2. Arraste uma tabela até o painel Fluxo. 3. No painel Entrada, selecione a guia Tabelas e, depois, selecione Tabelas de várias uniões de linha. _Nas versões anteriores, selecione a guia Várias tabelas e, depois, selecione União de linhas curinga._ ![A guia Tabelas no painel de entrada em um fluxo do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_databaseunion_2022.2.png) 4. No campo Tabelas, selecione Incluir ou Excluir na opção suspensa e insira um padrão de correspondência para localizar as tabelas que deseja unir linhas. _Nas versões anteriores, use as opções de pesquisa, Tabelas e Padrão de correspondência._ Apenas tabelas exibidas no painel Conexões na seção Tabelas podem ser incluídas na união de linhas. A pesquisa de união de linhas de entrada não pesquisa em todos os esquemas nem em toda a conexão com o banco de dados para encontrar tabelas. 5. Clique em Aplicar para unir as linhas de dados da tabela. Ao adicionar uma nova etapa ao fluxo, é possível ver todas as tabelas adicionadas ao conjunto de dados no campo Nomes de tabelas no painel Perfil. Esse campo é adicionado automaticamente. ![Um fluxo do Tableau Prep mostrando o campo Nomes de tabela adicionado após a união de linhas de várias tabelas na etapa de entrada.](/tableau/current/pt-br/prep/pt-br/Img/prep_database_tables_2022.2.png) ### Mesclar campos após uma união de linhas Depois de criar uma união de linhas na etapa de entrada, você pode querer mesclar campos. É possível fazer isso em qualquer etapa subsequente, exceto nas etapas de entrada e de saída. Para obter mais informações, consulte [Opções adicionais para mesclar campos](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#merge_fields). ## Unir colunas de dados na etapa de entrada No Tableau Prep Builder (versão 2019.3.1 e posteriores) e na Web, quando você se conecta a bancos de dados que incluem tabelas com dados de relacionamento, o Tableau Prep detecta e mostra quais campos em uma tabela são identificados como identificador exclusivo e quais são identificados como campo relacionado, além de mostrar os nomes dos campos relacionados referentes a cada um. Uma nova coluna chamada Chaves vinculadas é exibida no painel Entrada e mostra os seguintes relacionamentos, se existirem: - ![Um ícone em forma de chave de casa. ](/tableau/current/pt-br/prep/pt-br/Img/prep_pirmary_key_icon.png) Identificador exclusivo. Este campo identifica exclusivamente cada linha na tabela. Pode haver vários identificadores exclusivos em uma tabela. Os valores nos campos devem ser únicos e não podem ser vazios ou nulos. - ![O ícone de chave relacionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_related_key_icon.png) Campo relacionado. Este campo relaciona a tabela a outra tabela no banco de dados. Pode haver vários campos relacionados em uma tabela. - ![Um ícone com duas chaves e um link representa um identificador exclusivo em uma tabela e também relaciona a tabela a outra tabela no banco de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_combo_key_icon.png) Identificador exclusivo e campo relacionado. O campo é um identificador exclusivo nesta tabela e também relaciona a tabela a outra tabela no banco de dados. ![Descrições de chaves vinculadas em uma tabela de exemplo.](/tableau/current/pt-br/prep/pt-br/Img/prep_linked_keys1.png) Você pode aproveitar essas relações para localizar e adicionar rapidamente as tabelas relacionadas ao fluxo ou criar uniões a partir da etapa de Entrada. Esse recurso está disponível para qualquer conector de banco de dados compatível que contenha relações de tabela definidas. 1. Conecte-se a um banco de dados (como o Microsoft SQL Server) que contém dados de relacionamento para campos, como identificadores exclusivos ou campos relacionados (chave estrangeira). 2. No painel Entrada, clique em um campo marcado como um campo relacionado ![O ícone de chave relacionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_related_key_icon.png) ou como um identificador exclusivo e campo relacionado ![Um ícone com duas chaves e um link representa um identificador exclusivo em uma tabela e também relaciona a tabela a outra tabela no banco de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_combo_key_icon.png). Uma caixa de diálogo é aberta, exibindo uma lista de tabelas relacionadas. 3. Focalize com o mouse sobre a tabela que deseja adicionar ou unir colunas e clique no botão de símbolo de mais para adicionar a tabela ao fluxo, ou clique no botão de união de colunas para criar uma união de colunas com a tabela selecionada. ![O item de menu mostrando Tabelas relacionadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_linked_keys2.png) Se você criar uma união de colunas, o Tableau Prep usará a relação de campo definida para unir colunas das tabelas e mostrará uma visualização das cláusulas de união de colunas que ele usará para criar a união de colunas. ![Um exemplo de chaves vinculadas de duas tabelas.](/tableau/current/pt-br/prep/pt-br/Img/prep_linked_keys3.png) 4. Como alternativa, pode-se unir colunas de tabelas relacionadas por meio do menu no painel Fluxo. Clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar união de colunas para ver uma lista de tabelas relacionadas. O Tableau Prep cria a união de colunas com base nos campos que compõem a relação entre as duas tabelas. **Observação**: se a tabela não tiver relações de tabela definidas, essa opção não estará disponível. ![Item de menu mostrando como adicionar união de colunas com tabelas de exemplo.](/tableau/current/pt-br/prep/pt-br/Img/prep_linked_keys4.png) Para obter mais informações sobre como trabalhar com uniões, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Join). [Pular para o conteúdo principal](#main-content) # Adicionar previsões do Einstein Discovery ao seu fluxo _Com suporte no Tableau Prep Builder versão 2021.1.3 e posterior e na Web no Tableau Cloud e Tableau Server versão 2021.2.0 e posterior._ Use modelos oferecidos pelo Einstein Discovery fazer previsões em massa para os dados em seu fluxo. As previsões podem ajudar você a tomar decisões bem fundamentadas e adotar ações para melhorar os resultados da sua empresa. Ao aplicar esses modelos, um novo campo para resultados previstos (na forma de pontuações de probabilidade ou médias estimadas) é automaticamente adicionado ao seu fluxo. Você também pode incluir os principais preditores e os principais campos de melhorias em seus dados de fluxo, selecionando essas opções ao aplicar seu modelo. Os principais preditores mostram os fatores que contribuíram de forma mais significativa para a previsão. As principais melhorias mostram ações sugeridas a serem tomadas para melhorar o resultado previsto. Por exemplo, para prever a retenção de funcionários, é possível criar um modelo usando dados históricos (dos quais você já sabe o resultado) no Einstein Discovery. Em seguida, aplicar esse modelo ao conjunto de dados em seu fluxo e gerar o resultado previsto. Os resultados de previsão são aplicados no nível de linha, ajudando você a detalhar mais a análise no Tableau. Se você precisar aplicar vários modelos ao conjunto de dados, poderá incluir várias etapas de previsão em seu fluxo. Cada etapa de previsão aplica um único modelo de previsão ao fluxo. A partir da versão 2021.2, você pode entrar em vários servidores Einstein Discovery em um único fluxo para escolher os modelos de que precisa. As versões anteriores restringem você a um único servidor Einstein Discovery por fluxo. **Observação**: você deve ter uma licença do Salesforce e conta de usuário configurada para acessar o Einstein Discovery e usar esse recurso. Consulte [Pré-requisitos](#Prerequisites)para obter mais informações. ## O que é Einstein Discovery? O Einstein Discovery aumenta a inteligência de negócios com modelagem estatística e aprendizado de máquina supervisionado para identificar, obter e visualizar insights sobre os dados de suas atividades. Ele rapidamente filtra milhões de linhas de dados para encontrar correlações importantes, prever resultados e sugerir maneiras de melhorar esses resultados previstos. Para obter mais informações sobre o Einstein Discovery, consulte [Introdução ao Discovery](http://pages.mail.salesforce.com/gettingstarted/analytics-cloud/einstein-data-discovery/) e [Explicar, prever e agir com o Einstein Discovery](https://help.tableau.com/current/prep/pt-br/%3Chttp://Explain, Predict, and Take Action with Einstein Discovery in Salesforce>) na ajuda do Salesforce. Você também pode expandir seu conhecimento com o [Obter insight com Einstein Discovery em](https://trailhead.salesforce.com/en/content/learn/trails/wave_analytics_einstein_discovery)[Trailhead](https://trailhead.salesforce.com/en/home). **Observação**: o Einstein Discovery no Tableau é alimentado por [salesforce.com](https://www.salesforce.com/). Consulte seu contrato com a [salesforce.com](https://www.salesforce.com/) para obter os termos aplicáveis. ## Pré-requisitos Para configurar e usar as previsões do Einstein Discovery em seu fluxo, você precisa de certas licenças, acesso e permissões no Salesforce e no Tableau. #### Requisitos do Salesforce
requisitodescription

Licença do Salesforce

Uma das seguintes licenças:

  • Licença Einstein Discovery no Tableau
  • Licença Tableau CRM Plus
  • Licença Einstein Predictions

Essas licenças estão disponíveis por um custo extra.

Conta de usuário do Salesforce

Conta configurada para acessar o Einstein Discovery.

Se você usar a licença do Einstein Discovery no Tableau, sua conta de usuário deve ter a permissão do sistema de Exibir recomendações do Einstein Discovery via API Connect atribuída a ela.

Se você usar a licença Tableau CRM Plus ou Einstein Predictions:

  • Para obter previsões usando modelos do Einstein Discovery já implantados, a conta deve ter a permissão do sistema Detecção Einstein Discovery Recommendations atribuída a ela.
  • Para criar, implantar e gerenciar previsões no Einstein Discovery, a conta deve ter a Permissão de gerenciamento do Einstein Discovery atribuída a ela.

Para configurar as contas de usuário, consulte Configurar o Einstein Discovery na ajuda do Salesforce.

Configurações do administrador

Os administradores da Salesforce precisarão:

#### Requisitos do Tableau Prep
requisitodescription

Licença e permissões do Tableau Prep

Licença Creator.

Como Creator, você precisa ser capaz de entrar na conta da organização Salesforce para acessar definições de previsão e adicionar modelos ao seu fluxo.

Conta de usuário do Tableau

No Tableau Server e no Tableau Cloud 2021.2 e posteriores, os usuários podem salvar as credenciais da conta de usuário do Salesforce junto com a conta de usuário do Tableau.

Para obter mais informações sobre como se conectar a dados do Salesforce, consulte Conectar aos seus dados do Salesforce.

Configurações do administrador

Os administradores do Tableau Server precisarão configurar o Tableau Server para se integrar ao Einstein Discovery para Tableau Prep. Para obter mais informações, consulte Configurar integração do Einstein Discovery na ajuda do Tableau Server.

## Adicionar dados de previsão ao fluxo **Observação**: na versão 2021.1.4, os fluxos que incluem etapas de previsão podem ser executados manualmente no Tableau Prep Builder. Para aplicar as previsões do Einstein Discovery ao seu fluxo, você precisará: - Acesso a uma organização Salesforce. - Acessar uma organização do Tableau Prep Builder versão 2021.1.3 ou posterior. - Se estiver criando ou executando fluxos na Web, acesse o Tableau Cloud ou Tableau Server versão 2021.2 ou posterior que foi habilitado para previsões do Einstein Discovery. - Um modelo de previsão do Einstein Discovery implantado no Salesforce. - Dados de origem no Tableau Prep com campos que correspondem aos campos de modelo exigidos pelo modelo de previsão do Einstein Discovery. 1. Abra o Tableau Prep e se conecte a uma fonte de dados. 2. Aplique todas as operações de limpeza, conforme necessário. 3. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Previsão no menu Adicionar. ![Um menu de linha de fluxo do Tableau Prep é aberto, e a opção Previsão é selecionada.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_menu.png) 4. No painel Previsão da guia Configurações, execute um dos seguintes procedimentos, dependendo da versão: - **Versão 2021.2 e posterior**: no menu suspenso Conexão, conecte-se ao servidor Salesforce ou selecione-o na lista se já tiver uma conexão estabelecida. ![A guia Configurações é selecionada, e o menu Conexão é aberto. O Salesforce é selecionado.](/tableau/current/pt-br/prep/pt-br/Img/Prep_predictions_select_connection.png) - **Versão 2021.1.4 e anterior**: clique em Conectar-se ao Einstein Discovery. ![Uma mensagem de erro solicita que você insira as credenciais do Salesforce para se conectar ao Einstein Discovery.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_signin.png) Ao se conectar pela primeira vez, uma página da Web é aberta, pedindo que você faça login na sua conta do Salesforce. Depois de fazer login, uma página da Web é aberta perguntando se você deseja deixar o Tableau acessar seus dados do Salesforce. Clique em **Permitir** para continuar e, em seguida, feche a guia resultante no seu navegador. 5. Clique em Selecionar definição de previsão. Isso abre a lista de modelos implantados aos quais você tem acesso. Os modelos são criados e implantados no Salesforce usando o Einstein Discovery. Para obter mais informações sobre modelos preditivos, consulte [Sobre modelos](https://help.salesforce.com/articleView?id=sf.bi_edd_model_about.htm&type=5) na ajuda do Salesforce. ![A tela Previsão é definida na guia Configurações. O botão Selecionar definição de previsão é selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_definition1.png) 6. Na caixa de diálogo Definições de previsão, selecione a definição de previsão que mapeia o conjunto de dados. Para gerar resultados previstos usando seus dados de fluxo, todos os campos do modelo devem mapear para um campo de fluxo correspondente. ![A caixa de diálogo Definições de previsão mostra uma tabela de definições. Previsão de retenção de funcionários é selecionada.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_definition2.png) 7. Na seção Opções, selecione até três preditores e melhorias principais para incluir em seus dados de fluxo. Estes são dados suplementares que você pode adicionar ao seu fluxo. - Os principais preditores indicam quais fatores contribuíram mais para o resultado previsto. - As principais melhorias sugerem ações a serem tomadas para melhorar o resultado previsto. ![Na guia Configurações, as caixas de seleção Principais preditores e Principais melhorias são selecionadas no cabeçalho Opções.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_options.png) 8. Na seção Campos de mapa, mapeie seus campos de fluxo para seus campos de modelo. - Todos os campos de modelo devem ser mapeados para um campo de fluxo correspondente. - Os nomes de campo com correspondência exata são mapeados automaticamente. - Você não pode mapear o mesmo campo de fluxo para vários campos de modelo. - Os tipos de dados de modelo e fluxo de campo devem coincidir. Se o campo de fluxo for atribuído a um tipo de dados diferente, você precisará alterá-lo para corresponder ao tipo de dados atribuído ao campo modelo. Para alterar o tipo de dados, na seção Campos de mapa, basta clicar no tipo de dados para o campo de fluxo e selecionar o novo tipo de dados no menu. Em seguida, você pode alterar o tipo de dados de volta em uma etapa de limpeza subsequente. Para obter mais informações sobre a mudança de tipos de dados, consulte [Consultar os tipos de dados atribuídos aos seus dados](https://help.tableau.com/current/prep/pt-br/prep_explore.htm#reviewdatatypes). ![Opções de Campos de mapa, incluindo dimensões e medidas.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_map_fields.png) 9. Para aplicar suas configurações e executar o modelo em seus dados, clique em Aplicar. Os resultados de predição no painel Perfil e na grade de dados. Se você alterar qualquer configuração, poderá clicar em Aplicar novamente para executar novamente o modelo com suas alterações. Se você deixar a etapa Previsão antes de clicar em Aplicar, o modelo não será executado e suas alterações serão perdidas. ![O fluxo do Tableau Prep Builder mostra uma previsão adicionada ao fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_results.png) ### Revendo seus resultados Depois de aplicar o modelo preditivo aos seus dados de fluxo, você pode gerar a saída de fluxo e usar a nova fonte de dados para analisar os resultados previstos no nível de linha no Tableau. Para entender os resultados do modelo de previsão, analisaremos um exemplo. Neste tópico, aplicamos o modelo de Previsão de retenção de funcionários aos dados de nossos funcionários no Tableau Prep para obter uma pontuação de probabilidade de um funcionário permanecer na empresa. Isso nos deu os seguintes resultados: ![Uma tabela com um campo selecionado na coluna ID do funcionário.](/tableau/current/pt-br/prep/pt-br/Img/prep_predictions_results2.png) Vejamos o que esses resultados nos dizem sobre o Funcionário 2:
PerguntaPrevisãoOnde é isso?
Qual a probabilidade desse funcionário permanecer?O Einstein Discovery prevê que há 81,38% de chance de permanência.Campo de previsão
Quais fatores afetam esse resultado?Os anos com o atual gerente reduzem a chance desse funcionário ficar em 2,2%.

Campo de preditor 1 (preditor superior)

Impacto de preditor 1 (impacto percentual do preditor superior)

O que pode melhorar esse resultado previsto?O aumento da taxa mensal do funcionário entre 4923 e 5725 aumenta em 3,86% a probabilidade de o funcionário permanecer.

Campo de melhoria 1 (melhoria superior)

Impacto de melhoria 1 (impacto percentual de fazer a mudança sugerida)

[Pular para o conteúdo principal](#main-content) # Agregar, unir colunas ou linhas de dados Agregar, unir colunas ou linhas de dados no grupo ou combinar dados para análise. **Observação**: o conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). ## Agregar e agrupar valores Às vezes, será necessário ajustar a granularidade de alguns dados, seja para reduzir a quantidade de dados produzidos do fluxo ou para alinhá-los a outros dados que possa querer unir em linhas ou colunas. Por exemplo, você pode querer agregar dados de vendas por cliente antes de unir uma tabela de vendas a uma tabela de cliente. Se precisar ajustar a granularidade de seus dados, use a opção Agregar para criar uma etapa para agrupar e agregar dados. A agregação ou agrupamento de dados depende do tipo de dados (cadeia de caracteres, número ou data). 1. No painel Fluxo, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Agregar. Uma nova etapa de agregação é exibida no painel Fluxo e o painel Perfil é atualizado para mostrar o perfil de agregação e agrupamento. 2. Arraste campos do painel esquerdo para o painel Campos agrupados (os campos que compõem a linha) ou para o painel Campos agregados (os dados que serão agregados e apresentados no nível dos campos agrupados). Além disso, é possível: - Arrastar e soltar campos entre os dois painéis. - Pesquisar por campos na lista e selecionar apenas os campos que deseja incluir na agregação. - Clicar duas vezes em um campo para adicioná-lo ao painel à esquerda ou à direita. - Alterar a função do campo para adicioná-lo automaticamente ao painel adequado. - Clique em Adicionar todos ou Remover todos para aplicar ou remover em massa os campos. - Aplicar determinadas operações de limpeza a campos. Para obter mais informações sobre quais opções de limpeza estão disponíveis, consulte [Sobre as operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Edit). O exemplo a seguir mostraria a soma agregada de lucro e quantidade e desconto médio por região e ano de venda. ![Um exemplo de uma etapa de agregação em um fluxo do Tableau Prep mostrando a soma agregada de lucro e quantidade e o desconto médio por região e ano de venda.](/tableau/current/pt-br/prep/pt-br/Img/prep_aggregate.png) Os campos são distribuídos entre as colunas Campos agrupados e Campos agregados, com base no tipo de dados. Clique nos cabeçalhos do tipo de agrupamento ou de agregação (por exemplo, MÉDIA ou SOMA) para alterar o tipo. Nas grades de dados abaixo do perfil de agregação e agrupamento, é possível ver uma amostra dos membros do agrupamento ou agregação. Todas as operações de limpeza feita nos campos são monitoradas no painel Alterações. ## Unir colunas de dados Os dados que deseja analisar são, muitas vezes, compostos por um conjunto de tabelas relacionadas por campos específicos. A união de colunas é um método de combinação de dados relacionados nesses campos comuns. O resultado da combinação de dados por união de colunas é uma tabela, que normalmente se estende horizontalmente ao adicionar campos de dados. Se você precisar visualizar dados espaciais, talvez seja necessário criar uniões de colunas em seus campos geoespaciais. A partir da versão 2026.1, você pode realizar essas operações no Tableau Prep na etapa de união de colunas. As uniões espaciais usam o operador Interseções e permitem unir colunas de campos que são um tipo de dados geoespaciais. Embora a maioria dos mesmos recursos de união de colunas se aplique a dados espaciais e não espaciais, há algumas diferenças. Para obter mais informações, consulte [Criar cálculos espaciais e uniões de colunas](https://help.tableau.com/current/prep/pt-br/prep_spatial_calculations_and_joins.htm). A união de colunas é uma operação que pode ser feita a qualquer momento no fluxo. Realizar uma união de colunas no início do fluxo pode ajudar a entender os conjuntos de dados e expor áreas que precisam de atenção imediata. O Tableau Prep oferece suporte aos seguintes tipos de união de colunas:
Tipo de união de colunasDescrição
Esquerda Dois círculos que se cruzam, um em cinza e o outro em amarelo, ilustrando uma união de dados.Para cada linha, inclui todos os valores da tabela esquerda e as correspondências da tabela direita. Quando um valor na tabela esquerda não tiver uma correspondência na tabela direita, um valor nulo será exibido nos resultados de união de colunas.
Interna Edição em linha do Tableau Prep.Para cada linha, inclui valores que têm correspondências em ambas as tabelas.
Direita Uma união direita.Para cada linha, inclui todos os valores da tabela direita e correspondências da tabela esquerda. Quando um valor na tabela direita não tiver uma correspondência na tabela esquerda, um valor nulo será exibido nos resultados de união de colunas.
Somente esquerda Um diagrama de Venn com dois círculos que se cruzam, ilustrando uma união somente esquerda.Para cada linha, inclui apenas valores da tabela esquerda que não correspondem a nenhum valor da tabela direita. Os valores de campo da tabela direita aparecem como valores nulos nos resultados da união de colunas.
Somente direita Uma união somente direita.Para cada linha, inclui apenas valores da tabela direita que não correspondem a nenhum valor da tabela esquerda. Os valores de campo da tabela esquerda aparecem como valores nulos nos resultados da união de colunas.
Não interna Dois círculos sobrepostos, um rosa e um amarelo.Para cada linha, inclui todos os valores das tabelas direita e esquerda que não correspondem.
Completa Dois círculos sobrepostos.Para cada linha, inclui todos os valores de ambas as tabelas. Quando um valor de uma tabela não tiver uma correspondência na outra tabela, um valor nulo será exibido nos resultados de união de colunas.
Para criar uma união de colunas, faça o seguinte: 1. Una colunas de duas tabelas usando um dos seguintes métodos: - Adicione pelo menos duas tabelas ao painel Fluxo, em seguida, selecione e arraste a tabela relacionada para a outra tabela até que a opção União de colunas seja exibida. ![Uma etapa de fluxo sendo arrastada sobre outra etapa de fluxo para unir linhas ou colunas das etapas.](/tableau/current/pt-br/prep/pt-br/Img/prep_addjoinorunion.png) - Clique no ícone Adicionar ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Unir colunas no menu; em seguida, adicione manualmente a outra entrada à união de colunas e adicione as cláusulas de união. **Observação**: se você se conectar a uma tabela que tem relações de tabela definidas e campos relacionados, poderá selecionar Unir colunas e selecionar uma lista de tabelas relacionadas. O Tableau Prep cria a união de colunas com base nos campos que compõem a relação entre as duas tabelas. Para obter mais informações sobre conectores com relações de tabela, consulte [Unir colunas de dados na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#table_relations_joins). Uma nova etapa de união de colunas é adicionada ao fluxo e o painel Perfil é atualizado para mostrar o perfil dessa união. 2. Para consultar e configurar a união de colunas, faça o seguinte: 1. Consulte o Resumo de resultados da união de colunas para ver o número de campos incluídos e excluídos como consequência do tipo e das condições de união de colunas. 2. Em Tipo de união de colunas, clique no diagrama Venn para especificar o tipo de união de colunas desejado. 3. Em Cláusulas de união aplicadas, clique no ícone Adicionar![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) ou, no campo escolhido para a condição de união de colunas padrão, especifique ou edite a cláusula de união. Os campos selecionados na condição de união de colunas são campos comuns entre as tabelas na união. ![Cláusulas de união aplicadas do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_joinclause.png) 4. Você também pode clicar nas cláusulas de união de colunas recomendadas exibidas em Recomendações da cláusula de união de colunas para adicionar a cláusula à lista de cláusulas de união de colunas aplicadas. ![O painel União de colunas mostra o resultado da vinculação de duas tabelas por meio de IDs de produtos e pedidos compartilhados.](/tableau/current/pt-br/prep/pt-br/Img/prep_joinsummary.png) ### Inspecionar os resultados da união de colunas O resumo no perfil da união de colunas mostra os metadados da união para ajudar na verificação de que ela inclui os dados esperados. - Cláusulas da união de colunas aplicadas: por padrão, o Tableau Prep define a primeira cláusula de união de colunas com base em nomes de campos comuns nas tabelas da união. Adicione ou remova cláusulas da união de colunas conforme necessário. - Tipo de união de colunas: por padrão, ao criar uma união de colunas, o Tableau Prep usa uma união interna entre tabelas. Dependendo dos dados conectados, é possível usar a união de colunas esquerda, interna, direita, somente esquerda, somente direita, não interna ou completa. - Resumo de resultados da união de colunas: mostra a distribuição de valores incluídos e excluídos das tabelas na união de colunas. - Clique em cada barra Incluídos para isolar e ver os dados no perfil de união de colunas incluídos na união. - Clique em cada barra Excluídos para isolar e ver os dados no perfil de união de colunas excluídos da união. - Clique em qualquer combinação das barras Incluídos e Excluídos para ver uma perspectiva acumulativa dos dados. - Recomendações da cláusula de união de colunas: clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) próximo à cláusula de união de colunas recomendada para adicioná-la à lista Cláusulas de união de colunas aplicadas. - Painel Cláusulas de união de colunas: no painel Cláusulas de união de colunas, é possível ver os valores em cada campo na cláusula da união. Os valores que não atendem aos critérios da cláusula de união de colunas são exibidos em texto de cor vermelha. ![Os valores em cada campo na cláusula de união. Os valores que não atendem aos critérios da cláusula de união de colunas são exibidos em texto de cor vermelha.](/tableau/current/pt-br/prep/pt-br/Img/prep_join_clause_pane.png) - Painel Resultados da união de colunas: caso veja valores no painel Resultados da união de colunas que deseja alterar, é possível editá-los no próprio painel. ### Problemas comuns da união de colunas Caso não veja os resultados esperados após a união das colunas de dados, talvez seja necessário fazer uma limpeza adicional nos valores do campo. Os seguintes problemas farão com que o Tableau Prep leia os valores como não correspondentes e exclua-os da união de colunas: - Capitalização diferente: Minhas Vendas e minhas vendas - Ortografia diferente: Havaí e Havai - Erros de ortografia ou de entrada de dados: Integridade da minha empresa e Integridade da minha empresa - Mudanças de nome: John Smith e John Smith Jr. - Abreviaturas: Minha Empresa Limitada e Minha Empresa Ltd. - Separadores extras: Honolulu e Honolulu (Havaí) - Espaços extras: isso inclui espaço extra entre os caracteres, espaços com tabulação ou espaços extras à esquerda ou à direita - Uso inconsistente de ponto final: Retornado, não necessário e Retornado, não necessário. Caso tenha algum desses problemas com os valores do campo, é possível corrigi-los diretamente nas Cláusulas de união de colunas ou trabalhar com os valores excluídos, clicando nas barras Excluído no Resumo de resultados da união de colunas e usando as operações de limpeza no menu do cartão Perfil. Para obter mais informações sobre as diferentes opções de limpeza disponíveis na etapa de União de colunas, consulte [Sobre as operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Edit). ### Corrigir campos sem correspondência e mais É possível corrigir os campos sem correspondência diretamente na cláusula de união de colunas. Clique duas vezes ou clique com o botão direito do mouse e selecione Editar valor no menu de contexto do campo que você deseja corrigir e insira um novo valor. As alterações de dados são monitoradas e adicionadas ao painel Alterações na etapa União de colunas. ![O Tableau Prep exibe classes de união de coluna com "Google BigQuery" destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_joinreplace2.png) Além disso, é possível selecionar vários valores para manter, excluir ou filtrar nos painel Cláusulas de união de colunas, ou aplicar outras operações de limpeza no painel Resultados da união de colunas. Dependendo de quais campos forem alterados e de onde estão localizados no processo de união de colunas, sua alteração será aplicada antes ou depois da união de colunas para fornecer os resultados corretos. ![Um exemplo do Tableau Prep mostrando as alterações feitas em vários campos em uma etapa União de colunas. A alteração é realizada antes da ação de união de colunas para fornecer os resultados corrigidos.](/tableau/current/pt-br/prep/pt-br/Img/prep_orderops.png) Para obter mais informações sobre a limpeza de campos, consulte [Aplicar operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#clean_steps). ## Unir linhas de dados A união de linhas é um método de combinação de dados que anexa linhas de uma tabela a outra tabela. Por exemplo, você pode desejar adicionar novas transações em uma tabela a uma lista de transações antigas em outra tabela. Certifique-se de que as tabelas com linhas unidas têm o mesmo número e nomes de campos, e que os campos sejam do mesmo tipo de dados. > [!TIP] > > **Dica**: para aumentar o desempenho, uma única união de linhas pode ter um máximo de 10 entradas. Se precisar unir linhas de mais de 10 arquivos ou tabelas, tente unir as linhas dos arquivos na etapa de Entrada. Para obter mais informações sobre esse tipo de união de linhas, consulte [Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#Union). Semelhante a uma união de colunas, é possível usar a operação de união de linhas em qualquer ponto do fluxo. Para criar uma união de linhas, faça o seguinte: 1. Depois de adicionar pelo menos duas tabelas ao painel Fluxo, selecione e arraste uma tabela relacionada para a outra tabela até que a opção União de linhas seja exibida. Além disso, é possível clicar no ícone ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecionar União de linhas no menu. Uma nova etapa de união de linhas é adicionada ao painel Fluxo, e o painel Perfil é atualizado para mostrar o perfil da união. ![Uma nova etapa de união de linhas é adicionada ao painel Fluxo, e o painel Perfil é atualizado para mostrar o perfil da união.](/tableau/current/pt-br/prep/pt-br/Img/prep_unionprofile.png) 2. Adicione tabelas adicionais à união de linhas ao arrastar tabelas na direção das tabelas unificadas até ver a opção Adicionar. ![Um fluxo de trabalho de transformação de dados usando operações de união de linhas, adição e união de colunas em arquivos de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_joinunionplus.png) 3. No perfil de união de linhas, consulte os metadados sobre a união. Nele, é possível remover tabelas da união de linhas e ver detalhes sobre qualquer campo sem correspondência. ### Inspecionar os resultados da união de linhas Após criar uma união de linhas, inspecione os resultados para ter certeza de que os dados na união são os esperados. Para validar os dados da união de linhas, verifique as seguintes áreas: - **Revise os metadados da união de linhas**: o perfil da união de linhas mostra alguns metadados sobre a união. Aqui é possível ver as tabelas que constituem a união de linhas, o número de campos resultantes e qualquer campo sem correspondência. ![O perfil de união de linhas mostra alguns metadados sobre a união.](/tableau/current/pt-br/prep/pt-br/Img/prep_unionsummary.png) - **Revise as cores de cada campo**: próximo a cada campo listado no resumo União de linhas e acima de cada campo no perfil da união, está um conjunto de cores. Cada cor corresponde a uma tabela na união de linhas. Se todas as cores da tabela forem mostradas para aquele campo, então a união de linhas foi realizada corretamente. A ausência de uma das cores indica que há campos sem correspondência. ![Resultados da união para subcategoria, nome do produto, devolvido, produto e ano do pedido.](/tableau/current/pt-br/prep/pt-br/Img/prep_unioncolors.png) Campos sem correspondência são campos que poderiam ter dados similares, mas são diferentes de alguma maneira. É possível ver a lista de campos sem correspondência e as tabelas de onde eles vieram no resumo União de linhas. Caso deseje analisar os dados dos campos de maneira mais detalhada, marque a caixa de seleção Mostrar apenas os campos sem correspondência para isolar os campos sem correspondência no perfil União de linhas. ![Na página Resultados da união de linhas, a caixa de seleção “Mostrar apenas campos incompatíveis” é destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_mimatchedfields.png) Para corrigir esses campos, siga uma das sugestões na seção [Corrigir campos sem correspondência](#Fix_union) abaixo. ### Corrigir campos sem correspondência Quando as tabelas em uma união de linhas não são correspondidas, a união produz campos adicionais. Os campos adicionais são dados válidos que estão sendo excluídos de seu contexto adequado. Para solucionar um problema de campo sem correspondência, é necessário mesclar os campos não correspondentes. Há diversos motivos para que esses campos não sejam unidos no processo inicial: - **Campos correspondentes têm nomes diferentes**: se os campos correspondentes entre tabelas tiverem nomes diferentes, é possível usar recomendações de união de linhas, mesclar os campos manualmente na lista Campos sem correspondência ou renomear o campo no perfil da união de linhas para mesclar os campos sem correspondência. Para usar recomendações de união de linhas, faça o seguinte: 1. Na lista Campos sem correspondência, clique em um campo sem correspondência. Se existir uma correspondência sugerida, o campo correspondente é destacado na cor amarela. Correspondências sugeridas são baseadas em campos com tipos de dados e nomes de campo similares. 2. Focalize o campo destacado e clique no botão com o símbolo de mais para mesclar os campos. ![Uma lista de campos incompatíveis. O produto está selecionado](/tableau/current/pt-br/prep/pt-br/Img/prep_mismatchsuggestion.png) Para mesclar os campos manualmente na lista Campos sem correspondência, faça o seguinte: 1. Selecione um ou mais campos na lista. 2. Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) em um campo selecionado e, se a mesclagem for válida, a opção de menu Mesclar campos será exibida. Se você vir Nenhuma opção disponível ao clicar com o botão direito do mouse no campo, isso ocorre porque os campos não estão qualificados para a mesclagem. Por exemplo, tentar mesclar dois campos da mesma entrada. 3. Clique em Mesclar campos para mesclar os campos selecionados. ![Uma lista de campos conflitantes com a opção de consolidá-los.](/tableau/current/pt-br/prep/pt-br/Img/prep_union_merge_list.png) Para renomear o campo no painel Perfil da união de linhas, clique com o botão direito do mouse no nome do campo e clique em Renomear campo. ![Uma barra em um gráfico é selecionada, e a opção Renomear campo é exibida.](/tableau/current/pt-br/prep/pt-br/Img/prep_profilemenu.png) - **Os campos correspondentes têm o mesmo nome mas são de tipos diferentes:** por padrão, quando o nome dos campos correspondentes coincidem mas o tipo de dados não, o Tableau Prep altera o tipo de dados de um dos campos, de forma que sejam compatíveis um com o outro. Se o Tableau Prep fizer essa alteração, um ícone Alterar tipo de dados é exibido na parte superior do campo mesclado. ![Alterar ícone do tipo de dados](/tableau/current/pt-br/prep/pt-br/Img/prep_profileicon.png) Em determinados casos, o Tableau Prep pode selecionar o tipo de dados incorreto. Caso isso aconteça e você queira desfazer a mesclagem, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) no ícone Alterar tipo de dados e selecione Separar entradas com tipos de dados diferentes. ![Entradas separadas com tipos diferentes.](/tableau/current/pt-br/prep/pt-br/Img/prep_seperateinputs.png) Em seguida, mescle os campos novamente. Para isso, altere o tipo de dados de um dos campos e use as sugestões em [Opções adicionais para mesclar campos](#merge_fields). - **As tabelas correspondentes têm um número de campos diferente**: para unir tabelas, cada tabela na união de linhas deve ter o mesmo número de campos. Se uma união de linhas resultar em campos adicionais, mescle o campo extra com outro existente. ### Opções adicionais para mesclar campos Além dos métodos descritos na seção acima para mesclar campos, também é possível usar um dos seguintes métodos para mesclar campos. É possível mesclar campos em qualquer etapa, exceto na etapa de saída. Para obter informações sobre como mesclar campos no mesmo arquivo, consulte [Mesclar campos](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Merge). Para mesclar campos, execute uma das ações a seguir: - Arraste e solte um campo no outro. Um indicador Soltar para mesclar campos é exibido. - Selecione vários arquivos e clique com o botão direito do mouse na seleção para abrir o menu de contexto, em seguida clique em Mesclar campos. - Selecione vários campos e clique em Mesclar campos na barra de ferramentas sensível ao contexto. [Pular para o conteúdo principal](#main-content) # Ajuda do Tableau Prep ## Introdução ![Introdução ao Tableau Prep Builder](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_GetStarted_big.png) - [Novos recursos no Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_whatsnew.htm) - [Área de trabalho do Tableau Prep Builder.](https://help.tableau.com/current/prep/pt-br/prep_about.htm#a-tour-of-the-tableau-prep-builder-workspace) - [Tutorial do Tableau Prep Builder.](https://help.tableau.com/current/prep/pt-br/prep_get_started.htm) - [Cenários habituais](https://help.tableau.com/current/prep/pt-br/prep_dayinlife.htm) - [Criar seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_build_flow.htm) - [mais](https://help.tableau.com/current/prep/pt-br/prep_about.htm) ## Conectar a dados ![Conecte-se às suas fontes de dados](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_ConnectToData_big.png) - [Iniciar ou abrir um fluxo de dados](https://help.tableau.com/current/prep/pt-br/prep_startflow.htm) - [Conectar a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm) - [Configurar o conjunto de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm) - [Unir linhas de dados na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#union-files-and-database-tables-in-the-input-step) - [Unir colunas de dados usando relacionamentos de tabela de dados](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#join-data-in-the-input-step-version-201913-and-later) - [mais](https://help.tableau.com/current/prep/pt-br/prep_connect.htm) ## Examinar e filtrar dados ![Filtrar dados de fluxo](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_FilterData_big.png) - [Alterar tipos de dados de campo](https://help.tableau.com/current/prep/pt-br/prep_explore.htm#review-the-data-types-assigned-to-your-data) - [Aplicar filtros](https://help.tableau.com/current/prep/pt-br/prep_filter.htm) - [Padronizar e validar dados com funções de dados](https://help.tableau.com/current/prep/pt-br/prep_validate_data.htm) - [mais](https://help.tableau.com/current/prep/pt-br/prep_explore.htm) ## Limpar e formatar dados ![Transformar dados](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_CleanShape_big.png) - [Transformar seus dados com ações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) - [Editar valores de campo](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#edit-field-values) - [Copiar etapas, ações e campos de reuso](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm) - [Usar uma tabela dinâmica para transformar sua estrutura de dados](https://help.tableau.com/current/prep/pt-br/prep_pivot.htm) - [Incluir scripts R e Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm) - [mais](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) ## Agrupar os dados ![União de colunas e linhas dos seus dados](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_CombineData_big.png) - [Agregar para ajustar sua granularidade de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#aggregate-and-group-values) - [Unir colunas de tabelas para adicionar colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#join-your-data) - [Unir linhas de tabelas para adicionar linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#union-your-data) - [Unir linhas de tabelas para adicionar linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#union-your-data) - [mais](https://help.tableau.com/current/prep/pt-br/prep_combine.htm) ## Salvar e compartilhar dados de fluxo ![Publicar saídas de fluxo](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_Flow_Publish_big.png) - [Publicar extrações de dados e fontes de dados](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#create-and-publish-data-extracts-and-data-sources) - [Atualizar saídas de fluxo na linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm) - [Mantenha a compatibilidade da versão para o seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_conductor_compatibility.htm) - [mais](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm) ## Fluxos de programação para execução ![Executar fluxos em um cronograma](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_Optimize_big.png) - [Publicar um fluxo](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm) - [Agendar tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm) - [Gerenciar fluxos](https://help.tableau.com/current/server/pt-br/prep_conductor_manage_flow.htm) - [Monitorar a integridade e o desempenho do fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm) - [mais](https://help.tableau.com/current/prep/pt-br/prep_conductor_overview.htm) ## Instalar e implementar o Tableau Prep ![Instalação e configuração do Tableau Prep](/tableau/current/pt-br/prep/pt-br/Img/Help_Spot_InstallConfigure_big.png) - [Instalar o Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm) - [Licença do Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/dm_license.htm) - [Habilitar o Tableau Prep Conductor - Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_config_server_overview.htm) - [Habilitar o Tableau Prep Conductor- Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_configure_online.htm) - [mais](https://help.tableau.com/current/prep/pt-br/prep_conductor_config_server_overview.htm)

Avisos de copyright

[Pular para o conteúdo principal](#main-content) # Análise com a segunda data no Tableau Desktop Esta é a segunda etapa do tutorial e assume que a primeira etapa, [Encontrar a Segunda data com o Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_tutorial_2nddateA.htm), já foi concluída. Na primeira etapa, pegamos nosso conjunto de dados original e o moldamos para responder às perguntas a seguir: 1. Qual foi a duração em dias entre a primeira e a segunda infração de cada motorista? 2. Compare os valores das multas da primeira e da segunda infração. Elas estão correlacionadas? 3. Qual motorista pagou mais no total? Quem pagou menos? 4. Quantos motoristas tinham vários tipos de infrações? 5. Qual foi o valor médio da multa para os motoristas que nunca fizeram autoescola? Enquanto analisamos essas perguntas, torna-se claro que há alguns prós e contras na primeira estrutura de dados criada. Voltaremos ao Tableau Prep Builder e faremos uma reformulação adicional, depois veremos como isso influencia a mesma análise no Tableau Desktop. Finalmente, veremos uma abordagem, apenas para o Tableau Desktop, à análise por meio de expressões de nível de detalhe (LOD) com os dados originais. A meta deste tutorial é apresentar vários conceitos no contexto de um cenário da vida real e trabalhar com as opções, sem estabelecer uma que seja a melhor de maneira prescritiva. Ao fim, você deve entender melhor como a estrutura de dados influencia os cálculos e as análises, assim como obter uma maior familiaridade com vários aspectos do Tableau Prep e dos cálculos no Tableau Desktop. **Observação**: para completar as tarefas neste tutorial, é necessário ter o Tableau Prep Builder e, opcionalmente, o Tableau Desktop instalados e os dados já baixados. Para instalar o Tableau Prep e o Tableau Desktop antes de continuar com este tutorial, consulte o [Guia de implantação do Tableau Desktop e do Tableau Prep](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm#). Caso contrário, é possível baixar as versões gratuitas de avaliação do [Tableau Prep](https://www.tableau.com/pt-br/products/prep/download) e do [Tableau Desktop](https://www.tableau.com/pt-br/products/desktop/download). O conjunto de dados é o resultado de [Driver Infractions.tflx](https://mkt.tableau.com/PrepTutorials/Driver%20Infractions.tflx), conforme criado na primeira etapa. ## Análise no Tableau Desktop Depois de configurar os dados, vamos trazê-los para o Tableau Desktop. Algumas perguntas podem ser respondidas facilmente, mas outras envolvem alguns (ou muitos) cálculos. Tente responder às perguntas abaixo, é possível expandir cada uma delas para obter informações básicas sobre como proceder se você não conseguir seguir adiante. **Observação**: você pode baixar a pasta de trabalho [Driver Infractions.twbx](https://mkt.tableau.com/PrepTutorials/Driver%20Infractions.twbx) para considerar as soluções dentro do contexto. Lembre-se de que pode haver maneiras alternativas de interpretar a análise ou de chegar às respostas. 1\. Qual foi a duração em dias entre a primeira e a segunda infração de cada motorista? 1. Para responder a essa pergunta no Tableau Desktop, usaremos a função DATEDIFF. Essa função recebe três argumentos: a parte da data, a data de início e a data de término. Já que queremos saber os dias entre esses eventos, usaremos a parte de data 'day’. Nossas datas de início e de término estão no conjunto de dados como **1st Infraction Date** (Data da primeira infração) e **2nd Infraction Date** Data da segunda infração). 2. O cálculo é: **Time Between Infractions** = `DATEDIFF('day', [1st Infraction Date], [2nd Infraction Date])` 3. É possível plotar isso com relação a **ID do motorista** como um gráfico de barras. Observe que sete motoristas não possuem uma segunda infração, então existem sete valores nulos. ![Gráfico de barras de motoristas por tempo entre infrações](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_1desktopI.png) 2\. Compare os valores das multas da primeira e da segunda infração. Elas estão correlacionadas? 1. Para responder a essa pergunta no Tableau Desktop, criaremos um gráfico de dispersão de **1st Fine Amount** (Valor da primeira multa) e **2nd Fine Amount** (Valor da segunda multa). Ao trazer **ID do motorista** para a divisória Detalhes no cartão Marcas, é possível criar uma marca para cada motorista. 2. Para adicionar uma linha de tendência, use a guia Análise no painel à esquerda e trace uma linha de tendência linear. Com o ponteiro do mouse sobre a linha de tendência, é possível ver que o valor R-quadrado é praticamente zero e o valor p está bem acima de qualquer limite de significância. Pode-se determinar que não há correlação entre os valores da primeira e da segunda multa. Se usarmos este gráfico de dispersão em um painel, a linha de tendências deve ser removida. ![Gráfico de dispersão dos valores da 1ª e 2ª multa por ID do motorista, com a dica de ferramenta da linha de tendência mostrando](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_1desktopII.png) 3\. Qual motorista pagou mais no total? Quem pagou menos? Quando queremos ir além em nossa análise, pode ser necessário criar alguns cálculos. 1. Para responder isso no Tableau Desktop, será necessário adicionar as multas das duas infrações em um único campo. Já que alguns motoristas podem não ter tido uma segunda infração, será necessário usar a função de zerar nulos `ZN` para transformar qualquer nulo de **2nd Fine Amount** (Valor da segunda multa) em zero. Não fazer isso resultará em nulos se não houver uma segunda multa. 2. O cálculo é: **Total Amount Paid** = `[1st Fine Amount] + ZN([2nd Fine Amount])` 3. É possível plotar **Valor total pago** com relação a **ID do motorista** e ordenar o gráfico de barras. ![Gráfico de barras do valor pago por ID do motorista, com o editor de cálculo mostrando o valor pago](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_1desktopIII.png) 4\. Quantos motoristas tinham vários tipos de infrações? 1. Para responder isso no Tableau Desktop, será necessário fazer um cálculo `IF` mais sofisticado, comparando se os tipos da primeira e da segunda infração são os mesmos. Se forem, o valor atribuído será "1”. Se não forem os mesmos, o valor atribuído será "2”. Como nos preocupamos apenas com vários tipos de infração, qualquer outro resultado, como um segundo tipo de infração nulo, receberá "1". 2. O cálculo é: **Number of Infraction Types** = IF \[1st Infraction Type\]=\[2nd Infraction Type\] THEN 1 ELSEIF \[1st Infraction Type\]!= \[2nd Infraction Type\] THEN 2 ELSE 1 END 3. Então é possível plotar **Número de tipos de infração** com relação a **ID do motorista** e ordenar o gráfico de barras. ![Gráfico de barras do número de tipos de infração por ID do motorista, com o editor de cálculo mostrando o número de tipos de infração](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_1desktopIV.png) 5\. Qual foi o valor médio da multa para os motoristas que nunca fizeram autoescola? 1. Para responder isso no Tableau Desktop, não é possível apenas dividir o valor total da multa por dois, já que alguns motoristas só possuem uma infração. Também não é possível calcular a multa média por motorista e fazer a média desses valores, pois calcular a média de outras médias pode levar a inconsistências. Em vez disso, será necessário calcular o valor total pago pelos motoristas que nunca fizeram autoescola, depois dividi-lo pelo número total de infrações associadas a essas multas. 1. Primeiro, precisamos determinar se cada motorista teve uma segunda infração. É possível aproveitar o fato de que as informações em todos os campos "2nd” serão nulas se não houver segunda infração e começar a criar o cálculo: `IFNULL([2nd Infraction Type], 'no')` Isso retornará um tipo de infração se ela existir, ou "no” se não houver segunda infração. 2. Em seguida, será necessário transformar essas informações no número de infrações, 1 ou 2. Se o resultado do nosso cálculo `IFNULL` é "no", então o motorista deve ser marcado como tendo uma multa. Qualquer outro resultado deve ser marcado como tendo duas multas. O cálculo é: **Number of Infractions** = IF IFNULL(\[2nd Infraction Type\], 'no') = 'no' THEN 1 ELSE 2 END 3. Agora, será necessário considerar o valor total da multa. De maneira similar à pergunta 3 acima, adicionaremos o valor da primeira e da segunda multa, com uma função `ZN` sendo usada no valor da segunda multa. No entanto, já que não desejamos que isso seja calculado no nível de todo o conjunto de dados, é uma prática recomendada especificar as agregações, SUM, no próprio cálculo. O cálculo é:  `SUM([1st Fine Amount]) + SUM( ZN([2nd Fine Amount]) )` 4. Para reunir tudo, pegamos esse valor total da multa e o dividimos pelo novo campo calculado **Número de infrações** para determinar o valor médio da multa: **Average Fine** = `( SUM([1st Fine Amount]) + SUM( ZN([2nd Fine Amount]) ) ) / SUM([Number of Infractions])` 2. Também será necessário filtrar os motoristas que já fizeram autoescola, mas essas informações também estão armazenadas em dois campos. 1. O Tableau é muito eficiente em cálculos numéricos. Vamos expressar isso com números para ajudar no desempenho o máximo possível. Para combinar esses dois campos, criaremos um cálculo para cada um que diz "Sim = 1” e "Não = 0” (nulo também deve ser = 0 para motoristas sem segunda infração). Ao somar o resultado desses cálculos, qualquer motorista com um valor total de 0 nunca fez autoescola (e um valor 1 ou 2 representa quantas vezes eles foram). Então é possível filtrar para manter apenas motoristas com um valor 0. 2. Desta vez, usaremos uma declaração `CASE` em vez de `IF`. Elas funcionam de maneira muito similar, mas têm sintaxes diferente. O começo do cálculo deve se parecer com isso: CASE \[1st Traffic School\] WHEN 'Yes' THEN 1 WHEN 'No' THEN ELSE 0 END 3. E então faremos o mesmo para a segunda autoescola. É possível adicionar as duas partes no mesmo cálculo ao envolver cada declaração case em parêntesis e adicionar um sinal de mais entre elas. Ao remover algumas das quebras de linhas, se parece com isso: **Number of Traffic School Attendances** = (CASE \[1st Traffic School\] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END) + (CASE \[2nd Traffic School\] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END) 4. Se arrastarmos o **Número de presenças na autoescola** até a área Dimensões do painel Dados (acima da linha), os valores de 0 a 2 se tornarão discretos. 5. Agora, se filtrarmos segundo **Número de presenças na autoescola**, podemos selecionar apenas os 0 e saber que temos apenas motoristas que nunca fizeram autoescola. 3. Para responder à pergunta original, apenas arrastaremos **Multa média** até a divisória Texto no cartão Marcas. Já que criamos as agregações no cálculo, a agregação na pílula será AGG e não é possível alterar isso. Isso é o esperado. ![Exibição de número único do valor médio pago com o editor de cálculo aberto para mostrar o Número de Frequências da Escola de Trânsito](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_1desktopV.png) ## Vá além—Dados dinamizados Embora os dados com que estivemos trabalhando fossem bem estruturados para abordar perguntas específicas a respeito da primeira e da segunda infração, essa não é a estrutura padrão recomendada para uso com o Tableau Desktop. Quanto mais a nossa análise diverge das perguntas básicas com relação às datas das infrações, mais complicados nossos cálculos se tornam para combinar as informações relevantes em uma forma útil. Usualmente, quando os dados são armazenados com várias colunas para o mesmo tipo de dados (como duas colunas para data, duas colunas para o valor da multa, entre outros) e informações únicas são armazenadas no nome do campo (como se é a primeira ou a segunda infração), isso é uma indicação de que os dados devem estar dinamizados. Realizar várias tabelas dinâmicas no Tableau Prep Builder pode lidar com isso muito bem. Podemos trabalhar no final do fluxo do Tableau Prep para **Infração de motorista** criado no tutorial anterior [Encontrar a Segunda data com o Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_tutorial_2nddateA.htm). > [!TIP] > > **Dica:** certifique-se de que tenha voltado ao Tableau Prep para os próximos passos. 1. Na última etapa de limpeza, adicione uma etapa de dinamização que dinamiza todos os campos duplicados. Use o ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) no canto superior direito da área Campos dinamizados para adicionar mais Valores dinâmicos. Cada conjunto de campos (como Valores da primeira e segunda multas) deve ser dinamizado junto. Para obter mais informações sobre tabela dinâmica, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Pivot). 2. Na área Campos dinamizados, sob a coluna Nomes da tabela dinâmica1, clique duas vezes em cada valor e renomeie-os para 1º e 2º lugar. ![Painel de configuração da Tabela dinâmica 1 no Tableau Prep mostrando as cinco tabelas dinâmicas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_2desktop.png) Os resultados podem ser limpos ao remover datas nulas assim como ao renomear e reordenar campos. 1. Adicione uma etapa de limpeza após a dinamização. Na coluna **Data da infração**, clique com o botão direito do mouse na barra de nulos e escolha Excluir. 2. Clique duas vezes no nome de campo **Pivot1 Names** e renomeie-o **Número da infração.** 3. Arraste campos como apropriado para reordená-los como abaixo: ![Visualização dos dados dinamizados e limpos](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_2desktopdata.png) 1. A partir dos novos dados dinâmicos, crie um resultado chamado **Infrações dinamizadas do motorista** e traga-o para o Tableau Desktop. (Não se esqueça de executar o fluxo após adicionar a etapa de Saída.) Agora podemos considerar as nossas cinco perguntas novamente com essa estrutura de dados dinamizada; é possível expandir cada uma para obter informações básicas sobre como proceder se você não conseguir seguir adiante. **Observação**: é possível baixar o arquivo de fluxo completo [Pivoted Driver Infractions.tflx](https://mkt.tableau.com/PrepTutorials/Pivoted%20Driver%20Infractions.tflx) para verificar o seu trabalho ou baixar a pasta de trabalho [Pivoted Driver Infractions.twbx](https://mkt.tableau.com/PrepTutorials/Pivoted%20Driver%20Infractions.twbx) para considerar as soluções dentro do contexto. Lembre-se de que pode haver maneiras alternativas de interpretar a análise ou de chegar às respostas. 1\. Qual foi a duração em dias entre a primeira e a segunda infração de cada motorista? 1. Para responder isso no Tableau Desktop, como fizemos com o primeiro conjunto de dados, usaremos a função `DATEDIFF` . Essa função requer uma data inicial e uma data final. Essas informações estão presentes em nossos dados, mas todas em um campo. Será necessário colocá-la em dois campos. 1. Crie dois campos calculados preliminares: **1st Infraction Date** = `IF [Infraction Number] = "1st" THEN [Infraction Date] END` **2nd Infraction Date** = `IF [Infraction Number] = "2nd" THEN [Infraction Date] END` 2. Já que desejamos garantir que esses valores estejam disponíveis para serem comparados para cada motorista, será necessário fixá-los no nível da **ID do motorista**. **Observação**: não acredita? Tente fazer um cálculo `DATEDIFF` com esses dois campos da seguinte maneira: **Time Between Infractions** = `DATEDIFF('day', [1st Infraction Date], [2nd Infraction Date])` Você obterá resultados nulos em todos os lugares, pois o Tableau está tentando comparar uma estrutura de dados que se parece com isso: ![tabela de texto mostrando resultados nulos](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_2desktopnulls.png) Aqui, a linha que sabe qual é a primeira data não sabe qual é a segunda data e vice-versa. Para resolver isso, usaremos uma expressão de nível de detalhe FIXED para forçar que essas primeira e segunda datas estejam relacionadas à **ID do motorista**. Edite cada cálculo como mostrado a seguir: **1st Infraction Date** = `{ FIXED [Driver ID] : MIN ( IF [Infraction Number] = "1st" THEN [Infraction Date] END ) }` **2nd Infraction Date** = `{ FIXED [Driver ID] : MIN ( IF [Infraction Number] = "2nd" THEN [Infraction Date] END ) }` **Observação**: o cálculo original `IF` deve ser agregado quando incorporado em uma expressão de LOD. É possível usar qualquer agregação básica que preserve o valor da data (então agregações como SUM, AVG ou MIN funcionam, mas não CNT ou CNTD). **Observação**: esses cálculos também podem ser criados no Tableau Prep Builder. Para obter mais informações sobre expressões LOD no Prep, consulte [Criar nível de detalhe, classificação e cálculos de bloco](https://help.tableau.com/current/prep/pt-br/prep_calculations.htm). 8. Agora, é possível criar o cálculo `DATEDIFF` com mostrado a seguir: **Time Between Infractions** = `DATEDIFF('day', [1st Infraction Date], [2nd Infraction Date])` - Se desejarmos considerar semanas ou meses, apenas modifique a parte da data (atualmente `'day'`). - Também seria possível criar um único cálculo para tudo colocando os cálculos FIXED diretamente dentro de DATEDIFF:  DATEDIFF ( 'day', { FIXED \[Driver ID\] : MIN ( IF \[Infraction Number\] = "1st" THEN \[Infraction Date\] END ) }, { FIXED \[Driver ID\] : MIN ( IF \[Infraction Number\] = "2nd" THEN \[Infraction Date\] END ) } ) 9. Faça a plotagem de **Tempo entre infrações** em Colunas e **ID do motorista** em Linhas. Os resultados serão idênticos aos dos resultados com a estrutura de dados não dinamizada. 2\. Compare os valores das multas da primeira e da segunda infração. Elas estão correlacionadas? 1. Para responder isso no Tableau Desktop, usaremos uma lógica muito similar a da pergunta anterior. Usaremos **Número da infração** para identificar se uma dada linha é a primeira ou a segunda infração, depois extrair o valor da multa de acordo com isso. 1. Se tudo o que queremos fazer é plotar um gráfico de dispersão, é possível pular a parte do LOD e apenas usar o cálculo `IF` : **1st Fine Amount** = `IF [Infraction Number] = "1st" THEN [Fine Amount] END` **2nd Fine Amount** = `IF [Infraction Number] = "2nd" THEN [Fine Amount] END` 2. No entanto, se desejarmos comparar e ver a diferença no valor entre a primeira e a segunda multa para um único motorista, encontraríamos o mesmo problema com os valores nulos que ocorreu com as datas. Não custa nada envolver esses cálculos em uma LOD `FIXED` , então pode ser melhor já fazer isso desde o começo: **1st Fine Amount** = `{ FIXED [Driver ID] : MIN ( IF [Infraction Number] = "1st" THEN [Fine Amount] END ) }` **2nd Fine Amount** = `{ FIXED [Driver ID] : MIN ( IF [Infraction Number] = "2nd" THEN [Fine Amount] END ) }` Esses cálculos também podem ser criados no Tableau Prep Builder. Para obter mais informações sobre expressões LOD no Prep, consulte [Criar nível de detalhe, classificação e cálculos de bloco](https://help.tableau.com/current/prep/pt-br/prep_calculations.htm). 3. Crie um gráfico de dispersão com o **Valor da primeira multa** em Colunas e o **Valor da segunda multa** em Linhas e exiba uma linha de tendência linear, como antes. Os resultados serão idênticos aos dos resultados com a estrutura de dados não dinamizada. 3\. Qual motorista pagou mais no total? Quem pagou menos? 1. Para responder a essa pergunta no Tableau Desktop, a estrutura de dados dinamizada é a ideal. Apenas será necessário incluir **ID do motorista** e **Valor da multa** em um gráfico de barras. A agregação padrão já é SUM, então o valor total pago pelo motorista será automaticamente plotado. Os resultados serão idênticos aos dos resultados com a estrutura de dados não dinamizada. 4\. Quantos motoristas tinham vários tipos de infrações? 1. Para responder a essa pergunta no Tableau Desktop, a estrutura de dados dinamizada é a ideal. Apenas será necessário traçar **ID do motorista** e um Contagem distinta de **Tipo da infração** como um gráfico de barras e teremos nossa resposta. Os resultados serão idênticos aos dos resultados com a estrutura de dados não dinamizada. 5\. Qual foi o valor médio da multa para os motoristas que nunca fizeram autoescola? 1. Para responder isso no Tableau Desktop, não é possível apenas dividir o valor total da multa por dois, já que alguns motoristas só possuem uma infração. Também não é possível calcular a multa média por motorista e fazer a média desses valores, pois calcular a média de outras médias pode levar a inconsistências. Em vez disso, será necessário calcular o valor total pago pelos motoristas que nunca fizeram autoescola, depois dividi-lo pelo número total de infrações associadas a essas multas. 1. Primeiro, precisamos determinar se cada motorista teve uma segunda infração. É possível aproveitar o fato de que **Data da segunda infração** será nula se não houver segunda infração e começar a criar o cálculo: `IFNULL(STR([2nd Infraction Date]), 'no')` Isso retornará um tipo de infração se ela existir, ou "no” se não houver segunda infração. **Observação**: a porção `STR` deste cálculo é necessária porque `IFNULL` precisa de consistência de tipo de dados em seus argumentos. Já que desejamos retornar a cadeia de caracteres "no” para valores nulos, também será necessário converter a data em uma cadeia de caracteres. 2. Em seguida, será necessário transformar essas informações no número de infrações, 1 ou 2. Se o resultado do nosso cálculo `IFNULL` é "no", então o motorista deve ser marcado como tendo uma multa. Qualquer outro resultado deve ser marcado como tendo duas multas. O cálculo é: **Number of Infractions** = IF IFNULL(STR(\[2nd Infraction Date\]), 'no')= 'no' THEN 1 ELSE 2 END 3. Agora, será necessário considerar o valor médio da multa. Já temos um único campo para **Valor da multa**. Apenas será necessário dividi-lo pelo novo campo **Número de infrações** e envolver os dois em SUM:  **Average Fine** = `(SUM([Fine Amount]) / SUM([Number of Infractions])` 2. Também precisamos filtrar os motoristas que fizeram autoescola. Parece que poderíamos usar o campo **Autoescola** e filtrar por **Autoescola = não**. No entanto, isso filtraria _infrações_ não associadas à autoescola, não _motoristas_ que nunca frequentaram a autoescola. Se um motorista voltou à autoescola por causa de uma infração, mas não pela outra, não queremos que nenhuma das infrações seja considerada aqui. Como o motorista foi à autoescola, ele não se encaixa nos parâmetros da pergunta. O que desejamos fazer é filtrar qualquer motorista que tenha feito autoescola. Em termos de dados, desejamos filtrar qualquer motorista que tenha um "Yes" em **Traffic School** em qualquer linha, independentemente de qual infração está associada. Vamos criar nosso cálculo em estágios, em uma exibição simples para ajudar a visualizar o que está acontecendo: 1. Primeiro, desejamos saber se um motorista tem um "Yes" em Traffic School. Arraste **ID do motorista** até Linhas e **Autoescola** até Colunas. Obteremos uma tabela de texto como um texto de espaço reservado "Abc” que indica os valores relevantes para cada motorista. 2. Em seguida, desejamos criar um cálculo que identifique se o valor de **Autoescola** é "Yes". O primeiro estágio do cálculo é: **Attended Traffic School** = `CONTAINS([Traffic School), 'Yes')` Se arrastarmos **Fez autoescola** até a divisória Cor no cartão Marcas, veremos que ela rotula de maneira precisa como "False" cada marca na coluna "No" e como "True" cada marca na coluna "Yes". ![Uma visualização com rótulos "Falso" para cada marca na coluna "Não", e rótulos "Verdadeiro" para cada marca na coluna "Sim".](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_pivotedV2.png "Uma exibição da ID do Motorista pela Escola de Trânsito, com Escola de Trânsito Frequentada em Cores") 3. No entanto, o que realmente desejamos são estas informações no nível do _motorista_, não da _infração_. Uma expressão de LOD é uma resposta natural ao tentar calcular um resultado em um nível de detalhe diferente da estrutura básica dos dados. Faremos desta uma expressão de LOD `FIXED` . Mas, como sabemos, a porção da expressão agregada de uma LOD deve ser agregada. Previamente, usamos MIN. Isso funcionará aqui? Modificaremos o cálculo da maneira a seguir:  **Attended Traffic School** = `{ FIXED [Driver ID] : MIN( CONTAINS([Traffic School], 'Yes'))}` ![Uma exibição da ID do Motorista pela Escola de Trânsito, com Escola de Trânsito Frequentada em Cores](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_pivotedV3.png) Com essa alteração aplicada na exibição, veremos o oposto do que desejamos. Qualquer motorista que tenha um "No” é marcado como "False” em todos os lugares. Em vez disso, desejamos ter o "Yes” como um "True” em todos os registros para aquele motorista. O que o MIN está fazendo aqui? Ele está retornando a primeira resposta em ordem alfabética, que é, "No”. 4. E se o alterássemos para MAX? Isso retornaria a última resposta em ordem alfabética? Modificaremos o cálculo da maneira a seguir:  **Attended Traffic School** = `{ FIXED [Driver ID] : MAX ( CONTAINS( [Traffic School], 'Yes') ) }` ![Uma exibição da ID do Motorista pela Escola de Trânsito, com Escola de Trânsito Frequentada em Cores](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_pivotedV4.png) E aqui temos a resposta que desejamos, se um motorista tem "Yes” em qualquer lugar dos dados, ele é marcado como "True” por ter feito autoescola, mesmo em infrações que não envolvam a autoescola. 5. Se arrastarmos **Fez autoescola** até a divisória Filtros e selecionarmos apenas "False", ficaremos apenas com motoristas que nunca fizeram autoescola. 3. Para responder à pergunta original, com o nosso filtro em ação apenas arrastaremos **Multa média** até a divisória Texto no cartão Marcas. Já que criamos as agregações no cálculo, a agregação no campo será AGG e não é possível alterar isso. Isso é o esperado. Os resultados serão idênticos aos dos resultados com a estrutura de dados não dinamizada. ### Vantagens dos dados dinamizados Poderíamos continuar com a estrutura de dados original do tutorial se soubéssemos que apenas precisaríamos responder perguntas fáceis de responder com essa estrutura. No entanto, o formato de dados dinamizado é mais flexível. Mesmo que ele requeira alguns cálculos, uma vez que eles estejam em ação o conjunto de dados resultante é bem adequado para responder a perguntas mais amplas. ## Vá mais além—Somente cálculos E se você não tiver acesso ao Tableau Prep Builder? Você está totalmente sem sorte se estiver preso aos dados originais? De maneira alguma! O Tableau Desktop e as expressões de LOD podem responder a todas as nossas perguntas de análise. Se nos conectarmos a [**Traffic Violations.xlsx**](https://mkt.tableau.com/PrepTutorials/Traffic%20Violations.xlsx) original, a sua aparência é muito similar ao conjunto de dados dinamizados—apenas sem o campo essencial **Número da infração**. Precisaremos imitar o resultado das etapas de agregação por meio de expressões de LOD. **Observação**: é possível baixar a pasta de trabalho [LOD Driver Infractions.twbx](https://mkt.tableau.com/PrepTutorials/LOD%20Driver%20Infractions.twbx) para considerar as soluções dentro do contexto. Lembre-se de que pode haver maneiras alternativas de interpretar a análise ou de chegar às respostas. 1\. Qual foi a duração em dias entre a primeira e a segunda infração de cada motorista? 1. Para responder isso no Tableau Desktop, usaremos novamente a função `DATEDIFF` . Essa função requer uma data inicial e uma data final. Essas informações estão presentes em nossos dados, mas todas em um campo. Será necessário colocá-la em dois campos. Já que desejamos garantir que esses valores estejam disponíveis para serem comparados para cada motorista, será necessário fixá-los no nível da **ID do motorista**. 1. Para encontrar a data da primeira infração, usamos o cálculo: **1st Infraction** = `{ FIXED [Driver ID] : MIN ( [Infraction Date] ) }` 2. Descobriremos a data da segunda infração em estágios. 1. Para começar, será necessário considerar apenas as datas que são maiores do que a primeira data: `IF [Infraction Date] > [1st Infraction] THEN [Infraction Date] END` 2. Mas isso nos dará como resposta _todas_ as infrações após a primeira e apenas desejamos a segunda. Então desejamos a menor dessas datas. Envolva tudo com MIN: `MIN( IF [Infraction] : [1st Infraction] THEN [Infraction Date] END )` 3. Também desejamos recalcular a segunda data de infração para cada motorista. É aqui que entram as expressões de LOD. Corrigiremos isso no nível de **Driver ID**: **2nd Infraction** = `{ FIXED [Driver ID] : MIN ( IF [Infraction Date] > [1st Infraction] THEN [Infraction Date] END ) }` 3. E agora é possível criar o cálculo `DATEDIFF` : **Time Between Infractions** = `DATEDIFF('day', [1st Infraction], [2nd Infraction])` Os resultados serão idênticos aos dos resultados com as outras duas estruturas de dados. 2\. Compare os valores das multas da primeira e da segunda infração. Elas estão correlacionadas? 1. Para responder isso no Tableau Desktop, usaremos uma lógica muito similar a da versão com dados dinamizados da pergunta. Usaremos os campos **Primeira infração** e **Segunda infração** criados para a pergunta 1 para identificar se uma dada linha é a primeira ou a segunda infração, depois extrair o valor da multa de acordo com isso. 1. Se tudo o que queremos fazer é plotar um gráfico de dispersão, é possível pular a parte do LOD e apenas usar um cálculo `IF` : **1st Fine Amount** = `IF [1st Infraction] = [Infraction Date] THEN [Fine Amount] END` **2nd Fine Amount** = `IF [2nd Infraction] = [Infraction Date] THEN [Fine Amount] END` 2. No entanto, se desejarmos comparar e ver a diferença no valor entre a primeira e a segunda multa para um único motorista, encontraríamos o mesmo problema com os valores nulos que ocorreu na primeira estrutura de dados. Não custa nada envolver esses cálculos um uma LOD FIXED, então pode ser melhor já fazer isso desde o começo: **1st Fine Amount** = ``{ FIXED [Driver ID] : MIN ( `IF [1st Infraction] = [Infraction Date] THEN [Fine Amount] END` ) }`` **2nd Fine Amount** = ``{FIXED [Driver ID] : MIN( `IF [2ndInfraction] = [Infraction Date] THEN [Fine Amount] END` ) }`` Os resultados serão idênticos aos dos resultados com as outras duas estruturas de dados. 3\. Qual motorista pagou mais no total? Quem pagou menos? 1. Para responder isso no Tableau Desktop, primeiro será necessário entender algo sobre o método que usa somente LOD. Os dois métodos que usam o Tableau Prep filtram os registros que não são a primeira ou a segunda infração de um motorista. O método de LOD no Tableau Desktop mantém todos os registros. Isso significa que se criássemos uma visualização de **SUM(Amount Paid)** (Soma, valor pago) por **ID do motorista**, a versão apenas com o Tableau Desktop mostrará quantidades maiores para motoristas com mais de duas infrações. Para obter um valor de **Valor total pago** pelos dados completos que corresponda aos outros métodos, em vez de usar o campo original **Valor da multa**, será necessário somar a primeira e a segunda multa como fizemos com a primeira estrutura de dados. 2. Usando os campos que criamos para a pergunta 2, somaremos os dois valores da multa. `ZN`  é necessário para evitar um resultado nulo para qualquer motorista que tenha apenas uma infração. O cálculo é:  **Total Amount Paid** = `[1st Fine Amount] + ZN([2nd Fine Amount])` Os resultados serão idênticos aos dos resultados com as outras duas estruturas de dados. 4\. Quantos motoristas tinham vários tipos de infrações? 1. Para responder a essa pergunta no Tableau Desktop, não é possível apenas traçar **ID do motorista** e uma Contagem distinta de **Tipo da infração**. Já que esse conjunto de dados tem infrações além da segunda, alguns motoristas podem ter mais do que dois tipos de infração. Para que os resultados correspondam aos dos outros métodos, será necessário limitar o escopo apenas para as duas primeiras infrações. 1. É possível extrair o primeiro e o segundo tipo de infração, envolve-los em expressões de LOD para torná-los `FIXED` ao motorista, depois usar um cálculo `IF` para contar os tipos: 1. **1st Infraction Type** = `{ FIXED [Driver ID] : MIN ( IF [1st Infraction] = [Infraction Date] THEN [Infraction Type] END ) }` 2. **2nd Infraction Type** = `{ FIXED [Driver ID] : MIN ( IF [2nd Infraction] = [Infraction Date] THEN [Infraction Type] END ) }` 3. **Number of Infraction Types** = IF \[1st Infraction Type\] = \[2nd Infraction Type\] THEN 1 ELSEIF \[1st Infraction Type\] != \[2nd Infraction Type\] THEN 2 ELSE 1 END **Observação**: também é possível criar muitos desses cálculos como um único campo ao aninhar os cálculos iniciais diretamente no cálculo maior. Aqui, o cálculo combinado teria essa aparência: `IF {FIXED [Driver ID] : MIN(IF [1st Infraction]=[Infraction Date] THEN [Infraction Type] END)} = {FIXED [Driver ID] : MIN(IF [2nd Infraction]=[Infraction Date] THEN [Infraction Type] END)} THEN 1 ELSEIF {FIXED [Driver ID] : MIN(IF [1st Infraction]=[Infraction Date] THEN [Infraction Type] END)} != {FIXED [Driver ID] : MIN(IF [2nd Infraction]=[Infraction Date] THEN [Infraction Type] END)} THEN 2 ELSE 1 END` Que é um pouco mais difícil de entender, mas funciona se preferir. (Observe que as quebras de linha e alguns espaços não influenciam em como um cálculo é interpretado pelo Tableau.) 2. Então é possível plotar **Número de tipos de infração** com relação a **ID do motorista** e ordenar o gráfico de barras. Os resultados serão idênticos aos dos resultados com as outras duas estruturas de dados. 5\. Qual foi o valor médio da multa para os motoristas que nunca fizeram autoescola? 1. Para responder isso no Tableau Desktop, não é possível apenas dividir o valor total da multa por dois, já que alguns motoristas só possuem uma infração. Também não é possível calcular a multa média por motorista e fazer a média desses valores, pois calcular a média de outras médias pode levar a inconsistências. Em vez disso, será necessário calcular o valor total pago pelos motoristas que nunca fizeram autoescola, depois dividi-lo pelo número total de infrações associadas a essas multas. 1. Primeiro, precisamos determinar se cada motorista teve uma segunda infração. É possível aproveitar o fato de que as informações em todos os campos "2nd” serão nulas se não houver segunda infração e começar a criar o cálculo: `IFNULL([2nd Infraction Type], 'no')` Isso retornará um tipo de infração se ela existir, ou "no” se não houver segunda infração. 2. Em seguida, será necessário transformar essas informações no número de infrações, 1 ou 2. Se o resultado do nosso cálculo `IFNULL` é "no", então o motorista deve ser marcado como tendo uma multa. Qualquer outro resultado deve ser marcado como tendo duas multas. O cálculo é: **Number of Infractions** = IF IFNULL(\[2nd Infraction Type\], 'no') = 'no' THEN 1 ELSE 2 END 3. Para o valor total pago, é possível usar o cálculo da pergunta 3. Para reunir tudo, pegamos esse valor total da multa e o dividimos pelo novo campo calculado **Número de infrações** para determinar o valor médio da multa: **Average Fine** = `SUM([Total Amount Paid]) / SUM([Number of Infractions])` 2. Também precisamos filtrar os motoristas que fizeram autoescola. Já que esse conjunto de dados contém alguns motoristas com uma terceira ou quarta infração, não é possível usar o mesmo método que o usado para a estrutura de dados dinamizada. Em vez disso, seguiremos o mesmo método usado para os dados não dinamizados, resumido aqui: 1. Primeiro, será necessário criar dois cálculos que identifiquem se a primeira e a segunda infração envolveram autoescola ou não:  **1st Traffic School** = `{ FIXED [Driver ID] : MIN (IF [1st Infraction] = [Infraction Date] THEN [Traffic School] END ) }` **2nd Traffic School** = `{ FIXED [Driver ID] : MIN (IF [2nd Infraction] = [Infraction Date] THEN [Traffic School] END ) }` 2. Então adicionaremos esses valores para obter o número total de pessoas que fizeram autoescola:  **Number of Traffic School Attendances** = (CASE \[1st Traffic School\] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END) + (CASE \[2nd Traffic School\] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END) 3. Se arrastarmos o **Número de presenças na autoescola** até a área Dimensões do painel Dados, os valores de 0 a 2 se tornarão discretos. 4. Agora, se filtrarmos segundo **Número de presenças na autoescola**, podemos selecionar apenas os 0 e saber que temos apenas motoristas que nunca fizeram autoescola. 3. Para responder à pergunta original, apenas arrastaremos **Multa média** até a divisória Texto no cartão Marcas. Já que criamos as agregações no cálculo, a agregação no campo será AGG e não é possível alterar isso. Isso é o esperado. Os resultados serão idênticos aos dos resultados com as outras duas estruturas de dados. É importante lembrar que esta solução tem muitos cálculos aninhados e expressões de LOD. Dependendo do tamanho do conjunto de dados e da complexidade dos dados, o desempenho pode ser prejudicado. ## Reflexão sobre métodos Que caminho você deve seguir? Isso só depende de você e das ferramentas a sua disposição. - Se desejar ficar longe de LODs, há uma solução de formação de dados, embora cálculos possam ser necessários para algumas análises ([Análise no Tableau Desktop](#Desktop)). - Se é possível formar os dados e você se sente confortável em fazer cálculos—inclusive LODs—a segunda opção oferece a maior flexibilidade ([Vá além—Dados dinamizados](#Further)). - Se você se sente confortável com LODs, há uma influência mínima no desempenho e/ou você não tem acesso ao Tableau Prep, resolver isso apenas com LODs é uma opção viável ([Vá mais além—Somente cálculos](#Furtherer)). No mínimo, valer a pena entender como a agregação no Tableau Prep e as expressões de nível de detalhe no Tableau Desktop estão interrelacionadas e influenciam na análise de dados. Assim como na maioria das vezes no Tableau, há mais de uma maneira de se fazer o que for necessário. Explorar todas as várias opções pode ajudar a reunir conceitos e permitir que você escolha a melhor solução para você. Os cálculos usaram: ### Infrações dos motoristas - **Time Between Infractions** = `DATEDIFF('day', [1st Infraction Date], [2nd Infraction Date])` - **Total Amount Paid** =`[1st Fine Amount] + ZN([2nd Fine Amount])` - **Number of Infraction Types** = `IF [1st Infraction Type]=[2nd Infraction Type] THEN 1 ELSEIF [1st Infraction Type]!= [2nd Infraction Type] THEN 2 ELSE 1 END` - **Number of Infractions** = `IF IFNULL([2nd Infraction Type], 'no') = 'no' THEN 1 ELSE 2 END` - **Average Fine** = `( SUM([1st Fine Amount]) + SUM( ZN([2nd Fine Amount]) ) ) / SUM([Number of Infractions])` - **Number of Traffic School Attendances** = `(CASE [1st Traffic School] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END) + (CASE [2nd Traffic School] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END)` ### Infrações dinamizadas dos motoristas - **1st Infraction** = `{FIXED [Driver ID] : MIN(IF [Infraction Number] = "1st" THEN [Infraction Date] END)}` - **2nd Infraction** = `{FIXED [Driver ID] : MIN(IF [Infraction Number] = "2nd" THEN [Infraction Date] END)}` - **Time Between Infractions** = `DATEDIFF('day', [1st Infraction], [2nd Infraction])` - **1st Fine Amount** = `{FIXED [Driver ID] : MIN( IF [Infraction Number] = "1st" THEN [Fine Amount] END ) }` - **Number of Infractions** = `IF IFNULL(STR([2nd Infraction]), 'no')= 'no' THEN 1 ELSE 2 END` - **Average Fine** = `SUM([Fine Amount])/SUM([Number of Infractions])` - **Attended Traffic School** = `{ FIXED [Driver ID] : MAX( CONTAINS([Traffic School], 'Yes'))}` ### Infrações dos motoristas com LOD - **1st Infraction** = `{FIXED [Driver ID] : MIN([Infraction Date])}` - **2nd Infraction** = `{ FIXED [Driver ID] : MIN( IF [Infraction Date] > [1st Infraction] THEN [Infraction Date] END ) }` - **Time Between Infractions** = `DATEDIFF('day', [1st Infraction], [2nd Infraction])` - **1st Fine Amount** = `{FIXED [Driver ID] : MIN( IF [1st Infraction] = [Infraction Date] THEN [Fine Amount] END ) }` - **2nd Fine Amount** = `{FIXED [Driver ID] : MIN( IF [2nd Infraction] = [Infraction Date] THEN [Fine Amount] END ) }` - **Total Amount Paid** = `[1st Fine Amount] + ZN([2nd Fine Amount])` - **1st Infraction Type** = `{FIXED [Driver ID] : MIN( IF [1st Infraction] = [Infraction Date] THEN [Infraction Type] END ) }` - **2nd Infraction Type** = `{FIXED [Driver ID] : MIN( IF [2nd Infraction] = [Infraction Date] THEN [Infraction Type] END ) }` - **Number of Infraction Types** = `IF [1st Infraction Type]=[2nd Infraction Type] THEN 1 ELSEIF [1st Infraction Type]!= [2nd Infraction Type] THEN 2 ELSE 1 END` - **Number of Infractions** = `IF IFNULL([2nd Infraction Type], 'no') = 'no' THEN 1 ELSE 2 END` - **Average Fine** = `SUM ([Total Amount Paid]) / SUM([Number of Infractions])` - **1st Traffic School** = `{FIXED [Driver ID] : MIN (IF [1st Infraction] = [Infraction Date] THEN [Traffic School] END ) }` - **2nd Traffic School** = `{FIXED [Driver ID] : MIN (IF [2nd Infraction] = [Infraction Date] THEN [Traffic School] END ) }` - **Number of Traffic School Attendances** = `(CASE [1st Traffic School] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END) + (CASE [2nd Traffic School] WHEN 'Yes' THEN 1 WHEN 'No' THEN 0 ELSE 0 END)` **Observação**: agradecimento especial ao tópico do Workout Wednesday da Ann Jackson [Os clientes gastam mais na primeira ou na segunda compra?](https://www.workout-wednesday.com/2018/06/13/week-24-do-customers-spend-more-on-their-first-or-second-purchase/) e a dica para o Tableau Prep do Andy Kriebel [Retornar a primeira e a segunda data de compra](https://www.vizwiz.com/2018/06/first-second-purchase.html?m=1), que forneceram a inspiração inicial para este tutorial. Clicar nestes links o levará para fora do site do Tableau. A Tableau não pode ser responsabilizada pela exatidão ou pela atualidade de páginas mantidas por provedores externos. Entre em contato com os proprietários se você tiver dúvidas a respeito do conteúdo deles. [Pular para o conteúdo principal](#main-content) # Atualizar arquivos de saída de fluxo a partir da linha de comando _Compatível com o Tableau Prep Builder somente._ É possível executar o fluxo a partir da linha de comando para atualizar a saída de fluxo em vez de executar o fluxo a partir do Tableau Prep Builder. Você pode executar um fluxo de cada vez usando esse método. Essa opção está disponível em computadores com Windows ou Mac onde o Tableau Prep Builder está instalado. Para obter uma lista de todas as opções de linha de comando com suporte no Tableau Prep, consulte [Referência de linha de comando do Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_command_line_reference.htm). **Observação**: se você estiver usando o Gerenciamento de licença com base em login (LBLM), certifique-se de abrir periodicamente o Tableau Prep e entrar no ambiente do Tableau Server ou no site do Tableau Cloud que você usou para ativar. Caso contrário, a concessão pode expirar, fazendo com que os fluxos executados por meio da linha de comando falhem. Você também pode entrar em contato com o administrador para alterar a duração da concessão para a duração máxima. Consulte [Gerenciamento de licença com base em login](https://help.tableau.com/current/server/pt-br/license_lblm.htm). **Limitações do conector:** - **Conectores JDBC ou ODBC**: os fluxos que incluem esses conectores podem ser executados pela linha de comando a partir da versão 2019.2.3. - **Conectores de nuvem**: os fluxos que incluem conectores de nuvem, como o Google BigQuery, não podem ser executados pela linha de comando. Em vez disso, execute o fluxo manualmente ou em uma agenda no Tableau Server ou no Tableau Cloud usando o Tableau Prep Conductor. Para obter mais informações, consulte [Manter dados de fluxo atualizados](https://help.tableau.com/current/prep/pt-br/prep_conductor_overview.htm). - **Autenticação de logon único**: a execução de fluxos a partir da linha de comando não é compatível se você usar a autenticação de logon único. Em vez disso, é possível executar os fluxos do Tableau Prep Builder. - **Autenticação multifator**: a interface de linha de comando (CLI) do Tableau Prep não oferece suporte ao Tableau com autenticação multifator (MFA). Para obter mais informações, consulte [Não foi possível publicar o fluxo do Tableau Prep usando a linha de comando após habilitar o MFA no Tableau Cloud](https://help.salesforce.com/s/articleView?id=001534203&type=1) na Base de dados de conhecimento do Tableau. Para computadores Windows, também é possível agendar esse processo usando o Agendador de tarefas do Windows. Para obter mais informações, consulte [Agendador de tarefas](https://docs.microsoft.com/pt-br/windows/desktop/taskschd/task-scheduler-start-page) na ajuda on-line da Microsoft. Ao executar fluxos a partir da linha de comando, o Tableau Prep Builder atualiza todas as saídas do fluxo usando as configurações das etapas de saída especificadas no Tableau Prep Builder. Para obter mais informações sobre como especificar os locais de saída, consulte [Criar arquivos de extração de dados e fontes de dados publicadas](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#Extract). Para obter informações sobre como definir as opções de gravação (versão 2020.2.1 e posteriores), consulte [Configurar opções de gravação](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm#flow-writeoptions). ## Antes de executar o fluxo Para executar o fluxo a partir da linha de comando, você precisará de privilégios de administrador na máquina onde está executando o fluxo, e precisará das seguintes informações: - O caminho onde o Tableau Prep Builder está instalado. - Se você estiver se conectando a bancos de dados e publicando arquivos de saída em um servidor ou um banco de dados (versão 2020.3.1 e posterior), crie um arquivo .json de credenciais que inclua todas as credenciais necessárias. - O caminho onde o arquivo de fluxo do Tableau (.tfl) está localizado. ### Requisitos de arquivos de credenciais .json **Observação:** os arquivos de credenciais .json não são necessários se o fluxo se conectar a ou resultar em arquivos de saída, arquivos armazenados em um compartilhamento de rede ou arquivos de entrada que usam a Autenticação do Windows (SSPI). Para obter mais informações sobre a Autenticação do Windows, consulte [Modelo SSPI](https://docs.microsoft.com/pt-br/windows/desktop/SecAuthN/sspi-model) na ajuda on-line da Microsoft. O Tableau Prep Builder usa informações do arquivo de fluxo e do arquivo .json de credenciais para executar o fluxo quando você tiver conexões remotas. Por exemplo, o nome do banco de dados das conexões remotas e o nome do projeto dos arquivos de saída são provenientes do fluxo; o nome do servidor e as credenciais de logon são provenientes do arquivo .json de credenciais. - Caso planeje reusar o arquivo, coloque-o em uma pasta onde ele não seja substituído pelo processo de instalação do Tableau Prep Builder. - Se você estiver executando um fluxo que abranja qualquer uma das situações abaixo, precisará acrescentar um arquivo .json que contenha as credenciais necessárias para se conectar. - Conexão com arquivos de banco de dados ou fontes de dados publicadas. - A saída é publicada em um servidor ou em um banco de dados (versão 2020.3.1 e posteriores). - O fluxo inclui etapas de script para Rserve ou TabPy. O arquivo .json deve incluir as credenciais necessárias para se conectar a esses serviços. Para obter mais informações, consulte os requisitos de matriz da sua versão abaixo. - As credenciais especificadas no fluxo e as credenciais incluídas no seu arquivo .json devem coincidir; caso contrário, o fluxo não será executado. - Ao executar o processo, o nome de host, a porta e o nome de usuário são usados para encontrar a conexão correspondente no arquivo de fluxo do Tableau (tfl) e atualizados antes de executar o processo. A ID da porta e a ID do site são opcionais se suas conexões não solicitarem essas informações. - Se estiver se conectando a uma fonte de dados publicada, inclua hostname, contentUrl e porta (80 para http e 443 para https) nas conexões de entrada. O nome do host é necessário para localizar a conexão correspondente no arquivo de fluxo do Tableau (TFL), e o contentUrl e a porta são usados para estabelecer a conexão com o servidor. - Se você se conectar ao Tableau Cloud, inclua a porta (80 ou 443) nas conexões de entrada do pod ao qual está se conectando e na URL de conexões do servidor, certifique-se de incluir o prefixo pod correspondente junto com online.tableau.com. Para obter mais informações sobre o Tableau Cloud, consulte as [Conexões do Tableau Bridge com o Tableau Cloud](https://help.tableau.com/current/online/pt-br/to_keep_data_fresh.htm#tableau-bridge-connections-to-tableau-online) na Ajuda do Tableau Cloud. - (versão 2021.4.1 e posterior) Se você incluir parâmetros em seu fluxo, poderá criar e incluir um arquivo .json de substituição de parâmetros na linha de comando, para alterar os valores de parâmetro dos valores padrão atuais. Para obter mais informações, consulte [Execute fluxos que incluem valores de parâmetro](#flow_parameters). Dependendo da sua versão do Tableau Prep Builder, suas informações de credencial podem ser formatadas de forma diferente. Clique na guia abaixo para visualizar o formato de credencial para sua versão do Tableau Prep Builder. Dependendo de suas conexões, inclua suas credenciais de servidor ou banco de dados ou de ambos. Quando seu fluxo se conecta a e resulta no mesmo servidor ou banco de dados, você só precisa incluir um único bloco no arquivo .json. Se você se conectar a um servidor ou banco de dados que usa diferentes credenciais, use uma matriz delimitada por vírgula.
Conexões de servidorConexões de banco de dadosConexões Rserver ou Tableau Python

Nome do bloco de conexão: "tableauServerConnections"

Inclua os seguintes dados na matriz:

  • serverUrl (Nome do servidor) Para o Tableau Cloud, inclua o prefixo pod correspondente junto com online.tableau.com. Por exemplo, "https://10az.online.tableau.com"
  • contentUrl (ID do site. Isso aparece depois de /site/ na URL do Tableau Server ou do Tableau Cloud. Por exemplo, "https://my.server/#/site/mysite", defina "contentUrl": "mysite".))
  • porta (ID da porta)
  • username
  • senha

Nome do bloco de conexão: "databaseConnections"

Inclua os seguintes dados na matriz:

  • hostname (nome do servidor)
  • porta (ID da porta)
  • username
  • senha

Só inclua essa matriz se o seu fluxo tiver etapas de script para R ou TabPy.

Nome do bloco de conexão: "extensions"

Inclua os seguintes dados na matriz:

  • extensionName: especifique "rSupport" ou "pythonSupport"
  • regular: inclua "host" e "port". Você também pode incluir "username" (nome de usuário) ou "sslCertificate" (conteúdo do seu arquivo público .pem codificado como cadeia de caracteres base64) se aplicável.
  • sensitive: inclua "password" se você usar uma senha. Caso contrário, inclua uma matriz em branco.
**Observação**: ContentUrl é sempre necessário no arquivo .json para conexões do servidor. Se estiver se conectando a um site padrão, por exemplo, "https://my.server/#/site/", defina ContentUrl como em branco. Por exemplo, `"contentUrl": ""` ### Execute fluxos que incluem valores de parâmetro _Com suporte no Tableau Prep Builder versão 2021.4.1 e posteriores._ Para executar fluxos da linha de comando que incluem valores de parâmetro, você pode criar um arquivo de substituição de parâmetros .json que inclui os valores de parâmetro que deseja usar. Esses valores substituem os valores atuais (padrão) definidos para os parâmetros. Este é um arquivo separado do arquivo credentials.json e inclui os nomes e valores dos seus parâmetros. **Observação**: a partir da versão 2022.1.1, os valores dos parâmetros não precisam mais ser colocados entre aspas. Nas versões anteriores, todos os nomes e valores de parâmetros devem incluir aspas. **Exemplo**: { "Parameter 1": Value 1, "Number Parameter": 40, "Boolean Parameter": True } Ao executar o fluxo, inclua -p --parameters e o nome do seu arquivo na linha de comando. **Exemplos:** **Windows** ``` "\[Tableau Prep Builder install location]\Tableau Prep Builder \scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json ``` ### Exemplos Esta seção mostra exemplos diferentes de arquivos de credenciais que você pode criar usando os requisitos de credenciais .json. #### Conectar-se a um servidor Este exemplo mostra um arquivo de credenciais .json que se conecta a e resulta em uma conexão de servidor que usa as mesmas credenciais: { "tableauServerConnections":\[ { "serverUrl":"https://my.server", "contentUrl": "mysite", "port":443, "username": "jsmith", "password": "passw0rd$" } \] } #### Conectar-se a uma conexão de servidor e saída para uma conexão de banco de dados Este exemplo mostra um arquivo de credenciais .json que se conecta a um servidor e resulta em uma conexão de banco de dados: { "tableauServerConnections":\[ { "serverUrl":"https://my.server", "contentUrl": "mysite", "port":443, "username": "jsmith", "password": "passw0rd$" } \], "databaseConnections":\[ { "hostname":"example123.redshift.amazonaws.com", "port":"5439", "username":"jsmith", "password":"p@s$w0rd!" } \] } #### O fluxo inclui conexões de script Rserve e TabPy e saídas para uma conexão de banco de dados Este exemplo mostra um arquivo de credenciais .json que inclui credenciais Rserve e TabPy e resulta em uma conexão a um banco de dados: { "extensions": \[ { "extensionName": "rSupport", "regular": { "host": "localhost", "port": "9000", "username": "jsmith" }, "sensitive": { "password": "pwd" } }, { "extensionName": "pythonSupport", "regular": { "host": "localhost", "port": "9000" }, "sensitive": { } } \], "databaseConnections":\[ { "hostname":"example123.redshift.amazonaws.com", "port": "5439", "username": "jsmith", "password": "p@s$w0rd!" }, { "hostname":"mysql.mydb.tsi.lan", "port": "3306", "username": "jsmith", "password": "mspa$$w0rd" } \] } #### Conectar a e resultar em diferentes conexões de banco de dados Este exemplo mostra um arquivo de credenciais .json que se conecta a e resulta em diferentes conexões de banco de dados: { "databaseConnections":\[ { "hostname":"example123.redshift.amazonaws.com", "port": "5439", "username": "jsmith", "password": "p@s$w0rd!" }, { "hostname":"mysql.mydb.tsi.lan", "port": "3306", "username": "jsmith", "password": "mspa$$w0rd" } \] } Digite uma matriz para suas conexões de entrada e saída. **Observação**: se você usar o Tableau Prep Builder versão 2018.2.2 à 2018.3.1, sempre inclua as matrizes "inputConnections" e "outputConnections", mesmo se o fluxo não tiver conexões remotas para entradas e saídas. Deixe essas matrizes em branco. Se você estiver usando o Tableau Prep Builder versão 2018.3.2 e posteriores, não será necessário incluir matrizes em branco.
Conexões de entradaConexões de saídaConexões Rserver ou Tableau Python
  • hostname (nome do servidor)
  • contentUrl (sempre necessário para fontes de dados publicadas. Consulte Conexões de saída para obter a descrição.)
  • porta (ID da porta)
  • username
  • senha
  • serverUrl
  • contentUrl (ID do site. Isso aparece depois de /site/ na URL do Tableau Server ou do Tableau Cloud. Por exemplo, "https://my.server/#/site/mysite", defina "contentUrl": "mysite".)
  • username
  • senha

Só inclua essa matriz se o seu fluxo tiver etapas de script para R ou TabPy que requerem uma senha.

  • extensionName: especifique "rSupport" ou "pythonSupport"
  • credentials: incluir "password” (senha).
### Exemplos Esta seção mostra dois exemplos diferentes de arquivos de credenciais que você pode criar usando os requisitos de credenciais .json. #### Conectar a uma fonte de dados publicada Este exemplo mostra um arquivo de credenciais .json que se conecta a uma fonte de dados publicada e produz dados para um servidor que inclui uma ID do site **Observação**: se inputConnection ou outputConnection usar o site Padrão, por exemplo, "https://my.server/#/site/”, defina ContentUrl como em branco. Por exemplo, `"contentUrl": ""` { "inputConnections":\[ { "hostname":"https://my.server", "contentUrl": "mysite", "port":443, "username": "jsmith", "password": "passw0rd$" } \], "outputConnections":\[ { "serverUrl":"https://my.server", "contentUrl":"mysite", "username":"jsmith", "password":"passw0rd$" } \] } #### Conectar a dois bancos de dados Este exemplo mostra um arquivo de credenciais .json que se conecta ao MySQL e Oracle e os dados de saída são enviados a um servidor que inclui uma ID de site. { "inputConnections":\[ { "hostname":"mysql.example.lan", "port":1234, "username": "jsmith", "password": "passw0rd" }, { "hostname":"Oracle.example.lan", "port":5678, "username": "jsmith", "password": "passw0rd" } \], "outputConnections":\[ { "serverUrl":"http://my.server", "contentUrl":"mysite", "username":"jsmith", "password":"passw0rd$" } \] } #### O fluxo inclui etapas de script para Rserve e TabPy e se conecta a um banco de dados O exemplo a seguir mostra um arquivo de credenciais .json que inclui a senha para serviços Rserve e TabPy e se conecta ao MySQL. { "inputConnections":\[ { "hostname":"mysql.example.lan", "port":1234, "username": "jsmith", "password": "passw0rd" } \], "extensions":\[ { "extensionName":"rSupport", "credentials":{ "password":"pwd", } }, { "extensionName" : "pythonSupport", "credentials": { "password": "pwd" } } \] } ### Dicas para criar seu arquivo de credenciais Para evitar erros ao executar o fluxo, certifique-se de que seu arquivo de credenciais siga as diretrizes a seguir: - Se você usar o Tableau Prep Builder versão 2018.2.2 à 2018.3.1, sempre inclua as matrizes "inputConnections" e "outputConnections", mesmo se o fluxo não tiver conexões remotas para entradas e saídas. Deixe essas matrizes em branco. Se estiver usando o Tableau Prep Builder versão 2018.3.2 e posteriores, não é necessário incluir a matriz em branco. - Nenhuma conexão de entrada remota? Inclua esta sintaxe no início do arquivo .json { "inputConnections":\[ \], - Nenhuma conexão de saída remota? Inclua esta sintaxe no fim do arquivo .json "outputConnections":\[ \] } - Não há ID de porta para sua conexão de entrada ou a porta está especificada como parte do nome do servidor. Se não houver ID de porta para sua conexão, não inclua a referência `"port":xxxx,` no arquivo .json, nem mesmo `"port": ""`. Se a ID de porta estiver incluída no nome do servidor, inclua-a no nome do host. Por exemplo, `"hostname": "mssql.example.lan,1234"` - Ao fazer referência ao `"serverUrl":` não inclua uma "/" no fim do endereço. Por exemplo, use este `"serverUrl": "http://server"`, não este `"serverUrl": "http://server/"`. - Se você tiver várias conexões de entrada e saída, inclua as credenciais de cada uma no arquivo. - Se estiver se conectando a fontes de dados publicadas, inclua o nome do host e contentUrl nas conexões de entrada. ## Executar o fluxo > [!IMPORTANT] > > **Importante**: os exemplos abaixo incluem a alteração do nome de "Tableau Prep" versão 2019.1.2 para "Tableau Prep Builder". Se estiver usando uma versão anterior do produto, use o "Tableau Prep". 1. Abra o prompt de comando ou o prompt de comando Terminal (MacOS) como um Administrador. 2. Execute um dos seguintes comandos usando a sintaxe mostrada abaixo. - O fluxo se conecta a arquivos locais ou arquivos armazenados em um compartilhamento de rede e publica a arquivos locais, arquivos armazenados em um compartilhamento de rede ou usa a autenticação do Windows: **Observação**: se você estiver se conectando a ou gerando arquivos armazenados em um compartilhamento de rede, use o formato UNC para o caminho: \\\\server\\path\\file name. Ele não pode ser protegido por senha. **Windows** ``` "\[Tableau Prep Builder install location]\Tableau Prep Builder \scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl ``` - O fluxo se conecta a bancos de dados ou publica em um servidor: **Windows** ``` "\[Tableau Prep Builder install location]\Tableau Prep Builder \scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl ``` - O arquivo de fluxo ou arquivo de credenciais estão armazenados em um compartilhamento de rede (use o formato UNC para o caminho: \\\\server\\path\\file name): **Windows** ``` "\[Tableau Prep Builder install location]\Tableau Prep Builder \scripts"\tableau-prep-cli.bat -c "\server\path\[your credential file name].json" -t "\server\path\[your flow file name].tfl" ``` **Mac:** mapeie o compartilhamento de rede para /Volumes no Finder para que seja persistente, em seguida use `/Volumes/.../[your file]` para especificar o caminho: ``` /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c /Volumes/.../[your credential file name].json -t path/to/[your flow file name].tfl ``` Para erros e soluções comuns, consulte [Erros comuns ao usar a linha de comando para executar fluxos](https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm#cli_common_errors). ## Executar o fluxo com a atualização incremental ativada _Compatível com o Tableau Prep Builder versão 2020.2.1 e posterior e na Web a partir da versão 2020.4. A atualização incremental não tem suporte no momento ao gravar saídas de fluxo no Microsoft Excel._ Se você não tiver o Tableau Prep Conductor ativado no servidor para agendar as execuções de fluxo, poderá executar o fluxo usando a atualização incremental a partir da linha de comando. Basta incluir o parâmetro `--incrementalRefresh` na linha de comando, como mostrado no exemplo abaixo. **Windows** ``` "\[Tableau Prep Builder install location]\Tableau Prep Builder \scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl ``` Se as etapas de entrada no fluxo tiverem a atualização incremental ativada e os parâmetros de atualização incremental estiverem configurados corretamente, o Tableau Prep Builder fará o seguinte: - Todas as entradas no fluxo que tenham a atualização incremental ativada executarão todas as saídas correspondentes usando a atualização incremental. - Se nenhuma entrada no fluxo tiver a atualização incremental ativada, todas as saídas serão executadas usando a atualização completa. Uma mensagem mostrará detalhes sobre o método de atualização. - Se algumas entradas no fluxo tiverem a atualização incremental ativada, as saídas correspondentes serão executadas usando a atualização incremental. As outras saídas serão executadas usando a atualização completa e uma mensagem mostrará detalhes sobre o método de atualização. Para obter mais informações sobre a configuração de fluxos para usar a atualização incremental, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm) ## Opções de comando Caso deseje exibir as opções de ajuda, inclua `-h` na linha de comando.
Opções de comandoDescriçãoObservações
-c , --connections <arg>O caminho da conexão para o arquivo de credenciais.Requer o caminho onde o arquivo de credenciais está localizado.
-d, --debugDepure o processo do fluxo.Inclua essa opção para visualizar mais informações para ajudar a solucionar um problema com a atualização do fluxo. Os arquivos de registro estão armazenados em: My Tableau Prep Builder Repository\Command Line Repository\Logs
-dsv, --disableSslValidationDesabilitar a validação de SSLExecute o fluxo sem realizar a validação do certificado. Ao executar esta opção no MacOS, uma caixa de diálogo pode ser exibida solicitando o usuário e a senha do keychain. A partir da versão 2019.3.2 do Tableau Prep Builder, você pode passar esse parâmetro adicional para desabilitar essa caixa de diálogo de chaves. Por exemplo: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl
-h, --helpVeja a ajuda para as opções de sintaxe

A opção de ajuda ou um erro de sintaxe mostra as seguintes informações:

usage: tableau-prep-cli [-c <arg>] [-d]  [-h] [-t <arg>]
-c,--connections <arg>        Path to a file with all connection information
-d,--debug                    This option is for debugging
-dsv,--disableSslValidation   Disable SSL validation
-h,--help                     Print usage message
-inc,--incrementalRefresh     Run incremental refresh for all outputs that are configured to support it
-t,--tflFile <arg>            The Tableau Prep Builder flow file	
-inc, --incrementalRefreshExecute a atualização incremental em todas as saídas configuradas para usá-la.

Inclua essa opção para executar a atualização incremental em todas as entradas configuradas para usá-la. A atualização incremental permite que o Tableau Prep Builder recupere e processe apenas novas linhas, em vez de todas as linhas do fluxo.

As definições de configuração da atualização incremental nas etapas de entrada determinam quais saídas de fluxo podem ser executadas de forma incremental. Todas as outras saídas serão executadas usando a atualização completa e uma mensagem mostrará detalhes sobre o método de atualização.

Para obter mais informações sobre a execução de fluxos usando a atualização incremental, consulte Atualizar dados de fluxo usando a atualização incremental.

-t, --tflFile <arg>O arquivo de fluxo .tflRequer o caminho onde o arquivo de fluxo .tfl está localizado.
-p, --parameters Os parâmetros substituem o arquivo .jsonInclua este arquivo se desejar substituir os valores de parâmetro atuais (padrão) aplicados ao seu fluxo. Para obter mais informações sobre como usar parâmetros de fluxo, consulte Criar e usar parâmetros em fluxos
## Exemplos de sintaxe As linhas de comando abaixo mostram quatro exemplos diferentes para executar um fluxo usando o critério a seguir: - **Versão do Tableau Prep Builder**: 2022.1.1 > [!IMPORTANT] > > **Importante**: os exemplos abaixo incluem a alteração do nome de Tableau Prep versão 2019.1.2 para Tableau Prep Builder. Se estiver usando uma versão anterior do produto, use o "Tableau Prep". - **Nome do fluxo**: Flow1.tfl - **Local do fluxo**: C:\\Users\\jsmith\\Documents\\My Tableau Prep Builder Repository\\Flows - **Nome do arquivo de credenciais**: Flow 1.json - **Local do arquivo de credenciais**: C:\\Users\\jsmith\\Desktop\\Flow credentials - **Local do arquivo de credenciais armazenados em um compartilhamento de rede**: \\tsi.lan\\files\\Flow credentials #### O fluxo se conecta a e publica em arquivos locais **Windows** ``` "\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl ``` #### O fluxo se conecta e publica em arquivos locais e usa a forma curta da atualização incremental **Windows** ``` "\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -inc -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -inc -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl ``` #### O fluxo se conecta a bancos de dados e publica em um servidor **Windows** ``` "\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\C:\Users\jsmith\Desktop\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Users/jsmith/Desktop/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl ``` #### O fluxo publica em um servidor e o arquivo de credenciais é armazenado em um compartilhamento de rede **Windows** ``` "\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\\tsi.lan\files\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl" ``` **Mac** ``` /Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Volumes/files/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl ``` [Pular para o conteúdo principal](#main-content) # Atualizar dados de fluxo usando a atualização incremental **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) na ajuda do Tableau Server. A partir do Tableau Prep Builder versão 2020.2.1 e na Web, você pode configurar suas entradas e saídas de fluxo para atualizar de forma incremental para que apenas as novas linhas sejam recuperadas e processadas quando o fluxo for executado, economizando tempo e recursos. Por exemplo, se o fluxo incluir dados de transações que atualizam diariamente, você pode configurar a atualização incremental para recuperar e processar apenas as novas transações todos os dias e, em seguida, executar uma atualização completa semanal ou mensal para atualizar todos os dados de fluxo. ## Requisitos e limitações da atualização incremental ### Requisitos Para executar o fluxo usando atualização incremental, o Tableau Prep precisa das seguintes informações: - O campo que detecta novas linhas na tabela de entrada. - O campo a ser usado para comparar os últimos valores processados na saída do fluxo com os valores na entrada para determinar quais linhas são novas. Para obter mais informações, consulte [Atualização incremental com Anexar](#refreshAppend). - Como deseja gravar os novos dados nas tabelas. Você pode adicionar novos dados às tabelas existentes, substituir os dados da tabela pelos dados novos ou, a partir do Tableau Prep Builder versão 2020.3.1 e na Web, substituir os dados na tabela existente. ### Limitações - O Tableau Prep versão 2021.1.2 ou posterior é necessário ao executar a atualização incremental nas entradas de fluxo usando o conector Salesforce. - A atualização incremental não tem suporte no momento ao gravar saídas de fluxo no Microsoft Excel, Amazon S3, CRM Analytics ou Databricks. - As saídas para arquivos .csv são compatíveis apenas com a tabela Criar. - As saídas para extrações .hyper locais ou publicadas são compatíveis apenas com Anexar à tabela. ## Opções de atualização de fluxo O Tableau Prep permite selecionar como os dados são atualizados e como as tabelas são atualizadas com a saída de fluxo. A tabela a seguir descreve as diferentes opções e seus benefícios.
Combinação de atualizaçãoDados processadosAtualização da tabelaBenefícios
Atualização completa + Criar tabelaTodosCrie ou substitua a tabela existente pelo conjunto completo de dados.

Atualize todos os dados de cada execução de fluxo.

Atualização completa + Anexar à tabelaTodosAdicione novas linhas à tabela existente.Acompanhe os dados novos e existentes em cada execução de fluxo. Anexar à tabela não está disponível para os tipos de saída .csv.
Atualização completa + Substituir dadosTodosSubstitua as linhas na tabela existente.Mantenha sua estrutura de esquema de tabela existente, mas substitua todos os dados por cada execução de fluxo.
Atualização incremental + Criar tabelaApenas novas linhasCrie ou substitua a tabela existente somente pelas novas linhas.Crie uma nova tabela apenas com as novas linhas como o conjunto completo de dados.

Se a fonte de dados de saída não existir ou não puder ser conectada quando o fluxo for executado, o fluxo falhará. Uma atualização completa é necessária para criar a saída antes que ela possa ser usada de forma incremental.

Atualização incremental + Anexar à tabelaApenas novas linhasAdicione as novas linhas à tabela existente.

Adicione somente as novas linhas à tabela existente. Anexar à tabela não está disponível para os tipos de saída .csv. Consulte Atualização incremental com Anexar.

Atualização incremental + Substituir dadosApenas novas linhasSubstitua todas as linhas na tabela existente somente pelas novas linhas.Mantenha sua estrutura de esquema de tabela existente, mas substitua todos os dados apenas pelas novas linhas. Essa estrutura será seu conjunto completo de dados.
## Configurar atualização incremental Para configurar o fluxo para usar a atualização incremental, você precisa especificar as configurações nas etapas de Entrada e Saída onde deseja usar essa opção. Na etapa de Entrada, especifique como o Tableau Prep encontrará as novas linhas. Na etapa Saída, especifique como as novas linhas são gravadas na tabela. Ao executar o fluxo, você pode selecionar um tipo de atualização completa ou incremental. > [!TIP] > > **Dica**: depois de configurar as etapas de entrada e saída para atualização incremental, você pode preservar e reutilizar as configurações. Copie e cole as etapas para usá-las em outros lugares do fluxo atual ou, no Tableau Prep Builder, use Salvar etapas como fluxo para salvar as etapas selecionadas em um arquivo local ou no servidor para reutilizá-las em outros fluxos. Para obter mais informações sobre como copiar, colar e reutilizar etapas, consulte [Copiar etapas, ações e campos](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm). 1. No painel Fluxo, selecione a etapa de entrada que você quer configurar para atualização incremental. 2. No painel Entrada na guia Configurações, em Atualização incremental (seção Configurar atualização incremental em versões anteriores), defina as seguintes opções: - Selecione Ativar atualização incremental (Habilitar em versões anteriores). - Campo de entrada (Identificar novas linhas usando o campo nas versões anteriores): selecione o campo que deseja atualizar nos dados de entrada. Esse campo deve ser atribuído a um tipo de dados de Número (inteiro), Data ou Data e Hora. No momento, você só pode selecionar um campo. **Observação**: você pode remover ou renomear esse campo mais tarde no fluxo, desde que o campo especificado em Campo de saída (Nome do campo na saída em versões anteriores) possa ser usado para comparar esse campo à saída mais recente para encontrar novas linhas. - Saída: selecione a saída relacionada à entrada e que inclua o campo que será usado para comparar linhas. - Campo de saída (Nome do campo na saída em versões anteriores): selecione o campo a ser usado para comparar os últimos valores processados na saída do fluxo aos valores na entrada para encontrar novas linhas. Esse campo deve ter o mesmo tipo de dados e nome que o campo especificado no Campo de entrada (Identificar novas linhas usando o campo em versões anteriores). ![Configurações da etapa de Entrada com a seção Atualização incremental destacada. ](/tableau/current/pt-br/prep/pt-br/Img/prep_incremental_input.png) ### Atualização incremental com Anexar A atualização incremental primeiro procura o valor máximo existente do campo incremental na saída. Em seguida, ele filtra as linhas da entrada para adicionar apenas linhas com um valor maior no campo incremental. Por exemplo: Tabela existente:
Col1Col2
ID 5Linha 5
Anexe novas linhas à tabela com base em col1:
Col1Col2
ID 1NewRow1
ID 6NewRow6
- NewRow1 não é adicionada. - NewRow6 é adicionada. ## Configurar opções de gravação Para concluir a configuração da atualização incremental, defina as Opções de gravação de saída para especificar como as novas linhas serão gravadas nas tabelas. Todas as saídas relacionadas à etapa de entrada configurada têm uma opção de gravação padrão selecionada, mas você pode alterá-la para uma opção compatível. Você pode gerar as linhas para um arquivo (somente no Tableau Prep Builder), uma fonte de dados publicada ou um banco de dados. Alguns bancos de dados têm restrições de dados ou requisitos. Para obter mais informações sobre restrições e requisitos de banco de dados, consulte [Salvar dados de saída de fluxo em bancos de dados externos](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#save-flow-output-data--to-external-databases). Por padrão, as saídas para extrações .hyper locais ou publicadas são definidas como Anexar à tabela. As saídas dos tipos de arquivo .csv estão definidas como Criar tabela. 1. No painel Fluxo, selecione a etapa de saída que você quer configurar para atualização incremental. 2. No painel Saída, na seção Opções de gravação, veja a opção de gravação padrão e faça alterações conforme necessário. - Criar tabela: esta opção cria uma nova tabela ou substitui a tabela existente pela nova saída. - Anexar à tabela: esta opção adiciona os novos dados à tabela existente. Se a tabela ainda não existir, uma nova tabela será criada quando o fluxo for executado pela primeira vez e as execuções subsequentes adicionarão novas linhas a essa tabela. Não disponível para tipos de saída .csv. Para obter mais informações sobre as combinações de atualização compatíveis, consulte [Opções de atualização de fluxo](#refresh-options) - Substituir dados (Tableau Prep Builder versão 2020.3.1 e posteriores e na Web): esta opção está disponível quando você deseja gravar sua saída em uma tabela existente em um banco de dados. Substitui os dados na tabela de banco de dados pelos dados de fluxo, mas mantém a estrutura do esquema de tabela. ![Menu “Salvar saída em” com a opção “Acrescentar à tabela” selecionada. ](/tableau/current/pt-br/prep/pt-br/Img/prep_incremental_output4.png) ## Executar o fluxo Você pode executar fluxos individuais usando a atualização incremental no Tableau Prep Builder, na Web ou na linha de comando. Para obter informações sobre como executar o fluxo a partir da linha de comando, consulte [Executar o fluxo com a atualização incremental ativada](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm#incremental-refresh). Se você tiver o Data Management com o Tableau Prep Conductor ativado, pode executar o fluxo usando a atualização incremental com uma agenda no Tableau Server ou no Tableau Cloud. **Observação**: na versão anterior, as opções de gravação são definidas no Tableau Prep Builder e não podem ser alteradas ao executar o fluxo no Tableau Server ou no Tableau Cloud. A partir do Tableau Server e do Tableau Cloud versão 2020.4, você pode editar o fluxo diretamente na Web. Para obter mais informações sobre como usar os fluxos de criação na Web, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) na ajuda do Tableau Server. Antes de executar seu fluxo usando a atualização incremental, você precisará primeiro executar uma atualização completa para criar a fonte de dados de saída no local de saída. As execuções de fluxo subsequentes podem então usar o processo de atualização incremental e recuperar e processar apenas as novas linhas, a menos que os dados de configuração de atualização incremental não sejam perdidos ou a saída existente seja removida. Para executar uma atualização completa, selecione Atualização completa no botão suspenso no menu superior ou no painel Saída, ou clique no botão Executar fluxo no fluxo. - Para executar o fluxo no Tableau Prep usando a atualização incremental, selecione Atualização incremental em um dos seguintes locais: - No menu superior, clique na opção suspensa no botão Executar. ![Uma janela que permite escolher entre uma atualização completa ou incremental, com a atualização incremental destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_incremental_run_menu.png) - No painel Saída, clique na opção suspensa no botão Executar fluxo. ![Uma caixa de diálogo apresentando as opções "Atualização completa" e "Atualização incremental" para executar um fluxo de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_incremental_run_button.png) - No painel Fluxo, clique na opção suspensa no botão Executar ao lado da etapa Saída. ![Uma caixa de diálogo com opções para criar uma tabela usando a atualização completa ou atualização incremental.](/tableau/current/pt-br/prep/pt-br/Img/prep_incremental_run_menu_flow.png) Se uma entrada com atualização incremental ativada estiver associada a várias saídas, essas saídas deverão ser executadas juntas e deverão usar o mesmo tipo de atualização. Ao executar a atualização no Tableau Prep, uma caixa de diálogo é exibida informando que deve executar ambas as saídas juntas. ![Caixa de diálogo Executar fluxo (atualização incremental) com uma tabela contendo saída e tipo de atualização e o botão Executar fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_incremental_warning1.png) [Pular para o conteúdo principal](#main-content) # Calcular valores em várias linhas **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, a menos que indicado. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Os cálculos de várias linhas permitem que você calcule valores entre várias linhas de dados no fluxo. Embora semelhantes aos cálculos de tabela no Tableau, os cálculos de várias linhas se aplicam a todo o conjunto de dados quando você executa o fluxo. Você também pode desenvolver o resultado usando outros tipos de cálculos. **Observação**: ao criar um campo calculado, não utilize o nome reservado “Número de Registros”. Usar esse nome reservado resultará em um erro relacionado à permissão. No Tableau, os cálculos de tabela se aplicam apenas aos valores em sua visualização. Embora você possa desenvolver o resultado, use outro cálculo de tabela para fazer isso. Para obter mais informações sobre o uso de cálculos de tabela no Tableau, consulte [Transformar valores com cálculos de tabela](https://help.tableau.com/current/pro/desktop/pt-br/calculations_tablecalculations.htm) na ajuda do Tableau. Realizar cálculos de tabela durante a preparação de dados pode fornecer maior flexibilidade ao analisar dados no Tableau. Você pode facilmente reutilizar o cálculo ao criar sua exibição, e o cálculo subjacente não é afetado pela filtragem. Os tempos de carregamento da pasta de trabalho para grandes conjuntos de dados podem ser mais rápidos, pois o cálculo de tabela não é recalculado após a execução da consulta. No momento, o Tableau Prep é compatível com os seguintes cálculos de várias linhas: - Diferença de: calcula a diferença entre o valor da linha atual e outro valor. - Diferença de percentual de: calcula a diferença entre o valor da linha atual e outro valor como uma porcentagem. - Cálculos de movimentação: retorna a soma ou a média de um campo numérico dentro de um conjunto flexível de linhas. - Preencher cálculos: calcula e preenche os dados ausentes das linhas acima. - Execução de cálculos: calcula a soma ou média dos valores em uma coluna. Use o editor de cálculo visual para gerar o cálculo rapidamente ou escreva seu próprio cálculo personalizado no editor de cálculo. ## Calcular Diferença de _Compatível com o Tableau Prep Builder 2023.2 e posterior e na Web no Tableau Cloud. Também compatível no Tableau Server 2023.3 e posterior._ O cálculo da Diferença de calcula a diferença entre o valor atual e um valor N linhas antes ou depois da linha atual. #### Editor de cálculo visual Selecione campos de uma lista e o Tableau Prep cria o cálculo para você durante as suas seleções. Uma visualização dos novos resultados de campo aparece no painel esquerdo e você pode revisar os resultados do cálculo na extremidade direita do painel. 1. Em um painel de cartão de perfil ou resultados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Diferença de. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar Campo calculado com o item de menu Diferença de destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_menu2.png) 2. Na seção Agrupar por, selecione os campos com linhas que você deseja incluir no cálculo. Isso particiona a tabela ao realizar o cálculo. Para aplicar o cálculo a todas as linhas da tabela, aceite o valor padrão Tabela completa. Depois de selecionar seu primeiro campo, clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Agrupar por à sua partição. Para reordenar ou remover campos, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione uma ação no menu. ![O menu de reordenação na caixa de diálogo Diferença de é usado para alterar a ordem dos campos selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_reorder_menu.png) 3. Na seção Ordenar por, selecione os campos que deseja usar como ordem de classificação. Este campo é usado para especificar como a função `LOOKUP` ordena as linhas na tabela. Se o campo onde você selecionou a opção de menu Criar campo calculado >Diferença de é um campo de data ou hora, esse campo é adicionado por padrão, mas é possível alterá-lo. Clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Ordenar por ao seu cálculo. Clique no ícone de classificação ![Ocultar o ícone de Classificação. Altera a ordem dos campos de crescente (ASC) para decrescente (DESC).](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_sort.png) para alterar a ordem crescente (ASC) para ordem decrescente (DESC). Você também pode clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS) e selecionar uma ação no menu para reordenar ou remover campos. 4. Na seção Computar usando, selecione o campo com os valores que deseja usar para calcular seus resultados. 5. Na seção Diferença de, selecione as linhas a serem usadas para calcular a diferença. Por exemplo, selecione Valor anterior, 2 para calcular a diferença entre o valor atual e um valor 2 linhas antes desse valor. As anotações destacam as linhas usadas para realizar o cálculo. Por padrão, a visualização do cálculo mostrará a primeira linha não nula. No entanto, você pode clicar em qualquer linha na tabela de resultados e ver uma visualização atualizada do valor selecionado. ![A caixa de diálogo Diferença de mostra uma prévia dos resultados do cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from.png) Se o cálculo não puder ser realizado com as configurações atuais, a anotação Valores insuficientes aparecerá. Para resolver esse problema, selecione um valor atual diferente ou altere a configuração na seção Diferença de. ![A caixa de diálogo Diferença de mostra uma dica de ferramenta "Valores insuficientes" quando não há valores suficientes disponíveis para calcular a diferença entre as linhas.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_no_values.png) 6. No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. 7. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que o Tableau Prep gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![O painel Alterações em um fluxo mostrando a fórmula para um cálculo de “Diferença de” gerado pelo Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_changes_pane.png) #### Editor de cálculo Se você quiser escrever seu próprio cálculo para calcular a diferença entre dois valores, use a função `LOOKUP` no Editor de cálculo. 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar campo calculado com o item de menu Cálculo personalizado destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_custom.png) 2. No Editor de cálculo, insira a expressão. Por exemplo, para encontrar a diferença entre as vendas atuais e as vendas do dia anterior por região, crie um cálculo como o mostrado abaixo. {PARTITION \[Region\]:{ ORDERBY \[Order Date\]ASC:LOOKUP(\[Sales\],0)}} - { PARTITION \[Region\]:{ ORDERBY \[Order Date\]ASC:LOOKUP(\[Sales\],1)}} ![O Editor de cálculos mostra a sintaxe para calcular a diferença nas vendas diárias entre regiões.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_syntax.png) 3. Insira um nome para o cálculo e clique em Salvar. ## Calcular Diferença de percentual de _Compatível com o Tableau Prep Builder 2023.2 e posterior e na Web no Tableau Cloud. Também compatível no Tableau Server 2023.3 e posterior._ Um cálculo Diferença de percentual de calcula a diferença entre o valor atual e um valor N linhas antes ou depois da linha atual como uma porcentagem. Por exemplo, `Value1-Value2/Value2`. #### Editor de cálculo visual Selecione campos de uma lista e o Tableau Prep cria o cálculo para você durante as suas seleções. Uma visualização dos novos resultados de campo aparece no painel esquerdo e você pode revisar os resultados do cálculo na extremidade direita do painel. 1. Em um painel de cartão de perfil ou resultados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Diferença de percentual de. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar Campo calculado com o item de menu “Diferença percentual de” destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_pct_diff_from_menu.png) 2. Na seção Agrupar por, selecione os campos com linhas que você deseja incluir no cálculo. Isso particiona a tabela ao realizar o cálculo. Para aplicar o cálculo a todas as linhas da tabela, aceite o valor padrão Tabela completa. Depois de selecionar seu primeiro campo, clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Agrupar por à sua partição. Para reordenar ou remover campos, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione uma ação no menu. ![O menu de reordenação na caixa de diálogo Diferença de é usado para alterar a ordem dos campos selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_reorder_menu.png) 3. Na seção Ordenar por, selecione os campos que deseja usar como ordem de classificação. Este campo é usado para especificar como a função `LOOKUP` ordena as linhas na tabela. Se o campo onde você selecionou a opção de menu Criar campo calculado > Diferença de percentual de é um campo de data ou hora, esse campo é adicionado por padrão, mas é possível alterá-lo. Clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Ordenar por ao seu cálculo. Clique no ícone de classificação ![Ocultar o ícone de Classificação. Altera a ordem dos campos de crescente (ASC) para decrescente (DESC).](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_sort.png) para alterar a ordem crescente (ASC) para ordem decrescente (DESC). Você também pode clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS) e selecionar uma ação no menu para reordenar ou remover campos. 4. Na seção Computar usando, selecione o campo com os valores que deseja usar para calcular seus resultados. 5. Na seção Diferença de percentual de, selecione as linhas a serem usadas para calcular o resultado. Por exemplo, selecione Valor anterior, 2 para calcular a diferença de percentual entre o valor atual e um valor 2 linhas antes desse valor. As anotações destacam as linhas usadas para realizar o cálculo. Por padrão, a visualização do cálculo mostrará a primeira linha não nula. No entanto, você pode clicar em qualquer linha na tabela de resultados e ver uma visualização atualizada do valor selecionado. ![A caixa de diálogo “Diferença percentual de” mostra uma prévia dos resultados do cálculo da diferença percentual entre duas linhas.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_pct_diff_from_visual_calc.png) Se o cálculo não puder ser realizado com as configurações atuais, você verá a anotação Valores insuficientes. Para resolver isso, selecione um valor atual diferente ou altere a configuração na seção Diferença de percentual de. ![A caixa de diálogo “Diferença percentual de” mostra uma dica de ferramenta "Valores insuficientes" quando não há valores suficientes disponíveis para calcular a diferença percentual.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_pct_diff_from_no_values.png) 6. No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. 7. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que o Tableau Prep gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![O painel Alterações mostra a fórmula gerada pelo Tableau Prep para calcular a diferença percentual de um período anterior para dados de vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_pct_diff_from_changes_pane.png) #### Editor de cálculo Se você quiser escrever seu próprio cálculo para calcular a diferença de percentual entre dois valores, use a função `LOOKUP` no Editor de cálculo. 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar campo calculado com o item de menu Cálculo personalizado destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_custom.png) 2. No Editor de cálculo, insira a expressão. Por exemplo, para encontrar a diferença de percentual entre as vendas atuais e as vendas dos dias anteriores por região, crie um cálculo como o mostrado abaixo. { PARTITION \[Region\]:{ ORDERBY \[Order Date\]ASC:LOOKUP(\[Sales\],0)}} - { PARTITION \[Region\]:{ ORDERBY \[Order Date\]ASC:LOOKUP(\[Sales\],-1)}} / { PARTITION \[Region\]:{ ORDERBY \[Order Date\]ASC:LOOKUP(\[Sales\],-1)}} ![O Editor de Cálculo mostra a sintaxe de cálculo para encontrar a diferença percentual entre as vendas atuais e as vendas dos dias anteriores por região.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_pct_diff_from_syntax.png) 3. Insira um nome para o cálculo e clique em Salvar. ## Calcular média móvel ou soma _Compatível com o Tableau Prep Builder 2023.2 e posterior e na Web no Tableau Cloud. Também compatível no Tableau Server 2023.3 e posterior._ Crie um cálculo de movimentação para entender melhor as tendências em seus dados e reduzir as flutuações gerais. No Tableau Prep, você pode calcular uma média móvel ou soma em um número especificado de valores antes ou depois do valor atual. Por exemplo, acompanhando a média móvel de três meses de vendas por região. #### Editor de cálculo visual Selecione campos de uma lista e o Tableau Prep cria o cálculo para você durante as suas seleções. Uma visualização dos novos resultados de campo aparece no painel esquerdo e você pode revisar os resultados do cálculo na extremidade direita do painel. 1. Em um painel de cartão de perfil ou resultados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo de movimentação. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar campo calculado com o item de menu Cálculo móvel destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_moving_avg_menu.png) 2. Na seção Agrupar por, selecione os campos com linhas que você deseja incluir no cálculo. Isso particiona a tabela ao realizar o cálculo. Para aplicar o cálculo a todas as linhas da tabela, aceite o valor padrão Tabela completa Depois de selecionar seu primeiro campo, clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Agrupar por ao seu cálculo. Para reordenar ou remover campos, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione uma ação no menu. ![O menu de reordenação na caixa de diálogo Diferença de é usado para alterar a ordem dos campos selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_reorder_menu.png) 3. Na seção Ordenar por, selecione os campos que deseja usar como ordem de classificação. Este campo é usado para especificar como a função `LOOKUP` ordena as linhas na tabela. Se o campo onde você selecionou a opção de menu Criar campo calculado > Cálculo de movimentação é um campo de data ou hora, esse campo é adicionado por padrão, mas é possível alterá-lo. Clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Ordenar por ao seu cálculo. Clique no ícone de classificação ![Ocultar o ícone de Classificação. Altera a ordem dos campos de crescente (ASC) para decrescente (DESC).](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_sort.png) para alterar a ordem crescente (ASC) para ordem decrescente (DESC). Você também pode clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS) e selecionar uma ação no menu para reordenar ou remover campos. 4. Na seção Computar usando, selecione o campo com os valores que deseja usar para calcular seus resultados. 5. Na seção Resultados, selecione a agregação que deseja realizar (soma ou média), o número de linhas a serem incluídas no cálculo e se deseja incluir a linha atual ou excluí-la. Para alterar a configuração dos resultados, clique no menu suspenso no campo Valores. Por exemplo, para calcular a média móvel de vendas no mês atual e nos 2 meses anteriores, defina os Valores anteriores como 2 e feche a caixa de diálogo. ![A caixa de diálogo Cálculo móvel mostra o menu de configurações onde você pode ajustar o número de valores usados no cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_moving_avg_settings.png) 6. Por padrão, a visualização do cálculo mostra a primeira linha não nula. No entanto, você pode clicar em qualquer linha na tabela de resultados e ver uma visualização atualizada do valor selecionado. As anotações destacam as linhas usadas para realizar o cálculo. ![A caixa de diálogo Cálculo móvel mostra uma prévia dos resultados de uma média móvel de três meses de dados de vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_moving_avg.png) Se o cálculo não puder ser realizado com as configurações atuais, você verá a anotação Valores insuficientes. Para resolver isso, clique no menu suspenso no campo Valores para alterar a configuração nas Configurações de resultados. ![A caixa de diálogo Cálculo móvel mostra uma dica de ferramenta "Valores insuficientes" quando não há valores suficientes disponíveis para calcular a média móvel.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_moving_avg_no_values.png) 7. No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. 8. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que o Tableau Prep gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![O painel Alterações mostra a fórmula para uma média móvel de três meses gerada pelo Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_moving_avg_changes_pane.png) #### Editor de cálculo Se você quiser escrever seu próprio cálculo para calcular a média móvel ou soma, use a função `LOOKUP` no Editor de cálculo. 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar campo calculado com o item de menu Cálculo personalizado destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_custom.png) 2. No Editor de cálculo, insira a expressão. Por exemplo, para encontrar a média móvel de três meses de vendas por região, crie um cálculo como o mostrado abaixo. **Observação**: este exemplo supõe que o conjunto de dados esteja no nível de detalhe correto, uma linha para cada mês. Se o conjunto de dados não estiver no nível de detalhe correto, considere usar uma etapa de agregação para alterar isso antes de aplicar o cálculo. { PARTITION \[Region\]:{ ORDERBY \[Year of Sale\]ASC,\[Order Month\]ASC:LOOKUP(\[Sales\],-2)}} + { PARTITION \[Region\]:{ ORDERBY \[Year of Sale\]ASC,\[Order Month\]ASC:LOOKUP(\[Sales\],-1)}} + { PARTITION \[Region\]:{ ORDERBY \[Year of Sale\]ASC,\[Order Month\]ASC:LOOKUP(\[Sales\],-0)}} / 3 ![O Editor de Cálculo mostra a sintaxe de cálculo para encontrar a média móvel de vendas de três meses por região.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_moving_avg_syntax.png) 3. Insira um nome para o cálculo e clique em Salvar. ## Obter valor anterior _Compatível com o Tableau Prep Builder 2023.2 e posterior e na Web no Tableau Cloud. Também compatível no Tableau Server 2023.3 e posterior._ Se precisar criar um campo com o valor de uma linha anterior, você poderá criar um cálculo personalizado usando a função `LOOKUP`. 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![Em uma etapa de fluxo em um cartão de Perfil, o submenu Criar campo calculado com o item de menu Cálculo personalizado destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_custom.png) 2. No Editor de cálculo, insira a expressão. Por exemplo, para encontrar o valor de vendas anterior por data do pedido, crie um cálculo como o mostrado abaixo. **Observação**: este exemplo supõe que o conjunto de dados esteja no nível de detalhe correto, uma linha para cada dia. Se o conjunto de dados não estiver no nível de detalhe correto, considere usar uma etapa de agregação para alterar isso antes de aplicar o cálculo. { ORDERBY \[Order Date\]ASC:LOOKUP(\[Sales\],-1)} ![O Editor de cálculo mostra a sintaxe de cálculo para encontrar o valor de vendas anterior por data do pedido usando a expressão LOOKUP.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_LOOKUP.png) 3. Insira um nome para o cálculo e clique em Salvar. ## Cálculo de preenchimento _Compatível com o Tableau Prep Builder 2023.3 e posterior, Tableau Server 2023.3 e posterior e na Web no Tableau Cloud._ Um cálculo de preenchimento calcula e preenche os dados ausentes para que os valores nulos sejam substituídos pelos valores das linhas acima, permitindo que os dados sejam facilmente visualizados. O exemplo abaixo mostra os resultados de um cálculo de preenchimento substituindo os valores nulos do campo Aluno por valores baseados nas linhas acima. ![Duas tabelas exibem as notas dos alunos, a segunda tabela agrupa os alunos comuns.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_int.png) #### Editor de cálculo visual do Prep 1. Em um painel de cartão de perfil ou resultados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) , e selecione Criar campo calculado > Preenchimento. ![A opção de menu Criar campo calculado, Preencher.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_create.png) 3. Na seção Agrupar por, você pode selecionar campos para particionar os dados ao realizar o cálculo. Se você não deseja que seus dados sejam particionados, aceite o valor padrão de Tabela completa. Depois de selecionar seu primeiro campo, você pode adicionar campos adicionais Agrupar por à sua partição clicando no ícone de sinal de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png). Para reordenar ou remover campos, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione uma ação no menu. ![O menu do botão direito para reordenar ou remover campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_filldown_reorder_menu.png) 6. Na seção Ordenar por, selecione os campos que deseja usar como ordem de classificação. Este campo é usado para especificar como a ordem das linhas na tabela. Você também pode adicionar um número de linha de origem na etapa de entrada de arquivos de texto, CSV ou Excel para classificar os dados na ordem da fonte de dados. 8. Clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Ordenar por ao seu cálculo. Você deve escolher pelo menos um campo. Clique no ícone de classificação ![Ocultar o ícone de Classificação. Altera a ordem dos campos de crescente (ASC) para decrescente (DESC).](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_sort.png) para alterar a ordem crescente (ASC) para ordem decrescente (DESC). Você também pode clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS) e selecionar uma ação no menu para reordenar ou remover campos. 9. Na seção Computar usando, selecione o campo com os valores que deseja preencher. O campo Resultados mostra os valores preenchidos em negrito. ![O editor de Cálculo visual mostrando os resultados do cálculo de preenchimento.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_results.png) 10. No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. 11. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que o Tableau Prep gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![O painel Alterações mostra a sintaxe do cálculo Preencher.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_syntaxCalc.png) #### Editor de cálculo 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. 2. No Editor de cálculo, insira a expressão. 3. Insira um nome para o cálculo e clique em Salvar. #### Exemplos Exemplo de preenchimento com uma partição: Com base nos dados a seguir, você pode preencher os valores ausentes no campo Categoria do Sensor usando a função `LAST_VALUE`. Neste exemplo, _ID do sensor_ é usado para particionar os dados, _Carimbo de data e hora_ é usado para ordenar os dados, e _Categoria do sensor_ é usado para calcular os dados. ![Uma tabela de ID do sensor, registro de data e hora, categoria do sensor e observação é exibida.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_sensorId.png) ![A caixa de diálogo Editor de cálculo mostrando como usar a função Last\_Value para fazer um cálculo de preenchimento com uma partição.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_lastValue.png) Os resultados do preenchimento são destacados no painel de cálculo. ![Uma tabela de dados do sensor, incluindo registro de data e hora, categoria do sensor e valores de observação com linhas em branco preenchidas.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_syntaxResults.png) Exemplo de preenchimento sem partição: com base nos dados a seguir, você pode preencher os valores ausentes do campo _Estudante_. O campo _Número da linha de origem_ foi adicionado em uma etapa de entrada e é usado para ordenar os dados na ordem de origem. _Estudante_ é usado para calcular os dados. ![Uma tabela de alunos, suas disciplinas e suas notas correspondentes.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_int1.png) ![A caixa de diálogo Editor de cálculo mostrando como usar a função Last\_Value para fazer um cálculo de preenchimento sem uma partição.](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_withoutPart.png) Os resultados do preenchimento são destacados no painel de cálculo. ![O preenchimento dos resultados preenche os valores ausentes do campo Aluno](/tableau/current/pt-br/prep/pt-br/Img/prep_fillDown_calcResults.png) ## Cálculo acumulado _Compatível com o Tableau Prep Builder 2023.3 e posterior, Tableau Server 2023.3 e posterior e na Web no Tableau Cloud._ Um cálculo acumulado calcula a soma ou média cumulativa de um valor e todos os valores anteriores na coluna. O exemplo abaixo mostra os resultados de um cálculo acumulado da soma das vendas ao longo do tempo. ![Uma tabela com a soma das vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_runnngSum_int1.png) ![Um cálculo contínuo da Soma de vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_runningSum_int2.png) #### Editor de cálculo visual do Prep 1. Em um painel de cartão de perfil ou resultados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) , e selecione Criar campo calculado > Preenchimento. ![Criar um Cálculo contínuo.](/tableau/current/pt-br/prep/pt-br/Img/prep_runningCalc_create.png) 3. Na seção Agrupar por, você pode selecionar campos para particionar os dados ao realizar o cálculo. Se você não deseja que seus dados sejam particionados, aceite o valor padrão de Tabela completa. Depois de selecionar seu primeiro campo, você pode adicionar campos adicionais Agrupar por à sua partição clicando no ícone de sinal de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png). Para reordenar ou remover campos, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione uma ação no menu. ![O menu do botão direito para reordenar ou remover campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_filldown_reorder_menu.png) 6. Na seção Ordenar por, selecione os campos que deseja usar como ordem de classificação. Este campo é usado para especificar como a ordem das linhas na tabela. Você também pode adicionar um número de linha de origem na etapa de entrada de arquivos de texto, CSV ou Excel para classificar os dados na ordem da fonte de dados. 8. Clique no ícone de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar outros campos Ordenar por ao seu cálculo. Você deve escolher pelo menos um campo. Clique no ícone de classificação ![Ocultar o ícone de Classificação. Altera a ordem dos campos de crescente (ASC) para decrescente (DESC).](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_diff_from_sort.png) para alterar a ordem crescente (ASC) para ordem decrescente (DESC). Você também pode clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS) e selecionar uma ação no menu para reordenar ou remover campos. 9. Na seção Resultados, selecione a agregação que deseja realizar (SUM ou AVG), para uma soma acumulada ou uma média acumulada 10. Clique nas linhas na tabela de resultados para ver uma visualização atualizada do valor selecionado. As anotações destacam as linhas usadas para realizar o cálculo. ![A soma de um cálculo contínuo de Vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_runningCalc_sum.png) 11. No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. 12. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que o Tableau Prep gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![Um editor de cálculos contínuos exibindo cálculos.](/tableau/current/pt-br/prep/pt-br/Img/prep_runningCalc_syntax.png) #### Editor de cálculo 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. 2. No Editor de cálculo, insira a expressão. Por exemplo, com base nos dados a seguir, você pode calcular o total de _Vendas_ ao longo do tempo usando a função `RUNNING_SUM`. Os dados não são particionados e são agrupados usando Tabela completa. O campo _Ordem_ é usado para classificar em ordem cronológica, e _Vendas_ é usado para calcular os dados. ![Uma tabela com a soma das vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_runnngSum_int1.png) ![Um cálculo usando uma soma contínua.](/tableau/current/pt-br/prep/pt-br/Img/prep_runningCalc_withOutPart.png) 3. Insira um nome para o cálculo e clique em Salvar. Os resultados da soma acumulada são destacados no painel de cálculo. ![Um cálculo contínuo da Soma de vendas.](/tableau/current/pt-br/prep/pt-br/Img/prep_runningCalc_sumOfSales.png) [Pular para o conteúdo principal](#main-content) # Cenários habituais O que significa formar dados? Como isso influencia em quais visualizações podem ser criadas e quais análises podem ser realizadas? Nos tutoriais abaixo, averiguamos cenários de análise e visualização, identificamos as limitações de dados que nos impedem de seguir adiante, depois vemos como o Tableau Prep pode nos ajudar a formar os dados para alcançarmos o resultado desejado. Baixe os conjuntos de dados e acompanhe esses cenários habituais com o Tableau Prep e o Tableau Desktop. Saiba como aplicar os recursos e as funções no Tableau Prep para preparar os dados para análise no Tableau Desktop. **Dê-nos o seu feedback**. Estamos apenas começando a compilar esta seção da ajuda on-line. Entre em contato conosco caso haja cenários específicos que você gostaria de encontrar aqui. Use a barra de feedback no topo da página para nos contar mais. Para completar as tarefas nestes tutoriais, é necessário ter instalado o Tableau Prep e o Tableau Desktop e será necessário baixar e salvar os dados no seu computador. Para obter informações sobre como instalar o Tableau Prep e o Tableau Desktop, consulte [Instalar o Tableau Desktop ou o Tableau Prep Builder da Interface do usuário](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm) no Guia de implantação do Tableau Desktop e do Tableau Prep. Caso contrário, é possível baixar as versões gratuitas de avaliação do [Tableau Prep](https://www.tableau.com/pt-br/products/prep/download) e do [Tableau Desktop](https://www.tableau.com/pt-br/products/desktop/download). ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Compatibilidade de versão com o Tableau Prep Se novos recursos ou conectores forem introduzidos em uma nova versão do Tableau Prep Builder e você estiver trabalhando em uma versão mais antiga, a compatibilidade poderá ser um problema se você tentar abrir um fluxo. **Observação**: a partir da versão 2020.4, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. Os fluxos criados na Web sempre serão compatíveis com a versão do servidor que você está usando. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Da mesma maneira, se você publicar fluxos no Tableau Server ou Tableau Cloud para agendar a execução usando o Tableau Prep Conductor, e incluam novos recursos ou conectores não compatíveis com a sua versão do Tableau Server ou Tableau Cloud, você poderá enfrentar erros de compatibilidade que podem impedi-lo de agendar e executar seus fluxos. ## Formato do número da versão A partir da versão 2022.3 do Tableau Prep Builder, o esquema de numeração da versão de lançamento agora está alinhado com o Tableau Desktop e o Tableau Server. Nas versões anteriores, os números de versão do Tableau Desktop e do Tableau Prep Builder têm diferentes formatos. Por exemplo: ![Um diagrama ilustrando a relação entre o Tableau Prep Builder e o Tableau Desktop, incluindo números de versão.](/tableau/current/pt-br/prep/pt-br/Img/desktop_prep_upgrade_version.png) As versões de manutenção do Tableau Desktop e do Tableau Prep Builder não seguiram a mesma sequência. |   | Exemplo de atualização de versão | Exemplo de primeira versão da manutenção | | --- | --- | --- | | Prep Builder | 2022.1.1 | 2022.1.2 | | Desktop | 2022.1 | 2022.1.1 | ## Localização da versão **Observação**: para baixar uma versão específica do Tableau Prep Builder, abra a página [Downloads](http://www.tableau.com/pt-br/support/esdalt) e selecione Tableau Prep Builder na lista no lado esquerdo da página. **Tableau Prep Builder** Para encontrar a versão de lançamento do seu produto, abra o Tableau Prep Builder e, no menu superior, siga um destes procedimentos: - **Windows**: no menu superior, clique em Ajuda > Sobre o Tableau Prep Builder ou Sobre o Tableau Prep, dependendo da sua versão. - Mac: no menu superior, clique em Tableau Prep Builder > Sobre o Tableau Prep Builder ou Tableau Prep > Sobre o Tableau Prep, dependendo da versão. O número da versão é exibido no canto inferior esquerdo da caixa de diálogo. ![A tela inicial do Tableau Prep Builder.](/tableau/current/pt-br/prep/pt-br/Img/prep_version_about_builder.png) **Tableau Server** O Tableau Prep Conductor foi introduzido como parte do Data Management no Tableau Server versão 2019.1. Para agendar fluxos para serem executados no Tableau Server, você deve usar o Tableau Server versão 2019.1 ou posteriores e ter o Tableau Prep Conductor habilitado. Para encontrar sua versão, abra o Tableau Server no navegador da Web. Na barra de menu superior, clique no ícone de informações ![Um ponto de interrogação dentro de um círculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_info_icon_server.png) no canto superior direito e selecione Sobre o Tableau Server. Uma caixa de diálogo é aberta informando qual versão do Tableau Server você está usando. Para obter informações sobre como habilitar o Tableau Prep Conductor, consulte [Etapa 2: definir configurações de fluxo do Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm) na ajuda do Tableau Server. ![Caixa de informações Sobre o Tableau Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_version_Conductor.png) **Tableau Cloud** O Tableau Prep Conductor foi introduzido como parte do Data Management no Tableau Cloud versão 2019.3. Para agendar fluxos a serem executados no Tableau Cloud, você deve usar o Tableau Cloud versão 2019.3 ou posterior e ter o Tableau Prep Conductor habilitado. Para encontrar sua versão, abra o Tableau Cloud no navegador da Web. Na barra de menu superior, clique no ícone de informações no canto superior direito e selecione Sobre o Tableau Cloud. Uma caixa de diálogo é aberta informando qual versão do Tableau Cloud você está usando. Para obter informações sobre como habilitar o Tableau Prep Conductor, consulte [Tableau Prep Conductor](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm) no site de ajuda do Tableau Cloud. ![Caixa de informações Sobre o Tableau Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_version_Online.png) ## Compatibilidade entre diferentes versões do Tableau Prep Builder Geralmente, uma nova versão do Tableau Prep Builder pode abrir fluxos criados em uma versão anterior. No entanto, podem ocorrer problemas de compatibilidade ao tentar abrir um fluxo entre versões mais recentes e mais antigas do Tableau Prep Builder ou até mesmo ao abrir fluxos na mesma versão do Tableau Prep Builder usando computadores diferentes. Por exemplo: - O fluxo inclui recursos ou conectores de entrada que não são compatíveis com a versão na qual ele é aberto. - O computador que você usa para abrir o fluxo não tem os conectores de entrada necessários instalados ou tem uma versão de driver para o conector que não é compatível. O Tableau Prep Builder requer drivers de 64 bits instalados para funcionar com conectores de entrada de fluxo. Caso haja um problema de compatibilidade, ao tentar abrir o fluxo, ele poderá ser aberto com erros ou não será aberto de forma alguma e você receberá uma mensagem de erro. No exemplo abaixo, o fluxo não será aberto e uma mensagem de erro será exibida listando os recursos e as opções incompatíveis para resolver o problema. ![Uma janela de fluxo do Tableau Prep Builder exibe uma caixa de diálogo, indicando que o fluxo foi criado em uma versão mais recente e inclui funcionalidade incompatível na versão atual.](/tableau/current/pt-br/prep/pt-br/Img/prep_compatibility_message.png) ### Corrigir problemas de compatibilidade com o Tableau Prep Builder Para corrigir os problemas de compatibilidade, tente uma das seguintes opções: - Atualize para a versão mais recente do Tableau Prep Builder. Clique no botão de atualização na parte inferior do painel Descobrir para baixar a versão mais recente do produto e siga as instruções para [Instalar o Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm) no Guia de implantação do Tableau Desktop e do Tableau Prep Builder. Se você não tiver acesso ao botão de atualização no painel Descobrir, há instruções sobre como baixar a versão mais recente do produto incluídas no tópico **Instalar o Tableau Prep Builder**. - Verifique se o computador é compatível com o Tableau Prep Builder. Por exemplo, verifique se você tem os drivers de 64 bits instalados para os conectores usados pelo fluxo. Para instalar os drivers, consulte a página [Download de drivers](https://www.tableau.com/pt-br/support/drivers). - Abra uma cópia do fluxo que tenha os recursos incompatíveis removidos. ## Compatibilidade entre diferentes versões do Tableau Prep Builder e do Tableau Server A publicação de uma versão mais recente do Tableau Prep Builder em uma mais antiga o Tableau Server pode resultar em problemas de compatibilidade. Por exemplo, novos recursos adicionados no Tableau Prep Builder versão 2021.3.1 podem não ser compatíveis com o Tableau Server versão 2021.2, mas seriam compatíveis com o Tableau Server versão 2021.4 e quaisquer versões principais posteriores do Tableau Server, como a versão 2022.3. No Tableau Server, o Tableau Prep Conductor detecta os recursos incluídos em um fluxo quando ele é publicado. Se encontrar recursos não compatíveis, o fluxo ainda poderá ser publicado no Tableau Server, mas não será executado, agendado ou adicionado a uma tarefa. O Tableau Cloud é atualizado de forma automática regularmente, por isso geralmente é compatível com todas as versões do Tableau Prep Builder. Se você tiver uma versão mais antiga do Tableau Server, ainda poderá executar fluxos incompatíveis manualmente ou usando a linha de comando do Tableau Prep Builder. Para obter mais informações sobre como usar esse processo, consulte [Atualizar arquivos de saída de fluxo na linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm). ### Detectar recursos incompatíveis Dependendo da versão do Tableau Prep Builder que você está usando, é possível identificar recursos incompatíveis de diferentes maneiras. #### Tableau Prep Builder (versão 2020.1.1 e posterior) Entre no Tableau Server e o Tableau Prep Builder detectará e desativará recursos incompatíveis para você. Os recursos não compatíveis vão aparecer esmaecidos ou você receberá uma mensagem de incompatibilidade ao publicar o fluxo. Se você ainda quiser usar o recurso e executar o fluxo manualmente ou na linha de comando, poderá habilitar os recursos esmaecidos no menu. **Observação**: a partir do Tableau Prep Builder versão 2020.1.4, uma vez que você entra no servidor, o Tableau Prep Builder lembra o nome do servidor e as credenciais quando fechar o aplicativo para que, na próxima vez que abrir o aplicativo, já esteja conectado ao servidor. 1. Passe o cursor sobre o recurso desativado para ver se ele está desativado porque não é compatível com a versão do servidor e, em seguida, clique no botão Usar recursos. Esta opção está disponível no painel Fluxo e nos menus do painel Perfil, painel Resultados e grade de dados. **Observação**: os recursos podem ser desativados por outras razões, como interrupção de atualizações de dados ou se a opção não estiver disponível para uma determinada etapa ou tipo de dados. ![Uma mensagem de aviso de incompatibilidade mostrando que o fluxo no Tableau Prep é incompatível com uma versão do Tableau Server. ](/tableau/current/pt-br/prep/pt-br/Img/prep_incompatible3.png) 2. O recurso selecionado é aplicado e todos os recursos incompatíveis são habilitados e disponibilizados para uso. Os recursos incompatíveis são sinalizados com um aviso para que você possa encontrá-los facilmente e removê-los se quiser executar o fluxo usando um cronograma na sua versão do Tableau Server. Para desativar esse recurso completamente e habilitar todos os recursos incompatíveis, faça o seguinte: 1. No menu superior, selecione Ajuda >Configurações e desempenho > Desabilitar recursos incompatíveis. ![Menu Configurações e desempenho do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_incompatible4_262png.png) 2. Selecione Desativar recursos incompatíveis para desmarcar a marca de seleção ao lado desta opção. Para habilitar o recurso novamente, selecione Desativar recursos incompatíveis. Esta opção deve estar habilitada por padrão. #### Tableau Prep Builder (versão 2019.3.1 e posterior) À medida que você constrói seu fluxo, o Tableau Prep Builder pode detectar recursos incompatíveis à medida que os adiciona e sinaliza-os com um ícone de alerta. Você deve estar conectado ao seu servidor para ver esses alertas. Esse sistema de alerta ajuda a identificar rapidamente recursos incompatíveis no fluxo, para decidir se você deseja manter o recurso no fluxo ou removê-lo. Passe o mouse sobre os alertas no painel Fluxo para exibir as informações sobre o recurso incompatível ou use o centro de alerta para ver mais detalhes. No centro de alerta, clique no link Exibir no fluxo para navegar diretamente para a etapa, a anotação, o campo ou a alteração que disparou o aviso. ![Um fluxo de preparação mostrando uma mensagem de aviso sobre um recurso incompatível.](/tableau/current/pt-br/prep/pt-br/Img/prep_compatibility_message_alert.png) #### Tableau Prep Builder (todas as versões) Se você publicar um fluxo com recursos incompatíveis, a seguinte mensagem será exibida e listará os recursos não compatíveis com a versão do Tableau Server a qual está conectado. No Tableau Prep Builder versão 2019.2.3 e anterior, esta é a única maneira de ver quais recursos são incompatíveis no fluxo. **Observação**: a mensagem de erro lista a versão do Tableau Prep Builder, quando o recurso foi introduzido. O Tableau Prep Builder não libera recursos nas versões de manutenção, portanto, para que o recurso seja compatível, o Tableau Server deve executar a próxima versão principal. No exemplo abaixo, o recurso Duplicar campos foi introduzido no Tableau Prep Builder versão 2019.2.3, então que ele não será compatível com a versão de manutenção 2019.2.3 do Tableau Server. Em vez disso, seria compatível com a próxima versão principal do Tableau Server, versão 2019.3. ![Mensagem de erro de versão de fluxo incompatível.](/tableau/current/pt-br/prep/pt-br/Img/prep_versionerror1.png) Se você prosseguir com a publicação do fluxo, ela será concluída com sucesso. No entanto, ao abrir o fluxo no Tableau Server ou no Tableau Cloud, você verá a seguinte mensagem: ![A página Visão geral do fluxo mostra uma mensagem de erro informando que o fluxo inclui recursos incompatíveis e não pode ser executado.](/tableau/current/pt-br/prep/pt-br/Img/prep_conductor_version_error.png) Para agendar e executar o fluxo no Tableau Server, realize uma das ações a seguir: - Procure a versão principal mais recente do [Tableau Server](https://www.tableau.com/pt-br/support/releases/server) compatível com o Tableau Prep Builder que você está usando. Por exemplo, se estiver usando recursos lançado na versão 2019.2.3 do Tableau Prep Builder, para executar o fluxo no Tableau Server, a versão do servidor deverá ser 2020.3 ou posterior. A atualização automática do Tableau Cloud ocorre regularmente, em geral, a cada trimestre. Teste seu fluxo primeiro, para certificar-se de que ele seja compatível com sua versão atual do Tableau Cloud, antes de publicar. - Antes de publicar o fluxo, remova os recursos incompatíveis do fluxo e, em seguida, publique o fluxo. - Se já estiver publicado o fluxo no Tableau Server, tente editar o fluxo diretamente no servidor (versão 2019.4 ou posterior), baixe o fluxo e remova os recursos ou crie-o em uma versão anterior do Tableau Prep Builder usando somente os recursos disponíveis nessa versão. **Observação**: para baixar uma versão específica do Tableau Prep Builder, abra a página [Downloads](http://www.tableau.com/pt-br/support/esdalt) e selecione Tableau Prep Builder na lista no lado esquerdo da página. ### Corrigir problemas de compatibilidade Se o fluxo já estiver publicado no Tableau Server, tente as etapas abaixo para remover os recursos incompatíveis usando sua versão atual do Tableau Prep Builder. Depois de remover os recursos e não ver mais a mensagem ou avisos de incompatibilidade de versão, publique novamente o fluxo no Tableau Server ou no Tableau Cloud para agendá-lo usando o Tableau Prep Conductor. **Observação**: o Tableau Prep Conductor faz parte do Data Management. Ele deve ser habilitado no Tableau Server ou no Tableau Cloud para executar fluxos usando a funcionalidade de agendamento. Para obter mais informações sobre Data Management, consulte [Data Management do Tableau](https://www.tableau.com/pt-br/products/add-ons/data-management). Para obter mais informações sobre como habilitar o Tableau Prep Conductor no Tableau Server ou no Tableau Cloud, consulte [Etapa 2: definir configurações de fluxo do Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm) na ajuda do Tableau Server ou [Tableau Prep Conductor](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm) na ajuda do Tableau Cloud. #### Identificar recursos incompatíveis Se você estiver trabalhando no Tableau Server, ele não listará os recursos incompatíveis no fluxo. Para identificar a lista de recursos a serem removidos do fluxo, será necessário abrir o fluxo no Tableau Prep Builder e removê-los. 1. Abra o fluxo. Se você estiver no Tableau Prep Conductor, no menu Mais ações![A opção de menu Mais opções representada por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_server_rmoremenu.png), clique em Baixar para baixar e abrir o fluxo no Tableau Prep Builder, ou abra o fluxo no Tableau Prep Builder. 2. Se você baixou o fluxo, clique no fluxo baixado para abri-lo. 3. Dependendo da sua versão, siga um destes procedimentos: - **Versão 2019.3.1 e posterior**: no menu superior, selecione Servidor >Entrar. Selecione o mesmo servidor incompatível com o fluxo. As etapas, as anotações, os campos ou as alterações incompatíveis devem ser marcadas com um ícone de alerta. No canto superior direito do painel de fluxo, clique em Alerta para exibir os detalhes de cada recurso incompatível. Clique em Exibir no fluxo para navegar até o recurso incompatível a fim de realizar a ação. ![Três alertas de compatibilidade de versão no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_version_compatibility_alerts2.png) - **Versão 2019.2.3 e anterior**: no menu superior, selecione Servidor >Publicar fluxo. Se você precisar entrar no servidor novamente, certifique-se de selecionar o mesmo servidor incompatível com o fluxo. Uma caixa de diálogo de aviso será aberta, listando os recursos não compatíveis com a versão do servidor. Observe os recursos para identificá-los e removê-los do fluxo. Em seguida, clique em Cancelar para fechar a caixa de diálogo. ![Mensagem de erro de versão de fluxo incompatível.](/tableau/current/pt-br/prep/pt-br/Img/prep_versionerror1.png) 4. No menu superior, clique em Arquivo > Salvar como para salvar uma cópia do fluxo. Use as opções nas seções a seguir para remover recursos incompatíveis do fluxo. #### Remover recursos incompatíveis do fluxo Você pode usar vários métodos para localizar e remover recursos do fluxo. Esta seção mostra algumas opções para ajudar a resolver erros de incompatibilidade. #### Fonte de dados incompatível Se a fonte de dados não for compatível, por exemplo, um novo conector que foi adicionado e ainda não é compatível com o Tableau Prep Conductor, você precisará se conectar a uma fonte de dados compatível. Para alterar sua conexão de dados, consulte [Substituir a fonte de dados](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#input_replace). #### Recursos incompatíveis Para remover os recursos incompatíveis, será necessário localizar as etapas onde foram utilizados e removê-los. Você pode seguir as instruções em [Identificar recursos incompatíveis](#identify_incompat_features) para localizar os recursos incompatíveis. 1. Se o recurso for um tipo de etapa, no painel Fluxo, clique na etapa na qual o recurso é usado. Clique com o botão direito do mouse ou clique pressionando a tecla Control (MacOS) na etapa e selecione Remover. 2. Se o recurso for uma operação de limpeza, no painel Fluxo, clique na etapa na qual o recurso é usado. Você pode focalizar com o mouse sobre as anotações nos painéis Fluxo, Perfil ou Resultados para ver uma lista de alterações. **Observação**: no Tableau Prep Builder versão 2019.1.3 e posteriores, é possível focalizar com o mouse sobre o ícone que representa a alteração que você está procurando em uma etapa no painel Fluxo ou no cartão Perfil e, em seguida, selecionar a anotação na lista de alterações. A alteração é destacada no painel Alterações, Perfil ou Resultados e na grade de dados. 3. Abra o painel Alterações, se necessário, e selecione a alteração que corresponde ao recurso que precisa remover. Clique na alteração para selecioná-la e em Remover para excluí-la do fluxo. ![O painel Alterações em um fluxo do Tableau Prep destacando o "X" para remover uma alteração do fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_conductor_remove_feature.png) 4. Repita essas etapas para substituir quaisquer outros recursos. Em seguida, salve o fluxo e publique-o novamente. [Pular para o conteúdo principal](#main-content) # Conectar a dados > [!WARNING] > > A partir de 14 de outubro de 2025, o Data Cloud foi renomeado como Data 360. Durante essa transição, você pode ver referências a Data Cloud em nosso aplicativo e documentação. Embora o nome seja novo, a funcionalidade e o conteúdo permanecem inalterados. O Tableau Prep ajuda você a limpar e moldar seus dados para análise. A primeira etapa neste processo é identificar os dados com os quais você trabalhará. As informações deste tópico se aplicam a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) na ajuda do Tableau Server. Você pode se conectar aos seus dados usando qualquer um dos seguintes: - [Conectores inseridos para tipos de dados populares](#AboutConnectors) - [Conectores personalizados para outros tipos de dados](#custom-connectors) - [Fontes de dados publicadas](#published_datasource) - [Extrações de dados do Tableau](#data_extract) - [Tableau Catalog](#catalog) ## Conectar-se por meio de conectores inseridos para tipos de dados populares A maneira mais comum de se conectar aos dados é usar os conectores inseridos no Tableau Prep Builder. Eles estão disponíveis para os tipos de dados mais populares e novos conectores são adicionados frequentemente com novas versões do Tableau Prep Builder. Para ver a lista de conectores disponíveis, abra o Tableau Prep Builder ou inicie um fluxo na Web e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png) para ver os conectores disponíveis listados em Conectar no painel esquerdo. A maioria dos conectores inseridos funcionam da mesma forma em todas as nossas plataformas e são descritos no tópico [Conectores com suporte](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm) na Ajuda do Tableau Desktop. **Observação**: ao conectar-se a uma fonte de dados, não use o nome reservado “Número de registros” para um nome de campo ou campo calculado. Usar esse nome reservado resultará em um erro relacionado à permissão. ### Considerações ao usar conectores integrados - Os tipos de dados VARBINARY ou BINARY não são compatíveis. Se você se conectar a uma fonte de dados que inclua esse tipo de dados, esses campos não serão incluídos na lista de campos na etapa de entrada. Para obter mais informações, consulte [Tableau Prep Builder: colunas VARBINARY e BINARY excluídas silenciosamente durante a ingestão de dados](https://help.salesforce.com/s/articleView?id=005390299&type=1) na Base de dados de conhecimento. - Se você abrir um fluxo em uma versão cujo conector não é compatível, ele poderá abrir com erros ou não executar a menos que as conexões de dados sejam removidas. - Ao usar um conector baseado em MySQL, o comportamento padrão é ter uma conexão segura quando o SSL está ativado. No entanto, o Tableau Prep Builder não oferece suporte a conexões SSL baseadas em certificado personalizadas para conectores baseados em MySQL. - A partir da versão 2025.1, você pode se conectar a fontes de dados locais, publicar seu fluxo no Tableau Cloud e executá-lo conforme uma programação. Isso requer um cliente Tableau Bridge configurado em um pool de clientes Bridge, com o domínio adicionado ao Lista de permissões de rede privada. No Tableau Prep Builder e na Web, ao se conectar à sua fonte de dados, certifique-se de que a URL do servidor corresponda ao domínio no pool de ponte. Para obter mais informações, consulte a seção [Bancos de dados](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#cloud_databases) no tópico “Publicar um fluxo no Tableau Server ou Tableau Cloud”. - Não é possível executar o Tableau Prep Conductor para atualizar fluxos do Tableau Prep que se conectam a arquivos simples por meio do Bridge. Para habilitar atualizações de fluxo bem-sucedidas do Prep Conductor, mova o arquivo simples para um local acessível diretamente pelo Tableau Cloud (Google Drive, Box, Dropbox etc.) - A conexão com o Snowflake pelo Bridge não é compatível. - Alguns conectores, detalhados nas seções abaixo, têm requisitos diferentes ao usá-los com o Tableau Prep Builder. - A partir da versão 2025.3, ao se conectar ao Tableau Server ou ao Tableau Cloud do Tableau Prep Builder, você pode selecionar se deseja autenticar usando o navegador inserido fornecido com o Tableau Prep ou usar o navegador padrão para sua máquina. Para obter mais informações, consulte [Publicar um fluxo para o Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#before-you-publish). Conectar-se às fontes de dados de nuvem via Tableau Server ou Tableau Cloud Você pode se conectar a fontes de dados na nuvem do Tableau Prep, do mesmo modo em que no Tableau Desktop; porém, se quiser publicar fluxos que se conectem a fontes de dados na nuvem e executá-los em uma agenda no seu servidor, será necessário configurar suas credenciais no Tableau Server ou no Tableau Cloud. Você configura suas credenciais na guia Configurações na página Minhas configurações de conta e se conecta à entrada do conector de nuvem usando essas mesmas credenciais. #### Tableau Prep Builder Ao publicar o fluxo, na caixa de diálogo Publicar, clique em Editar para editar a conexão e, em seguida, no menu suspenso Autenticação, selecione Inserir . Você também pode adicionar credenciais apenas na caixa de diálogo de publicação (Tableau Prep Builder versão 2020.1.1 e posterior) ao publicar seu fluxo e, em seguida, inseri-las automaticamente nele na publicação. Para obter mais informações, consulte [Publicar um fluxo no Tableau Prep Builder](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#Publish). Se você não tiver as credenciais salvas configuradas e selecionar Solicitar ao usuário no menu suspenso Autenticação, após publicar o fluxo, edite a conexão e insira suas credenciais na guia Conexões do Tableau Server ou do Tableau Cloud ou ocorrerá falha na execução do fluxo. #### Tableau Prep na Web Na autoria da Web, você pode inserir credenciais do menu superior em Arquivo > Credenciais de conexão. Para obter mais informações, consulte [Publicando fluxos](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm#publishing-flows) na ajuda do Tableau Server. ![O menu Arquivo mostra o submenu de Credenciais de conexão, Incorporar no fluxo publicado, para incorporar suas credenciais de conexão de dados em um fluxo quando ele é publicado.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_credentials.png) No Tableau Prep Builder versão 2019.4.1, os seguintes conectores de nuvem foram adicionados e também estão disponíveis na criação ou edição de fluxos na Web: - Box - DropBox - Google Drive - OneDrive Para obter mais informações sobre como se conectar aos dados usando esses conectores, consulte o tópico [específico do conector](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm) na ajuda do Tableau Desktop. Conectar aos seus dados do Salesforce _Com suporte na versão Tableau Prep Builder 2020.2.1 e posteriores, e quando os fluxos de criação são na Web, a partir da Versão 2020.4 do Tableau Server e Tableau Cloud._ O Tableau Prep Builder oferece suporte à conexão com dados usando o conector do Salesforce, assim como o Tableau Desktop, mas com algumas diferenças. - O Tableau Prep Builder é compatível com qualquer tipo de união de colunas que queira fazer. - O SQL personalizado pode ser criado no Tableau Prep Builder 2022.1.1 ou posterior. Os fluxos que usam SQL personalizado podem ser executados e as etapas existentes podem ser editadas em 2020.2.1 ou posterior. - O uso de uma conexão padrão para criar sua própria conexão personalizada não é compatível no momento. - Você não pode alterar o nome da fonte de dados padrão para algo único ou personalizado. - Se você planeja publicar fluxos no Tableau Server e deseja usar credenciais salvas, o administrador do servidor precisa configurar o Tableau Server com uma ID do cliente OAuth e uma senha no conector. Para obter mais informações, consulte [Alterar Salesforce.com OAuth para Credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm) na ajuda do Tableau Server. - Para executar a atualização incremental nas entradas de fluxo que usam o conector Salesforce, você deve usar a versão 2021.1.2 ou posterior do Tableau Prep Builder. Para obter mais informações sobre o uso da atualização incremental, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm). O Tableau Prep importa os dados criando uma extração. Atualmente, apenas extrações são compatíveis com o Salesforce. A extração inicial pode levar algum tempo para carregar, dependendo da quantidade de dados incluídos. Você verá um temporizador na etapa de Entrada enquanto os dados são carregados. Para obter informações gerais sobre o uso do conector do Salesforce, consulte [Salesforce](https://help.tableau.com/current/pro/desktop/pt-br/examples_salesforce.htm) na ajuda do Tableau Desktop e da Criação na Web. Conectar-se o ao Salesforce Data Cloud Você pode se conectar a dados que usam o Salesforce Data Cloud usando o conector do Salesforce Data Cloud (lançado no Tableau Cloud em outubro de 2023). Para obter mais informações, consulte [Conectar a criação na Web do Tableau Cloud ao Salesforce Data Cloud](https://help.tableau.com/current/online/pt-br/config_oauth_sfdc_cdp_online.htm). Para se conectar aos dados do Salesforce Data Cloud, use o conector do Salesforce Data Cloud. O conector Salesforce Data Cloud reconhece Data Spaces, apresenta rótulos de objetos mais claros e é alimentado por consultas aceleradas. 1. No painel Conexões, selecione Salesforce Dados na lista de conectores do Server. 2. Na caixa de diálogo Salesforce Data Cloud, clique em Entrar. 3. Entre no Salesforce com seu nome de usuário e sua senha. 4. Selecione Permitir. 5. Feche o painel do navegador. 6. No Tableau Prep, selecione um espaço de dados para ver as tabelas. 7. Selecione a tabelas. Conectar-se aos dados do Google BigQuery O Tableau Prep Builder oferece suporte à conexão com dados usando o Google BigQuery, igual ao Tableau Desktop. Você deve configurar credenciais para permitir que o Tableau Prep se comunique com o Google BigQuery. Se você planeja publicar fluxos no Tableau Server ou Tableau Cloud, as conexões OAuth também deverão ser configuradas para esses aplicativos. **Observação**: no momento, o Tableau Prep não é compatível com os atributos de personalização do Google BigQuery. - [Configurar OAuth para Google](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm) - Configurar conexões OAuth para o Tableau Server. - [Conexões OAuth](https://help.tableau.com/current/online/pt-br/protected_auth.htm) - Configure conexões Oauth para o Tableau Cloud. #### Configure o SSL para se conectar ao Google BigQuery (apenas MacOS) Se estiver usando o Tableau Prep Builder no Mac e um proxy para se conectar ao Big Query, você precisa modificar a configuração do SSL para se conectar ao Google BigQuery **Observação**: não são necessárias etapas adicionais para os usuários do Windows. Para configurar o SSL para conexões OAuth ao Google BigQuery, conclua as seguintes etapas: 1. Exporte o certificado SSL do seu proxy para um arquivo, por exemplo proxy.cer. Você pode encontrar o certificado em `Applications > Utilities > Keychain Access >System > Certificates (under Category)`. 2. Localize a versão do java que você está usando para executar Tableau Prep Builder. Por exemplo: `/Applications/Tableau Prep Builder 2020.4.app/Plugins/jre/lib/security/cacerts` 3. Abra o prompt de comando do Terminal e execute o seguinte comando para sua versão do Tableau Prep Builder: **Observação**: o comando keytool deve ser executado no diretório que contém a versão de java que você está usando para executar o Tableau Prep Builder. Você pode ter que mudar os diretórios antes de executar esse comando. Por exemplo, `cd /Users/tableau_user/Desktop/SSL.cer -keystore Tableau Prep Builder 2020.1.1/Plugins/jre/bin`. Em seguida, execute o comando keytool. `keytool –import –trustcacerts –file /Users/tableau_user/Desktop/SSL.cer -keystore Tableau Prep Builder /Plugins/jre/lib/security/cacerts -storepass changeit` **Exemplo**: `keytool –import –trustcacerts –file /Users/tableau_user/Desktop/SSL.cer -keystore Tableau Prep Builder 2020.4.1/Plugins/jre/lib/security/cacerts -storepass changeit` Se receber um erro FileNotFoundException (Acesso negado) ao executar o comando keytool, tente executar o comando com permissões elevadas. Por exemplo: `sudo keytool –import –trustcacerts –file /Users/tableau_user/Desktop/SSL.cer -keystore Tableau Prep Builder 2020.4.1/Plugins/jre/lib/security/cacerts -storepass changeit`. #### Configurar e gerenciar as credenciais do Google BigQuery As credenciais que você usa para se conectar ao Google BigQuery em sua etapa de Entrada devem corresponder às credenciais definidas na guia Configurações na página Minhas configurações de conta do Google BigQuery em Tableau Server ou Tableau Cloud. Se você selecionar credenciais diferentes ou nenhuma credencial em sua configuração de autenticação ao publicar seu fluxo, o fluxo falhará com um erro de autenticação até que você edite a conexão para o fluxo no Tableau Server ou Tableau Cloud. Para editar as credenciais, faça o seguinte: 1. No Tableau Server ou Tableau Cloud, na guia Conexões, na conexão Google BigQuery, clique em Mais ações![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) . 2. Selecione Editar Conexão. 3. Selecione as credenciais salvas que estão configuradas na guia Configurações na página Minhas configurações de conta. #### Entrar usando o arquivo de conta de serviço (JSON) _Com suporte no Tableau Prep Builder versão 2021.3.1 e posteriores. O acesso à conta de serviço não está disponível durante a criação de fluxos na Web_. 1. Adicione uma Conta de Serviço como uma credencial salva. Para obter mais informações, consulte [Alterar o Google OAuth para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm). 2. Entre no Google BigQuery usando seu e-mail ou telefone e selecione Próximo. 3. Em Autenticação, selecione Entrar usando o arquivo de conta de serviço (JSON). 4. Digite o caminho do arquivo ou use o botão Procurar para procurá-lo. 5. Clique em Fazer logon. 6. Digite sua senha para continuar. 7. Selecione Aceitar para permitir que o Tableau possa acessar os dados do Google BigQuery. Você será solicitado a fechar o navegador. #### Entrar usando OAuth _Com suporte na versão Tableau Prep Builder 2020.2.1 e posteriores, e quando os fluxos de criação são na Web, a partir da Versão 2020.4 do Tableau Server e Tableau Cloud._ 1. Entre no Google BigQuery usando seu e-mail ou telefone e selecione Próximo. 2. Em Autenticação, selecione Entrar usando OAuth. 3. Clique em Fazer logon. 4. Digite sua senha para continuar. 5. Selecione Aceitar para permitir que o Tableau possa acessar os dados do Google BigQuery. Você será solicitado a fechar o navegador. Para obter mais informações sobre a definição e o gerenciamento de suas credenciais, consulte os seguintes tópicos: [Gerenciar as configurações da sua conta](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm) na ajuda do Tableau Desktop e da Criação na Web. [Publicar um fluxo no Tableau Prep Builder](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#Publish)para obter informações sobre a configuração das opções de autenticação ao publicar um fluxo. [Ver e solucionar erros](https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm#view-and-resolve-errors) para obter informações sobre a resolução de erros de conexão no Tableau Server ou no Tableau Cloud. Conexão com os dados do SAP HANA _Com suporte na versão Tableau Prep Builder 2019.2.1 e posteriores, e quando os fluxos de criação são na Web, a partir da Versão 2020.4 do Tableau Server e Tableau Cloud._ O Tableau Prep Builder, o Tableau Server e o Tableau Cloud oferecem suporte à conexão com dados usando o conector do SAP HANA, assim como o Tableau Desktop, mas com algumas diferenças. Conecte-se ao banco de dados usando o mesmo procedimento que usaria no Tableau Desktop. Para obter mais informações consulte [SAP HANA](https://help.tableau.com/current/pro/desktop/pt-br/examples_saphana.htm). Após conectar-se e procurar sua tabela, arraste-a para a tela para começar a criar o fluxo. **Observação**: esse conector requer o Tableau Server versão 2019.2 e posterior para executar o fluxo de acordo com uma agenda. Se você estiver usando uma versão anterior do servidor, poderá atualizar os dados de fluxo usando a interface da linha de comandos. Para obter mais informações sobre a execução de fluxos na linha de comando, consulte [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm). Para obter mais informações sobre a compatibilidade de versão, consulte [Compatibilidade de versão com o Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_conductor_compatibility.htm). - Se seu banco de dados SAP HANA incluir variáveis e parâmetros, você precisará inserir esses dados na seção Variáveis e parâmetros na guia Configurações da etapa de entrada para definir esses valores. Para conferir versões do Tableau Prep mais antigas (2026.1 e anteriores), navegue até a guia Variáveis e parâmetros na etapa de entrada. - A conexão com fontes de dados SAP HANA que usam valores de variáveis e parâmetros só é compatível com fontes de dados em tempo real. Essa opção não é compatível com fontes de dados SAP HANA publicadas. - A partir do Tableau Cloud versão 2026.2, você pode se conectar a fontes de dados SAP HANA locais que incluem variáveis e parâmetros por meio do Tableau Bridge. - A partir do Tableau Prep Builder versão 2019.2.2 e na Web a partir da versão 2020.4.1, você pode usar o SQL inicial para consultar sua conexão. Se você tiver vários valores para uma variável, poderá selecionar o valor de que precisa em uma lista suspensa. **Inserir variáveis e parâmetros** 1. Conexão com sua fonte de dados do SAP HANA. 2. No painel Entrada, na guia Configurações, selecione as variáveis e os operandos que deseja usar. ![Entrada SAP HANA para parâmetros e variáveis](/tableau/current/pt-br/prep/pt-br/Img/prep_SAPHANA_262.png) Nas versões anteriores (2026.1 e anteriores), selecione a guia Variáveis e parâmetros e, em seguida, selecione as variáveis e os operandos que deseja usar. ![Se você tiver vários valores para uma variável, poderá selecionar o valor de que precisa em uma lista suspensa.](/tableau/current/pt-br/prep/pt-br/Img/prep_SAPHANA.png) 3. Selecione de uma lista de valores predefinidos ou insira valores personalizados para consultar seu banco de dados e retornar os valores necessários ou adicionar outras variáveis. Para adicionar variáveis, clique no botão de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) na seção Variáveis e selecione uma variável e um operando, em seguida, insira um valor personalizado. ![Para adicionar mais valores, clique no sinal de mais na seção Variáveis, selecione uma variável e um operando e, em seguida, insira um valor personalizado.](/tableau/current/pt-br/prep/pt-br/Img/prep_SAPHANA2.png) Conectar-se a arquivos espaciais e bancos de dados _Com suporte na versão Tableau Prep Builder 2020.4.1 e posteriores, e quando os fluxos de criação são na Web, a partir da Versão 2020.4 do Tableau Server e Tableau Cloud._ Você pode se conectar a arquivos espaciais e fontes de dados espaciais no Tableau Prep Builder ou ao criar ou editar fluxos na Web. **Observação**: tipos de arquivo .shp não são compatíveis no momento na Web. Se precisar se conectar a esse tipo de arquivo, conecte-se a ele no Tableau Prep Builder e publique o fluxo no servidor. O Tableau Prep oferece suporte aos seguintes tipos de conexão: - Formatos de arquivo espacial - Tableau Prep Builder: Esri Shapefiles, Bancos de dados geográficos do arquivo Esri, KML, TopoJSON, GeoJSON, extrações, MapInfo MID/MIF, arquivos TAB e shapefiles compactados. - Tableau Server e Tableau Cloud: shapefiles compactados, KML, TopoJSON, GeoJSON, bancos de dados geográficos de arquivos Esri e extrações. - Bancos de dados espaciais (Amazon Redshift, Microsoft SQL Server, Oracle e PostgreSQL). A partir da versão 2026.1, você pode criar campos calculados usando funções espaciais e unir colunas de dados espaciais na etapa de União de colunas por meio do operador de interseções. Para obter mais informações, consulte [Criar cálculos espaciais e uniões de colunas](https://help.tableau.com/current/prep/pt-br/prep_spatial_calculations_and_joins.htm). Você também pode combinar tabelas espaciais com tabelas não espaciais usando um padrão de dados espaciais de união e saída para um arquivo de extração (.hyper). No momento, não há suporte para a exibição de dados espaciais em uma visualização de mapa no Tableau Prep. #### Operações de limpeza compatíveis Durante o trabalho com dados de arquivos espaciais, algumas operações de limpeza não são compatíveis. Apenas as seguintes operações de limpeza estão disponíveis no Tableau Prep ao trabalhar com dados de arquivos de formato. - Filtros: somente para remover valores nulos ou desconhecidos - Renomear campo - Duplicar Campo - Manter apenas o campo - Remover campo - Criar campo calculado #### Antes de se conectar Antes de se conectar a arquivos espaciais, certifique-se de que os seguintes arquivos estejam no mesmo diretório: - **Shapefiles Esri**: a pasta deve conter arquivos .shp, .shx, .dbf, and .prj, bem como arquivos .zip ou Esri shapefile. - **Para bancos de dados geográficos do arquivo Esri**: a pasta deve conter .gdb ou .zip do arquivo .gdb do banco de dados geográficos do arquivo. - **Para arquivos KML:** a pasta deve conter o arquivo kml. (Nenhum outro arquivo é necessário.) - **Para arquivos GeoJSON**: a pasta deve conter o arquivo .geojson (Nenhum outro arquivo é necessário.) - **Para arquivos TopoJSON**: a pasta deve conter o arquivo .json ou .topojson. (Nenhum outro arquivo é necessário.) #### Conectar-se a arquivos espaciais 1. Execute um destes procedimentos: - Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). - Abra Tableau Server ou Tableau Cloud. No menu Explorar, clique em Novo > Fluxo. 2. Na lista de conectores, selecione Arquivos espaciais. Os campos espaciais recebem tipos de dados espaciais e não podem ser alterados. Se os campos vierem de um arquivo espacial, o campo será atribuído a um nome de campo padrão de "Geometria". Se os campos vierem de um banco de dados espacial, os nomes de campo do banco de dados são mostrados. Se o Tableau não puder determinar o tipo de dados, o campo será "Nulo". ![Tableau Prep com dados espaciais.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial.png) Conectar-se usando ODBC _Com suporte noTableau Prep Builder versão 2019.2.2 e posterior. Este tipo de conector ainda não é suportado quando há fluxos de criação na Web._ Se você precisar se conectar a fontes de dados que não estão listadas no painel Conexões, poderá se conectar a qualquer fonte de dados usando o conector Outros Bancos de Dados (ODBC) que ofereça suporte ao padrão SQL e implemente a API ODBC. A conexão a dados usando o conector Outros bancos de dados (ODBC) funciona de forma semelhante a como você pode usá-lo no Tableau Desktop; no entanto há algumas diferenças: - Você só pode se conectar usando a opção DSN (nome da fonte de dados ). - Para publicar e executar seu fluxo no Tableau Server, o servidor deve ser configurado usando um DSN correspondente. **Observação**: a execução de fluxos na linha de comando que incluem o conector Outros bancos de dados (ODBC) não é suportada no momento. - Há uma única experiência de conexão para Windows e MacOS. Não há suporte para a solicitação de atributos de conexão para drivers ODBC (Windows). - Somente drivers de 64 bits são compatíveis com o Tableau Prep Builder. #### Antes de se conectar Para se conectar aos dados usando o conector Outros bancos de dados (ODBC), instale o driver de banco de dados e defina e configure seu DSN (nome da fonte de dados). Para publicar e executar fluxos no Tableau Server, o servidor também deve ser configurado com um DSN correspondente. > [!IMPORTANT] > > **Importante**: o Tableau Prep Builder só oferece suporte a drivers de 64 bits. Se você já tiver um driver de 32 bits definido e configurado, talvez seja necessário desinstalá-lo e instalar a versão de 64 bits se o driver não permitir que ambas as versões sejam instaladas ao mesmo tempo. 1. Crie um DSN usando o Administrador da fonte de dados ODBC (64 bits) (Windows) ou um utilitário do Gerenciador ODBC (MacOS). Se você não tiver o utilitário instalado no Mac, poderá fazer o download em ([www.odbcmanager.net](http://www.odbcmanager.net/), por exemplo) ou poderá editar manualmente o arquivo odbc.ini. 2. No Administrador da Fonte de Dados ODBC (64 bits) (Windows) ou no utilitário do Gerenciador ODBC (MacOS), adicione uma nova fonte de dados e selecione o driver para a fonte de dados e, em seguida, clique em Concluir. ![Lista de drivers para configurar uma nova fonte de dados no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_odbc_driver_setup.png) 3. Na caixa de diálogo Configuração do driver de ODBC, insira as informações de configuração como nome do servidor, porta, nome de usuário e senha. Clique em Testar (se a caixa de diálogo tiver essa opção) para verificar se a conexão está configurada corretamente; em seguida, salve sua configuração. **Observação**: o Tableau Prep Builder não oferece suporte ao aviso de atributos de conexão; portanto, você deve definir essas informações ao configurar o DNS. Esse exemplo mostra a caixa de diálogo de configuração de um Conector MySQL. ![Janela de configuração da fonte de dados do Conector MySQL.](/tableau/current/pt-br/prep/pt-br/Img/prep_odbc_driver_setup2.png) #### Conectar usando outros bancos de dados (ODBC) 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). 2. Na lista de conectores, selecione Outros bancos de dados (ODBC). 3. Na caixa de diálogo Outros bancos de dados (ODBC), selecione um DSN na lista suspensa e digite o nome de usuário e a senha. Em seguida, clique em Registrar. ![Janela de logon Outros bancos de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_ODBC_signin.png) 4. No painel Conexões, selecione seu banco de dados na lista suspensa. ![Lista de conexões de outros bancos de dados do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_ODBC_connection.png) Conectar-se aos dados do Microsoft Excel e limpe com o Interpretador de dados _Compatível apenas com conexões diretas do Microsoft Excel. O Interpretador de Dados não está atualmente disponível para arquivos do Excel armazenados em unidades de nuvem._ **Observação**: não é possível executar o Tableau Prep Conductor para atualizar fluxos do Tableau Prep que se conectam a arquivos simples por meio do Bridge. Para habilitar atualizações de fluxo bem-sucedidas do Prep Conductor, mova o arquivo simples para um local acessível diretamente pelo Tableau Cloud (Google Drive, Box, Dropbox etc.) Ao trabalhar com arquivos Microsoft Excel, é possível usar o Interpretador de dados para detectar subtabelas nos dados e remover informações irrelevantes, de forma a ajudar a preparar os dados para análise. Quando o Interpretador de dados é ativado, ele detecta essas subtabelas e as lista na seção Tabelas do painel Conexões. Em seguida é possível arrastá-las até o painel Fluxo. Se o Interpretador de dados for desativado, essas tabelas serão removidas do painel Conexões. Se as tabelas já estiverem em uso no fluxo, esta ação resultará em erros de fluxo dos dados ausentes. **Observação**: atualmente, o Interpretador de dados detecta apenas subtabelas em planilhas do Excel e não oferece suporte à especificação da linha inicial de arquivos de texto e planilhas. Além disso, as tabelas detectadas pelo Interpretador de dados não estão incluídas nos resultados de pesquisa da União de linhas curinga. O exemplo abaixo mostra os resultados do uso do Interpretador de dados em uma planilha do Excel no painel Conexões. O Interpretador de dados detectou duas subtabelas adicionais.
Antes do Interpretador de dadosDepois do Interpretador de dados
A caixa de seleção Usar Interpretador de dados no painel Conexões no Tableau Prep.Os resultados do Interpretador de dados aparecem na seção Tabelas do painel Conexões no Tableau Prep, mostrando uma lista de subtabelas encontradas.
Para usar o Interpretador de dados, conclua as etapas abaixo: 1. Selecione Conectar a dados e, em seguida, Microsoft Excel. 2. Selecione seu arquivo e clique em Abrir. 3. Marque a caixa de seleção Usar Interpretador de dados. 4. Arraste a nova tabela até o painel **Fluxo** para incluí-la no fluxo. Para remover a tabela antiga, clique com o botão direito do mouse na etapa de entrada da antiga tabela e selecione Remover. ## Conectar-se usando conectores personalizados Quando o Tableau Prep não fornece um conector inserido para seus dados baseados em ODBC e JDBC, você pode usar um conector personalizado. É possível: - Use um conector desenvolvido por um parceiro. Para obter mais informações sobre conectores na troca, consulte [Use conectores desenvolvidos por parceiros](#partner_connect). - Usar um conector do cliente criado com o Tableau Connector SDK. O Connector SDK fornece ferramentas para criar um conector personalizado para dados baseados em ODBC ou JDBC. Para obter mais informações, consulte [Conectores criados com o Tableau Connector SDK](https://help.tableau.com/current/pro/desktop/pt-br/examples_connector_sdk.htm) na ajuda do Tableau Desktop. Os conectores personalizados para dados baseados em ODBC e JDBC são compatíveis com o Tableau Prep Builder versão 2020.4.1 e posterior. Para desenvolvedores de conectores, consulte [Executar seu conector](https://tableau.github.io/connector-plugin-sdk/docs/run-taco) para obter mais informações. Alguns conectores personalizados exigem a instalação de um driver adicional. Se solicitado durante o processo de conexão, siga as instruções para baixar e instalar o driver necessário. No momento, conector personalizado não pode ser usados com o Tableau Cloud. #### Use conectores desenvolvidos por parceiros Os conectores criados por parceiros ou outros conectores personalizados estão disponíveis no painel Conectar. Esses conectores estão listados em Conexões adicionais e também estão disponíveis na página [Conectores do Tableau Exchange](https://extensiongallery.tableau.com/connectors). 1. Clique em Conexões no painel esquerdo. 2. Na seção Conectores adicionais, no painel Conectar, clique no conector que deseja usar. 3. Clique em Instalar e reiniciar o Tableau. Depois que o conector é instalado, ele aparece na seção **Para um servidor** do painel Conectar. **Observação**: se você receber um aviso de que os conectores não podem ser carregados, instale o arquivo .taco necessário na página [Conectores do Tableau Exchange](https://extensiongallery.tableau.com/connectors). Se você for solicitado a instalar os drivers, vá para [Tableau Exchange](https://extensiongallery.tableau.com/connectors) para obter instruções e locais de download do driver. ## Conectar a fontes de dados publicadas As fontes de dados publicadas são aquelas que você pode compartilhar com outras pessoas. Quando quiser disponibilizar uma fonte de dados para outros usuários, você pode publicá-la no Tableau Prep Builder (versão 2019.3.1 e posterior) para Tableau Server ou Tableau Cloud, ou como saída do fluxo. Você pode usar uma fonte de dados publicada como fonte de dados de entrada para o fluxo, caso esteja trabalhando no Tableau Prep Builder ou na Web. **Observação**: quando você publica um fluxo que inclui uma fonte de dados publicada como uma entrada, o editor é atribuído como o proprietário padrão do fluxo. Quando o fluxo é executado, ele usa o proprietário do fluxo da conta Run As . Para obter mais informações sobre a conta Run As, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm). Somente o administrador do Site ou do Servidor pode alterar o proprietário do fluxo no Tableau Server ou Tableau Cloud e somente para ele próprio. O Tableau Prep Builder é compatível com: - Fontes de dados publicadas com filtros de usuário ou funções a partir do Tableau Prep Builder versão 2021.1.3. - Conexões a um único servidor e site. O login em um servidor diferente ou no mesmo servidor e site diferente não é suportado. Você deve usar o mesmo servidor ou conexão de site para fazer o seguinte: - Conectar-se à fonte de dados publicada. - Publicar saída de fluxo para Tableau Server ou Tableau Cloud. - Programar a execução do fluxo no Tableau Server ou Tableau Cloud. Se seu fluxo usar fontes de dados publicadas e você sair do servidor, isso interromperá a conexão do fluxo. O fluxo estará em um estado de erro e você não poderá ver os dados da fonte de dados publicada no painel de perfil ou na grade de dados. **Observação:** o Tableau Prep Builder não oferece suporte a fontes de dados publicadas que incluem dados multidimensionais (cubo), conexões de vários servidores ou fontes de dados publicadas com tabelas relacionadas. Tableau Server e Tableau Cloud são compatíveis com: - Fontes de dados publicadas com filtros de usuário ou funções a partir do Tableau Server e Tableau Cloud versão 2021.2. - Criação ou edição de um fluxo na Web usando uma fonte de dados publicada (Tableau Server ou Tableau Cloud versão 2020.4 e posterior) - Conexão a fontes de dados publicadas (Tableau Server e Tableau Cloud versão 2019.3 e posterior) **Observação:** as versões anteriores do Tableau Server podem não oferecer suporte a todos os recursos da fonte de dados publicada. #### Sobre credenciais e permissões: - Você deve receber uma função do Explorer ou superior no site do servidor que você está conectado, para se conectar a fontes de dados publicadas. Apenas os Creators podem criar ou editar fluxos na Web. Para obter mais informações sobre funções de site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm) na ajuda do Tableau Server. - No Tableau Prep Builder, o acesso à fonte de dados é autorizado com base na identidade do usuário conectado ao servidor. Você verá apenas os dados aos quais tem acesso. - Em criação na Web do Prep (Tableau Server e Tableau Cloud), o acesso à fonte de dados também é autorizado com base na identidade do usuário conectado ao servidor. Você verá apenas os dados aos quais tem acesso. No entanto, quando você executa o fluxo manualmente ou usando um planejamento, o acesso à fonte de dados é autorizado com base na identidade do proprietário do fluxo. O último usuário a publicar um fluxo se torna o novo proprietário do fluxo. - Os administradores do site e do servidor podem alterar o proprietário do fluxo, mas apenas para eles próprios. - As credenciais devem ser inseridas para se conectar à fonte de dados publicada. **Dica:** se as credenciais não forem inseridas à fonte de dados, atualize a fonte de dados para incluir as credenciais inseridas. ### Utilização de fontes de dados publicadas em seu fluxo Para se conectar a uma fonte de dados publicada e usá-la no fluxo, siga as instruções da versão do Tableau Prep: Tableau Prep Builder versão 2020.2.2 e posterior e na Web Conecte-se às fontes de dados publicadas e mais que são armazenadas no Tableau Server ou no Tableau Cloud diretamente do painel Conectar. Se você tiver o [Data Management](https://www.tableau.com/pt-br/products/add-ons/data-management) com o Tableau Catalog ativado, você também poderá procurar e se conectar a bancos de dados e tabelas e visualizar ou filtrar por metadados sobre as fontes de dados, como descrições, avisos de qualidade de dados e certificações. Para obter mais informações sobre Tableau Catalog, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm). 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Em criação na Web, na página Início, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Em seguida, clique em Conectar a dados. 2. No painel Conectar, em Pesquisar dados, selecione Tableau Server. ![Conexão do Tableau Prep com o Tableau Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_SearchDataCatalog.png) 3. Entre para conectar-se ao seu servidor ou site. Na criação na Web, a caixa de diálogo Pesquisar dados é aberta para o servidor ao qual você está conectado. A partir da versão 2025.3, você também pode selecionar o método de autenticação do servidor (navegador inserido ou navegador padrão). Para obter mais informações, consulte [Publicar um fluxo para o Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#before-you-publish). 4. Na caixa de diálogo Pesquisar dados, pesquise a partir de uma lista de fontes de dados publicadas disponíveis. Use a opção de filtro para filtrar por tipo de conexão e fontes de dados certificadas. 5. Selecione a fonte de dados que deseja usar e clique em Conectar. Se não tiver permissão para se conectar a uma fonte de dados, a linha e o botão Conectar são esmaecidos. **Observação**: a lista suspensa Tipo de conteúdo não será mostrada se você não tiver o Data Management com o Tableau Catalog ativado. Apenas fontes de dados publicadas são mostradas na lista. ![Painel Pesquisar por dados com o tipo de conteúdo Fontes de dados selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_SearchDataCatalog2.png) 6. A fonte de dados é adicionada ao painel Fluxo. No painel Conexões, selecione fontes de dados adicionais ou use a opção de pesquisa para localizar a fonte de dados e arrastá-la até o painel Fluxo para criar o fluxo. A guia Tableau Server no painel Entrada mostra detalhes sobre a fonte de dados publicada. ![Um fluxo do Tableau Prep mostra uma lista de fontes de dados pesquisáveis no painel Conexões.](/tableau/current/pt-br/prep/pt-br/Img/prep_dai_metadata.png) 7. (Opcional) Se você tiver o Data Management com o Tableau Catalog ativado, use a lista suspensa Tipo de conteúdo para procurar por bancos de dados e tabelas. ![Painel Pesquisar por dados com o tipo de conteúdo Fontes de dados selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_SearchDataCatalog3.png) Use a opção de filtro no canto superior direito para filtrar os resultados por tipo de conexão, avisos de qualidade de dados e certificações. ![Uma barra de pesquisa com filtros para tipo de conexão, avisos de qualidade de dados e certificação.](/tableau/current/pt-br/prep/pt-br/Img/prep_connectto_filter.png) Tableau Prep Builder versão 2020.2.1 e posteriores 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). 2. Na lista de conectores, selecione Tableau Server. ![O painel Conectar do Tableau Prep mostra a conexão do Tableau Server destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_connect_dai.png) 3. Entre para conectar-se ao seu servidor ou site. 4. Selecione a fonte de dados ou use a opção de pesquisa para localizar a fonte de dados e arraste-a até o painel de fluxo para iniciar o fluxo. A guia Tableau Server no painel Entrada mostra detalhes sobre a fonte de dados publicada. ![Um fluxo do Tableau Prep mostra uma lista de fontes de dados pesquisáveis no painel Conexões.](/tableau/current/pt-br/prep/pt-br/Img/prep_dai_metadata.png) ## Conectar-se a conexões virtuais _Compatível com o Tableau Prep Builder versão 2021.4.1 e posterior e o Tableau Server e Tableau Cloud versão 2021.4 e posterior. O Data Management é necessário para usar este recurso._ Você pode se conectar aos dados usando conexões virtuais para seus fluxos. As conexões virtuais são um recurso compartilhável que fornece um ponto de acesso central aos dados. #### Considerações ao se conectar a conexões virtuais: - As credenciais do banco de dados são inseridas à conexão virtual. Você só precisa entrar em seu servidor para acessar as tabelas na conexão virtual. - As políticas de dados que aplicam a segurança em nível de linha podem ser incluídas na conexão virtual. Apenas tabelas, campos e valores aos quais você tem acesso são mostrados ao trabalhar e executar seus fluxos. - A segurança em nível de linha em conexões virtuais não se aplica à saída de fluxo. Todos os usuários com acesso à saída do fluxo veem os mesmos dados. - SQL personalizado e SQL inicial não são compatíveis. - Parâmetros não são compatíveis. Para obter mais informações sobre como usar parâmetros em seu fluxo, consulte [Criar e usar parâmetros em fluxos](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm) . Para obter mais informações sobre as conexões virtuais e as políticas de dados, consulte a ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_vconn_overview.htm). 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Em criação na Web, na página Início, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Em seguida, clique em Conectar a dados. 2. No painel Conectar, em Pesquisar dados, selecione Tableau Server. ![Conexão do Tableau Prep com o Tableau Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_SearchDataCatalog.png) 3. Entre para conectar-se ao seu servidor ou site. Na autoria da Web, a caixa de diálogo Pesquisar dados é aberta para o servidor em que você está conectado. 4. Clique Digitar tudo. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_search_vconn.png) 5. Selecione Conexão virtual. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_select_vconn.png) 6. Selecione a fonte de dados que deseja usar e clique em Conectar. 7. A fonte de dados é adicionada ao painel Fluxo. No painel Conexões, você pode selecionar na lista de tabelas incluídas na conexão virtual e arrastá-las para a área de janela de fluxo para iniciar o fluxo. ![Tabelas do Tableau Prep e visualização de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_virtual_connections3.png) **Observação**: se você vir as operações Renomear no painel Alterações ao conectar-se a uma conexão virtual, não as remova. O Tableau Prep gera automaticamente essas operações para mapear e exibir o nome amigável do campo. ## Conectar-se às extrações de dados do Tableau Você pode se conectar a uma extração de dados como entrada para seu fluxo de dados. Extrações são subconjuntos de dados salvos que você pode criar usando filtros e configurando outros limites. As extrações são salvas como arquivos .hyper. Para obter mais informações sobre como usar extrações com Tableau Prep Builder, consulte [Salvar e compartilhar seu trabalho](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm). ## Conectar-se aos dados por meio do Tableau Catalog Se você tiver o [Data Management](https://www.tableau.com/pt-br/products/add-ons/data-management) com o Tableau Catalog ativado, também poderá procurar e se conectar a bancos de dados, arquivos e tabelas armazenados no Tableau Server ou Tableau Cloud. Para obter mais informações sobre o Tableau Catalog, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm). ## Outras opções de conexão Ao se conectar, você também verá as seguintes opções, dependendo da conexão escolhida. ### Usar SQL personalizado para conectar-se aos dados. Se você sabe exatamente as informações que precisa de um banco de dados e entende como escrever consultas SQL, você pode usar consultas SQL personalizadas para se conectar aos dados da forma que puder no Tableau Desktop. É possível usar o SQL personalizado para unir linhas de dados em tabelas, reformular campos para realizar uniões de colunas cruzadas entre bancos de dados, reestruturar ou reduzir o tamanho dos dados para análise e assim em diante. 1. Conecte-se à sua fonte de dados e, no painel Conexões, no campo Banco de dados, selecione um banco de dados. 2. Clique no link SQL personalizado para abrir a guia SQL personalizado. ![A guia SQL personalizado em uma etapa de entrada de fluxo do Tableau Prep, em que você pode inserir uma consulta SQL para se conectar aos dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_sql.png) 3. Digite ou cole a consulta na caixa de texto e, em seguida, clique em Executar para executar sua consulta. ![A guia SQL personalizado em uma etapa de entrada de fluxo do Tableau Prep mostra um exemplo de consulta SQL.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_SQL2.png) 4. Adicione uma etapa de limpeza no painel de fluxo para ver se apenas campos relevantes da consulta SQL personalizada são adicionados ao seu fluxo. ### Usar SQL inicial para consultar suas conexões _Com suporte na versão Tableau Prep Builder 2019.2.2 e posteriores, e quando os fluxos de criação são na Web, a partir da versão 2020.4.1._ Você pode especificar um comando SQL inicial que será executado quando for feita uma conexão no banco de dados compatível. Por exemplo, ao se conectar ao Amazon Redshift, você pode inserir uma instrução SQL para aplicar um filtro ao se conectar ao banco de dados como na adição de filtros na etapa de entrada. O comando SQL será aplicado antes que os dados sejam amostrados e carregados no Tableau Prep. A partir do Tableau Prep Builder (versão 2020.1.3) e na Web, você também pode incluir parâmetros para passar dados de nome, versão e nome de fluxo do aplicativo e incluir dados de rastreamento ao consultar sua fonte de dados. ### Executar o SQL inicial Para atualizar os dados e executar o comando SQL inicial, siga um dos seguintes procedimentos: - Altere o comando SQL inicial e atualize a etapa de entrada para restabelecer a conexão. - Execute o fluxo. O comando SQL inicial é executado antes do processamento de todos os dados. - Execute o fluxo no Tableau Server ou Tableau Cloud. O SQL inicial é executado sempre que o fluxo é executado como parte da experiência de carregamento de dados **Observação**: [Data Management](https://www.tableau.com/pt-br/products/add-ons/data-management) é necessário para executar o seu fluxo no Tableau Server ou Tableau Cloud. Para obter mais informações sobre o Data Management, consulte [Sobre o Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm). ![Um formulário para conexão com o Amazon Redshift.](/tableau/current/pt-br/prep/pt-br/Img/prep_initialSQL.png) 1. No painel Conexões, selecione um conector na lista que suporta o SQL inicial. 2. Clique no link Mostrar SQL inicial para expandir a caixa de diálogo e insira suas instruções SQL. ### Incluir parâmetros em uma instrução de SQL inicial _Com suporte na versão Tableau Prep Builder 2020.1.3 e posteriores, e quando os fluxos de criação são na Web, a partir da versão 2020.4.1._ Você pode passar os seguintes parâmetros para sua fonte de dados com o objetivo de adicionar detalhes adicionais sobre o aplicativo Tableau Prep, versão e nome de fluxo. Os parâmetros TableauServerUser e TableauServerUserFull não são suportados atualmente.
ParâmetroDescriçãoValor retornado
TableauAppO aplicativo que está sendo usado para acessar sua fonte de dados.

Prep Builder

Prep Conductor

TableauVersionO número da versão do aplicativo.

Tableau Prep Builder: retorna a versão exata. Por exemplo, 2020.4.1

Tableau Prep Conductor, retorna a versão principal do servidor onde o Tableau Prep Conductor está habilitado. Por exemplo, 2020.4

FlowNameO nome do arquivo .tfl em Tableau Prep BuilderExemplo: Entertainment Data_Cleaned
## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Iniciar ou abrir um Fluxo de dados Para começar a preparar seus dados com Tableau Prep Builder, você pode: - [Iniciar um novo fluxo](#NewFlow) - [Abrir um fluxo existente](#Open) **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. As informações deste tópico se aplicam a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Você pode abrir várias áreas de trabalho do Tableau Prep Builder para trabalhar em vários fluxos ao mesmo tempo. No Tableau Prep Builder versão 2019.3.1 e anterior, se você selecionar Arquivo > Abrir, Tableau Prep Buildersubstituirá o fluxo aberto atual pelo novo fluxo selecionado. ## Iniciar um novo fluxo Inicie um novo fluxo conectando-se aos seus dados, assim como no Tableau Desktop. **Observações**: se você abrir um fluxo em uma versão cujo conector não é suportado, ele poderá abrir com erros ou não executar a menos que as conexões de dados sejam removidas. Alguns conectores podem exigir o download e a instalação de um driver antes da conexão. Consulte a página [Download do driver](https://www.tableau.com/pt-br/support/drivers) no site do Tableau para obter links de download do driver e instruções de instalação. 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Em criação na Web, na página Início, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Em seguida, clique em Conectar a dados. A partir da versão 2021.4, se você tiver o Data Management com o Catálogo habilitado, você também pode clicar em Novo > Fluxo na página Ativos externos na Web para criar um fluxo com uma conexão compatível com o Catalog. Para obter mais informações, consulte **Tableau Catalog**, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm). 2. Na lista de conectores, selecione o tipo de arquivo ou servidor que hospeda seus dados. Se solicitado, insira as informações necessárias para acessar seus dados. **Observação**: na Criação na Web, a lista de conectores de arquivos pode ser diferente. ![O painel Conectar do Tableau Prep mostra uma lista de fontes de dados disponíveis, de arquivos a servidores.](/tableau/current/pt-br/prep/pt-br/Img/prep_connect_2020.2.2.png) 3. No painel Conexões, realize uma das seguintes ações: - Caso tenha se conectado a um arquivo, clique duas vezes ou arraste uma tabela até o painel Fluxo. Em tabelas únicas, o Tableau Prep cria automaticamente uma etapa de entrada no painel Fluxo ao adicionar dados ao fluxo. **Observação**: na criação na Web, para conexões de arquivos, você só pode baixar os arquivos um de cada vez. Conexões diretas a um compartilhamento de rede de arquivos não são aceitas no momento. - Caso tenha se conectado a um banco de dados, selecione um banco de dados ou um esquema e, em seguida, clique duas vezes ou arraste uma tabela até o painel Fluxo. ![A lista suspensa Banco de dados em um fluxo mostra uma lista de bancos de dados para seleção.](/tableau/current/pt-br/prep/pt-br/Img/prep_connect3.png) **Observação**: em Tableau Prep Builder, você pode unir linhas de vários arquivos ou tabelas de banco de dados a partir de uma única fonte de dados na etapa de entrada usando uma pesquisa curinga. Na criação na Web, você não pode criar ou editar uniões de entrada, mas isso pode ser feito em fluxos publicados do Tableau Prep Builder. Para obter mais informações, consulte [Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#Union). ## Abrir um fluxo existente No Tableau Prep Builder, é possível ver e acessar os fluxos mais recentes da página inicial. Dessa forma, é simples encontrar trabalhos em andamento. Ao trabalhar com fluxos na Web, todos os seus fluxos são convenientemente listados na página Explorar sob o menu Todos os fluxos. Abra um fluxo ### Abrir um fluxo no Tableau Prep Builder Na página Iniciar, realize uma das seguintes ações: - Em Fluxos recentes, selecione um fluxo. - Clique em Abrir um fluxo para navegar até o arquivo do fluxo e abri-lo. Depois de se conectar aos dados, use as diversas opções na etapa de entrada para identificar os dados com os quais deseja trabalhar. Em seguida, é possível adicionar uma etapa de limpeza ou outro tipo de etapa para examinar, limpar e moldar os dados. Quando seus fluxos incluem vários conectores de origem de dados, o Tableau Prep ajuda você a ver facilmente quais conectores e tabelas estão associados às etapas de Entrada. Ao clicar na etapa de Entrada, o conector associado e a tabela de dados são destacados no painel Conexões. Essa opção foi adicionada na versão 2020.1.1 do Tableau Prep Builder e também é compatível ao editar fluxos na Web. ![Um fluxo do Tableau Prep com uma conexão de banco de dados à esquerda e as etapas de transformação de dados à direita.](/tableau/current/pt-br/prep/pt-br/Img/prep_highlight_connection.png) ### Abrir um fluxo no Tableau Prep na Web 1. Para abrir e editar um fluxo existente, na página Explorar, selecione Todos os fluxos no menu suspenso superior e selecione seu fluxo na lista. ![Um menu suspenso com a opção de exibir todos os fluxos.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_open_flow.png) 2. Na página Visão geral do fluxo, clique em Editar para editar o fluxo. ![A página Visão geral do fluxo na Web mostra o botão Editar fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_edit_flow.png) O fluxo será aberto em uma nova guia. Assim que você começar a fazer alterações, o Tableau salvará automaticamente suas alterações a cada poucos segundos e salvará seu fluxo modificado como um rascunho. Os rascunhos só são visíveis para você e seu administrador. Quando terminar, você pode fechar o fluxo e continuar fazendo alterações mais tarde ou publicar o fluxo para aplicar suas alterações, criando uma nova versão do fluxo. Como outras ferramentas, a publicação de fluxo usa um método de ordem de chegada. Se outro usuário modificar e republicar o fluxo antes de você, suas alterações são confirmadas primeiro. Mas você pode rastrear e reverter para uma versão anterior usando a página Histórico de revisão. Para obter mais informações, consulte [Trabalhar com revisões de conteúdo](https://help.tableau.com/current/pro/desktop/pt-br/qs_revision_history.htm) na Ajuda do Tableau Desktop. [Pular para o conteúdo principal](#main-content) # Configurar o conjunto de dados **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, a menos que indicado. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Para determinar com quanto de seu conjunto de dados trabalhar no fluxo, você pode configurar seu conjunto de dados. Quando você se conecta aos seus dados ou arrasta tabelas para o painel Fluxo, uma etapa de entrada é adicionada automaticamente ao fluxo. A etapa de entrada é onde você pode decidir quais e quantos dados incluir em seu fluxo. Ela sempre será a primeira etapa no fluxo. Você também pode atualizar os dados na etapa de entrada. Para obter mais informações, consulte [Adicionar mais dados na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm). Na etapa de entrada, você pode: - Clicar com o botão direito do mouse ou clique pressionando a tecla Cmd (MacOS) na etapa de entrada no painel de fluxo para renomeá-la ou removê-la. - Una as linhas de vários arquivos no mesmo diretório principal ou secundário. Para obter mais informações, consulte [Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#Union). - (versão 2023.1 e posterior) Inclua números de linha gerados automaticamente com base na ordem de classificação original de seu conjunto de dados. Consulte [Incluir números de linha do seu conjunto de dados](#autogenerated_row_numbers). - Pesquisar campos. - Veja uma prévia de valores de campo. - Defina as propriedades do campo alterando o nome do campo ou as configurações de texto para arquivos de texto. **Observação**: valores de campo que incluam colchetes serão convertidos automaticamente em parenteses. - Configure a amostra de dados ingerida em seu fluxo. Consulte [Definir o tamanho da amostra de dados](#sample) - Remova os campos de que você não precisa. Você sempre pode voltar para a etapa de entrada e incluí-los mais tarde. - Oculte os campos que você não precisa limpar, mas ainda deseja incluir na saída de fluxo. Você poderá mostrá-los a qualquer momento, se precisar deles. - Aplique filtros a campos selecionados. - Altere o tipo de dados do campo para conexões de dados que o suportem. - (versão 2023.3 e posterior) Você pode definir o cabeçalho e a linha inicial para arquivos CSV. - (versão 2024.1 e posterior) Você pode definir o cabeçalho e a linha inicial para arquivos Excel. ## Incluir números de linha do seu conjunto de dados _Compatível com o Tableau Prep Builder versão 2023.1 e posterior e na Web para Microsoft Excel e arquivos de texto (.csv)._ **Observação**: essa opção não estiver aceita atualmente para arquivos incluídos em uma união de linhas de entrada. A partir da versão 2023.1, o Tableau Prep gera automaticamente números de linha com base na ordem de classificação original de seus dados que você pode incluir como um novo campo em seu fluxo. Está disponível apenas para tipos de arquivo Microsoft Excel ou Texto (.csv). Em liberações anteriores, se você quisesse incluir esses números de linha, precisava adicioná-los manualmente à origem antes de adicionar o conjunto de dados ao seu fluxo. Esse campo é gerado na etapa de entrada quando você se conecta aos seus dados. Por padrão, ele é excluído do fluxo, mas você pode incluí-lo com um clique. Se você optar por incluí-lo, ele se comportará como qualquer outro campo e poderá ser usado em suas operações de fluxo e campos calculados. O Tableau Prep também oferece suporte à função ROW\_NUMBER para campos calculados. Essa função é útil quando há campos em seu conjunto de dados que podem definir a classificação, como ID da linha ou carimbo de data/hora. Para obter mais informações sobre como usar essa função, consulte [Criar nível de detalhe, classificação e cálculos de bloco](https://help.tableau.com/current/prep/pt-br/prep_calculations.htm). ### Adicionar o campo Número de linha de origem ao seu fluxo 1. Clique com o botão direito do mouse ou com a tecla Cmd pressionada (MacOS) no campo ou clique no menu Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Incluir campo. Visualização de dados: ![](/tableau/current/pt-br/prep/pt-br/Img/prep_dp_Include_srn.png) Lista de campos: ![](/tableau/current/pt-br/prep/pt-br/Img/prep_fl_Include_srn.png) A lista de alterações é limpa, o campo agora faz parte dos dados de fluxo e você pode ver os números de linha gerados nas etapas de fluxo subsequentes. #### Detalhes do número da linha da fonte Quando você inclui o Número da linha da fonte em seu conjunto de dados, as opções a seguir e considerações se aplicam. - Os números de linha da fonte de dados são aplicados antes de qualquer amostragem ou filtro de dados. - Isso cria um novo campo chamado Número da linha da fonte que persiste ao longo do fluxo. Esse nome de campo não está localizado, mas pode ser renomeado a qualquer momento. - Se já existir um campo com esse nome, o novo nome de campo será incrementado em 1. Por exemplo, Número da linha da fonte 1, Número da linha da fonte 2, e assim por diante. - Você pode alterar o tipo de dados do campo nas etapas subsequentes. - Você pode usar esse campo em operações e cálculos de fluxo. - Esse valor é regenerado para todo o conjunto de dados sempre que os dados de entrada são atualizados ou o fluxo é executado. - Esse campo não está disponível para uniões de entrada. ## Definir cabeçalho e linha inicial de dados _Compatível com o Tableau Prep Builder versão 2023.3 e posterior, na Web para arquivos de texto (.csv) e na versão 2024.1 e posterior para arquivos Excel (.xls)._ É possível definir uma linha específica como linha de cabeçalho de campo e a linha na qual os dados começam para arquivos de Excel e texto (.csv). Ao conectar-se a arquivos do Excel ou de texto, um cenário comum é que os arquivos sejam formatados com metainformações nas primeiras linhas para torná-los legíveis por humanos. Por padrão, o Tableau Prep interpreta as primeiras linhas de arquivos CSV como a linha do cabeçalho do campo. Os arquivos do Excel são interpretados com base em tipos de campos e linhas vazias. O Tableau Prep pode selecionar uma linha como cabeçalho ou não incluir uma linha de cabeçalho. Por exemplo, nos arquivos seguintes, `STORE DETAILS` é interpretado como a linha do cabeçalho. Você pode excluir as informações de metadados (1) e fornecer a estrutura para esquema correta de seus dados definindo a linha 3 como o cabeçalho (2) e a linha 4 como a linha para o início dos dados. Arquivos CSV: ![Metadados do cabeçalho, incluindo detalhes da loja, como código, descrição e valores de unidade.](/tableau/current/pt-br/prep/pt-br/Img/prep_setHeader_metadata.png) Arquivos do Excel: ![](/tableau/current/pt-br/prep/pt-br/Img/prep_setHeader_metadataExcel.png) Por exemplo, o seguinte mostra as configurações padrão para o cabeçalho da linha e a linha inicial: ![](/tableau/current/pt-br/prep/pt-br/Img/prep_SetHeaderBefore.png) A seguir, são mostrados os dados com os metadados excluídos: ![](/tableau/current/pt-br/prep/pt-br/Img/prep_SetHeaderAfter.png) **Observação**: a visualização de dados não reflete alterações nas configurações de amostra de dados. ### Configure o cabeçalho e a linha inicial Usando a visualização de entrada de visualização de dados, você pode inspecionar a estrutura do esquema de seus dados e definir cabeçalho e linhas iniciais para excluir metadados dos dados de origem de entrada. Você pode definir a linha inicial dos dados para qualquer valor superior ao valor da linha do cabeçalho. Por padrão, o Tableau Prep define a linha inicial dos dados para o próximo número consecutivo após a linha do cabeçalho. Quaisquer linhas entre a linha do cabeçalho e a linha inicial dos dados serão ignoradas. **Observação**: a visualização de dados e o interpretador de dados são mutuamente exclusivos. O Interpretador de dados detecta apenas subtabelas em planilhas do Excel e não oferece suporte à especificação da linha inicial de arquivos de texto e planilhas. 1. Selecione a etapa de entrada. 2. Na barra de ferramentas, clique na visualização de entrada da Visualização de dados. 3. Na linha que você deseja definir como cabeçalho, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Definir como cabeçalho. 4. Na linha que você deseja definir como linha inicial de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Definir como início dos dados. Por padrão, a linha inicial dos dados é definida para o próximo número de linha consecutivo.  ![](/tableau/current/pt-br/prep/pt-br/Img/prep_SetHeaderDP.png) O menu Opções de cabeçalho exibe a linha do cabeçalho e o número da linha inicial dos dados. Como opção, você pode definir o cabeçalho e a linha inicial diretamente na caixa de diálogo Opções de cabeçalho. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_SetHeaderOldWay.png) ### Vários esquemas em um único arquivo Se um único arquivo incluir diversas fontes de dados, você poderá criar uma etapa de entrada adicional conectando-se à mesma fonte de dados e, em seguida, definir o cabeçalho e as linhas iniciais de dados para a segunda fonte de dados. Por exemplo, o arquivo a seguir contém uma fonte de dados começando na linha número 3 (1) com um segundo esquema diferente e separado começando na linha número 28 (2). ![ Uma fonte de dados começando na linha número 3 (1) com um segundo esquema diferente e separado começando na linha número 28 (2).](/tableau/current/pt-br/prep/pt-br/Img/prep_setHeader_mutliSource.png) ![Vários esquemas em um único arquivo.](/tableau/current/pt-br/prep/pt-br/Img/prep_setHeader_multiFlow.png) Para esse tipo de fonte de dados, siga estas etapas. 1. Selecione a primeira etapa de entrada. 2. Na barra de ferramentas, clique na visualização de entrada da Visualização de dados. 3. Na linha que você deseja definir como cabeçalho, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Definir como cabeçalho. 4. Na linha que você deseja definir como linha inicial de dados, clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Definir como início dos dados. Por padrão, a linha inicial dos dados é definida para o próximo número de linha consecutivo. 5. Selecione a próxima etapa de entrada. 6. Repita as etapas acima para definir o cabeçalho e a linha inicial para fontes de dados adicionais. ![Vários esquemas em um único arquivo.](/tableau/current/pt-br/prep/pt-br/Img/prep_setHeader_multiFlow.png) Quaisquer linhas entre a linha do cabeçalho e a linha inicial dos dados serão ignoradas. ### União de linhas de várias tabelas _Compatível com o Tableau Prep Builder versão 2024.1 e posterior e na Web para arquivos de texto (.csv)._ Você pode unir linhas de várias tabelas de fontes de dados que tenham a mesma estrutura de esquema e linha de metadados. 1. Conecte-se aos arquivos e selecione a primeira etapa de entrada. 2. Na barra de ferramentas, clique na visualização de entrada da Visualização de dados. 3. Na linha que você deseja definir como cabeçalho, clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Definir como cabeçalho. 4. Na linha que você deseja definir como linha inicial de dados, clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Definir como início dos dados. 5. Clique na guia Tabelas e selecione União de linhas de várias tabelas. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_setHeader_DPunion.png) 7. Clique em Aplicar para unir os arquivos e manter a seleção de cabeçalho e linha para todos os arquivos na união de entrada. Isso pressupõe que a estrutura e o esquema nos arquivos unidos de entrada sejam os mesmos. ## Conectar a uma consulta SQL personalizada Se seu banco de dados for compatível com o uso do SQL personalizado, você verá SQL personalizado exibido próximo à parte inferior do painel Conexões. Clique duas vezes em SQL personalizado para abrir a guia SQL personalizado, onde poderá inserir consultas para pré-selecionar dados e usar operações específicas da fonte. Depois que a consulta recuperar o conjunto de dados, é possível selecionar os campos a serem incluídos, aplicar filtros ou alterar o tipo de dados antes de adicionar os dados ao fluxo. ![A guia SQL personalizado em uma etapa de entrada de fluxo do Tableau Prep, em que você pode inserir uma consulta SQL para se conectar aos dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_customSQL.png) Para obter mais informações sobre o uso de SQL personalizado, consulte [Usar SQL personalizado para conectar-se aos dados.](https://help.tableau.com/current/prep/pt-br/prep_connect.htm#custom__sql). ## Aplicar operações de limpeza na etapa de entrada Apenas algumas operações de limpeza estão disponíveis em uma etapa de entrada. Qualquer uma das alterações a seguir é permitida na lista Campo de entrada. Suas alterações são monitoradas no painel Alterações e as anotações são adicionadas à etapa de entrada no painel Fluxo e na lista Campo de entrada. - **Ocultar campo**: oculte campos em vez de removê-los para reduzir a confusão em seu fluxo. Você sempre poderá mostrá-los se precisar deles. Os campos ocultos ainda serão incluídos na saída quando você executar seu fluxo. - **Filtro**: use o editor de cálculo para filtrar valores ou, a partir da versão 2023.1, você pode usar a caixa de diálogo Filtro de data relativa para especificar rapidamente intervalos de datas para qualquer data ou campos de data e hora. - **Renomear campo:** no campo Nome de campo, clique duas vezes ou pressione Ctrl e clique (MacOS) no nome do campo e insira um novo nome. - **Alterar tipo de dados**: clique no tipo de dados do campo e selecione um novo tipo de dados no menu. Essa opção é suportada atualmente para Microsoft Excel, arquivos de texto e PDF, Box, Dropbox, Google Drive e fontes de dados OneDrive. Todas as outras fontes de dados podem ser alteradas em uma etapa limpa. ### Selecionar campos a serem incluídos no fluxo **Observação**: a partir da versão 2023.1, você pode selecionar vários campos para ocultá-los, mostrá-los, removê-los ou incluí-los. Em versões anteriores, você pode trabalhar com um campo por vez e marcar ou desmarcar as caixas de seleção para incluir ou remover campos. O painel Entrada mostra uma lista de campos em seu conjunto de dados. Por padrão, todos os campos são incluídos, exceto o campo gerado automaticamente, Número da linha da fonte. Use a visualização de dados ou a visualização de lista para gerenciar seus campos. - **Pesquisar**: encontrar campos. - Ocultar campos: oculte os campos que você deseja incluir na saída do fluxo, mas que não precisam ser limpos. - Na lista de campos, clique no ícone de olho ![Um ícone de olho riscado com uma linha diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_icon.png) ou selecione Ocultar campos no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png). - Na visualização de dados, selecione Ocultar campos no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png). Os campos são processados pelo fluxo durante o tempo de execução. Além disso, você poderá Mostrar os campos sempre que precisar deles Para obter mais informações, consulte [Ocultar campos](https://help.tableau.com/current/prep/pt-br/prep_filter.htm#hide_fields). - Incluir campos: adicione campos ao seu fluxo que foram marcados como removidos. - Na Lista de campos, selecione uma ou mais linhas e clique com o botão direito do mouse, clique em Cmd (MacOS) ou clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Incluir campos para adicionar de volta os campos marcados como removidos. - Na visualização de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) no campo que você deseja incluir no seu fluxo e selecione Incluir campo. - Remover campos: - selecione uma ou mais linhas e clique com o botão direito do mouse, clique em Cmd (MacOS), clique no "X" ou clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Remover campos para remover os campos que você não deseja incluir no fluxo. - Na Visualização de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) no campo que você deseja remover e selecione Remover campo. ### Aplicar filtros a campos na etapa de entrada Aplique filtros na etapa de entrada para reduzir a quantidade de dados que você ingere de suas fontes de dados. Você pode obter eficiência de desempenho interativo e uma amostra de dados mais útil eliminando os dados que não deseja processar ao executar o fluxo. Na etapa de entrada, você pode aplicar filtros usando o Editor de cálculo. A partir da versão 2023.1, você também pode usar a caixa de diálogo Filtro de data relativa para especificar um intervalo de datas exato de valores a serem incluídos nos tipos de campo de data e data e hora. Para obter mais informações, consulte "Filtro de data relativa" em [Filtrar dados](https://help.tableau.com/current/prep/pt-br/prep_filter.htm). Você pode usar outras opções de filtro na etapa Limpar ou outros tipos de etapa. Para obter mais informações, consulte [Filtrar dados](https://help.tableau.com/current/prep/pt-br/prep_filter.htm). #### Aplicar um filtro de cálculo 1. Na barra de ferramentas, clique em Filtrar valores. Use um dos seguintes métodos para filtrar seus dados: - Na lista de campos, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) no nome do campo e selecione Filtro > Cálculo .... ![](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_calc_view.png) - Na visualização de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) no nome do campo e selecione Filtro > Cálculo .... ![](/tableau/current/pt-br/prep/pt-br/Img/prep_dp_filter_calc.png) 2. Insira o critério de filtragem no editor de cálculo. ![Uma janela de filtro que permite que você insira um cálculo e escolha um valor de referência.](/tableau/current/pt-br/prep/pt-br/Img/prep_inputfilter2.png) #### Aplicar um filtro de data relativa 1. Selecione um campo com um tipo de dados Data ou Data e Hora e use um dos métodos a seguir para aplicar um filtro de data relativa. - Na lista de campos, clique com o botão direito, clique com a tecla Cmd pressionada (MacOS) ou clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) na coluna Nome do campo e selecione Filtro \> Datas relativas. - Na visualização de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) do campo e selecione Filtro > Datas relativas. ![](/tableau/current/pt-br/prep/pt-br/Img/Prep_dp_relative_date.png) 2. Use a caixa de diálogo Filtro de datas relativas para especificar o intervalo exato de anos, trimestres, meses, semanas ou dias que você deseja ver nos dados. Além disso, é possível configurar uma referência relativa a uma data específica e incluir valores nulos. **Observação**: por padrão, o filtro opera em relação à data em que o fluxo é executado ou visualizado na experiência de criação. ![Um filtro de data relativa com opções para anos, trimestres, meses, semanas e dias.](/tableau/current/pt-br/prep/pt-br/Img/prep_inputfilter_relativedates2.png) ### Alterar nomes de campo Use um dos métodos a seguir para alterar o nome de um campo. Uma anotação é adicionada na grade do campo e no painel Fluxo à esquerda da etapa de entrada. As alterações também serão rastreadas no painel Alterações. - Na Lista de Campos, selecione um campo na coluna Nome do Campo e clique em Renomear campo. Digite um novo nome no campo. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_list_view_rename.png) - Na visualização de dados, selecione um campo e clique em Renomear campo. Digite um novo nome no campo. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_dp_rename_field.png) ### Alterar tipos de dados _Atualmente compatível com arquivos do Microsoft Excel, de texto e PDF, Box, Dropbox, Google Drive e fontes de dados OneDrive. Todas as outras fontes de dados podem ser alteradas em uma etapa limpa._ **Observação**: o tipo de dados para Número de linha da fonte (versão 2023.1 e posterior) só pode ser alterado em uma etapa de Limpeza ou outro tipo de etapa. Para alterar o tipo de dados de um campo, realize as ações a seguir: 1. Clique no tipo de dados do campo. 2. Selecione o novo tipo de dados no menu. - Visualização de dados: ![](/tableau/current/pt-br/prep/pt-br/Img/prep_dp_chg_data_type.png) - Visualização de campo: ![Um tipo de dados em um campo no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_inputdatatype2.png) Você também pode alterar o tipo de dados para campos em outros tipos de etapa no fluxo ou atribuir funções de dados para ajudar a validar os valores de campo. Para obter mais informações sobre como alterar o tipo de dados ou usar funções de dados, consulte [Consultar os tipos de dados atribuídos aos seus dados](https://help.tableau.com/current/prep/pt-br/prep_explore.htm#reviewdatatypes) e [Usar funções de dados para validar seus dados](https://help.tableau.com/current/prep/pt-br/prep_validate_data.htm). ## Configurar propriedades de campo Ao trabalhar com arquivos de texto, você verá uma guia **Configurações** onde é possível editar a conexão e configurar as propriedades de texto, como o separador de campo para arquivos de texto. Também é possível editar a conexão do arquivo no painel Conexões ou configurar atualizações incrementais. Para obter mais informações sobre como configurar atualização incremental para o fluxo, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm). Ao trabalhar com arquivos de texto e Excel, é possível corrigir os tipos de dados que foram inferidos incorretamente antes mesmo de iniciar o fluxo. Os tipos de dados sempre poderão ser alterados nas etapas subsequentes do painel Perfil após iniciar o fluxo. ### Configurar definições de texto em arquivos de texto Para alterar as configurações usadas na analise de arquivos de texto, selecione das opções a seguir: - A primeira linha contém o cabeçalho (padrão): selecione essa opção para usar a primeira linha como os rótulos de campo. - Gerar nomes de campo automaticamente: selecione essa opção se desejar que o Tableau Prep Builder gere os cabeçalhos de campo automaticamente. A convenção de nomenclatura do campo segue o mesmo modelo do Tableau Desktop. Por exemplo **F1**, **F2** e assim por diante. - Separador de campo: selecione um caractere da lista para usar na separação de colunas. Selecione Outro para inserir um caractere personalizado. - Qualificador de texto: selecione o caractere que contenha os valores no arquivo. - Conjunto de caracteres: selecione um conjunto de caracteres que descreva a codificação do arquivo de texto. - Localidade: selecione a localidade a ser usada para pesquisar por arquivos. Essa configuração indica qual separador de decimal e milhar usar. ## Definir o tamanho da amostra de dados _A seleção de linha estratificada é compatível com o Tableau Prep Builder versão 2023.3 e posterior._ Por padrão, o Tableau Prep determina o número máximo de linhas necessárias para explorar e preparar dados de maneira eficaz para uma amostra representativa dos seus dados. Com base no algoritmo de amostra do Tableau Prep, quanto mais campos houver nos dados de entrada, menor será o número de linhas permitidas. Quando os dados são amostrados, a amostra resultante pode incluir todas as linhas necessárias — ou não, dependendo de como a amostra foi calculada e retornada. Por exemplo, por padrão, o Tableau Prep usa o método de seleção rápida para amostrar dados. Usando esse método, as linhas superiores são carregadas e, se o seu conjunto de dados for grande e os dados estiverem estruturados cronologicamente, você poderá ver a amostra dos dados mais antigos, mas não uma representação completa de todos os dados. Caso não veja os dados esperados, é possível alterar as configurações da amostra de dados para executar a consulta novamente. Ao criar ou editar fluxos usando Criação na Web, o número máximo de linhas que um usuário pode selecionar ao usar grandes conjuntos de dados é configurado pelo administrador do Tableau Server. No Tableau Cloud, esse limite é fixo e não pode ser alterado pelo administrador. Para obter mais informações, consulte Amostragem de dados e processamento de limites, na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm#sample-data-and-processing-limits) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm#sample-data-and-processing-limits). ### Preparando seus dados para amostragem Se você sabe que determinados valores não são obrigatórios para sua análise, remova os campos na etapa Entrada para que os dados não sejam incluídos quando você criar ou executar seu fluxo. Se você tiver um grande conjunto de dados que aciona a amostragem, a remoção de campos na etapa Entrada aumentará o número de linhas que o Tableau Prep carrega. Quando a amostragem não é aplicada, a remoção de campos na etapa Entrada reduz o volume de dados carregado pelo Tableau Prep. Depois de remover campos e valores desnecessários do conjunto de dados, você poderá alterar a quantidade de dados carregados para amostragem ou o método de amostragem. ### Alteração das configurações de amostra de dados Os dados de exemplo ajudam na experiência interativa e tornam a edição do fluxo mais eficiente em comparação com a criação de perfil de todos os dados e a aplicação de alterações em conjuntos de dados maiores enquanto você trabalha. Todos os dados são usados quando você executa o fluxo. Quaisquer alterações feitas na seção de amostra se aplicam ao fluxo atual. Para validar seus dados após a limpeza e modelagem, execute o fluxo e visualize a saída no Tableau Desktop. **Observação**: execute o fluxo completo em vez de “visualizar amostra no Tableau Desktop” para poder ver todos os seus dados. Se você encontrar valores inesperados ou incorretos que não estavam na amostra, poderá voltar ao Tableau Prep para resolver o problema. 1. Remova campos e valores desnecessários do conjunto de dados. 2. Selecione uma etapa de entrada e clique na guia Amostra de dados. ![Um formulário para configurar dados de entrada e especificar o número de linhas a serem amostradas.](/tableau/current/pt-br/prep/pt-br/Img/prep_sampleMenu.png) 3. Selecione o número de linhas que deseja carregar para amostragem de dados. O número de linhas que você escolhe afeta o desempenho. - Automático: (padrão) carrega dados rapidamente e calcula automaticamente o número de linhas para que haja dados suficientes para uma amostra. O número de linhas carregadas é igual ou inferior a 393.216. - Especificar: normalmente usado para carregar um pequeno número de linhas para que você possa entender a estrutura dos dados e ter tempos de carregamento rápidos. Especifique um número de linhas inferior a 1 milhão. **Observação**: na criação na Web: o número máximo de linhas que um usuário pode selecionar ao usar grandes conjuntos de dados é configurado pelo administrador do Tableau Server. No Tableau Cloud, esse limite é fixo e não pode ser alterado pelo administrador. Como usuário, você pode selecionar o número de linhas até esse limite. - Máximo: carrega o máximo de dados possível para seleção de linha igual ou menor que 1.048.576. Certifique-se de que você tem os [Requisitos de alto desempenho](https://www.tableau.com/pt-br/products/techspecs) para grandes conjuntos de dados. 5. Selecione o método a ser usado para o número de linhas retornadas para amostragem. O desempenho pode ser afetado quando Aleatório ou Estratificado são escolhidos. **Observação**: a seleção de linha só será suportada se sua fonte de dados de entrada aceitar amostragem aleatória. Se a fonte de dados não aceitar amostragem aleatória, o método padrão de Seleção Rápida será usado. - Seleção rápida: (padrão) amostra dados com base no desempenho, pois as linhas são retornadas o mais rápido possível. Algumas linhas podem não ser incluídas na amostra. As linhas usadas para amostragem podem ser o primeiro número N de linhas ou as linhas que o banco de dados armazenou em cache na memória de uma consulta anterior. Embora este seja quase sempre um resultado mais rápido do que a amostragem aleatória, pode devolver uma amostra tendenciosa (como dados de apenas um ano em vez de todos os anos presentes nos dados, se os registos forem ordenados cronologicamente). - Aleatório: permite amostrar um grande conjunto de dados e retornar uma representação geral de toda a seleção de linhas. O Tableau Prep retorna linhas aleatórias com base em todas as linhas selecionadas carregadas. Essa opção pode afetar o desempenho quando os dados são recuperados em um primeiro momento. - Estratificado: permite agrupar por um campo especificado e, em seguida, amostrar os dados dentro de cada subgrupo. O Prep retorna o número solicitado de linhas distribuídas no campo selecionado para agrupamento da forma mais igualitária possível. Em alguns casos, com base na fonte de dados, isso pode fazer com que alguns valores do campo tenham mais linhas do que outros. #### Exemplos Esses exemplos são baseados no conjunto de dados de indicadores mundiais globais incluído no Tableau Prep. A primeira amostra usa Automático para o número de linhas e Aleatório para o método de amostra ou o número de linhas a serem retornadas para amostragem. ![Campos para especificar o Número de linha e a Seleção de linhas, com Seleção aleatória de linhas marcada.](/tableau/current/pt-br/prep/pt-br/Img/prep_sample_autoRandom.png) Com esses valores selecionados, 3 K linhas são selecionadas aleatoriamente e usadas para representar todo o conjunto de dados. ![As linhas são selecionadas aleatoriamente e usadas para representar todo o conjunto de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_sample_paneAutoRandom.png) A segunda amostra usa Especificar para o número de linhas e Estratificado para o método de amostra. O número especificado de linhas é definido como um valor de 7 e o campo _Taxa de natalidade_ usado para agrupamento. ![Campos para especificar o Número de linha e a Seleção de linhas, com Seleção estratificada de linhas marcada.](/tableau/current/pt-br/prep/pt-br/Img/prep_sample_stratfied.png) Os novos valores de amostra mostram uma distribuição unificada de 7 linhas de valores exclusivos em todos os campos. ![O número especificado de linhas é definido como um valor de 7 e o campo Taxa de natalidade usado para agrupamento.](/tableau/current/pt-br/prep/pt-br/Img/prep_sample_stratified_example.png) [Pular para o conteúdo principal](#main-content) # Copiar etapas, ações e campos **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Ao limpar seus dados, geralmente você executa as mesmas operações ou ações de limpeza diversas vezes em seu fluxo. Para tornar a limpeza e a formatação de dados mais eficientes, é possível copiar e colar operações ou ações em todo o fluxo, ou mesmo copiar etapas ou grupos selecionados e salvá-los, para que você possa executar operações ou ações de limpeza uma vez e, posteriormente, reutilizá-las onde precisar. Você pode até mesmo duplicar campos para experimentar com diferentes operações de limpeza. Para obter mais informações sobre a criação de grupos no fluxo, consulte [Agrupar etapas](https://help.tableau.com/current/prep/pt-br/prep_build_flow.htm#group_steps). ## Copiar e colar etapas Copie uma ou mais etapas para usá-las em outra área do mesmo fluxo. Essa opção não está disponível para etapas de Entrada que incluem uma união de linhas na etapa de entrada. 1. No painel Fluxo, selecione uma ou mais etapas ou grupos no fluxo. 2. Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) na etapa selecionada e escolha Copiar. ![Menu de clique direito para uma etapa em um painel de fluxo do Tableau Prep com a opção Copiar destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_copy1.png) 3. Para colar as etapas de copiadas, siga um destes procedimentos: - Passe o cursor sobre uma etapa ou linha de fluxo até que o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) apareça, em seguida clique nele e selecione Colar no menu suspenso. - Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) em qualquer espaço em branco na tela e clique em Colar. ![A opção Colar ao criar um fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_paste1.png) 4. Se as etapas foram coladas no espaço em branco do fluxo, arraste e solte as etapas onde desejar que fiquem no fluxo para organizá-las. Se estiver adicionando etapas no final de uma etapa do fluxo, elas serão adicionadas automaticamente ao final da etapa. Se estiver inserindo etapas entre as etapas de fluxo existentes, mova-as para o local que deseja no fluxo e corrija os erros. Você pode remover as linhas de fluxo ou mover as etapas se necessário. Por exemplo, para conectar uma etapa às etapas copiadas, remova a linha de fluxo existente, se houver, arraste a etapa existente para a nova etapa e solte em Adicionar. ![Linhas de fluxo sendo removidas.](/tableau/current/pt-br/prep/pt-br/Img/prep_paste_fix.png) Para obter mais informações sobre como organizar o fluxo, consulte [Reorganizar o layout do fluxo](https://help.tableau.com/current/prep/pt-br/prep_build_flow.htm#move_steps). ## Copiar e colar operações de limpeza Você pode copiar e colar operações de limpeza no mesmo fluxo para reutilizar suas ações usando uma das seguintes opções: - Copie uma operação do painel Alterações em uma etapa e cole-a no painel Alterações da mesma etapa ou de outra para aplicar a mesma operação nela. - Arraste e solte uma operação do painel Alterações e solte em outros campos no painel Perfil dessa etapa para aplicar essa operação a vários campos. Essa opção não está disponível para operações que afetam vários campos, como campos calculados. Para copiar e colar uma alteração em uma mesma etapa ou em outra, faça o seguinte: 1. No painel Alterações, selecione a alteração que deseja copiar. 2. Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) no item de alteração, em seguida, selecione Copiar no menu. ![O menu do botão direito no painel Alterações com a opção Copiar destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_copy_changes1.png) 3. No painel Alterações, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) onde deseja colar a alteração e selecione Colar. Selecione a alteração e clique em Editar para fazer ajustes conforme necessário. ![O painel Alterações mostrando a opção Colar.](/tableau/current/pt-br/prep/pt-br/Img/prep_paste_change1.png) Para arrastar e soltar uma alteração em outros campos da etapa, faça o seguinte: 1. No painel Alterações, selecione a alteração que deseja copiar. 2. Arraste a alteração no campo em que deseja aplicá-la e solte-a. Repita essa ação conforme necessário. ![Uma tela mostrando que um gráfico de barras pode ser arrastado e solto.](/tableau/current/pt-br/prep/pt-br/Img/prep_paste_change_drag.png) ## Copiar campos A partir do Tableau Prep Builder versão 2019.2.3, posteriores e na Web, se quiser experimentar as operações de limpeza em um campo, mas não quiser alterar os dados originais, poderá copiar os campos. 1. No painel Perfil, grade de dados, painel Resultados ou na exibição de lista, selecione o campo que deseja copiar. 2. No menu Mais opções, selecione Campo duplicado. ![A opção de menu Campo duplicado no menu Mais opções em um cartão de perfil no fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_duplicate_field.png) Um novo campo é criado com o mesmo nome e um modificador. Por exemplo, "Data de envio -1". ![Os resultados da opção Campo duplicado mostram o novo campo "Data de Envio -1" criado.](/tableau/current/pt-br/prep/pt-br/Img/prep_duplicate_field2.png) ## Criar etapas de fluxos reutilizáveis _Compatível com o Tableau Prep Builder versão 2019.3.2 e posterior._ **Observação**: as etapas de fluxo reutilizáveis não podem ser criadas na Web, mas você pode usá-las em seus fluxos na Web. As etapas reutilizáveis que incluem etapas de entrada baseadas em arquivos ainda não são suportadas na Web. Se você costuma executar repetidamente as mesmas ações com seus dados e quiser aplicar essas mesmas etapas a outros fluxos, na versão 2019.3.2 e posteriores do Tableau Prep Builder, pode selecionar uma ou mais etapas de fluxo ou grupos e suas ações correspondentes ou todo o fluxo e salvar localmente em um arquivo no seu computador. Você também pode publicar no Tableau Server ou no Tableau Cloud para compartilhar com outras pessoas. Quando as etapas de fluxo são publicadas em seu servidor, uma marca de Etapas salvas é adicionada automaticamente para que você possa pesquisar e encontrá-las facilmente ao adicioná-las aos seus fluxos. A partir da versão 2022.1.1, você pode criar etapas reutilizáveis que incluem parâmetros. Quando as etapas são salvas, o parâmetro é convertido em um valor estático usando o valor atual do parâmetro. Para obter mais informações sobre como usar parâmetros nos fluxos, consulte [Criar e usar parâmetros em fluxos](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm). ### Criar etapas reutilizáveis 1. Selecione uma ou mais etapas. 2. Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS), em uma etapa selecionada e marque Salvar etapas como fluxo. ![Um diagrama de fluxo que mostra a capacidade de salvar etapas como um fluxo ou publicar em um servidor.](/tableau/current/pt-br/prep/pt-br/Img/prep_saved_steps_menu.png) 3. Selecione Salvar no arquivo para salvar o fluxo localmente ou Publicar no servidor para publicar o fluxo no Tableau Server ou Tableau Cloud. 4. Se você publicar o fluxo no Tableau Server ou Tableau Cloud, entre no servidor, se necessário, preencha os campos na caixa de diálogo Publicar fluxo e clique em Publicar. ![A caixa de diálogo Publicar fluxo de trabalho no Tableau Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_saved_steps_publish.png) ### Inserir etapas reutilizáveis em um fluxo 1. Abra um fluxo. 2. No painel Fluxo, siga um destes procedimentos: - Passe o mouse sobre uma etapa ou linha de fluxo até que o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) seja exibido; em seguida, clique no ícone e selecione Inserir fluxo. - Na área branca da tela, clique com o botão direito do mouse ou Ctrl+clique (MacOS) e clique em Inserir fluxo ou Editar > Inserir fluxo no menu superior.
Menu de etapas do fluxoMenu da tela
O menu Mais na tela Fluxo.

Um fluxo para processamento de pedidos mostrando o menu Inserir fluxo.

3. Na caixa de diálogo Adicionar fluxo, selecione nos fluxos salvos no arquivo local ou no servidor e clique em Adicionar. A lista de fluxos é filtrada automaticamente para mostrar os fluxos marcados com Etapas salvas. Para inserir outros fluxos, altere o Tipo de fluxo para Todos os fluxos. Na versão 2019.4.2 e posteriores do Tableau Prep Builder e na Web, você pode clicar em Exibir fluxo para abrir e exibir o fluxo publicado no servidor em que está conectado. ![Caixa de diálogo Adicionar fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_saved_steps_insert.png) 4. O fluxo é adicionado ao painel Fluxo. Se estiver adicionando um fluxo ao final de uma etapa do fluxo, as etapas do fluxo serão adicionadas automaticamente ao final da etapa. Se estiver inserindo etapas de fluxo entre as existentes, mova as etapas para o local que deseja no fluxo e corrija os erros. ![Um fluxo que contém alguns sinalizadores de erro.](/tableau/current/pt-br/prep/pt-br/Img/prep_saved_steps_add2.png) [Pular para o conteúdo principal](#main-content) # Criar cálculos espaciais e uniões de colunas _Compatível com o Tableau Prep Builder versão 2026.1 e posterior e na Web._ Atualmente, você pode se conectar a arquivos espaciais e fontes de dados espaciais no Tableau Prep Builder e no Tableau Prep na Web. A partir da versão 2026.1, você também pode limpar e transformar seus dados espaciais usando funções espaciais para campos calculados. Você também pode criar uniões de colunas espaciais na etapa de União de colunas. Isso permite a realização de tarefas espaciais complexas no Tableau Prep, tornando a análise de dados espaciais no Tableau mais acessível e eficiente. Para obter informações sobre os formatos de arquivos e bancos de dados espaciais aos quais você pode se conectar, consulte “Conectar-se a arquivos e bancos de dados espaciais” em [Conectar-se a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm#connect-via-builtin-connectors-for-popular-data-types). O Tableau Prep aceita muitas das mesmas funções de cálculo espacial que o Tableau Desktop. Por exemplo, você pode usar a função MAKEPOINT para converter dados de campo de latitude e longitude em valores de ponto do Tableau em arquivos de texto. Use a função VALIDATE para confirmar a correção topológica dos valores de campo de ponto, polígono ou linha. Você pode até solicitar ao Tableau Agent para criar esses cálculos para você. A união de colunas de dados espaciais no Tableau pode consumir recursos valiosos e afetar seu desempenho geral. Ao realizar uniões espaciais no Tableau Prep, você pode carregar antecipadamente esse processo e simplificar sua criação de visualização com dados espaciais limpos antes de começar sua análise espacial. ## Limitações Embora o Tableau Prep aceite muitos dos mesmos recursos e funções espaciais que o Tableau Desktop, há algumas limitações. - O Tableau Agent pode criar cálculos espaciais, mas ainda não pode criar uniões espaciais. - Não é possível fazer upload dos arquivos .mif e .shp para a criação na Web. - O Tableau Prep não pode traduzir valores espaciais do Tableau para WKT (formato de texto conhecido), GeoJSON ou qualquer outro formato de tipo de dados espaciais. - O processamento espacial avançado, como a remoção de orifícios de polígonos ou a conversão de polígonos em polilinhas, não é compatível com esse recurso. - As uniões espaciais no Tableau Prep só aceitam a união de colunas em tipos de campos espaciais. Para unir colunas de dados espaciais com dados não espaciais, como campos de longitude e latitude em um arquivo de texto, crie um campo calculado usando as funções espaciais para esses dados primeiro. Por exemplo, use a função espacial MAKEPOINT para converter dados de campo de latitude e longitude em um campo de ponto. - Os fluxos que incluem dados espaciais só podem ser gerados para arquivos .hyper ou como uma fonte de dados publicada. Outros tipos de saída não são compatíveis no momento. - As uniões espaciais não são compatíveis no momento. ## Criar cálculos espaciais É possível usar uma função Espacial para converter campos de longitude e latitude, ou outros campos que representam um local (como um CEP ou nome de país) em tipos de campos espaciais. O Tableau Prep oferece suporte às funções espaciais a seguir. Para obter mais informações sobre essas funções e a sintaxe, consulte [Funções espaciais](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_spatial.htm) no Tableau Desktop e na ajuda da Criação na Web.
FunçãoSintaxeQuando usar esta
ÁREAAREA(Spatial Polygon, 'units')

Cálculo do valor da área

Exemplo: determine a área total de uma parcela imobiliária para calcular o preço por metro quadrado.

BUFFERBUFFER(Spatial point, distance, 'units')

Análise da área de comércio

Exemplo: crie uma “área de influência” de 15 km ao redor de um novo local de loja para identificar quais clientes moram a uma distância de carro.

DIFFERENCEDIFFERENCE(Spatial, Spatial)

Exclusão de zonas

Exemplo: use um polígono de território de vendas e “corte” uma área florestal protegida ou a zona de um concorrente para encontrar a verdadeira área tributável.

DISTÂNCIADISTANCE(SpatialPoint1, SpatialPoint2, 'units')

Otimização da entrega

Exemplo: calcule a distância entre um armazém e um centro de distribuição para sinalizar quaisquer remessas que excedam uma taxa de envio “local”.

INTERSECTIONINTERSECTION (spatial, spatial)

Localização de espaço compartilhado

Exemplo: identifique a área específica de sobreposição onde dois habitats diferentes da vida selvagem se encontram para estudar a interação entre as espécies.

INTERSECTSINTERSECTS (geometry1, geometry2)

Filtragem de dados

Exemplo: retorna True ou False. Use isso como um filtro para manter apenas as localizações das lojas que se enquadram em distritos escolares específicos de “Alto crescimento”.

LENGTHLENGTH (geometry,'units')

Planejamento de infraestrutura

Exemplo: Meça a quilometragem total de uma rota de cabo de fibra óptica para estimar o custo dos materiais para uma expansão da rede.

MAKELINEMAKELINE(SpatialPoint1, SpatialPoint2)

Roteamento logístico

Exemplo: crie a distância reduzida entre um aeroporto de origem e um destino para visualizar rotas de voo globais.

MAKEPOINTMAKEPOINT(latitude, longitude, [SRID])

Geocodificação de dados brutos

Exemplo: transforme uma planilha de coordenadas de latitude e longitude em pontos geográficos reais que Tableau pode mapear.

OUTLINEOUTLINE(spatial polygon)

Destaque de limites

Exemplo: extraia a borda de uma forma complexa de cidade para criar uma linha de “perímetro” limpa para uma sobreposição de mapa.

SHAPETYPESHAPETYPE(geometry)

Dados de auditoria

Exemplo: identifique se uma coluna espacial contém Pontos, Linhas ou Polígonos para garantir que seu conjunto de dados seja consistente antes de uni-la a outros dados.

SYMDIFFERENCESYMDIFFERENCE(spatial, spatial)

Detecção de alterações

Exemplo: compare um mapa de uma zona de inundação de 2020 e 2024 para encontrar apenas as áreas que foram inundadas em um ano, mas não ambas.

VALIDATEVALIDATE(spatial geometry)

Limpeza de dados

Exemplo: verifique se pontos, cadeias de linhas e polígonos (como CEP, cidade, estado etc.) são válidos ou estão corrompidos. Use isso para filtrar formas corrompidas que podem travar seu fluxo. Este cálculo pode levar algum tempo para ser executado.

### Criar um campo calculado para dados espaciais 1. Conecte-se a uma fonte de dados que inclua dados espaciais. 2. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. 3. No editor de cálculo, digite um nome para o cálculo e, no menu suspenso do campo Referência, selecione Espacial. ![A caixa de diálogo do editor de cálculo mostra opções de cálculo espacial.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_calc_editor.png) 4. Selecione a função espacial que deseja calcular e insira a expressão. Por exemplo, se você tiver um arquivo que inclua valores de latitude e longitude e quiser calcular o número de pessoas que moram a menos de 8 km de uma loja, poderá criar um campo calculado usando a função BUFFER e a sintaxe mostrada abaixo. ![O editor de cálculo do Tableau Prep mostra o exemplo da sintaxe e função espacial BUFFER.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_calc_editor_example.png) ## Criar uniões espaciais Execute as uniões de colunas em dados espaciais na etapa União de colunas como qualquer outro tipo de união de colunas. Quando as fontes de dados incluem dados espaciais, nos quais os campos recebem um tipo de dados geoespaciais ![Um ícone de globo representa um tipo de dados geológicos ou geográficos.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_geo_data_type_icon.png), é possível ver um novo operador na cláusula de união de colunas de Interseções. Para uniões espaciais, o Tableau Prep aceita a mesma funcionalidade de união de colunas que existe hoje, bem como algumas funcionalidades adicionais. Para obter mais informações sobre a união de colunas de dados no Tableau Prep, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#join-your-data). Quando o Tableau Prep identifica campos geoespaciais em nossos conjuntos de dados, ele aplica por padrão um tipo de união de colunas de interseções aos campos correspondentes. Quaisquer correspondências de campo geoespacial adicionais são mostradas na seção Recomendações da cláusula de união que você pode adicionar clicando nelas. Para uniões espaciais, você pode focalizar o operador Interseções para ver uma dica de ferramenta visual sobre a união de colunas. Para verificar seus resultados no Tableau Desktop, clique no botão Visualizar no Tableau Desktop que aparece na seção Resumo dos resultados da união de colunas. ![O painel Configurações de união de colunas do Tableau Prep mostra cláusulas de união e resultados, dicas de ferramentas visuais e o botão Visualizar no Tableau Desktop.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_join_clause.png) Você só pode unir colunas em tipos de campos espaciais. Se você precisar unir colunas de dados não espaciais com dados espaciais, poderá criar um campo calculado para os dados não espaciais (como campos de longitude ou latitude) usando uma das funções espaciais e, em seguida, criar a união de colunas. As uniões espaciais compatíveis incluem: - Ponto para ponto - Ponto para linha - Ponto para polígono - Linha para linha - Linha para polígono - Polígono para polígono ### De que tipo de união de colunas preciso? O tipo de união de colunas selecionado dependerá do objetivo da sua visualização. - **União interna**: selecione esse tipo de união de colunas para filtrar os dois conjuntos de dados e visualizar apenas as geometrias que os conjuntos de dados têm em comum. - **União esquerda ou direita**: selecione este tipo de união de colunas para filtrar os dados de uma fonte de dados e visualizar todas as geometrias da outra fonte de dados, além dos pontos em comum. - **União externa**: selecione este tipo de união de colunas para visualizar todas as geometrias de ambas as fontes de dados. As uniões espaciais aceitam todos os tipos de união de colunas no Tableau Prep. Para obter mais informações sobre tipos de uniões de colunas, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm). ### Unir dados espaciais Para criar uma união espacial, faça o seguinte: 1. Adicione pelo menos duas tabelas ao painel Fluxo que incluam dados espaciais; em seguida, selecione e arraste a tabela relacionada para a outra tabela até que a opção União de colunas seja exibida. Isso cria uma nova etapa de União de colunas no fluxo. ![A tela de fluxo do Tableau Prep mostra como arrastar e soltar para unir colunas de fontes de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_join_drag_drop.png) 2. Na guia Configurações da etapa de União de colunas, revise as Cláusulas de união aplicadas. Por padrão, o Tableau Prep cria uma cláusula de união usando o operador Interseções para campos geoespaciais correspondentes. Para editar a cláusula de união, clique nos campos ou no operador. Focalize o operador Interseções para ver uma dica de ferramenta visual sobre a união de colunas. ![Opções suspensas de Cláusulas de união aplicadas do Tableau Prep para editar uma cláusula de união.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_join_clause_dropdown.png) 3. Na seção Tipos de união de colunas, clique no diagrama de Venn para alterar o tipo de união de colunas. 4. Na seção Resumo de resultados da união de colunas, veja o número de campos incluídos e excluídos como resultado do tipo e das condições de união de colunas. No painel Cláusulas de união, é possível ver os valores em cada campo na cláusula de união. Os valores que não atendem aos critérios da cláusula de união de colunas são exibidos em texto de cor vermelha. Você também pode clicar em Visualizar no Desktop para testar seus resultados no Tableau. ![Resultados do resumo da união espacial do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_spatial_summary_join_results.png) 5. Na seção Recomendações da cláusula de união, você pode exibir e adicionar quaisquer correspondências de cláusula de união recomendadas à lista Cláusulas de união aplicadas. [Pular para o conteúdo principal](#main-content) # Criar e organizar o fluxo **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Após se conectar aos dados que deseja incluir no fluxo, você pode começar a limpar e formatá-los ao adicionar novas etapas ao fluxo ou inserir etapas entre as existentes. Para organizar seu fluxo, você pode alterar as cores da etapa padrão, adicionar descrições para fornecer contexto para suas etapas ou ações de limpeza ou reorganizar seu layout de fluxo para facilitar o acompanhamento dos fluxos complexos. ## Adicionar ou inserir etapas À medida que você constrói o fluxo, pode adicionar diferentes tipos de etapas para executar as ações necessárias. Por exemplo, adicione uma Etapa de limpeza para realizar ações como dividir campos, aplicar filtros ou executar várias outras operações para limpar dados sujos. Use um tipo de etapa União de colunas ou União de linhas para combinar tabelas de dados ou adicionar um tipo de etapa Script para incorporar os scripts R ou Python no fluxo. À medida que seu fluxo começa a se formar, talvez seja necessário voltar às etapas anteriores do fluxo e inserir diferentes tipos de etapa para executar várias ações, como adicionar uma etapa de limpeza adicional ou agregar seus dados para usar o mesmo nível de detalhe que uma etapa posterior. **Observação**: as opções de menu que você visualiza variarão dependendo de sua versão do Tableau Prep Builder, e se você estiver adicionando uma etapa para construir a etapa seguinte no fluxo em vez da inserção de uma etapa entre etapas existentes. Se você estiver usando o Tableau Prep Builder versão 2019.3.1 ou anterior, consulte essa seção para ver as opções do menu. Você não pode adicionar etapas de entrada usando esses menus. Em vez disso, precisará arrastar tabelas do painel Conexões para o painel Fluxo. Para obter mais informações, consulte [Conectar a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm). ### Adicionar passos Depois de conectar-se aos dados e arrastar uma tabela para a tela, clique no botão de adição ![Um botão com um sinal de mais para adicionar etapas de fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_add_icon.png) para selecionar um tipo de etapa no menu ou clique na etapa de limpeza sugerida (Tableau Prep Builder versão 2020.3.3 e posteriores e na Web) para adicionar automaticamente uma etapa de limpeza ao fluxo.

Um menu de linha de fluxo do Tableau Prep é aberto e as opções do Prep são exibidas.

A interface de fluxo do Tableau Prep Builder mostrando a etapa de limpeza sugerida.
Selecione um tipo de etapa: - Etapa de limpeza: adicione uma etapa de limpeza para executar uma variedade de ações de limpeza. Para obter mais informações sobre as diferentes ações de limpeza disponíveis, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm). **Observação**: no Tableau Prep Builder versão 2019.4.2, a opção Adicionar ramificação foi substituída pela opção Etapa de limpeza. Para dividir o fluxo em diferentes ramificações, clique no botão de adição ![Um botão com um sinal de mais para adicionar etapas de fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_add_icon.png) entre duas etapas existentes e selecione um tipo de etapa no menu Adicionar. - Novas linhas: gere novas linhas para preencher as lacunas em seu conjunto de dados sequenciais. Para obter mais informações, consulte [Preencher lacunas em dados sequenciais](https://help.tableau.com/current/prep/pt-br/prep_new_rows.htm). Agregado: crie uma etapa de Agregação para selecionar campos e alterar o nível de detalhe. Para obter mais informações, consulte [Agregar e agrupar valores](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Group). - Tabela dinâmica: crie uma etapa de Tabela dinâmica para executar uma variedade de opções de dinamização, como converter dados de coluna em linhas ou dados de linha em colunas. Você também pode configurar uma tabela dinâmica curinga para adicionar automaticamente novos dados à tabela dinâmica. Para obter mais informações, consulte [Dinamizar os dados](https://help.tableau.com/current/prep/pt-br/prep_pivot.htm). - União de colunas: crie uma etapa de União de colunas para combinar tabelas de dados. Quando você criar uma união de colunas na opção de menu, adicione manualmente a outra entrada à união e inclua as cláusulas de união. Como alternativa, é possível arrastar e soltar uma etapa (mostrado abaixo) para unir colunas de arquivos automaticamente. Para obter mais informações sobre a criação de uma união de colunas, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Join). ![Uma etapa de fluxo sendo arrastada sobre outra etapa de fluxo para unir linhas ou colunas das etapas.](/tableau/current/pt-br/prep/pt-br/Img/prep_addjoinorunion.png) Se você se conectar a bancos de dados que incluem tabelas com dados de relacionamento, também poderá criar uma união de colunas no menu no painel Fluxo. Para obter mais informações sobre como unir tabelas usando esse método, consulte [Unir colunas de dados na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#table_relations_joins). - União de linhas: crie uma etapa de União de linhas. Adicione tabelas à União de linhas arrastando-as para a etapa e soltando-as na opção Adicionar exibida. Como alternativa, é possível arrastar e soltar uma etapa em outra etapa para unir linhas de arquivos. Para obter mais informações sobre a criação de uma união de linhas, consulte [Unir linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Union). - Script (Tableau Prep Builder versão 2019.3.1 e posteriores e na Web): crie uma etapa de Script para incluir scripts R e Python no fluxo. No momento, não há suporte para as etapas de script no Tableau Cloud. Para obter mais informações, consulte [Usar scripts R e Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm). - Previsão: use modelos oferecidos pelo Einstein Discovery fazer previsões em massa para os dados em seu fluxo. Para obter mais informações, consulte [Adicionar previsões do Einstein Discovery ao seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_predictions.htm). - Saída: crie uma etapa de Saída para salvar a saída em um arquivo de extração (.hyper) e um arquivo .csv. Publique a saída como fonte de dados em um servidor ou grave a saída de fluxo em um banco de dados. No momento, não há suporte na Web para salvar as etapas de Saída em um arquivo. Para obter mais informações sobre os tipos de saída, consulte [Salvar e compartilhar seu trabalho](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm). - Colar: adicione as etapas copiadas do mesmo fluxo. Para obter mais informações sobre como copiar e colar etapas no mesmo fluxo, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#copy_paste). - Inserir fluxo (Tableau Prep Builder versão 2019.3.2 e posteriores e na Web): adicione etapas de fluxo que foram salvas de outro fluxo no seu fluxo atual. Você pode adicioná-las ao final de uma etapa ou inseri-las entre as etapas existentes. Para obter mais informações sobre o uso de etapas de fluxo salvas no seu fluxo, consulte [Criar etapas de fluxos reutilizáveis](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm#reuse_flows) **Observação**: essa opção foi adicionada a este menu no Tableau Prep Builder versão 2019.4.2. Em versões anteriores, você pode adicionar etapas de fluxo ao clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS), no espaço em branco do painel Fluxo. ### Inserir etapas Insira uma etapa entre as etapas existentes. Os tipos de etapa de entrada e saída não estão disponíveis neste menu. As opções variam de acordo com a versão do produto. Se você estiver usando uma versão anterior Tableau Prep Builder, consulte a seção de **versão 2019.3.1 e anterior** abaixo. 1. Passe o mouse no meio da linha de fluxo onde você deseja inserir uma etapa até que o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) apareça. Em seguida, clique no ícone e selecione um tipo de etapa. **Observação**: suas opções podem parecer diferentes dependendo da versão do produto. Por exemplo, o recurso Inserir fluxo foi adicionado a este menu na versão 2019.4.2 do Tableau Prep Builder. ![Passe o mouse no meio da linha de fluxo onde deseja inserir uma etapa até que o ícone de adição apareça e, em seguida, clique no ícone e selecione um tipo de etapa.](/tableau/current/pt-br/prep/pt-br/Img/prep_insert_menu2.png) 2. Selecione um tipo de etapa: - Etapa de limpeza: insira uma etapa de limpeza entre as etapas existentes para executar uma variedade de ações de limpeza. Para obter mais informações sobre as várias ações de limpeza no dados, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) - Novas linhas: gere novas linhas para preencher as lacunas em seu conjunto de dados sequenciais. Para obter mais informações, consulte [Preencher lacunas em dados sequenciais](https://help.tableau.com/current/prep/pt-br/prep_new_rows.htm). - Agregado: insira uma etapa de Agregação entre as etapas existentes para selecionar campos e alterar o nível de detalhe. Para obter mais informações, consulte [Agregar e agrupar valores](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Group). - Tabela dinâmica: insira uma etapa de Tabela dinâmica entre as etapas existentes para executar uma variedade de opções de dinamização, como converter dados de coluna em linhas ou dados de linha em colunas. Você também pode configurar uma tabela dinâmica curinga para adicionar automaticamente novos dados à tabela dinâmica. Para obter mais informações, consulte [Dinamizar os dados](https://help.tableau.com/current/prep/pt-br/prep_pivot.htm). - União de colunas: insira uma etapa de União de colunas entre as etapas existentes. Quando você criar uma união de colunas na opção de menu, adicione manualmente a outra entrada à união e inclua as cláusulas de união. Como alternativa, é possível arrastar e soltar uma etapa (mostrado abaixo) para unir colunas de arquivos automaticamente. ![Uma etapa de fluxo sendo arrastada sobre outra etapa de fluxo para unir linhas ou colunas das etapas.](/tableau/current/pt-br/prep/pt-br/Img/prep_addjoinorunion.png) Para obter mais informações sobre a criação de uma união de colunas, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Join). Se você se conectar a bancos de dados que incluem tabelas com dados de relacionamento também poderá criar uma união de colunas no menu no painel Fluxo. Para obter mais informações sobre como unir tabelas usando esse método, consulte [Unir colunas de dados na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#table_relations_joins). - União de linhas: insira uma etapa de União de linhas. Adicione tabelas à União de linhas arrastando-as para a etapa e soltando-as na opção Adicionar exibida. Como alternativa, é possível arrastar e soltar uma etapa em outra etapa para unir linhas de arquivos. Para obter mais informações sobre a criação de uma união de linhas, consulte [Unir linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Union). - Script (Tableau Prep Builder versão 2019.3.1 e posteriores e na Web): insira uma etapa de Script para incluir scripts R e Python no fluxo. No momento, não há suporte para as etapas de script no Tableau Cloud. Para obter mais informações, consulte [Usar scripts R e Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm). - Previsão: use modelos oferecidos pelo Einstein Discovery fazer previsões em massa para os dados em seu fluxo. Para obter mais informações, consulte [Adicionar previsões do Einstein Discovery ao seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_predictions.htm). - Colar: insira etapas copiadas do mesmo fluxo entre as etapas existentes. Para obter mais informações sobre como copiar e colar etapas no mesmo fluxo, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#copy_paste). - Inserir fluxo (Tableau Prep Builder versão 2019.3.2 e posteriores e na Web): insira etapas de fluxo que foram salvas de outro fluxo no seu fluxo atual. Você pode adicioná-las ao final de uma etapa ou inseri-las entre as etapas existentes. Para obter mais informações sobre o uso de etapas de fluxo salvas no seu fluxo, consulte [Criar etapas de fluxos reutilizáveis](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm#reuse_flows). **Observação**: essa opção foi adicionada a este menu no Tableau Prep Builder versão 2019.4.2. Em versões anteriores, você pode inserir etapas de fluxo ao clicar com o botão direito do mouse ou pressionar Ctrl e clicar (MacOS), no espaço em branco do painel Fluxo. Versão 2019.3.1 e anteriores 1. Passe o cursor sobre uma etapa até que o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) apareça, em seguida clique nele e selecione o tipo de etapa. Inserir etapa insira uma etapa de limpeza entre as etapas. Todas as outras opções criarão uma ramificação do fluxo. ![A opção Inserir etapa insere uma etapa de limpeza entre as etapas.](/tableau/current/pt-br/prep/pt-br/Img/prep_insert_menu_2019.3.1b.png) 2. Selecione dentre as seguintes opções: - Adicionar extensão: divida seu fluxo em diferentes extensões. - Inserir etapa: insira uma etapa de limpeza entre as etapas existentes para executar uma variedade de ações de limpeza. Para obter mais informações sobre as várias ações de limpeza no dados, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) - Adicionar agregação: crie uma etapa de agregação onde você pode selecionar os campos que deseja agregar ou agrupar. Para obter mais informações, consulte [Agregar e agrupar valores](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Group). - Adicionar tabela dinâmica: crie uma Tabela dinâmica onde você pode executar uma variedade de opções de dinamização para converter dados de coluna em linhas ou dados de linha para colunas. Para obter mais informações, consulte [Dinamizar os dados](https://help.tableau.com/current/prep/pt-br/prep_pivot.htm). - Adicionar junção: crie uma etapa de União de colunas onde você pode adicionar manualmente a outra entrada à união e adicionar as cláusulas de união. Como alternativa, é possível arrastar e soltar uma etapa para unir colunas de arquivos. O exemplo a seguir mostra a etapa de entrada Orders\_Central sendo arrastada e solta em União de colunas: ![Uma etapa de fluxo sendo arrastada sobre outra etapa de fluxo para unir linhas ou colunas das etapas.](/tableau/current/pt-br/prep/pt-br/Img/prep_addjoinorunion.png) Para obter mais informações sobre a criação de uma união de colunas, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Join). No Tableau Prep Builder versão 2019.1.3 e posteriores, se você se conectar a bancos de dados que incluem tabelas com dados de relacionamento, também poderá criar uma união de colunas no menu no painel Fluxo. Para obter mais informações sobre como unir tabelas usando esse método, consulte [Unir colunas de dados na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#table_relations_joins). - Adicionar União de linhas: crie uma etapa de União de linhas. Adicione tabelas à União de linhas arrastando-as para a etapa e soltando-as na opção Adicionar exibida. Como alternativa, é possível arrastar e soltar uma etapa em outra etapa para unir linhas de arquivos. Para obter mais informações sobre a criação de uma união de linhas, consulte [Unir linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Union). - Adicionar script (versão 2019.3.1 e posterior): crie uma etapa de script para incluir scripts R e Python em seu fluxo. Para obter mais informações, consulte [Usar scripts R e Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm). - Adicionar saída: selecione essa opção para salvar a saída de um arquivo de extração (.hyper), de um arquivo .csv ou para publicar a saída como uma fonte de dados em um servidor. ## Agrupar etapas _Com suporte no Tableau Prep Builder versão 2020.3.3 e posteriores e no Tableau Server ou Tableau Cloud a partir da versão 2020.4._ Use a opção Grupo para compartimentar as seções de grandes fluxos complexos em pastas para facilitar o acompanhamento, a solução de problemas ou o compartilhamento do fluxo com outras pessoas. Você pode alterar a cor do grupo, adicionar uma descrição, copiar e colar as etapas agrupadas em outras áreas do fluxo ou no Tableau Prep Builder e até mesmo salvar as etapas agrupadas em um arquivo no servidor para reutilizá-las em outros fluxos. ![Um fluxograma complexo com o ícone da pasta de arquivo do Grupo 1 e o ícone da pasta de arquivo do Grupo 2 destacados.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupsteps5.png) #### Requisitos para agrupar etapas - As etapas devem ser conectadas diretamente a uma linha de fluxo. - As etapas só podem ser incluídas em um grupo de cada vez. - Os grupos não podem ser aninhados. - Você pode adicionar ou remover etapas de um grupo a qualquer momento, desde que mantenha as conexões da linha de fluxo entre as etapas do grupo. Isso também se aplica à remoção de etapas em um fluxo que já foi incluído em um grupo. Nesse cenário, o grupo é desagrupado automaticamente. ### Criar um grupo Selecione um conjunto de etapas conectadas no fluxo (você também pode arrastar para selecionar várias etapas em um clique), em seguida, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) nas etapas selecionadas e escolha Grupo no menu. ![Um diagrama de fluxo com um menu suspenso aberto e “Grupo” visível.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupsteps2.png) Depois de criar o grupo, você pode realizar qualquer uma das ações a seguir: - Clique nas setas duplas para expandir ![Duas setas diagonais apontando em direções opostas.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupsteps4.png)ou recolher ![Duas setas apontando uma para a outra na diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupsteps7.png)o grupo a qualquer momento. - Adicione mais etapas ao grupo arrastando e soltando uma etapa conectada na pasta recolhida. - Remover etapas do grupo. No estado expandido, clique com o botão direito do mouse ou pressione Ctrl e clique (Mac OS) em uma etapa e selecione Remover do grupo. **Observação**: esta opção não estará disponível se você tentar remover uma etapa que interrompe a continuidade do grupo. - No estado recolhido, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) para abrir o menu e selecione uma das opções a seguir: ![Um menu abaixo do ícone de uma pasta de arquivo selecionada, oferecendo opções para ajustar o grupo.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupsteps6.png) - Renomear: altere o nome do grupo. - Adicionar descrição: insira uma descrição para a grupo - Editar cor: altere a cor da pasta do grupo. Essa ação não altera a cor das etapas individuais do grupo. - Expandir grupo: mostre todas as etapas do grupo. Você também pode clicar nas setas duplas ![Duas setas diagonais apontando em direções opostas.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupsteps4.png) para expandir o grupo. - Desagrupar: remova todas as etapas do grupo e exclua o grupo. - Copiar: copia o grupo e todas as etapas do grupo para a área de transferência para colar em outro lugar do fluxo. Para obter mais informações sobre o uso de copiar e colar, consulte [Copiar e colar etapas](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm#copy_steps). - Salvar etapas como fluxo (somente para o Tableau Prep Builder): salve as etapas agrupadas localmente em um arquivo do seu computador ou publique-as no Tableau Server ou no Tableau Cloud para compartilhar com outras pessoas ou usá-las em outros fluxos. Para obter mais informações sobre como salvar as etapas para serem reutilizadas, consulte [Criar etapas de fluxos reutilizáveis](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm#reuse_flows). - Remover: remova o grupo e todas as etapas no grupo do fluxo. - (versão 2021.1.2 e posterior) No estado expandido, clique com o botão direito do mouse ou Cntrl-clique (MacOS) na área de grupo expandido para abrir o menu e recolher o grupo ou desagrupar as etapas. ![Opções “Recolher” e “Desagrupar” em um processo chamado “Agrupar 1”, que mostra pedidos e devoluções, seguido por uma etapa chamada "Limpar 2".](/tableau/current/pt-br/prep/pt-br/Img/prep_group_ungroup_menu.png) ## Alterar o esquema de cores do fluxo Por padrão, o Tableau Prep atribui uma cor a cada etapa do fluxo. Esse esquema de cores é aplicado em todo o fluxo para ajudar a rastrear os dados conforme você aplica as etapas de limpeza, une colunas ou linhas ou agrega os dados para saber quais arquivos são afetados pelas operações. Para selecionar um esquema de cores diferente para as etapas, faça o seguinte: 1. Selecione uma ou mais etapas. 2. Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) em uma etapa selecionada e marque Editar cor. ![O menu do botão direito em uma etapa do fluxo com a opção Editar cor e a paleta de cores para alterar a cor da etapa é exibida.](/tableau/current/pt-br/prep/pt-br/Img/prep_edit_colors.png) 3. Clique em uma cor na paleta de cores para aplicá-la. Para redefinir a cor da etapa novamente como a cor padrão, escolha uma das opções a seguir: - Clique em Desfazer no menu superior. - Ctrl+Z ou Command-Shift-Z (MacOS). - Selecione as etapas alteradas, clique com o botão direito do mouse em uma etapa selecionada e selecione Editar cor, depois selecione Redefinir cor na parte inferior da paleta de cores. ## Remover etapas do fluxo A qualquer momento no fluxo, é possível remover etapas ou as linhas de fluxo entre etapas. **Observação**: você não pode remover as linhas de fluxo que entram ou saem de um grupo de etapas recolhido. Você deve expandir o grupo ou desagrupar as etapas primeiro. - Para remover uma etapa ou linha de fluxo, selecione a etapa ou linha que deseja remover, clique com o botão direito do mouse no elemento e selecione Remover. - Para remover várias etapas ou linhas de fluxo, execute uma das ações a seguir: - Use o mouse para arrastar e selecionar uma seção inteira do fluxo. Em seguida, clique com o botão direito do mouse ou pressione Ctrl (Mac OS) e clique em uma das etapas escolhidas e selecione Remover - Pressione Ctrl+A ou Cmd+A (MacOS) para selecionar todos os elementos do fluxo, ou pressione Ctrl+clique ou Cmd+clique (MacOS) para selecionar elementos específicos; em seguida, pressione a tecla Excluir. ## Adicionar descrições a etapas de fluxo e ações de limpeza À medida que você cria o fluxo e realiza várias operações de limpeza, talvez queira adicionar uma descrição para ajudar outros usuários, que por sua vez podem visualizar ou trabalhar com ele posteriormente, a entender melhor suas etapas. É possível adicionar uma descrição a qualquer etapa individual do fluxo diretamente no painel Fluxo, a qualquer grupo de etapas ou a qualquer ação de limpeza no painel Alterações para dar contexto adicional às alterações. A descrição pode conter até 200 caracteres. Para obter mais informações sobre como exibir alterações no painel Alterações, consulte [Visualizar suas alterações](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#changes_pane). ### Adicionar uma descrição às etapas do fluxo Ao adicionar uma descrição, um ícone de mensagem ![O ícone Descrição é mostrado como um balão de fala.](/tableau/current/pt-br/prep/pt-br/Img/prep_description_icon.png) é adicionado embaixo da etapa. Clique no ícone para mostrar ou ocultar o texto da descrição no painel Fluxo. 1. No painel Fluxo, selecione uma etapa. 2. Execute um destes procedimentos: - Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) na etapa e selecione Adicionar descrição no menu. ![Menu de clique direito em uma etapa do fluxo do Tableau Prep com a opção Adicionar descrição destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_description.png) - Clique duas vezes no campo de nome da etapa, depois clique em Adicionar uma descrição. ![Um fluxo do Tableau Prep mostrando a caixa de texto para inserir uma descrição para uma etapa do fluxo no painel de fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_description5.png) 3. Digite a descrição na caixa de texto. ![A caixa de texto de descrição para uma etapa do fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_description2.png) 4. Clique fora da caixa de texto ou pressione Enter para aplicar as alterações. Como padrão, a descrição é exibida embaixo da etapa. Para ocultar a descrição, clique no ícone de mensagem ![O ícone Descrição é mostrado como um balão de fala.](/tableau/current/pt-br/prep/pt-br/Img/prep_description_icon.png). 5. Para editar ou excluir a descrição, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) na etapa ou na descrição. Em seguida, no menu, selecione Editar descrição ou Excluir descrição. ![Menu de clique direito em uma etapa do fluxo do Tableau Prep com a opção Editar descrição destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_description3.png) ### Adicionar uma descrição para uma entrada de alteração A partir do Tableau Prep Builder versão 2019.1.1 e na Web, você pode adicionar uma descrição a uma entrada no painel Alterações. 1. No painel Fluxo, selecione uma etapa. 2. Abra o painel Alterações ou a guia Alterações. 3. Clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) em uma entrada no painel Alterações e selecione Adicionar descrição. ![O painel Alterações em um fluxo mostrando um menu de clique com o botão direito com “Adicionar descrição” destacado.](/tableau/current/pt-br/prep/pt-br/Img/prep_change_description.png) 4. Insira uma descrição para a ação de alteração. ![O painel Alterações mostra uma entrada destacada e uma caixa de texto aberta onde você pode digitar uma descrição.](/tableau/current/pt-br/prep/pt-br/Img/prep_change_description2.png) A descrição é exibida abaixo do texto gerado para a alteração com um ícone de comentário ![O ícone Descrição é mostrado como um balão de fala.](/tableau/current/pt-br/prep/pt-br/Img/prep_description_icon.png). ![O painel Alterações mostra uma entrada destacada e uma descrição da alteração.](/tableau/current/pt-br/prep/pt-br/Img/prep_change_description3.png) 5. Para editar ou excluir a descrição, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) no item de alteração e selecione Editar descrição ou Excluir descrição. ## Reorganizar o layout do fluxo _Com suporte no Tableau Prep Builder versão 2019.2.2 e posteriores e no Tableau Server e Tableau Cloud a partir da versão 2020.4._ Ao criar um fluxo, o Tableau Prep Builder usa um layout padrão. Cada fluxo é disposto e processado da esquerda para a direita, com as etapas de entrada começando na extremidade esquerda da tela e as etapas de saída terminando no lado direito da tela. No entanto, se você criar fluxos grandes e complexos, eles poderão se tornar difíceis de seguir. Você poderá limpar o layout do fluxo ao selecionar e mover etapas para que o layout do fluxo seja organizado de forma que faça sentido para você. Por exemplo, você pode corrigir linhas de fluxo cruzadas, movimentar as etapas do fluxo para limpar espaço em branco extra ou reorganizar as etapas do fluxo para mostrar uma sequência clara de eventos. Por exemplo, o fluxo a seguir é confuso e difícil de seguir: ![Um fluxograma com etapas de limpeza e preparação de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_messy_flow.png) Para limpar esse fluxo, selecione e arraste etapas para cima, para baixo, para a esquerda ou para a direita e solte-as em um novo local na tela. As etapas de fluxo não podem ser movidas para uma posição que interrompa o fluxo do processo da direita para a esquerda. Por exemplo, você não pode arrastar uma etapa de união de linhas que esteja posicionada antes de uma etapa de união de colunas para uma posição posterior à etapa de união de colunas no fluxo. Ao arrastar as etapas do fluxo para um local permitido, é exibida uma caixa laranja. Se o local não for permitido, nenhuma caixa laranja será exibida e as etapas retornarão ao local original quando você tentar soltá-las. Para mover as etapas do fluxo, faça o seguinte: 1. No painel Fluxo, selecione as etapas que você quer mover. Clique em uma etapa específica, arraste para selecionar várias etapas ou clique com a tecla Ctrl ou Cmd (MacOS) pressionada para selecionar etapas que não estejam próximas umas das outras. 2. Arraste e solte as etapas para o novo local. **Observação**: se você não gostar da reorganização, poderá clicar em Desfazer no menu superior para reverter. No entanto, se você executar ações de limpeza entre o movimento das etapas, também poderá desfazer essas ações. A opção Desfazer reverte suas ações na ordem em que você as executou. Assista a "Reorganizar etapas de fluxo" em ação O exemplo a seguir mostra a reorganização de um fluxo usando arrastar e soltar. ## Usar a ferramenta de navegação de fluxo Ao trabalhar com grandes fluxos, pode ser difícil rolar a página para trás e para frente para procurar uma área específica do fluxo à qual você precisa voltar. A ferramenta do navegador do fluxo facilita isto. O navegador de fluxo é uma versão em miniatura do seu fluxo que aparece no canto inferior direito da tela. ![Um fluxograma que exibe transformações de dados para várias fontes de dados no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_navigator.png) Clique em qualquer área do gráfico para saltar para essa área do fluxo ou use as seguintes opções da barra de ferramentas ![Uma barra de ferramentas com controles de zoom em 100%.](/tableau/current/pt-br/prep/pt-br/Img/prep_flow_nav_toolbar.png) para navegar:
Opção da barra de ferramentasDescrição
Um ícone de seta para baixo.Recolher o gráfico do navegador de fluxo. No estado recolhido, você só pode ver o indicador de porcentagem. Basta passar o mouse sobre isso para expandir a barra de ferramentas e clique na seta para cima Uma seta apontando para cima que, quando clicada, expande o gráfico do navegador de fluxo. para expandir o gráfico novamente.
Uma seta apontando para cima que, quando clicada, expande o gráfico do navegador de fluxo.Expanda o gráfico do navegador de fluxo.
O ícone de tamanho permite alterar seu fluxo para caber na tela.Altere o tamanho do seu fluxo para caber na tela.
Um sinal de menos, um sinal de mais e uma porcentagem numérica para ajustar o zoom na sua tela de fluxo.Aumente e saia do seu fluxo. Você pode clicar no indicador de porcentagem para restaurar a exibição para 100 por cento.
[Pular para o conteúdo principal](#main-content) # Criar e usar parâmetros em fluxos _Com suporte no Tableau Prep Builder versão 2021.4.1 e posterior e na Web no Tableau Cloud e Tableau Server versão 2021.4.0 e posterior._ **Observação**: o conteúdo deste tópico se aplica aos fluxos de criação no Tableau Prep Builder e na Web, a menos que seja especificamente indicado. Para obter mais informações sobre os fluxos de criação na Web, consulte Tableau Prep na Web na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Se você costuma reutilizar fluxos usando dados diferentes com o mesmo esquema, pode criar e aplicar parâmetros de usuário a seus fluxos para fazer a transição facilmente entre cenários. Um parâmetro é um valor de espaço reservado global, como um número, valor de texto ou valor booleano que pode substituir um valor constante em um fluxo. Em vez de criar e manter vários fluxos, agora você pode criar um fluxo e usar parâmetros para executá-lo com diferentes conjuntos de dados. Por exemplo, você pode criar um parâmetro para várias regiões de vendas e, em seguida, aplicar um valor de parâmetro ao caminho do arquivo de entrada para executar o fluxo usando apenas os dados dessa região. ![Tableau Prep Builder com a caixa de diálogo "Criar parâmetro" aberta. Um parâmetro chamado "Regiões" está sendo criado.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_add.png) A partir do Tableau Prep Builder e do Tableau Cloud versão 2023.2, você também pode adicionar parâmetros de sistema ao arquivo ou ao nome de saída da fonte de dados publicada para adicionar automaticamente um carimbo de data/hora sempre que executar o fluxo. ![Adicione parâmetros de sistema ao arquivo ou ao nome de saída da fonte de dados publicada para adicionar automaticamente um carimbo de data/hora sempre que executar o fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_system_parameters.png) ## Onde posso aplicar os parâmetros? Você pode aplicar parâmetros de usuário a nomes de arquivos, caminhos, nomes de tabelas, expressões de filtro e campos calculados, dependendo do tipo de etapa. A partir da versão 2022.1.1, você pode até incluir valores de substituição de parâmetro ao executar fluxos usando a API REST. Para obter mais informações, consulte [Métodos de fluxo](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm) na Ajuda da API REST do Tableau Server. Você pode aplicar parâmetros de sistema (versão 2023.2 e posterior) a nomes de saída para tipos de saída de arquivo e de fonte de dados publicada. A tabela a seguir lista os locais onde você pode aplicar parâmetros para cada tipo de etapa.
Tipo de etapaLocalização do parâmetro
Entrada

Parâmetros do usuário:

  • Conectar ao arquivo: use parâmetros no nome do arquivo ou no caminho do arquivo
  • Conectar ao banco de dados: use parâmetros para o nome da tabela e no SQL personalizado
  • Editor de expressão: filtros
Saída

Parâmetros do usuário ou do sistema:

  • Saída para arquivo: aplique parâmetros de usuário ao nome do arquivo ou ao caminho do arquivo e, a partir da versão 2022.1.1, ao nome da planilha do Microsoft Excel. Aplique os parâmetros de sistema ao nome de arquivo.
  • Saída para servidor: aplique parâmetros de usuário ou de sistema ao nome da fonte de dados publicada
  • Saída para banco de dados: aplique parâmetros de usuário ao nome da tabela e, a partir da versão 2022.1.1, a scripts SQL executados antes ou depois de gravar a saída do fluxo em um banco de dados.
Limpeza, novas linhas, dinamização, união de colunas, união de linhas

Parâmetros do usuário:

  • Editor de expressão: filtros e valores de campo calculados
Agregação

Parâmetros do usuário:

  • Editor de expressão: filtros
Script

Parâmetros do usuário:

  • Editor de expressão: filtros e valores de campo calculados
Previsão

Parâmetros do usuário:

  • Editor de expressão: filtros e valores de campo calculados
## Criar parâmetros de usuário Os parâmetros de usuário são específicos para o fluxo onde são usados. Crie parâmetros no menu superior e defina os valores que se aplicam a eles. Você também pode definir parâmetros que aceitam todos os valores, o que significa que qualquer usuário de fluxo pode inserir qualquer valor ao executar o fluxo. Você pode tornar os valores de parâmetro de fluxo obrigatórios ou opcionais. Ao executar o fluxo, os usuários são solicitados a inserir os valores dos parâmetros. Os valores de parâmetro obrigatórios devem ser inseridos antes que o usuário possa executar o fluxo. Valores de parâmetros opcionais podem ser inseridos ou você pode aceitar o valor atual (padrão). Os valores de parâmetro são então aplicados ao fluxo executado em todos os lugares em que esse parâmetro é usado. **Observação**: para executar ou programar fluxos que incluem parâmetros no Tableau Server ou Tableau Cloud, o administrador deve habilitar as configurações de parâmetro de fluxo no servidor. Para obter mais informações, consulte **Criar e interagir com fluxos na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/web_author_flows.htm#flow-parameters) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/web_author_flows.htm#flow-parameters) 1. No menu superior, clique no ícone de parâmetro![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) e em Criar parâmetro . ![A caixa de diálogo “Criar um parâmetro” com a descrição “Definir variáveis que os usuários podem especificar ao executar fluxos no Tableau Prep Builder ou na Web”. O botão “Criar parâmetro” está selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_create.png) 2. Na caixa de diálogo Criar parâmetro, insira um nome e uma descrição (opcional). O nome do parâmetro deve ser exclusivo. Este é o valor mostrado na interface do usuário quando você adiciona um parâmetro. Se você incluir uma descrição, os usuários poderão ver essas informações ao passar o mouse (a partir da versão 2022.1.1) na lista de parâmetros e onde os parâmetros são usados. ![A caixa de diálogo “Criar parâmetro” é aberta e um parâmetro chamado “Regiões” está sendo criado. A descrição é “Regiões de vendas”, o tipo de dados é “Cadeia de caracteres” e o valor atual é “Sul”. Os valores permitidos são definidos como “Lista”. A caixa “Exigir seleção em tempo de execução” está marcada. ](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_create2.png) 3. Selecione um dos tipos de dados a seguir. Os valores dos parâmetros devem corresponder ao tipo de dados selecionado. - Número (inteiro ou decimal) - Cadeia de caracteres - Booleano 4. Especifique os valores permitidos. Esses são os valores que os usuários podem inserir no parâmetro. - Todos: esta opção permite que os usuários digitem qualquer valor para o parâmetro, mesmo durante a execução do fluxo. **Observação**: usar esta opção para parâmetros que podem ser usados nas etapas de entrada e saída pode ser um risco à segurança. Por exemplo, consultas SQL personalizadas que permitem a inserção de qualquer valor podem expor seus ativos de dados a ataques de injeção de SQL. - Lista: insira uma lista de valores que os usuários podem escolher ao aplicar o parâmetro. Para inserir vários valores, pressione **Enter** após cada entrada. 5. (opcional) Selecione Exigir seleção em tempo de execução (solicitar valor em tempo de execução em versões anteriores). Isso torna o parâmetro obrigatório. O usuário deve inserir um valor ao executar ou programar o fluxo. 6. Insira um valor atual. Esse é um valor obrigatório e atua como um valor padrão para o parâmetro. - Todos: insira um valor - Lista: o Tableau usa o primeiro valor da sua lista. Use a opção suspensa para alterá-lo. - Booleano: selecione Verdadeiro ou Falso. 7. Clique em OK para salvar o parâmetro. ### Alterar o valor padrão do parâmetro de usuário Ao criar usuário um parâmetro de usuário, você deve especificar um valor atual (padrão). Se um parâmetro for incluído em um fluxo, esse valor será usado para: - Execute consultas de SQL personalizado definidas em uma etapa de entrada. - Preencha os parâmetros opcionais que não são especificados em tempo de execução. - Substitua o parâmetro como um valor estático nas etapas salvas (versão 2022.1.1 e posterior). - Substitua o parâmetro como um valor estático em caminhos de arquivo ao publicar fluxos com conjuntos de dados compactados. Você pode alterar o valor a qualquer momento. No menu superior, você pode editar o parâmetro ou usar o botão Definir na lista de parâmetros. De dentro do fluxo, você pode usar o botão Definir em qualquer lugar em que o parâmetro seja aplicado. Ao fazer isso, ele redefine o valor atual (padrão) do parâmetro em todos os lugares em que o parâmetro é usado, mesmo em consultas de SQL personalizado. #### Editar parâmetros de usuário 1. No menu superior, clique no ícone de parâmetro![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png). 2. Clique em Editar parâmetro. 3. Na caixa de diálogo Editar parâmetro, faça as alterações e clique em OK. ![A caixa de diálogo “Editar parâmetro” está aberta e um parâmetro chamado “Regiões” está sendo editado. A descrição é “Regiões de vendas”, o tipo de dados é “Cadeia de caracteres” e o valor atual é “Central”. Os valores permitidos são definidos como “Lista”. A caixa “Exigir seleção em tempo de execução” está marcada.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_edit2.jpg) #### Redefinir valores padrão do parâmetro de usuário Para redefinir rapidamente o valor padrão do parâmetro, use o botão Definir. O botão mostra uma contagem indicando o número de lugares no fluxo onde o parâmetro é usado. Para destacar as etapas no fluxo que usam o parâmetro, clique em Visualizar no fluxo na caixa de diálogo do parâmetro. Se houver apenas um local onde o parâmetro é usado, você será levado diretamente para essa etapa com o painel de perfil aberto. 1. Execute um destes procedimentos: - No menu superior, selecione o ícone de parâmetro![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png). Use esta opção para redefinir valores de parâmetros usados em qualquer lugar no fluxo ou quando usados em filtros e campos calculados. ![A caixa de diálogo “Parâmetro” é aberta e a descrição de “Cadeia de caracteres qualquer” é “CoffeeChain”. A opção “Visualizar em fluxo” mostra que ele existe em 4 fluxos. A descrição da “Lista de cadeia de caracteres” é “Norte” e a opção “Exibir no fluxo” mostra que ela existe em 5 fluxos.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_edit3.jpg) - Selecione o parâmetro onde ele é aplicado no fluxo. Você pode usar essa opção para parâmetros usados em nomes de arquivos, caminhos de arquivos, nomes de tabelas, SQL personalizado e scripts SQL anteriores e posteriores. ![Uma caixa de diálogo com a Região definida como Central.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_set2.png) 2. Selecione ou insira o valor do parâmetro. 3. Selecione Definir para aplicar as alterações. ## Aplicar parâmetros ao seu fluxo Depois de criar os parâmetros de usuário, você pode aplicá-los a vários lugares em todo o seu fluxo, dependendo do tipo de etapa. Quando o fluxo é executado, os valores de parâmetro são aplicados a essa execução de fluxo para produzir a saída para o cenário de dados específico. Os parâmetros do sistema (versão 2023.2 e posterior) são gerados automaticamente quando você executa o fluxo. Basta aplicá-los ao nome da etapa de saída e toda vez que o fluxo for executado; o parâmetro será atualizado dinamicamente com a data ou hora de início da execução do fluxo. ### Aplicar parâmetros às etapas de entrada Em uma etapa de entrada, você pode usar parâmetros de usuário para substituir um nome de arquivo, seções do caminho de arquivo, um nome de tabela de banco de dados ou ao usar o SQL personalizado. #### Nome do arquivo ou caminho do arquivo _Esta opção não está disponível ao editar ou criar fluxos na Web._ Você pode incluir parâmetros de usuário no caminho do arquivo com algumas exceções. A partir da versão 2022.1.1, você também pode ver uma visualização dos valores dos parâmetros. **Exceções** - A partir da versão 2022.1.1, você pode agendar e executar fluxos na Web que incluem parâmetros no caminho do arquivo de entrada. Se estiver usando uma versão anterior, execute fluxos no Tableau Prep Builder ou na linha de comando. - Para incluir parâmetros no caminho do arquivo ao publicar fluxos na Web, é necessária uma conexão direta de arquivo. Caso contrário, o parâmetro é convertido em um valor estático usando o Valor atual. **Observação**: as conexões diretas de arquivos exigem que os locais dos arquivos sejam incluídos na lista segura de sua organização. Para obter mais informações, consulte [Locais de entrada e saída da lista de segurança](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm) na ajuda do Tableau Server. **Aplicar um parâmetro de usuário a um nome de arquivo ou caminho** 1. Na guia Configurações, no caminho do arquivo, coloque o cursor no local onde deseja adicionar o parâmetro. 2. Selecione o ícone ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) do parâmetro e o parâmetro a aplicar. ![A guia “Configurações” é selecionada e o ícone “Parâmetro” é escolhido. As opções listadas são “Regiões” e “Ano de vendas”](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_file2.png) 3. Veja uma visualização do valor do parâmetro. O valor atual (padrão) é mostrado na visualização. Você será solicitado a selecionar ou inserir o valor do parâmetro ao executar o fluxo. ![A guia “Configurações” é selecionada e os Detalhes da conexão, incluindo o local do arquivo, são exibidos.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_file_preview.jpg) #### Tabela de banco de dados Ao usar parâmetros de usuário em nomes de tabelas, todo o nome da tabela deve ser o parâmetro. O uso de parâmetros para partes de um nome de tabela não é suportado atualmente. **Observação**: o uso de um parâmetro para um nome de tabela em uma conexão de entrada do Google BigQuery ainda não é compatível. 1. Na guia Configurações, no campo Tabela, clique no menu suspenso. 2. Selecione Usar parâmetro e, em seguida, selecione o parâmetro na lista. ![O campo Tabela lista os retornos possíveis.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_table.png) #### SQL personalizado 1. No painel Conexões, clique em SQL personalizado. 2. Na guia SQL personalizado, digite ou cole a consulta na caixa de texto. 3. Selecione o ícone ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) do parâmetro e o parâmetro a aplicar. ![A guia “SQL personalizado” é selecionada, mostrando um editor de consulta SQL com a consulta “SELECT \* FROM \[dbo\]. \[Orders\] WHERE \[Orders\]." ](Img/prep_parameters_CustomSQL.png) 4. Selecione Executar para executar sua consulta. Você não será solicitado a inserir um valor de parâmetro até executar o fluxo. Em vez disso, a consulta será executada inicialmente usando o Valor atual do parâmetro. **Observação**: se o parâmetro for usado em outro lugar no fluxo e o Valor atual for redefinido, essa alteração poderá afetar sua consulta. ### Aplicar parâmetros de usuário às etapas de saída Em uma etapa de saída, você pode aplicar parâmetros de usuário aos seguintes locais: - Nome do arquivo - Seções do caminho do seu arquivo - Nome da fonte de dados publicada - Nome da tabela de banco de dados - Nome da planilha do Microsoft Excel (versão 2022.1.1 e posterior) - Scripts SQL personalizados executados antes ou depois de gravar dados de saída de fluxo em um banco de dados (versão 2022.1.1 e posterior) #### Nome do arquivo ou caminho do arquivo _Essa opção de saída não está disponível ao criar ou editar fluxos na web_ 1. No painel Saída, selecione Arquivo na lista suspensa Salvar saída em. 2. No campo Nome ou Local, clique no ícone de parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) e selecione seu parâmetro. Para o caminho do arquivo, coloque o cursor no local onde deseja adicionar o parâmetro. ![A caixa de diálogo “Salvar saída em” está definida como “Arquivo”.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_output_file_name2.png) Ao executar o fluxo, você será solicitado a inserir seus valores de parâmetro. #### Nome da fonte de dados publicada 1. No painel Saída, na lista suspensa Salvar saída em, selecione Fonte de dados publicada. 2. No campo Nome, clique no ícone do parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) e selecione seu parâmetro. ![A caixa de diálogo “Salvar saída em” é aberta. O ícone “Parâmetro” foi escolhido e um menu para escolher o parâmetro é aberto. ](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_output_pds_name.png) Ao executar o fluxo, você será solicitado a inserir seus valores de parâmetro. #### Tabela de banco de dados e antes e depois do SQL personalizado 1. Na guia Saída, na lista suspensa Salvar saída em, selecione Tabela de banco de dados. 2. No campo Tabela, selecione Usar parâmetro e, em seguida, selecione o parâmetro na lista. ![A caixa de diálogo “Salvar saída em” é definida como “Tabela de banco de dados”. A opção Tabela está aberta e “Usar parâmetro” está selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_output_table_name.png) 3. (Opcional) Clique na guia SQL personalizado. A partir da versão 2022.1.1, você pode inserir um script SQL com parâmetros para executar Antes e Depois que os dados forem gravados na tabela. Para incluir um parâmetro, clique em Inserir parâmetro e selecione seu parâmetro. Para obter mais informações sobre como usar scripts SQL ao gravar a saída em um banco de dados, consulte [Salvar dados de saída de fluxo em bancos de dados externos](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#write_to_DB). **Observação**: os parâmetros usados em scripts SQL devem ser excluídos manualmente. Consulte [Excluir parâmetros de usuário manualmente](#delete_earlier_version) para obter mais informações. ![A opção “Salvar saída em” está definida como “Tabela de banco de dados”. A guia “SQL personalizado” é selecionada e um parâmetro está sendo inserido.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_before_after_sql.jpg) Ao executar o fluxo, você será solicitado a inserir seus valores de parâmetro. ### Aplicar parâmetros de sistema às etapas de saída Em uma etapa de saída, você pode aplicar parâmetros do sistema de data e hora aos seguintes locais: - Nome do arquivo - Nome da fonte de dados publicada #### Nome do arquivo _Essa opção de saída não está disponível ao criar ou editar fluxos na web_ 1. No painel Saída, selecione Arquivo na lista suspensa Salvar saída em. 2. No campo Nome, clique no ícone de parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) e selecione um dos parâmetros de data de execução ou hora de execução a seguir. Você pode combinar vários parâmetros do sistema para criar qualquer carimbo de data/hora necessário. **Data de execução** - Data: AAAA-MM-DD, AAMMDD, DD-MM-AAAA - Mês: nome do mês, número do mês - Número da semana - Número do trimestre - Número do ano Hora de execução - AAAA-MM-DD\_HH-MM-SS (24 horas) - AAAAMMDD\_HHMMSS (24 horas) Quando você executa o fluxo, o Tableau Prep aplica a hora de execução inicial do fluxo usando seu fuso horário local ou o fuso horário do servidor. #### Nome da fonte de dados publicada 1. No painel Saída, na lista suspensa Salvar saída em, selecione Fonte de dados publicada. 2. No campo Nome, clique no ícone de parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) e selecione um dos parâmetros de data de execução ou hora de execução a seguir. Você pode combinar vários parâmetros do sistema para criar qualquer carimbo de data/hora necessário. **Data de execução** - Data: AAAA-MM-DD, AAMMDD, DD-MM-AAAA - Mês: nome do mês, número do mês - Número da semana - Número do trimestre - Número do ano Hora de execução - AAAA-MM-DD\_HH-MM-SS (24 horas) - AAAAMMDD\_HHMMSS (24 horas) Quando você executa o fluxo, o Tableau Prep aplica a hora de execução inicial do fluxo usando seu fuso horário local ou o fuso horário do servidor. ### Aplicar parâmetros de usuário para filtrar cálculos Use parâmetros de usuário para filtrar dados em todo o fluxo. Filtre seu conjunto de dados na etapa de entrada ou aplique parâmetros de filtro no nível de valor da etapa ou do campo. Por exemplo, use um parâmetro de filtro para inserir dados apenas para uma região específica ou filtrar dados em uma etapa para um departamento específico. **Observação**: a partir da versão 2022.1, você pode usar copiar e colar para reutilizar cálculos de filtro com parâmetros em outros fluxos quando houver o mesmo parâmetro com o mesmo nome e tipo de dados. 1. Na etapa Entrada ou na barra de ferramentas, no painel Perfil, clique em Filtrar valores. Para adicionar um filtro de parâmetro a um campo, no menu de opções Mais![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) selecione Filtros > Cálculo. 2. No editor de cálculo Adicionar Filtro, digite o nome do parâmetro para selecioná-lo na lista (o parâmetro é mostrado em roxo) e clique em Salvar para salvar o filtro. ![Caixa de diálogo “Adicionar filtro” com o cálculo “\[Region\]=\[Regions\]”.](Img/prep_parameters_filter.png) Ao executar o fluxo, você será solicitado a inserir seus valores de parâmetro. ### Aplicar parâmetros de usuário aos campos calculados Use parâmetros de usuário para substituir valores constantes em cálculos que você usa em todo o fluxo. Você pode aplicar parâmetros de cálculo no nível da etapa ou do valor do campo. **Observação**: a partir da versão 2022.1, você pode usar copiar e colar para reutilizar cálculos com parâmetros em outros fluxos quando houver o mesmo parâmetro com o mesmo nome e tipo de dados. 1. Na barra de ferramentas no painel de perfil, clique em Criar campo calculado. Para adicionar um parâmetro a um cálculo em um campo, no menu de opções Mais![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png), selecione Criar campo calculado > Cálculo personalizado. 2. No editor de cálculo Adicionar campo, insira nosso cálculo, digite o nome do parâmetro para selecioná-lo na lista e clique em Salvar para salvar seu cálculo. ![A caixa de diálogo “Adicionar campo” é aberta. O “Nome do campo” é “No ano da venda?” A área de cálculo mostra a fórmula YEAR(\[Order Date\]) = \[year of Sale\]. A caixa de diálogo confirma que o cálculo é válido e retorna o ano de uma determinada data como um inteiro. ](Img/prep_parameters_calc.png) Ao executar o fluxo, você será solicitado a inserir seus valores de parâmetro. ## Excluir parâmetros de usuário Para excluir parâmetros de usuário que você não precisa mais, clique em Excluir parâmetro na caixa de diálogo Editar parâmetro. Isso remove qualquer instância do parâmetro usado em todo o fluxo e a substitui pelo Valor atual do parâmetro. Essa ação não pode ser desfeita. **Observação**: as opções para excluir parâmetros em um fluxo variam de acordo com sua versão. Use as instruções abaixo para a versão 2022.1 e posterior. Use [Excluir parâmetros de usuário manualmente](#delete_earlier_version) para versões anteriores e para excluir parâmetros usados em scripts de SQL personalizados executados antes ou depois de gravar a saída em um banco de dados. 1. No menu superior, clique no menu suspenso do ícone do parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png) e clique em Editar parâmetro para o parâmetro que deseja excluir. 2. Na caixa de diálogo Editar parâmetro, clique em Excluir parâmetro. ![A caixa de diálogo “Editar parâmetro” é aberta e o botão “Excluir parâmetro” é selecionado. ](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_delete.png) 3. Na caixa de diálogo de confirmação, selecione Excluir parâmetro novamente. Você pode clicar em Exibir no fluxo para destacar as etapas e investigar onde o parâmetro é usado antes de excluí-lo. ![A caixa de diálogo de confirmação “Excluir parâmetro” é aberta e a descrição diz “Tem certeza de que deseja excluir o parâmetro? Duas instâncias do parâmetro serão removidas do fluxo e substituídas pelo valor atual ‘Sul’.” A caixa de diálogo exibe o nome do parâmetro “Região” e a opção para visualizar as 2 instâncias do parâmetro é selecionada.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_delete3.jpg) Excluir parâmetros de usuário manualmente _Aplica-se à versão 2021.4.4 e anterior e aos parâmetros usados em scripts do SQL personalizado anteriores e posteriores_ Para excluir um parâmetro de usuário da sua lista de parâmetros, primeiro localize e remova todas as instâncias dos parâmetros do seu fluxo, mesmo do painel Alterações. 1. No menu superior, clique no menu suspenso do ícone do parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png). 2. Para o parâmetro que deseja excluir, clique em Visualizar no fluxo para localizar todas as instâncias em que o parâmetro é usado no fluxo. Se o parâmetro não for usado em nenhum lugar do fluxo, pule para a etapa 4. 3. Para cada etapa em que o parâmetro é usado, remova o parâmetro, incluindo a exclusão de quaisquer alterações listadas no painel Alterações. 4. No menu superior, clique no menu suspenso do ícone de parâmetro ![Ícone de parâmetros do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_icon.png)e para o parâmetro que deseja excluir, clique em Editar parâmetro. 5. Na caixa de diálogo Editar parâmetro, clique em Excluir parâmetro. ![A caixa de diálogo “Editar parâmetro” é aberta e o botão “Excluir parâmetro” é selecionado. ](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_delete.png) O parâmetro será substituído pelo Valor atual do parâmetro. ## Executar fluxos com parâmetros Fluxos em execução que incluem parâmetros são iguais aos fluxos em execução que não os têm, exceto que os usuários são solicitados a inserir valores de parâmetros de usuário em tempo de execução ou ao adicionar o fluxo a uma agenda no Tableau Server ou Tableau Cloud. Os parâmetros do sistema são aplicados automaticamente quando o fluxo é executado. Se um parâmetro de usuário for marcado como obrigatório, os usuários deverão inserir um valor para que possam executar o fluxo. Se um parâmetro for opcional, os usuários poderão inserir um valor ou aceitar o Valor atual do parâmetro por padrão. Os parâmetros obrigatórios são aqueles que têm a caixa de seleção Exigir seleção em tempo de execução (Solicitar valor em tempo de execução em liberações anteriores) marcada. ![Caixa de diálogo Editar Parâmetro do Tableau com opções para definir o parâmetro “Região”. A caixa “Exigir seleção em tempo de execução” está marcada.](/tableau/current/pt-br/prep/pt-br/Img/prep_parameter_required.png) Se você executar fluxos usando a interface de linha de comando e desejar substituir os valores de parâmetro atuais (padrão), crie um arquivo de substituição de parâmetros .json e inclua a sintaxe -p --parameters na linha de comando. Para obter mais informações, consulte [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm). ### Executar fluxos manualmente Quando você executa um fluxo do Tableau Prep Builder ou manualmente no Tableau Server ou Tableau Cloud, a caixa de diálogos Parâmetros é aberta quando você clica em Executar. 1. Insira ou selecione os valores de parâmetro de usuário. Se houver parâmetros opcionais no fluxo, você poderá inserir os valores neste momento ou aceitar o valor do parâmetro atual (padrão). 2. Clique em Executar fluxo para executar o fluxo. ![A caixa de diálogo “Parâmetros” com dois parâmetros obrigatórios: Regiões e Anos](/tableau/current/pt-br/prep/pt-br/Img/prep_parameters_required_run.png) Para obter mais informações sobre a execução de fluxos, consulte [Publicar um fluxo no Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#run_flows). ### Executar fluxos em um cronograma Quando você agendar fluxos para execução no Tableau Server ou no Tableau Cloud, precisará inserir todos os valores de parâmetro de usuário necessários ao agendar os fluxos. 1. Na guia Novas Tarefas ou Tarefas Vinculadas, na seção Definir Parâmetros, insira ou selecione os valores dos parâmetros. Se houver parâmetros opcionais no fluxo, você pode inserir os valores neste momento ou deixar o campo vazio para usar o valor do parâmetro atual (padrão). 2. Clique em Criar tarefas para agendar o fluxo. [Pular para o conteúdo principal](#main-content) # Criar fluxos do Tableau Prep com o Tableau Agent > [!WARNING] > > A partir de 14 de outubro de 2025, o Data Cloud foi renomeado como Data 360. Durante essa transição, você pode ver referências a Data Cloud em nosso aplicativo e documentação. Embora o nome seja novo, a funcionalidade e o conteúdo permanecem inalterados. _Com suporte no Tableau Prep Builder e na criação na Web do Tableau Prep no Tableau Cloud versão 2025.2 e posterior e no Tableau Server versão 2025.3 e posterior._ O Tableau Agent no Tableau Prep é um recurso generativo de IA que pode ajudar a limpar e transformar seus dados. Em versões anteriores, você podia usar o Tableau Agent para ajudar a criar campos calculados conforme criava seu fluxo. A partir da versão 2025.2, você pode usar o Tableau Agent para ajudar a limpar seus dados e criar seu fluxo, além de obter ajuda para criar campos calculados. Esse recurso está disponível no Tableau Prep Builder e na criação na Web do Tableau Prep no Tableau Cloud e no Tableau Server (versão 2025.3 e posterior). Para usar o Tableau Agent, basta descrever o que deseja fazer usando linguagem natural, como "Dividir o campo Detalhes do voo em campos separados para voo, data, classe e preço" ou "Alterar os valores do campo Data do pedido para mês". O Tableau Agent retorna um resumo sobre como realizar sua tarefa e um conjunto sugerido de etapas que você pode aplicar ao seu fluxo, até mesmo criando cálculos, se necessário. ![O Tableau Agent no Tableau Prep mostrando um plano para limpar dados em um fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_plan_superstore.png) Como o human-in-the-loop, você pode revisar as etapas sugeridas e aplicar cada uma individualmente ou aplicar todas as etapas do plano. O Tableau Agent executa as etapas para você, criando seu fluxo e adicionando as mudanças ao painel Alterações. Você pode interagir manualmente com qualquer alteração que o Tableau Agent fizer, como editar um cálculo ou usar Desfazer ou Refazer, para que esteja sempre no controle do fluxo. ![O Tableau Agent no Tableau Prep mostrando as etapas e alterações aplicadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_plan_superstore_applied.png) O Tableau Agent pode executar uma única ação (por exemplo, criando um campo calculado) ou ações mais complexas que exigem várias etapas. Dependendo de quais ações são necessárias para concluir a tarefa, o Tableau Agent mostrará a única ação que você pode revisar e aplicar ou retornará um plano quando ações mais complexas e várias etapas forem necessárias. O Tableau Agent tem um máximo de 10 etapas. Se a ação exigir mais de 10 etapas para ser concluída, divida sua solicitação em várias perguntas. O Tableau Agent oferece suporte ao inglês (en\_US) e a um subconjunto de outros idiomas. Ao usar o Tableau Agent no Tableau Cloud ou no Tableau Server (versão 2025.3 e posterior), o idioma usado na resposta da IA generativa é baseado no Idioma definido nas Minhas configurações de conta. Se a definição nas Minhas configurações de conta está configurado para Não especificado, a configuração de idioma do navegador é usada. Ao usar o Tableau Agent no Tableau Desktop e no Tableau Prep Builder, o idioma usado na resposta de IA generativa é baseado no idioma selecionado no menu Ajuda > Escolher idioma. Para obter mais informações sobre os idiomas suportados, consulte [Idiomas e localidades compatíveis com a IA no Tableau](https://help.tableau.com/current/tableau/pt-br/tableau_gai_einstein_trust.htm#supported_language). ## Tableau Agent e Confiança O Tableau Agent no Tableau Cloud foi desenvolvido com base na [Camada de confiança do Einstein](https://help.tableau.com/current/tableau/pt-br/tableau_gai_einstein_trust_layer.htm) e herda todos os seus recursos de segurança, governança e confiança. À medida que você interage com o Tableau Agent, nem seus dados nem suas conversas enviadas para o Modelo de linguagem grande (LLM) são salvos no LLM, e nenhum dado do cliente é usado para treinar o modelo. Quando você faz uma solicitação no Tableau Prep, ela é enviada para um modelo de prompt criado pelo Tableau. O modelo de prompt solicita que o LLM crie um plano ou um conjunto de etapas para realizar sua tarefa, para que você possa revisar as etapas sugeridas que o Tableau Agent retorna antes de aplicá-las ao seu fluxo. O Tableau Agent funciona apenas com as fontes de dados às quais seu fluxo está conectado e, no caso do Tableau Prep, apenas os dados da tabela da etapa selecionada são enviados para o prompt e LLM, não todos os dados no seu fluxo. O Tableau Agent não tem conhecimento de outra fonte de dados do Tableau, portanto, não pode sugerir conteúdo relevante, responder perguntas sobre linhagem de dados ou responder perguntas de conhecimento geral. As políticas definidas pelo usuário para segurança em nível de linha e coluna são respeitadas. Os dados aos quais um usuário tem acesso ao usar o Tableau Agent estão em conformidade com quaisquer políticas de segurança em nível de linha ou coluna que você tenha em vigor. Quando você abre o Tableau Agent pela primeira vez, ele indexa seus dados para entender o contexto. Isso ajuda o Tableau Agent a retornar resultados relevantes com base nas suas perguntas e na sua fonte de dados. As informações que ele indexa incluem nomes de colunas e tipo de dados e 5 linhas de exemplo da tabela referenciada na etapa de fluxo. A Camada de confiança do Einstein pode ser usada para mascarar Informações de Identificação Pessoal (PII) antes que elas sejam enviadas ao LLM usando o mascaramento de dados baseado em padrões. Usando técnicas de aprendizado de máquina e correspondência de padrões, as PII em solicitações são substituídas por tokens genéricos e desmascaradas com valores originais na resposta. Para obter mais informações sobre como configurar o mascaramento de dados, consulte [Selecionar dados a serem mascarados](https://help.salesforce.com/s/articleView?id=ai.generative_ai_mask_select.htm&type=5) na Ajuda do Salesforce. Para obter uma camada adicional de proteção, a Camada de confiança do Einstein garante que, depois que a solicitação e a resposta forem processadas pelo LLM, o LLM esqueça tanto a solicitação quanto a resposta. Se você estiver usando o Tableau Agent no Tableau Server (versão 2025.3 e posterior), ele não usará a camada de confiança do Einstein. Em vez disso, você se conecta diretamente ao provedor do modelo de linguagem grande. Para obter mais informações, consulte [IA no Tableau e confiança](https://help.tableau.com/current/tableau/pt-br/tableau_gai_einstein_trust.htm). ## Considerações sobre cobrança do Tableau Agent **Observação**: a partir de outubro de 2025, a IA no Tableau não consome mais créditos de solicitação do Einstein para uso de IA. Outros serviços, como Data 360, ainda podem consumir outros tipos de créditos. Os créditos do Data 360 incluem créditos de serviço de dados e Flex. O tipo e o número de créditos consumidos variam de acordo com o modelo de crédito escolhido para sua organização do Salesforce. Para obter mais informações, consulte [Perguntas frequentes sobre solicitação do Einstein e atualizações de cartões de taxa de crédito Flex](https://help.salesforce.com/s/articleView?id=005197697&type=1) e [Considerações de cobrança para auditoria e feedback](https://help.salesforce.com/s/articleView?id=ai.generative_ai_audit_feedback_usage_types.htm&type=5) na Central de Ajuda do Salesforce. Quando você usar recursos de IA generativa no Tableau no Tableau Cloud, ele poderá consumir créditos de Data 360 se você estiver usando o recurso de coleta e armazenamento de dados do Einstein (também conhecido como trilha de auditoria) como parte de sua configuração de IA no Tableau. Para obter mais informações, consulte [Uso da IA no Tableau](https://help.tableau.com/current/tableau/pt-br/tableau_gai_usage.htm). Você pode visualizar o consumo de crédito na sua organização do Salesforce usando painéis pré-criados e a Carteira Digital, ou conectar-se aos dados do Data 360 do Tableau e criar visualizações usando os dados das tabelas da Carteira Digital. Para obter mais informações, consulte [Exibir consumo de crédito](https://help.tableau.com/current/tableau/pt-br/tableau_gai_usage_view.htm). ## Ações compatíveis do Tableau Agent no Tableau Prep O Tableau Agent ainda não tem acesso a todos os recursos do Tableau Prep, mas você ainda pode interagir com o fluxo para realizar essas ações manualmente. Por exemplo, o Tableau Agent só pode criar um fluxo linearmente no momento. Se você precisar ramificar seu fluxo, precisará fazer isso manualmente. Veja abaixo a lista de ações de transformação compatíveis com o Tableau Agent atualmente. Para obter informações sobre as limitações do Tableau Agent, consulte [Limitações do Tableau Agent no Tableau Prep](#Tableau) posteriormente neste tópico.
Ação de transformaçãoCompatível com o Tableau Agent

Examinar os dados

  • Filtrar dados

    • Criar cálculos de filtro (como parte de um plano de fluxo)

    • Filtrar valores nulos

    • Filtrar valores por intervalo de data e hora

    • Filtrar valores por filtro de data relativa

  • Remover campos

  • Alterar tipos de dados

Limpar e formatar dados
  • Operações de limpeza rápidas

    • Tornar as letras maiúsculas

    • Tornar as letras minúsculas

    • Criar capitalização de título

    • Remover todos os espaços

    • Remover espaços adicionais

    • Remover letras

    • Remover números

    • Remover toda a pontuação

    • Cortar espaços

  • Criar cálculos (individualmente ou como parte de um plano de fluxo)

  • Renomear campos

  • Converter formato de data

  • Dividir valores

  • Identificar linhas duplicadas

  • Preencher lacunas em dados sequenciais

    • Etapa Criar novas linhas para gerar as linhas ausentes e definir opções de configuração

Dinamizar os dados
  • Dinamizar colunas para linhas

  • Dinamizar linhas para colunas

Agregar, unir colunas ou linhas de dados
  • Criar etapas de agregação

  • Agregar e agrupar valores como parte da etapa de agregação

## Introdução ao Tableau Agent O Tableau Agent está disponível por meio de um painel de conversação no ambiente de criação na Web de um site do Tableau Cloud ou do Tableau Server (a partir da versão 2025.3) ou no Tableau Prep Builder quando você está conectado a um site do Tableau Cloud ou do Tableau Server configurado para habilitar o Tableau Agent. Para acessar o Tableau Agent: - **Tableau Cloud**: entre em um site do Tableau Cloud que tenha o Tableau+ e uma conexão com uma organização do Salesforce com IA generativa do Einstein configurada para usar o Tableau Agent no Tableau Prep. Também é necessário ter permissões para acessar o Tableau Agent. Para obter mais informações, consulte [Ativar a IA no Tableau para seu site](https://help.tableau.com/current/online/pt-br/setup_tabAI_site_setting.htm). - Se você não tem o Tableau+, mas quer experimentar o Tableau Agent, [inscreva-se](https://www.tableau.com/pt-br/products/trial) em uma avaliação gratuita do Tableau Cloud que agora inclui recursos do Tableau Agent. - **Tableau Server** (versão 2025.3 e posterior): faça logon em um site do Tableau Server com a IA no Tableau configurada e ativada para o Tableau Prep. Para obter mais informações, consulte [Ativar a IA no seu site do Tableau Server](https://help.tableau.com/current/server/pt-br/sites_gai_server.htm). - **Tableau Prep Builder**: faça logon em um site do Tableau Cloud com o Tableau+ ou em um site do Tableau Server. A IA no Tableau também deve ser ativada para o Tableau Prep. O Tableau Agent não consegue se conectar às suas fontes de dados, trazer mais dados para você, otimizar a amostragem ou criar etapas de entrada. Portanto, comece conectando-se aos seus dados e trazendo as tabelas com as quais deseja trabalhar para a canvas Fluxo. ### Inicie o Tableau Agent Você pode iniciar o Tableau Agent na barra de ferramentas no Tableau Prep Builder, na criação na Web do Tableau Prep no Tableau Cloud ou Tableau Server (versão 2025.3 e posterior) ou na caixa de diálogo de cálculo. Para obter mais informações sobre como iniciar o Tableau Agent na caixa de diálogo de cálculo, consulte [Criar campos calculados com o Tableau Agent](#Create) neste tópico. 1. No painel Fluxo, selecione o ícone do Tableau Agent na barra de ferramentas ao lado de Alertas. **Observação**: se você não vir o ícone, verifique se está conectado a um site do Tableau Cloud (Servidor > Entrar no Tableau Prep Builder) ou a um site do Tableau Server e que a IA no Tableau Prep esteja ativada. O Tableau Cloud requer o Tableau+ e você também deve ter permissões para usar o Tableau Agent. ![O painel Fluxo do Tableau Prep mostrando o ícone do Tableau Agent](/tableau/current/pt-br/prep/pt-br/Img/prep_en_tab_agent_icon.png) 2. Quando o painel abrir, selecione Entendi para reconhecer a isenção de responsabilidade e começar. Talvez você precise rolar a tela para baixo para ver o botão. ![A página Fluxo do Tableau Prep mostrando o painel do Tableau Agent.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_tab_agent_launch.png) ### Limpar e preparar dados com o Tableau Agent _O exemplo nesta seção usa dados de um desafio realizado por [Preppin Data](https://www.preppindata.com/challenges)._ O Tableau Agent não é um chatbot‌ aberto. Ele funciona apenas dentro do seu conjunto de dados e executa um conjunto específico de ações relacionadas à limpeza e transformação dos dados no seu fluxo. Por exemplo, o Tableau Agent pode ajudar a dividir campos, dinamizar ou agregar seus dados, mas não pode responder a perguntas abertas, como "Conte-me sobre este fluxo" ou "Conte-me mais sobre a tabela Pedidos". **Observação**: no momento, o Tableau Agent não pode executar o fluxo ou agendá-lo para executar, criar etapas de saída ou ajudar com determinados tipos de etapas, como etapas de União de colunas, União de linhas, Script ou Previsão. Para obter mais informações, consulte [Limitações do Tableau Agent no Tableau Prep](#Tableau). 1. No painel Fluxo, selecione a etapa em que deseja que o Tableau Agent aplique a ação de limpeza. Selecione uma entrada, limpeza ou outro tipo de etapa compatível. Atualmente, o Tableau Agent funciona com base em uma etapa específica, portanto, você precisará primeiro selecionar a etapa onde deseja executar uma ação. Se quiser realizar operações de limpeza em tabelas que existem em etapas separadas, você precisará fazer isso uma etapa de cada vez. 2. No painel do Tableau Agent, descreva a ação que você deseja que o Tableau Agent ajude a realizar. ![Um fluxo do Tableau Prep com o painel do Tableau Agent aberto mostrando uma ação solicitada.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_request.png) > [!TIP] > > **Dica**: para obter os melhores resultados do Tableau Agent, seja específico em sua solicitação e forneça o máximo de detalhes possível para ajudar o Tableau Agent a entender o contexto. Neste exemplo, nosso valor de campo usa dois delimitadores diferentes. Ao incluir essas informações na solicitação "**Você pode dividir o campo Detalhes do voo para que eu tenha campos separados para Data, Número do voo, De, Para, Classe e Preço? No campo Detalhes do voo, os dados "de" e "para" aparecem com um traço. Por exemplo, "Tóquio-Nova Iorque".** O Tableau Agent pode entender melhor a solicitação e sugerir as ações corretas. 3. Quando sua solicitação estiver pronta, clique na seta na caixa de texto para passá-la ao Tableau Agent. O Tableau Agent indexa os dados na etapa selecionada para avaliar sua solicitação em relação aos dados. Em seguida, a solicitação é passada para um modelo de prompt, que é então passado para o LLM para processar e retornar um plano. 4. Revise as etapas no plano expandindo cada etapa. ![O fluxo do Tableau Prep que mostra o painel do Tableau Agent retornando um plano para dividir um campo.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_plan.png) 5. Clique em Aplicar para aplicar cada etapa individualmente ou clique em Aplicar tudo e o Tableau Agent aplicará todas as etapas no plano. ![Um fluxo do Tableau Prep com o painel do Tableau Agent aberto, mostrando todas as etapas do plano aplicadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_plan_apply_all.png) 6. Avalie o resultado para ter certeza de que o Tableau Agent fez o que você esperava. Uma marca de seleção verde aparece ao lado de cada etapa que foi concluída com êxito. Você pode avaliar e modificar quaisquer alterações listadas no painel Alterações, bem como atualizar a descrição adicionada à etapa no painel Fluxo. 7. Continue pedindo ao Tableau Agent para ajudar você a limpar seus dados e, em seguida, adicione uma etapa de Saída para concluir o fluxo. ![Um fluxo do Tableau Prep com o Tableau Agent aberto mostrando a próxima solicitação e resposta de ação.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_plan_next_request.png) ## Criar campos calculados com o Tableau Agent _Com suporte na criação na Web do Tableau Prep no Tableau Cloud, no Tableau Server versão 2025.3 e posterior e no Tableau Prep Builder versão 2025.2 e posterior._ Criar campos calculados está mais fácil do que nunca com o Tableau Agent. Inicie o Tableau Agent na caixa de diálogo Cálculo e descreva um cálculo, e o Tableau Agent criará a fórmula, permitindo que você adicione campos calculados poderosos aos seus fluxos do Prep com um único clique. Anteriormente, a criação de fórmulas para campos calculados exigia uma compreensão de objetos e campos, funções disponíveis e diversas limitações baseadas em tipos de dados, tipos de fórmulas e muito mais. O Tableau Agent simplifica muito a tarefa de criação de funções personalizadas. O Tableau Agent permite que usuários técnicos e não técnicos criem cálculos facilmente usando linguagem simples. Com a capacidade de criar campos de fórmula de resumo e de nível de linha de forma rápida e eficiente a partir de descrições em linguagem natural, você pode realizar a preparação de dados, tornando mais fácil e rápido combinar, moldar e limpar dados para análise. ## Criar campos calculados **Observação**: a partir da versão 2025.2, quando você pedir ajuda ao Tableau Agent com um cálculo, ele abrirá um painel de conversa para você fazer perguntas, em vez de permitir que você faça perguntas diretamente na caixa de diálogo Cálculo. 1. No painel Fluxo, clique em uma etapa limpa. 2. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![A caixa de diálogo Cálculo do Tableau Prep mostra o botão Criar com o Tableau Agent.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_calc_agent_256.png) 3. Clique em Criar com o Tableau Agent. A caixa de diálogo de cálculo será fechada, e o painel do Tableau Agent será aberto. 4. No painel Conversa, selecione Entendi para reconhecer o aviso de isenção de responsabilidade e começar. ![Página de fluxo do Tableau Prep com o painel do Tableau Agent e a mensagem de boas-vindas exibida.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_pane_welcome.png) 5. Como você abriu o Tableau Agent na caixa de diálogo de cálculo, ele já foi preenchido com seus dados. Na caixa de texto do Tableau Agent, descreva o cálculo desejado. Forneça o máximo de detalhes possível para obter os melhores resultados. ![O fluxo do Tableau Prep mostra o Tableau Agent com uma solicitação de cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_dialog_request.png) 6. Quando sua solicitação estiver pronta, clique na seta na caixa de texto para passá-la ao Tableau Agent. ![O fluxo do Tableau Prep mostra o Tableau Agent com uma resposta a uma solicitação de cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_dialog_response.png) **Observação**: se o Tableau Agent não puder fornecer um cálculo válido, você poderá fornecer feedback. 7. Avalie o resultado para ter certeza de que é o que você deseja. Clique em Editar para abrir a caixa de diálogo de cálculo e personalizar o cálculo manualmente e aplicá-lo ou clique em Aplicar e o Tableau Agent adiciona o cálculo ao seu fluxo. ![O fluxo do Tableau Prep com o Tableau Agent aplica um novo campo calculado.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_dialog_applied.png) ### Exemplos de cálculo **Observação**: às vezes, o Tableau Agent mostrará o cálculo sugerido no painel do Tableau Agent para você revisar e aplicar e, às vezes, mostrará apenas uma descrição resumida que você pode aplicar e, em seguida, revisar e editar no painel Alterações. #### Exemplo de cálculo 1: Prompt: _Escreva um cálculo para encontrar o nome do mês para pedidos no campo Data do pedido._ ![O painel do Tableau Agent mostra um cálculo sugerido para extrair o nome do mês do campo Data do pedido.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_ex1.png) ![A caixa de diálogo de cálculo mostra o cálculo resultante do Tableau Agent.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_dialog_result_ex1.png) ![](/tableau/current/pt-br/prep/pt-br/Img/prep_en_calc_month.png) #### Exemplo de cálculo 2: Prompt: _Escreva um cálculo para limitar os valores no campo Quantidade a um valor máximo de 10._ ![O Tableau Agent mostra um cálculo sugerido para limitar os valores no campo Quantidade a um máximo de 10. ](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_ex2.png) Neste exemplo, um prompt adicional é adicionado para refinar os cálculos para manter os valores acima do limite. Prompt: _Se a quantidade estiver acima de 10, substitua pelo texto “Acima do limite” e mantenha os valores originais._ ![O Tableau Agent mostra uma iteração do prompt para refinar os resultados do cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_ex3.png) ![O resultado do Tableau Agent aplica o cálculo refinado para Quantidade limitada.](/tableau/current/pt-br/prep/pt-br/Img/prep_en_agent_calc_result_ex3.png) ## Dicas para obter os melhores resultados O Tableau Agent faz o possível para entender sua intenção e seus dados. Mas ainda está aprendendo. Use as dicas a seguir para ajudar o Tableau Agent a fazer o melhor e entregar ótimos resultados para você.
DicaProblemaO que fazer
Seja explícito com sua intençãoO Tableau Agent faz o possível para inferir sua intenção, mas nem sempre acerta.Se você deseja que o Tableau Agent divida um campo, informe quais campos deseja que ele crie. Como alternativa, se desejar que o Tableau Agent crie um cálculo, tente iniciar sua solicitação com a frase “Criar um cálculo que...”
Oculte campos não utilizadosCampos com nomes semelhantes em seu conjunto de dados podem ser confusos para o Tableau Agent.Oculte campos que você não precisa, e o Tableau Agent não usará esses campos ocultos.
Cuidado com sinônimosO Tableau Agent faz um bom trabalho ao compreender sinônimos comuns. Por exemplo, saberia que “títulos” e “filmes” poderiam ser aplicados a um campo denominado “filmes”. No entanto, ele não conhece nenhuma terminologia ou siglas específicas da sua empresa que você possa usar.Consulte os campos específicos de seu interesse para ajudar o Tableau Agent a ser mais preciso.
Use uma terminologia específica em suas solicitaçõesO Tableau Agent pode verificar sua fonte de dados em busca de nomes de campos e dados nesses campos, mas não entende verdadeiramente os dados da mesma forma que um ser humano consegue.Quanto mais descritivo você for em sua solicitação, melhor será o Tableau Agent em fornecer a resposta certa.
Divida tarefas complexasO Tableau Agent pode criar um plano gradativo, mas pode ter dificuldades para concluir várias tarefas complexas em um plano grande.

Divida nossas tarefas em partes e faça a iteração. Por exemplo:

  • <Task 1=""> "Divida o campo Voo em "Voo", "Data", "Preço" e "Destino".

  • <Task 2=""> "Altere o tipo de dados de "Preço" para decimal e o campo "Data" para Data e hora"

Apenas faz perguntas sobre seus dadosO Tableau Agent não é um chatbot de uso geral. Não pode responder a perguntas de consultoria como “como devo limpar meus dados?” ou perguntas gerais como “qual raça de gato é o melhor animal de estimação?”Faça perguntas direcionadas à execução de ações de limpeza específicas em seus dados e à iteração nos resultados.
## Ajude o Tableau Agent a melhorar O Tableau Agent ainda está aprendendo. Por exemplo, alguns cálculos criados pelo Tableau Agent não serão escritos da maneira que você esperava. Quando isso acontece, seu feedback sobre o que há de errado ajuda o Tableau Agent a continuar aprimorando suas operações de limpeza e a criar cálculos cada vez mais precisos. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_en_calc_feedback.png) ## Limitações do Tableau Agent no Tableau Prep O Tableau fornece ferramentas poderosas para o analista humano, e o Tableau Agent não é diferente. A IA no Tableau não pretende substituir analistas e exploradores de dados; ele está aqui para ajudar você. Sua participação no processo é crucial. ### Tipos de análises O Tableau Agent ainda não consegue gerenciar perguntas do tipo consultivo, como "O que esse fluxo faz?", "Você pode explicar este cálculo?" ou ajudá-lo a solucionar problemas do fluxo, como "Como corrigir este erro?" Em vez disso, peça que ele ajude você a executar tarefas de limpeza específicas, como "Extrair o código do banco do código de transação." ou "Somar as transações por banco por mês". ### Recursos não compatíveis Atualmente, o Tableau Agent pode aceitar muitas das operações de limpeza comuns que você precisa. Mas está apenas começando. Aqui estão algumas das operações às quais ele ainda não pode oferecer suporte. No entanto, você sempre pode interagir com o fluxo e executar qualquer uma dessas tarefas manualmente. - Escolher uma fonte de dados para você ou adicionar dados ao fluxo como uniões de entrada - Fazer modelagem de dados, como uniões de colunas e de linhas - Não pode oferecer suporte a alguns tipos de etapas, como previsões, scripts e etapas de saída - Fornecer uma resposta que exija a análise de mais de 1 etapa no fluxo - Ramificar o fluxo. Atualmente, o Tableau Agent só pode criar etapas lineares. - Otimizar o fluxo (ajuda com amostragem de dados ou desempenho) - Não pode oferecer suporte a alguns recursos (parâmetros, recomendações, dinamização usando pesquisa curinga etc.) - Executar ou programar o fluxo - Compatível com todos os idiomas. O Tableau Agent oferece suporte ao inglês (en\_US) e a um subconjunto de outros idiomas. Se os nomes e valores dos campos da fonte de dados não estiverem no mesmo idioma das configurações de idioma do usuário ou não forem iguais ao idioma no qual você está interagindo com o Agent, use o nome e os valores exatos dos campos em suas solicitações. Para obter informações sobre os idiomas com suporte atual do Tableau Agent, consulte [Idiomas e localidades compatíveis com IA no Tableau](https://help.tableau.com/current/tableau/pt-br/tableau_gai_einstein_trust.htm#supported_language). [Pular para o conteúdo principal](#main-content) # Criar nível de detalhe, classificação e cálculos de bloco **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Você pode usar campos calculados para criar novos dados usando dados que já existem em sua fonte de dados. O Tableau Prep suporta muitos dos mesmos tipos de cálculo que o Tableau Desktop. Para obter informações gerais sobre a criação de cálculos, consulte [Introdução a cálculos no Tableau](https://help.tableau.com/current/pro/desktop/pt-br/calculations_calculatedfields_create.htm). **Observação**: ao criar um campo calculado, não utilize o nome reservado “Número de Registros”. Usar esse nome reservado resultará em um erro relacionado à permissão. A partir da versão 2020.1.3 do Tableau Prep Builder, e na Web, você pode usar as funções analíticas de Nível de Detalhes (LOD) FIXED e RANK e ROW\_NUMBER para realizar cálculos mais complexos. Por exemplo, adicione um cálculo de LOD FIXED para alterar a granularidade dos campos em sua tabela, use a função analítica ROW\_NUMBER () para encontrar rapidamente linhas duplicadas, ou use uma das funções RANK () para encontrar os principais valores N ou N inferior para uma seleção de linhas com dados semelhantes. Se você quer uma experiência mais guiada ao construir esses tipos de expressões, pode usar o editor de cálculo visual. A partir da versão 2021.4.1Tableau Prep Builder e na Web, você pode usar o recurso de bloco para distribuir linhas em um número especificado de grupos. **Observação**: algumas funções suportadas pelo Tableau Desktop ainda não podem ser suportadas no Tableau Prep. Para ver as funções disponíveis no Tableau Prep, revise a lista de funções no editor de cálculo. ## Calcular o nível de detalhe Quando você precisa calcular dados em vários níveis de granularidade na mesma tabela, você pode escrever um nível de expressão Detalhe (LOD) para fazer isso. Por exemplo, se você quiser encontrar as vendas totais para cada região, poderá escrever um cálculo como `{FIXED [Region] : SUM([Sales])}`. O Tableau Prep suporta o nível FIXED de expressão detalhada e usa a sintaxe `{FIXED [Field1],[Field2] : Aggregation([Field)}`. As expressões de LOD têm duas partes para a equação que são separadas por dois pontos. - **FIXED \[Field\]**(obrigatório): esse é o campo ou campos para os quais você deseja calcular os valores. Por exemplo, se você quisesse encontrar as vendas totais para cliente e região, digitaria `FIXED [Customer ID], [Region]:`. Se você não selecionar nenhum campo, isso equivale a realizar a agregação definida no lado direito dos dois pontos e repetir esse valor para cada linha. - **Agregação (\[Field\])** (obrigatório): selecione o que você deseja calcular e que nível de agregação você deseja. Por exemplo, se você quiser encontrar as vendas totais, digite `SUM([Sales]`. Ao usar esse recurso no Tableau Prep, os seguintes requisitos se aplicam: - As expressão de LOD `INCLUDE` e `EXCLUDE` não são aceitas. - Os cálculos de agregação só são aceitos dentro de uma expressão de LOD. Por exemplo, `SUM([Sales])` não seria válido, mas `{FIXED [Region] : SUM([Sales])}` é válido. - Fazer expressões dentro de uma expressão de LOD não é aceito Por exemplo, `{ FIXED [Region] : AVG( [Sales] ) / SUM( [Profit] )}` não é aceito. - Não é aceito combinar uma expressão de LOD com outra expressão. Por exemplo, `[Sales]/{ FIXED [Country / Region]:SUM([Sales])}` não é aceito. ### Criar cálculos de Nível de Detalhe (LOD) Para criar um cálculo de detalhes, você pode usar o editor de cálculo para escrever o cálculo ou, se você quiser uma experiência mais guiada, poderá usar o editor de Cálculo Visual para selecionar seus campos e o Tableau Prep escreve o cálculo para você. #### Editor de cálculo 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![O menu Mais opções com a opção de criar um cálculo personalizado.](/tableau/current/pt-br/prep/pt-br/Img/prep_lod_rank_menu_tile.png) 2. No editor de cálculo, digite um nome para o seu cálculo e a expressão. Por exemplo, para encontrar os dias médios para enviar produtos pela cidade, crie um cálculo como o mostrado abaixo. ![A caixa de diálogo Editor de cálculo mostrando a sintaxe de cálculo para calcular a média de dias para envio por produto.](/tableau/current/pt-br/prep/pt-br/Img/prep_LOD_expression_example2.png) #### Editor de cálculo visual Selecione campos de uma lista e o Tableau Prep cria o cálculo para você durante as suas seleções. Uma prévia dos resultados é mostrada no painel esquerdo, para que você possa ver os resultados de suas seleções. 1. Em um painel de placa de perfil ou resultados, clique no meni Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado \>LOD fixo. ![Um menu exibindo opções para um campo calculado.](/tableau/current/pt-br/prep/pt-br/Img/prep_LOD_visual_menu_tile.png) 2. No editor de Cálculo visual, faça o seguinte: - Na seção Agrupar por , selecione os campos para os quais deseja calcular os valores. O campo em que você selecionou a opção de menu Criar campo calculado >LOD fixo é adicionada por padrão. Clique no ícone de sinal de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png)adicionar quaisquer campos adicionais ao seu cálculo. Isso preenche o lado esquerdo da equação, `{FIXED [Field1],[Field2] :`. - Na seção Computar usando, selecione o campo que deseja usar para calcular seus novos valores. Em seguida, selecione sua agregação. Isso preenche o lado direito da equação, `Aggregation([Field)}`. Um gráfico abaixo do campo mostra a distribuição de valores e uma contagem total para cada combinação de valor. Dependendo do tipo de dados, esse pode ser um gráfico de caixa, faixa de valores ou os valores reais. ![Uma tabela LOD fixa de dados de vendas de clientes com um gráfico de caixa.](/tableau/current/pt-br/prep/pt-br/Img/prep_LOD_visual.png) **Observação**: os valores de agregação disponíveis variam de acordo com o tipo de dados atribuído ao campo. - Para remover um campo, clique com o botão direito ou Ctrl+clique (MacOS) na caixa suspensa para os campos na seção Agrupar por e selecione Remover o campo. - No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. 3. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que o Tableau Prep gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![A sintaxe para uma expressão de Nível de Detalhe (LOD) FIXED no painel Alterações.](/tableau/current/pt-br/prep/pt-br/Img/prep_LOD_changes.png) ## Calcular o número de classificação ou linha As funções analíticas, às vezes denominadas cálculos de janelas, permitem que você realize cálculos em toda a tabela ou em uma seleção de linhas (partição) em seu conjunto de dados. Por exemplo, ao aplicar uma classificação para uma seleção de linhas, você usaria a seguinte sintaxe de cálculo: `{PARTITION [field]: {ORDERBY [field]: RANK() }}` - **PARTITION** (opcional): designe as linhas em que deseja realizar o cálculo. Você pode especificar mais de um campo, mas se quiser usar toda a tabela, omita esta parte da função, e o Tableau Prep trata todas as linhas como partição. Por exemplo, `{ORDERBY [Sales] : RANK() }`. - **ORDERBY**(obrigatório): especifique um ou mais campos que deseja usar para gerar a sequência para a classificação. - **Rank ()**(obrigatório): especifique o tipo de classificação ou ROW\_NUMBER () que deseja calcular. O Tableau Prep suporta funções RANK(), RANK\_DENSE(), RANK\_MODIFIED(), RANK\_PERCENTILE() e ROW\_NUMBER() () - **DESC** ou **ASC** (opcional): representa a ordem descendente (DESC) ou ascendente (ASC). Por padrão, a classificação é feita em ordem descendente, então você não precisa especificar isso na expressão. Se você quiser mudar a ordem de classificação, adicione ASC à expressão. Também é possível incluir ambas as opções na função. Por exemplo, se você quisesse classificar uma seleção de linhas, mas em ordem ascendente e, em seguida, aplicar a classificação em ordem descendente, você incluiria essas duas opções na expressão. Por exemplo: `{PARTITION [Country], [State]: {ORDERBY [Sales] ASC,[Customer Name] DESC: RANK() }}` Ao usar esse recurso, os seguintes requisitos se aplicam: - As expressões aninhadas dentro de uma função RANK () não são aceitas. Por exemplo, `[Sales]/{PARTITION [Country]: {ORDERBY [Sales]: RANK() }} / SUM( [Profit] )}` não é aceito. - Não é aceito combinar uma função RANK () com outra expressão. Por exemplo, `[Sales]/{PARTITION [Country]: {ORDERBY [Sales]: RANK() }}` não é aceito. ### Funções analíticas aceitas
FunçãoDescriçãoResultado
RANK ()

Atribui um número inteiro começando com 1, em ordem ascendente ou descendente para cada linha. Se as linhas tiverem o mesmo valor, elas compartilham a classificação atribuída à primeira instância do valor. O número de linhas com a mesma classificação é adicionado ao calcular a classificação para a próxima linha, para que você não obtenha valores consecutivos de classificação.

Cálculo de amostra :{ORDERBY [Commission] DESC: RANK()}

Uma tabela exibindo a comissão de vendas ganha por cinco vendedores e sua classificação.
RANK_DENSE()

Atribui um número inteiro começando com 1, em ordem ascendente ou descendente para cada linha. Se as linhas tiverem o mesmo valor, elas compartilham a classificação atribuída à primeira instância do valor, mas nenhum valor de classificação é ignorado para que você veja valores consecutivos de classificação.

Cálculo de amostra :{ORDERBY [Commission] DESC: RANK_DENSE()}

Uma tabela de vendedores, seus valores de comissão, as regiões que cobrem e sua classificação densa.
RANK_MODIFIED()

Atribui um número inteiro começando com 1, em ordem ascendente ou descendente para cada linha. Se as linhas tiverem o mesmo valor, elas compartilham a classificação atribuída à última instância do valor. Rank_Modified é calculado como Rank + (Rank + Number of duplicate rows - 1).

Cálculo de amostra :{ORDERBY [Commission] DESC: RANK_MODIFIED()}

Uma tabela exibindo a comissão de vendas ganha por cinco vendedores e sua classificação usando o método RANK_MODIFIED.
RANK_PERCENTILE()

Atribui uma classificação de percentil de 0 a 1 em ordem ascendente ou descendente para cada linha. RANK_PERCENTILE é calculado como (Rank-1)/(Total rows-1).

Cálculo de amostra :{ORDERBY [Commission] DESC: RANK_PERCENTILE()}

Observação: em caso de empate, o Tableau Prep arredonda a classificação para baixo, semelhante a PERCENT_RANK() no SQL.

Uma tabela exibindo classificação percentual, vendedor, região e comissão.
ROW_NUMBER()

Atribui uma ID sequencial de linha a cada linha única. Nenhum valor de número de linha é ignorado. Se você tiver linhas duplicadas e usar este cálculo, seus resultados podem mudar cada vez que você executar o fluxo em caso de mudança na ordem das linhas.

Cálculo de amostra :{ORDERBY [Commission] DESC: ROW_NUMBER()}

Uma tabela que exibe vendedores, sua região, valor da comissão e número da linha.
O exemplo a seguir mostra uma comparação de cada uma das funções acima aplicadas ao mesmo conjunto de dados. ![Uma tabela de classificação, classificação densa, classificação modificada e percentil de classificação.](/tableau/current/pt-br/prep/pt-br/Img/prep_rank_example_all.png) ### Criar cálculos de classificação ou número de linha Para criar um cálculo Rank ou Row\_Number, você pode usar o editor de cálculo para escrever o cálculo, ou, se você quiser uma experiência mais guiada, poderá usar o editor de Cálculo Visual para selecionar seus campos e o escreve o cálculo para você. **Observação**: os cálculos de ROW\_NUMBER () não estão disponíveis no editor de cálculo visual. #### Editor de cálculo Use o editor de cálculo para criar qualquer um dos cálculos RANK () ou ROW\_NUMBER() aceitos. A lista de cálculos analíticos aceitos é mostrada no editor de Cálculo no menu suspenso Referência em Análise. 1. Na barra de ferramentas do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou uma grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![O menu Mais opções com a opção de criar um cálculo personalizado.](/tableau/current/pt-br/prep/pt-br/Img/prep_lod_rank_menu_tile.png) 2. No editor de cálculo, digite um nome para o seu cálculo e a expressão. Por exemplo, para encontrar o último pedido do cliente, crie um cálculo como o mostrado abaixo, em seguida, mantenha apenas as linhas de pedidos do cliente classificadas com o número 1. ![O editor de cálculo adicionou um campo calculado, “Último pedido do cliente”, que usa a função RANK.](/tableau/current/pt-br/prep/pt-br/Img/prep_rank_example2.png) **Exemplo**: use ROW\_NUMBER para encontrar e remover valores duplicados. Esse exemplo usa o conjunto de dados de amostra da Superstore no Tableau Prep Builder para encontrar e remover valores duplicados exatos para o campo ID de linha usando a função ROW\_NUMBER. 1. Abra o fluxo Sample Superstore. 2. No painel Fluxo, para a etapa de entrada Pedidos Oeste, clique na etapa Limpar Renomear Estados. 3. Na barra de ferramentas, clique em Criar campo calculado. 4. No editor de Cálculo, nomeie o novo campo como “Duplicatas” e use a função `ROW_NUMBER` para adicionar um número de linha ao campo ID de linha usando a expressão `{PARTITION [Row ID]: {ORDERBY[Row ID]:ROW_NUMBER()}}` e clique em Salvar. ![O Editor de cálculo mostrando a sintaxe de cálculo para remover valores duplicados usando a função ROW\_NUMBER().](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_row_number.png) 5. No novo campo calculado, clique com o botão direito ou clique em Cmd (MacOS) no valor de campo 1 e selecione Manter apenas no menu. ![Eles mantêm apenas a opção de uma lista de duplicatas.](/tableau/current/pt-br/prep/pt-br/Img/prep_ROW_NUM_Example.png)
AntesDepois
A tabela “antes” de dados antes de serem usados em um cálculo.A tabela posterior de dados de um cálculo.
#### Editor de cálculo visual Igual ao criar um nível de cálculo detalhado, você pode usar o editor de cálculo visual para construir um cálculo de classificação. Selecione os campos que deseja incluir no cálculo e selecione os campos que deseja usar para classificar as linhas e o tipo de classificação que deseja calcular. Uma prévia dos resultados é mostrada no painel esquerdo, para que você possa ver os resultados de suas seleções. 1. Em um painel de placa de perfil ou resultados, clique no meni Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado \>Classificação. ![O menu Mais opções mostra o submenu Criar campo calculado para Classificação.](/tableau/current/pt-br/prep/pt-br/Img/prep_rank_visual_nav_tile_r.png) 2. No editor de cálculo visual, faça o seguinte: - Na seção Agrupar por, selecione os campos com linhas para as quais deseja calcular valores. Isso cria a parte de partição do cálculo. Depois de selecionar seu primeiro campo, clique no sinal de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) ícone para adicionar quaisquer campos adicionais ao seu cálculo. Se você deseja incluir todas as linhas ou remover um campo selecionado, clique com o botão direito ou clique em Cmd (MacOS) na caixa suspensa para os campos na seção Agrupar por e selecione Remover o campo. - Na seção Ordenar por, selecione os campos que deseja usar para calcular seus novos valores. O campo em que você selecionou a opção de menu Criar campo calculado >Classificação é adicionada por padrão. Clique no ícone de sinal de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png)adicionar quaisquer campos adicionais ao seu cálculo, em seguida, selecione seu tipo de Classificação. Clique no ícone de classificação ![Ocultar o ícone de Classificação.](/tableau/current/pt-br/prep/pt-br/Img/prep_rank_visual_order.png) para alterar a ordem de classificação de descendente (DESC) para ascendente (ASC). **Observação**: os valores de classificação disponíveis variam de acordo com o tipo de dados atribuído ao campo. - No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. ![O editor Visual calc é usado para calcular a classificação de um conjunto de campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_rank_visual_calc_editor.png) 3. Clique em Feito para adicionar seu novo campo calculado. No painel Alterações, você pode ver o cálculo que Tableau Prep Builder gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. ![O painel Alterações em um fluxo mostrando cinco campos calculados para classificação densa, classificação, percentil de classificação, classificação modificada e número de linha.](/tableau/current/pt-br/prep/pt-br/Img/prep_rank_changes_pane.png) ## Calcular ladrilhos Use o recurso Bloco para distribuir linhas em um número especificado de depósitos, criando um campo calculado. Você seleciona os campos pelos quais deseja distribuir e o número de grupos (blocos) a serem usados. Você também pode selecionar campos adicionais para criar partições onde as linhas lado a lado são distribuídas em grupos. Use o editor de cálculo para inserir a sintaxe manualmente ou use o editor de cálculo visual para selecionar os campos, e o Tableau Prep grava o cálculo para você. Por exemplo, se você tiver linhas de dados de alunos e quiser ver quais alunos estão entre os 50% superiores e os 50% inferiores, você pode agrupar os dados em dois blocos. ![Uma tabela de alunos, as disciplinas e as notas.](/tableau/current/pt-br/prep/pt-br/Img/prep_tiles_calc_excel.png) O exemplo a seguir mostra dois grupos para a metade superior e a metade inferior das notas dos alunos. A sintaxe para este método é: `{ORDERBY [Grade] DESC:NTILE(2)}` ![Uma tabela que mostra os nomes de alunos, disciplinas e notas.](/tableau/current/pt-br/prep/pt-br/Img/prep_tiles_calc_students.png) Você também pode criar uma partição, onde cada valor de um campo é uma partição separada e dividir os dados em grupos para cada partição. O exemplo a seguir mostra a criação de partições para o campo Assunto. Uma partição é criada para cada disciplina e dois grupos (blocos) são criados para o campo Grade. As linhas são então distribuídas uniformemente nos dois grupos para as três partições. A sintaxe para este método é: `{PARTITION [Subject]:{ORDERBY [Grade] DESC:NTILE(2)}}` ![Uma tabela mostra o cálculo, aluno, disciplina e nota. O assunto está em destaque.](/tableau/current/pt-br/prep/pt-br/Img/prep_tiles_calc_partition.png) ### Criar cálculos de blocos Para criar cálculos de blocos, você pode usar o editor de cálculo para escrever o cálculo, ou, se você quiser uma experiência mais guiada, poderá usar o editor de Cálculo Visual para selecionar seus campos e o escreve o cálculo para você. #### Editor de cálculo visual Quando você usa o editor de cálculo visual para criar um cálculo de bloco, uma visualização dos resultados é mostrada no painel esquerdo. 1. Selecione um cartão de perfil para criar um cálculo de bloco. 2. Clique no menu de opções Mais e selecione Criar Campo Calculado > Bloco. ![Criar um cálculo de tabela por usando o editor de cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_tiles_calc_visual_menu.png) O cartão de perfil selecionado é adicionado como um campo ORDERBY. 3. No editor de cálculo visual, faça o seguinte: - Selecione o número de agrupamentos de blocos que você deseja. O valor padrão para blocos é 1. - Na seção Agrupar por, selecione os campos cujas linhas você deseja calcular os valores. Isso cria a parte de `PARTITION` do cálculo. Você pode ter vários campos Agrupar por para um único cálculo. Clique no ícone de sinal de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png)adicionar quaisquer campos adicionais ao seu cálculo. Se você deseja incluir todas as linhas ou remover um campo selecionado, clique com o botão direito ou clique em Cmd (MacOS) na caixa suspensa para os campos na seção Agrupar por e selecione Remover o campo. - No painel esquerdo, clique duas vezes no cabeçalho do campo e digite um nome para o seu cálculo. - Na seção Ordenar por, selecione um ou mais campos que deseja usar para agrupar e distribuir seus novos valores. Você deve ter pelo menos um campo Ordem por. O campo em que você selecionou a opção de menu Criar campo calculado >Bloco é adicionada por padrão. ![Uma tabela de números de vendas, organizada por região.](/tableau/current/pt-br/prep/pt-br/Img/prep_tiles_calc_visual_create.png) 4. Para classificar os resultados, faça o seguinte: - Clique em qualquer uma das linhas de cálculo para filtrar os resultados do agrupamento selecionado - Altere a ordem crescente ou decrescente da ordem por campo. 5. Clique em Feito para adicionar seu novo campo calculado. 6. No painel Alterações, você pode ver o cálculo que o Tableau Prep Builder gerou. Clique em Editar para abrir o editor de cálculo visual e fazer quaisquer alterações. O exemplo a seguir mostra uma divisão de linhas em quartis. Uma partição é criada com base em quatro regiões dos EUA e, em seguida, os dados do campo Vendas são agrupados uniformemente nas partições. ![Mantenha campo calculado como um bloco.](/tableau/current/pt-br/prep/pt-br/Img/prep_tile_calc.gif) #### Editor de cálculo 1. Na barra de ferramenta do painel Perfil, clique em Criar campo calculado, ou em um cartão de perfil ou grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Criar campo calculado > Cálculo personalizado. ![O menu Mais opções com a opção de criar um cálculo personalizado.](/tableau/current/pt-br/prep/pt-br/Img/prep_lod_rank_menu_tile.png) 2. No editor de cálculo, digite um nome para o seu cálculo e a expressão. Por exemplo, para ordenar as linhas de alunos por notas em dois grupos e, em seguida, agrupá-los por assunto, use: `{PARTITION [Subject]:{ORDERBY [Grade] DESC:NTILE(2)}}` . ![Um formulário para adicionar um campo calculado com um menu suspenso que lista opções de cálculo.](/tableau/current/pt-br/prep/pt-br/Img/prep_tiles_calc_menu.png) Os cálculos de blocos incluem os seguintes elementos:  - **PARTITION** (opcional): uma cláusula de partição difere as linhas de um conjunto de resultados em partições onde a função NTILE() é usada. - **ORDERBY** (obrigatório) A cláusula ORDER BY define a distribuição de linhas em cada partição onde NTILE() é usado. - **NTILE** (obrigatório): NTILE é o número inteiro em que as linhas são divididas. **Observação**: quando todas as linhas são divisíveis pela cláusula NTILE, o recurso divide as linhas igualmente entre o número de blocos. Quando o número de linhas não é divisível pela cláusula NTILE, os grupos resultantes são divididos em compartimentos de tamanhos diferentes. - **DESC** ou **ASC** (opcional): representa a ordem descendente (DESC) ou ascendente (ASC). Por padrão, o bloco é classificado em ordem descendente, então você não precisa especificar isso na expressão. Se você quiser mudar a ordem de classificação, adicione ASC à expressão. 3. Clique em Salvar. O campo gerado mostra as atribuições de agrupamento de blocos (compartimento) associadas a cada linha da tabela. [Pular para o conteúdo principal](#main-content) # Dicionário visual Passe o cursor sobre a imagem e clique para obter mais informações. ![Um diagrama de fluxo de dados que ilustra o processo de limpeza e preparação de dados de pedidos.](/tableau/current/pt-br/prep/pt-br/Img/prep_v_d_canvas2.png) Para obter uma versão impressa do dicionário visual, consulte o [PDF do Tableau Prep](https://help.tableau.com/current/offline/pt-br/tableau_prep.pdf#v-d-alt). [Pular para o conteúdo principal](#main-content) # Dinamizar os dados **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Às vezes, a análise de dados em uma planilha ou no formato de tabela de referência cruzada pode ser difícil no Tableau. O Tableau prefere que os dados sejam "compridos" em vez de "largos", o que significa que, com frequência, é necessário dinamizar os dados de colunas para linhas para que o Tableau possa avaliá-los adequadamente. No entanto, você também pode ter cenários em que as tabelas de dados são verticais e estreitas, além de muito normalizadas para serem analisadas adequadamente. Por exemplo, um departamento de vendas que acompanha o gasto com publicidade em duas colunas, uma chamada **Publicidade**, que contém linhas para **rádio**, **televisão** e **impressão** e outra para o gasto total. Nesse tipo de cenário, para analisar esses dados como medidas separadas, seria necessário dinamizá-los de linha para colunas. Mas, como dinamizar conjuntos de dados maiores ou dados que mudam com frequência ao longo do tempo? Você pode usar uma correspondência de padrão curinga para pesquisar campos que correspondam ao padrão e dinamizar automaticamente os dados. Use uma das seguintes opções ao dinamizar os dados: - Dinamizar colunas para linhas - Use a pesquisa curinga para dinamizar instantaneamente os campos com base em uma correspondência de padrão (Tableau Prep Builder versão 2019.1.1, posteriores e na Web). - Dinamize colunas para linhas (Tableau Prep Builder versão 2019.1.1, posteriores e na Web). Independentemente de como os campos são dinamizados, é possível interagir diretamente com os resultados e executar quaisquer operações de limpeza adicionais para que seus dados tenham a aparência que você deseja. Além disso, é possível usar o recurso de nomeação inteligente padrão do Tableau Prep para renomear automaticamente os campos e valores dinamizados. ## Dinamizar colunas para linhas Use essa opção de dinamizar para alterar de dados horizontais para dados verticais. Dinamize de colunas para linhas em um ou mais grupos de campos. Selecione os campos com os quais deseja trabalhar e dinamize os dados de colunas para linhas. 1. Conecte-se à fonte de dados. 2. Arraste a tabela que deseja dinamizar até o painel Fluxo. 3. Execute um destes procedimentos: - **Tableau Prep Builder versão 2019.4.2, versões posteriores e na Web**: no painel Perfil, selecione os campos que deseja dinamizar, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione Dinamizar colunas para linhas no menu. Se usar essa opção, pule para a etapa 7. - **Todas as versões:** clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar dinamização no menu de contexto.
Selecionar campos (Tableau Prep Builder versão 2019.4.2, posteriores e na Web)Menu Etapa do fluxo (todas as versões)
A página do Tableau Prep Builder com a opção Dinamizar colunas para linhas selecionada.O menu do ícone Fonte de dados é aberto, e Dinamizar é selecionado.
4. (Opcional) No painel Campos, insira um valor no campo Pesquisar para pesquisar a lista de campos a serem dinamizados. 5. (Opcional) Selecione Renomear automaticamente campos e valores dinamizados para permitir que o Tableau Prep renomeie os novos campos dinamizados usando valores comuns nos dados. Caso nenhum valor comum seja encontrado, o nome padrão é usado. 6. Selecione um ou mais campos no painel à esquerda e arraste-os até a coluna Valores da Dinamização1 no painel Campos dinamizados. 7. (Opcional) No painel Campos dinamizados, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar mais colunas para dinamizar, em seguida, repita a etapa anterior para selecionar mais campos a serem dinamizados. Seus resultados aparecem imediatamente tanto no painel Dinamizar resultados quanto na grade de dados. **Observação**: é necessário selecionar o mesmo número de campos selecionados na Etapa 5. Por exemplo, se tiver selecionado 3 campos para iniciar a dinamização, cada coluna dinamizada subsequente também deve conter 3 campos. 8. Caso não tenha habilitado a opção de nomeação padrão ou se o Tableau Prep não detectou automaticamente um nome, edite os nomes dos campos. Também é possível editar os nomes dos campos originais neste painel para descrever os dados adequadamente. 9. (Opcional) Renomeie a nova etapa Dinamizar para monitorar suas alterações. Por exemplo "Dinamizar meses". 10. Para atualizar os dados dinâmicos quando os dados forem alterados, execute o fluxo. Caso sejam incluídos novos campos na fonte de dados que precisa ser adicionada à dinamização, adicione-os manualmente à dinamização. **Exemplo**: dinamização em vários campos Este exemplo mostra uma planilha de vendas, taxas e totais farmacêuticos por mês e ano. ![Uma planilha para vendas farmacêuticas, impostos e totais por mês e ano com cabeçalhos compartilhados.](/tableau/current/pt-br/prep/pt-br/Img/prep_beforepivot.png) Ao dinamizar os dados, é possível criar linhas para cada mês e ano e colunas individuais para vendas, taxas e totais, de forma que o Tableau possa interpretar esses dados com mais facilidade para a análise. ![O painel Campos dinamizados mostra os resultados da dinamização de colunas para linhas em um fluxo do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_afterpivot.png) ### Veja a opção “Dinamizar em vários campos” em ação. ## Usar a pesquisa curinga para dinamizar Se você trabalhar com conjuntos de dados maiores ou os dados mudarem com frequência ao longo do tempo, a partir do Tableau Prep Builder versão 2019.1.1, versões posteriores e na Web, você pode usar uma pesquisa curinga ao dinamizar colunas para linhas, assim os dados serão dinamizados instantaneamente com base em uma correspondência de padrão curinga. Caso sejam adicionados ou removidos novos campos que correspondam ao padrão, o Tableau Prep detectará a alteração do esquema quando o fluxo for executado e os resultados da dinamização serão atualizados automaticamente. 1. Conecte-se à fonte de dados. 2. Arraste a tabela que deseja dinamizar até o painel Fluxo. 3. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar dinamização no menu de contexto. 4. No painel Campos dinamizados, clique no link Usar pesquisa curinga para dinamizar. ![Use a pesquisa curinga para dinamizar.](/tableau/current/pt-br/prep/pt-br/Img/prep_wildcard_pivot3.png) 5. Insira um valor ou valor parcial que deseja pesquisar. Por exemplo, insira **Vendas\_** para corresponder aos campos rotulados como **vendas\_2017**, **vendas\_2018** e **vendas\_2019**. Não use asteriscos para corresponder ao padrão, a menos que eles façam parte do valor do campo pesquisado. Em vez disso, clique no botão Opções de pesquisa![Botão Opções de pesquisa do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_search_options_button.png) para selecionar como deseja corresponder ao valor. Em seguida, pressione Enter para aplicar a pesquisa e dinamizar os valores correspondentes. ![Use a pesquisa curinga para dinamizar.](/tableau/current/pt-br/prep/pt-br/Img/prep_wildcard_pivot.png) 6. (Opcional) No painel Campos dinamizados, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar mais colunas para dinamizar, em seguida, repita a etapa anterior para selecionar mais campos a serem dinamizados. 7. Caso não tenha habilitado a opção de nomeação padrão ou se o Tableau Prep não detectou automaticamente um nome, edite os nomes dos campos. 8. Para atualizar os dados dinâmicos quando os dados forem alterados, execute o fluxo. Quaisquer novos campos adicionados à fonte de dados que correspondam ao padrão curinga são detectados e adicionados automaticamente à dinamização. 9. Se os resultados não forem os esperados, tente uma das seguintes opções: - Insira um padrão de valor diferente no campo Pesquisar e pressione Enter. A dinamização será atualizada automaticamente e mostrará os novos resultados. - Arraste manualmente os campos adicionais para a coluna Valores de dinamização 1 no painel Campos dinamizados. Você também pode remover os campos que foram adicionados manualmente, arrastando-os da coluna Valores de dinamização 1 e soltando-os no painel Campos. **Observação**: os campos que foram adicionados dos resultados da pesquisa curinga não poderão ser removidos ao arrastá-los para fora da coluna Valores de dinamização 1. Em vez disso, tente usar um padrão mais específico para corresponder aos resultados da pesquisa desejados. ## Dinamizar linhas para colunas No Tableau Prep Builder versão 2019.1.1, versões posteriormente e na Web, o dinamize linhas para colunas se seus dados forem muito normalizados e você precisar criar novas colunas. Passando de dados altos a dados mais amplos. Por exemplo, se você tiver custos de publicidade referentes a cada mês que incluam todos os tipos de publicidade em uma coluna, ao dinamizar os dados de linhas para colunas, será possível ter uma coluna separada para cada tipo de publicidade, facilitando a análise dos dados. ![Duas tabelas onde as colunas e linhas foram dinamizadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_pivot_example.png) Você pode selecionar um campo para a dinamização. Os valores desse campo são usados para criar as novas colunas. Em seguida, selecione um campo para ser usado para preencher as novas colunas. Esses valores de campo são agregados e é possível selecionar o tipo de agregação a ser aplicado. Como a agregação foi aplicada, a dinamização inversa de colunas para linhas não reverterá essa ação de dinamização. Para inverter um tipo de dinamização de linha para coluna, você precisará desfazer a ação. Clique no botão Desfazer no menu superior, remova os campos do painel Campos dinamizados ou exclua a etapa de dinamização. 1. Conecte-se à fonte de dados. 2. Arraste a tabela que deseja dinamizar até o painel Fluxo. 3. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar dinamização no menu de contexto. 4. No painel Campos dinamizados, selecione Linhas para colunas na lista suspensa. 5. (Opcional) No painel Campos, insira um valor no campo Pesquisar para pesquisar a lista de campos a serem dinamizados. 6. Selecione um campo no painel esquerdo e arraste-o para a seção Campo para dinamizar linhas para colunas no painel Campos dinamizados. **Observação**: se o campo no qual deseja dinamizar tiver um tipo de dados de data ou de data e hora, será necessário alterar o tipo de dados para cadeia de caracteres para dinamizá-lo. Os valores nesse campo serão usados para criar e nomear as novas colunas. Você pode alterar os nomes das colunas no painel Dinamizar resultados posteriormente. ![As colunas e os resultados dos Campos dinâmicos.](/tableau/current/pt-br/prep/pt-br/Img/prep_pivot_rows_field.png) 7. Selecione um campo no painel esquerdo e arraste-o para a seção Campo a ser agregado para as novas colunas no painel Campos dinamizados. Os valores nesse campo são usados para preencher as novas colunas criadas na etapa anterior. ![As colunas e os resultados dos Campos dinâmicos.](/tableau/current/pt-br/prep/pt-br/Img/prep_pivot_rows_aggregate.png) Um tipo de agregação padrão é atribuído ao campo. Clique no tipo de agregação para alterá-lo. ![Uma lista de tipos de agregação.](/tableau/current/pt-br/prep/pt-br/Img/prep_pivot_rows_agg_type.png) 8. No painel Dinamizar resultados, revise os resultados e aplique as operações de limpeza às novas colunas criadas. ![Os Campos dinâmicos e os Resultados da dinamização mostram três gráficos de barras.](/tableau/current/pt-br/prep/pt-br/Img/prep_pivot_rows2.png) 9. Se o campo que está sendo dinamizado tiver uma alteração nos dados da linha, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS), na etapa de Dinamização do painel Fluxo e selecione Atualizar. [Pular para o conteúdo principal](#main-content) # Encontrar a Segunda data com o Tableau Prep Uma necessidade comum na análise é determinar a data que um _segundo_ evento acontece, como quando um cliente fez uma segunda compra (se tornando, então, um cliente recorrente) ou se um motorista recebe uma segunda multa de trânsito. Encontrar a data de um primeiro evento é fácil; é simplesmente a data mínima. Encontrar a segunda data é mais complexo. Neste tutorial de duas partes, definiremos os dados de infração trânsito e responderemos às seguintes perguntas: 1. Qual foi a duração em dias entre a primeira e a segunda infração de cada motorista? 2. Compare os valores das multas da primeira e da segunda infração. Elas estão correlacionadas? 3. Qual motorista pagou mais no total? Quem pagou menos? 4. Quantos motoristas tinham vários tipos de infrações? 5. Qual foi o valor médio da multa para os motoristas que nunca fizeram autoescola? No primeiro estágio, usaremos o Tableau Prep Builder para reestruturar os dados para nossa análise. No segundo estágio, [Análise com a segunda data no Tableau Desktop](https://help.tableau.com/current/prep/pt-br/prep_tutorial_2nddateB.htm), prosseguiremos para a análise no Tableau Desktop. A meta deste tutorial é apresentar vários conceitos no contexto de um cenário da vida real e trabalhar com as opções, sem estabelecer uma que seja a melhor de maneira prescritiva. Ao fim, você deve entender melhor como a estrutura de dados influencia os cálculos e as análises, assim como obter uma maior familiaridade com vários aspectos do Tableau Prep e dos cálculos no Tableau Desktop. **Observação**: para completar as tarefas neste tutorial, é necessário ter o Tableau Prep Builder (instalado e por navegador) e os dados baixados. Para a segunda parte, você também precisará do Tableau Desktop instalado. O conjunto de dados é [Traffic Violations.xlsx](https://mkt.tableau.com/PrepTutorials/Traffic%20Violations.xlsx). É recomendado salvá-lo em sua pasta Meu repositório do Tableau Prep > Fontes de dados. Para instalar o Tableau Prep Builder e o Tableau Desktop antes de continuar com este tutorial, consulte o [Guia de implantação do Tableau Desktop e do Tableau Prep](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm#). Caso contrário, é possível baixar as versões gratuitas de avaliação do [Tableau Prep](https://www.tableau.com/pt-br/products/prep/download) e do [Tableau Desktop](https://www.tableau.com/pt-br/products/desktop/download). ## Os dados Para este exemplo, analisamos os dados de infração de trânsito. Cada linha é uma infração. O motorista, a data, o tipo de infração, se o motorista deveria frequentar a autoescola e o valor da multa estão gravados. ![Visualização do conjunto de dados de violações de tráfego](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_trafficviolations.png) ## Estrutura de dados desejada Os dados estão atualmente estruturados de forma que cada linha é uma _infração_. Um motorista com várias infrações aparece em várias linhas, e não há uma maneira simples de dizer qual foi a primeira ou a segunda infração. Para investigar os infratores recorrentes, queremos um conjunto de dados que separe as datas da primeira e segunda infrações, além das informações associadas a cada uma delas, e cada linha é um _motorista_. ![Visualização da estrutura de dados desejada](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_driverLOD.png) ## Reestruturação dos dados Como fazemos isso com o Tableau Prep? Criaremos o fluxo em estágios, começando por retirar a data da primeira infração, em seguida a segunda e definindo o conjunto de dados final conforme desejado. Certifique-se de que tenha baixado o arquivo Excel ([Traffic Violations.xlsx](https://mkt.tableau.com/PrepTutorials/Traffic%20Violations.xlsx)) para acompanhar. ### Agregação inicial da data da primeira infração Primeiro, vamos conectar ao arquivo **Traffic Violations.xlsx**. 1. Abra o Tableau Prep Builder. 2. Na tela inicial, clique em Conectar aos dados. 3. No painel Conexões, clique em Microsoft Excel. Navegue até onde você salvou o **Traffic Violations.xlsx** e clique em Abrir. 4. A planilha **Infrações** deverá ser trazida automaticamente para o painel Fluxo. Para obter mais informações sobre como se conectar a dados, consulte [Conectar a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm). Em seguida, precisamos identificar a data da primeira infração de cada motorista. Usaremos uma etapa Agregação para isso, criando um mini conjunto de dados de **ID do motorista** e **Data mínima da infração**. Ao usar uma etapa de Agregação no Tableau Prep, qualquer campo que defina o que faz uma linha é um Campo agrupado. (Para nós, é a **ID do motorista**.) Qualquer campo que será agregado e apresentado no nível dos campos agrupados é um Campo agregado. (Para nós, é a **Data da infração**). 1. No painel Fluxo, selecione **Infrações**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Agregação. 2. Arraste **ID do motorista** até a área para soltar Campos agrupados. 3. Arraste **Data da infração** até a área Campos agregados. A agregação padrão é CNT (contagem). Clique em CNT e altere a agregação para Mínimo. ![O painel de configuração da etapa agregada mostrando o layout correto dos campos](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_aggregation1.png) Isso identifica a menor data (mais recente), que é a primeira data da infração por motorista. Para obter mais informações sobre as agregações, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Group). 1. No painel Fluxo, selecione Agregação 1, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Etapa de limpeza para que possamos limpar a saída da agregação. 2. No painel Perfil, clique duas vezes no nome do campo **Data da infração** e altere-o para **Data da primeira infração**. _Neste estágio, o painel de fluxo e perfil devem ter esta aparência:_ ![Visual do fluxo com três etapas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_flowstate1.png) No painel Perfil, nesta etapa Limpar, podemos ver que nossos dados agora consistem em 39 linhas e apenas dois campos. Os grupos não usados para agrupamento ou agregação são perdidos. Mas queremos manter algumas das informações originais. Podemos adicionar esses campos ao agrupamento ou à agregação (mas fazer isso altera o nível de detalhe ou requer que os campos sejam agregados) ou unir as colunas desse mini conjunto de dados de volta ao original (adicionando uma nova coluna aos dados originais para a **Data da primeira infração**). Vamos fazer a união de colunas. 1. No painel Fluxo, selecione **Horários**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Etapa de limpeza. Certifique-se de focalizar a etapa de Infrações diretamente, não a linha entre ela e a etapa de Agregação. Se a nova etapa de Limpeza for inserida entre os dois em vez de ramificar, use a seta Desfazer na barra de ferramentas e tente novamente. O menu deve indicar _Adicionar_ não _Inserir_. ![Agregação inicial da data da primeira infração.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial2nd_branch.png) Isso ramifica o fluxo com todos os dados originais. Uniremos as colunas dos resultados da agregação a esta cópia dos dados completos. Ao unir colunas na **ID do motorista**, adicionamos a data mínima da nossa agregação aos dados originais. 1. Selecione a etapa **Limpeza 2**, arraste-a para o início da etapa **Limpeza 1** e solte em Unir colunas. 2. A configuração padrão da união de colunas deve estar correta: uma união de colunas interna em **ID do motorista = ID do motorista**. ![Uma tabela de dados representa uma união interna de dois conjuntos de dados da ID do motorista, acompanhada por um tipo de união de colunas e um gráfico de barras empilhadas para consolidar os resultados.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_join1.png) Para obter mais informações sobre uniões, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Join). Como alguns campos podem ser duplicados durante uma união, como os campos na cláusula de união, é uma boa ideia limpar campos irrelevantes após executar uma união de colunas. 1. No painel Fluxo, selecione **União de colunas 1**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar etapa. 2. No painel Perfil, clique com o botão direito do mouse ou Ctrl -clique (MacOS) no cartão para **Driver ID-1** e selecione Remover. 3. Para alterar a ordem do campo, arraste o cartão **Data da primeira infração** entre **ID do motorista** e **Data da infração**, onde você verá a linha preta aparecer. _Neste estágio, o fluxo deve ter esta aparência:_ ![Visual do fluxo com seis etapas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_flowstate2.png) Observando a grade de dados abaixo, podemos ver nosso novo conjunto de dados combinado. Temos a data da infração mínima (ou seja, a primeira) de cada motorista adicionada a cada linha no conjunto de dados. ![Visualização dos dados com o campo Data da 1ª Infração](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_1stdatedatagrid.png) ### Segunda agregação da data da segunda infração Também é preciso determinar a data da segunda infração. Para isso, devemos filtrar as linhas onde a data da infração é igual a mínima, removendo, então, a primeira data. Em seguida, podemos pegar o mínimo das datas restantes usando outra etapa de agregação, deixando apenas a data da segunda infração, que renomearemos para ficar mais claro. **Observação**: como queremos usar os dados como estão no momento em **Limpeza 3**, futuramente no fluxo, adicionaremos outra etapa de **Limpeza** para obter a data da segunda infração. Isso deixará o estado atual dos dados em Limpeza 3 disponível posteriormente. 1. No painel Fluxo, selecione **Limpeza 3**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Etapa de limpeza. 2. Na barra de ferramentas, no painel Perfil, selecione Filtrar valores. Crie um filtro `[Infraction Date] != [1st Infraction Date]`. 3. Remova o campo **Data da primeira infração**. 4. No painel Fluxo, selecione **Limpeza 4**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Agregação. 5. Arraste **ID do motorista** até a área para soltar Campos agrupados. Arrase **Data da infração** até a área Campos agregados e altere a agregação para Mínimo. 6. No painel Fluxo, selecione **Agregação 2**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Etapa de limpeza. Renomeie **Data da infração** e **Datada segunda infração**. _Neste estágio, o fluxo deve ter esta aparência:_ ![Exibição do fluxo com nove etapas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_flowstate3.png) Agora temos nossa data da segunda infração identificada para cada motorista. Para obter todas as outras informações associadas a cada infração (tipo, multa, autoescola) precisamos unir colunas novamente ao conjunto de dados completo. 1. Selecione **Limpeza 5**, arraste-a para o início da etapa **Limpeza 3** e solte em Unir colunas. 2. Novamente, a configuração padrão da união de colunas deve estar correta: uma união de colunas interna em **ID do motorista = ID do motorista**. 3. No painel Fluxo, selecione **União de colunas 2**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar etapa. Como não eles são mais necessários, exclua os campos **ID do motorista-1** e **Data da primeira infração**. _Neste estágio, o fluxo deve ter esta aparência:_ ![Exibição do fluxo com onze etapas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_flowstate4.png) ### Criar conjuntos de dados completos para a primeira e a segunda infrações Antes de continuar, vamos voltar e pensar sobre tudo que temos e como queremos unir todas as informações. O estado final que desejamos é um conjunto de dados que pareça com isto, com uma coluna para **ID do motorista** e colunas para data, tipo, autoescola e montante da multa das primeira e da segunda infração. ![Visualização da estrutura de dados desejada](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_driverLOD.png) Como faremos isso? Na etapa **Limpeza 3**, temos nosso conjunto de dados completo com uma coluna que repete a data da primeira infração para cada motorista. ![Visualização da grade de dados da etapa Limpeza 3](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_clean3grid.png) Queremos eliminar todas as linhas de um motorista que não está na primeira infração, criando um conjunto de dados de apenas primeiras infrações. Ou seja, queremos mantes apenas as informações de um determinado motorista quando **Data da primeira infração = Data da infração**. Depois de filtrar para manter apenas a linha da primeira infração, podemos remover o campo **Data da infração** organizar os nomes de campo. De forma semelhante, depois da segunda agregação e união de colunas, teremos nosso conjunto de dados completo com uma coluna para a data da segunda infração. ![Visualização da grade de dados da etapa Limpeza 6](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_clean6grid.png) Podemos executar um filtro semelhante a **Data da segunda infração = Data da infração** para manter apenas a linha das informações para cada segunda infração do motorista. Novamente, podemos remover também a **Data da infração** e organizar os nomes de campo. Começaremos com o conjunto de dados da primeira infração. 1. No painel Fluxo, selecione **Limpeza 3**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Etapa de limpeza. Como na etapa 10 acima, queremos adicionar uma ramificação para a nova etapa de limpeza, não inseri-la entre Limpeza 3 e Limpeza 4. 2. Com essa nova etapa Limpeza selecionada, no painel Perfil, clique em Filtrar valores na barra de ferramentas. Crie um filtro `[1st Infraction Date] = [Infraction Date]`. 3. Remova o campo **Data da infração**. 4. Renomeie os campos **Tipo de infração**, **Autoescola** e **Valor da multa** para que comecem com "1º". 5. Clique duas vezes no nome **Limpeza 7** na etapa do painel Fluxo e renomeie como **1º Robusto**. Agora para o conjunto de dados da segunda infração. 1. No painel Fluxo, selecione **Limpeza 6**, depois da última união de colunas. 2. Clique em Filtrar valores na barra de ferramentas. Crie um filtro `[2nd Infraction Date] = [Infraction Date]`. 3. Remova o campo **Data da infração**. 4. Renomeie os campos **Tipo de infração**, **Autoescola** e **Valor da multa** para que comecem com "2º". 5. Clique duas vezes no nome **Limpeza 6** na etapa do painel Fluxo e renomeie como **2º Robusto**. _Neste estágio, o fluxo deve ter esta aparência:_ ![Exibição do painel de fluxo com 12 etapas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_flowstate5.png) ### Criar o conjunto de dados completo Agora que temos esses dois conjuntos de dados com informações completas para a primeira e segunda infração por motorista, podemos unir as colunas novamente na **ID do motorista** e concluir nossa estrutura de dados desejada. 1. Selecione **2º Robusto**, arraste-o para o início do etapa **1º Robusto** e solte em Unir colunas. 2. A cláusula padrão da união de colunas deve estar correta como **ID do motorista = ID do motorista**. 3. Como não queremos soltar motoristas que não possuem uma segunda infração, precisamos torná-la uma união de colunas à esquerda. Na área Tipo de união de colunas, clique na área que não está sombreada do diagrama próximo a **1º Robusto**, tornando uma união de colunas **à esquerda**. 4. No painel Fluxo, selecione **União de colunas 3**, clique no ícone de sinal de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Etapa de limpeza. Remova o campo **ID do motorista-1** duplicado. Os dados estão no estado esperado, então podemos criar uma saída e prosseguir para a análise. 1. No painel Fluxo, selecione a **Limpeza** 6 recém-adicionada, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar saída. 2. No painel Saída, altere o Tipo de saída para .csv e clique em Procurar. Insira **Infrações do motorista** para o nome e selecione o local desejado antes de clicar em Aceitar para salvar. 3. Clique no botão Executar fluxo ![O botão Executar fluxo aparece como uma seta voltada para a direita.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow.png) na parte inferior do painel para gerar a saída. Clique em Concluído na caixa de diálogo do status e feche-a. **Dica**: para obter mais informações sobre as saídas e a execução de um fluxo, consulte [Salvar e compartilhar seu trabalho](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#Export). _O fluxo final deve ter esta aparência:_ ![Exibição final do fluxo completo](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_2d_flowstate6.png) **Observação**: é possível baixar o arquivo de fluxo completo para verificar seu trabalho: [Driver Infractions.tflx](https://mkt.tableau.com/PrepTutorials/Driver%20Infractions.tflx) ## Resumo Na primeira etapa desse tutorial, nosso objetivo era pegar o conjunto de dados original e prepará-lo para análise, envolvendo as datas da primeira e da segunda infração. O processo consiste em três fases:  Identificar as datas da primeira e da segunda infração: 1. Crie uma agregação que mantenha a **ID do motorista** e **Data da infração mínima**. Una as colunas ao conjunto de dados original para criar um "conjunto de dados intermediário" que tenha a data da primeira infração (mínima) repetida em cada linha. 2. Em uma nova etapa, filtre todas as linhas onde a **Data da primeira infração** seja a mesma da **Data da infração**. A partir desse conjunto de dados filtrado, crie uma agregação que mantenha a **ID do motorista** e **Data da infração mínima**. Una as colunas ao conjunto de dados intermediário da primeira etapa. Isso identifica a segunda data da infração. Crie conjuntos de dados limpos para a primeira e a segunda infração. 1. Volte e crie uma extensão a partir do conjunto de dados intermediário e filtre para manter apenas as linhas onde a **Data da primeira infração** seja a mesma da **Data da infração**. Isso cria um conjunto de dados apenas para a primeira infração. Organize-o removendo campos desnecessários e renomeie todos os campos desejados (exceto **ID do motorista**) para indicar que eles são da primeira infração. Este é o conjunto de dados **1º Robusto**. 2. Organize o conjunto de dados para a data da segunda infração. Limpe os resultados da união de colunas da etapa dois filtrando para manter apenas as linhas onde a **Data da segunda infração** seja a mesma da **Data da infração**. Remova os campos desnecessários e renomeie todos os campos desejados (exceto **ID do motorista**) para indicar que eles são da primeira infração. Este é o conjunto de dados **2º Robusto**. Combine os dados da primeira e segunda infração em um conjunto de dados: 1. Una as colunas aos conjuntos de dados **1º Robusto** e **2º Robusto**, certificando-se de manter todos os registros do **1º Robusto** para evitar perder quaisquer drivers sem uma segunda infração. Em seguida, queremos explorar como esses dados podem ser analisados no Tableau Desktop. ### Prossiga para [Análise com a segunda data no Tableau Desktop](https://help.tableau.com/current/prep/pt-br/prep_tutorial_2nddateB.htm). **Observação**: agradecimento especial ao tópico do Workout Wednesday da Ann Jackson [Os clientes gastam mais na primeira ou na segunda compra?](https://www.workout-wednesday.com/2018/06/13/week-24-do-customers-spend-more-on-their-first-or-second-purchase/) e a dica para o Tableau Prep do Andy Kriebel [Retornar a primeira e a segunda data de compra](https://www.vizwiz.com/2018/06/first-second-purchase.html?m=1), que forneceram a inspiração inicial para este tutorial. Clicar nestes links o levará para fora do site do Tableau. A Tableau não pode ser responsabilizada pela exatidão ou pela atualidade de páginas mantidas por provedores externos. Entre em contato com os proprietários se você tiver dúvidas a respeito do conteúdo deles. [Pular para o conteúdo principal](#main-content) # Examinar os dados **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). Use as opções neste tópico para ter uma boa compreensão da composição dos dados para entender melhor as alterações necessárias e o efeito das operações incluídas no fluxo. ## Consultar os tipos de dados atribuídos aos seus dados Como o Tableau Desktop, o Tableau Prep interpreta os dados nos campos quando você arrasta uma conexão até o painel Fluxo e atribui automaticamente um tipo de dados a eles. Como banco de dados diferentes podem lidar com dados de maneiras diversas, a interpretação do Tableau Prep pode nem sempre estar correta. Para alterar um tipo de dados, clique no ícone de tipo de dados e selecione o tipo correto no menu de contexto. É possível alterar os tipos de dados de cadeia de caracteres ou de inteiros para Data ou Data e hora, e o Tableau Prep acionará o DateParse automático para alterar esses tipos de dados. Como no Tableau Desktop, se as alterações não forem bem-sucedidas, você verá valores Nulos nos campos e será possível criar um cálculo para fazer a alteração. Para obter mais informações sobre como usar o DataParse, consulte [Converter um campo em um campo de data](https://help.tableau.com/current/pro/desktop/pt-br/data_dateparse.htm) na Ajuda para criação na Web e do Tableau Desktop. ![Um menu Tipo de Dados exibindo funções de dados disponíveis.](/tableau/current/pt-br/prep/pt-br/Img/prep_profiledatatype.png) Você pode alterar o tipo de dados na etapa de Entrada após se conectar aos dados das fontes de dados a seguir: - Microsoft Excel - Arquivos de texto - Arquivos em PDF - Box - Dropbox - Google Drive - OneDrive Para todas as outras fontes de dados, adicione uma etapa de limpeza ou outro tipo de etapa para fazer essa alteração. Para ver uma lista das opções de limpeza disponíveis nos diferentes tipos de etapas, consulte [Sobre as operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Edit). ## Ver detalhes de tamanho dos dados Após conectar-se a seus dados, adicione uma tabela ao fluxo e depois adicione uma etapa. É possível usar o painel Perfil para ver o estado e a estrutura atuais dos seus dados e identificar nulos e exceções. - **Número de campos e linhas**: no canto superior direito do painel Perfil é possível encontrar informações que resumem o número de campos e linhas nos dados em determinado momento do fluxo. O Tableau Prep arredonda para o milhar mais próximo. No exemplo abaixo, há 21 campos e 3.000 linhas no conjunto de dados. ![A parte superior do painel Perfil mostra o número resumido de campos e linhas nos dados em um ponto específico do fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_fields.png) Ao passar o cursor pelo número de campos e linhas, é possível ver o número exato de linhas (neste exemplo, 2848). ![O estado de foco na parte superior do painel de perfil para ver o número exato de linhas.](/tableau/current/pt-br/prep/pt-br/Img/prep_fields_exact.png) - **Tamanho do conjunto de dados**: trabalhe com um subconjunto de dados ao especificar o número de linhas a serem incluídas na guia Amostra de dados, no painel de Entrada. - **Amostra**: para habilitar a interação diretamente com os dados, o Tableau Prep trabalha com um subconjunto dos seus dados brutos. O número de linhas é determinado pelos tipos de dados e número de campos que estão sendo renderizados. Campos de cadeia de caracteres ocupam mais espaço de armazenamento que inteiros. Dessa forma, se tiver 10 campos de cadeia de caracteres em seu conjunto de dados é possível que obtenha menos linhas do que se tivesse 10 campos de inteiros. Um selo de Amostra ![Um carimbo rotulado "Amostrado", designando que o conjunto de dados de fluxo é apenas uma amostra de todo o conjunto de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_sampledbadge.png) é exibido próximo aos detalhes de tamanho no painel Perfil para indicar que se trata de um subconjunto do conjunto de dados. Você pode modificar a quantidade de dados que inclui em seu fluxo. Ao criar ou editar fluxos na Web, limites de dados adicionais se aplicam. Para obter mais informações, consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#sample). - **Número de valores exclusivos**: o número próximo ao cabeçalho do campo representa os valores distintos contidos nesse campo. O Tableau Prep arredonda para o milhar mais próximo. No exemplo abaixo, há 3.000 valores distintos representados no campo Descrição, mas se passar o cursor pelo número é possível ver o número exato de valores únicos. ![O estado de foco em um cartão de perfil mostrando o número exato de valores para um campo no fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_fields2.png) ## Ver a distribuição de valores ou valores exclusivos Por padrão, o Tableau Prep agrupa valores numéricos, de data e de data/hora de um campo em cestos. Esses cestos também são conhecidos como compartimentos. Os compartimentos garantem que veja a distribuição de valores como um todo e que identifique rapidamente as exceções e valores nulos. O tamanho do compartimento é calculado com base nos valores mínimo e máximo no campo, e os valores nulos sempre são mostrados na parte superior da distribuição. Por exemplo, as datas do pedido e do envio são resumidas ou "compartimentadas” por ano. Cada compartimento representa um ano de janeiro do ano inicial a janeiro do ano seguinte, adequadamente rotulado. Como há datas de venda e de envio que caem na segunda metade de 2018 e 2019, um compartimento é criado para o ano seguinte que contém esses valores. ![Três gráficos de barras mostram a data do pedido, a data de envio e a região. Uma dica de ferramenta é exibida mostrando datas e detalhes do campo.](/tableau/current/pt-br/prep/pt-br/Img/prep_profiletooltip.png) Se um campo de dados discreto (ou categórico) tiver muitas linhas ou uma distribuição tão grande que não possa ser exibida sem rolagem, é possível ver uma distribuição resumida à direita do campo. Você pode clicar e rolar por toda a distribuição para encontrar valores específicos. ![Uma lista de nomes de clientes, organizada em ordem alfabética com um pequeno gráfico de barras horizontais.](/tableau/current/pt-br/prep/pt-br/Img/prep_minimap.png) Quando os dados tiverem campos numéricos ou de data, é possível alternar para exibir a versão detalhada (discreta) ou resumida (contínua) dos valores. A exibição resumida mostra o intervalo de valores em um campo e a frequência com que certos valores aparecem. Essa alternância pode ajudar a isolar valores exclusivos (como o número de “3” registros em um campo) ou a distribuição de valores (como a soma de todos os “3” registros em um campo). Para alternar a exibição: 1. No painel Perfil ou Resultados, ou na grade de dados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) de um campo numérico ou de data. ![No Painel de perfil, menu Mais opções, a opção para alterar o estado de exibição de Detalhes para resumo. ](/tableau/current/pt-br/prep/pt-br/Img/prep_fieldcontextmenu.png) 2. No menu de contexto, selecione Detalhe para ver a versão detalhada dos valores ou Resumo para ver a versão distribuída. ## Pesquisar campos e valores No painel Perfil ou Resultados, é possível pesquisar campos ou valores de seu interesse e usar os resultados da pesquisa para filtrar os dados. A partir da versão 2021.1.1, quando você pesquisa campos, um novo indicador será exibido indicando o número de campos encontrados para que você possa entender melhor os resultados da pesquisa. Se nenhum campo for encontrado, aparecerão mensagens adicionais. Para pesquisar por campos, insira um termo de pesquisa completo ou parcial na caixa de pesquisa na barra de ferramentas. ![Campos de pesquisa no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_searchfields.png) Para pesquisar por um valor em um campo: 1. Clique no ícone de pesquisa ![Ícone Pesquisar.](/tableau/current/pt-br/prep/pt-br/Img/prep_searchicon.png) de um campo e insira um valor. ![Um filtro de Opções de Pesquisa com “Contém” selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_highlighting2.png) 2. Para usar opções de pesquisa avançada, clique no botão Opções de pesquisa.... ![Uma lista de opções de pesquisa e botões para criar um filtro a partir da pesquisa.](/tableau/current/pt-br/prep/pt-br/Img/prep_searchoptions.png) 3. Para usar os resultados de pesquisa para filtrar os dados, selecione Manter apenas ou Excluir. No painel Fluxo, um ícone de filtro é exibido acima das etapas afetadas. ## Copiar valores de campo na grade de dados _Com suporte no Tableau Prep Builder e Tableau Server versão 2022.3 e posterior e no Tableau Cloud versão 2022.2 (agosto) e posterior._ Copie facilmente um conjunto selecionado de valores da grade de dados e cole-os em qualquer documento, como Microsoft Excel, arquivos de texto (.csv), e-mail e muito mais. Você pode até copiá-los e colá-los no editor SQL para executar rapidamente uma consulta SQL. 1. Na grade de dados, selecione um ou mais valores de campo para copiar. 2. Clique com o botão direito do mouse ou clique em cmd (MacOS) nos valores de campo selecionados e selecione Copiar no menu. Você também pode usar os atalhos de teclado Ctrl + C ou cmd + C (MacOS) ou selecionar Copiar no menu ... da barra de ferramentas. ![O menu do botão direito na grade de dados mostrando a opção Copiar.](/tableau/current/pt-br/prep/pt-br/Img/prep_datagrid_copy.png) 3. Cole os campos copiados em seu documento ou local. **Observação**: Editar > Copiar não copia atualmente os valores de campo da grade de dados. ## Classificar valores e campos **Painel Perfil** As opções de classificação em um cartão de perfil permitem classificar os compartimentos (a contagem dos valores representados pelas barras de distribuição) em ordem crescente ou decrescente ou classificar os valores de campo individuais em ordem alfabética. ![Um menu de classificação com opções para classificar em ordem decrescente, crescente, de A a Z ou de Z a A.](/tableau/current/pt-br/prep/pt-br/Img/prep_sort.png) **Grade de dados** Classifique os detalhes do nível de linha dos seus campos em ordem crescente ou decrescente. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_grid_sort_asc.png) ![](/tableau/current/pt-br/prep/pt-br/Img/prep_grid_sort_desc.png) ### Reordenar campos _A alteração da ordem dos campos usando o modo de exibição de lista tem suporte na versão 2022.2.1 e posterior._ Você pode alterar a ordem dos campos no painel Perfil, na grade de dados ou na exibição de lista arrastando-os e soltando-os em uma nova posição. Para reorganizar a ordem dos seus campos: 1. No painel Perfil , painel Resultados, Grade de dados ou exibição **Lista**, selecione um ou mais cartões ou campos de perfil. 2. Arraste o cartão de perfil ou campo até que a linha preta desejada seja exibida. 3. Solte o cartão de perfil ou campo no lugar. O painel Perfil, a grade de dados e a exibição de lista são sincronizados para que o campo apareça na mesma ordem em todos os lugares. A nova ordem dos campos é persistente nos produtos do Tableau ao executar e agendar fluxos. **Reordenação da grade de dados**
Reordene os campos com a reordenação da grade de dados.Os campos foram reordenados com a reordenação da grade de dados.
**Reordenação da exibição de lista**
O painel Perfil na exibição de Lista mostra como arrastar e soltar um campo para alterar a ordem.O painel Perfil na exibição de Lista mostrando os resultados de arrastar um campo para reordená-lo.
## Realçar campos e valores em um fluxo O Tableau Prep facilita a localização de campos e valores nos dados do fluxo. Rastreie onde um campo foi originado e onde ele é usado em todo o fluxo, no painel Fluxo, ou clique em valores individuais em um cartão Perfil ou na grade de dados para realçar valores relacionados ou idênticos. ### Rastrear campos em um fluxo No Tableau Prep, é possível realçar todos os locais onde um campo é usado em um fluxo, até mesmo onde ele foi originado, de forma a ajudar a rastrear valores ausentes ou solucionar problemas em um fluxo quando não estiver recebendo os resultados esperados Clique em um campo no painel Perfil em uma etapa de limpeza ou no painel Resultados em qualquer outra etapa e o painel Fluxo realçará o caminho onde o campo é usado. **Observação:** essa opção não está disponível para tipos de etapa de Entrada ou Saída. ![Um diagrama de fluxo de trabalho que mostra o processo de junção de dados de pedidos e devoluções.](/tableau/current/pt-br/prep/pt-br/Img/prep_lineage.png) ### Ver valores relacionados É possível usar o recurso de destaque para encontrar valores relacionados entre campos. Ao clicar em um valor no cartão Perfil, no painel Perfil ou Resultados, todos os valores relacionados nos outros campos serão destacados em azul. A cor azul mostra a distribuição de relações entre o valor selecionado e os valores em outros campos. Por exemplo, para destacar valores relacionados, no painel Perfil, clique no valor de um campo. Os valores relacionados em outros campos ficam azul e a proporção da barra destacada em azul representa o grau de associação. ![Tabela de dados com várias células destacadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_highlighting.png) ### Destacar valores idênticos Ao selecionar um valor na grade de dados, todos os valores idênticos também são destacados. Esses destaques ajudam a identificar padrões ou irregularidades nos dados. ![Uma tabela de dados que lista as compras dos clientes, com células com o mesmo valor destacadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_highlighting3.png) ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Executar o fluxo > [!IMPORTANT] > > **Importante**: a partir da versão 2020.4.1, Data Management não é mais necessário para executar fluxos manualmente na Web. Ele só será necessário (com o Tableau Prep Conductor habilitado) se você planejar a execução de fluxos de acordo com a agenda. Para gerar sua saída de fluxo, você precisa executar seu fluxo. Ao executar o fluxo, todos os seus dados (não apenas a amostra de dados com a qual você pode estar trabalhando) são executados nas etapas do fluxo. Todas as suas operações de limpeza são aplicadas ao seu conjunto de dados completo, resultando em um conjunto de dados organizado e limpo que agora você pode usar para analisar seus dados. **Observação** : a partir da versão 2021.4.1, ao executar fluxos que incluem parâmetros, você será solicitado a inserir valores de parâmetro. Você deve inserir os valores de parâmetro obrigatórios. Você também pode inserir qualquer valor de parâmetro opcional ou aceitar o valor atual (padrão) para o parâmetro. Para obter mais informações sobre como usar parâmetros em fluxos, consulte [Executar fluxos com parâmetros](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm#run_flows). ## Opções de execução de fluxo Execute seus fluxos manualmente, na linha de comando, usando métodos de fluxo da API REST do Tableau Server ou um agendamento. - **Manual**: execute seus fluxos manualmente a qualquer momento no Tableau Prep Builder e na Web. O Data Management não é necessário. Os fluxos na Web devem ser publicados antes de serem executados. Para obter mais informações, consulte **Tableau Catalog**, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm#publishing-flows) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm#publishing-flows). - **Interface de linha de comando**: se você não tiver o Data Management é possível executar fluxos um de cada vez usando a interface de linha de comando. Para obter mais informações, consulte [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm). - **API REST**: use os métodos de API REST Fluxo e Tarefa de fluxo no Tableau Server para executar fluxos. O Data Management é necessário. Para obter mais informações, consulte [Métodos de fluxo](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm) na Ajuda da API REST do Tableau Server. - **Usando um agendamento**: no Tableau Server e no Tableau Cloud, você pode agendar fluxos únicos para executar ou executar vários fluxos um após o outro usando tarefas vinculadas. Seu servidor deve incluir o Data Management com o Tableau Prep Conductor habilitado. Para obter mais informações, consulte **Tableau Prep Conductor**, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm). Para obter informações sobre como agendar seu fluxo para execução automática, consulte [Agendar uma tarefa de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_online_schedule_flow_task.htm) na ajuda do Tableau Server. ## Executar fluxos manualmente Ao executar fluxos manualmente, você pode executar um fluxo por vez. É possível executar todo o fluxo ou o fluxo para uma saída selecionada. Se estiver executando fluxos na criação na Web (versão 2020.4 e posteriores), o fluxo deve ser publicado no servidor para ser executado e você não pode executar outro fluxo até que o primeiro fluxo esteja concluído, mesmo em uma guia separada. Para obter mais informações, consulte [Publicar um fluxo no Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm). No Tableau Cloud, o número de fluxos que você pode executar em um dia também é limitado pelo administrador do site. Para obter mais informações, consulte o [Capacidade do site do Tableau Cloud](https://help.tableau.com/current/online/pt-br/to_site_capacity.htm) na ajuda do Tableau Cloud. 1. No Tableau Prep Builder ou em seu servidor, abra seu fluxo. 2. Execute um destes procedimentos: - No menu superior, clique em Executar ![O botão Executar fluxo aparece como uma seta voltada para a direita.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow.png) para executar todo o fluxo ou clique na seta suspensa para selecionar uma saída de fluxo na lista. ![Um menu com opções para Criar 'Annual Regional Perform...' e Criar 'Superstore Sales.hyper'.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow2.png) - No servidor, na página Explorar , clique com o botão direito ou clique em Cmd (MacOS)![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) Mais ações e selecione Executar agora no menu. Isso executará todo o seu fluxo. ![O menu suspenso de uma miniatura de fluxo mostra a opção Executar agora para executar o fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_explore_runflow.png) - Clique em uma etapa de Saída em seu fluxo e, no painel Saída, clique em Executar Fluxo. Se o fluxo não estiver aberto na Web, você precisará clicar em Editar fluxo para abrir seu fluxo no modo de edição e, em seguida, clicar em Publicar para publicar o fluxo ou aceitar o prompt para publicar o fluxo e clicar em Executar fluxo. ![Botão para Executar fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow3.png) [Pular para o conteúdo principal](#main-content) # Filtrar dados **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). O Tableau Prep fornece várias opções que podem ser usadas para filtrar seus dados. Por exemplo, use Manter apenas ou Excluir para filtrar com um clique em um valor específico de um campo em um cartão Perfil, uma grade de dados ou um cartão de resultados, ou selecione entre uma variedade de opções de filtro para necessidades de filtro mais complexas. Você também pode manter ou remover campos inteiros. Filtre dados em qualquer etapa do fluxo. Se você quiser simplesmente alterar um valor específico, poderá selecionar Editar valor para editar o valor em linha ou substituir o valor por Nulo. Para obter mais informações sobre como editar valores de campo, consulte [Editar valores de campo](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#editvalues). ![A opção de menu do botão direito em um valor de campo mostrando a opção de menu Excluir.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_values.png) ## Manter ou remover campos À medida que você trabalha com seus dados no fluxo, talvez queira remover campos indesejados. No painel Perfil ou na grade de dados em qualquer etapa de limpeza ou ação, selecione um ou mais campos e clique com o botão direito do mouse (MacOS) e selecione Remover para remover os campos selecionados ou selecione Manter apenas (Tableau Prep Builder versão 2019.2.2 e posterior e na Web) para manter somente os campos selecionados e remover todos os campos não selecionados. ![Uma tabela de dados com opções para classificar por data do pedido, região e data de envio.](/tableau/current/pt-br/prep/pt-br/Img/prep_keep_only_fields.png) ## Ocultar campos _Com suporte no Tableau Prep Builder versão 2021.1.4 e posteriores e no Tableau Server ou Tableau Cloud a partir da versão 2021.1._ Se você tiver campos em seu fluxo que não precisam de limpeza, mas ainda quiser incluí-los no fluxo, poderá ocultar os campos em vez de removê-los. Os dados desses campos não serão carregados até que você reexiba os campos ou execute seu fluxo para gerar a saída. Quando você oculta campos, um novo cartão de perfil chamado Campos ocultos é adicionado automaticamente ao painel Perfil, permitindo que você reexiba campos com facilidade na lista conforme necessário. Você pode incluir campos ocultos na maioria das operações, mas uniões de colunas, agregações e tabelas dinâmicas exigem que o campo seja reexibido para usá-lo em um desses tipos de etapa. Se você ocultar o campo após ele ter sido usado em uma dessas operações, o campo aparecerá como oculto e a operação não será afetada. Todos os campos ocultos são marcados com um ícone de olho ![Um ícone de olho riscado com uma linha diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_icon.png). ![Uma tabela de dados com um cursor pairando sobre um campo oculto.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_output.png) ### Ocultar e reexibir campos Para ocultar ou reexibir campos, você deve estar em uma etapa de Entrada ou em uma etapa de Limpeza. Na etapa de Limpeza, você pode ocultar ou reexibir campos no painel Perfil, na grade de data e na exibição Lista. **Na etapa de Entrada** 1. Conecte-se aos seus dados. 2. Na etapa de Entrada, selecione o campo que deseja ocultar ou reexibir. 3. Clique no ícone de olho ![Um ícone de olho riscado com uma linha diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_icon.png) para ocultar ou reexibir o campo. A seleção múltipla de campos na etapa de entrada é aceita a partir da versão 2023.1. ![Uma tabela de dados e um cursor pairando sobre um ícone para ocultar um campo.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_input.png) **No painel Perfil** 1. Selecione os campos que deseja ocultar. 2. Clique com o botão direito do mouse, pressione Ctrl e clique (MacOS) no menu Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png), ou no menu da barra de ferramentas, selecione Ocultar campo ou Ocultar campos. ![Uma coluna de tabela de dados selecionada e "Ocultar campos" selecionado.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields.png) 3. Um novo cartão de perfil é gerado mostrando os campos ocultos. ![Um cartão de perfil em um fluxo do Tableau Prep mostrando campos ocultos, designados por um ícone de um olho com uma linha atravessando-o.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_card.png) 4. Para reexibir campos, no cartão de perfil Campos ocultos, selecione um ou mais campos; e clique no ícone de olho ![Um ícone de olho riscado com uma linha diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_icon.png), clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) e selecione Reexibir campos no menu. **Na exibição Lista** 1. Em uma etapa de Limpeza, na barra de ferramentas, clique no ícone de exibição Lista ![O ícone Exibição de lista para alterar o painel Perfil de cartões para uma lista de campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_list_view_icon.png) para mudar para a exibição de lista. 2. Selecione um ou mais campos para ocultar ou reexibir. 3. Clique no ícone de olho ![Um ícone de olho riscado com uma linha diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_icon.png) para ocultar ou reexibir os campos. ![Uma tabela de dados com um cursor pairando sobre o ícone de exibição de campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_list.png) ## Filtros disponíveis para cada tipo de dados
Tipo de dadosFiltros disponíveis
Cadeia de caracteresCálculo, Correspondência curinga, Valores nulos, Valores selecionados
NúmeroCálculo, Intervalo de valores, Valores nulos, Valores selecionados
Data e Data e horaCálculo, Intervalo de datas, Data relativa, Valores nulos, Valores selecionados
## Onde estão minhas opções de filtro? Para ver as diferentes opções de filtro disponíveis para os campos, no cartão Perfil, na grade de dados ou no painel de resultados, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png). Para ver o menu na grade de dados, clique primeiro no botão Ocultar painel Perfil e depois clique em Mais opções![Um ícone de um retângulo com dois retângulos menores acima dele.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_show_profileicon.png) ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png).
O menu de filtro Mais opções para um campo de data.O menu Mais opções de filtro para um campo de texto.
## Filtro de cálculo Ao selecionar Cálculo, a caixa de diálogo Adicionar filtro é aberta. Insira o cálculo, verifique se é válido e clique em Salvar. A partir da versão 2021.4.1, você também pode incluir parâmetros nos filtros de cálculo. Para obter mais informações, consulte [Aplicar parâmetros de usuário para filtrar cálculos](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm#filter_parameters). **Observação:** na etapa de entrada, este é o único tipo de filtro disponível. Todos os outros tipos de filtro estão disponíveis nos cartões Perfil, na grade de dados ou no painel de resultados. ![O Editor de cálculo mostra como adicionar um filtro com um campo calculado.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_calc.png) ## Filtro de valores selecionados No Tableau Prep Builder versão 2019.2.3 e posterior e na Web, você pode usar o filtro Valores selecionados para escolher os valores que deseja manter ou excluir de um campo, mesmo valores que não estão em sua amostra. No painel direito, clique na guia Manter apenas ou Excluir para selecionar a ação e, em seguida, insira os termos de pesquisa para procurar valores ou clique em Adicionar um valor ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar valores que estão no seu conjunto de dados, mas não estão incluídos na amostra. Clique em Concluir para aplicar o filtro. **Observação:** essas opções de filtro não estão disponíveis para os tipos de etapa Agregação ou Dinamização . ![Valores selecionados para um filtro.](/tableau/current/pt-br/prep/pt-br/Img/prep_select_filter2.png) ## Filtro de intervalo de valores Filtre valores que estão em um intervalo específico. Ao selecionar Intervalo de valores, é possível especificar um intervalo ou definir valor mínimo e máximo. ![A caixa de diálogo Filtro para Intervalo de datas, mostrando a guia Intervalo.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_range.png) ## Filtro de intervalo de datas Filtre valores que estão em um intervalo de datas específico. Ao selecionar Intervalo de datas, é possível especificar um intervalo de datas ou definir uma data mínima e máxima. ![A caixa de diálogo Filtro para Intervalo de datas, mostrando a guia Mínimo.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_date_range.png) ## Filtro de data relativa Use o filtro Datas relativas para especificar o intervalo exato de anos, trimestres, meses, semanas ou dias que você deseja ver nos dados. Além disso, é possível configurar uma referência relativa a uma data específica e incluir valores nulos. **Observação:** os períodos de data "última" incluem a unidade de tempo atual completa, mesmo que algumas datas ainda não tenham ocorrido. Por exemplo, se você selecionar o último mês e a data atual for 7 de janeiro, o Tableau exibirá as datas de 1 a 31 de janeiro. ![A caixa de diálogo Filtro para Datas Relativas.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_date.png) ## Filtro de correspondência curinga Ao selecionar Correspondência curinga, é possível filtrar os valores de campo para manter ou excluir os valores que correspondam a um padrão. No editor de filtros, selecione a guia Manter apenas ou Excluir, insira um valor a ser correspondido e depois defina os critérios Opções de correspondência para retornar os valores que está procurando. Os resultados filtrados são exibidos no painel à esquerda do editor de filtros para que você possa revisar e experimentar com os resultados. Assim que tiver os resultados desejados, clique em Concluído para aplicar a alteração. ![Um filtro que permite aos usuários incluir ou excluir produtos que correspondem a uma sequência de texto curinga.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_wcmatch.png) ## Filtro de valores nulos Ao selecionar Valores nulos, é possível filtrar os valores no campo selecionado para mostrar apenas os valores nulos ou excluir todos os valores nulos. ![A caixa de diálogo Filtro para valores nulos.](/tableau/current/pt-br/prep/pt-br/Img/prep_filter_null.png) [Pular para o conteúdo principal](#main-content) # Introdução ao Tableau Prep Builder **Observação**: a partir da versão 2020.4.1, como Criador, é possível criar e editar fluxos na web. Este tutorial foi criado usando o Tableau Prep Builder, mas também pode ser seguido na Web com algumas exceções indicadas. Este tutorial introduz as operações usuais disponíveis no Tableau Prep. Usando os conjuntos de dados de amostra do Tableau Prep, você será guiado pela criação de um fluxo para o Sample Superstore. Este tutorial usa a versão mais atual do Tableau Prep Builder. Caso esteja usando uma versão anterior, seus resultados podem ser diferentes. Assista às dicas por todo o processo para receber informações sobre como o Tableau Prep o ajuda a limpar e formatar seus dados para análise. Para instalar o Tableau Prep Builder antes de prosseguir com este tutorial, consulte [Instalar o Tableau Desktop ou o Tableau Prep Builder usando a interface do usuário](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm) no Guia de implantação do Tableau Desktop e do Tableau Prep Builder. Como alternativa, você pode baixar a [avaliação gratuita](https://www.tableau.com/pt-br/products/prep/download). #### Arquivos de amostra Para completar as tarefas neste tutorial, você precisa instalar o Tableau Prep Builder ou, se a criação na Web estiver habilitada na versão 2020.4 (ou posterior) do servidor, você também pode seguir essas etapas na Web. Após instalar o Tableau Prep Builder em sua máquina, os arquivos de amostra estarão no seguinte local: - (Windows) `C:\Program Files\Tableau\Tableau Prep Builder \help\Samples\en_US\Superstore Files` - (Mac) `/Applications/Tableau Prep Builder .app/Contents/help/Samples/en_US/Superstore Files` Como alternativa, baixe os arquivos de amostra nos links abaixo e crie um diretório de Amostras e um subdiretório Sul. Esses passos são necessário para seguir este tutorial na Web.
Baixe para o diretório AmostrasDownload para o subdiretório Sul
## Esta é a história... Você trabalha na sede de uma grande rede varejista. Seu chefe deseja analisar as vendas do produto e os lucros da empresa dos últimos quatro anos. Você sugere que ele use o Tableau Desktop para isso. Ele acha uma ótima ideia e quer que você comece logo a tarefa. Conforme começa a juntar os dados necessários, você percebe que eles foram coletados e monitorados de forma diferente para cada região. Além disso, você percebe muitas entradas de dados criativos nos diversos arquivos, e que uma região possui até mesmo um arquivo separado para cada ano! Antes que possa começar a analisar os dados no Tableau será necessário limpá-los antes. Será uma longa noite. Ao procurar por menus de restaurantes para pedir o jantar, você se lembra de que o Tableau tem um produto chamado Tableau Prep, que pode ajudá-lo com sua tarefa hercúlea de limpeza de dados. Você baixa o produto ou assina uma [avaliação gratuita](https://www.tableau.com/pt-br/products/prep/download) e decide experimentar. ## 1\. Conectar a dados A primeira tela que você vê ao abrir o Tableau Prep Builder é uma página inicial com um painel Conexões, igual ao Tableau Desktop. ![Página inicial do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_startpage2.png) Para começar, a primeira etapa é se conectar aos dados e criar uma etapa de entrada. A partir daí você começa a criar um fluxo de trabalho ou “fluxo”, como é chamado no Tableau Prep, e a adicionar mais etapas para agir sobre os dados conforme prossegue. > [!TIP] > > **Dica**: a etapa de entrada é um ponto de inserção de dados e o ponto inicial do fluxo. É possível ter várias etapas de entrada e algumas podem incluir vários arquivos de dados. Para obter mais informações sobre como se conectar a dados, consulte [Conectar a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm). Os arquivos de dados de vendas de diferentes regiões são armazenados em formatos diferentes e os pedidos do Sul são, na verdade, vários arquivos. Você dá uma olhada no painel Conexões e vê que há várias alternativas para se conectar aos dados. Ótimo! Como as outras regiões têm apenas um arquivo para todos dados de quatro anos, você decide tratar os arquivos do Sul antes. 1. No painel Conexões, clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Em criação na Web, na página Início, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Em seguida, clique em Conectar a dados. 2. Os arquivos estão no formato .csv, então selecione Arquivo de texto na lista de conexões. 3. Navegue até o diretório dos seus arquivos. No subdiretório Pedidos - Sul, selecione o primeiro arquivo **orders\_south\_2015** e clique em Abrir para adicioná-lo ao fluxo. (Para obter a localização do arquivo, consulte [Conclusão e recursos](#Wrap).) Depois de se conectar ao primeiro arquivo, a área de trabalho do Tableau Prep Builder é aberta e você pode perceber que é dividida em duas seções principais. O painel **Fluxo** na parte superior e o painel **Entrada** na inferior. ![Uma interface do Tableau Prep exibe configurações de etapas de entrada para detalhes do pedido.](/tableau/current/pt-br/prep/pt-br/Img/prep_get_started_step3.png) Assim como no Tableau Desktop, o painel **Fluxo** é a sua área de trabalho, onde você pode interagir com os dados visualmente e criar seu próprio fluxo. O painel **Entrada** contém opções de configuração de como os dados são inseridos. Também mostra os campos, tipos de dados e exemplos de valores do conjunto de dados. Veremos como vai interagir com esses dados na próxima seção. > [!TIP] > > **Dica**: em tabelas únicas, o Tableau Prep cria automaticamente uma etapa de entrada no painel **Fluxo** ao adicionar dados ao fluxo. Como alternativa, você pode usar o recurso de arrastar e soltar para adicionar tabelas ao painel Fluxo. 4. Você tem outros três arquivos para seus pedidos no Sul, e como poderá agrupá-los vai depender de onde estiver trabalhando. No Tableau Prep Builder: 1. Você poderia adicionar cada arquivo individualmente, mas deseja agrupar todos eles em uma etapa de entrada, então clica na guia Tabelas no painel **Entrada**. 2. Você vê uma opção de Tabelas de várias uniões de linhas. Selecione-a. Você percebe que o diretório onde selecionou seu arquivo já foi preenchido e que os outros arquivos necessários foram listados na seção Tabelas incluídas no painel Entrada. > [!TIP] > > **Dica**: usar uma união de linhas de entrada é uma ótima forma de conectar e combinar vários arquivos de uma única fonte de dados com nome e estrutura semelhantes. Para usar essa opção, os arquivos devem estar no mesmo diretório principal ou secundário. Caso não veja os arquivos que precisa imediatamente, altere o critério de pesquisa. Para obter mais informações, consulte [Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#Union). ![Uma interface do Tableau Prep exibe fontes de dados e campos disponíveis.](/tableau/current/pt-br/prep/pt-br/Img/prep_get_started_step4.png) 3. Clique em Aplicar para adicionar os dados desses arquivos à etapa de entrada orders\_south\_2015. 4. Os arquivos das outras regiões são arquivos de tabela única, então é possível selecionar todos de uma vez e adicioná-los ao fluxo. **Observação**: na Web, os arquivos só podem ser carregados individualmente. No Tableau Server ou no Tableau Cloud: A opção de união de linhas está disponível atualmente no Tableau Server ou no Tableau Cloud. Ainda assim, você quer incluir todos os arquivos do Sul e lidar com esses dados da mesma forma, então agrupá-los faz sentido. 1. Repita as etapas 2 e 3 para adicionar o resto dos arquivos do subdiretório Pedidos - Sul. 2. Agrupe-os usando uma etapa do tipo União de linhas. (para obter mais detalhes, consulte [Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#Union).) 1. Arraste Orders\_South\_2016 em cima de Orders\_South\_2015 e solte sobre a opção Unir linhas. ![Na tela do Tableau Prep, arrastando uma etapa para outra para uni-las.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_union.png) 2. Arraste Orders\_South\_2017 em cima da nova etapa Unir linhas e solte sobre Adicionar. Repita esta etapa com o último arquivo. ![Na tela do Tableau Prep, arrastando uma etapa para o botão Adicionar para adicioná-la a uma união existente.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_union2.png) 5. Adicione os arquivos restantes ao seu fluxo. **No Tableau Prep Builder:** - Abra o Pesquisador ou Localizador de arquivos e navegue até o diretório dos arquivos. Pressione Ctrl ou Cmd e clique (MacOS) para selecionar os arquivos a seguir e arraste e solte-os no painel **Fluxo** para adicioná-los ao fluxo. (Para obter a localização do arquivo, consulte [Conclusão e recursos](#Wrap).) - Orders\_Central.csv - Orders\_East.xlsx - Orders\_West.csv **Observação**: há diferentes tipos de arquivo. Caso você não veja todos esses arquivos, garanta que o seu navegador ou descobridor de arquivos está definido como visualizar todos os tipos de arquivo. ![Etapa de entrada com a guia Tabelas aberta mostrando a união de várias tabelas selecionadas e uma tabela de dados de tabelas incluídas.](/tableau/current/pt-br/prep/pt-br/Img/prep_get_started_step5.png) No Tableau Server ou no Tableau Cloud: - Siga as etapas 2 e 3 para adicionar os arquivos Orders\_Central.csv e Orders\_West.csv. - No painel Conexões, clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Clique no **Microsoft Excel** e selecione **Orders\_East.xlsx**. ### Verifique seu trabalho: veja “Conectar a dados” em ação _Clique na imagem para reproduzi-la_ ![Conecte-se aos dados no Tableau.](/tableau/current/pt-br/prep/pt-br/Img/getStarted_add_files.gif) ## 2\. Explorar os dados Agora que tem os arquivos de dados carregados no Tableau Prep, você tem certeza de que deseja combinar todos os arquivos. Mas antes de fazer isso, pode ser uma boa ideia analisá-los e ver se encontra algum problema. Ao selecionar uma etapa de entrada no painel **Fluxo**, você poderá ver as configurações usadas para trazer os dados, os campos incluídos e uma visualização dos valores. Esse é um bom momento para decidir quantos dados deseja incluir no fluxo e remover ou filtrar os campos que não deseja. Além disso, é possível alterar quaisquer tipos de dados que foram atribuídos incorretamente. > [!TIP] > > **Dica**: se estiver trabalhando com grandes conjuntos de dados, o Tableau Prep trará automaticamente uma amostra dos dados para melhorar o desempenho. Caso não veja os dados esperados, pode ser necessário ajustar a amostra. Você pode fazer isso na guia Amostra de dados. Para obter mais informações sobre as opções de configuração de dados e o tamanho da amostra, consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#sample). No painel Fluxo, ao selecionar cada etapa e analisar cada conjunto de dados, você percebe algumas coisas que desejará alterar posteriormente e uma coisa que deseja corrigir agora na etapa de Entrada. - Selecione a etapa de entrada **Orders\_West**. - O campo Estado usa abreviações do nome de estado. Outros arquivos escrevem o nome completo, então será necessário corrigir isso posteriormente. - Há muitos campos que começam com **Right\_**. Esses campos parecem duplicatas de outros campos. Você não deseja incluí-las no fluxo. Isso é algo que pode ser corrigido logo na etapa de Entrada: **Para corrigir agora**, selecione Lista de campos ![O botão Lista de campos na etapa de entrada Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_get_started_field_list_button.png) para alternar a exibição para a lista de campos. Em seguida, selecione todos os campos na lista que começam com **Right\_**. Focalize em qualquer um dos campos selecionados e clique na opção ![Um ícone "X" que, quando clicado, remove os campos selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_get_started_remove_fields.png) Remover. Isso instrui que o Tableau Prep ignore esses campos e não os inclua no fluxo. ![Uma tela do Tableau Prep exibe campos do conjunto de dados Orders\_West.](/tableau/current/pt-br/prep/pt-br/Img/prep_get_started_Right.png) > [!TIP] > > **Dica**: ao realizar operações de limpeza em uma etapa, como remover campos, o Tableau Prep rastreia as suas alterações no painel Alterações e adiciona uma anotação (no formato de um ícone pequeno) no painel Fluxo para ajudá-lo a acompanhar as ações que você toma em relação aos seus dados. Para etapas de entrada, uma anotação também é adicionada a cada campo. - No painel Fluxo, clique na etapa de entrada **Orders\_Central** para selecioná-la. No painel Entrada, você observa os problemas a seguir: - As datas de pedido e de envio estão separadas em campos para mês, dia e ano. - Alguns dos campos possuem tipos de dados diferentes dos mesmo campos em outros arquivos. - Não há um campo para Região. Você precisará limpar esses campos antes de agrupar esse arquivo aos outros. Mas não é possível corrigir isso nesta etapa de Entrada, então você faz uma anotação para corrigir posteriormente. - Selecione a etapa de entrada **Orders\_East**. Os campos neste arquivo parecem ter se alinhado bem com os outros. Mas os valores de Vendas parecem ter o código da moeda incluso. Também será necessário corrigir isso. Agora que identificou os problemáticos nos conjuntos de dados a próxima etapa é examinar os dados com mais cuidado e limpar qualquer problema encontrado, para que possa agrupar e formatar os dados, além de gerar um arquivos de saída que possa usar para análise. ## 3\. Limpar seus dados No Tableau Prep, examinar e limpar os dados é um processo iterativo. Após decidir com qual conjunto de dados deseja trabalhar, a próxima etapa é examinar e agir nesses dados ao aplicar várias operações de limpeza, formatação e agrupamento neles. Você aplica essas operações adicionando etapas ao fluxo. Para obter mais informações sobre as opções de limpeza, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) Dependendo do que esteja tentando fazer, as etapas são diversas. Por exemplo, adicione uma etapa de limpeza a qualquer momento para aplicar operações de limpeza nos campos como filtrar, mesclar, dividir, renomear, entre outros. Adicione uma etapa de agregação para agrupar e agregar campos e alterar o nível de detalhe dos dados. Para obter mais informações sobre os diferentes tipos de etapa e seus usos, consulte [Criar e organizar o fluxo](https://help.tableau.com/current/prep/pt-br/prep_build_flow.htm). > [!TIP] > > **Dica**: ao adicionar etapas ao fluxo, uma linha de fluxo é adicionada automaticamente para conectar as etapas umas às outras. É possível mover essas linhas de fluxo e removê-las ou adicioná-las conforme necessário. > > Ao executar o fluxo, esses pontos de conexão são solicitados, para que o Tableau Prep saiba quais etapas estão conectadas e em qual ordem elas são aplicadas ao fluxo. Se a linha de fluxo estiver ausente, o fluxo será quebrado e resultará em erro. ### Limpar Orders\_Central Para solucionar os problemas observados anteriormente e identificar qualquer outro, comece adicionando uma etapa de limpeza à etapa de entrada **Orders\_Central**. 1. No painel Fluxo, selecione o arquivo Orders\_Central e siga um destes procedimentos: - Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e adicione uma etapa de limpeza. Dependendo da sua versão, essa opção de menu é Adicionar etapa, Adicionar etapa de limpeza ou Etapa de limpeza. - Clique na etapa de limpa sugerida (Tableau Prep Builderversão 2020.3.3 e posterior e na Web) ![Um fluxo do Tableau Prep mostra uma etapa de entrada e uma etapa de limpeza sugerida.](/tableau/current/pt-br/prep/pt-br/Img/prep_autoclean_step.png) Após adicionar uma etapa de limpeza ao fluxo, a área de trabalho é alterada e você vê os detalhes dos dados. ![Partes do fluxo: A. Painel Fluxo, B. Barra de ferramentas, C. Painel Perfil, D. Grade de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_cleaningstep2.png) A. Painel Fluxo, B. Barra de ferramentas, C. Painel Perfil, D. Grade de dados A área de trabalho agora está dividida em três partes: o painel Fluxo, o painel Perfil com uma barra de ferramentas e a grade de Dados. O painel **Perfil** mostra a estrutura dos dados, resumindo os valores de campo em compartimentos, para que possa ver rapidamente valores relacionados e identificar exceções e valores nulos. A grade de Dados mostra o detalhe de nível de linha dos campos. > [!TIP] > > **Dica**: cada campo do painel Perfil é mostrado em um cartão de perfil. Use o menu Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) em cada cartão para ver e selecionar as diferentes opções de limpeza disponíveis para esse tipo de campo. Além disso, é possível classificar os valores de campo, alterar o tipo de dados, atribuir uma função de dados ao campo ou arrastar e soltar os cartões de perfil e as colunas na grade de Dados para reorganizá-los. Limpar dados com campos calculados Este conjunto de dados não tem o campo **Região**. Como os outros conjuntos de dados têm esse campo, será necessário adicioná-lo para que possa agrupar os dados posteriormente. Será necessário usar um campo calculado para isso. 2. Na barra de ferramentas, clique em Criar campo calculado. 3. No editor de Cálculo, nomeie a **Região** do campo calculado.. Em seguida, insira **"Central"** (incluindo as aspas) e clique em **Salvar**. ![O Editor de cálculo mostra a sintaxe de cálculo para criar um campo chamado "Região" com um valor chamado "Central".](/tableau/current/pt-br/prep/pt-br/Img/prep_calc1.png) Você adora a flexibilidade de poder usar campos calculados para formatar os dados. Está contente em ver que o Tableau Prep usa o mesmo idioma do editor de cálculo que o Tableau Desktop. > [!TIP] > > **Dica**: ao fazer alterações nos campos e valores, o Tableau Prep os monitora no painel Alterações à esquerda. Um ícone (anotação) representando a alteração também é adicionado à etapa de limpeza no fluxo e ao campo no painel Perfil. Veremos o painel Alterações após fazer mais alterações. Em seguida, você deseja tratar os campos de datas de pedido e de envio separados. Você deseja agrupá-los em dois campos únicos, um para **Data de pedido** e outro para **Data de envio**, para que se alinhem com os mesmos campos dos outros conjuntos de dados. Certificar-se de que as tabelas têm os mesmos campos permitirá que, posteriormente, você as combine usando uma união de linhas. É possível usar um campo calculado novamente para fazer isso em uma simples etapa. 4. Na barra de ferramentas, clique em Criar campo calculado para agrupar os campos Ano do pedido, Mês do pedido e Dia do pedido em um só campo com o formato "MM/DD/AAAA". 5. No Editor de cálculo, nomeie a **Data do pedido** do campo calculado. Em seguida, insira o cálculo a seguir e clique em Salvar: `MAKEDATE([Order Year],[Order Month],[Order Day])` ![O Editor de cálculo mostra a sintaxe de cálculo para criar um campo chamado "Data do pedido" usando a função MAKEDATE.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc2.png) Agora que tem um novo campo para a data do pedido, você deseja remover os campos existentes, como não precisa mais deles. Há muitos campos no painel Perfil. Você observa uma caixa de Pesquisa no canto superior direito da barra de ferramentas. Você se pergunta se pode usá-la para encontrar rapidamente os campos que deseja remover. E decide tentar. 6. No painel Perfil, na caixa de pesquisa, digite Pedido. ![Pesquise o campo de pedido no Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_searchprofile.png) O Tableau Prep rapidamente rola todos os campos com Pedido no nome na exibição. Legal! 7. Pressione Ctrl ou Cmd e clique (MacOS) para selecionar os campos para Ano do pedido, Mês do pedido e Dia do pedido. Em seguida, clique com o botão direito do mouse nos campos selecionados e selecione Remover (Remover campo nas versões anteriores) no menu para removê-los. ![Vários campos selecionados no Tableau Prep com a opção de removê-los destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_multiselect_fields.png) 8. Agora repita as etapas de 4 a 7 acima para criar um campo único de Data do envio. Tente fazer sozinho ou use as etapas acima para ajudá-lo. - Na barra de ferramentas, clique em Criar campo calculado para agrupar os campos Ano do envio, Mês do envio e Dia do envio em um só campo com o formato "MM/DD/AAAA". - Nomeie o campo calculado **Data do envio** e insira o cálculo `MAKEDATE([Ship Year],[Ship Month],[Ship Day])`. Em seguida, clique em **Salvar**. - Remova os campos Ano do envio, Mês do envio e Dia do envio. Pesquise os campos, selecione-os e selecione Remover (Remover campo nas versões anteriores) no menu para remover os campos. > [!TIP] > > **Dica**: o Tableau Prep resume os dados no painel Perfil em compartimentos para ajudá-lo a ver rapidamente o formato dos dados, encontrar exceções, identificar relações entre campos, entre outros. > > Nesse cenário, as datas de pedido e de envio agora podem ser resumidas por ano. Cada compartimento representa um ano de janeiro do ano inicial a janeiro do ano seguinte, adequadamente rotulado. Como há datas de pedido e de envio que caem na segunda metade de 2018 e 2019, obtemos um compartimento para esses dados rotulado com o ano final de 2019 e 2020. > > Para alterar essa exibição para as datas reais, clique no menu Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) no cartão Perfil e selecione Detalhe. > ![Dois campos em um painel Perfil de fluxo do Tableau mostram dados agrupados em compartimentos e representados como um gráfico de barras horizontais.](/tableau/current/pt-br/prep/pt-br/Img/prep_bins_example.png) Interagir diretamente com campos para limpar os dados Seus dados estão tomando forma. Mas, conforme conclui a remoção de campos adicionais das datas de pedido e de envio, você observa que o campo Descontos apresenta alguns problemas. - Ele está atribuído a um tipo de dados de Cadeia de caracteres em vez de Numérico (decimal). - Há um valor de campo Nenhum em vez de um valor numérico para nenhum desconto. Isso causa um problema ao agrupar os arquivos, então melhor corrigir isso também. 9. Limpe a pesquisa e insira desc na caixa de pesquisa para encontrar o campo. 10. Selecione o campo Descontos, clique duas vezes no valor de campo Nenhum e altere-o para o valor numérico 0. 11. Para alterar o tipo de dados do campo Desconto de Cadeia de caracteres para Número (decimal), clique em Abc e selecione Número (decimal) no menu suspenso. ![Um menu suspenso com opções de tipo de dados destacadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_change_type.png) 12. Finalmente, nomeie a etapa para ajudar a monitorar o que foi feito nela. No painel Fluxo, clique duas vezes no nome da etapa Limpeza 1 e digite Datas de correção/nomes de campo. #### Revisar alterações Você fez muitas alterações neste conjunto de dados e agora começa a se preocupar em não se lembrar de tudo o que fez. Ao olhar para o seu trabalho, você vê uma coluna à esquerda do painel Perfil chamada Alterações. Você clica na seta para abrí-la e fica contente em ver uma lista de todas as alterações feitas. Ao rolar pelas alterações na lista, observa que pode excluir, editar e até movê-las para alterar a ordem em que eles foram feitas. Você adora o fato de poder encontrar facilmente as alterações feitas em qualquer etapa conforme cria o fluxo e faz testa a ordem delas para obter o máximo de seus dados. ![Um fluxo do Tableau Prep com uma etapa de limpeza selecionada e o painel Alterações aberto mostrando a lista de todas as ações de limpeza.](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_fix_dates.png) ### Verifique seu trabalho: veja “Limpar Orders\_Central” em ação. _Clique na imagem para reproduzi-la_ Agora que limpou um arquivo, dê uma olhada nos outros arquivos para ver quais outros problemas precisam ser corrigidos. Você decide olhar o arquivo Excel de **Orders\_East** em seguida. ### Limpar Orders\_East Ao olhar os campos do arquivo **Orders\_East**, a maioria deles parece se alinhar aos outros arquivos, exceto **Vendas**. Para analisar melhor e ver se há outro problema a ser solucionado, adicione uma etapa de limpeza à etapa de entrada **Orders\_East**. 1. No painel Fluxo, selecione o arquivo **Orders\_East** e siga um destes procedimentos: - Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e adicione uma etapa de limpeza. Dependendo da sua versão, essa opção de menu é Adicionar etapa, Adicionar etapa de limpeza ou Etapa de limpeza. - Clique na etapa de limpeza sugerida (Tableau Prep Builderversão 2020.3.3 e posterior e na Web). Observando o campo Vendas, você pode ver rapidamente que o código de moeda USD foi incluído com os números de venda, e que o Tableau Prep interpretou esses valores como uma cadeia de caracteres. Será necessário remover o código de moeda desse campo e alterar o tipo de dados se quiser obter dados de vendas precisos. Corrigir o tipo de dados é fácil, você já sabe como fazer isso. Mas há mais de 2.000 linhas exclusivas de dados de vendas e corrigir cada uma individualmente para remover o código de moeda parece uma tarefa complexa. Porém, esse é o Tableau Prep, e você decide dar uma olhada no menu suspenso para ver se há uma opção para corrigir isso. Ao clicar em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) do campo **Vendas**, você vê uma opção de menu chamada Limpar e outra opção embaixo dela para remoção de letras. Você decide tentar e ver o que ela faz. 2. Selecione o campo Vendas. Clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) e selecione Limpar > Remover letras. ![A função Remover letras remove instantaneamente o código de moeda de todos os campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_removeletters.png) Nossa! Essa opção de limpeza removeu instantaneamente o código de moeda de todos os campos. Agora só precisa alterar o tipo de dados de Cadeia de caracteres para Numérico (decimal) e este arquivo estará pronto. 3. Clique no tipo de dados do campo Vendas e selecione Número (decimal) na lista suspensa para alterar o tipo de dados. ![Um fluxo do Tableau Prep mostra os resultados da aplicação da opção de limpeza "Remover letras".](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_east2.png) 4. O restante do arquivo está correto. Nomeie sua etapa de limpeza para monitorar seu trabalho. Por exemplo, **Alterar tipo de dados**. Em seguida, você olha o último arquivo do **Orders\_West** para ver se há problemas que precisam ser corrigidos. ### Limpar Orders\_West Ao analisar os campos do arquivo **Orders\_West**, a maioria dos arquivos parecem estar alinhada ao outros, mas você se lembra de ter visto que o campo **Estados** usou abreviações para os valores em vez de escrever o nome do estado completo. Para agrupar esse arquivo com os outros será necessário corrigir isso. Então você adiciona uma etapa de limpeza à etapa de entrada **Orders\_West**. 1. No painel Fluxo, selecione o arquivo **Orders\_West** e siga um destes procedimentos: - Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e adicione uma etapa de limpeza. - Clique na etapa de limpeza sugerida (Tableau Prep Builderversão 2020.3.3 e posterior e na Web). 2. Role ou use Pesquisar para encontrar o campo **Estado**. Você vê que todos os valores de nome de estado usam a abreviação. Há apenas 11 valores exclusivos para esse campo. É possível alterar manualmente cada um, mas será que o Tableau Prep tem outra forma de fazer isso? Clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) do campo e veja uma opção chamada **Agrupar valores** (Agrupar e substituir em versões anteriores). Ao selecioná-la, você vê várias opções: - Seleção manual - Pronúncia - Caracteres usuais - Ortografia Os nomes de estado não têm a mesma pronúncia, não estão escritos de maneira incorreta e não compartilham os mesmos caracteres, então você decide tentar a opção Seleção manual. > [!TIP] > > **Dica**: você pode clicar duas vezes em um nome de campo ou valor de campo pra editar um valor único. Para editar vários valores, é possível selecionar todos eles e usar a opção do menu de clique com o botão direito Editar valores. Entretanto, quando quiser mapear um ou mais valores para valores específicos, use a opção Agrupar valores no menu suspenso. > Para obter mais informações sobre como editar ou agrupar valores, consulte [Editar valores de campo](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#editvalues). 3. Selecione o campo Estado. Clique na seta suspensa e selecione Agrupar valores (Agrupar e substituir em versões anteriores) > Seleção manual. ![Uma tabela de abreviações de estados do oeste dos EUA com um menu "Agrupar valor por" aberto e "Seleção manual" selecionada. ](/tableau/current/pt-br/prep/pt-br/Img/prep_group.png) Um cartão de duas colunas é aberto. Esse é o editor **Agrupar valores**. A coluna à esquerda mostra os valores de campo atuais e, a à esquerda, os campos disponíveis para mapeamento aos campos da esquerda. Você deseja mapear as abreviações de estado para a versão de nome completo, mas não tem esses valores no conjunto de dados Orders\_West. Em seguida, se pergunta se pode apenas editar o nome diretamente e talvez adicioná-lo, então decide tentar. 4. No editor **Agrupar valores,** no painel à esquerda, clique duas vezes em AZ para destacar o valor e digite Arizona. Em seguida, pressione Enter para adicionar a alteração. ![Menu Agrupar valores pela seleção manual com Estado e AZ selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_group2.png) O Tableau Prep criou um valor mapeado do novo valor Arizona e mapeou automaticamente o valor antigo, AZ, a ele. Ter uma relação mapeada definida para esses valores economizará tempo se tiver mais dados dessa região inseridos dessa forma. > [!TIP] > > **Dica**: é possível adicionar valores de campo que não estão na amostra de dados para definir relações de mapeamento para organizar os dados. Se atualizar sua fonte de dados e novos dados forem adicionados, você poderá adicioná-lo ao mapeamento em vez de corrigir manualmente cada valor. > > Ao adicionar manualmente um valor que não está na amostra de dados, ele será marcado com um ponto vermelho para ajudar na identificação. 5. Repita essas etapas para mapear cada estado para a versão com o nome completo.
AbreviaçãoNome do estado
AZArizona
CACalifórnia
COColorado
IDIdaho
MTMontana
NMNovo México
NVNevada
OROregon
UTUtah
WAWashington
WYWyoming
Em seguida, clique em Concluído para fechar o editor Agrupar valores. ![Uma etapa de fluxo do Tableau Prep com a caixa de diálogo Agrupar valores por seleção manual aberta, mostrando agrupamentos de estados por suas abreviações.](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_west2.png) Depois que todos os estados foram mapeados, você olha para o painel Alterações e vê que há apenas uma entrada, em vez de 11. O Tableau Prep agrupou ações similares de um campo. Você gosta disso, porque facilita a encontrar as alterações feitas no conjunto de dados posteriormente. A única alteração que precisou fazer aqui foi corrigir os valores do campo **Estado**. 6. Nomeie sua etapa de limpeza para monitorar seu trabalho. Por exemplo **Renomear estados**. Você executou muitas ações de limpeza nos arquivos e não acredita em como foi fácil e rápido. Talvez você chegue em casa para o jantar! Para garantir que não perca todo o seu trabalho, salve o fluxo. **Observação**: na Web, suas alterações são salvas automaticamente em tempo real, criando um fluxo de rascunho. Clique no título do rascunho para nomeá-lo. Para obter mais informações sobre a criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm) Clique em Arquivo > Salvar ou **Arquivo** > **Salvar como**. Salve o arquivo como um arquivo de fluxo (.tfl) e dê um nome. Por exemplo, **Meu Superstore**. > [!TIP] > > **Dica**: ao salvar seus arquivos de fluxo, é possível salvá-los como um arquivo de fluxo (.tfl) ou como um arquivo empacotado (.tflx), além de empacotar seus arquivos de dados locais com eles para compartilhar o fluxo e os arquivos com terceiros. Para obter mais informações sobre como salvar e compartilhar os fluxos, consulte [Salvar e compartilhar seu trabalho](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm). ## 4\. Agrupar os dados Agora que todos os arquivos foram limpos, você está pronto pra agrupar todos eles. Como todos os arquivos têm campos semelhantes após seus esforços de limpeza, para juntar todas as linhas em uma única tabela, será necessário unir as linhas das tabelas. Você se recorda de que há uma opção de etapa chamada União de linhas, mas se pergunta se pode arrastar e soltar as etapas para uní-las. Você decide tentar. ### Unir linhas de dados 1. Siga os passos correspondentes à plataforma em que estiver trabalhando. **Tableau Prep Builder** - No painel Fluxo, arraste a etapa de limpeza **Renomear estado**s até a etapa **Tipo de dados alterado** e solte-a na opção União de linhas. ![Arrastando uma etapa de fluxo para uni-la a outra etapa no painel Fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_drag_union.png) Você vê que o Tableau Prep Builder adicionou uma nova etapa de União de linhas ao fluxo. Ótimo! Agora você também deseja adicionar os outros campos a essa união de linhas. **Tableau Server ou Tableau Cloud** - No painel Fluxo, arraste a etapa de limpeza **Renomear estado**s até a etapa Unir linhas criada anteriormente para os arquivos de pedidos do Sul e solte-a na opção Adicionar. ![Na tela do Tableau Prep, arrastando uma etapa de limpeza para uma união de linhas existente.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_union3.png) Você vê que o Tableau Prep adicionou seus novos arquivos à união de linhas anterior. Ótimo! Agora você também deseja adicionar os outros campos a essa união de linhas. 2. Arraste a próxima etapa de limpeza no fluxo para a etapa Unir linhas e solte-a em Adicionar para adicioná-la à união de linhas existente. ![Uma etapa de fluxo sendo arrastada sobre outra etapa de fluxo para unir linhas ou colunas das etapas.](/tableau/current/pt-br/prep/pt-br/Img/prep_add_join.png) 3. Arraste a etapa restante (a etapa de entrada de orders\_south\_2015 se estiver no Tableau Prep Builder ou a sua etapa de limpeza se estiver na Web) para a nova etapa Unir linhas. Solte-a em Adicionar para adicioná-la a união de linhas existente. Agora todos os arquivos estão agrupados em uma tabela única. No painel Fluxo , selecione a nova etapa de União de linhas para ver os resultados. **No Tableau Prep Builder:** ![O Tableau correspondeu automaticamente os campos com os mesmos nomes e tipos.](/tableau/current/pt-br/prep/pt-br/Img/prep_union_step.png) **No Tableau Server ou no Tableau Cloud:** ![Um diagrama de fluxo de dados que ilustra uma operação de união de linhas em várias tabelas.](/tableau/current/pt-br/prep/pt-br/Img/Online_union.png) Você observa que o Tableau correspondeu automaticamente os campos com os mesmos nomes e tipos. Além disso, percebe que as **cores** atribuídas às etapas no fluxo são usadas nos perfis de união de linhas para indicar a origem do campo e também aparecem na **faixa colorida** na parte superior de cada campo para mostrar se ele existe na tabela. Você observa que um novo campo chamado Nomes de tabela foi adicionado, que lista as tabelas de origem de todas as linhas da união de linhas. Uma lista de campos sem correspondência também é mostrada no painel de resumo e é possível ver imediatamente que os campos Produto e Descontos só aparecem no arquivo Orders\_Central. 4. Para analisar esses campos de maneira mais detalhada, no painel **Resultados da união de linhas**, marque a caixa de seleção Mostrar apenas os campos sem correspondência. ![Os dados são os mesmos, mas o nome do campo não corresponde.](/tableau/current/pt-br/prep/pt-br/Img/prep_union_step_mismatch.png) Ao examinar os dados do campo, você vê rapidamente que os dados são os mesmos, mas o nome do campo é diferente. Você poderia apenas renomear o campo, mas se pergunta se poderia simplesmente arrastar e soltar esses campos para mesclá-los. Você decide tentar. 5. Selecione o campo Produto e arraste e solte-o no campo Nome do produto para mesclá-los. Depois de mesclados, eles não aparecem mais no painel. ![Arraste e solte para mesclar campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_union_merge.png) 6. Repita essa etapa para mesclar o campo Descontos ao campo Desconto. O único campo que não tem uma correspondência agora é o Caminhos do arquivo. No Tableau Prep Builder, esse campo mostra os caminhos do arquivo da união de linhas curinga criada para os pedidos de vendas do sul. Você decide deixar esse campo intacto, pois possui boas informações. > [!TIP] > > **Dica**: você tem várias opções para corrigir campos sem correspondência após uma união de linhas. Se o Tableau Prep detectar uma possível correspondência, ela será realçada em amarelo. Para mesclar os campos, focalize o campo destacado e clique no botão com o símbolo de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) que aparece. > > Para conhecer mais maneiras de mesclar campos em uma união de linhas, consulte [Corrigir campos sem correspondência](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Fix_union). 7. Desmarque a caixa de seleção Mostrar apenas campos sem correspondência para mostrar todos os campos incluídos na união de linhas. 8. Nomeie a etapa de união de linhas para representar o que está incluído nessa união. Por exemplo, **Todos os pedidos**. ### Verifique seu trabalho: veja “Unir linhas de dados” em ação _Clique na imagem para reproduzi-la_ Você é um gênio de limpeza! Enquanto admira os resultados, seu chefe telefona. Ele esqueceu de mencionar que também quer que você inclua as devoluções de produtos na análise. E espera que não seja um problema. Com o Tableau Prep no kit de ferramentas, isso não é problema algum! ### Limpar os dados de devoluções de produtos Você dá uma olhada no arquivo Excel enviado por seu chefe com as devoluções de produtos e ele parece estar um pouco bagunçado. Você adiciona o arquivo novo **return\_reasons new** ao fluxo para analisá-lo de maneira mais detalhada. 1. No painel Conexões, clique em Adicionar conexão. Selecione o Microsoft Excel e navegue até os arquivos de dados de amostra que está usando para este exercício. (Consulte [Arquivos de amostra](#sample_files) para baixar o arquivo.) 2. Selecione **return reasons\_new.xlsx** e depois clique em Abrir para adicionar o arquivo ao painel Fluxo. Há apenas quatro campos desse arquivo que você deseja incluir no fluxo: ID de pedido, ID de produto, Motivo da devolução e Observações. 3. No painel Entrada do **returns\_new**, desmarque a caixa de seleção na parte superior da coluna mais à esquerda para desmarcar todas as caixas de seleção. Em seguida, selecione a caixa de seleção dos campos ID de pedido, ID de produto, Motivo da devolução e Observações. ![A adição de uma etapa de limpeza retorna dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_return_file.png) 4. Renomeie a etapa de entrada para que reflita melhor os dados incluídos nessa entrada. No painel Fluxo, clique duas vezes no nome da etapa de entrada Returns\_new e digite Devoluções (tudo). Ao olhar os valores de campo de amostra, você observa que o campo Observações parece ter muitos dados diferentes agrupados. Há limpeza a ser feita nesse arquivo antes que possa prosseguir para qualquer trabalho com os dados, então você adiciona uma etapa de limpeza para ver o que acontece. 5. No painel Fluxo, selecione a etapa de entrada **Devoluções (tudo)**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) ou na etapa de limpeza sugerida para adicionar uma etapa de limpeza. No painel **Perfil**, redimensione o campo Observações para que possa ver melhor as entradas. Para isso, clique a arraste a borda direita externa do campo para a direita. 6. No campo Observações, use a barra de rolagem visual à direita dos valores do campo para examiná-los. Você observa alguns problemas: - Algumas entradas apresentam um espaço adicional. Isso pode fazer com que o campo seja lido como um valor nulo. - Parece que o nome do aprovador está incluído na entrada de observações de devolução. Para trabalhar melhor com esses dados, você precisará dessas informações em um campo separado. Para lidar com os espaços extras, você se lembra de que havia uma opção de limpeza para remover espaços à direita e decide tentar usá-la para ver se ela consegue corrigir esse problema. 7. Selecione o campo Observações. Clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) e selecione Limpar > Remover espaços. ![A função do Tableau Prep para cortar espaços.](/tableau/current/pt-br/prep/pt-br/Img/prep_trimspaces.png) Sim! Você fez exatamente o que queria. Os espaços adicionais foram removidos. Depois você deseja criar um campo separado para o nome do aprovador. Você vê uma opção Dividir valores no menu e decide usá-la. 8. Selecione o campo Observações. Clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) e selecione Dividir valores > Divisão automática. Essa opção fez exatamente o que esperava que fizesse. Ela dividiu automaticamente as observações de devolução e o nome do aprovador em campos separados. ![O Tableau Prep divide automaticamente as notas de devolução e o nome do aprovador em campos separados.](/tableau/current/pt-br/prep/pt-br/Img/prep_split1.png) Assim como no Tableau Desktop, o Tableau Prep atribui automaticamente um nome a esses campos. Então você precisará renomeá-los com um nome significativo. 9. Selecione o campo Divisão de observações 1. Clique duas vezes no nome de campo e digite Observações de devolução. 10. Repita essa etapa no segundo campo e renomeie-o como Aprovador. 11. Como não precisa mais dele, remova o campo Observações original. Selecione o campo Observações, clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa nas versões anteriores) e selecione Remover (Remover campo nas versões anteriores) no menu. ![Cartões de perfil em uma etapa de fluxo do Tableau Prep para motivo da devolução, notas do cliente, quem aprovou a devolução e os campos de ID do pedido e do produto.](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_returns.png) Ao olhar para o novo campo Aprovador, você observa que os valores do campo listam os mesmos nomes, mas que eles foram inseridos de maneira diferente. Você deseja agrupá-los para eliminar as muitas variações do mesmo valor. Será que a opção Agrupar valores (Agrupar e substituir em versões anteriores) pode ajudar com isso? Você se lembra que tinha uma opção de Caracteres usuais. Como esses valores compartilham das mesmas letras, você decide tentar. 12. Selecione o campo Aprovador. Clique no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) (seta suspensa em versões anteriores) e selecione Agrupar valores (Agrupar e substituir em versões anteriores > Caracteres usuais. ![Uma tabela de nomes de aprovadores com um menu suspenso “Agrupar valores por” aberto e “Caracteres comuns” selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_group_common.png) Essa opção agrupou todas as variações de cada nome para você. Isso era exatamente o que você queria fazer. Após verificar os outros nomes para garantir que foram agrupados corretamente, você clica em Concluído para fechar o editor Agrupar valores. ![Uma lista que agrupa nomes com caracteres comuns.](/tableau/current/pt-br/prep/pt-br/Img/prep_group_common1.png) Esse arquivo está com uma boa aparência. 13. Nomeie sua etapa de limpeza para monitorar seu trabalho. Por exemplo, **Observações limpas**. Agora que os dados de devoluções de produtos foram todos limpos, você deseja adicioná-los aos dados de pedidos dos arquivos unidos. Mas muitos desses campos não existem nos arquivos unidos. Para adicionar esses campos (colunas de dados) ao conjunto de dados unido, você precisa usar uma união de colunas. ### Unir colunas de dados Para unir colunas de seus dados, os arquivos devem ter ao menos um campo em comum. Neste caso, os arquivos compartilham os campos ID de pedido e ID de produto, então é possível unir as colunas desses campos para ver todas as linhas que têm esses campos em comum. Você lembra de ter visto a opção para criar uma união de colunas quando criou sua união de linhas ao arrastar e soltar as tabelas, então decide tentar. 1. No painel Fluxo, arraste a etapa Observações limpas até a etapa de união de linhas Todos os pedidos e solte-a em União de colunas. ![O Tableau Prep adicionou seus novos arquivos à união de linhas anterior.](/tableau/current/pt-br/prep/pt-br/Img/prep_join_return.png) Ao unir os arquivos, o Tableau Prep mostra os resultados de sua união de colunas no perfil União de colunas. Trabalhar com uniões de coluna pode ser complicado. Normalmente, você deseja ter uma visão clara dos fatores incluídos na união de colunas, como os campos usados para unir colunas dos arquivos, o número de linhas incluídas nos resultados e qualquer campo que não esteja incluído ou que sejam valores nulos. Conforme revisa os resultados da união de colunas no Tableau Prep, você se contenta em ter tantas informações e interatividade na ponta dos seus dedos. ![O painel mais à esquerda do perfil da união de colunas é onde você pode explorar e interagir com a união.](/tableau/current/pt-br/prep/pt-br/Img/prep_join_details.png) > [!TIP] > > **Dica:** o painel mais à esquerda do perfil da união de colunas é onde você pode explorar e interagir com a união. Também é possível editar valores diretamente nos painéis Cláusulas de união de colunas e realizar operações de limpeza no painel Resultados da união de colunas. > > Clique no diagrama Tipo de união de coluna para testar configurações de união diferentes e ver o número de linhas incluídas ou excluídas em sua união para cada tabela da seção Resumo dos resultados de união de colunas. > > Selecione os campos que deseja unir na seção Cláusulas de união de colunas aplicadas ou adicione cláusulas de união de colunas sugeridas da seção Recomendações da cláusula de união de colunas. > > Para obter mais informações sobre como trabalhar com uniões de colunas, consulte [Agregar, unir colunas ou linhas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm). Você observa que tem mais de 13.000 linhas excluídas de seus arquivos **Todos os pedidos**. Ao criar a união de colunas, o Tableau Prep uniu automaticamente o campo ID de produto, mas você também queria unir o campo ID de pedido. Ao examinar o painel à esquerda do perfil de união, você observa que ID de pedido está na lista de cláusulas de união de colunas recomendadas, então o adiciona rapidamente. 2. No painel à esquerda do perfil União de colunas, na seção Recomendações da cláusula de união de colunas, selecione Order ID = Order ID e clique no botão com o símbolo de mais ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addvalueicon.png) para adicionar a cláusula de união de colunas. ![O Tipo de união de colunas está definido como uma união interna (a configuração padrão do Tableau Prep). Por isso, a união inclui apenas valores que existem em ambos os arquivos. ](/tableau/current/pt-br/prep/pt-br/Img/prep_join_rec.png) Como o Tipo de união de colunas está definido para uma união interna (a configuração padrão do Tableau Prep), a união inclui apenas valores que existem em ambos os arquivos. Mas você quer todos os dados dos arquivos Pedidos, assim como os dados de devolução deles. Então será necessário alterar o tipo de união de colunas. 3. Na seção Tipo de união de colunas, clique no lado do diagrama para incluir todos os pedidos. No exemplo abaixo, clique no lado esquerdo do diagrama para alterar a união de colunas para uma união de colunas à esquerda e inclua todos os dados da etapa de união de linhas Todos os pedidos e os dados correspondentes da etapa de Observações limpas. ![Todos os dados dos arquivos de pedidos de vendas e todos os dados de devolução que se aplicam a esses pedidos. ](/tableau/current/pt-br/prep/pt-br/Img/prep_join_rec2.png) Agora você tem todos os dados dos arquivos de pedido de vendas e todos os dados de devolução que se aplicam a eles. Você revisa o painel Cláusulas de união de colunas e vê os valores distintos que não existem no outro arquivo. Por exemplo, há muitas linhas de pedido (mostrado em vermelho) que não possuem dados de devolução correspondentes. Você adora ser capaz de explorar esse nível de detalhe de sua união de colunas. Está ansioso para começar a analisar esses dados no Tableau Desktop, mas observa alguns resultados da união de colunas que deseja limpar antes disso. Ainda bem que sabe o que fazer! > [!TIP] > > **Dica**: está se perguntando se os dados estão suficientemente limpos? No Tableau Prep Builder, é possível visualizar seus dados no Tableau Desktop em qualquer etapa do fluxo para verificar. > > Apenas clique com o botão direito do mouse no painel Fluxo e selecione Visualizar. no Tableau Desktop no menu. > > Você pode testar com seus dados e qualquer alteração feita no Tableau Desktop não será gravada na fonte de dados do Tableau Prep Builder. Para obter mais informações consulte [Exibir saída de fluxo no Tableau Desktop](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#View). 4. Antes de começar a limpeza nos resultados da união de colunas, nomeie a etapa União de colunas como Pedidos+Devoluções e salve o fluxo. ### Limpar os resultados da união de colunas **Observação**: para limpar os campos da sua união de colunas, é possível realizar operações de limpeza diretamente na etapa da união. Para o propósito deste tutorial, adicionaremos uma etapa de limpeza para que você possa ver claramente suas operações de limpeza. Se quiser tentar realizar essas etapas diretamente na etapa de união de colunas, ignore as etapas 1 e 3 abaixo. Ao unir as duas etapas, os campos comuns ID de pedido e ID de produto foram adicionados nas duas tabelas. Você deseja manter o campo ID de produto de todos os pedidos e o campo ID de pedido do arquivo de devoluções e remover os campos duplicados que vieram desses arquivos. Você também não precisa dos campos Caminhos do arquivo e Nomes de tabela no arquivo de saída, então também deseja removê-los. > [!TIP] > > **Dica**: ao unir colunas de tabelas usando campos que existem nos dois arquivos, o Tableau Prep traz os dois arquivos e renomeia o campo duplicado do arquivo secundário ao adicionar um "-1" ou um "-2" ao nome do campo. Por exemplo ID do pedido e ID do pedido -1. 1. No painel Fluxo, selecione **Pedidos+Devoluções**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e adicione uma etapa de limpeza. 2. No painel Perfil, selecione e remova os campos a seguir: - Nomes de tabela - ID do pedido - Caminhos do arquivo (somente no Tableau Prep Builder) - ID-1 do produto ![Um fluxo do Tableau Prep mostra vários cartões de perfil selecionados com o menu Mais opções aberto e a opção Remover destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_orders_returns.png) 3. Renomeie o campo ID de pedido-1 para ID de pedido. Há alguns valores nulos onde o produto foi devolvido, mas não há observações de devolução ou aprovador indicados. Para facilitar a análise desses dados, você deseja adicionar um campo com um valor Sim e Não para indicar se o produto foi devolvido. Você não tem esse campo, mas é possível adicioná-lo ao criar um campo calculado. 4. Na barra de ferramentas, clique em Criar campo calculado. 5. Nomeie o campo Devolvido?, em seguida insira o cálculo a seguir e clique em Salvar. `If ISNULL([Return Reason])=FALSE THEN "Yes" ELSE "No" END` ![O Editor de cálculo mostra a sintaxe de cálculo para criar um campo booleano rotulado como "Retornou?" com valores "Sim" e "Não".](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_returned_bool.png) Para sua análise, você também gostaria de saber o número de dias que leva para enviar um pedido, mas também não tem esse campo. Contudo, você possui todas as informações de que precisa para criá-lo, então adiciona outro campo calculado para isso. 6. Na barra de ferramentas, clique em Criar campo calculado. 7. Nomeie o campo Dias para envio, em seguida insira o cálculo a seguir e clique em Salvar. `DATEDIFF('day',[Order Date],[Ship Date])` ![O Editor de cálculo mostra uma fórmula para calcular a diferença entre duas datas.](/tableau/current/pt-br/prep/pt-br/Img/prep_calc_days2ship.png) 8. Nomeie sua etapa Limpar pedidos +Devoluções. 9. Salve seu fluxo. ![Um fluxo do Tableau Prep com uma etapa de limpeza selecionada e o painel Alterações aberto mostrando as ações de limpeza realizadas após uma etapa de união de colunas.](/tableau/current/pt-br/prep/pt-br/Img/prep_clean_orders_return2.png) ## 5\. Executar o fluxo e gerar saída Seus dados estão com uma boa aparência e você está pronto para gerar o arquivo de saída para começar a analisar no Tableau Desktop. Tudo que precisa fazer é executar o fluxo e gerar o arquivo de extração. Para isso, é necessário adicionar uma etapa de Saída. Dependendo de onde estiver trabalhando, você pode exportar seu fluxo para um arquivo (somente no Tableau Prep Builder), para uma fonte de dados publicada ou para um banco de dados. 1. No painel Fluxo, selecione **Limpar Pedidos+Devoluções**, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Saída (Adicionar saída em versões anteriores). Ao adicionar uma etapa de saída, o painel de Saída é aberto e mostra um instantâneo de seus dados. Aqui é possível selecionar o tipo de saída que deseja gerar e especificar o nome e local onde deseja salvar o arquivo. O local padrão é o repositório Meu Tableau Prep Builder na pasta das fontes de dados. ![Botão Executar fluxo do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_run.png) 2. No painel esquerdo no menu suspenso Salvar saída em, dependendo de onde estiver trabalhando, siga um dos seguintes procedimentos: **Tableau Prep Builder** 1. Selecione Arquivo (Salvar para arquivo em versões anteriores). 2. Clique no botão Procurar, em seguida, na caixa de diálogo Salvar extração como, insira um nome para o arquivo, Orders\_Returns\_Superstore por exemplo, e clique em Aceitar. 3. No campo Tipo de saída, selecione um tipo de saída. Selecione Extração de dados do Tableau (.hyper) para o Tableau Desktop ou Valores separados por vírgula (.csv) se quiser compartilhar a extração com terceiros. **Tableau Server ou Tableau Cloud** 1. Selecione **Fontes de dados publicadas**. 2. Selecione um projeto. 3. Digite um nome para o arquivo, por exemplo, Orders\_Returns\_Superstore. > [!TIP] > > **Dica**: você tem escolhas ao gerar uma saída do fluxo. Você pode gerar um arquivo de extração (apenas no Tableau Prep Builder) ou publicar os dados como uma fonte de dados no Tableau Server ou no Tableau Cloud. Como alternativa, você também pode gravar seus dados em um banco de dados. Para obter mais informações sobre como gerar arquivos de saída, consulte [Criar arquivos de extração de dados e fontes de dados publicadas](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#Extract). 3. Na seção Opções de gravação, visualize as opções para gravar os novos dados em seus arquivos. Você deseja usar o padrão(Criar tabela) e substituir a tabela com a saída de fluxo, portanto não há nada para mudar aqui. > [!TIP] > > **Dica**: a partir da versão 2020.2.1, você pode escolher como deseja gravar os dados de fluxo de volta à tabela. Escolha entre duas opções; Criar tabela ou Anexar tabela. Por padrão, o Tableau Prep usa a opção Criar tabela e substitui os dados de tabela pelos dados novos ao executar o fluxo. Se você escolher Anexar tabela, o Tableau Prep adiciona os dados de fluxo à tabela existente para que você possa rastrear dados novos e históricos em cada fluxo executado. Para obter mais informações, consulte [Configurar opções de gravação](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm#flow-writeoptions) 4. No painel Saída, clique em Executar fluxo ou clique no botão Executar fluxo![O botão Executar fluxo aparece como uma seta voltada para a direita.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow.png) no painel Fluxo para gerar a saída. **Observação**: se estiver trabalhando na web, clique em **Publicar** para publicar seu fluxo de rascunho. Apenas fluxos publicados podem ser executados. 5. Quando a execução do fluxo tiver terminado, uma caixa de diálogo de status mostra se o fluxo executou com sucesso e o tempo que ele levou para executar. Clique em Concluído para fechar a caixa de diálogo. ![Mensagem de sucesso de execução do fluxo concluída.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow_status.png) Se estiver na Web, navegue até a página Explorar > Todos os Fluxos e encontre seu fluxo. O status do seu fluxo executado pode ser visualizado na página Visão geral do fluxo. ![A página Visão geral do fluxo mostra um fluxo do Tableau Prep na Web.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_getstarted.png) Para manter os dados atualizados, execute o fluxo manualmente ou use a linha de comando. Se tiver o Data Management e o Tableau Prep Conductor ativados, também poderá executar o fluxo em uma agenda no Tableau Server ou no Tableau Cloud. A partir do Tableau Prep versão 2020.2.1, você também pode optar por atualizar todos os dados sempre que o fluxo for executado, ou executar o fluxo usando a atualização incremental e processar apenas os novos dados cada vez. Para obter mais informações sobre como mantes os dados atualizados, consulte os tópicos a seguir: - [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm) - [Publicar um fluxo no Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm) - [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm) ## Conclusão e recursos Você é um astro da preparação de dados! Pegou dados sujos e os transformou com facilidade! Rapidamente você limpou e preparou os dados de vários conjuntos de dados e os transformou em um conjunto de dados simples e claro que agora pode usar no Tableau Desktop para análise. Quer praticar mais? Tente replicar o resto do fluxo de amostra do Superstore usando os arquivos de dados encontrados aqui: - [Orders\_South\_2015](https://mkt.tableau.com/PrepTutorials/orders_south_2015.csv) - [Orders\_South\_2016](https://mkt.tableau.com/PrepTutorials/orders_south_2016.csv) - [Orders\_South\_2017](https://mkt.tableau.com/PrepTutorials/orders_south_2017.csv) - [Orders\_South\_2018](https://mkt.tableau.com/PrepTutorials/orders_south_2018.csv) - [Orders\_Central](https://mkt.tableau.com/PrepTutorials/Orders_Central.csv) - [Orders\_East](https://mkt.tableau.com/PrepTutorials/Orders_East.xlsx) - [Orders\_West](https://mkt.tableau.com/PrepTutorials/Orders_West.csv) - [returns\_reasons\_new](https://mkt.tableau.com/PrepTutorials/return_reasons_new.xlsx) - [Quota](https://mkt.tableau.com/PrepTutorials/Quota.xlsx) Você também pode encontrar os arquivos no seguinte local do seu computador após instalar o Tableau Prep Builder: - (Windows) `C:\Program Files\Tableau\Tableau Prep Builder \help\Samples\en_US\Superstore Files` - (Mac) `/Applications/Tableau Prep Builder .app/Contents/help/Samples/en_US/Superstore Files` Quer treinar mais? Confira estes ótimos [recursos](https://www.tableau.com/pt-br/about/blog/2018/7/master-tableau-prep-list-learning-resources-92064) ou faça um curso de [treinamento presencial](https://www.tableau.com/pt-br/learn/classroom/prep). Deseja mais informações sobre os tópicos abordados? Veja os outros tópicos na Ajuda online do Tableau Prep. ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Limpar e formatar dados O Tableau Prep oferece várias operações de limpeza que podem ser usadas para limpar e formatar os dados. A limpeza de dados sujos facilita a combinação e análise de dados ou a compreensão de outras pessoas em relação aos dados durante o compartilhamento dos conjuntos de dados. Você também pode limpar os dados usando uma etapa dinâmica ou uma etapa de script para aplicar scripts R ou Python ao fluxo. Não há suporte para as etapas de script no Tableau Cloud. Para obter mais informações, consulte [Dinamizar os dados](https://help.tableau.com/current/prep/pt-br/prep_pivot.htm) ou [Usar scripts R e Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm). ## Sobre as operações de limpeza Você limpa seus dados ao aplicar operações de limpeza como filtragem, adição, renomeação, divisão, agrupamento ou remoção de campos. É possível executar operações de limpeza na maioria das etapas do fluxo. Você também pode realizar operações de limpeza na grade de dados em uma etapa de limpeza. Você pode aplicar operações de limpeza limitadas na etapa de entrada e não pode aplicar operações de limpeza na etapa de saída. Para obter mais informações sobre como aplicar operações de limpeza na etapa de entrada, consulte [Aplicar operações de limpeza na etapa de entrada](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#clean_input). ### Operações de limpeza disponíveis A tabela a seguir mostra quais operações de limpeza estão disponíveis em cada tipo de etapa:
 EntradaLimparAgregaçãoTabela dinâmicaUnião de colunasUnião de linhasNovas linhasSaída
FiltrarXXXXXXX 
Agrupar valores X X XX 
Limpar X XXXX 
Converter datas XXXXXX 
Dividir valores X XXXX 
Renomear campoXX XXXX 
Renomear campos (em massa) X      
Duplicar Campo X XXXX 
Manter apenas o campoXXXXXXX 
Remover campoXXXXXXX 
Criar campo calculado X XXXX 
Editar valor X XXXX 
Alterar tipo de dadosXXXXXXX 
Conforme faz alterações nos dados, anotações são adicionadas à etapa correspondente no painel Fluxo e uma entrada é adicionada ao painel Alterações para monitorar suas ações. Se fizer alterações na etapa de entrada, a anotação será mostrada à esquerda da etapa, no painel Fluxo, e será mostrada no Perfil de entrada, na lista de campos. A ordem em que você aplica mudanças é significativa. As alterações feitas a Agregar, Tabelas dinâmicas, União de colunas e União de linhas são executadas antes ou depois dessas ações de limpeza, dependendo de onde está o campo ao fazer a alteração. O local onde a alteração foi feita é mostrado no painel Alterações da etapa. O exemplo a seguir mostra as alterações feitas em vários campos em uma etapa União de colunas. A alteração é realizada antes da ação de união de colunas para fornecer os resultados corrigidos. ![Um exemplo do Tableau Prep mostrando as alterações feitas em vários campos em uma etapa União de colunas. A alteração é realizada antes da ação de união de colunas para fornecer os resultados corrigidos.](/tableau/current/pt-br/prep/pt-br/Img/prep_orderops.png) ### Ordem das operações A tabela a seguir mostra onde a ação de limpeza é executada nos tipos de etapa Agregar, Dinamizar, União de colunas e União de linhas, dependendo de onde o campo está na etapa.
Ação/ Tipo de etapa:AgregaçãoAgregaçãoTabela dinâmicaTabela dinâmicaUnião de colunasUnião de colunasUnião de linhasUnião de linhasNovas linhas
Localização do campo:Campos agrupadosCampos agregadosNão está na tabela de dinâmicaCriado a partir da tabela dinâmicaIncluído em uma tabela*Incluído nas duas tabelas*Campos incompatíveisCampos combinadosCampo usado para gerar linhas
FiltrarAntes da agregaçãoApós a agregaçãoAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Agrupar valoresNANAAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
LimparNANAAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Converter datasAntes da agregaçãoApós a agregaçãoAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Dividir valoresNANAAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Renomear campoNANAAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasAntes de novas linhas
Duplicar CampoNANAAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Manter apenas o campoApós a agregaçãoApós a agregaçãoAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Remover campoRemove da agregaçãoRemove da agregaçãoAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Criar campo calculadoNANAAntes da dinamizaçãoApós a dinamizaçãoApós a união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Editar valorNANAAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasApós a união de colunasAntes da união de linhasApós a união de linhasDepois de novas linhas
Alterar tipo de dadosAntes da agregaçãoApós a agregaçãoAntes da dinamizaçãoApós a dinamizaçãoAntes da união de colunasAntes da união de colunasAntes da união de linhasApós a união de linhasAntes de novas linhas
**Observação**: para união de colunas, se o campo for um campo calculado criado usando um campo de uma tabela, a alteração será aplicada antes da união de colunas. Se o campo for criados com campos de ambas as tabelas, a alteração será aplicada depois da união de colunas. ## Aplicar operações de limpeza Para aplicar operações de limpeza a campos, use as opções da barra de ferramentas ou clique em Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) no cartão Perfil do campo, na grade de dados ou no painel Resultados para abrir o menu. Nos tipos de etapas Agregar, Dinamizar, Unir colunas e Unir linhas, o menu Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png)está disponível nos cartões de perfil do painel Resultados e grade de dados correspondente. Se você realizar as mesmas operações ou ações de limpeza repetidamente em todo o fluxo, poderá copiar e colar etapas, ações ou até mesmo campos. Para obter mais informações, consulte [Copiar etapas, ações e campos](https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm).
Barra de ferramentas do painel PerfilMenu suspenso

A barra de ferramentas do Tableau Prep.

### Selecionar sua exibição Você pode executar operações de limpeza fora do painel de perfil ou de resultados na grade de dados ou na exibição de lista. Use a barra de ferramentas de exibição ![Uma barra de pesquisa com ícones de uma planilha e uma pesquisa.](/tableau/current/pt-br/prep/pt-br/Img/prep_view_toolbar.png) para alterar a exibição e clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) em um campo para abrir o menu de limpeza. - Painel Mostrar perfil ![Ícone do painel Mostrar perfil.](/tableau/current/pt-br/prep/pt-br/Img/prep_show_profile_pane.png): este é o modo de exibição padrão. Selecione este botão para voltar à exibição do painel Perfil ou do painel Resultados. ![Uma sequência de gráficos de barras que mostram detalhes de cada pedido, como ID, data do pedido, região para onde foi enviado etc.](/tableau/current/pt-br/prep/pt-br/Img/prep_profile_pane_view.png) - Mostrar grade de dados ![Ícone de grade de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_show_datagrid.png): recolher o perfil ou painel de resultados para expandir e mostrar apenas a grade de dados. Essa exibição fornece uma exibição mais detalhada de seus dados e pode ser útil quando você precisa trabalhar com valores de campo específicos. Depois de selecionar essa opção, esse estado de exibição persiste em todas as etapas do seu fluxo, mas você pode alterá-lo a qualquer momento. **Observação**: nem todas as operações de limpeza estão disponíveis na grade de dados. Por exemplo, caso deseje editar um valor em linha, você deve usar o painel Perfil. ![A exibição somente da grade de dados em um fluxo do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_datagrid_view.png) - Mostrar exibição de lista ![Ícone de Lista de campos](/tableau/current/pt-br/prep/pt-br/Img/prep_show_list.png) (Tableau Prep Builder na Web): converta o painel de perfil ou o painel de resultados em uma lista. Depois de selecionar essa opção, esse estado de exibição persiste em todas as etapas do seu fluxo, mas você pode alterá-lo a qualquer momento. Nesta exibição, você pode: - Selecionar e remover várias linhas usando a opção X. - Selecione e oculte ou exiba várias linhas usando a opção ![Um ícone de olho riscado com uma linha diagonal.](/tableau/current/pt-br/prep/pt-br/Img/prep_hide_fields_icon.png). - Renomeie campos em massa. - Usar o menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) para aplicar operações em campos selecionados. Se você atribuir uma função de dados ao campo ou selecionar Filtrar, Agrupar valores, Limpar ou Dividir valores, você retornará à exibição Perfil ou Resultados para concluir essas ações. Todas as outras opções podem ser executadas na exibição de lista. ![O menu permite limpar um campo no modo de exibição de lista.](/tableau/current/pt-br/prep/pt-br/Img/prep_list_view2.png) ### Interromper atualizações de dados para aumentar o desempenho Ao realizar operações de limpeza nos dados, o Tableau Prep aplica as alterações à medida que você mostra os resultados imediatamente. Para economizar tempo de processamento valioso quando você sabe as alterações que precisa fazer e não precisa de feedback imediato à medida que faz cada alteração, você pode aumentar o desempenho pausando as atualizações de dados. Ao interromper as atualizações de dados, você pode fazer todas as alterações de uma só vez e, em seguida, retomar as atualizações para ver os resultados. Você pode retomar as atualizações de dados e ativar todas as operações disponíveis a qualquer momento. Precisa de ajuda para depurar um fluxo lento? Tente ativar Habilitar log de consulta no menu Ajuda\>Configurações e desempenho. Para obter mais informações, consulte [Habilitar log de consulta](https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm#enable-query-logging). **Observação:** ao interromper as atualizações de dados, todas as operações que exigem que você veja que os valores estão desativados. Por exemplo, se quiser aplicar um filtro aos valores selecionados, precisará ver os valores que deseja excluir. 1. No menu superior, clique em Interromper atualizações de dados para interromper as atualizações. ![O botão Pausar na tela do Tableau Prep Builder.](/tableau/current/pt-br/prep/pt-br/Img/prep_pause_updates.png) 2. O Tableau Prep converte o painel Perfil em uma exibição de Lista. Na exibição em Lista, use o menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) para aplicar operações em campos selecionados. Se a operação exigir que você veja seus valores, ela será desabilitada. Para habilitar a operação, você deve retomar as atualizações de dados. Para obter mais informações sobre o uso do modo de exibição em Lista, consulte [Selecionar sua exibição](#select_view). ![O menu Mais opções (três pontos) é aberto e um botão Continuar aparece em um menu suspenso.](/tableau/current/pt-br/prep/pt-br/Img/prep_pause_updates2.png) 3. Para ver os resultados das alterações ou ativar um recurso desabilitado, retome as atualizações de dados. Clique no botão Retomar atualizações de dados, clique no botão Retomar na caixa de diálogo do menu ou no banner de mensagem na parte superior do painel Fluxo. **Observação**: o Tableau Prep Builder oferece a você uma opção para retomar as atualizações diretamente no menu. Se você estiver editando na Web, precisa retomar as atualizações no menu superior. ![A tela de fluxo está pausada. O botão Continuar é destacado na parte superior da página.](/tableau/current/pt-br/prep/pt-br/Img/prep_pause_resume_updates.png) ### Aplicar operações de limpeza Para aplicar operações de limpeza a um campo, faça o seguinte: 1. No painel Perfil, grade de dados, painel Resultados ou na exibição de lista, selecione o campo que deseja alterar. 2. Na barra de ferramentas ou no menu Mais opções ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) do campo, selecione uma das opções a seguir: - Filtrar ou Filtrar valores: selecione uma das opções de filtro, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) em um valor de campo para manter ou excluir valores. Você também pode usar o filtro Valores selecionados para selecionar e escolher os valores a serem filtrados, incluindo os valores que não estão no seu exemplo de fluxo. Para obter mais informações sobre as opções de filtro, consulte [Filtrar dados](https://help.tableau.com/current/prep/pt-br/prep_filter.htm). - Agrupar valores (Agrupar e substituir em versões anteriores): selecione manualmente os valores ou use o agrupamento automático. Além disso, é possível selecionar vários valores no cartão Perfil e clicar com o botão direito do mouse ou manter a tecla Ctrl pressionada (MacOS) e clicar para agrupar ou desagrupar valores ou editar o valor do grupo. Para obter mais informações sobre como utilizar Agrupar valores, consulte [Mapear automaticamente os valores para um valor padrão usando uma correspondência parcial](#fuzzy_match). - Limpar: selecione de uma lista de operações rápidas de limpeza para aplicar a todos os valores no campo. - Converter datas: em campos atribuídos a um tipo de dados Data ou Data e hora, selecione a partir de uma lista de operações de limpeza rápida DATEPART para converter os valores do campo de data em um valor inteiro representando ano, trimestre, mês, semana, dia ou um valor de data e hora. Você também pode selecionar entre duas operações de limpeza rápida DATENAME, dia da semana ou nome do mês, para converter seus valores de campo de data. - Ano fiscal personalizado : se o ano fiscal não começar em janeiro, você poderá definir um mês fiscal personalizado para converter a data usando esse mês, em vez do mês padrão de janeiro. - Essa configuração é feita por campo, portanto, se quiser aplicar um ano fiscal personalizado a outros campos, repita a mesma etapa. - Para abrir a caixa de diálogo, no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png), selecione Converter datas > Ano fiscal personalizado. ![Um menu para definir um ano fiscal personalizado em um campo, incluindo opções para conversão de data, seleção de data e data de início.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_fiscal_year.png) - Dividir valores: dividir valores automaticamente com base em um separador comum ou usar divisão personalizada para especificar como deseja dividir valores de campo. Divisões automáticas e personalizadas funcionam da mesma maneira no Tableau Desktop. Para obter mais informações, consulte [Dividir um campo em vários campos](https://help.tableau.com/current/pro/desktop/pt-br/split.htm) na Ajuda para criação na Web e do Tableau Desktop. - Renomear campo: edite o nome do campo. - Campo Duplicado: crie uma cópia do seu campo e valores. - Manter apenas o campo: mantenha apenas o campo selecionado e exclua todos os outros campos da etapa. - Criar campo calculado: escreva um cálculo personalizado no editor de cálculo ou use o editor de Cálculo visual para criar cálculos de nível de detalhes, classificação ou número de linha. Para obter mais informações, consulte [Criar nível de detalhe, classificação e cálculos de bloco](https://help.tableau.com/current/prep/pt-br/prep_calculations.htm). - Publicar como função de dados: crie funções de dados personalizadas que você pode aplicar aos seus campos para validar os valores do campo ao limpar os dados. Para obter mais informações sobre essa opção, consulte [Criar funções de dados personalizadas](https://help.tableau.com/current/prep/pt-br/prep_validate_data.htm#custom_data_roles). - Ocultar campo: se você tiver campos que deseja manter em seu fluxo, mas não precisa limpá-los, pode ocultá-los em vez de removê-los. Para obter mais informações, consulte [Ocultar campos](https://help.tableau.com/current/prep/pt-br/prep_filter.htm#hide_fields). - Remover: remova o campo do fluxo. 3. Para editar um valor, clique com o botão direito do mouse ou pressione Ctrl e clique (MacOS) em um ou mais valores, selecione Editar valor e insira um novo valor. Além disso, é possível selecionar Substituir com nulo para substituir os valores com um valor nulo ou clicar duas vezes em um único valor para editá-lo diretamente. Para obter mais informações sobre como editar valores de campo, consulte [Editar valores de campo](#editvalues). 4. Consulte os resultados dessas operações no painel Perfil, painéis Resumo ou na grade de dados. ### Renomear campos em massa _Com suporte no Tableau Prep Builder versão 2021.2.1 e posteriores. Compatível com Tableau Prep na Web no Tableau Server e Tableau Cloud versão 2021.2 e posterior._ Use a opção Renomear campos para renomear vários campos em massa. Pesquise por partes de um nome de campo para substituí-lo ou removê-lo, ou adicione prefixos ou sufixos a todos os campos ou a campos selecionados no conjunto de dados. Você também pode aplicar automaticamente a mesma alteração a quaisquer campos adicionados no futuro que correspondam aos seus critérios, marcando a caixa de seleção Renomear novos campos automaticamente ao fazer as alterações. **Observação**: essa opção está disponível apenas em um tipo de etapa de Limpeza. 1. Em uma etapa de Limpeza, na barra de ferramentas, selecione Renomear campos. ![Botão Renomear campos na barra de ferramentas.](/tableau/current/pt-br/prep/pt-br/Img/prep_rename_fields_toolbar.png) A exibição é convertida automaticamente para a Exibição de lista, mostrando todos os campos no fluxo. Você pode usar a opção Pesquisar na barra de ferramentas para restringir seus resultados. ![Opção para substituir texto para cada campo ao renomear campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_rename_fields.png) Todos os campos são selecionados como padrão. Desmarque a caixa de seleção superior para limpar a seleção de todos os campos e selecionar manualmente apenas os campos que deseja alterar. 2. No painel Renomear campo, selecione uma das seguintes opções: - Substituir texto: no campo Localizar texto, encontre o texto correspondente usando as opções de Pesquisa e insira o texto de substituição no campo Substituir por. Para localizar espaços em branco, pressione a barra de espaço no campo Localizar texto. **Observação**: renomear campos não pode resultar em nomes de campo em branco ou duplicados. ![Opções de pesquisa para procurar texto que contenha, comece com e termine com.](/tableau/current/pt-br/prep/pt-br/Img/prep_rename_fields_search_options.png) - Adicionar prefixo: adiciona texto ao início de todos os nomes de campo selecionados. - Adicionar sufixo: adiciona texto ao final de todos os nomes de campo selecionados. Conforme você faz suas entradas, seus resultados são exibidos no painel Exibição de lista. ![Opção para renomear campos adicionando um sufixo a cada campo.](/tableau/current/pt-br/prep/pt-br/Img/prep_rename_fields_suffix.png) 3. (opcional) Selecione Renomear novos campos automaticamente para aplicar automaticamente essas mesmas alterações aos novos campos correspondentes aos seus critérios de substituição, quando seus dados são atualizados. 4. Clique em Renomear para aplicar as alterações e fechar o painel. O botão Renomear mostra o número de campos afetados pelas alterações. ![Botão Renomear campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_rename_fields_button.png) ## Visualizar suas alterações Os diferentes tipos de operações de limpeza são representados por ícones nas etapas do fluxo. Caso mais de quatro tipos de operações sejam aplicados a uma etapa, uma elipse será exibida na etapa. Passe o cursor sobre esses ícones para exibir as anotações que mostram as operações aplicadas e a ordem na qual são executadas. A partir do Tableau Prep Builder versão 2019.1.3 e posteriores e na Web, você pode clicar em uma anotação no ícone de alteração em uma etapa no painel Fluxo ou em um cartão de perfil no painel Perfil ou Resultados, e a alteração e o campo afetados serão realçados no painel Alterações e no painel Perfil ou Resultados.
Um diagrama de fluxo de dados que mostra o processo de limpeza de datas na fonte de dados com cálculos. Uma tabela de dados que ilustra a correlação entre os dias para envio e o ano de venda dos itens devolvidos.
Além disso, é possível selecionar uma etapa e expandir o painel Alterações para exibir os detalhes de cada alteração, editar ou removê-las, ou arrastá-las para cima e para baixo para trocar a ordem em que serão aplicadas e adicionar uma descrição para dar contexto a outros usuários. Para obter mais informações sobre como adicionar descrições às alterações, consulte [Adicionar descrições a etapas de fluxo e ações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_build_flow.htm#descriptions).
Anotação de limpezaPainel Alterações

Uma etapa de limpeza em um fluxo do Tableau Prep que mostra a dica de ferramentas de anotações com a lista de ações de limpeza aplicadas a essa etapa.

O painel Alterações mostra uma lista de todas as alterações feitas em uma etapa do fluxo do Tableau Prep.
Ao visualizar alterações em uma etapa Agregar, Dinamizar, União de colunas ou União de linhas, a ordem em que a alteração é aplicada é mostrada antes ou depois da ação de reformulação. A ordem dessas alterações é aplicada pelo sistema e não pode ser alterada. É possível editar e remover a alteração. ![Lista de alterações aplicadas pelo Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_orderops2.png) ## Mesclar campos Se você tiver campos que contêm os mesmos valores nomeados de forma diferente, é possível mesclá-los em um campo para agrupá-los, arrastando um campo até o outro. Ao mesclar os campos, o campo de destino se torna o campo primário e o nome do campo de destino permanece o mesmo. O campo mesclado ao campo de destino é removido. **Exemplo:**
entrada de união de linhas em 3 campos com os mesmos valoresMesclar 3 filtros em 1
Três gráficos de barras horizontais com “Dados incertos/inexistentes”.Um gráfico de barras horizontais de “Dados incertos ou inexistentes”.
Ao mesclar os campos, o Tableau Prep mantém todos os campos do campo de destino e substitui todos os nulos dele por valores de campos de origem mesclados com o campo de destino. Os campos de origem são removidos. **Exemplo**
NomeContact_PhoneBusiness_PhoneCell_PhoneHome_Phone
Bob123-4567123-4567nulonulo
Sallynulonulo456-7890789-0123
Frednulonulonulo567-8901
Emmanulo234-5678345-6789nulo
Se você mesclar os campos **Business \_Phone**, **Cell\_Phone** e **Home\_Phone** com o campo **Contact\_phone**, os outros campos serão removidos e resultarão no seguinte:
NomeContact_Phone
Bob123-4567
Sally456-7890
Fred567-8901
Emma234-5678
Para mesclar campos, execute uma das ações a seguir: - Arraste e solte um campo no outro. Um indicador Soltar para mesclar campos é exibido. - Selecione vários arquivos e clique com o botão direito do mouse na seleção para abrir o menu de contexto, em seguida clique em Mesclar campos. - Selecione vários campos e clique em Mesclar campos na barra de ferramentas. Para obter informações sobre como corrigir campos sem correspondência devido a uma união de linhas, consulte [Corrigir campos sem correspondência](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Fix_union). ## Aplicar operações de limpeza usando recomendações Às vezes, pode ser difícil identificar qual operação de limpeza será necessária para corrigir problemas nos dados. O Tableau Prep pode analisar os dados e recomendar operações de limpeza que podem ser aplicadas automaticamente para corrigir com rapidez os problemas nos campos de dados ou ajudar a identificar problemas para corrigi-los. Esse recurso está disponível em todos os tipos de etapas, exceto em Entrada, Saída e Unir colunas. **Observação**: no Tableau Prep Builder, se não quiser usar esse recurso, é possível desativá-lo. No menu superior, acesse Ajuda > Configurações e desempenho. Em seguida, clique em Habilitar recomendações para desmarcar a caixa de seleção ao lado da configuração. Os tipos de recomendação incluem: - Funções de dados - Filtrar - Agrupar valores - Dinamizar colunas para linhas - Substituir valores por valores nulos - Remover campos - Dividir (Essa opção funciona especificamente com dados em arquivos de texto de largura fixa. Para usar a recomendação de divisão com esse tipo de arquivo, após conectar-se à fonte de dados, na etapa de entrada, na guia Configurações de texto, selecione um caractere de Separador de campo que não esteja sendo usado nos dados, para que eles sejam carregados como um campo único.) - Cortar espaços ### Aplicar recomendações 1. Execute um destes procedimentos: - Clique no ícone de lâmpada ![Ícone de sugestões do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_suggestions_icon.png) no canto superior direito do cartão Perfil. - Na barra de ferramentas, clique na seta suspensa Recomendações para exibir todas as recomendações referentes a seu conjunto de dados e selecione uma recomendação na lista. Essa opção é exibida somente quando as alterações recomendadas são identificadas pelo Tableau Prep.
Recomendações no Tableau Prep.Uma lista de recomendações para alterar a função de dados para Região, País, Cidade, Estado e Código Postal.
2. Para aplicar a recomendação, passe o mouse sobre o cartão Recomendações e clique em Aplicar. ![Caixa de diálogo de recomendações do Tableau Prep com opções para aplicar recomendações.](/tableau/current/pt-br/prep/pt-br/Img/prep_suggestions3.png) - A alteração é aplicada automaticamente e uma entrada é adicionada ao painel Alterações. Para remover uma Alteração, clique em Desfazer no menu superior ou passe o mouse sobre a alteração no painel Alterações e clique no X para removê-la. - Se você aplicar uma recomendação para dinamizar campos, uma etapa de dinamização será criada automaticamente, onde é possível realizar quaisquer ações de dinamização adicionais, como renomear os campos dinamizados ou dinamizar campos adicionais. 3. Se o Tableau Prep identificar recomendações adicionais como resultado da alteração, o ícone de lâmpada permanecerá no cartão Perfil até que nenhuma recomendação adicional seja encontrada. ![Recomendações do Tableau Prep para agrupar e filtrar valores.](/tableau/current/pt-br/prep/pt-br/Img/prep_suggestions4.png) Repita as etapas acima para aplicar quaisquer alterações adicionais ou ignorar a alteração sugerida e usar as outras ferramentas de limpeza para solucionar os problemas de dados.

## Editar valores de campo Diversas variações do mesmo valor podem impedir um resumo preciso dos dados. É possível corrigir essas variações de forma rápida e fácil usando as opções a seguir. **Observação**: qualquer edição feita no valores devem ser compatíveis com o tipo de dados do campo. ### Editar valor único 1. No cartão Perfil, clique no valor que deseja editar e insira o novo valor. Um ícone de agrupamento ![Ícone de clipe de papel.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupicon.png) aparece próximo ao valor. Como alternativa, clique com o botão direito do mouse e, em seguida, clique em Editar valor. A alteração é gravada no painel Alterações, no lado esquerdo da tela. ![Edição em linha do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_inlineedit.png) 2. Consulte os resultados no painel Perfil e na grade de dados. ### Editar vários valores Há várias opções para a edição de vários valores de uma só vez. Por exemplo, use operações rápidas de limpeza para remover a pontuação em todos os valores de um campo, agrupe valores manualmente ao usar a seleção múltipla, agrupe valores automaticamente ao usar algoritmos de correspondência nebulosa que encontram valores similares ou selecione vários valores e os substitua por Nulo. **Observação**: ao mapear vários valores em um só, o campo original mostra um ícone de agrupamento ![Ícone de clipe de papel.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupicon.png) próximo ao valor, que mostra quais valores estão agrupados. #### Editar vários valores usando operações rápidas de limpeza Esta opção se aplica apenas a campos de texto. 1. No painel Perfil ou Resultados, ou na grade de dados, selecione o campo que deseja editar. 2. Clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png), selecione Limpar, em seguida selecione uma das opções a seguir: - Tornar letras maiúsculas: altera todos os valores de texto em letras maiúsculas. - Tornar letras minúsculas: altera todos os valores de texto em letras minúsculas. - Tornar letras maiúsculas: altera todos os valores de texto em letras maiúsculas. - Remover letras: remove todas as letras e deixe apenas outros caracteres. - Remover números: remove todos os números e deixa apenas letras e outros caracteres. - Remover pontuação: remove toda a pontuação. - Cortar espaços: remove espaços à esquerda e à direita. - Remover espaços adicionais: remova espaços em branco à esquerda ou à direita e substitua espaços em branco entre caracteres com um único espaço. - Remover todos os espaços: use esta opção para remover todos os espaços em branco, incluindo espaços à esquerda e à direita, bem como espaços entre caracteres. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_title_case.png) É possível empilhar operações para aplicar várias operações de limpeza nos campos. Por exemplo, primeiro selecione Limpar > Remover números, em seguida selecione Limpar > Remover pontuação para remover todos os números e pontuação dos valores de campo. 3. Para desfazer as alterações, clique na seta Desfazer, na parte superior do painel Fluxo, ou remova a alteração da lista de alterações. #### Agrupar e editar vários valores embutidos Use essa opção para selecionar manualmente vários valores e agrupá-los em um valor padrão no cartão Perfil. Para usar outros métodos para agrupar valores, consulte [Mapear manualmente vários valores para um valor padrão](#group_replace_manual) e [Mapear automaticamente os valores para um valor padrão usando uma correspondência parcial](#fuzzy_match). 1. No cartão Perfil, selecione o campo que deseja editar. 2. Pressione a tecla Ctrl ou Shift+clique, ou Command ou Shift+clique (MacOS), e selecione os valores que deseja agrupar. 3. Clique com o botão direito do mouse e selecione Agrupar no menu de contexto. O valor da seleção clicada com o botão direito do mouse se torna o nome padrão do novo grupo, mas é possível editar isso em linha. ![Uma coluna de variações do nome “C Arnold” selecionada com a ação “Agrupar”](/tableau/current/pt-br/prep/pt-br/Img/prep_groupmulti_select.png) 4. Para editar o nome do grupo, selecione o campo agrupado e edite o valor, ou clique com o botão direito do mouse ou pressione Ctrl + clique (no Mac) no campo agrupado e selecione Editar valor no menu de contexto. 5. Para desagrupar os valores do campo agrupado, clique com o botão direito do mouse no campo agrupado e selecione Desagrupar no menu de contexto. #### Substituir um ou mais valores com Nulo Caso deseje incluir linhas de dados em sua análise, mas queira excluir determinados valores de campo, basta alterá-los para um valor nulo. 1. No cartão Perfil, pressione a tecla Ctrl ou Shift+clique, ou Command ou Shift+clique (Mac), e selecione os valores que deseja alterar 2. Clique com o botão direito do mouse ou Ctrl+clique (no Mac) e selecione Substituir com nulo no menu. Os valores são alterados para nulo e o ícone de grupo ![Ícone de clipe de papel.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupicon.png) é mostrado ao lado do valor. ![Selecione Substituir por Nulo para substituir os valores por um valor Nulo.](/tableau/current/pt-br/prep/pt-br/Img/prep_replacenull2.png) ## Mapear manualmente vários valores para um valor padrão Use Agrupar valores (Agrupar e substituir em versões anteriores) para mapear valores de um campo entre si ou selecionar manualmente vários valores para agrupá-los. Além disso, é possível adicionar novos valores para definir relações de mapeamento para organizar os dados. Por exemplo, digamos que você tenha três valores em um campo: Minha Empresa, Minha Empresa Incorporada e Minha Empresa Inc. Todos esses valores representam a mesma empresa, Minha Empresa. É possível usar o editor Agrupar valores para mapear os valores Minha Empresa Incorporada e Minha Empresa Inc para Minha Empresa, de forma que os três valores apareçam como Minha Empresa no campo. ### Mapear vários valores para um único campo selecionado 1. No painel Perfil ou Resultados, selecione o campo que deseja editar. 2. Selecione Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e Agrupar valores (Agrupar e substituir em versões anteriores) > Seleção manual no menu de contexto. 3. No painel à esquerda do editor Agrupar valores, selecione o valor de campo que deseja usar como o valor de agrupamento. Esse valor agora é exibido na parte superior do painel à direita. 4. Na seção inferior do painel à direita, no editor Agrupar valores, selecione os valores que deseja adicionar ao grupo. ![Menu Agrupar valores por ortografia com três itens selecionados em “Nome do produto”. ](/tableau/current/pt-br/prep/pt-br/Img/prep_groupreplace4.png) Para remover valores do grupo, na seção superior do painel à direita, no editor Agrupar valores, desmarque a caixa de seleção próxima aos valores. ### Selecionar vários valores para criar um grupo 1. No painel Perfil ou Resultados, selecione o campo que deseja editar. 2. Selecione em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e Agrupar valores (Agrupar e substituir em versões anteriores) > Seleção manual no menu de contexto. 3. No painel à esquerda do editor Agrupar valores, selecione vários valores que você queira agrupar. 4. No painel à direita do editor Agrupar valores, clique em Agrupar valores. ![Agrupar valores por menu Manual de seleção com vários valores selecionados. ](/tableau/current/pt-br/prep/pt-br/Img/prep_groupreplace8.png) Um novo grupo é criado usando o último valor selecionado como o nome do grupo. Para editar o nome do grupo, selecione o campo agrupado e edite o valor, clique com o botão direito do mouse ou pressione Ctrl + clique (no MacOS) no campo agrupado e selecione Editar valor no menu. ![Um menu Agrupar e Substituir e opções para editar o valor dos envelopes selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupreplace9.png) ### Adicionar e identificar valores que não estão no conjunto de dados Se quiser mapear valores no conjunto de dados a um novo valor não existente, é possível adicioná-lo usando Agrupar valores (Agrupar e substituir em versões anteriores). Para identificar com facilidade qualquer valor que não estiver no conjunto de dados, esses valores são marcados com um ponto vermelho próximo ao nome no editor Agrupar valores. Por exemplo, na imagem abaixo, Wyoming e Nevada não estão no conjunto de dados. ![Editor de valores de grupo no Tableau Prep com a opção de selecionar valores de uma lista para adicionar ao grupo.](/tableau/current/pt-br/prep/pt-br/Img/prep_outofsample1.png) Alguns motivos para o valor não estar no conjunto de dados incluem os seguintes: - Você acabou de adicionar um novo valor manualmente. - O valor não está mais nos dados. - O valor está nos dados mas não está no conjunto de dados de amostra. Para adicionar um novo valor: 1. No painel Perfil ou Resultados, selecione o campo que deseja editar. 2. Clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Agrupar valores (Agrupar e substituir em versões anteriores) > Seleção manual no menu de contexto. 3. No painel à esquerda do editor Agrupar valores, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) para adicionar um novo valor. 4. Digite um novo valor no campo e pressione Enter para adicioná-lo. ![Editor de valores de grupo no Tableau Prep mostrando um novo valor digitado no campo de valor.](/tableau/current/pt-br/prep/pt-br/Img/prep_OOSAdd.png) 5. No painel à direita, selecione os valores que deseja mapear para o novo valor. ![Editor de valores de grupo no Tableau Prep mostrando valores que não estão no conjunto de dados marcados com um ponto vermelho ao lado dos nomes dos valores.](/tableau/current/pt-br/prep/pt-br/Img/prep_OOSMap.png) 6. (Opcional) Para adicionar novos valores ao valor mapeado, clique no botão de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) no painel à direita do editor Agrupar valores. ## Mapear automaticamente os valores para um valor padrão usando uma correspondência parcial Para pesquisar valores semelhantes e agrupá-los automaticamente, use um dos algoritmos de correspondência difusa. Os valores de campo são agrupados no valor que aparece com mais frequência. Consulte o valores agrupados e adicione ou remova valores no grupo conforme necessário. Se você usar funções de dados para validar os valores de campo, poderá usar a opção Agrupar valores (Agrupar e substituir em versões anteriores) para corresponder valores inválidos e válidos. Para obter mais informações, consulte [Agrupar valores semelhantes por função de dados](https://help.tableau.com/current/prep/pt-br/prep_validate_data.htm#Group_datarole) Escolha uma das opções a seguir para agrupar valores: - Pronúncia: encontre e agrupe valores com sons parecidos. Essa opção usa o algoritmo Metaphone 3, que indexa palavras por suas pronúncias, e é mais adequado para palavras em inglês. Esse tipo de algoritmo é usado por muitos corretores ortográficos populares. Esta opção não está disponível para funções de dados. - Caracteres usuais: encontre e agrupe valores que possuem letras ou números em comum. Essa opção usa o algoritmo biométrico ngram, que indexa palavras por seus caracteres únicos depois de remover a pontuação, os duplicados e os espaços em branco. Esse algoritmo funciona para qualquer idioma compatível. Esta opção não está disponível para funções de dados. Por exemplo, esse algoritmo corresponderia nomes representados como "John Smith" e "Smith, John", pois ambos geram a chave "hijmnost". Como esse algoritmo não leva em consideração a pronúncia, o valor "Tom Jhinois" teria a mesma chave "hijmnost", e também seria incluído no grupo. - Ortografia: encontre e agrupe valores textuais com grafias parecidas. Essa opção usa o algoritmo de distância de Levenshtein para calcular uma distância de edição entre dois valores textuais com o uso de um limite padrão fixo. Ele depois os agrupa quando a distância de edição for menor do que o valor do limite. Esse algoritmo funciona para qualquer idioma compatível. Ele fica disponível para uso após a aplicação de uma função de dados. Nesse caso, ele corresponde os valores inválidos ao valor válido mais próximo usando a distância de edição. Se o valor padrão não estiver em sua amostra do conjunto de dados, o Tableau Prep vai adicioná-lo automaticamente e marcá-lo como não existente no conjunto de dados original. - Pronúncia + Ortografia: agora, se você atribuir uma função de dados aos campos, poderá usá-la para correspondência, além de agrupar valores com o valor padrão definido por ela. Essa opção corresponde os valores inválidos ao valor válido mais semelhante com base na ortografia e na pronúncia. Se o valor padrão não estiver em sua amostra do conjunto de dados, o Tableau Prep vai adicioná-lo automaticamente e marcá-lo como não existente no conjunto de dados original. Esta opção é mais adequada para palavras em inglês. Para obter mais informações, consulte [Limpar e formatar dados](#Group_datarole). Quer ler mais sobre esses algoritmos de correspondência difusa? Consulte [Agrupamento automatizado no Tableau Prep Builder](https://www.tableau.com/pt-br/blog/automated-grouping-tableau-prep-builder) em Tableau.com. ### Agrupar valores semelhantes usando correspondência difusa 1. No painel Perfil ou Resultados, selecione o campo que deseja editar. 2. Clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Agrupar valores e, em seguida, selecione uma das opções a seguir: - Pronúncia - Caracteres usuais - Ortografia ![Um menu suspenso exibe o Valor do Grupo por opções.](/tableau/current/pt-br/prep/pt-br/Img/prep_groupreplace7.png) O Tableau Prep Builder encontra e agrupa valores correspondentes e os substitui pelo valor que ocorre com mais frequência no grupo. 3. Consulte os agrupamentos, adicione e remova manualmente os valores ou edite-os conforme necessário. Em seguida clique em Concluído. ![Menu Agrupar valores por ortografia com três itens selecionados em “Nome do produto”. ](/tableau/current/pt-br/prep/pt-br/Img/prep_groupreplace6.png) ### Ajustar os resultados ao agrupar valores de campo Se você agrupar valores semelhantes por Ortografia ou Pronúncia, poderá alterar os resultados usando o controle deslizante no campo para ajustar o quão rigorosos são os parâmetros de agrupamento. Dependendo de como o controle deslizante for definido, é possível ter mais controle sobre o número de valores incluídos em um grupo e o número de grupos que serão criados. Por padrão, o Tableau Prep detecta a configuração de agrupamento ideal e mostra o controle deslizante nessa posição. Ao alterar o limite, o Tableau Prep analisa uma amostra dos valores para determinar o novo agrupamento. Os grupos gerados pela configuração são salvos e gravados no painel Alterações, mas a configuração de limite não é salva. Na próxima vez que o editor Agrupar valores for aberto, para editar a alteração existente ou para fazer uma nova alteração, o controle deslizante de limite será mostrado na posição padrão, permitindo que você faça ajustes com base no conjunto de dados atual. 1. No painel Perfil ou Resultados, selecione o campo que deseja editar. 2. Clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Agrupar valores (Agrupar e substituir em versões anteriores) e, em seguida, selecione uma das opções a seguir: - Pronúncia - Ortografia ![Uma ferramenta de correspondência difusa agrupa nomes por pronúncia.](/tableau/current/pt-br/prep/pt-br/Img/prep_fuzzy_slider1.png) O Tableau Prep encontra e agrupa valores correspondentes e os substitui pelo valor que ocorre com mais frequência no grupo. 3. No painel à esquerda do editor Agrupar valores, arraste o controle deslizante para um dos cinco níveis de limite para alterar os resultados. ![Diálogo Agrupar por Pronúncia com uma lista de nomes de cidades agrupados.](/tableau/current/pt-br/prep/pt-br/Img/prep_fuzzy_slider2.png) Para definir um limite mais rigoroso, mova o controle deslizante para a esquerda. Isso resulta em menos correspondências e cria menos grupos. Para definir um limite mais flexível, mova o controle deslizante para a direita. Isso resulta em mais correspondências e cria mais grupos. 4. Clique em Concluir para salvar as alterações. ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Manter as licenças do Tableau Desktop e do Tableau Prep O Tableau Desktop e o Tableau Prep Builder podem ser licenciados sob um modelo de licença com prazo. Quando você compra uma assinatura nova do Tableau Server ou do Tableau Cloud, no entanto, as chaves do produto não são mais emitidas para Tableau Desktop ou Tableau Prep Builder. Em vez disso, você usa gerenciamento de licenças baseadas em logon para ativar e entrar no Tableau Server ou Tableau Cloud. Para obter mais informações, consulte [Ativar o Tableau usando o gerenciamento de licenças baseado em logon](https://help.tableau.com/current/online/pt-br/license_lblm.htm). As licenças com prazo devem ser renovadas e a chave do produto deve ser atualizada para continuarem a oferecer serviço ininterrupto. Você pode renovar continuamente a licença com prazo à medida que cada período especificado expira. Se a sua licença com prazo não for renovada e o prazo expirar, o Tableau não funcionará mais e o acesso o software será interrompido. Para obter mais informações sobre como renovar sua licença, consulte [Como renovar as licenças do Tableau](https://www.tableau.com/pt-br/support/renew). **Observação**: as licenças de avaliação do Tableau Prep expiram após um período de tempo definido, geralmente 14 dias. Após a expiração do período de avaliação, você precisará [comprar uma licença](https://www.tableau.com/pt-br/pricing/individual) para continuar usando o produto. ## Mostrar dados sobre a licença Depois de instalar o Tableau Desktop ou o Tableau Prep, abra o aplicativo e navegue até Ajuda > Gerenciar chaves do produto no menu superior para ver as informações sobre o tipo de licença que você tem e a data de expiração. Também é possível ativar ou desativar uma chave do produto ou atualizar uma chave do produto de manutenção nessa caixa de diálogo, se não estiver usando a opção de Desktop Virtual (ATR). **Observação**: o Tableau oferece licenças com prazo que fornecem uma variedade de recursos. O tipo da sua licença é exibido no campo Produto. Para obter mais informações sobre os diferentes tipos de licenças baseadas em usuário disponíveis, consulte [Licenças baseadas em usuário](https://help.tableau.com/current/server/pt-br/license_server_overview.htm#user-based) na ajuda do Tableau Server. Os usuários existentes do Tableau Desktop podem ter uma licença perpétua (permanente). As licenças perpétuas não expiram, e o campo Licença expira na caixa de diálogo Gerenciar chaves de produto exibe "Permanente". No entanto, para obter acesso a atualizações de produtos e suporte técnico, é necessário comprar os Serviços de suporte e manutenção. Esses serviços devem ser renovados para continuar recebendo o serviço. As licenças perpétuas (permanentes) não estão mais disponíveis para o Tableau Desktop. ![Caixa de diálogo Gerenciar chaves do produto com o botão Atualizar destacado.](/tableau/current/pt-br/prep/pt-br/Img/licensekey_refresh.png) Use os seguintes botões para executar a chave do produto: - Atualizar (apenas sem ser o gerenciamento de licenças baseadas em logon e o Desktop Virtual): clique no botão Atualizar para atualizar uma licença de manutenção que está expirando, em seguida, feche e reinicie o Tableau Desktop. Se a data do campo A manutenção expira não for atualizada, verifique com o administrador de licença, pois a chave ou o contrato de manutenção pode ter mudado. Uma chave do produto cujo valor de expiração de licença está listado como "Permanente", como mostrado na caixa de diálogo Gerenciar chaves de produto acima, é uma chave de produto antiga. Você pode atualizar uma chave permanente do produto a qualquer momento, desde que a data final de manutenção listada no Portal do Cliente do Tableau seja posterior à data refletida na caixa de diálogo Chaves de produto do Desktop Manager. Se a chave do produto tiver atingido a data de validade (chaves do produto não permanentes), não será possível atualizá-la. Visite o Portal do Cliente do Tableau para obter uma chave do produto de assinatura atualizada e realizar uma nova ativação. Se a chave do produto não tiver atingido a data de validade, será possível atualizá-la. Quando você atualiza uma chave de produto que ainda não expirou, apenas o valor "Licença expira" mudará e não a chave do produto. A chave do produto mudará quando atingir a data de validade. Para atualizar uma chave de manutenção na linha de comando, consulte [Atualizar a chave do produto](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm#refresh-the-product-key-tableau-desktop-only) no Guia de implantação do Tableau Desktop e do Tableau Prep. **Observação:** não é possível atualizar a chave do produto se Tableau Desktop estiver off-line. Se você estiver ativando o Tableau Desktop no modo off-line, obtenha e ative uma nova chave no Portal do cliente Tableau. - Desativar (apenas sem ser o gerenciamento de licenças baseadas em logon e o Desktop Virtual): selecione uma chave do produto na lista e clique em Desativar para desativar a chave do produto. Desative uma chave do produto se precisar movê-la para outro computador ou se não precisar mais dela nesse computador. Para obter mais informações sobre a desativação de uma chave do produto, consulte [Mover ou desativar chaves do produto](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_move_or_deactivate.htm) no Guia de implantação do Tableau Desktop e do Tableau Prep. - **Ativar**: depois de instalar o Tableau Desktop ou o Tableau Prep, clique em Ativar para abrir a caixa de diálogo de ativação e inserir a chave do produto. Caso receba um erro e não possa ativar o Tableau Desktop ou Tableau Prep usando a chave do produto, entre em contato com o [Suporte do Tableau](https://www.tableau.com/pt-br/support/case#create_case). Para obter mais informações sobre a ativação de uma chave do produto, consulte [Ativar e registrar seu produto](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm#activate-and-register-your-product) no Guia de implantação do Tableau Desktop e do Tableau Prep. ## Atualize automaticamente as chaves do produto usando o licenciamento sem tempo de inatividade A partir da versão 2021.1 do Tableau, os usuários do Tableau Desktop e do Tableau Prep Builder conectados à Internet talvez não precisem mais atualizar manualmente as chaves do produto. Licenças por prazo são automaticamente atualizadas sem exigir qualquer ação, a partir de 14 dias antes da expiração da assinatura se o usuário estiver conectado ao Tableau Desktop ou Tableau Prep Builder. Chaves do produto permanentes não são atualizadas automaticamente e devem ser atualizadas manualmente usando a opção de menu Gerenciar chaves do produto. O Tableau Desktop e o Tableau Prep Builder tentarão atualizar silenciosamente uma chave ativa do produto e avisará os usuários 14 dias antes de a licença expirar, se a atualização silenciosa não tiver sucesso. O Tableau tentará atualizar uma chave do produto três vezes (14 dias, 4 dias e 1 dia antes do vencimento da licença) para refletir as extensões da data final da licença, como resultado da renovação da sua assinatura. A chave do produto não é atualizada a menos que um usuário do Tableau Desktop faça login em Tableau Desktop durante aqueles períodos. Para usuários que não fazem login no Tableau Desktop todos os dias, você deve atualizar suas chaves do produto usando a opção de menu Gerenciar chaves de produto. ## Monitorar dados de uso e de expiração da licença do Tableau Desktop Se quiser monitorar e ver os dados de uso e de expiração da licença do Tableau Desktop no Tableau Server, configure o Tableau Desktop para enviar os dados de licença para o Tableau Server em um intervalo definido e, em seguida, habilite os relatórios no Tableau Server. Isso permite que os administradores do servidor acessem dois relatórios: - Uso da licença do Desktop: este relatório permite que administradores do servidor visualizem os dados de uso das licenças do Tableau Desktop na sua organização. - Vencimento da licença do Desktop: este relatório apresenta informações aos administradores do servidor sobre quais licenças do Tableau Desktop na sua organização venceram ou precisam de renovação de manutenção. Se o Tableau Desktop e o Tableau Server estiverem configurados para relatórios de licenciamento, ao entrar no Tableau Server como Administrador, você verá esses dois relatórios listados na página Status do servidor, na seção Análise. ![Vários painéis de status do servidor.](/tableau/current/pt-br/prep/pt-br/Img/server_status_licensing.png) Caso não veja esses relatórios listados, é possível que o Tableau Desktop e o Tableau Server não estejam configurados para os relatórios de uso do Tableau Desktop. Para obter informações sobre como configurar o Tableau Desktop e o Tableau Server para os relatórios de uso, consulte [Gerenciar o uso da licença do Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm) no Guia de implantação do Tableau Desktop e do Tableau Prep. ## Recursos adicionais Para obter mais informações sobre o gerenciamento de licenças, consulte os tópicos a seguir: - Para encontrar a chave do produto e ativar o Tableau Desktop ou Tableau Prep Builder consulte [Onde encontrar minha chave do produto?](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm#wheres-my-product-key). - Para desativar uma chave do produto ou movê-la para outro computador, consulte [Mover ou desativar o Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_move_or_deactivate.htm). - Para saber mais sobre as chaves do produto para desktops virtuais não persistentes ou para computadores que são reformatados regularmente, consulte [Configurar o suporte de desktop virtual](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_license_deactivate.htm). - Para saber mais sobre o gerenciamento de chaves do produto no Tableau Server ou Tableau Cloud, consulte Visão geral de licenciamento ([Linux](https://help.tableau.com/current/server-linux/pt-br/license_server_overview.htm) | [Windows](https://help.tableau.com/current/server/pt-br/license_server_overview.htm)) - Para saber mais sobre o processo de renovação de licença ou renovar uma licença, consulte [Como renovar as licenças do Tableau](https://www.tableau.com/pt-br/support/renew). [Pular para o conteúdo principal](#main-content) # Manter dados de fluxo atualizados **Observação**: o conteúdo deste tópico é focado em fluxos de execução em uma agenda, o que requer o Data Management com Tableau Prep Conductor ativado. A partir da versão 2020.4.1, Data Management não precisa criar e editar fluxos no Tableau Server e no Tableau Cloud e executar fluxos manualmente. Você criou seu fluxo e limpou seus dados, mas agora deseja compartilhar seu conjunto de dados com outros e manter estes dados atualizados. Execute seus fluxos manualmente no Tableau Prep Builder e na Web publique uma extração no Tableau Server, mas agora há uma maneira melhor. Conheça o Tableau Prep Conductor, parte do Data Management e disponível no Tableau Server a partir versão 2019.1 e no Tableau Cloud. Se você adicionar essa opção à instalação do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm), poderá usar o Tableau Prep Conductor para executar seus fluxos em uma agenda para manter os dados do fluxo atualizados. Para obter informações sobre como configurar o Tableau Prep Conductor, consulte o conteúdo do Tableau Prep Conductor na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm). E, a partir da versão 2021.3, você pode executar até 20 fluxos em uma programação, um após o outro, usando a nova opção Tarefas vinculadas. Para obter mais informações sobre como executar fluxos usando tarefas vinculadas, consulte **Agendar tarefas vinculadas** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm#schedule-linked-tasks) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm#schedule-linked-tasks). ![A página Visão geral do Tableau Prep Conductor na Web.](/tableau/current/pt-br/prep/pt-br/Img/prep_conductor_overview.png) **Observação**: se o Tableau Catalog estiver instalado, você também poderá ver avisos de qualidade de dados sobre os dados de entrada do fluxo e exibir o impacto de upstream e downstream dos campos em seu fluxo, na nova guia Linhagem. Para obter mais informações sobre Tableau Catalog, consulte [Sobre o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) na ajuda do Tableau Server. Com o Tableau Prep Conductor é possível: - Configurar o Servidor ou Site para usar o Tableau Prep Conductor - Habilitar ou desabilitar o Tableau Prep Conductor para sites individuais - Configurar notificações por e-mail para falhas de fluxo dos fluxos executados sob demanda ou usando uma agenda - Definir configurações de tempo limite do fluxo - Publicar um fluxo do Tableau Prep Builder no Tableau Server ou no Tableau Cloud. A partir da versão 2020.4.1, o Data Management não precisa publicar fluxos para a Web. **Observação**: a partir da versão 2026.2.4 do Tableau Cloud, como Creator, você também pode carregar fluxos diretamente em seu site. Para obter mais informações, consulte [Gerenciar um fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_manage_flow.htm). - Carregue os arquivos de dados ou se conectar diretamente aos seus arquivos (Tableau Prep Builder somente) ou bancos de dados. Se estiver se conectando a bancos de dados, é possível incorporar as credenciais do banco de dados ou exigir um prompt de usuário. **Observação**: se você se conectar aos arquivos de dados por meio de uma conexão direta ou publicar a saída de fluxo em um compartilhamento de arquivos, os arquivos precisarão estar em um local que o Tableau Server possa acessar. Essa opção não está disponível para fluxos criados na Web. Para obter mais informações, consulte [Etapa 4: locais de entrada e saída da lista de segurança](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm) na ajuda do Tableau Server. - Selecionar de uma hierarquia de projeto ao publicar seus fluxos - Inserir tags e uma descrição para ajudar os outros a encontrar seu fluxo - Gerenciar o fluxo - Definir permissões - Mover o fluxo para um projeto diferente - Alterar o proprietário do fluxo - Adicionar ou editar tags - Exibir o histórico de versões e selecionar na lista para restaurar o fluxo para uma versão anterior - Marcar um fluxo como favorito e adicioná-lo à lista de favoritos - Editar uma conexão de entrada e atualizar credenciais - Visualizar fontes de dados criadas a partir de um fluxo e vincular de volta para o fluxo que a criou - Crie agendas para executar os fluxos ou execute as programações sob demanda - Adicionar tarefas agendadas para executar o fluxo e selecionar quais saídas de fluxo serão atualizadas - Adicione tarefas agendadas vinculadas para executar vários fluxos, um após o outro - Executar o fluxo sob demanda sem uma agenda - Monitorar o fluxo - Configurar notificações de alerta por e-mail - Ver erros - Monitorar e reiniciar fluxos que foram suspensos - Ver histórico de execução - Usar exibições administrativas ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Notas de versão do Tableau Prep Este tópico descreve o que há de novo na versão mais recente.Use a visualização abaixo para explorar novos recursos no Tableau Prep.Clique em um recurso para exibir a dica de ferramenta com um link para a documentação detalhada desse recurso.Explore os filtros para refinar sua pesquisa.Baixe os dados para criar uma lista personalizada. - Clique em Pesquisar por recurso para ver uma lista de novos recursos para um produto ou uma versão ou explorar quando um recurso foi lançado.The dashboard currently defaults to Tableau Prep as the product (which includes Prep Builder and Prep Conductor features) for the version Tableau Prep Builder. - Clique em Atualizar Prep para ver uma lista de recursos específicos para sua atualização.Se você publicar fluxos no Tableau Server para executá-los em uma programação, alguns novos recursos exigirão uma versão mínima do Tableau Server para serem executados.A exibição lista a versão mínima do Tableau Server que oferece suporte ao agendamento dos fluxos criados em uma versão específica do Tableau Prep Builder para ajudá-lo a identificar rapidamente recursos com requisitos de compatibilidade. **Dica**: clique no botão Baixar na barra de ferramentas de visualização (enquanto nenhum nome de recurso estiver selecionado) e selecione Dados para exportar a lista para um arquivo CSV que você pode personalizar. ## Recursos relacionados [Novos recursos](https://www.tableau.com/pt-br/products/new-features) Consulte resumos de novos recursos para obter as versões compatíveis atualmente. [Todos os problemas conhecidos](https://issues.salesforce.com/ "Todos os problemas conhecidos") | [Downloads](https://www.tableau.com/pt-br/support/releases/prep) [Pular para o conteúdo principal](#main-content) # Preencher lacunas em dados sequenciais _Com suporte no Tableau Prep Builder versão 2021.3.1 e posterior e na Web no Tableau Servidor e Tableau Cloud versão 2021.3.0 e posterior._ Quando você tem lacunas em seu conjunto de dados sequenciais, pode ser necessário preenchê-las com novas linhas para analisar seus dados com eficácia ou realizar análises de tendências. Você pode usar o tipo de etapa Novas linhas para gerar as linhas ausentes e definir opções de configuração para obter os resultados de que precisa. Novas linhas podem ser geradas para campos com valores numéricos (números inteiros) ou de data. As opções de configuração incluem: - Gerar linhas usando valores de um único campo ou dois campos - Use todos os dados do campo ou selecione um intervalo de valores - Crie um novo campo com os resultados ou adicione as novas linhas aos campos existentes - Defina o incremento (até 10.000) para usar ao gerar as novas linhas - Defina os valores das novas linhas como zero, Nulo ou copie o valor da linha anterior. **Exemplos** - **Exemplo 1**: você tem uma tabela de dados de vendas, mas há alguns dias em que nenhuma venda é registrada. Você precisa de uma linha para todos os dias, não apenas para os dias em que teve vendas. Com as Novas linhas, você pode gerar linhas para os dias que faltam e adicioná-las ao campo "Dias da semana" existente. Como nenhuma venda é registrada nesses dias, você deseja que o valor da quantidade vendida seja zero. ![Uma tabela rotulada como tabela original ao lado de uma tabela em que linhas ausentes foram adicionadas usando a etapa de novas linhas no Tableau Prep,](/tableau/current/pt-br/prep/pt-br/Img/prep_new_rows_example1.png) - **Exemplo 2**: você tem uma tabela de dados de vendas onde os pedidos preenchidos são registrados usando um intervalo de datas. Você precisa de uma linha para cada dia. Como você não sabe quantos pedidos foram atendidos a cada dia, deseja que os valores das novas linhas sejam Nulos. Com Novas linhas, você pode gerar as linhas que faltam entre as duas datas e criar um novo campo chamado "Todos os dias" para preservar seus dados originais. ![Uma tabela rotulada como tabela original ao lado de uma tabela em que linhas ausentes foram adicionadas usando a etapa de novas linhas no Tableau Prep,](/tableau/current/pt-br/prep/pt-br/Img/prep_new_rows_example2.png) ## Gerar novas linhas 1. No painel Fluxo, clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Novas linhas. Uma etapa Novas linhas é exibida no painel Fluxo. Conclua as etapas a seguir para configurar suas opções e gerar as novas linhas. 2. Como quer adicionar novas linhas? Use uma das seguintes opções para selecionar o campo ou campos em que as linhas estão faltando. 1. Valores de um campo: gere linhas ausentes de valores em um único campo. Use esta opção para os tipos de dados Número (inteiro) ou Data. Por padrão, use os valores mínimo e máximo para gerar linhas ausentes. Essa opção usa todos os valores do campo. Se você deseja usar apenas um intervalo de valores para gerar as linhas ausentes, defina um valor inicial e um valor final. **Observação**: os campos Valor inicial e Valor final não podem ser usados para gerar linhas fora de seu conjunto de dados atual. 2. O valor varia de dois campos: gere novas linhas usando um intervalo de valor entre dois campos de data. Esta opção está disponível apenas para os tipos de dados Data, usa todos os valores do campo e requer que ambos os campos tenham o mesmo tipo de dados. 3. Onde você deseja adicionar as novas linhas? Ao usar um único campo, você pode adicionar as novas linhas ao campo existente ou criar um novo campo para preservar seus dados originais. Ao usar intervalos de valor de dois campos, você deve criar um novo campo. - Nome do campo: insira um nome para o novo campo de trabalho. ![Caixa de diálogo perguntando onde você deseja adicionar novas linhas, com a opção criar novo campo selecionada.](/tableau/current/pt-br/prep/pt-br/Img/prep_new_rows_new_field.png) 4. Especifique seu valor de incremento: insira um valor de 1 a 10.000. Cada nova linha é incrementada pelo valor que você selecionar. Se você selecionar um valor maior do que a lacuna entre os valores, nenhuma nova linha será gerada. - **Campos numéricos**: selecione um valor numérico. - **Campos de data**: selecione um valor numérico e selecione Dia, Semana ou Mês. 5. Quais valores suas novas linhas devem ter?: selecione uma opção para preencher os outros valores de campo para as novas linhas. - Nulo: preenche todos os valores de campo com Nulo. - Nulo ou zero: preencha todos os valores de texto com Nulo e todos os valores numéricos com zero. - Copiar da linha anterior: preencha todos os valores de campo com o valor da linha anterior. ![Caixa de diálogo perguntando quais valores suas novas linhas devem ter, com a opção nula ou zero selecionada.](/tableau/current/pt-br/prep/pt-br/Img/prep_new_rows_values.png) Novas linhas são mostradas no painel Linhas geradas **em negrito**, conforme você insere suas definições de configuração. Os detalhes da linha são mostrados no painel Resultados de novas linhas. ![Novas linhas no painel Linhas geradas são exibidas em negrito nas configurações, e os detalhes das linhas são mostrados no painel Resultados das novas linhas.](/tableau/current/pt-br/prep/pt-br/Img/prep_new_rows_results.png) [Pular para o conteúdo principal](#main-content) # Publicar um fluxo no Tableau Server ou Tableau Cloud > [!IMPORTANT] > > **Importante**: a partir da versão 2020.4.1, Data Management não é mais necessário para publicar os fluxos no Tableau Server ou no Tableau Cloud ou para executar os fluxos manualmente na Web. Ele só será necessário (com o Tableau Prep Conductor habilitado) se você planejar a execução de fluxos de acordo com a agenda. Publique seus fluxos no Tableau Server ou Tableau Cloud para compartilhá-los com outras pessoas ou executá-los automaticamente em uma programação e atualizar a saída do fluxo usando o Tableau Prep Conductor. Você também pode executar fluxos individuais manualmente no servidor. Os fluxos criados ou editados na Web (versão 2020.4 e posteriores) devem ser publicados antes da execução. A partir versão 2026.2.4 do Tableau Cloud, como Creator, você também pode carregar fluxos diretamente em seu site. Para obter mais informações, consulte [Gerenciar um fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_manage_flow.htm). Para obter informações sobre publicação de fluxos na Web, consulte **Publicação de fluxos** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm#publishing-flows) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm#publishing-flows). Para obter informações sobre a execução de fluxos, consulte [Executar o fluxo](https://help.tableau.com/current/prep/pt-br/prep_conductor_run_flow.htm) . ## Antes de publicar Para garantir que você possa executar o fluxo, verifique o seguinte: 1. Verifique se não há erros no fluxo. Haverá falhas nos fluxos que contêm erros ao tentar executá-los no Tableau Server ou Tableau Cloud. Os erros no fluxo são identificados por um ponto de exclamação vermelho e um ponto vermelho com um indicador de Erros no canto superior direito da tela. ![Um fluxo do Tableau Prep mostrando o ícone de erro do triângulo vermelho para etapas de fluxo com erros.](/tableau/current/pt-br/prep/pt-br/Img/prep_flow_error.png) 2. Verifique se o fluxo não inclui conectores de entrada ou recursos que não são compatíveis com a sua versão do Tableau Server. Os fluxos criados na Web são sempre compatíveis com a versão do servidor em que são criados. Você ainda pode publicar fluxos no Tableau Prep Builder, incluindo conectores ou recursos que ainda não são compatíveis com a sua versão do Tableau Server, mas você não pode agendar a execução deles. Por exemplo, o conector SAP HANA foi introduzido na versão 2019.1.4 do Tableau Prep Builder, mas esse conector não é compatível até a versão 2019.2 do Tableau Server para o Tableau Prep Conductor. Ao publicar o fluxo, você verá uma mensagem como o exemplo abaixo: ![Uma notificação de que uma versão desatualizada do Tableau Prep Conductor está em operação.](/tableau/current/pt-br/prep/pt-br/Img/prep_incompatible2.png) **Observação**: para agendar a execução de fluxos no Tableau Server, você deve usar o Tableau Server versão 2019.1 ou posteriores e ter o Tableau Prep Conductor habilitado. Para executar seu fluxo no Tableau Server, é necessário tomar as medidas apropriadas para tornar o fluxo compatível. Para obter mais informações sobre como trabalhar com fluxos incompatíveis, consulte [Compatibilidade de versão com o Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_conductor_compatibility.htm). 3. Os fluxos que incluem etapas de entrada ou saída com conexões a um compartilhamento de rede exigem uma lista de permissões. O Tableau Cloud não oferece suporte a essa opção e os arquivos devem ser empacotados com o fluxo na publicação. **Observação**: no momento, os fluxos criados na Web só podem ser gerados para uma fonte de dados publicada ou um banco de dados. **Tableau Prep Builder** As etapas de entrada e saída do fluxo que apontam para os arquivos armazenados em um compartilhamento de rede (caminho UNC) não são permitidas, a menos que o arquivo e o caminho estejam acessíveis pelo servidor e incluídos na lista de permissões da sua organização. Se você publicar o fluxo sem adicionar o local do arquivo à sua lista segura, o fluxo será publicado, mas você receberá um erro ao tentar executar o fluxo manualmente ou usando um agendamento no Tableau Server. Se os arquivos não estiverem armazenados em um local da lista de permissões, você verá uma mensagem de aviso ao publicar o fluxo. ![Uma mensagem de erro informando que o local de saída não está na sua lista segura e vinculando a lista para adicioná-lo.](/tableau/current/pt-br/prep/pt-br/Img/prep_serverfiles_safelist.png) Clique no link "lista" na mensagem para ver uma lista de locais permitidos. Mova seus arquivos para um dos locais na lista e verifique se o fluxo aponta para esses novos locais. ![A lista de locais de arquivos da lista segura.](/tableau/current/pt-br/prep/pt-br/Img/prep_conductor_safelist_locations.png) No Tableau Server, para configurar os caminhos de rede permitidos, use as opções de comando tsm descritas na [Etapa 4: lista de permissões para locais de entrada e saída](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm) na ajuda do Tableau Server. Se não quiser mover seus arquivos para um local da lista de permissões, será necessário empacotar os arquivos de entrada com o fluxo e publicar a saída do fluxo no Tableau Server como uma fonte de dados publicada. Para obter mais informações sobre como definir essas opções, consulte [Publicar um fluxo no Tableau Prep Builder](#Publish) neste tópico. 4. (**Somente para o Tableau Prep Builder**) Se as etapas de saída de fluxo forem definidas como Publicar como uma fonte de dados, todas as etapas de saída de fluxo devem apontar para o mesmo servidor ou site em que o fluxo é publicado. Elas podem apontar para diferentes projetos nesse servidor ou site, mas apenas um servidor ou site pode ser selecionado. Para definir o local de publicação para as etapas de saída, faça o seguinte: 1. No painel Fluxo, selecione uma etapa de saída. 2. No painel Publicação, selecione **Publicar como fonte de dados**. 3. Selecione o servidor ou site e o projeto no qual deseja publicar o fluxo. Entre no servidor ou site, se necessário. 4. Insira um nome e uma descrição para cada saída. O nome do arquivo de saída deve ser diferente o suficiente para que a pessoa que executa o fluxo possa identificar facilmente quais arquivos de saída serão atualizados. O nome do arquivo é mostrado na página Visão geral e Conexões do fluxo em Tableau Server ou Tableau Cloud. 5. Salve seu fluxo. ![O campo Salvar saída em é definido como Fonte de dados publicada. Uma tabela de dados é exibida.](/tableau/current/pt-br/prep/pt-br/Img/prep_publishasdatasource2.png) Para obter mais informações sobre como configurar as etapas de saída para publicação, consulte [Criar arquivos de extração de dados e fontes de dados publicadas](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#Extract). 5. Definir o método de autenticação do servidor (versão 2025.3 e posterior) Para oferecer melhor suporte para logon único (SSO) e autenticação multifator (MFA) ao entrar no Tableau Server ou no Tableau Cloud do Tableau Prep Builder, é possível optar por autenticar usando o navegador incorporado fornecido com Tableau Prep ou o navegador externo. A configuração padrão é Usar configurações do servidor. Ao entrar, o Tableau Prep Builder verificará se o método de autenticação preferencial do servidor está definido como Navegador externo. Isso é habilitado pelo administrador. Se essa configuração não estiver ativada, o Tableau Prep usará o navegador inserido como padrão. Você também pode selecionar manualmente uma opção diferente no menu, e o Tableau Prep usará o método selecionado ao autenticar. ![Menu do método de autenticação do Tableau Prep Builder Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_server_authentication_method_menu.png) Para visualizar ou alterar seu método de autenticação, faça o seguinte: 1. No Tableau Prep Builder, no menu superior, selecione Servidor > Método de autenticação do servidor. 2. No menu, clique em uma das seguintes opções para definir seu método de autenticação: - Usar as configurações do servidor (padrão): use o método de autenticação preferencial definido pelo administrador. Ele pode ser o navegador padrão ou o navegador inserido. Para obter mais informações sobre como configurar essa definição como administrador, consulte [Opções de tsm configuration set](https://help.tableau.com/current/server-linux/pt-br/cli_configuration-set_tsm.htm#wgserverauthenticationprepbuilderexternalbrowser). - Navegador inserido: use a versão padrão do Chromium fornecida com o Tableau Builder. - Navegador padrão: use o navegador padrão definido para sua máquina, como Chrome, Edge, Firefox, Safari e assim por diante. ## Publicar um fluxo no Tableau Prep Builder **Observação**: quando você publica um fluxo, é automaticamente designado como o proprietário do fluxo padrão. Se o fluxo se conectar a uma fonte de dados publicada, o servidor usará o proprietário do fluxo para se conectar à fonte de dados publicada. Somente o administrador do Site ou do Servidor pode alterar o proprietário do fluxo e somente para ele próprio. 1. Abra seu fluxo no Tableau Prep Builder. 2. No menu superior, selecione **Servidor** > **Publicar fluxo**. ![Um menu de servidor com opção para Publicar fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_server_publish_flow.png) 3. Preencha os campos para sua plataforma. Em seguida, clique em **Publicar**. O Tableau Server ou Tableau Cloud é aberto automaticamente na página de **Visão geral** do fluxo no seu navegador padrão. 1. Na caixa de diálogo Publicar no Tableau Server, preencha os seguintes campos: - **Projeto:** clique na opção suspensa para selecionar o projeto na hierarquia. Esse deve ser o mesmo projeto no qual os arquivos de saída estão publicados. - **Nome:** digite um nome para o fluxo. Esse nome é exibido no servidor, nas páginas de Fluxo. Se quiser substituir um fluxo existente, clique na opção suspensa para selecionar um nome na lista. - **Descrição (opcional):** insira uma descrição para o fluxo. - **Marcas (opcional):** clique em Adicionar para digitar em uma ou mais marcas, a fim de identificar seu fluxo para que os usuários possam localizá-lo facilmente. Marcas também podem ser adicionadas após a publicação nas páginas de Fluxo no Tableau Server. 2. Clique em Editar na seção Conexões para editar as configurações de conexões ou alterar a autenticação. ![Um formulário para publicar um fluxo no Tableau Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_serverfiles2.png) #### Arquivos Por padrão, as conexões de entrada de arquivo são empacotadas com o fluxo. Os arquivos empacotados não são atualizados quando o fluxo é executado no Tableau Server. Todos os arquivos devem ter a mesma configuração, Upload ou Conexão direta. **Conexão direta** Para recuperar os dados mais atuais ao atualizar os arquivos de saída, selecione a Conexão direta se o Tableau Server puder se conectar ao local do arquivo e a localização estiver incluída na lista de permissões da organização. ![Publique o fluxo no Tableau Server com botões de opção para escolher uma conexão.](/tableau/current/pt-br/prep/pt-br/Img/prep_serverfiles.png) **Arquivos armazenados em um compartilhamento de rede** Se as etapas de entrada ou saída apontarem para arquivos armazenados em um compartilhamento de rede (caminho UNC) e o local não estiver incluído na lista de permissões da sua organização, você verá uma mensagem de aviso. Clique no link da mensagem para ver uma lista de locais confiáveis, mova os arquivos e aponte as etapas de entrada e saída para o novo local de arquivo. Para obter mais informações, consulte a Etapa 3 em [Antes de publicar](#pre-publish). Para obter informações sobre como adicionar locais à lista de permissões da sua organização, consulte [Etapa 4: incluir locais de entrada e saída à lista de permissões](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm) na ajuda do Tableau Server. ![Uma mensagem de erro informando que o local de saída não está na sua lista segura e vinculando a lista para adicioná-lo.](/tableau/current/pt-br/prep/pt-br/Img/prep_serverfiles_safelist.png) **Parâmetros no caminho do arquivo de entrada** A partir da versão 2022.1.1, você pode agendar e executar fluxos na Web que incluem parâmetros no caminho do arquivo de entrada. Isso requer uma conexão de arquivo direta. Se seus arquivos estiverem empacotados com o fluxo, ou você estiver usando uma versão anterior do Tableau Prep, todos os parâmetros incluídos nos caminhos de arquivo serão alterados para o valor atual (padrão) e o caminho do arquivo se tornará estático. Para obter mais informações sobre como usar parâmetros em fluxos, consulte [Aplicar parâmetros às etapas de entrada](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm#parameters_input_steps). #### Bancos de dados Se o fluxo se conectar a um ou mais bancos de dados, selecione um dos tipos de autenticação a seguir a ser usado para se conectar às fontes de dados de entrada de fluxo. - **Conta Run As do servidor:** a conta de usuário Run As do servidor autenticará todos os usuários. - **Prompt de usuário:** você deve editar a conexão no Tableau Server e inserir as credenciais do banco de dados antes de executar o fluxo. - **Senha inserida:** as credenciais usadas para se conectar aos dados serão salvas com a conexão e usadas quando o fluxo é executado em uma agenda. Se você abrir o fluxo para editá-lo, precisará inserir novamente suas credenciais. ![A caixa de diálogo Fluxo de publicação no Tableau Online com configurações de conexão. A senha incorporada está selecionada.](/tableau/current/pt-br/prep/pt-br/Img/prep_publishwithdatabase.png) **Adicionar credenciais** (versão 2020.1.1 e posterior) Se você se conectar a conectores de nuvem, poderá adicionar suas credenciais diretamente da caixa de diálogo Publicar fluxo para inserí-las ao fluxo. 1. Clique em Editar na seção Conexões ou clique em Editar credenciais na mensagem de aviso. Em seguida, clique em Adicionar credenciais no menu suspenso Autenticação. ![A caixa de diálogo Publicar fluxo no Tableau Server mostrando a caixa de diálogo Conexões com a opção Adicionar credenciais.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred2.png) 2. Na caixa de diálogo de confirmação, clique em Continuar. O Tableau Prep Builder abre automaticamente a página Configurações de conta do servidor ao qual você está conectado. ![A caixa de diálogo Adicionar credenciais à sua conta.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred3.png) 3. Adicione suas credenciais e, em seguida, navegue de volta para o Tableau Prep Builder. ![A guia Configurações da conta no servidor mostra uma lista de fontes de dados e botões para adicionar suas credenciais.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred4.png) 4. Na caixa de diálogo Terminar de adicionar credenciais, clique em Concluído. ![A caixa de diálogo Concluir a adição de credenciais com um botão Concluído.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred5.png) 5. Clique em Editar na seção Conexões e verifique se as credenciais foram adicionadas e incorporadas ao fluxo. ![A caixa de diálogo Publicar fluxo no Tableau Server mostrando a caixa de diálogo Conexões com credenciais recém-adicionadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred6.png) 1. Na caixa de diálogo Publicar no Tableau Cloud, preencha os seguintes campos: - **Projeto:** clique na opção suspensa para selecionar o projeto na hierarquia. Esse deve ser o mesmo projeto no qual os arquivos de saída estão publicados. - **Nome:** digite um nome para o fluxo. Esse nome é exibido no servidor, nas páginas de Fluxo. Se quiser substituir um fluxo existente, clique na opção suspensa para selecionar um nome na lista. - **Descrição (opcional):** insira uma descrição para o fluxo. - **Marcas (opcional):** clique em Adicionar para digitar em uma ou mais marcas, a fim de identificar seu fluxo para que os usuários possam localizá-lo facilmente. Marcas também podem ser adicionadas após a publicação nas páginas de Fluxo no Tableau Server. 2. Clique em Editar na seção Conexões para editar as configurações de conexões ou alterar a autenticação. ![Um formulário para publicar um fluxo no Tableau Server.](/tableau/current/pt-br/prep/pt-br/Img/prep_serverfiles2.png) #### Arquivos O Tableau Cloud não suporta conexões diretas de arquivos para dados da etapa de entrada e você deve empacotar seus arquivos com o fluxo. Os arquivos empacotados não são atualizados quando o fluxo é executado no Tableau Cloud. Não é possível executar o Tableau Prep Conductor para atualizar fluxos do Tableau Prep que se conectam a arquivos simples por meio do Bridge. Para habilitar atualizações de fluxo bem-sucedidas do Prep Conductor, mova o arquivo simples para um local acessível diretamente pelo Tableau Cloud (Google Drive, Box, Dropbox etc.) **Observação**: o agendamento e a execução de fluxos que incluem parâmetros no caminho do arquivo de entrada não têm suporte no Tableau Cloud porque isso requer uma conexão direta de arquivo. Quando você publica o fluxo, quaisquer parâmetros incluídos nos caminhos de arquivo são alterados para o valor atual (padrão) e o caminho do arquivo torna-se estático. Como alternativa, você pode executar fluxos com parâmetros no caminho do arquivo no Tableau Prep Builder ou usando a linha de comando. Para obter mais informações sobre como usar parâmetros em fluxos, consulte [Aplicar parâmetros às etapas de entrada](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm#parameters_input_steps). #### Bancos de dados Para manter os dados atualizados ao publicar fluxos no Tableau Cloud, é possível se conectar diretamente apenas a fontes de dados hospedadas na nuvem. Para obter mais informações sobre conexões diretas com suporte do Tableau Cloud, consulte [Permitir conexões diretas com dados hospedados em uma plataforma de nuvem](https://help.tableau.com/current/online/pt-br/to_connect_live_sql.htm). Se você se conectar a fontes de dados locais, a partir da versão 2025.1, poderá usar um cliente do Tableau Bridge para se conectar e atualizar seus dados no Tableau Cloud. Para usar o cliente do Tableau Bridge: - O cliente do Tableau Bridge deve ser configurado para usar um pool de clientes do Bridge (não o pool padrão) - Um ou mais clientes de ponte conectados devem ser incluídos no pool e os clientes devem estar ativos - O domínio deve ser especificado através do Lista de permissões de rede privada e configurado para fazer parte do pool. ![Configurações do site do Tableau Bridge mostrando a configuração do pool do Bridge.](/tableau/current/pt-br/prep/pt-br/Img/prep_bridge_setting.png) Para obter mais informações, consulte [Configurar o pool do cliente do Bridge](https://help.tableau.com/current/online/pt-br/to_enable_bridge_live_connections.htm) na ajuda do Tableau Cloud. **Observação**: Ao conectar-se a fontes de dados locais em versões anteriores do Tableau Prep, você deve primeiro converter as fontes de dados em uma fonte de dados publicada e o Tableau Cloud pode usar um cliente do Tableau Bridge para se conectar aos dados, se o Tableau Bridge estiver configurado para a fonte de dados. Para obter mais informações sobre como usar um Tableau Bridge, consulte [Permitir que os publicadores mantenham conexões em tempo real para dados locais](https://help.tableau.com/current/online/pt-br/to_enable_bridge_live_connections.htm#clientsummary). Se o fluxo se conectar a uma fonte de dados baseada em nuvem que ofereça suporte a uma conexão direta, selecione um dos seguintes tipos de autenticação para se conectar às fontes de dados de entrada de fluxo. - **Prompt de usuário:** você deve editar a conexão no Tableau Cloud e inserir as credenciais do banco de dados antes de executar o fluxo. - **Senha inserida:** as credenciais usadas para se conectar aos dados serão salvas com a conexão e usadas quando o fluxo é executado em uma agenda. Se você abrir o fluxo para editá-lo, precisará inserir novamente suas credenciais. ![A caixa de diálogo Fluxo de publicação no Tableau Online com configurações de conexão.](/tableau/current/pt-br/prep/pt-br/Img/prep_publishdatasource_online.png) - Se você não estiver usando um cliente do Tableau Bridge para se conectar à sua fonte de dados local, selecione o botão de opção Publicar fonte de dados. A seleção desta opção converte a conexão de entrada da fonte de dados em uma fonte de dados publicada quando você publica o fluxo no Tableau Cloud. Se o Tableau Bridge estiver configurado para a fonte de dados e ela for compatível com Tableau Cloud, os dados poderão ser atualizados quando o fluxo for executado. Consulte [Permitir conexões diretas a dados hospedados em uma plataforma de nuvem](https://help.tableau.com/current/online/pt-br/to_connect_live_sql.htm) para obter mais informações. - Para substituir as conexões de fonte de dados no local para o fluxo no Tableau Prep Builder pela fonte de dados publicada, selecione Atualizar entradas de fluxo para usar fontes de dados publicadas na seção Mais opções antes de publicar o fluxo. Se você não marcar a caixa de seleção, o fluxo no Tableau Prep Builder permanecerá conectado à fonte de dados local e o fluxo no Tableau Prep Builder poderá ficar fora de sincronia com a versão publicada do fluxo. Para continuar trabalhando com o fluxo, é necessário baixá-lo do Tableau Cloud para editá-lo e, em seguida, republicá-lo. ![A caixa de diálogo Publicar fluxo no Tableau Online com a caixa de seleção Atualizar entradas de fluxo para usar fontes de dados publicadas destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_conductor_publish_online4.png) **Adicionar credenciais** (versão 2020.1.1 e posterior) Se você se conectar a conectores de nuvem, poderá adicionar suas credenciais diretamente da caixa de diálogo Publicar fluxo para inserí-las ao fluxo. 1. Clique em Editar na seção Conexões ou clique em Editar credenciais na mensagem de aviso. Em seguida, clique em Adicionar credenciais no menu suspenso Autenticação. ![A caixa de diálogo Publicar fluxo no Tableau Online mostrando a caixa de diálogo Conexões com a opção Adicionar credenciais.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_Online_cred2.png) 2. Na caixa de diálogo de confirmação, clique em Continuar. O Tableau Prep Builder abre automaticamente a página Configurações de conta do servidor ao qual você está conectado. ![A caixa de diálogo Adicionar credenciais à sua conta.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred3.png) 3. Adicione suas credenciais e, em seguida, navegue de volta para o Tableau Prep Builder. ![A guia Configurações da conta no servidor mostra uma lista de fontes de dados e botões para adicionar suas credenciais.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred4_254.png) 4. Na caixa de diálogo Terminar de adicionar credenciais, clique em Concluído. ![A caixa de diálogo Concluir a adição de credenciais com um botão Concluído.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_cred5.png) 5. Clique em Editar na seção Conexões e verifique se as credenciais foram adicionadas e incorporadas ao fluxo. ![A caixa de diálogo Publicar fluxo no Tableau Online mostrando a caixa de diálogo Conexões com credenciais recém-adicionadas.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_cloud_Online_cred6.png) ### Quem pode fazer isso - Administrador do servidor, Creator (administrador de site) e Creator (Criador) têm acesso total de conexão e publicação. - O Creator pode realizar as tarefas de criação na Web. - Explorer (pode publicar) [Pular para o conteúdo principal](#main-content) # Referência da linha de comando do Tableau Prep Você pode interagir com o Tableau Prep usando a linha de comando por meio do aplicativo principal (Tableau Prep.exe) ou da interface de linha de comando (tableau-prep-cli.bat). - Tableau Prep.exe: usado para configurar como o aplicativo se inicializa. Por exemplo; instalar, ativar, licenciar, configurar diretórios de dados do usuário ou solucionar problemas do Electron shell. - Tableau-prep-cli.bat: usado para executar fluxos. Por exemplo, passar credenciais, parâmetros e atualizar saídas de dados sem abrir a interface visual. Este documento descreve todas as opções de sintaxe de linha de comando suportadas pelo Tableau Prep e disponíveis para os clientes, separadas pelo utilitário onde estão disponíveis. A sintaxe de linha de comando adicional com suporte usada por desenvolvedores e o suporte do Tableau não está incluída neste documento. ## Aplicativo do Tableau Prep As seguintes ações podem ser executadas na linha de comando do aplicativo Tableau Prep.exe. ### Instale Instale o Tableau Prep executando o arquivo .exe do instalador a partir da linha de comando do computador como administrador. Para obter mais informações, ccconsulte [Instalar a partir da linha de comando](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm). **Nota:** esta opção está disponível apenas para o Windows.
SintaxeDescrição
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

Execute o comando como administrador a partir do diretório onde o arquivo .exe está localizado ou especifique o caminho completo para a localização do arquivo .exe no computador. Não execute a partir de um diretório compartilhado. Para obter uma lista das opções do instalador suportadas, consulte Opções do instalador. Para obter uma lista das propriedades do instalador suportadas, consulte Propriedades do instalador.

  • tableau_<product_installer_name>.exe é o instalador do Tableau para o produto e a versão que você está instalando.

  • option1, option2 etc é como você deseja que o processo de instalação seja executado.

  • PROPERTY1, PROPERTY2 etc especifica as configurações que o instalador deve fazer durante o processo de instalação.

Exemplo:

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

Este comando instala o Tableau versão 2026.2 no modo silencioso (não exibe prompts, IU ou a caixa de diálogo de licença). Ele conclui a instalação sem uma reinicialização, aceita o contrato de licença do usuário final (EULA) e define os relatórios de erros e relatórios de uso como desativados.

### Ativação, licença e registro Use esses comandos para verificar sua licença, ativar o produto durante ou após a instalação e registrar o produto. Para obter mais informações, consulte [Ativar o Tableau Desktop e o Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm#activate-tableau-desktop-and-tableau-prep-builder).
SintaxeDescrição
--activate <key>

Ative o produto usando a chave do produto fornecida. Sai com o código 0 em caso de sucesso. Caso contrário, sai com um código de erro. Também aceita single-dash (-activate).

Para ativar o produto durante a instalação adicione uma única linha de comando que inclua a opção do instalador ACTIVATE_KEY “<key>” e insira a chave do produto entre aspas.

--register

Registre o produto. Também aceita single-dash (-register). Para registrar o Tableau usando a linha de comando, é necessário preencher previamente os valores de registro (Windows) ou .plist (Mac) em cada computador que executará o Tableau Prep Builder.

No Windows, você pode registrar o produto durante a instalação adicionando uma única linha de comando que inclui a opção REGISTER=“1” do instalador.

Para obter mais informações, consulte Registre o Tableau Desktop e o Tableau Prep Builder.

--check-license Exibe a interface de usuário de ativação, se não licenciado.
--refresh

Atualiza as licenças com a data de validade do período de manutenção vigente e interrompe as mensagens de expiração. Sai com o código 0 em caso de sucesso. Também aceita single-dash (-refresh).

Windows: execute o arquivo tableau.exe com a opção --refresh e uma chave de produto.

MacOS: Execute a opção -refresh no objeto do Tableau no caminho /Applications.

--return <key>

Desative a chave do produto fornecida para que possa ser reutilizada. Também aceita single-dash (-return).

Windows: execute o arquivo tableau.exe com a opção -return e uma chave de produto.

MacOS: Execute a opção -return no objeto do Tableau no caminho /Applications.

### Configuração e armazenamento Use esses comandos para definir as configurações de arquivos e locais de repositório.
SintaxeDescrição
--settings-file <file location>

Carregue as definições de configuração do aplicativo a partir do arquivo fornecido. Pode ser especificado várias vezes para dar suporte a configurações em camadas, como quando você tem uma configuração global do servidor proxy usada por todos e uma configuração de banco de dados específica usada para um fluxo.

Exemplo de arquivo. json:

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

Comando de exemplo:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

--repository-location <file path>

Defina o diretório do repositório. Por padrão, durante a instalação, o Tableau Prep cria uma pasta na pasta Documentos chamada Meu repositório do Tableau Prep. Essa pasta inclui pastas para fluxos, fontes de dados, conexões, bem como arquivos de registro e um cache temporário. Em ambientes de servidor ou automação, você pode usar este comando para especificar um local de repositório alternativo e apontar o fluxo executado para ele.

Exemplo:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

--user-data-directory <location>

Diretório usado para armazenar dados do aplicativo Electron.

Enquanto --repository-location gerencia os ativos da empresa (logs e dados), --user-data-directory gerencia o mecanismo interno do aplicativo.

Como administrador, use este sinalizador se estiver executando o Tableau Prep Builder em um ambiente de alta simultaneidade, onde vários processos precisam de estados de aplicativo isolados, ou ao solucionar erros persistentes de bloqueio de sessão em um servidor sem cabeça.

Observação: quando você executa o comando, ele cria automaticamente a pasta especificada em --user-data-directory. No entanto, a conta de usuário que executa o script deve ter permissões de “gravação” para esse diretório pai.

Exemplo:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

### Abrir arquivos Use esses comandos para abrir arquivos .tfl e .tflx de fluxo do Tableau Prep.
SintaxeDescrição
--tfl<file>

Abra o arquivo de fluxo de .tfl especificado. Use aspas duplas se o caminho do arquivo incluir espaços.

Exemplo:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl “/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl”

--tflx<file>

Abra o arquivo de fluxo .tflx empacotado especificado.

Exemplo:

Windows:"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

## Aplicativo de linha de comando do Tableau Prep Os comandos a seguir podem ser executados usando a interface de linha de comandos (tableau-prep-cli.bat) do Tableau Prep. ### Atualizar saída de fluxo Use essas opções para executar o fluxo via linha de comando para atualizar a saída de fluxo. Esse método permite executar apenas um fluxo de cada vez. Para obter mais informações e limitações, consulte [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm).
SintaxeDescrição
-c, --connections <path>

O caminho para o arquivo de .json que contém as credenciais para suas fontes de dados e servidores.

O Tableau Prep Builder usa informações do arquivo de fluxo e do arquivo .json de credenciais para executar o fluxo quando você tiver conexões remotas. Para obter mais informações, consulte Requisitos do arquivo Credentials.json.

Se você se conectar a um banco de dados snowflake, certifique-se de incluir quaisquer parâmetros específicos, como Role, Warehouse e, às vezes, tokens OAuth ou autenticação de navegador externo.

Exemplo de arquivo de configurações .json - Snowflake:

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						

Exemplo:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

- p, - - parameters

O caminho para um arquivo .json que substitui os valores de parâmetro padrão em seu fluxo. Este é um arquivo separado do arquivo credentials.json e inclui os nomes e valores dos seus parâmetros.

Para obter mais informações, consulte “Executar fluxos que incluem valores de parâmetros” em Requisitos do arquivo Credentials.json.

Exemplo:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

-t,--tflFile <file path>O caminho para o arquivo de fluxo do Tableau Prep.
-inc, --incrementalRefresh

Se você não tiver o Tableau Prep Conductor habilitado em seu servidor para agendar execuções de fluxo, poderá usar este comando para executar seu fluxo usando atualização incremental. Para obter mais informações, consulte Executar o fluxo com a atualização incremental ativada.

Exemplo:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

### Comandos diversos Use esses comandos para imprimir a versão do Tableau Prep, ative o modo de depuração para depurar um processo de fluxo, desabilite a validação de SSL e muito mais.
SintaxeDescrição
--versionProduz a versão atual da CLI do Tableau Prep Builder e encerra imediatamente o processo.
-d, --debug

Ativa o modo de depuração. Gera logs detalhados na pasta do repositório para solução de problemas. Os arquivos de registro estão armazenados em: My Tableau Prep Builder Repository\Command Line Repository\Logs

Exemplo:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

-dsv, --disableSslValidation

Desabilita a validação de certificado SSL (útil para determinados ambientes de servidor interno). Ao executar esta opção no MacOS, uma caixa de diálogo pode ser exibida solicitando o usuário e a senha do keychain.

A partir da versão 2019.3.2 do Tableau Prep Builder, você pode passar esse parâmetro adicional para desabilitar essa caixa de diálogo de chaves.

Exemplo:

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

-h, --help

Exibe o menu de ajuda para as opções da linha de comando.

[Pular para o conteúdo principal](#main-content) # Referência de funções do Tableau Prep As funções de cálculo do Tableau Prep permitem usar campos calculados para criar novos dados usando dados que já existem na sua fonte de dados. ### Funções de número
SintaxeDescrição
ABS(number)Retorna o valor absoluto do número especificado.

Exemplos:

ABS(-7) = 7

ABS([Budget Variance])

Retorna o valor absoluto para todos os números contidos no campo Variação de orçamento.
ACOS(number)Retorna o arco cosseno do número especificado. O resultado é em radianos.

Exemplo:

ACOS(-1) = 3.14159265358979

ASIN(number)Retorna o arco seno de um número especificado. O resultado é em radianos.

Exemplo:

ASIN(1) = 1.5707963267949

ATAN(number)Retorna o arco tangente de um número especificado. O resultado é em radianos.

Exemplo:

ATAN(180) = 1.5652408283942

ATAN2(y number, x number)Retorna o arco tangente de dois números especificados (x e y). O resultado é em radianos.

Exemplo:

ATAN2(2, 1) = 1.10714871779409

CEILING(number)Arredonda um número para o inteiro mais próximo de valor maior ou igual.

Exemplo:

CEILING(3.1415) = 4

COS(number)Retorna o cosseno de um ângulo. Especifica o ângulo em radianos.

Exemplo:

COS(PI( ) /4) = 0.707106781186548

COT(angle)Retorna a cotangente de um ângulo. Especifica o ângulo em radianos.

Exemplo:

COT(PI( ) /4) = 1

DIV(integer1, integer2)Retorna a parte inteira de uma operação de divisão, na qual o integer1 é dividido pelo integer2.

Exemplo:

DIV(11,2) = 5

EXP(number)Retorna e elevado à potência do número especificado.

Exemplos:

EXP(2) = 7.389 EXP(-[Growth Rate]*[Time])

FLOOR(number)Arredonda um número para o inteiro mais próximo de valor menor ou igual.

Exemplo:

FLOOR(3.1415) = 3

HEXBINX(number, number)Mapeia as coordenadas x, y com a coordenada x do compartimento hexagonal mais próximo. Os compartimentos têm extensão 1, então as entradas podem precisar ser escalonadas corretamente.

Exemplo:

HEXBINX([Longitude], [Latitude])

HEXBINY(number, number)Mapeia as coordenadas x, y com a coordenada y do compartimento hexagonal mais próximo. Os compartimentos têm extensão 1, então as entradas podem precisar ser escalonadas corretamente.

Exemplo:

HEXBINY([Longitude], [Latitude])

LN(number)

Retorna o algoritmo natural de um número. Retorna Null se o número for menor que ou igual a 0.

Exemplo:

LN(EXP(5)) = 5

LOG(number [, base])

Retorna o algoritmo de um número para a base especificada. Se o valor de base for omitido, a base 10 será usada.

Exemplo:

LOG(256, 2) = 8

MAX(number, number)Retorna o máximo de dois argumentos, que devem ser do mesmo tipo. Retorna Null se algum argumento for Null. MAX também pode ser aplicada a um único campo em um cálculo agregado.

Exemplos:

MAX(4,7)
MAX(Sales,Profit)
MAX([First Name],[Last Name])

MIN(number, number)Retorna o mínimo de dois argumentos, que devem ser do mesmo tipo. Retorna Null se algum argumento for Null. MIN também pode ser aplicada a um único campo em um cálculo agregado.

Exemplos:

MIN(4,7)

MIN(Sales,Profit)

MIN([First Name],[Last Name])

PI( )

Retorna o pi da constante numérica: 3.14159.

Exemplo:

PI() = 3.14159265358979

POWER(number, power)Eleva o número à potência especificada.

Exemplos:

POWER(5,2) = 52 = 25 POWER(Temperature, 2)

Também é possível usar o símbolo ^:

5^2 = POWER(5,2) = 25

RADIANS(number)Converte o número especificado de graus em radianos.

Exemplo:

RADIANS(180) = 3.14159

ROUND(number, [decimals])Arredonda os números para um número de dígitos especificado. O argumento de decimais especifica quantos pontos decimais de precisão são necessários incluir no resultado final. Se os decimais forem omitidos, o número será arredondado para o inteiro mais próximo.

Exemplo:

Este exemplo arredonda cada valor de Vendas para um número inteiro:

ROUND(Sales)

SIGN(number)Retorna o sinal de um número: os valores de retorno possíveis são: -1 se o número for negativo, 0 se o número for zero ou 1 se o número for positivo.

Exemplo:

Se a média do campo de lucro for negativa,

SIGN(AVG(Profit)) = -1

SIN(number)Retorna o seno de um ângulo. Especifica o ângulo em radianos.

Exemplos:

SIN(0) = 1.0

SIN(PI( )/4) = 0.707106781186548

SQRT(number)Retorna a raiz quadrada de um número.

Exemplo:

SQRT(25) = 5

SQUARE(number)Retorna o quadrado de um número.

Exemplo:

SQUARE(5) = 25

TAN(number)

Retorna a tangente de um ângulo. Especifica o ângulo em radianos.

Exemplo:

TAN(PI ( )/4) = 1.0

ZN(expression)

Retorna a expressão se não for nulo, caso contrário, retorna zero. Use essa função para utilizar valores de zero, em vez de valores nulos.

Exemplo:

ZN([Profit]) = [Profit]

### Funções de cadeia de caracteres
SintaxeDescrição
ASCII(string)Retorna o código ASCII do primeiro caractere de uma cadeia de caracteres.

Exemplo:

ASCII('A') = 65

CHAR(number)Retorna o caractere codificado pelo número de código ASCII.

Exemplo:

CHAR(65) = 'A'

CONTAINS(string, substring)Retornará true se a cadeia de caracteres determinada contiver a subcadeia de caracteres especificada.

Exemplo:

CONTAINS(“Calculation”, “alcu”) = true

ENDSWITH(string, substring)Retornará true se a cadeia de caracteres determinada terminar com a substring especificada. Espaços em branco à direita são ignorados.

Exemplo:

ENDSWITH(“Tableau”, “leau”) = true

FIND(string, substring, [start])Retorna a posição de índice de uma substring em uma cadeia de caracteres, ou 0 se a subcadeia de caracteres não for encontrada. Se o argumento de iniciar opcional for adicionado, a função ignora quaisquer instâncias de substring que aparecem antes do início da posição do índice. O primeiro caractere na cadeia de caracteres está na posição 1.

Exemplos:

FIND("Calculation", "alcu") = 2

FINDNTH(string, substring, occurrence)Retorna a posição da nª ocorrência de substring dentro da string especificada, onde n é definido pelo argumento de ocorrência

Exemplo:

FINDNTH("Calculation", "a", 2) =7

ISDATE(string)

Retornará true se uma determinada cadeia de caracteres for uma data válida.

Exemplo:

ISDATE("2004-04-15") = True

LEFT(string, number)Retorna o número de caracteres na extremidade esquerda na cadeia de caracteres.

Exemplo:

LEFT("Matador", 4) = "Mata"

LEN(string)Retorna o comprimento da cadeia de caracteres.

Exemplo:

LEN("Matador") = 7

LOWER(string)Retorna cadeia de caracteres, com todos os caracteres maiúsculos.

Exemplo:

LOWER("ProductVersion") = "productversion"

LTRIM(string)Retorna a cadeia de caracteres com os espaços à esquerda removidos.

Exemplo:

Example: LTRIM(" Sales") = "Sales"

(MID(string, start, [length])Retorna a cadeia de caracteres que começa no início da posição de índice. O primeiro caractere na cadeia de caracteres está na posição 1. Se o comprimento de argumento opcional for adicionado, a cadeia de caracteres retornada incluirá apenas esse número de caracteres.

Exemplos:

MID("Calculation", 2) = "alculation"

MID("Calculation", 2, 5) ="alcul"

PROPER(string)Converte uma cadeia de caracteres de texto para que a primeira letra de cada palavra seja maiúscula e as letras restantes fiquem em minúsculas. Espaços e caracteres não alfanuméricos, como pontuação, também atuam como separadores.

Exemplo:

PROPER("PRODUCT name") = "Product Name"

REGEXP_EXTRACT(string, pattern)Retorna uma subcadeia de caracteres da cadeia de caracteres fornecida que corresponde ao grupo de captura dentro do padrão de expressão regular. O padrão de expressão regular requer exatamente um grupo de captura

Exemplo:

REGEXP_EXTRACT('abc 123', '[a-z]+\\s+(\\d+)') = '123'

REGEXP_EXTRACT_NTH(string, pattern, index)Retorna uma subcadeia de caracteres da cadeia de caracteres fornecida usando o padrão de expressão regular. A subcadeia é comparada com o grupo de captura nth, onde n é o índice dado.

Exemplo:

REGEXP_EXTRACT_NTH('abc 123', '([a-z]+)\\s+(\\d+)', 2) = '123'

REGEXP_MATCH(string, pattern)Retorna true se uma subcadeia de caracteres de uma cadeia de caracteres fornecida corresponder ao padrão de expressão regular.

Exemplo:

REGEXP_MATCH('-([1234].[ The.Market ])-', '\\[\\s*(\\w*\\.)(\\w*\\s*\\])') = true

REGEXP_REPLACE(string, pattern, replacement)Retorna uma cópia da cadeia de caracteres fornecida onde o padrão correspondente é substituído pela cadeia de caracteres de substituição.

Exemplo:

REGEXP_REPLACE('abc 123', '\\s', '-') = 'abc--123'

REPLACE(string, substring, replacement)Procura uma cadeia de caracteres para uma subcadeia de caracteres e substitui. Se a subcadeia de caracteres não for encontrada, a string não será alterada.

Exemplo:

REPLACE("Calculation", "ion", "ed") = "Calculated"

RIGHT(string, number)Retorna o número de caracteres na extremidade direita na cadeia de caracteres.

Exemplo:

RIGHT("Calculation", 4) = "tion"

RTRIM(string)Retorna cadeia de caracteres com os espaços à direita removidos.

Exemplo:

Example: RTRIM("Market ") = "Market"

SPACE(number)Retorna uma cadeia de caracteres composta por um número especificado de espaços repetidos.

Exemplo:

SPACE(1) = " "

SPLIT(string, delimiter, token number)

Retorna uma subcadeia de caracteres de uma cadeia de caracteres, conforme determinado por um delimitador que extrai os caracteres do início ou do fim da cadeia de caracteres.

Exemplo:

SPLIT('a-b-c-d', '-', 2) = 'b'

STARTSWITH(string, substring)Retorna true se a cadeia de caracteres começa com substring. Espaços em branco à esquerda são ignorados.

Exemplo:

STARTSWITH(“Joker”, “Jo”) = true

TRIM(string)Retorna a cadeia de caracteres com os espaços à esquerda e à direita removidos.

Exemplo:

TRIM(" Calculation ") = "Calculation"

UPPER(string)Retorna string, com todos os caracteres maiúsculos.

Exemplo:

UPPER("Calculation") = "CALCULATION"

### Funções de agregação
SintaxeDescrição
AVG(expression)Retorna a média de todos os valores na expressão. AVG pode ser usada com campos numéricos apenas. Os valores nulos são ignorados

Exemplo;

AVG([Profit])

COUNT(expression)Retorna o número de itens em um grupo. Os valores Null não são contados.

Exemplo:

COUNT([Customer ID])

COUNTD(expression)Retorna o número de itens distintos em um grupo. Os valores NULL não são contados. Cada valor exclusivo é contado apenas uma vez.

Exemplo:

COUNTD([Region])

MEDIAN(expression)Retorna a mediana de uma única expressão. MEDIAN pode ser usada com campos numéricos apenas. Os valores nulos são ignorados.

Exemplo:

MEDIAN([Profit])

PERCENTILE(expression, number)Cálculo agregado que retorna o valor percentil da expressão fornecida correspondente ao número especificado. Os valores válidos para o número são de 0 a 1. PERCENTILE([expression], 0,50) sempre retornará o valor mediano na expressão.

Exemplo:

PERCENTILE([Sales], 0.90)

STDEV(expression)Retorna o desvio padrão de exemplo da expressão.

Exemplo:

STDEV([Profit])

STDEVP(expression)

Retorna o desvio padrão de exemplo da expressão na janela.

Exemplo:

STDEVP([Profit])

SUM(expression)

Retorna a soma de todos os valores na expressão. SUM pode ser usada com campos numéricos apenas. Os valores nulos são ignorados.

Exemplo:

SUM([Profit])

VAR(expression)

Retorna a variação estatística de todos os valores na expressão atribuída com base em uma amostra da população.

Exemplo:

VAR([Height])

VARP(expression)

Retorna a variação estatística de todos os valores na expressão atribuída com base na população inteira.

Exemplo:

VARP([Test Score])

ZN(expression)

Retorna a expressão se não for nulo, caso contrário, retorna zero. Use essa função para utilizar valores de zero, em vez de valores nulos.

Exemplo:

ZN([Profit]) = [Profit]

### Funções de conversão de tipo
SintaxeDescrição
DATERetorna uma data de acordo com um número, cadeia de caracteres ou expressão de data.

Exemplo:

DATE("2006-06-15 14:52") = 2006-06-15

Observe que as aspas são obrigatórias.

DATETIME(expression)Retorna uma datetime de acordo com um número, cadeia de caracteres ou expressão de data.

Exemplo:

DATETIME("April 15, 2004 07:59:00")

Observe que as aspas são obrigatórias.

FLOAT(expression)Retorna um flutuante dada uma expressão de qualquer tipo. Essa função requer números não formatados, o que significa excluir vírgulas e outros símbolos.

Exemplo:

FLOAT("3")= 3.000

INT(expression)Retorna um número inteiro dada uma expressão. Essa função trunca os resultados para o inteiro mais próximo de zero.

Exemplo:

INT(8.0/3.0) = 2 or INT(-9.7) = -9

MAKEDATE(year, month, day)Retorna um valor de data composto por um ano mês e um dia do mês.

Exemplo:

MAKEDATE(2014, 3, 18)

MAKEDATETIME(date, time)

Retorna um valor de data e hora de acordo com uma expressão de data e uma expressão de hora.

Exemplo:

MAKEDATETIME(#2012-11-12#, #07:59:00#)

MAKETIME(hour, minute, second)

Retorna um valor de hora composto por minutos e segundos.

Exemplo:

MAKETIME(14, 52, 40)

STR(expression)

Retorna uma cadeia de caracteres dada uma expressão.

Exemplo:

STR([Age])

Retorna todos os valores da medida Idade como cadeia de caracteres.

### Funções de data
SintaxeDescrição
DATEADD(date_part, interval, date)Adiciona um incremento à data especificada e retorna a nova data. O incremento é definido pelo intervalo e pela data_parte.

Exemplo:

DATEADD('month', 3, #2004-04-15#) = 2004-07-15 12:00:00 AM

DATEDIFF(date_part, start_date, end_date, [start_of_week])

Retorna a diferença entre duas datas onde data_inicial é subtraída de data_final. A diferença é expressa em unidades de date_part. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados.

Exemplo:

DATEDIFF('month', #2004-07-15#, #2004-04-03#, 'sunday') = -3

DATENAME(date_part, date, [start_of_week])Retorna uma parte da data fornecida como uma cadeia de caracteres, onde a parte é definida por date_part. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados.

Exemplo:

DATENAME('month', #2004-04-15#) = "April"

DATEPARSE(format, string)Converte uma cadeia de caracteres em uma data no formato especificado.

Exemplo:

DATEPARSE ("dd.MMMM.yyyy", "15.April.2004") = 2004-04-15 12:00:00 AM

DATEPARTT(date_part, date, [start_of_week])Retorna uma parte da data fornecida como um inteiro onde a parte é definida por date_part. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados.

Exemplo:

DATEPART('month', #2004-04-15#) = 4

DATETRUNC(date_part, date, [start_of_week])Trunca a data especificada na precisão definida por date_part e retorna a nova data. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados.

Exemplo:

DATETRUNC('quarter', #2004-08-15#) = 2004-07-01 12:00:00 AM

DAY(date)Retorna o dia da data especificada como um inteiro.

Exemplo:

DAY(#2004-04-12#) = 12

ISDATE(string)Retornará true se uma determinada cadeia de caracteres for uma data válida.

Exemplo:

ISDATE("2004-04-15") = True

MONTH(date)

Retorna o mês da data especificada como um inteiro.

Exemplo:

MONTH(#2004-04-12#) = 4

NOW()Retorna a data e a hora atuais.

Exemplo:

NOW() = 2004-05-12 1:08:21 PM

TODAY()Retorna a data atual.

Exemplo:

TODAY() = 2004-05-12

YEAR(date)Retorna o ano da data especificada como um inteiro.

Exemplo:

YEAR(#2004-04-12#) = 2004

### Funções lógicas
SintaxeDescrição
IFNULL(expr1, expr2)Retorna <expr1> se for não nulo, caso contrário, retorna <expr2>.

Exemplo:

IFNULL([Profit], 0)

IIF(test, then, else, [unknown])Verifica se uma condição é atendida e retorna um valor se VERDADEIRA, outro valor se FALSA e um terceiro valor opcional ou NULO se desconhecida.

Exemplo:

IIF([Profit] > 0, 'Profit', 'Loss')

ISDATE(string)Retornará true se uma determinada cadeia de caracteres for uma data válida.

Exemplo:

ISDATE("2004-04-15") = True

ISNULL(expression)Retorna true se a expressão não contiver dados válidos (Null).

Exemplo:

ISNULL([Profit])

ZN(expression)

Retorna a expressão se não for nulo, caso contrário, retorna zero. Use essa função para utilizar valores de zero, em vez de valores nulos.

Exemplo:

ZN([Profit]) = [Profit]

### Funções analíticas
SintaxeDescrição
LAST_VALUE(expression, [return_last_non-null_value])Retorna o último valor da expressão especificada a partir da primeira linha na partição para a linha atual. Aceita um segundo parâmetro booliano opcional para retornar o último valor não nulo.

Exemplo:

{ ORDERBY [Row ID] ASC: LAST_VALUE([Category], true) } = returns the last non-null value of [Category]

LOOKUP(expression, [offset])

Retorna o valor da expressão especificada em uma linha de destino, especificada como uma compensação relativa da linha atual. Retornará NULL se a linha de destino não puder ser determinada.

O parâmetro [offset] da função LOOKUP só pode receber um número inteiro literal, como 1.

Exemplo:

{ORDERBY [DATE] ASC : LOOKUP([SALES], -1)}

Retorna o valor SALES da linha anterior.

NTILE(number)Distribui linhas em uma partição selecionada em um número especificado de grupos ou blocos. Com esta função o conjunto de valores (6,9,9,14) distribuídos por 3 peças seria atribuído às peças (1,2,2,3) em ordem crescente.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales] ASC: NTILE(3) }}

RANK()Retorna a posição na classificação da concorrência padrão para a linha atual da partição. Valores idênticos são colocados em uma posição na classificação idêntica.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK() }}

RANK_DENSE()Retorna a posição na classificação densa para a linha atual na partição. Para valores idênticos, são atribuídos uma mesma posição na classificação, mas nenhuma lacuna é inserida na sequência numérica.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK_DENSE() }}

RANK_MODIFIED()Retorna a posição na classificação da concorrência modificada para a linha atual na partição. Valores idênticos são colocados em uma posição na classificação idêntica.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK_MODIFIED() }}

RANK_PERCENTILE()Retorna a posição na classificação percentil para a linha atual na partição.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK_PERCENTILE() }}

ROW_NUMBER()Retorna uma ID de linha sequencial exclusivo para cada linha.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales] ASC: ROW_NUMBER() }}

RUNNING_AVG(expression)Retorna a média em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

Exemplo:

{ PARTITION [Category] : { ORDERBY [Row ID] ASC : RUNNING_AVG([Sales]) } } = running average of Sales, per Category.

RUNNING_SUM(expression)Retorna a soma em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

Exemplo:

{ ORDERBY [Row ID] ASC : RUNNING_SUM([Sales]) } = running sum of all Sales

### Palavras-chave
FunçãoDescrição
ANDExecuta uma conjunção lógica em duas expressões

Exemplo:

IF (ATTR([Market]) = "New Business" AND SUM([Sales]) > [Emerging Threshold] )THEN "Well Performing"

ASCDefine a ordem crescente para operações ORDERBY .

Exemplo

{ORDERBY [Sales] ASC:RANK()}

CASEEncontra o primeiro <value> que corresponde <expr> e retorna ao <return> correspondente.

Exemplo:

CASE [RomanNumeral] WHEN "|" THEN 1 WHEN "II" THEN 2 ELSE 3 END

DESCDefine a ordem decrescente para operações ORDERBY .

Exemplo:

{ORDERBY [Sales] DESC:RANK()}

ELSETesta uma série de expressões retornando o valor <then> para o primeiro <expr> true.

Exemplo:

IF [Profit] > 0 THEN 'Profitable' ELSE 'Loss' END

ELSEIFTesta uma série de expressões retornando o valor <then> para o primeiro <expr> true. Equivale a colocar uma instrução if dentro de uma operação ELSE.

Exemplo:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

ENDEncerra uma operação introduzida pela diretiva correspondente.

Exemplo:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

{ FIXED }As expressões de nível de detalhe FIXED calculam valores usando as dimensões especificadas sem referência ao nível de detalhe da visualização.

Exemplo:

{FIXED[Customer ID]:MIN([Order Date])}

IFCriar declaração condicional (instruções IF) e permite que você execute somente se uma condição for True.

Exemplo:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

NOTExecuta uma negação lógica em uma expressão.

Exemplo:

IF NOT [Profit] > 0 THEN "Unprofitable" END

ORExecuta uma disjunção lógica em uma expressão.

Exemplo:

IF [Profit] < 0 OR [Profit] = 0 THEN "Needs Improvement" END

{ ORDERBY }Define a ordem de aplicação das funções analíticas. Use o argumento asc | desc opcional para especificar a ordem crescente ou decrescente para cada campo.

Exemplo:

{ORDERBY [Customer Name] ASC, [Sales] DESC: RANK() }

{ PARTITION }Define o grupo para funções analíticas. ORDERBY deve estar dentro da partição.

Exemplo:

{PARTITION [Customer]: {ORDERBY [Sales]: RANK()}}

THENTesta uma série de expressões retornando o valor <then> para o primeiro <expr> true.

Exemplo:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Break even' ELSE 'unprofitable' END

WHENEncontra o primeiro <value> que corresponde expr> e retorna ao <return> correspondente.

Exemplo:

CASE [RomanNumberal] WHEN 'I' THEN 1 WHEN 'II' THEN 2 ELSE 3 END

[Pular para o conteúdo principal](#main-content) # Remover linhas em duplicado _Compatível com o Tableau Prep Builder versão 2024.1 e posterior, Tableau Server versão 2024.2 e posterior e na Web no Tableau Cloud._ Dados duplicados podem afetar a qualidade dos dados, distorcer os resultados da previsão e desperdiçar espaço de armazenamento. A remoção de duplicatas garante que cada valor seja único, fornecendo uma representação precisa dos seus dados. A primeira etapa para remover duplicatas é identificar as linhas duplicadas em seus dados. Depois de identificar duplicatas, você poderá removê-las do fluxo de trabalho. ## Identificar e remover duplicatas O Tableau Prep identifica uma duplicata como qualquer linha que tenha pelo menos uma outra linha com os mesmos valores. Para identificar e remover linhas duplicadas. 1. (Opcional) Para arquivos Excel e de texto, você pode clicar na etapa Entrada e adicionar um campo Número da linha de origem para classificar as linhas pela fonte de dados original. Para obter mais informações, veja [Adicionar o campo Número da linha de origem ao seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm) e [Classificar ordem do campo calculado](#sortOrderDups). 2. Clique em qualquer etapa que não seja uma etapa de entrada ou saída. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_remove_dup_select.png) 4. Identifique linhas duplicadas. - Para identificar linhas duplicadas em todos os campos, na barra de ferramentas, clique em Identificar linhas duplicadas. - Para identificar linhas duplicadas em campos específicos, selecione um ou mais campos e clique em Identificar linhas duplicadas. Opcionalmente, no painel de perfil, você pode clicar no menu Mais opções![](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) do campo selecionado e escolha Identificar linhas duplicadas. Um campo calculado é criado e listado no painel Alterações. O campo calculado fornece uma descrição e os nomes dos campos que as linhas duplicadas abrangem. A grade de dados mostra quais linhas são exclusivas e quais linhas são duplicadas. A imagem a seguir mostra os resultados da seleção dos dois campos _Região_ e _Tipo de item_ para identificar linhas duplicadas apenas nos campos selecionados. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_remove_dup_id.png) Se um número de linha de origem estiver disponível, ele será usado para classificar a ordem das linhas. Caso contrário, as linhas serão classificadas com base no primeiro campo do esquema da tabela. Para alterar os valores no campo calculado, você pode editar diretamente o cálculo ou escrever seu próprio cálculo. Confira [Classificar ordem do campo calculado](#sortOrderDups). 5. Para avaliar linhas duplicadas, clique em Duplicada ou Exclusiva no campo É linha duplicada? ou na grade de dados. A imagem a seguir mostra linhas duplicadas em todos os campos. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_remove_dup_all_rows.png) A imagem a seguir mostra linhas duplicadas apenas nos campos _Região_ e _Tipo de item_. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_remove_dup_limit_rows.png) 10. Para filtrar e manter apenas as linhas exclusivas, clique em Exclusiva na grade de dados ou no campo É linha duplicada? e selecione Manter apenas na barra de ferramentas. Como opção, você pode clicar em Exclusiva na grade de dados ou no campo É linha duplicada? e clicar com o botão direito para selecionar Mantenha apenas. Você também pode selecionar Duplicada e selecionar Excluir para filtrar dados em busca de duplicatas. Isso produz os mesmos resultados que selecionar Exclusiva e Manter somente e não afeta quais linhas são excluídas ou mantidas. Um filtro é criado no painel de alterações mostrando que apenas linhas exclusivas são mantidas e linhas duplicadas são excluídas. ![](/tableau/current/pt-br/prep/pt-br/Img/prep_remove_dup_filter.png) 11. No campo calculado É linha duplicada?, clique no menu Mais opções![](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) e selecione Remover. As linhas duplicadas são removidas quando você executa o fluxo e cria uma saída. **Observação**: não remova o campo calculado É linha duplicada? se você estiver ajustando os dados de amostra. ### Duplicatas em dados de amostra Linhas duplicadas podem não aparecer nos dados amostrados e podem introduzir um viés no modelo. Para tratar dados de amostra de linhas duplicadas: 1. não remova o campo calculado É linha duplicada? se você estiver ajustando os dados de amostra. Isso lhe dá a opção de alterar o tamanho da amostra ou ajustar os dados da amostra na etapa de entrada. 2. Ajuste o tamanho da amostra para carregar o máximo de dados possível para seleção de linha. Consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm) 3. As duplicatas podem não aparecer nos dados de amostra, dependendo do tamanho da amostra. Usando a opção Manter apenas para linhas exclusivas permite remover linhas duplicadas, mesmo que elas não estejam visíveis nos dados de amostra. ### Classificar ordem do campo calculado Por padrão, se várias linhas contiverem o mesmo valor, elas serão classificadas pelo primeiro campo ou, se disponível, pelo número da linha de origem. Os campos são usados para identificar a primeira linha como _Exclusiva_ e as demais como _Duplicada_. Alterar a ordem de classificação dos campos permite especificar qual linha duplicada você deseja identificar como Exclusiva. Você pode fazer alterações no pedido editando o cálculo e alterando o campo `ORDERBY` . Por exemplo: `IF ({PARTITION [Field1], [Field2], [Field3]: { **ORDERBY** [**FieldName**] **ASC**: ROW_NUMBER() } } = 1) THEN 'Unique' ELSE 'Duplicate' END` Para arquivos Excel e de texto, você pode classificar pela fonte de dados original adicionando um campo Número da linha de origem. Por exemplo: `IF ({PARTITION [Source Row Number], [Field1], [Field2], [Field3]: { **ORDERBY** [**Source Row Number**] **DESC**: ROW_NUMBER() } } = 1) THEN 'Unique' ELSE 'Duplicate' END` [Para obter mais informações, consulte Adicionar o campo Número de linha de origem ao seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm). ### Escrever o próprio cálculo de filtro para localizar e remover duplicatas Você pode escrever seu próprio cálculo de filtro em vários campos para localizar e remover duplicatas. O cálculo de filtro a seguir retornará apenas resultados que retornem True. O cálculo retorna True ou False com base nos campos usados para PARTITION `{PARTITION [Field1], [Field2], [Field3]: { ORDERBY [Field1] DESC: ROW_NUMBER() } } = 1` Usar `CASE` ou `IF` para identificar cálculos duplicados Você pode usar as funções `IF` ou `CASE` no editor de cálculo. Por exemplo: `CASE {PARTITION [Field1], [Field2], [Field3] : { ORDERBY [[Field3]]: ROW_NUMBER() } } = 1 WHEN TRUE THEN 'UNIQUE' ELSE 'DUPLICATE' END` `IF ({PARTITION [[Field1]], [[Field2]], [[Field3]]: { ORDERBY [[Field3]] DESC: ROW_NUMBER() } } = 1) THEN 'Unique' ELSE 'Duplicate' END` [Pular para o conteúdo principal](#main-content) # Salvar e compartilhar seu trabalho > [!WARNING] > > A partir de 14 de outubro de 2025, o Data Cloud foi renomeado como Data 360. Durante essa transição, você pode ver referências a Data Cloud em nosso aplicativo e documentação. Embora o nome seja novo, a funcionalidade e o conteúdo permanecem inalterados. Em qualquer ponto do fluxo, você pode salvar o trabalho manualmente ou deixar que o Tableau o faça automaticamente ao criar ou editar fluxos na Web. Existem algumas diferenças quando você trabalha com fluxos na Web. Para obter mais informações sobre os fluxos de criação na Web, consulte **Tableau Prep na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm).
Tableau Prep BuilderTableau Prep na Web
  • Acesse uma visualização dos dados no fluxo no Tableau Desktop.
  • Inclua conexões diretas de arquivos na entrada de fluxo ou empacote os arquivos e publique o fluxo empacotado no servidor.
  • Gere o fluxo para um arquivo, fpnte de dados publicada ou um banco de dados.
  • Crie e edite os fluxos na Web.
  • Carregue os arquivos nas entradas de fluxo e conecte-se a diversas fontes de dados.
  • Gere o fluxo para uma fonte de dados publicada ou um banco de dados.
Para manter os dados atualizados, você pode executar os fluxos manualmente no Tableau Prep Builder ou na linha de comando. Você também pode executar os fluxos publicados no Tableau Server ou no Tableau Cloud manualmente ou de acordo com a agenda. Para obter mais informações sobre a execução de fluxos, consulte [Publicar um fluxo no Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#run_flows). ## Salvar um fluxo No Tableau Prep Builder, você pode salvar o fluxo manualmente para fazer um backup de seu trabalho antes de executar qualquer operação adicional. Seu fluxo está salvo no formato de arquivo de fluxo (.tfl) do Tableau Prep. Além disso, é possível empacotar os arquivos locais (Excel, arquivos de texto e extrações do Tableau) junto com o fluxo para compartilhar com terceiros, da mesma forma que se empacota uma pasta de trabalho para compartilhamento no Tableau Desktop. Apenas arquivos locais podem ser empacotados com um fluxo. Os dados de conexões de banco de dados, por exemplo, não são incluídos. Na criação na Web, os arquivos locais são empacotados automaticamente com o nosso fluxo. As conexões diretas de arquivos ainda não são compatíveis. Ao salvar o fluxo empacotado, ele é salvo como um Arquivo de fluxo empacotado do Tableau (.tflx). - Para salvar seu fluxo manualmente, no menu superior, selecione Arquivo > Salvar. - No Tableau Prep Builder, para empacotar os arquivos de dados com o fluxo, no menu superior, execute uma das ações a seguir: - Selecione Arquivo > Exportar fluxo empacotado - Selecione Arquivo > Salvar como. Em seguida, na caixa de diálogo Salvar como, selecione Arquivos de fluxo empacotados do Tableau no menu suspenso Salvar como tipo. ### Salvar os fluxos automaticamente na Web Se você criar ou editar fluxos na Web, quando você fizer uma alteração no fluxo (conecte-se a uma fonte de dados, adicione uma etapa e assim por diante), o trabalho será salvo automaticamente em um intervalo de poucos segundos como rascunho para que você não o perca. Você só pode salvar os fluxos no servidor em que está conectado no momento. Você não pode criar um fluxo de rascunho em um servidor e tentar salvá-lo ou publicá-lo em outro. Se você quiser publicar o fluxo para um projeto diferente no servidor, use a opção do menu Arquivo > Publicar como e selecione o projeto na caixa de diálogo. Você só pode ver os fluxos de rascunho até publicá-los e disponibilizá-los para qualquer usuário que tenha permissões para acessar o projeto no servidor. Os fluxos no status de rascunho são marcados com o selo Rascunho para que você possa encontrar facilmente os fluxos em andamento. Se o fluxo nunca foi publicado, o selo Nunca publicado será mostrado ao lado do selo Rascunho. ![Uma tabela de fluxos por nome e status, como rascunho ou nunca publicado.](/tableau/current/pt-br/prep/pt-br/Img/prep_save_drafts.png) Após a publicação do fluxo, quando você o edita e publica fluxo novamente, outra versão é criada. Você pode ver uma lista das versões de fluxo na caixa de diálogo Histórico de revisões. Na página Explorar, clique no menu ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) **Ações** e selecione Histórico de revisões. Para obter mais informações sobre o gerenciamento do histórico de revisões, consulte [Trabalhar com revisões de conteúdo](https://help.tableau.com/current/pro/desktop/pt-br/qs_revision_history.htm) na Ajuda do Tableau Desktop. **Observação**: o salvamento automático é ativado por padrão. Os administradores podem desativar o salvamento automático em um site, mas não é recomendado. Desative o salvamento automático, use o método de "Atualizar site" da API REST do Tableau Server e defina o atributo `flowAutoSaveEnabled` como false. Para obter mais informações, consulte [Métodos de site da API REST do Tableau Server: site de atualização](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_sites.htm#update_site). ### Recuperação automática de arquivos Por padrão, o Tableau Prep Builder salvará automaticamente um rascunho dos fluxos abertos se o aplicativo travar ou falhar. Os fluxos de rascunho são salvos na pasta Fluxos recuperados em Meu repositório do Tableau Prep. Da próxima vez que você abrir o aplicativo, uma caixa de diálogo será mostrada com uma lista dos fluxos recuperados para você selecionar. Você poderá abrir um fluxo recuperado e continuar de onde parou ou excluir o arquivo de fluxo recuperado se não precisar dele. **Observação**: se você recuperou fluxos na pasta Fluxos recuperados, esta caixa de diálogo será exibida sempre que você abrir o aplicativo até que a pasta esteja vazia. ![A caixa de diálogo Recuperação de arquivo mostra um único arquivo recuperado chamado "Superstore", modificado pela última vez em 7 de agosto de 2020.](/tableau/current/pt-br/prep/pt-br/Img/prep_filerecovery.png) Se não quiser que esse recurso seja habilitado, como Administrador, você poderá desativá-lo durante ou após a instalação. Para obter mais informações sobre como desativar este recurso, consulte [Desativar recuperação de arquivos](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_setting_changes.htm#turn-off-autosave-tableau-desktop-only) no guia de implantação do Tableau Desktop e do Tableau Prep. ### Recuperar fluxos excluídos _Com suporte na criação na Web do Tableau Prep no Tableau Cloud e no Tableau Server versão 2025.3 e posterior._ Na criação na Web, você pode recuperar fluxos excluídos anteriormente da Lixeira. Se a Lixeira estiver ativada, em vez de serem excluídos permanentemente, os fluxos serão movidos temporariamente para a lixeira, onde você poderá recuperá-los ou excluí-los de forma permanente. Os fluxos em estado de rascunho ainda são excluídos permanentemente. Para obter mais informações a Lixeira, consulte [Lixeira](https://help.tableau.com/current/online/pt-br/recycle_bin.htm). **Observação**: este recurso não está disponível no Tableau Prep Builder. Para utilizar esta funcionalidade, é necessário o seguinte: - **Permissões**: você deve receber a função de Administrador de site, Administrador de servidor, Creator ou Explorer (pode publicar). - **Configuração do site**: a lixeira está ativada para seu site - **Status do fluxo**: o fluxo deve ser publicado. O período de tempo em que os fluxos são armazenados na Lixeira é definido pelo administrador. #### Recuperar um fluxo 1. Na página inicial, expanda o painel lateral e selecione Lixeira. 2. Na página Lixeira, selecione Fluxos na lista suspensa Tipo de conteúdo. ![Página Lixeira, opções de menu suspenso mostrando Fluxos selecionados.](/tableau/current/pt-br/prep/pt-br/Img/prep_recycle_bin_content_type.png) 3. Selecione o menu Mais ações para o fluxo que você deseja restaurar e, em seguida, selecione Restaurar. ![Página da Lixeira mostrando o menu Mais ações do fluxo para restaurar um fluxo excluído.](/tableau/current/pt-br/prep/pt-br/Img/prep_recycle_bin_restore_menu.png) 4. Selecione um projeto como local de restauração. ![Caixa de diálogo Restaurar em que você seleciona um projeto para restaurar o fluxo excluído da Lixeira.](/tableau/current/pt-br/prep/pt-br/Img/prep_recycle_bin_restore_dialog.png) 5. Selecione Restaurar. ## Exibir saída de fluxo no Tableau Desktop **Observação**: esta opção não está disponível na Web. Às vezes, ao limpar seus dados, você pode querer verificar o andamento olhando no Tableau Desktop. Quando o fluxo é aberto no Tableau Desktop, o Tableau Prep Builder cria um arquivo .hyper permanente do Tableau ou um arquivo (.tds) de fonte de dados do Tableau. Esses arquivos são salvos no repositório do Tableau, no arquivo Fontes de dados, para que você possa usar os dados a qualquer momento. Ao abrir o fluxo no Tableau Desktop, você pode ver a amostra de dados com a estiver trabalhando no fluxo com as operações aplicadas a ela, até a etapa selecionada. **Observação**: embora você possa experimentar seus dados, o Tableau mostra apenas uma amostra dos dados e você não poderá salvar a pasta de trabalho como uma pasta de trabalho em pacote (.twbx). Quando estiver pronto para trabalhar com seus dados no Tableau, crie uma etapa de saída para seu fluxo e salve a saída em um arquivo ou como uma fonte de dados publicada, então conecte a fonte de dados completa no Tableau. Para exibir a amostra de dados no Tableau Desktop, faça o seguinte: 1. Clique com o botão direito do mouse na etapa que deseja exibir os dados e selecione Visualizar no Tableau Desktop no menu de contexto. ![Um diagrama de fluxo de dados com a opção selecionada Visualizar no Tableau Desktop.](/tableau/current/pt-br/prep/pt-br/Img/prep_preview_in_desktop.png) 2. O Tableau Desktop é aberto na guia Planilha. ## Criar arquivos de extração de dados e fontes de dados publicadas Para criar a saída de fluxo, execute o fluxo. Ao executar o fluxo, suas alterações são aplicadas a todo o conjunto de dados. Executar o fluxo resulta em um arquivo de fonte de dados do Tableau (.tds) e extração de dados do Tableau (.hyper). **Observação**: fluxos que incluem dados espaciais só podem ser gerados para arquivos .hyper ou como uma fonte de dados publicada. Outros tipos de saída não são compatíveis no momento. Para obter mais informações sobre como trabalhar com dados espaciais, consulte [Criar cálculos espaciais e uniões de colunas.](https://help.tableau.com/current/prep/pt-br/prep_spatial_calculations_and_joins.htm) #### Tableau Prep Builder É possível criar um arquivo de extração da saída do fluxo para usar no Tableau Desktop ou para compartilhar os dados com terceiros. Criar um arquivo de extração nos formatos a seguir: - Extração Hyper (.hyper): este é o tipo de arquivo de extração mais recente do Tableau. - Valor separado por vírgula (.csv): salve a extração em um arquivo .csv para compartilhar os dados com terceiros. A codificação do arquivo CSV o exportado será UTF-8 com o BOM. - Microsoft Excel (.xlsx): Uma planilha do Microsoft Excel. #### Tableau Prep Builder e na Web Publique sua saída de fluxo como uma fonte de dados publicada ou saída para um banco de dados. - Salve sua saída de fluxo como uma fonte de dados no Tableau Server ou Tableau Cloud para compartilhar seus dados e fornecer acesso centralizado aos dados que você limpou, formatou e combinou. - Salve sua saída de fluxo em um banco de dados para criar, substituir ou anexar os dados da tabela com seus dados de fluxo limpos e preparados. Para obter mais informações, consulte [Salvar dados de saída de fluxo em bancos de dados externos](#write_to_DB). Use a atualização incremental ao executar seu fluxo para economizar tempo e recursos atualizando apenas novos dados em vez de seu conjunto de dados completo. Para obter informações sobre como configurar e executar o fluxo usando a atualização incremental, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm). **Observação**: para publicar a saída do Tableau Prep Builder no Tableau Server, a API REST do Tableau Server deve estar habilitada. Para obter mais informações consulte [Requisitos da REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_requ.htm) na Ajuda da REST API do Tableau . Para publicar em um servidor que usa certificados de criptografia Secure Socket Layer (SSL), são necessárias etapas de configuração adicionais no computador que executa o Tableau Prep Builder. Para obter mais informações, consulte [Antes da instalação](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_intro.htm) no Guia de implantação do Tableau Desktop e Tableau Prep Builder. #### Incluir parâmetros em sua saída de fluxo _Com suporte no Tableau Prep Builder e na Web a partir da versão 2021.4_ Inclua valores de parâmetro em seus nomes de arquivo de saída de fluxo, caminhos, nomes de tabela ou scripts SQL personalizados (versão 2022.1.1 e posterior) para executar facilmente seus fluxos para diferentes conjuntos de dados. Para obter mais informações, consulte [Criar e usar parâmetros em fluxos](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm). ### Criar uma extração para um arquivo **Observação**: esta opção de saída não está disponível ao criar ou editar fluxos na Web. 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. Se já tiver executado o fluxo anteriormente, clique no botão de executar fluxo ![O botão Executar fluxo aparece como uma seta voltada para a direita.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow.png) na etapa de saída. Isso executa o fluxo e atualiza a saída. O painel de Saída é aberto e mostra um instantâneo de seus dados. ![Painel de saída do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_outputpane.png) 2. No painel esquerdo, selecione Arquivo na lista suspensa Salvar saída no. Nas versões anteriores, selecione Salvar no arquivo. 3. Clique no botão Procurar, depois, na caixa de diálogo Salvar extração como, insira um nome para o arquivo e clique em Aceitar. 4. No campo Tipo de saída, selecione um destes tipos de saída: - Extração de dados do Tableau (.hyper) - Valores separados por vírgula (.csv) 5. (Tableau Prep Builder) Na seção Opções de gravação, veja a opção de gravação padrão para gravar os novos dados nos arquivos e faça alterações conforme necessário. Para obter mais informações, consulte [Configurar opções de gravação](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm#flow-writeoptions). - Criar tabela: esta opção cria uma nova tabela ou substitui a tabela existente pela nova saída. - Anexar à tabela: esta opção adiciona os novos dados à tabela existente. Se a tabela ainda não existir, uma nova tabela será criada e as execuções subsequentes adicionarão novas linhas a ela. **Observação**: a opção Anexar à tabela não é compatível com os tipos de saída .csv. Para obter mais informações sobre as combinações de atualização compatíveis, consulte [Opções de atualização de fluxo](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm#refresh-options). 6. Clique em Executar fluxo para executar o fluxo e gerar o arquivo de extração. ### Criar uma extração para uma planilha do Microsoft Excel _Com suporte no Tableau Prep Builder versão 2021.1.2 e posteriores. Essa opção de saída não está disponível ao criar ou editar fluxos na Web ou ao criar saídas para fluxos que incluem dados espaciais._ Quando você produz dados de fluxo para uma planilha do Microsoft Excel, pode criar uma nova planilha ou anexar ou substituir dados em uma planilha existente. Aplicam-se as seguintes condições: - Apenas os formatos de arquivos .xlsx do Microsoft Excel são aceitos. - As linhas da planilha começam na célula A1. - Ao anexar ou substituir dados, pressupõe-se que a primeira linha seja cabeçalhos. - Os nomes do cabeçalho são adicionados ao criar uma nova planilha, mas não ao adicionar dados a uma planilha existente. - Qualquer formatação ou fórmulas nas planilhas existentes não são aplicadas à saída de fluxo. - Gravar para tabelas ou intervalos nomeados não é aceito no momento. - A atualização incremental não é aceita atualmente. **Dados de fluxo de saída para um arquivo de planilha do Microsoft Excel** 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. Se já tiver executado o fluxo anteriormente, clique no botão de executar fluxo ![O botão Executar fluxo aparece como uma seta voltada para a direita.](/tableau/current/pt-br/prep/pt-br/Img/prep_run_flow.png) na etapa de saída. Isso executa o fluxo e atualiza a saída. O painel de Saída é aberto e mostra um instantâneo de seus dados. ![Dados de fluxo de saída para um arquivo de planilha do Microsoft Excel](/tableau/current/pt-br/prep/pt-br/Img/prep_write_to_excel3.png) 2. No painel esquerdo, selecione Arquivo na lista suspensa Salvar saída no. 3. Clique no botão Procurar, depois, na caixa de diálogo Salvar extração como, insira ou selecione o nome de arquivo e clique em Aceitar. 4. No campo Tipo de saída, selecione Microsoft Excel (.xlsx). ![Dados de fluxo de saída para um arquivo de planilha do Microsoft Excel](/tableau/current/pt-br/prep/pt-br/Img/prep_write_to_excel4.png) 5. No campo Planilha, selecione a planilha para a qual deseja gravar seus resultados ou digite um novo nome no campo e clique em Criar nova tabela. 6. Na configuração Opções de gravação, selecione uma das seguintes opções: - Criar tabela: cria ou recria (se o arquivo já existir) a planilha com os dados de fluxo. - Anexar à tabela: adiciona novas linhas a uma planilha existente. Se a planilha não existir, uma é criada e as execuções de fluxo subsequentes adicionam linhas a essa planilha. - Substituir os dados: substitui todos os dados, exceto a primeira linha em uma planilha existente pelos dados de fluxo. Uma comparação de campo mostra os campos no fluxo que correspondem aos campos na planilha, caso a planilha já exista. Se a planilha for nova, será exibida uma correspondência de campo de um para um. Todos os campos que não correspondem são ignorados. ![Dados de fluxo de saída para um arquivo de planilha do Microsoft Excel](/tableau/current/pt-br/prep/pt-br/Img/prep_write_to_Excel2.png) 7. Clique em Executar fluxo para executar o fluxo e gerar o arquivo de extração do Microsoft Excel. ### Criar uma fonte de dados publicada 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. **Observação**: o Tableau Prep Builder atualiza fontes de dados publicadas anteriormente e mantém, a modelagem de dados (por exemplo, campos calculados, formatação de números e assim por diante) que possam ser incluídos na fonte de dados. Se a fonte de dados não puder ser atualizada, a fonte de dados, incluindo a modelagem de dados, será substituída. 2. O painel de saída é aberto e mostra um instantâneo de seus dados. ![O campo Salvar saída em é definido como Fonte de dados publicada. Uma tabela de dados é exibida.](/tableau/current/pt-br/prep/pt-br/Img/prep_publishasdatasource2.png) 3. Na lista suspensa Salvar saída em, selecione Fonte de dados publicada (Publicar como fonte de dados em versões anteriores). Preencha os campos a seguir: - Servidor (somente para o Tableau Prep Builder): selecione o servidor onde deseja publicar a fonte de dados e a extração de dados. Se não estiver logado a um servidor você será solicitado a entrar. **Observação**: a partir do Tableau Prep Builder versão 2020.1.4, depois de entrar no servidor, Tableau Prep Builderlembra o nome do servidor e as credenciais quando você fecha o aplicativo. Na próxima vez que você abrir o aplicativo, já estará conectado ao seu servidor. No Mac, você pode ser solicitado a fornecer acesso às chaves do Mac para que o Tableau Prep Builder possa usar certificados SSL com segurança para se conectar ao ambiente do Tableau Server ou do Tableau Cloud. Se você estiver enviando para o Tableau Cloud, inclua o pod onde seu site está hospedado no "serverUrl". Por exemplo, "https://eu-west-1a.online.tableau.com”, não "https://online.tableau.com". - Projeto: selecione o projeto onde deseja carregar a fonte de dados e a extração. - Nome: insira um nome de arquivo. - Descrição: insira uma descrição para a fonte de dados. 4. (Tableau Prep Builder) Na seção Opções de gravação, veja a opção de gravação padrão para gravar os novos dados nos arquivos e faça alterações conforme necessário. Para obter mais informações, consulte [Configurar opções de gravação](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm#flow-writeoptions) - Criar tabela: esta opção cria uma nova tabela ou substitui a tabela existente pela nova saída. - Anexar à tabela: esta opção adiciona os novos dados à tabela existente. Se a tabela ainda não existir, uma nova tabela será criada e as execuções subsequentes adicionarão novas linhas a ela. 5. Clique em Executar fluxo para executar o fluxo e publicar a fonte de dados. ## Salvar dados de saída de fluxo em bancos de dados externos _Esta opção de saída não está disponível ao criar saída para fluxos que incluem dados espaciais._ > [!IMPORTANT] > > **Importante**: este recurso permite excluir permanentemente e substituir os dados em um banco de dados externo. Verifique se você tem permissões para gravar no banco de dados. > Para evitar a perda de dados, você pode usar a opção SQL personalizado para fazer uma cópia dos dados da sua tabela e executá-los antes de gravar os dados de fluxo na tabela. Você pode se conectar a dados de qualquer um dos conectores que o Tableau Prep Builder ou a Web permite e enviar dados para um banco de dados externo. Isso permite adicionar ou atualizar dados em seu banco de dados com dados limpos e preparados do seu fluxo toda vez que o fluxo é executado. Este recurso está disponível para opções de atualização incremental e completa, salvo indicação em contrário. Para obter mais informações sobre como configurar a atualização incremental, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm). Quando você salva sua saída de fluxo em um banco de dados externo, o Tableau Prep faz o seguinte: 1. Gera as linhas e executa os comandos SQL no banco de dados. 2. Grava os dados em uma tabela temporária (ou área de preparação se for para Snowflake) no banco de dados de saída. 3. Se a operação for bem-sucedida, os dados serão movidos da tabela temporária (ou da área de preparação para Snowflake) para a tabela de destino. 4. Executa todos os comandos SQL que você deseja executar depois de gravar os dados no banco de dados. Se o script SQL falhar, o fluxo também terá erros. No entanto, seus dados ainda serão carregados em suas tabelas de banco de dados. Você pode tentar executar o fluxo mais uma vez ou executar manualmente seu script SQL em seu banco de dados para aplicá-lo. ### Opções de saída Você pode selecionar as seguintes opções ao gravar dados em um banco de dados. Se a tabela ainda não existir, ela será criada quando o fluxo for executado pela primeira vez. - Anexar à tabela: esta opção adiciona dados a uma tabela existente. Se a tabela não existir, será criada quando o fluxo for executado pela primeira vez e os dados serão adicionados a essa tabela a cada fluxo subsequente executado. - Criar tabela: esta opção cria uma nova tabela com os dados do seu fluxo. Se a tabela já existir, a tabela e qualquer estrutura de dados existente ou propriedades existentes definidas para a tabela serão excluídas e substituídas por uma nova tabela que usa a estrutura de dados de fluxo. Todos os campos existentes no fluxo são adicionados à nova tabela de banco de dados. - Substituir dados: esta opção exclui os dados da tabela existente e os substitui pelos dados do seu fluxo, mas preserva a estrutura e as propriedades da tabela do banco de dados. Se a tabela não existir, a tabela será criada quando o fluxo for executado pela primeira vez e os dados da tabela forem substituídos por cada fluxo subsequente executado. ### Opções adicionais Além das opções de gravação, você também pode incluir scripts de SQL personalizado ou adicionar uma nova tabela ao seu banco de dados. - **Scripts de SQL personalizados**: insira seu SQL personalizado e selecione se deseja executar seu script antes, depois ou antes e depois que os dados forem gravados nas tabelas do banco de dados. Você pode usar esses scripts para criar uma cópia de sua tabela de banco de dados antes que os dados de fluxo sejam gravados na tabela, adicionar um índice, adicionar outras propriedades de tabela e assim por diante. **Observação**: a partir da versão 2022.1.1, você também pode inserir parâmetros em seus scripts SQL. Para obter mais informações, consulte [Aplicar parâmetros de usuário às etapas de saída](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm#output_parameters). - **Adicionar uma nova tabela**: adicione uma nova tabela com um nome exclusivo ao banco de dados em vez de selecionar uma na lista de tabelas existente. Se você quiser aplicar um esquema diferente do esquema padrão (Microsoft SQL Server e PostgreSQL), poderá especificá-lo usando a sintaxe `[schema name].[table name]`. ### Bancos de dados compatíveis e requisitos de bancos de dados O Tableau Prep permite a gravação de dados de fluxo em tabelas em um número específico de bancos de dados. Os fluxos executados em uma agenda no Tableau Cloud só poderão ser gravados nesses bancos de dados se estiverem hospedados na nuvem. Se você se conectar a fontes de dados locais, a partir da versão 2025.1, poderá usar um cliente do Tableau Bridge para se conectar e atualizar seus dados no Tableau Cloud. Isso requer um cliente Tableau Bridge configurado em um pool de clientes Bridge, com o domínio adicionado ao Lista de permissões de rede privada. No Tableau Prep Builder e na Web, ao se conectar à sua fonte de dados, certifique-se de que a URL do servidor corresponda ao domínio no pool de ponte. Para obter mais informações, consulte "Bancos de dados" na seção Tableau Cloud em [Publicar um fluxo do Tableau Prep Builder](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#publish-a-flow-from-tableau-prep-builder). Alguns bancos de dados têm restrições de dados ou requisitos. O Tableau Prep também pode impor alguns limites para manter o alto desempenho ao gravar dados nos bancos de dados compatíveis. A tabela a seguir lista os bancos de dados onde você pode salvar seus dados de fluxo e quaisquer restrições ou requisitos de banco de dados. Os dados que não atendem a esses requisitos podem resultar em erros na execução do fluxo. **Observação**: ainda não há suporte para definir limites de caracteres para os campos. No entanto, você pode criar as tabelas em seu banco de dados que incluem restrições de limite de caracteres e, em seguida, usar a opção Substituir dados para substituir seus dados, mas manter a estrutura da tabela no banco de dados.
Banco de dadosRequisitos ou restrições
Amazon Redshift
  • Sequências em bloco não são aceitas. Consulte a documentação do Amazon Redshift para obter mais informações.
  • Os nomes de campo são convertidos em letras minúsculas.
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
Amazon S3 (somente saída)Salvar dados de saída de fluxo no Amazon S3
Databricks
  • O Tableau Prep Builder ou Tableau Server requer o driver de ODBC Databricks versão 2.8.2 ou mais recente. Os drivers necessários são implantados automaticamente em ambientes do Tableau Cloud.

  • Compatível com o Tableau Cloud ou ao publicar no Tableau Cloud (a partir da versão 2025.3).

  • O nome da tabela não pode exceder 255 caracteres ou incluir qualquer um dos seguintes caracteres:

    • Ponto (.)

    • Espaço ( )

    • Barra (/)

    • Todos os caracteres de controle ASCII (00-1F hex)

    • O caractere DELETE (7F hex)

    • Ponto e vírgula (;)

  • Compatível apenas com as opções de gravação Criar e Substituir. Anexar não é compatível no momento.

  • Compatível apenas com atualização Completa. A atualização incremental não é aceita.

Google BigQuery
  • O Tableau pode gravar até 2 GB como saída para a tabela.

Microsoft SQL Server
  • Até 3.072 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
  • (Versão: 2022.3.1 e mais recentes) As saídas de fluxo publicadas no Tableau Server têm permissão de acesso de gravação a um banco de dados Microsoft SQL Server usando credenciais Run As. Consulte maestro.output.write_to_mssql_using_runas em Opções tsm configuration set.
MySQL
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
Oracle
  • Nomes de campo e tabela não podem exceder 30 caracteres.
  • Até 1.000 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
  • Caracteres especiais nos nomes de campo podem causar erros.
Pivotal Greenplum Database
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
PostgreSQL
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
SAP HANA
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
Snowflake
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
  • As opções de warehouse devem ser definidas como retomada automática para permitir que o Tableau Prep grave dados no warehouse do banco de dados. Para obter mais informações, consulte Suspensão e retomada automáticas na documentação do Snowflake.

Teradata
  • Até 1.000 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
Vertica
  • Até 8.192 caracteres podem ser escritos nos valores de campo de texto. Valores mais longos são truncados.
### Salvar dados de fluxo em um banco de dados **Observação**: você pode inserir suas credenciais no banco de dados ao publicar o fluxo. Para obter mais informações sobre como inserir credenciais, consulte a seção **Bancos de dados** em [Publicar um fluxo no Tableau Prep Builder](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#Publish). 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. 2. Na lista suspensa Salvar saída, selecione Banco de dados e Armazenamento na nuvem. 3. Na guia Configurações, insira estas informações: - Na lista suspensa Conexão, selecione o conector de banco de dados onde deseja gravar a saída de fluxo. São exibidos apenas os conectores compatíveis. Este pode ser o mesmo conector que você usou para sua entrada de fluxo ou um conector diferente. Se você selecionar um conector diferente, será solicitado a fazer logon. > [!IMPORTANT] > > **Importante:** certifique-se de ter permissão de gravação para o banco de dados selecionado. Caso contrário, o fluxo só poderá processar parcialmente os dados. ![Salve dados de fluxo em um banco de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb1_254.png) - Na lista suspensa Banco de dados, selecione o banco de dados onde você deseja salvar os dados de saída de fluxo. Os esquemas ou bancos de dados devem ter pelo menos uma tabela para ficarem visíveis na lista suspensa. - Na lista suspensa Tabela, selecione a tabela onde você deseja salvar os dados de saída de fluxo. Dependendo da opção de gravação selecionada, uma nova tabela será criada, os dados de fluxo substituirão os dados existentes na tabela ou os dados de fluxo serão adicionados à tabela existente. Para criar uma nova tabela no banco de dados, digite um nome de tabela exclusivo no campo e clique em Criar nova tabela. Quando você executa o fluxo pela primeira vez, independentemente da opção de gravação selecionada, a tabela é criada no banco de dados usando o mesmo esquema que o fluxo. ![Caixa de diálogo Salvar saída em.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb3.png) 4. O painel de saída mostra um instantâneo de seus dados. Uma comparação de campo mostra os campos no fluxo que correspondem aos campos na tabela, caso a tabela já exista. Se a tabela for nova, será exibida uma correspondência de campo de um para um. ![Salve dados de fluxo em um banco de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb1.png) Caso existam incompatibilidades de campo, uma nota de status mostra os erros. - **Sem correspondência: campo ignorado**: os campos existem no fluxo, mas não no banco de dados. O campo não será adicionado à tabela de banco de dados, a menos que você selecione a opção de gravação Criar tabela e execute uma atualização completa. Em seguida, os campos de fluxo são adicionados à tabela de banco de dados e usam o esquema de saída de fluxo. - **Sem correspondência: o campo conterá valores nulos**: os campos existem no banco de dados, mas não no fluxo. O fluxo passa um valor nulo para a tabela de banco de dados no campo. Se o campo existir no fluxo, mas for incompatível porque o nome de campo é diferente, você poderá navegar até uma etapa de limpeza e editar o nome de campo para corresponder ao nome de campo do banco de dados. Para obter informações sobre como editar o nome de campo, consulte [Aplicar operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#clean_list). - **Erro: os tipos de dados de campo não correspondem**: os tipos de dados atribuídos a um campo, tanto no fluxo quanto na tabela do banco de dados em que você está gravando sua saída, devem corresponder; caso contrário, o fluxo falhará. Você pode navegar até uma etapa de limpeza e editar o tipo de dados de campo para corrigir isso. Para obter mais informações sobre a mudança de tipos de dados, consulte [Consultar os tipos de dados atribuídos aos seus dados](https://help.tableau.com/current/prep/pt-br/prep_explore.htm#reviewdatatypes). 5. Selecione uma opção de gravação. Você pode selecionar uma opção diferente para atualização completa e incremental, e a opção é aplicada quando você seleciona seu método de execução de fluxo. Para obter mais informações sobre a execução do nosso fluxo usando a atualização incremental, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm). - Anexar à tabela: esta opção adiciona dados a uma tabela existente. Se a tabela não existir, será criada quando o fluxo for executado pela primeira vez e os dados serão adicionados a essa tabela a cada fluxo subsequente executado. - Criar tabela: esta opção cria uma nova tabela. Se a tabela com o mesmo nome já existir, a tabela existente será excluída e substituída pela nova tabela. Qualquer estrutura de dados existente ou propriedades definidas para a tabela também são excluídas e substituídas pela estrutura de dados de fluxo. Todos os campos existentes no fluxo são adicionados à nova tabela de banco de dados. - Substituir dados: esta opção exclui os dados da tabela existente e os substitui pelos dados do seu fluxo, mas preserva a estrutura e as propriedades da tabela do banco de dados. 6. (opcional) Clique na guia SQL personalizado e insira seu script de SQL. Você pode inserir um script para executar Antes e Depois de os dados serem gravados na tabela. ![Salve a saída na tabela do banco de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb4.png) 7. Clique em Executar fluxo para executar o fluxo e gravar seus dados no banco de dados selecionado. ## Salvar dados de saída de fluxo em conjuntos de dados no CRM Analytics _Com suporte no Tableau Prep Builder e na Web a partir da versão 2022.3_ **Observação**: o CRM Analytics tem vários requisitos e algumas limitações ao integrar dados de fontes externas. Para garantir que você possa gravar com êxito sua saída de fluxo no CRM Analytics, consulte [Considerações antes de integrar dados em conjuntos de dados](https://help.salesforce.com/s/articleView?id=sf.bi_integrate_considerations.htm) na ajuda do Salesforce. Limpe seus dados usando o Tableau Prep e obtenha melhores resultados de previsão no CRM Analytics. Basta conectar aos dados de qualquer um dos conectores que o Tableau Prep Builder ou Tableau Prep na Web oferece suporte. Em seguida, aplique transformações para limpar seus dados e enviar seus dados de fluxo diretamente para conjuntos de dados no CRM Analytics aos quais você tem acesso. Os fluxos que geram dados para o CRM Analytics não podem ser executados usando a interface de linha de comando. Você pode executar fluxos manualmente usando o Tableau Prep Builder ou um agendamento na Web com o Tableau Prep Conductor. ### Pré-requisitos Para enviar dados de fluxo para o CRM Analytics, verifique se você tem as seguintes licenças, acesso e permissões no Salesforce e no Tableau. #### Requisitos do Salesforce
requisitodescription
Permissões do Salesforce

Você deve estar designado para a licença CRM Analytics Plus ou CRM Analytics Growth.

A licença CRM Analytics Plus inclui os conjuntos de permissões:

  • Administrador do CRM Analytics Plus: habilita todas as permissões necessárias para administrar a plataforma CRM Analytics e o Einstein Discovery, incluindo permissões para criar e gerenciar aplicativos e aplicativos com modelo do CRM Analytics.

  • Usuário do CRM Analytics Plus : habilita todas as permissões necessárias para usar a plataforma CRM Analytics, Einstein Discovery e aplicativos com modelo do CRM Analytics e Aplicativos.

A licença CRM Analytics Plus inclui os conjuntos de permissões:

  • Administrador do CRM Analytics Growth: habilita todas as permissões necessárias para administrar a plataforma CRM Analytics, incluindo permissões para criar e gerenciar aplicativos e aplicativos com modelo do CRM Analytics.

  • Usuário do CRM Analytics Growth: habilita todas as permissões necessárias para usar a plataforma CRM Analytics, Einstein Discovery e aplicativos com modelo do CRM Analytics e Aplicativos.

Para obter mais informações, consulte Saiba mais sobre licenças e conjuntos de atribuir usuários permissões do CRM Analytics e Selecionar e atribuir conjuntos de permissões do usuário na ajuda do Salesforce.

Configurações do administrador

Os administradores da Salesforce precisarão configurar:

#### Requisitos do Tableau Prep
requisitodescription

Licença e permissões do Tableau Prep

Licença Creator.

Como criador, você precisa fazer login em sua conta organizacional do Salesforce e autenticar antes de selecionar Aplicativos e conjuntos de dados para gerar seus dados de fluxo.

Conexões de dados OAuth

Como administrador do servidor, configure o Tableau Server com uma ID de cliente OAuth e um segredo no conector. Isso é necessário para executar fluxos no Tableau Server.

Para obter mais informações, consulte Configurar Tableau Server para Oauth do Salesforce.com Oauth na ajuda do Tableau Server.

### Salvar dados de fluxo em um CRM Analytics Os seguintes limites de entrada do CRM Analytics se aplicam ao salvar de Tableau Prep Builder para CRM Analytics. - Tamanho máximo de arquivo para uploads de dados externos: 40 GB - Tamanho máximo de arquivo para todos os uploads de dados externos em um período contínuo de 24 horas: 50 GB 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. 2. Na lista suspensa Salvar saída em, selecione CRM Analytics. ![Opções de salvamento de conjunto de dados com o menu suspenso Conexão expandido.](/tableau/current/pt-br/prep/pt-br/Img/prep_output_crma_signin.png) 3. Na seção Conjunto de dados de dados, conecte-se ao Salesforce. Faça login no Salesforce e clique em Permitir para conceder ao Tableau acesso aos aplicativos e conjuntos de dados do CRM Analytics ou selecione uma conexão existente do Salesforce 4. No campo Nome, selecione um nome de conjunto de dados existente. Isso substituirá o conjunto de dados pela saída do fluxo. Caso contrário, digite um novo nome e clique em Criar novo conjunto de dados para criar um novo conjunto de dados no aplicativo CRM Analytics selecionado. **Observação**: os nomes dos conjuntos de dados não podem exceder 80 caracteres. ![Opções de salvamento de conjunto de dados com MyDataSet inserido no campo de nome.](/tableau/current/pt-br/prep/pt-br/Img/prep_output_crma_dataset.png) 5. Abaixo do campo Nome, verifique se o aplicativo mostrado é o aplicativo para o qual você tem permissão para gravar. Para alterar o aplicativo, clique em Procurar conjuntos de dados, selecione o aplicativo na lista, insira o nome do conjunto de dados no campo Nome e clique em Aceitar. ![A caixa de diálogo Selecionar conjunto de dados mostra uma lista de conjuntos de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_output_crma_dataset_app.png) 6. Na seção Opções de gravação, Atualização completa e Criar tabela são as únicas opções com suporte. 7. Clique em Executar fluxo para executar o fluxo e gravar seus dados no conjunto de dados CRM Analytics. Se a execução do fluxo for bem-sucedida, você poderá verificar os resultados de saída no CRM Analytics na guia Monitor do gerenciador de dados. Para obter mais informações sobre esse recurso, consulte [Monitorar um carregamento de dados externos](https://help.salesforce.com/s/articleView?id=sf.bi_integrate_systemjob_monitoring.htm) na ajuda do Salesforce. ## Salvar dados de saída de fluxo em Data Cloud _Com suporte no Tableau Prep Builder e na Web a partir da versão 2023.3_ Prepare seus dados com o Tableau Prep e associe-os aos conjuntos de dados existentes no Data Cloud. Use qualquer um dos conectores compatíveis com o Tableau Prep Builder ou o Tableau Prep na Web para importar seus dados, limpar e preparar seus dados e, em seguida, enviar seus dados de fluxo diretamente para o Data Cloud usando a API de ingestão. ### Pré-requisitos de permissão

Licença do Salesforce

Para obter informações sobre edições do Data Cloud e licenças complementares, consulte Edições e licenças padrão do Data Cloud na ajuda do Salesforce.

Veja também Limites e diretrizes do Data Cloud.

Permissões de espaço de dados

Você deve estar atribuído a um espaço de dados e a um dos seguintes conjuntos de permissões no Data Cloud:

  • Administrador de nuvem de dados do cliente
  • Data Cloud para administrador de marketing
  • Especialista em Data Cloud para a conscientização de dados de marketing

Para obter mais informações, veja Gerenciar espaços de dados e Gerenciar espaços de dados com conjuntos de permissões herdados.

Permissão de ingestão para Data Cloud

Você deve ser atribuído ao seguinte para acesso de campo para ingestão no Data Cloud:

  • Conector Data Cloud Salesforce

Para obter mais informações, veja Habilitar permissões de objetos e campos.

Perfis do Salesforce

Habilite o acesso ao perfil para:

  • Permissões administrativas: API habilitada
  • Acesso ao aplicativo (aplicativo cliente externo ou aplicativo conectado): NameOfApp
Licença e permissões do Tableau PrepLicença Creator. Como criador, você precisa fazer login em sua conta organizacional do Salesforce e autenticar antes de selecionar Aplicativos e conjuntos de dados para gerar seus dados de fluxo.
### Salvar dados de fluxo em Data Cloud Se você já usa a API de ingestão e chama manualmente as APIs para salvar conjuntos de dados no Data Cloud, você pode simplificar esse fluxo de trabalho usando o Tableau Prep. As configurações de pré-requisito são as mesmas do Tableau Prep. Se esta for a primeira vez que você salva dados no Data Cloud, siga os requisitos de configuração em [Pré-requisitos de configuração do Data Cloud](#saveDC_setup). 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. 2. Na lista suspensa Salvar saída, selecione **Salesforce Data Cloud**. ![Um menu suspenso de opções para salvar sua saída.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDC.png) 4. Na seção Objeto, selecione a organização do Salesforce Data Cloud para fazer login. ![Exemplo de como salvar saída no Salesforce Data Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDCName.png) 5. No menu Salesforce Data Cloud, clique em Entrar. Uma janela do navegador será aberta para _https://login.salesforce.com/_. ![A janela de autenticação do Salesforce Data Cloud solicita que os usuários façam logon usando o OAuth.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDC_login.png) 8. Faça login na organização Data Cloud usando seu nome de usuário e senha. 9. Na formulário Permitir acesso, clique em **Permitir**. ![O formulário Permitir acesso é exibido ao fazer logon no Data Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDC_allow.png) 11. Na seção Salvar saída para, insira o conector da API de ingestão e o Nome do objeto. ![Um formulário para salvar a saída no Salesforce Data Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDC_ingestion.png) 13. Para encontrar o nome do Conector de API de ingestão e Nome do objeto correspondente, faça o seguinte: - Faça login no Salesforce Data Cloud e navegue até Configuração do Data Cloud. ![O menu Configuração em uma organização do Salesforce mostrando a opção de menu Configuração do Data Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb_DC_setup.png) - Na caixa Localização rápida, digite API de ingestão, então selecione API de ingestão nos resultados. ![O menu de localização rápida da configuração do Salesforce Org Data Cloud mostra a opção de menu da API de ingestão.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb_DC_Ingestion_API_menu.png) - Na página API de ingestão, você verá os conectores disponíveis listados em Nome do conector. ![Página de ingestão da API do Salesforce Data Cloud mostrando a lista de nomes de conectores de ingestão de API.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb_DC_Ingestion_API_Connectors.png) - Para encontrar o correspondente Nome do objeto para o conector que você deseja usar, selecione um conector na lista. Na página Detalhes do conector na seção Esquema, você verá os objetos correspondentes listados em Nome do objeto. ![Página de detalhes do conector da API de ingestão do Salesforce Data Cloud, mostrando os objetos correspondentes para o conector.](/tableau/current/pt-br/prep/pt-br/Img/prep_wtdb_DC_Ingestion_API_Connectors_Object.png) 14. A seção Opções de Gravação indica que as linhas existentes serão atualizadas se o valor especificado já existir em uma tabela, ou uma nova linha será inserida se o valor especificado ainda não existir. 15. Clique em Executar fluxo para executar o fluxo e gravar seus dados no Data Cloud. 16. Valide os dados no Data Cloud visualizando o status de execução no Data Stream e os objetos no Data Explorer. #### Considerações - É possível executar um fluxo por vez. A execução deve ser concluída no Data Cloud antes que outra saída Salvar possa ser executada. - Os tempos de espera para salvar um fluxo no Data Cloud podem levar algum tempo para serem concluídos. Verifique o status no Data Cloud. - Os dados são salvos no Data Cloud usando a função Upsert. Se um registro em um arquivo corresponder a um registro existente, o registro existente será atualizado com os valores dos seus dados. Se nenhuma correspondência for encontrada, o registro será criado como uma nova entidade. - Para o Prep Conductor, se você agendar o mesmo fluxo para execução automática, os dados não serão atualizados. Isso ocorre porque apenas o Upsert é compatível. - Você não pode cancelar o trabalho durante o processo de salvar no Data Cloud. - Não há validação de campos salvos no Data Cloud. Valide os dados no Data Cloud. ### Pré-requisitos de configuração do Data Cloud Estas etapas são um pré-requisito para salvar fluxos do Tableau Prep no Data Cloud. Para obter informações detalhadas sobre conceitos do Data Cloud e mapeamento de dados entre fontes de dados do Tableau e Data Cloud, consulte [Sobre a nuvem de dados do Salesforce](https://help.salesforce.com/s/articleView?id=sf.c360_a_data_cloud.htm). #### Configurar o conector Salesforce API Crie um fluxo de dados da API de ingestão a partir de seus objetos de origem fazendo upload de um arquivo de esquema no formato OpenAPI (OAS) com uma extensão de arquivo .yaml. O arquivo de esquema descreve como os dados do seu site são estruturados. Para obter mais informações, consulte o [Exemplos de arquivo YAML](#YMAL) e [API de ingestão.](https://help.salesforce.com/s/articleView?id=sf.c360_a_ingestion_api.htm) 1. Clique no ícone de engrenagem Configurar e depois Configuração da nuvem de dados. 2. Clique em API de ingestão. 3. Clique em Novo e forneça um nome de conector. 4. Na página de detalhes do novo conector, carregue um arquivo de esquema no formato OpenAPI (OAS) com uma extensão de arquivo `.yaml`. O arquivo de esquema descreve como os dados transferidos por meio da API são estruturados. **Observação**: os esquemas da API de ingestão definiram requisitos. Veja [Requisitos de esquema](#saveDC_schemReq) antes da ingestão. 6. Clique Salvar no formulário Esquema de visualização. #### Criar um fluxo de dados Os fluxos de dados são uma fonte de dados trazida para o Data Cloud. Consiste nas conexões e nos dados associados ingeridos no Data Cloud. 1. Vá para o Iniciador de aplicativos e selecione Data Cloud. 2. Clique na guia Fluxo de dados. 3. Clique em Novo e selecione API de ingestão, então clique em Próximo. 4. Selecione a API de ingestão e os objetos. 5. Selecione o espaço de dados, a categoria e a chave primária e clique em Próximo. Uma chave primária verdadeira deve ser usada para Data Cloud. Se não existir, você precisará criar um campo de fórmula para a chave primária. Para Categoria, escolha entre Perfil, Engajamento ou Outro. Um campo de data e hora deve estar presente para objetos destinados à categoria de trabalho. Objetos do tipo perfil ou outros não impõem esse mesmo requisito. Para obter mais informações, veja [Categoria](https://help.salesforce.com/s/articleView?id=sf.c360_a_category.htm) e [Chave primária](https://help.salesforce.com/s/articleView?id=sf.c360_a_primary_key.htm). 8. Clique em Implantar. Agora você tem um fluxo de dados e um objeto de lago de dados. Seu fluxo de dados agora pode ser adicionado a um espaço de dados. ![Uma página de fluxo de dados no Salesforce Data Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDC_data_stream.png) #### Adicione seu fluxo de dados a um espaço de dados Ao trazer dados de qualquer fonte para o Data Cloud, você associa os Objetos de lago de dados (DLOs) ao espaço de dados relevante com ou sem filtros. 1. Clique na guia Espaços de dados. ![Uma tabela de espaços de dados visualizados recentemente.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDCSF_recent.png) 3. Escolha o Espaço de dados padrão ou o nome do espaço de dados ao qual você está atribuído. 4. Clique em Adicionar dados. 5. Selecione o objeto de Lago de dados que você criou e clique em Próximo. 6. (Opcional) selecione filtros para o objeto. 7. Clique em Salvar. #### Mapeie o objeto de Lago de dados para objetos do Salesforce O mapeamento de dados relaciona os campos do Objeto de lago de dados aos campos do Objeto de modelo de dados (DMO). 1. Vá para a guia Fluxo de dados e selecione o fluxo de dados que você criou. ![Formulário de status de mapeamento de dados com o botão Iniciar.](/tableau/current/pt-br/prep/pt-br/Img/prep_saveDC_map.png) 2. Na seção Mapeamento de dados, clique em Começar. A tela de mapeamento de campo mostra seus DLOs de origem à esquerda e DMOs de destino à direita. Para obter mais informações, consulte [Mapear objetos do modelo de dados](https://help.salesforce.com/s/articleView?id=sf.c360_a_map_custom_data_model_objects.htm). #### Criar um aplicativo cliente externo ou aplicativo conectado para a API de ingestão do Data Cloud Para enviar dados para o Data Cloud usando a API de ingestão, configure o Salesforce para usar um aplicativo cliente externo (recomendado) ou um aplicativo conectado (obsoleto). Para obter mais detalhes, consulte o seguinte na Ajuda do Salesforce: - Para aplicativo cliente externo: [Definir as configurações de OAuth do aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_oauth_settings.htm&type=5) e [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) - Para aplicativo conectado: [Habilitar configurações de OAuth para integração de API](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_api_integration.htm) e [Criar um aplicativo conectado para API de ingestão do Data Cloud](https://help.salesforce.com/s/articleView?id=sf.c360_a_create_ingestion_api_connected_app.htm) Como parte da configuração do seu aplicativo cliente externo ou aplicativo conectado para API de ingestão, você deve selecionar os seguintes escopos OAuth: - Acesse e gerencie os dados da API de ingestão de Data Cloud (cdp\_ingest\_api) - Gerencie dados de perfil do Data Cloud (cdp\_profile\_api) - Execute consultas ANSI SQL nos dados do Data Cloud (cdp\_query\_api) - Gerenciar dados do usuário por meio de APIs (api) - Realizar solicitações em seu nome a qualquer momento (refresh\_token, offline\_access) #### Requisitos de esquema Para criar uma origem de API de ingestão no Data Cloud, o arquivo de esquema carregado deve atender a requisitos específicos. Consulte [Requisitos para esquema de API de ingestão](https://help.salesforce.com/s/articleView?id=sf.c360_a_ingestion_api_schema_req.htm). - Os esquemas carregados devem estar em formato OpenAPI válido com extensão .yml ou .yaml. A versão 3.0.x do OpenAPI é suportada. - Os objetos não podem ter objetos aninhados. - Cada esquema deve ter pelo menos um objeto. Cada objeto deve ter pelo menos um campo. - Os objetos não podem ter mais de 1.000 campos. - Os objetos não podem ter mais de 80 caracteres. - Os nomes dos objetos devem conter apenas a-z, A-Z, 0–9, \_, -. Sem caracteres Unicode. - Os nomes dos campos devem conter apenas a-z, A-Z, 0–9, \_, -. Sem caracteres Unicode. - Os nomes dos campos não podem ser nenhuma destas palavras reservadas: date\_id, location\_id, dat\_account\_currency, dat\_exchange\_rate, pacing\_period, pacing\_end\_date, row\_count, version. Os nomes dos campos não podem conter a cadeia de caracteres \_\_. - Os nomes de campo não podem exceder 80 caracteres. - Os campos atendem ao seguinte tipo e formato: - Para texto ou tipo booleano: cadeia de caracteres - Para tipo de número: número - Para tipo de data: cadeia de caracteres; formato: data-hora - Os nomes dos objetos não podem ser duplicados; não diferencia maiúsculas de minúsculas. - Os objetos não podem ter nomes de campos duplicados; não diferencia maiúsculas de minúsculas. - Os campos de tipo de dados DateTime em suas cargas devem estar em ISO 8601 UTC Zulu com formato aaaa-MM-dd’T’HH:mm:ss.SSS’Z'. Ao atualizar seu esquema, esteja ciente de que: - Os tipos de dados de campo existentes não podem ser alterados. - Ao atualizar um objeto, todos os campos existentes para esse objeto deverão estar presentes. - Seu arquivo de esquema atualizado inclui apenas objetos alterados, portanto você não precisa fornecer todas as vezes uma lista abrangente de objetos. - Um campo de data e hora deve estar presente para objetos destinados à categoria de trabalho. Objetos do tipo `profile` ou `other` não impõem esse mesmo requisito. #### Exemplos de arquivo YAML openapi: 3.0.3 components: schemas: owner: type: object required: - id - name - region - createddate properties: id: type: integer format: int64 name: type: string maxLength: 50 region: type: string maxLength: 50 createddate: type: string format: date-time car: type: object required: - car\_id - color - createddate properties: car\_id: type: integer format: int64 color: type: string maxLength: 50 createddate: type: string format: date-time ## Salvar dados de saída de fluxo no Amazon S3 _Disponível no Tableau Prep Builder 2024.2 e posterior, criação na Web e Tableau Cloud. Esse recurso ainda não está disponível no Tableau Server._ Você pode se conectar aos dados de qualquer um dos conectores suportados pelo Tableau Prep Builder ou pela Web e salvar a saída do fluxo como um arquivo .parquet ou .csv no Amazon S3. A saída pode ser salva como novos dados ou você pode substituir os dados S3 existentes. Para evitar a perda de dados, você pode usar a opção SQL personalizado para fazer uma cópia dos dados da tabela e executá-la antes de salvar os dados de fluxo no S3. Salvar sua saída de fluxo e conectar-se ao conector S3 são independentes um do outro. Não é possível reutilizar uma conexão S3 existente usada como conexão de entrada do Tableau Prep. O volume total de dados e o número de objetos que você pode armazenar no Amazon S3 são ilimitados. Os objetos individuais do Amazon S3 podem variar em tamanho, de no mínimo 0 bytes a no máximo 5 TB. O maior objeto que pode ser carregado em um único PUT é de 5 GB. Para objetos maiores que 100 MB, os clientes devem considerar o uso do recurso de upload em várias partes. Consulte [Fazendo upload e copiando objetos usando upload de várias partes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html). #### Permissões Para gravar no bucket do Amazon S3, você precisa da região do bucket, do nome do bucket, do ID da chave de acesso e da chave de acesso secreta. Para obter essas chaves, você precisará criar um usuário de gerenciamento de identidade e acesso (IAM) na AWS. Consulte [Gerenciar chaves de acesso para usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html). ### Salvar dados de fluxo no Amazon S3 1. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) em uma etapa e selecione Adicionar saída. 2. Na lista suspensa Salvar saída, selecione **Banco de dados e Armazenamento na nuvem**. 3. Na seção Tabela > Conexão, selecione Amazon S3 (somente saída). 4. No formulário Amazon S3 (somente saída), adicione as seguintes informações: - **ID da chave de acesso**: a ID da chave que você usou para assinar as solicitações enviadas ao Amazon S3. - **Chave de acesso secreta**: credenciais de segurança (senhas, chaves de acesso) usadas para verificar se você tem permissão para acessar o recurso da AWS. - **Região do intervalo**: o local do bucket do Amazon S3 (endpoint da região da AWS). Por exemplo: us-east-2. - **Nome do intervalo**: o nome do bucket S3 em que você deseja gravar a saída do fluxo. Os nomes dos buckets de duas contas da AWS na mesma região não podem ser iguais. **Observação**: para encontrar sua região S3 e o nome do bucket, faça login em sua conta AWS S3 e navegue até o console AWS S3. 5. Clique em Fazer logon. 6. No campo S3 URI, insira o nome do arquivo `.csv` ou `.parquet`. Por padrão, o campo é preenchido com `s3://`. O nome do arquivo deve incluir a extensão `.csv` ou `.parquet.` Você pode salvar a saída do fluxo como um novo objeto S3 ou substituir um objeto S3 existente. - Para um novo objeto S3, digite o nome do arquivo `.parquet` ou `.csv`. O URI é mostrado no texto de visualização. Por exemplo: `s3://`. - Para substituir um objeto S3 existente, digite o nome do arquivo `.parquet` ou `.csv` ou clique em Navegar para encontrar os arquivos S3 existentes `.parquet` ou `.csv`. **Observação**: a janela Procurar objeto mostrará apenas arquivos que foram salvos de logins anteriores no Amazon S3. 7. Para Opções de gravação, um novo objeto S3 é criado com os dados do seu fluxo. Se os dados já existirem, qualquer estrutura de dados ou propriedades existentes definidas para o objeto serão excluídas e substituídas por novos dados de fluxo. Todos os campos existentes no fluxo são adicionados ao novo objeto S3. 8. Clique em Executar para executar o fluxo e gravar seus dados para S3. Você pode verificar se os dados foram salvos no S3 fazendo login em sua conta AWS S3 e navegando até o console AWS S3. ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Sobre o Tableau Prep O Tableau Prep Builder é uma ferramenta no pacote de produtos do Tableau, projetada para facilitar e tornar intuitiva a preparação de dados. Use o Tableau Prep Builder para combinar, formatar e limpar seus dados para análise no Tableau. **Observação**: o Tableau Prep versão 2019.1.2 mudou de nome para Tableau Prep Builder e se refere ao aplicativo do Desktop. A partir da versão 2020.4, como Creator, é possível criar e editar fluxos no [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_web_auth.htm). ## Uso do Tableau Prep Para começar, conecte-se a seus dados a partir de uma variedade de arquivos, servidores ou extrações do Tableau. Conecte-se aos dados e agrupe-os a partir de várias fontes de dados. Arraste e solte ou clique duas vezes para levar suas tabelas ao painel Fluxo, em seguida, adicione etapas de fluxo como filtrar, dividir, renomear, dinamizar, unir colunas e linhas etc. para limpar e formatar seus dados. Cada etapa do processo é representada visualmente em um gráfico de fluxo, que você cria e controla. O Tableau Prep acompanha cada operação para que você possa verificar seu trabalho e fazer alterações no fluxo a qualquer momento. Ao concluir, execute o fluxo para aplicar as operações a todo o conjunto de dados. O Tableau Prep funciona perfeitamente com outros produtos do Tableau. A qualquer momento no fluxo, é possível criar uma extração de dados, publicar a fonte de dados no Tableau Server ou no Tableau Cloud, publicar o fluxo no Tableau Server ou Tableau Cloud para continuar editando na Web ou atualizar os dados usando uma agenda. Você também pode abrir o Tableau Desktop diretamente do Tableau Prep Builder para visualizar seus dados. Para obter informações sobre a instalação do Tableau Prep Builder, consulte [Instalar o Tableau Desktop ou o Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm) no Guia de implantação do Tableau Desktop e do Tableau Prep. Quer experimentar o Tableau Prep com um assistente de IA? A partir da versão 2025.2, você pode usar o Tableau Agent para ajudar a criar cálculos, limpar e transformar seus dados à medida que cria seu fluxo. Para obter mais informações, consulte [Criar fluxos do Tableau Prep com o Tableau Agent](https://help.tableau.com/current/prep/pt-br/prep_einstein.htm). ## Assista a um vídeo: Ver o Tableau Prep Builder em ação Your browser does not support the video tag. Pronto para experimentar? Na página de **Início**, clique em um dos fluxos de amostra para explorar e experimentar as etapas; teste o tutorial prático [Introdução ao Tableau Prep Builder](https://help.tableau.com/current/prep/pt-br/prep_get_started.htm) para saber como criar um fluxo ou acesse um dos nossos [Cenários habituais](https://help.tableau.com/current/prep/pt-br/prep_dayinlife.htm) usando o Tableau Prep Builder. ## ![Fluxos de exemplo na página inicial do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_startpage.png) **Observação**: os arquivos de dados de amostra usados nos fluxos podem ser encontrados nos seguinte locais: - (Windows) `C:\Program Files\Tableau\Tableau Prep Builder \help\Samples\en_US` - (Mac) `` `/Applications/Tableau Prep Builder .app/Contents/help/Samples/en_US` `` Para saber mais sobre como o Tableau Prep Builder otimiza os dados para desempenho, consulte [Tableau Prep aprofundado](https://www.tableau.com/about/blog/2020/5/under-tableau-prep-hood-how-it-helps-you-build-performant-data-prep-flows). Para saber mais sobre o Tableau Prep e os diversos recursos e funções oferecidos, consulte os tópicos neste guia. ## Um tour na área de trabalho do Tableau Prep A área de trabalho do Tableau Prep inclui o painel Conexões (1) onde você se conecta às fontes de dados e a três áreas coordenadas que o ajudam a interagir com os dados e explorá-los: - **Painel Fluxo** (2): uma representação visual das etapas de operação conforme você prepara seus dados. É aqui que você adiciona etapas para construir o fluxo. - **Painel Perfil** (3): um resumo de cada campo em sua amostra de dados. Veja a forma dos seus dados e encontre atípicos e nulos rapidamente. - **Grade de dados** (4): o detalhe de nível de linha de seus dados. ![Partes do workspace do Tableau Prep](/tableau/current/pt-br/prep/pt-br/Img/prep_partsoftheview.png "Área de trabalho do Tableau Prep") Após se conectar aos dados e começar a criação do fluxo, você adiciona etapas ao painel Fluxo. Essas etapas funcionam como uma lente na estrutura dos dados, assim com um resumo das operações aplicadas a eles. Cada etapa representa uma categoria diferente das operações definidas por você, assim como parte do fluxo. Consulte o [Dicionário visual](https://help.tableau.com/current/prep/pt-br/prep_visual_dictionary.htm) para ver as etapas e ícones usados no Tableau Prep. ### Painel Conexões (1) Na parte à esquerda da área de trabalho, o painel Conexões mostra os bancos de dados e arquivos conectados. Adicione conexões a uma ou mais fontes de dados e arraste as tabelas com as quais deseja trabalhar para o painel Fluxo. Para obter mais informações, consulte [Conectar a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm). ![O painel Conexões mostra os bancos de dados e arquivos aos quais o fluxo está conectado.](/tableau/current/pt-br/prep/pt-br/Img/prep_connect2.png) Minimize o painel Conexões se precisar de mais espaço na área de trabalho. ### Painel Fluxo (2) Na parte superior da área de trabalho, está o painel Fluxo. É aqui que você construirá o fluxo. Ao se conectar a, limpar, formatar e agrupar seus dados, as etapas aparecerão no painel Fluxo e se alinharão da esquerda para a direita junto à parte superior. Essas etapas informam que tipo de operação está sendo aplicada, em que ordem e como seus dados são afetados por ela. Por exemplo, as etapas de União de colunas mostram que tipo de união foi aplicado, as cláusulas de união, união recomendada e os campos das tabelas inclusas. ![Um diagrama de fluxo de dados que ilustra o processo de limpeza e combinação de fontes de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_flow.png) Você inicia seu fluxo ao arrastar tabelas para o painel Fluxo. Aqui você pode adicionar conjuntos de dados adicionais, dinamizar seus dados, unir ou juntar dados, criar agregações e gerar sua saída de fluxo para um arquivo (.hyper, .csv, .xlsx), fonte de dados publicada que você pode usar no Tableau, banco de dados ou para o CRM Analytics. Para obter mais informações sobre como gerar dados de saída, consulte [Salvar e compartilhar seu trabalho](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm). **Observação**: no Tableau Desktop, ao fazer alterações nos dados, como renomear campos e alterar tipos de dados, entre outras, elas não serão gravadas no Tableau Prep Builder. ### Painel Perfil (3) Na parte central da área de trabalho, está o painel Perfil. O painel Perfil mostra a estrutura dos dados em qualquer etapa do fluxo. A estrutura dos dados pode ser representada de diferentes maneiras dependendo da operação que deseja executar nos dados ou da etapa selecionada no painel Fluxo. ![Uma sequência de gráficos de barras que mostram detalhes de cada pedido, como ID, data do pedido, região para onde foi enviado etc.](/tableau/current/pt-br/prep/pt-br/Img/prep_profile_pane_view.png) Na parte superior do painel Perfil há uma barra de ferramentas que mostra as operações de limpeza que podem ser executadas em cada etapa do fluxo. Um menu de opções também é exibido em cada cartão do painel Perfil, onde é possível selecionar as diversas operações que podem ser executadas nos dados. Por exemplo: - Pesquisar, classificar e dividir campos - Filtrar, incluir ou excluir valores - Encontrar e corrigir valores nulos - Renomear campos - Limpar erros de entrada de dados usando valores agrupados ou operações rápidas de limpeza - Usar a análise de dados automática para alterar tipos de dados - Reorganizar a ordem das colunas do campo ao arrastar e soltá-las onde desejar ![Arrastando o campo Data de envio para um novo local no painel Perfil do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_drag_move.png) Selecione um ou mais valores de campo em um cartão Perfil e clique com o botão direito do mouse ou clique pressionando a tecla Ctrl (MacOS) para ver opções adicionais para manter ou excluir valores, agrupar valores selecionados ou substituir valores por Nulo. ![Uma tabela de IDs de pedidos com um menu que permite manter apenas, excluir, substituir, agrupar ou desagrupar valores.](/tableau/current/pt-br/prep/pt-br/Img/prep_profilemenu3.png) O Tableau Prep monitora todas as alterações, na ordem em que foram realizadas, para que você possa voltar e consultar ou editá-las, caso necessário. Use a opção de arrastar e soltar para reorganizar as operações listadas de forma a experimentar e aplicar alterações em uma ordem diferente. ![O painel Alterações mostra uma lista de todas as alterações feitas em uma etapa do fluxo do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_changespane.png) Clique na seta da parte superior direita do painel para expandir e recolher o painel **Alterações** e, assim, ter mais espaço para trabalhar com os dados no painel Perfil. Para obter mais informações sobre como aplicar as operações de limpeza no dados, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) ### Grade de dados (4) Na parte inferior da área de trabalho encontra-se a grade de Dados, que mostra o detalhe de nível de linha em seus dados. Os valores exibidos na grade de Dados refletem as operações definidas no painel Perfil. Caso prefira trabalhar em um nível mais detalhado, é possível realizar as mesmas operações de limpeza aqui que as possíveis no painel Perfil. Clique no ícone Recolher perfis ![Ícone do painel Mostrar perfil.](/tableau/current/pt-br/prep/pt-br/Img/prep_showhide_profilepane.png) na barra de ferramentas para recolher (e expandir) o painel Perfil para ver as opções. ![A grade de dados em um fluxo do Tableau Prep mostrando o menu Mais opções.](/tableau/current/pt-br/prep/pt-br/Img/prep_datagrid2.png) ## Como o Tableau Prep armazena seus dados Ao conectar o Tableau Prep aos dados e criar um fluxo, ele armazena os dados usados com frequência em um arquivo .hyper. Em grandes conjunto de dados, isso pode ser uma amostra dos dados. Todos os dados armazenados são salvos em um diretório de arquivo temporário seguro, em um arquivo denominado Prep BuilderXXXXX, onde XXXXX representa um identificador exclusivo universal (UUID). Após salvar o fluxo, o arquivo é excluído. Para obter mais informações sobre as amostras de dados no Tableau Prep, consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#sample). O Tableau Prep Builder também salva os dados no arquivo de fluxo do Tableau (.tfl) para suportar as operações a seguir (que podem capturar valores da dados inseridos): - SQL personalizado usado em etapas de entrada - Filtragem (na entrada de dados) - Agrupar valores (na entrada de dados) - Cálculos [Pular para o conteúdo principal](#main-content) # Solucionar problemas no Tableau Prep Builder Este artigo lista os problemas que pode encontrar ao usar o Tableau Prep Builder, além de sugestões de como solucioná-los. Ao solucionar problemas com seu fluxo, seja para depuração ou para entrar em contato com o suporte, geralmente, você precisará coletar os arquivos de registro e os arquivos de despejo com falhas para análise, bem como documentar as etapas necessárias para reproduzir o erro. Fornecer as etapas exatas que você executou antes que o erro ocorresse, bem como fornecer o arquivo de fluxo, é a melhor maneira de ajudar o desenvolvedor ou a equipe de suporte a diagnosticar o problema. ## Coletando arquivos de log e de despejo com falhas Os arquivos de registro do Tableau Prep são armazenados na pasta Meu repositório do Tableau Prep. Por padrão, o local é: **Windows**: `C:\Users\\Documents\My Tableau Prep Repository\Logs`. **MacOS**: `/users//Documents/My Tableau Prep Repository/Logs` Para diagnosticar corretamente o problema, você precisará coletar todos os arquivos de registro. Se você estiver executando o Tableau Prep Builder, isso é tudo na pasta “My Tableau Prep Repository/Logs”. Se você estiver executando o Tableau Prep a partir da linha de comando, inclua os arquivos de log de “My Tableau Prep Repository/Command Line Repository/Logs”. Essa tabela descreve os diferentes arquivos de log gerados.
Nome do arquivo de logProcesso que gera o arquivo de logDescrição
app.logTableau Prep.exeArquivo de log da interface do usuário. É produzido pelo código JavaScript em execução no processo Electron.
backendProcessManager.logTableau Prep.exeÉ produzido pelo código JavaScript que é iniciado e monitora o processo Java.

preprestapi.log

Java.exe

Este é o arquivo de log produzido pelo código Java. As entradas de registro relacionadas ao uso da API REST, compilação, gerenciamento de cache e inicialização e desligamento do processo tabminerva (anteriormente prepservice) devem estar aqui.

log.txt

prepservice.exe

tabminerva.exe

Esse log é produzido pelo código C++.

Esse registro inclui toda a interação com a pilha de tecnologia compartilhada do Tableau, incluindo conexões a bancos de dados, consultas, execução, cache externo, pipeline de consulta, protocolos e muito mais.

tdeserver.txttdeserver64.exe

Este é o arquivo de log criado pelo antigo Tableau Data Engine. O Tableau Prep ainda usa o Tableau Data Engine.

tabprotosrv.txttabprotosrv.exe

O log do servidor de protocolo. Qualquer coisa em que você use um driver de banco de dados hospedado produzirá linhas de log nesse arquivo.

hyperd.loghyperd.exe

O log hyper. Consultas e erros relacionados a consultas estão aqui.

### Habilitar o log de consultas A partir do Tableau Prep Builder versão 2026.2, você pode ativar a configuração Habilitar registro de consultas no menu Configurações e desempenho do > Ajuda sem precisar reiniciar o aplicativo. Quando ativada, essa configuração gera um arquivo de consulta XML para cada consulta executada pelo Tableau Prep Builder. Isso pode ser útil ao diagnosticar problemas com seu fluxo. Os logs são gerados e armazenados na pasta Consulta. ![Menu Ajuda no Tableau Prep mostrando opções de menu Configuração e desempenho.](/tableau/current/pt-br/prep/pt-br/Img/prep_enable_query_logging.png) Você pode encontrar esses registros de consulta nos seguintes diretórios: **Windows**: `C:\Users\\Documents\My Tableau Prep Repository\Query` **MacOS**: `/users//Documents/My Tableau Prep Repository/Query` ### Executar o LogShark LogShark é um utilitário de linha de comando de código aberto gratuito que você pode usar para extrair informações de arquivos de log do Prep para solucionar problemas e obter informações sobre erros e uso. Usando o plugin do `Prep.twbx` LogShark, você pode gerar pastas de trabalho com um painel de erro e fluxo para ajudar a analisar e visualizar problemas de preparação. Para obter informações sobre como instalar e executar o LogShark, consulte [Configure seu computador para o LogShark](https://tableau.github.io/Logshark/docs/logshark_prefunc). ### Criar arquivos de despejo de falhas Além dos arquivos de log, você também deseja coletar arquivos de despejo de falha. Tudo o que não estiver nos arquivos de log pode ser detalhado aqui e pode ajudar na solução de problemas de inicialização do aplicativo, exceções ou problemas ao consultar o .hyper. Ao criar arquivos de despejo de falha, é útil criá-los para os processos a seguir.
ProcessoDescrição
tabminerva.exe (anteriormente prepservice.exe)Esse é o processo nativo que hospeda o restante da lógica de negócios do Tableau Prep. Também é o processo que contém a tecnologia nativa compartilhada do Tableau, incluindo conectores de banco de dados.
hyperd.exeEste é o processo de banco de dados hyper. Sempre que uma consulta falhar. Os despejos de falha do hyper podem ser úteis quando ocorre uma falha porque grande parte do que o Tableau Prep faz envolve consultas ao hyper.
Para criar arquivos de despejo com falhas, faça o seguinte, dependendo do seu sistema operacional. #### Windows 1. Abrir o Gerenciador de tarefas. 2. Clique com o botão direito do mouse no cabeçalho da coluna e selecione Nome do processo e Linha de comando. Isso mostra os diferentes processos e permite que você selecione aquele que deseja usar para criar um arquivo de despejo com falhas. 3. Clique com o botão direito do mouse no processo tabminerva.exe (anteriormente prepservice.exe). 4. Selecione Criar arquivo de despejo. Uma caixa de diálogo será aberta e mostrará a localização do arquivo de despejo com falhas em seu sistema. #### MacOS No MacOS, há dois tipos de arquivos de diagnóstico úteis para solucionar problemas do Tableau Prep: - Relatório de falhas — registra a pilha de chamadas no momento da falha, semelhante a um rastreamento de pilha. - Arquivo principal — um instantâneo completo da memória do processo no momento do fechamento. Ambos exigem o encerramento do processo do Tableau Prep. Você precisará reiniciar o Tableau Prep após coletar esses arquivos. **Pré-requisito**: é preciso ter acesso de administrador para a coleta de arquivos principais. **Etapa 1**: criar um relatório de falhas 1. Abra o Terminal. 2. Execute o comando: `pgrep tabminerva | xargs kill -SEGV` Isso encerra o processo tabminerva.exe enviando um sinal de falha de segmentação, o que faz com que o MacOS gere um relatório de falha automaticamente. 3. Encontre o relatório de falhas salvo em: `~/Library/Logs/DiagnosticReports/` O nome do arquivo segue o formato tabminerva\_YYYY-MM-DD-HHMMSS\_machinename.crash ou tabminerva\_YYYY-MM-DD-HHMMSS\_machinename.ips Ao enviar esse arquivo para o suporte ou para a equipe de desenvolvimento do Tableau, certifique-se de declarar que você enviou intencionalmente um sinal de falha de segmentação para gerar o relatório. Isso o distingue de uma falha genuína. **Etapa 2**: criar um arquivo principal Utilize uma das seguintes opções para criar seu arquivo principal. **Criar um arquivo principal e encerrar a sessão do Tableau Prep** 1. Abra o Terminal. 2. Execute o comando `sudo chmod 1777 /cores` para conceder acesso de gravação ao diretório do arquivo principal. 3. Execute o comando `ulimit -c unlimited` para remover o limite no tamanho do arquivo principal para a sessão atual do terminal. 4. Execute o comando `pgrep tabminerva | xargs kill -SEGV` para encerrar o processo e gerar o arquivo principal. 5. Localize o arquivo principal em `/cores/` com o nome `core.`. **Criar um arquivo principal e mantenha o Tableau Prep em execução** Essa opção usa um utilitário gcore para capturar um despejo central de um processo em execução sem encerrá-lo. Esse processo requer que a ferramenta de linha de comando Xcode seja instalada. Para verificar se você tem essa opção instalada, abra o Terminal e execute `Bash xcode-select --install`. 1. Abra o Terminal. 2. Execute o comando: `sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)` Isso salva o arquivo principal em `/tmp/tabminerva.core`. O Tableau Prep continua funcionando normalmente. ## Erros comuns ao usar a linha de comando para executar fluxos É possível executar fluxos a partir da linha de comando para atualizar os arquivos de saída em vez de abrir o Tableau Prep Builder para executar cada fluxo manualmente. Embora este processo ajude a criar eficiência no processo do fluxo, se a sintaxe estiver incorreta ou você não tiver as credenciais das conexões ou das localizações de saída, você encontrará erros ao executar este processo. Para obter uma lista de todas as opções de linha de comando com suporte no Tableau Prep, consulte [Referência de linha de comando do Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_command_line_reference.htm). A seguinte tabela descreve os erros comuns e como resolvê-los. Para obter informações sobre como executar fluxos a partir da linha de comando, consulte [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm).
ErroCausaComo corrigir
"Missing arguments” ("Faltam argumentos”)Um dos argumentos de linha de comando exigidos está faltando.Use o comando “tableau-prep-cli -help” para visualizar uma lista de argumentos para a linha de comando.
"Unable to read the connections file.” ("Não foi possível ler o arquivo de conexões”)Há erros na sintaxe ou no formato do arquivo credentials.json nas conexões de entrada.Verifique a sintaxe das conexões de entrada no arquivo .json. Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando.

"There are errors in the flow. Unable to run the flow.

Check that the credentials .json file includes all required credentials. Open the flow in Tableau Prep Builder to view error details.”

Faltam credenciais no arquivo credentials.json para as conexões de entrada ou o fluxo contém erros.

Verifique se o arquivo .json tem as credenciais para todas as conexões e abra o arquivo do fluxo no Tableau Prep Builder para visualizar se há algum erro no fluxo.

Se o fluxo tem erros, será necessário corrigi-los e publicar o fluxo novamente no Tableau Server, depois tente executar o processo novamente.

"Could not find match for <hostname of inputConnections >” ("Não foi possível uma correspondência para <hostname of inputConnections>”)Falta uma entrada para o nome de host (nome do servidor) no arquivo credentials.json.

Garanta que o arquivo credentials.json inclua as credenciais corretas para o nome de host (nome do servidor).

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"We don't have credentials of all connections in tfl/tflx file. The following connection(s) were not found: <hostname of inputConnections>” ("Não existem credenciais para todas as conexões no arquivo tfl/tflx. As seguintes conexões não foram encontradas: <hostname of inputConnections>”)Faltam credenciais no arquivo credentials.json ou elas estão incorretas para o nome de host (nome do servidor) mostrado na mensagem de erro.

Garanta que o arquivo credentials.json inclua as credenciais corretas para o nome de host (nome do servidor) listado na mensagem de erro.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando.

"Error signing in server <serverUrl> as a user <userName>. Please check the credentials.” ("Erro ao fazer logon no servidor <serverUrl> como o usuário <userName>. Verifique as credenciais.”)O arquivo credentials.json tem as credenciais incorretas para o Tableau Server.

Garanta que o arquivo credentials.json inclua todas as credenciais e elementos corretos para a conexão de saída.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"Could not sign in successfully as <userName> to server <serverUrl>(<contentUrl>)” ("Não foi possível fazer logon com sucesso como <userName> no servidor <serverUrl>(<contentUrl>)”)O arquivo credentials.json tem as credenciais incorretas para o Tableau Server.

Garanta que o arquivo credentials.json inclua todas as credenciais e elementos corretos para a conexão de saída.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"We don't have credentials for Tableau Server to publish extract for one or more output nodes in tfl/tflx file.” ("Não temos as credenciais do Tableau Server para publicar a extração de um ou mais nós de saída no arquivo tfl/tflx.”)O arquivo credentials.json não foi passado como argumento na linha de comando ou faltam as credenciais da conexão de saída.

Garanta que o caminho para o arquivo credentials.json esteja incluído na linha de comando e verifique se ele inclui todas as credenciais e elementos corretos para a conexão de saída.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"Loom rest api server not started” ("O próximo servidor da API REST não iniciou.”)A configuração da instalação ou do ambiente está incorreta.

Garanta que o Tableau Prep Builder esteja instalado corretamente e que você esteja executando o comando como Administrador.

Para obter informações sobre como instalar o Tableau Prep Builder, consulte Instalar o Tableau Desktop ou o Tableau Prep Builder usando a interface do usuário.

"Error. Flow file does not exist.” ("Erro. O arquivo de fluxo não existe.”)O caminho para o arquivo de fluxo está incorreto.Garanta que o caminho correto para o arquivo de fluxo esteja incluído na linha de comando.
"Error. Connections file does not exist.” ("Erro. O arquivo de conexões não existe.”)O caminho para o arquivo credentials.json está incorreto.Verifique se o caminho correto para o arquivo credentials.json está incluído na linha de comando.
“Não foi possível encontrar correspondência para <mapr01:5181>,<mapr02:5181>,<mapr03:5181>”Você deve especificar uma ID de porta específica ao conectar a Apache Drill usando ZooKeeper.Inclua um arquivo credentials.json na linha de comando que especifique a "porta": 31010 para as credenciais de entrada.
## Erros comuns do Tableau Prep A tabela a seguir descreve alguns erros comuns que você pode encontrar ao usar o Tableau Prep juntamente com soluções para testar.
ErroCausaComo corrigirArtigo de conhecimento
Não foi posspível se conectar ao Tableau Server. Verifique se o servidor está em execução e se a URL está correta. tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationExceptionUm proxy ou firewall está impedindo que o navegador incorporado do Tableau Prep Builder conclua o handshake de logon do Tableau Cloud.

Trabalhe com o setor de TI para usar URLs do Tableau Cloud na lista de permissões por meio do proxy.

Saia e entre novamente no Tableau Prep Builder.

Se um script de configuração de proxy automático estiver em vigor, verifique se ele manipula a autenticação sem solicitar credenciais.

Não é possível fazer logon no Tableau Online via Tableau Prep Builder em um ambiente de proxy necessário para autenticação

O certificado SSL necessário pode estar ausente ou não corresponder ao certificado do Tableau Server para [serverhostname].

Também visto como “Não foi possível localizar o caminho de certificado solicitado para a ID de fluxo” ao executar fluxos no servidor.

Arquivo de cadeia de certificados SSL ausente no Tableau Server ou o arquivo de cadeia não está instalado na máquina que executa o Tableau Prep Builder. Em alguns casos, o problema é causado por um balanceador de carga AWS usando uma política TLS incompatível.

Certifique-se de que o arquivo da cadeia de certificados SSL esteja carregado no Tableau Server.

Instale o certificado na máquina que executa o Prep Builder (se clicar duas vezes e selecionar “Instalar certificado”, retorna “O arquivo é inválido para uso como o seguinte: Certificado de segurança”, o próprio arquivo de certificado pode estar malformado. Trabalhe com o setor de TI para exportar um arquivo de cadeia válido.

Se estiver com um balanceador de carga AWS desatualizado, faça o downgrade da política para ELBSecurityPolicy-TLS-1-2-2017-01.

Erro - O certificado SSL necessário pode estar ausente ou não corresponder ao certificado do Tableau Server - Fazer logon por meio do Tableau Prep

O Tableau Prep Builder parou de executar porque um processo subjacente parou inesperadamente. Se o problema continuar, tente reinstalar o produto.

Isso pode ser desencadeado por vários fatores: configuração de VPN/rede (confirmada com o bloqueio da comunicação localhost da Cato Network VPN), interferência antivírus ou um arquivo de porta corrompido ao abrir um arquivo .tfl específico.

Observação: o Tableau Prep Builder nunca deve ser instalado em um nó do Tableau Server. Essa é uma causa conhecida deste erro.

Reinstalar, verificar exclusões de AV, verificar a comunicação IPv4/IPv6 com localhost

Se for específico de VPN, teste com uma VPN alternativa para isolar; fale com a equipe de rede para verificar se há blocos do localhost

Se vinculado a um arquivo .tfl específico, colete logs do Prep e despejos de IPS para investigar falhas no processo tabminerva

Verifique se o Tableau Prep Builder não está instalado em algum nó do Tableau Server.

Erro: o Tableau Prep parou de executar porque um processo subjacente parou inesperadamente ao iniciar o Tableau Prep
Falha na avaliação do processador Aql: “Cancelado” — falha no fluxo após uma etapa de dinamizaçãoProblema conhecido ao alterar o valor de uma coluna dinamizada após a etapa de dinamização.

Nota: esta correção aplica-se às versões 2022.2 e posteriores.

Atualize para uma versão inclusa nessa correção.

Como solução alternativa em versões mais antigas, evite modificar valores de coluna dinamizados nas etapas posteriores à dinamização.

Erro: erro do sistema - Erro na comunicação com a fonte de dados (LoomDataSource) ao alterar o valor de uma coluna dinamizada após a etapa de dinamização
Esse fluxo precisa de mais memória do que a alocada atualmente para executar essa ação. Considere filtrar seus dados ou dividir o fluxo em partes menores.O tamanho ou a complexidade do fluxo precisa de mais memória do que a disponível para concluir a tarefa de fluxo no Tableau Cloud.

Simplifique o fluxo. Tente remover campos não utilizados, aplicar filtros, mover filtros ou agregações antes de uma união para recolher na tabela.

Tente dividir o fluxo em fluxos menores, usando as saídas de fluxo como uma entrada para um fluxo final.

Para obter mais ideias, consulte Práticas recomendadas para melhorar o desempenho dos seus fluxos de preparação de dados.

Erro “Não é possível alocar ##### bytes de memória: o limite de memória global de ##### bytes foi excedido” ao tentar executar um fluxo
Não é possível publicar a fonte de dados” — o fluxo é executado com êxito localmente ou ao gerar para um arquivo .hyper, mas falha ao publicar no Tableau Cloud.O fluxo falha devido ao tamanho do arquivo temporário exceder os limites do Tableau Cloud. Também observado quando um fluxo falha com erros de SQL relacionados à memória (por exemplo, grandes operações JOIN) que só aparecem no Tableau Cloud, não localmente.

Alterne a saída para um arquivo .hyper local para confirmar se o problema é específico da nuvem.

Reduza a complexidade do fluxo, entre em fluxos menores, remova colunas não utilizadas ou use conexões em tempo real.

N/A
O Prep Builder não abre no Windows; os logs de depuração mostram um erro relacionado a um caminho relativo da pasta temporária.

A variável de ambiente Windows TEMP é definida como um caminho relativo (por exemplo, %USERPROFILE%\AppData\Local\Temp) ou contém uma entrada de caminho duplicada.

O Tableau Prep Builder exige um caminho absoluto.

Verifique se a variável de ambiente Windows TEMP está definida como um caminho absoluto (por exemplo, C:\Users[username]\AppData\Local\Temp)

Remove quaisquer entradas duplicadas da variável TEMP.

N/A
## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Tableau Prep na Web _O Internet Explorer 11 no Windows e o modo de compatibilidade para o Internet Explorer não são aceitos._ A partir da versão 2020.4, o Tableau Prep oferece suporte à criação na Web para fluxos. Agora você pode criar fluxos para limpar e preparar seus dados usando Tableau Prep Builder, Tableau Server, ou Tableau Cloud. Você também pode executar fluxos manualmente na Web e o Data Management não é necessário. Embora a maior parte da mesma funcionalidade do Tableau Prep Builder também seja compatível com a Web, existem algumas diferenças ao criar e trabalhar com os fluxos. > [!IMPORTANT] > > **Importante**: para criar e editar fluxos na Web, você deve ter uma licença de Creator. O Data Management só será necessário se você quiser executar os fluxos de acordo com a agenda, usando o Tableau Prep Conductor ou via API. Para obter informações sobre como configurar e usar o Tableau Prep Conductor, consulte o Tableau Prep Conductor na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm). ## Instalação e implantação Para permitir que os usuários criem e editem fluxos na Web, você precisará fazer várias configurações no servidor. Para obter mais informações sobre cada uma dessas configurações, consulte [Criar e interagir com fluxos na Web](https://help.tableau.com/current/server/pt-br/web_author_flows.htm). - **Criação na Web**: ativada por padrão, esta opção controla se os usuários podem criar e editar fluxos em Tableau Server ou Tableau Cloud - **Executar agora**: controla se os usuários ou apenas os administradores podem executar fluxos manualmente, usando a opção Executar agora. O Data Management não é necessário para executar fluxos manualmente na Web. - **Tableau Prep Conductor**: se Data Management tiver licença, ative essa opção para permitir que os usuários agendem e rastreiem os fluxos. - **Tableau Prep Extensions** (versão 2021.2.0 e posterior): controla se os usuários podem se conectar ao Einstein Discovery para aplicar e executar modelos preditivos em relação aos dados em seu fluxo. - **Salvamento automático**: ativado por padrão, esse recurso salva automaticamente o fluxo de trabalho de um usuário em um intervalo de poucos segundos. ### Dados de amostra e limites de processamento Para manter o desempenho enquanto trabalha com fluxos na Web, os limites são aplicados ao volume de dados que você pode incluir em um fluxo. Aplicam-se os seguintes limites: - O tamanho máximo do arquivo é de 1GB ao se conectar aos arquivos. - A opção de amostragem de dados para incluir todos os dados não está disponível. O limite padrão de dados da amostra é de 1 milhão de linhas. O administrador do Tableau Server pode definir o limite de amostra de dados usando TSM. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#maestroappsettingssamplingmaxrowlimit). No Tableau Cloud, esse limite é fixo e não pode ser definido pelo administrador. Para obter mais informações sobre como definir a amostra de dados, consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#set-your-data-sample-size) na ajuda do Tableau Prep. Precisa de ajuda para depurar um fluxo lento? Tente ativar Habilitar log de consulta no menu Ajuda\>Configurações e desempenho. Para obter mais informações, consulte [Habilitar log de consulta](https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm#enable-query-logging). ## Recursos disponíveis na Web Quando você cria e edita fluxos na Web, pode perceber algumas diferenças na navegação e na disponibilidade de determinados recursos. Embora a maioria dos recursos esteja disponível em todas as plataformas, alguns recursos são limitados ou ainda não são compatíveis com o Tableau Server ou o Tableau Cloud. A tabela a seguir identifica os recursos em que as diferenças podem ser aplicadas.
Área de recursosExceçõesTableau Prep BuilderTableau ServerTableau Cloud
Conectar a dadosAlguns conectores podem não ser compatíveis com a Web. Abra o painel Conectar no servidor para ver os conectores compatíveis.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Criar fluxos do Tableau Prep com o Tableau Agent

A partir da versão 2025.2, com suporte no Tableau Cloud (requer Tableau+) e no Tableau Prep Builder quando conectado ao Tableau Cloud com o Tableau Agent ativado.

A partir da versão 2025.3, com suporte no Tableau Server e Tableau Prep Builder quando conectado ao Tableau Server com o Tableau Agent ativado.

Para obter mais informações, consulte Ativar IA no seu site do Tableau Cloud e Ativar IA no seu site do Tableau Server.

Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Criar e organizar o fluxo Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Definir o tamanho da amostra de dadosNo Tableau Server, o tamanho dos dados de amostra está sujeito aos limites definidos pelo administrador usando um comando do TSM. No Tableau Cloud, esse limite é fixado em 1.048.576 linhas e não pode ser alterado pelo administrador.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Unir linhas de arquivos e tabelas de banco de dada na etapa de entradaAs uniões de linhas de entrada não podem ser editadas ou criadas no Tableau Server ou no Tableau Cloud. Somente no Tableau Prep Builder.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Limpar e formatar dados Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Copiar valores da grade de dadosDisponível no Tableau Prep Builder e no Tableau Server a partir da versão 2022.3 e no Tableau Cloud a partir de 2022.2 (agosto)Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Agregar, unir colunas ou linhas de dados Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Usar scripts R e Python no fluxoAs etapas de script não podem ser adicionadas ao criar ou editar um fluxo no Tableau Cloud. No momento, esse recurso é compatível somente com o Tableau Prep Builder e com o Tableau Server.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo vermelho com uma linha diagonal atravessando-o.
Criar etapas de fluxos reutilizáveis Um círculo verde com uma marca de seleção branca.Um círculo vermelho com uma linha diagonal atravessando-o.Um círculo vermelho com uma linha diagonal atravessando-o.
Salvar os fluxos automaticamente na Web Não aplicávelUm círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Recuperação automática de arquivos Um círculo verde com uma marca de seleção branca.Não aplicávelNão aplicável
Habilitar o log de consultas Um círculo verde com uma marca de seleção branca.Um círculo vermelho com uma linha diagonal atravessando-o.Um círculo vermelho com uma linha diagonal atravessando-o.
Exibir saída de fluxo no Tableau Desktop Um círculo verde com uma marca de seleção branca.Um círculo vermelho com uma linha diagonal atravessando-o.Um círculo vermelho com uma linha diagonal atravessando-o.
Criar uma extração para um arquivo Um círculo verde com uma marca de seleção branca.Um círculo vermelho com uma linha diagonal atravessando-o.Um círculo vermelho com uma linha diagonal atravessando-o.
Criar uma extração para uma planilha do Microsoft Excel Um círculo verde com uma marca de seleção branca.Um círculo vermelho com uma linha diagonal atravessando-o.Um círculo vermelho com uma linha diagonal atravessando-o.
Conectar a uma consulta de SQL personalizado Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Criar uma fonte de dados publicada Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Salvar saída de fluxo em bancos de dados externos Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
Adicionar previsões do Einstein Discovery ao seu fluxo Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.Um círculo verde com uma marca de seleção branca.
### Salvamento automático e como trabalhar com rascunhos Quando você cria ou edita fluxos no servidor, o trabalho é salvo automaticamente como rascunho em um intervalo de poucos segundos para que você não perca o trabalho, em caso de acidente ou se uma guia for fechada por acidente. Os rascunhos são salvos no servidor e no projeto em que você está conectado. Você não pode salvar ou publicar um rascunho em outro servidor, mas pode salvar o fluxo em outro projeto desse servidor, usando a opção do menu Arquivo > Publicar como. ![Um fluxo de preparação de dados com dados de amostra, nomes de campos e valores de campos.](/tableau/current/pt-br/prep/pt-br/Img/prep_save_draft1.png) Só você pode ver o conteúdo do rascunho até a publicação. Se você publicar alterações e precisar revertê-las, pode usar a caixa de diálogo Histórico de revisões para exibir e reverter para uma versão publicada anteriormente. Para obter mais informações sobre como salvar fluxos na Web, consulte [Salvar os fluxos automaticamente na Web](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#automatically-save-your-flows-on-the-web). ## Fluxos de publicação na Web Se você criar um fluxo do zero na Web ou editar um fluxo existente, antes de executar o fluxo, é necessário publicá-lo. - Você só pode publicar fluxos de rascunho no mesmo servidor em que está conectado. - Você pode publicar um rascunho em um projeto diferente usando o menu Arquivo e selecionando Publicar como. - Você pode inserir credenciais para as conexões de banco de dados do fluxo, a fim de permitir que o fluxo seja executado sem inserir manualmente as credenciais quando o fluxo for executado. Se você abrir o fluxo para editá-lo, precisará inserir novamente suas credenciais. ### Inserir credenciais As credenciais inseridas só se aplicam à execução de fluxos no servidor. A partir do Tableau Cloud versão 2025.2, os proprietários de fluxo podem editar seu fluxo na criação na Web sem precisar autenticar novamente em todas as conexões de banco de dados, se essas conexões forem inseridas no fluxo ou salvas no perfil do usuário. Se estiver usando o Tableau Server, é necessário inserir as credenciais manualmente ao editar um fluxo conectado a um banco de dados. As credenciais inseridas só podem ser definidas no nível de fluxo e não no nível do servidor ou do site. Execute um destes procedimentos: - No menu superior, selecione Arquivo > Credenciais de conexão > Inserir no fluxo publicado. ![O menu Arquivo mostra o submenu de Credenciais de conexão, Incorporar no fluxo publicado, para incorporar suas credenciais de conexão de dados em um fluxo quando ele é publicado.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_credentials.png) - Ao publicar um fluxo, selecione a caixa de seleção Inserir credenciais. Essa opção é mostrada quando você seleciona Publicar como para publicar o fluxo em um novo projeto pela primeira vez ou quando você está editando um fluxo que foi publicado pela última vez por outra pessoa. ![A caixa de diálogo Publicar fluxo como com campos para nomear e publicar um fluxo, com opções para projeto e credenciais de incorporação.](/tableau/current/pt-br/prep/pt-br/Img/prep_embed_credentials_prompt.png) ### Publicar um fluxo Quando você publica o fluxo, ele se torna a versão atual do fluxo e pode ser executado e visto por outros usuários com acesso ao projeto. Só você pode ver os fluxos que nunca foram publicados ou as alterações de fluxo que você faz em um rascunho, até que você publique o fluxo. Para obter mais informações sobre os status de fluxos na Web, consulte [Salvar os fluxos automaticamente na Web](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#automatically-save-your-flows-on-the-web). Para publicar o fluxo, siga um destes procedimentos: - No menu superior, selecione Arquivo > Publicar ou Arquivar > Publicar como ![O menu Arquivo na Web destacando a opção Publicar para publicar um fluxo.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_publish_menu.png) - Na barra superior, clique no botão Publicar ou clique na seta suspensa para selecionar Publicar como. ![A barra superior de um fluxo do Tableau Prep na Web mostrando os botões Publicar e Publicar como.](/tableau/current/pt-br/prep/pt-br/Img/prep_pwa_publish.png) ### Quem pode fazer isso - Administrador do servidor, Creator (administrador de site) e Creator (Criador) têm acesso total de conexão e publicação. - O Creator pode realizar as tarefas de criação na Web. [Pular para o conteúdo principal](#main-content) # Usar funções de dados para validar seus dados **Observação**: os proprietários das fontes de dados e os administradores do Tableau podem adicionar sinônimos dos nomes e valores de campo de dados específicos para o Pergunte aos dados. Para obter informações sobre o uso das funções de dados do Pergunte aos dados, consulte [Adicionar sinônimos para o Pergunte aos dados](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_synonyms.htm) na ajuda do Tableau Desktop. > [!WARNING] > > **Observação**: o recurso Pergunte aos dados do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Use funções de dados para identificar rapidamente se os valores em um campo são válidos ou não. O Tableau Prep oferece um conjunto padrão de funções de dados que você pode selecionar ou criar usando os valores de campo exclusivos no seu conjunto de dados. Quando você atribui uma função de dados, o Tableau Prep compara os valores padrão definidos para a função de dados com os valores em seu campo. Qualquer valor não correspondente é marcados com um ponto de exclamação vermelho. Você pode filtrar seu campo para visualizar somente os valores válidos ou inválidos e tomar as medidas apropriadas para corrigi-los. Depois de atribuir uma função de dados aos campos, você pode usar a opção Agrupar valores para agrupar e corresponder os valores inválidos aos válidos com base na ortografia e na pronúncia. **Observação**: a partir da versão 2020.4.1, é possível criar e editar fluxos no Tableau Server e Tableau Cloud. O conteúdo deste tópico se aplica a todas as plataformas, salvo observação específica. Para obter mais informações sobre os fluxos de criação na Web, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm) na ajuda do Tableau Server. ## Atribuir funções de dados padrão a seus dados Atribua funções de dados fornecidas pelo Tableau Prep ao seu campo da mesma maneira que você atribui um tipo de dados. A função de dados identifica o que os seus valores de dados representam, para que o Tableau Prep possa validar automaticamente os valores e destacar aqueles que não sejam válidos para aquela função. ![Campos sem uma função de dados aplicada.](/tableau/current/pt-br/prep/pt-br/Img/prep_roles3.png) Por exemplo, se você tiver valores de campo para dados geográficos, é possível atribuir uma função de dados Cidade e o Tableau Prep compara os valores no campo com um conjunto de valores de domínio conhecidos para identificar os valores sem correspondência. **Observação**: cada campo é analisado de maneira independente para que um valor de Cidade como "Portland" no Estado de "Washington" no País "EUA" não possa ser uma combinação válida de cidade e estado, mas ele não será identificado dessa maneira porque é um nome de cidade válido. O Tableau Prep Builder oferece suporte às seguintes funções de dados: - E-mail - URL - Funções geográficas (baseadas nos dados geográficos atuais e são os mesmos dados usados pelo Tableau Desktop) - Aeroporto - Código de área (EUA) - CBSA/MSA - Cidade - Distrito congressional (EUA) - País/região - Município - NUTS Europa - Estado/Província - CEP/Código postal > [!TIP] > > **Dica**: no Tableau Prep Builder versão 2019.1.4 e posteriores e na Web, se você atribuir uma função geográfica a um campo, também poderá usar essa função de dados para correspondência, além de agrupar valores com o valor padrão definido por ela. Para obter mais informações sobre o agrupamento de valores usando funções de dados, consulte [Limpar e formatar dados](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Group_datarole). Para atribuir uma função de dados para um campo, realize as ações a seguir: 1. No painel Perfil ou Resultados, ou na grade de dados, clique no tipo de dados do campo. 2. Selecione a função de dados para o campo. ![O menu de função Dados e o submenu geográfico.](/tableau/current/pt-br/prep/pt-br/Img/prep_datarolemenu.png) O Tableau Prep compara os valores de dados do campo com valores ou padrões de domínio conhecidos (para e-mail ou URL) para a função de dados selecionada e marca qualquer valor sem correspondência com um ponto de exclamação vermelho. 3. Clique na seta suspensa do campo e na seção Mostrar valores selecione uma opção para mostrar todos os valores ou somente valores válidos ou não válidos para a função de dados.
O menu Mais opções mostra apenas funções de dados válidas ou inválidas.Preparar dados sem uma função de dados válida aplicada.
4. Use as opções de limpeza no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) para corrigir qualquer valor inválido. Para obter mais informações sobre como limpar valores dos campos, consulte [Sobre as operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Edit). ## Criar funções de dados personalizadas > [!WARNING] > > **Importante**: as funções de dados personalizadas serão descontinuadas no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. A partir do Tableau Prep Builder versão 2019.3.1 e na Web, você pode criar suas próprias funções de dados personalizadas usando os valores de campo em seus conjuntos de dados, para criar um conjunto padrão de valores que você ou outras pessoas podem usar para validar os campos ao limpar dados. Selecione o campo que deseja usar, aplique qualquer operação de limpeza a ele se necessário, publique-o no Tableau Server ou Tableau Cloud para usar o seu fluxo ou compartilhe suas funções de dados com outras pessoas. Se criar funções de dados personalizadas ao editar fluxos na Web, você pode publicar a função de dados personalizada diretamente no servidor em que está conectado. ### Requisitos - Você pode criar funções de dados personalizadas em campos únicos no seu conjunto de dados. A criação de funções de dados personalizadas de uma combinação de campos não é compatível. - A publicação de funções de dados em projetos com permissões bloqueadas não é compatível. - Você pode criar funções de dados personalizadas somente para campos atribuídos a um tipo de dados de Cadeia de caracteres e Número (inteiro). - Quando você cria uma função de dados personalizada, o Tableau Prep cria uma etapa de saída no fluxo específico da publicação da função de dados. - Não há suporte para a publicação de funções de dados personalizadas em vários sites no mesmo fluxo. Se você publicar o fluxo, deverá publicar a função de dados personalizada no mesmo site ou servidor no qual o fluxo será publicado. - As funções de dados personalizadas são específicas para o site, servidor e projeto em que você as publica. Todos os usuários com permissões para o local podem usar a função de dados personalizada, mas devem entrar no site ou servidor para selecioná-la ou aplicá-la. Funções de dados personalizadas são atribuídas à permissão padrão do grupo Todos os usuários para novos projetos em vez de Nenhum. - As funções de dados personalizadas não são específicas à versão. Ao aplicar uma função de dados personalizada, a versão mais atual é aplicada. - Depois de publicada no usuário do Tableau Server ou Tableau Cloud com acesso ao site, o servidor e o projeto podem exibir todas as funções de dados nesse local. - Os usuários com permissões apropriadas podem mover, excluir ou editar permissões para as funções de dados. - As permissões que você pode definir e ações que podem ser executadas em uma função de dados personalizada são semelhantes ao que você pode fazer com um fluxo. Para obter mais informações, consulte [Gerenciar um fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_manage_flow.htm) e [Recursos de permissão](https://help.tableau.com/current/server/pt-br/permissions.htm#permission-capabilities) na ajuda do Tableau Server. - Para editar uma função de dados, você deve fazer as alterações no Tableau Prep Builder ou no fluxo na Web e, em seguida, publicar a função de dados novamente usando o mesmo nome para substituí-la. Esse processo é semelhante à edição de uma fonte de dados publicada. ### Criar uma função de dados personalizada 1. No painel Perfil ou Resultados, ou na grade de dados, selecione o campo que deseja usar para criar uma função de dados personalizada. 2. Clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) para o campo e selecione Publicar como função de dados. ![Um cartão de Perfil em um fluxo do Tableau Prep mostrando o menu Mais opções com a opção Publicar como função de dados destacada.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_data_role.png) 3. Selecione o servidor e o projeto no qual deseja publicar a fonte de dados. ![Painel de saída do fluxo do Tableau Prep, em que você seleciona o servidor e o projeto em que deseja publicar a função de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_data_role3.png) 4. Clique em Executar fluxo para criar a função de dados. Depois que o processo de publicação for concluído com êxito, você poderá exibir a função de dados no Tableau Server ou Tableau Cloud. O processamento da função de dados pode levar algum tempo, de acordo com a carga no site do Tableau Server ou Tableau Cloud. Se a sua função de dados não estiver disponível imediatamente, aguarde alguns minutos e tente selecioná-la novamente. ![Uma função de dados personalizada para materiais de tijolos mostrando os valores incluídos na definição da função de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_data_role_server2.png) ### Aplicar uma função de dados personalizada 1. No painel Perfil ou Resultados, ou na grade de dados, clique no tipo de dados do campo em que deseja aplicar a função de dados personalizada. 2. Selecione Personalizar e a função de dados que deseja aplicar ao campo. > [!IMPORTANT] > > **Importante**: no Tableau Prep Builder, verifique se você entrou no site ou servidor em que a função de dados foi publicada ou você não verá essa opção. ![Um menu suspenso mostrando tipos de dados, funções de dados e um dicionário abrangente de materiais do Brick com 11 valores.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_data_role2.png) O Tableau Prep compara os valores de dados do campo a valores de domínio conhecidos para a função de dados selecionada e marca qualquer valor sem correspondência com um ponto de exclamação vermelho. ![Um cartão de Perfil em um fluxo do Tableau Prep mostrando um ponto de exclamação vermelho ao lado de valores inválidos para uma função de dados atribuída.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_data_role_invalid.png) 3. Clique na seta suspensa do campo e na seção Mostrar valores selecione uma opção para mostrar todos os valores ou somente valores válidos ou não válidos para a função de dados. ![Um cartão de Perfil em um fluxo do Tableau Prep mostrando a opção de menu Não válido selecionada para mostrar apenas valores que não são válidos para a função de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_custom_data_role_invalid2.png) 4. Use as opções de limpeza no menu Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) para corrigir qualquer valor inválido. Para obter mais informações sobre como limpar valores dos campos, consulte [Sobre as operações de limpeza](https://help.tableau.com/current/prep/pt-br/prep_clean.htm#Edit). ### Exibir e gerenciar funções de dados personalizadas É possível exibir e gerenciar as funções de dados personalizadas publicadas no Tableau Server e no Tableau Cloud. Você pode visualizar todas as funções de dados personalizadas publicadas no site ou servidor. Clique em Mais ações ![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png) para obter uma função de dados selecionada e movê-la para um projeto diferente, alterar permissões ou excluí-la. ![A página Explorar mostra um menu para visualizar e gerenciar suas funções de dados personalizadas publicadas no Tableau Server e no Tableau Cloud.](/tableau/current/pt-br/prep/pt-br/Img/prep_conductor_dataroles.png) ## Agrupar valores semelhantes por função de dados **Observação**: no Tableau Prep Builder versão 2019.1.4 e 2019.2.1 essa opção foi rotulada como Correspondências de função de dados. Se você atribuir uma função de dados geográficos a um campo, poderá usar os valores na função de dados para agrupar e corresponder valores no seu campo de dados com base na ortografia e na pronúncia para padronizá-los. Você pode usar a Ortografia ou Ortografia + Pronúncia para agrupar e corresponder valores inválidos aos válidos. Essas opções usam o valor padrão definido pela função de dados. Se o valor padrão não estiver em sua amostra do conjunto de dados, o Tableau Prep vai adicioná-lo automaticamente e marcá-lo como não existente no conjunto de dados original. Para obter mais informações sobre como atribuir funções de dados a campos, consulte [Atribuir funções de dados padrão a seus dados](#datarole). Para usar funções de dados para agrupar valores, conclua as etapas a seguir. 1. No painel Perfil ou Resultados, ou na grade de dados, clique no tipo de dados do campo. 2. Selecione uma das funções de dados a seguir para o campo: - Aeroporto - Cidade - País/região - Município - Estado/Província A partir do Tableau Prep Builder versão 2019.3.2 e na Web, você também pode selecionar suas funções de dados personalizadas.
Funções de dados padrão (versão 2019.1.4 e posterior)Funções de dados personalizadas (versão 2019.3.2 e posterior)

O menu de função Dados e o submenu geográfico.

Um menu suspenso mostrando tipos de dados, funções de dados e um dicionário abrangente de materiais do Brick com 11 valores.
O Tableau Prep compara os valores de dados do campo a valores de domínio conhecidos para a função de dados selecionada e marca qualquer valor sem correspondência com um ponto de exclamação vermelho. 3. Clique em Mais opções![O menu Mais opções é representado por 3 pontos.](/tableau/current/pt-br/prep/pt-br/Img/prep_moreoptions_icon.png), selecione Agrupar valores (Agrupar e substituir em versões anteriores), em seguida selecione uma das opções a seguir: - Ortografia: corresponde valores inválidos aos valores válidos mais próximos que diferem, adicionando, removendo ou substituindo caracteres. - Pronúncia + Ortografia: essa opção corresponde os valores inválidos ao valor válido mais semelhante com base na ortografia e na pronúncia. ![O submenu Agrupar valores por mostra opções para agrupar e corresponder valores inválidos para a função de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_datarole_match3.png) Você também pode clicar no ícone de Recomendações![Ícone de sugestões do Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_suggestions_icon.png) no campo para aplicar a recomendação de agrupar e substituir os valores inválidos com os válidos. Essa opção usa a opção Agrupar valores de pronúncia + ortografia. O Tableau Prep compara os valores por ortografia ou ortografia e pronúncia e agrupa os valores semelhantes usando o valor padronizado para a função de dados. Se o valor padronizado não estiver no conjunto de dados, o valor será adicionado e marcado com um ponto vermelho. ![A caixa de diálogo Agrupar valores por pronúncia e ortografia é usada para agrupar valores semelhantes sob o valor padronizado para a função de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_datarole_match2.png) [Pular para o conteúdo principal](#main-content) # Usar scripts de Python no seu fluxo **Isenção de responsabilidade:** este tópico contém informações sobre um produto de terceiros. Observe que, enquanto nos esforçamos para manter as referências precisas ao conteúdo de terceiros, as informações que fornecemos aqui podem mudar sem aviso prévio, à medida que phyton muda. Para obter as informações mais atualizadas, consulte a documentação e o suporte do python. Python é uma linguagem de programação de alto nível amplamente utilizada para programação geral. Ao enviar comandos Python para um serviço externo por meio do Tableau Prep Builder, você pode facilmente estender suas opções de preparação de dados realizando ações, como adicionar números de linha, campos de classificação, preencher campos e executar outras operações de limpeza que, de outra forma, usaria os campos calculados. Para incluir scripts de Python no fluxo, você precisa configurar uma conexão entre Tableau e um servidor TabPy. Em seguida, você pode usar scripts de Python para aplicar funções com suporte aos dados do fluxo usando dataframe de pandas. Quando você adiciona uma etapa de script ao fluxo e especifica os detalhes da configuração, do arquivo e da função que deseja usar, os dados são transmitidos com segurança ao servidor TabPy, as expressões no script são aplicadas e os resultados são retornados como uma tabela que você pode limpar ou colocar como saída, conforme necessário. Você pode executar fluxos que incluem etapas de script no Tableau Server, desde que tenha configurado uma conexão com o servidor TabPy. Não é possível executar fluxos com etapas de script no Tableau Cloud. Para configurar o Tableau Server, consulte [Configurar o servidor Tableau Python (TabPy) para Tableau Server](#TabServer_TabPy). Para obter informações sobre como configurar sites no Tableau Server com extensões de análise para pastas de trabalho, consulte [Configurar conexões com extensões de análise](https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm). ## Pré-requisitos Para incluir scripts de Python no seu fluxo, conclua a configuração a seguir. Não é possível criar ou executar fluxos com etapas de script no Tableau Cloud. 1. Faça o download e instale o [Python](https://www.python.org/downloads/). Baixe e instale a versão mais atual do Python para Linux, Mac ou Windows. 2. Baixe e instale o servidor Tableau Python ([TabPy](https://github.com/tableau/TabPy)). Siga as instruções de instalação e configuração para instalar o TabPy. O Tableau Prep Builder usa o TabPy para transmitir dados do fluxo por meio de TabPy como a entrada, aplica seu script e retorna os resultados de volta ao fluxo. 3. Instale o Pandas. Execute `pip3 install pandas`. Você deve usar um dataframe de pandas em seus scripts para integrar-se ao Tableau Prep Builder. ### Configurar o servidor Tableau Python (TabPy) para Tableau Server Se você planeja publicar, criar, editar e executar fluxos que incluem etapas de script no Tableau Server, precisará configurar uma conexão entre o seu servidor TabPy e o Tableau Server. - **Versão 2019.3 e posterior**: é possível executar fluxos publicados que incluem etapas de script no Tableau Server. - **Versão 2020.4.1 e posterior**: é possível criar, editar e executar fluxos que incluem etapas de script no Tableau Server. - **Tableau Cloud**: no momento, não é possível criar ou executar fluxos com etapas de script. 1. Abra a linha de comando do TSM/shell. 2. Insira os seguintes comandos para definir o endereço do host, os valores da porta e o tempo limite da conexão: `tsm security maestro-tabpy-ssl enable --connection-type {maestro-tabpy-secure/maestro-tabpy} --tabpy-host --tabpy-port --tabpy-username --tabpy-password --tabpy-connect-timeout-ms ` - Selecione `{maestro-tabpy-secure}` para habilitar uma conexão segura ou `{maestro-tabpy}` para habilitar uma conexão não segura. - Se você selecionar `{maestro-tabpy-secure}`, especifique o arquivo de certificado `-cf` na linha de comando. - Especifique o `--tabpy-connect-timeout-ms ` em milissegundos. Por exemplo, `--tabpy-connect-timeout-ms 900000`. 3. Para desabilitar a conexão TabPy, insira o seguinte comando `tsm security maestro-tabpy-ssl disable` ## Criar seu script de Python Ao criar o script, inclua uma função que especifique um pandas (pd.DataFrame) como um argumento da função. Isto chamará seus dados do Tableau Prep Builder. Você também precisará retornar os resultados em um pandas (pd.DataFrame) usando tipos de dados compatíveis. Por exemplo, para adicionar codificação a um conjunto de campos em um fluxo, você pode escrever o seguinte script: def encode(input): le = preprocessing.LabelEncoder() Return pd.DataFrame({ 'Opportunity Number' : input\['Opportunity Number'\], 'Supplies Subgroup Encoded' : le.fit\_transform(input\['Supplies Subgroup'\]), 'Region Encoded' : le.fit\_transform(input\['Region'\]), 'Route To Market Encoded' : le.fit\_transform(input\['Route To Market'\]), 'Opportunity Result Encoded' : le.fit\_transform(input\['Opportunity Result'\]), 'Competitor Type Encoded' : le.fit\_transform(input\['Competitor Type'\]), 'Supplies Group Encoded' : le.fit\_transform(input\['Supplies Group'\]), }) Os seguintes tipos de dados são compatíveis:
Tipo de dados no Tableau Prep BuilderTipo de dados no Python
Cadeia de caracteresCadeia de caracteres UTF-8 padrão
DecimalDuplo
IntInteiro
BoolBooleano
DataCadeia de caracteres no formato ISO_DATE “AAAA-MM-DD” com compensação de zona opcional. Por exemplo, “2011-12-03” é uma data válida.
DateTimeCadeia de caracteres no formato ISO_DATE_TIME “AAAA-MM-DDT:HH:mm:ss” com compensação de zona opcional. Por exemplo, “2011-12-03T10:15:30+01:00” é uma data vslid.
**Observação**: Date e DateTime sempre devem ser retornados como uma cadeia de caracteres válida. Se quiser retornar campos diferentes do que você inserir, será necessário incluir uma função get\_output\_schema no script que define a saída e os tipos de dados. Caso contrário, a saída usará os campos dos dados de entrada, que são obtidos na etapa anterior à etapa do script no fluxo. Use a seguinte sintaxe ao especificar os tipos de dados para seus campos no get\_output\_schema:
Função no PythonTipos de dados resultantes
prep_string()Cadeia de caracteres
prep_decimal()Decimal
prep_int()Inteiro
prep_bool()Booleano
prep_date()Data
prep_datetime()DateTime
Colchetes podem ser usados para acessar linhas de um DataFrame. Colchetes simples geram uma série Pandas, enquanto colchetes duplos geram um DataFrame Pandas. def create\_key(df): return pd.DataFrame({ "Key": \['12345'\] }) O exemplo seguinte mostra a função get\_output\_schema adicionada ao script de python de codificação de campo: def get\_output\_schema(): return pd.DataFrame({ 'Opportunity Number' : prep\_int(), 'Supplies Subgroup Encoded' : prep\_int(), 'Region Encoded' : prep\_int(), 'Route To Market Encoded' : prep\_int(), 'Opportunity Result Encoded' : prep\_int(), 'Competitor Type Encoded' : prep\_int(), 'Supplies Group Encoded' : prep\_int() }) ## Conecte-se ao servidor Tableau Python (TabPy) > [!IMPORTANT] > > **Importante**: a partir da versão 2020.3.3 do Tableau Prep Builder, configure a conexão de servidor uma vez no menu superior Ajuda, em vez de configurar a conexão por fluxo na etapa de Script, clicando em Conectar-se ao servidor Tableau Python (TabPy) e inserindo os detalhes da conexão. Você precisará reconfigurar a conexão usando este novo menu para os fluxos criados em uma versão mais antiga do Tableau Prep Builder que você abre na versão 2020.3.3. 1. Selecione Ajuda > Configurações e desempenho > Gerenciar conexão de extensões do Analytics. 2. Na lista suspensa Selecionar uma extensão do Analytics, selecione Servidor Tableau Python (TabPy). ![Formulário de logon de configuração da Conexão de extensão do Analytics.](/tableau/current/pt-br/prep/pt-br/Img/prep_scripts_tabpy_signin.png) 3. Insira as credenciais: - A porta 9004 é a padrão para TabPy. - Se o servidor exigir credenciais, insira um Nome de usuário e uma Senha. - Se o servidor usar a criptografia SSL, marque a caixa de seleção Exigir SSL e clique no link Sem arquivo de configuração personalizado especificado para selecionar um certificado para a conexão. Esse é o arquivo de certificado do servidor SSL. **Observação**: o Tableau Prep Builder não fornece uma maneira de testar a conexão. Se houver um problema com a conexão, uma mensagem de erro será exibida. ## Adicionar um script ao fluxo Inicie o servidor TabPy e conclua as seguintes etapas: **Observação**: TabPy requer a versão 5.1.1 do pacote tornado para execução. Se você recebe o erro, 'tornado.web' não tem nenhum atributo 'assíncrono' ao tentar iniciar o TabPy, na linha de comando, execute `pip list` para verificar a versão do tornado instalada. Se você tiver uma versão diferente instalada, faça o download do [pacote do tornado versão 5.1.1](https://pypi.org/project/tornado/5.1.1/#files). Em seguida, execute `pip uninstall tornado` para desinstalar sua versão atual e, em seguida, `pip install tornado==5.1.1` para instalar a versão necessária. 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Em criação na Web, na página Início, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Em seguida, clique em Conectar a dados. 2. Na lista de conectores, selecione o tipo de arquivo ou servidor que hospeda seus dados. Se solicitado, insira as informações necessárias para acessar seus dados. 3. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar script no menu de contexto. ![Adicione um script ao Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_script_add.png) 4. No painel Script, na seção Tipo de conexão, selecione Tableau Python (TabPy) Server. ![prep\_scripts\_python2.png](/tableau/current/pt-br/prep/pt-br/Img/prep_scripts_python2.png) 5. Na seção Nome do arquivo, clique em Procurar para selecionar o arquivo de script. 6. Digite o Nome da função e pressione Enter para executar seu script. ![Um script para definir as configurações do tipo de conexão.](/tableau/current/pt-br/prep/pt-br/Img/prep_scripts_python_pane.png) [Pular para o conteúdo principal](#main-content) # Usar scripts de R (Rserve) no seu fluxo **Isenção de responsabilidade:** este tópico contém informações sobre um produto de terceiros. Observe que, enquanto nos esforçamos para manter as referências precisas ao conteúdo de terceiros, as informações que fornecemos aqui podem mudar sem aviso prévio, à medida que R e Rserve mudam. Para obter as informações mais atualizadas, consulte a documentação e o suporte do R e Rserve. R é uma linguagem de programação de software com código-fonte aberto e um ambiente de software para computação estatística e gráficos. Para estender a funcionalidade do Tableau Prep Builder, você pode criar scripts no R para usar no seu fluxo executado por um servidor Rserve com o objetivo de produzir saída para trabalho no fluxo. Por exemplo, convém adicionar dados de modelagem estatística ou prever dados para os que você já tem no fluxo usando um script em R, em seguida usar o poder do Tableau Prep Builder para limpar o conjunto de dados resultante para análise. Para incluir scripts de R no fluxo, você precisa configurar uma conexão entre o Tableau Prep Builder e um servidor Rserve. Em seguida, você pode usar scripts de R para aplicar funções com suporte aos dados do fluxo usando expressões de R. Depois de inserir os detalhes da configuração e apontar o Tableau Prep Builder para o arquivo e a função que você deseja usar, os dados são transmitidos de forma segura ao servidor Rserve, as expressões são aplicadas e os resultados são retornados como uma tabela (data.frame de R) que você pode limpar ou imprimir conforme necessário. Você pode executar fluxos que incluem etapas de script no Tableau Server, desde que tenha configurado uma conexão com o servidor Rserve. Não é possível executar fluxos com etapas de script no Tableau Cloud. Para configurar o Tableau Server, consulte [Configurar o servidor Rserve para Tableau Server](#server_config). ## Pré-requisitos Para incluir etapas de script R no seu fluxo, instale o R e configure uma conexão com um servidor Rserve. ### Recursos - [Download e instalação do R](http://cran.wustl.edu/). Faça download e instale a versão mais atual do R para Linux, Mac ou Windows. - [Notas de implementação do R](https://community.tableau.com/s/question/0D54T00000G54v3SAB/r-implementation-notes) (publicação da comunidade). Instale e configure uma conexão com R e Rserve para Windows. - [Instalar e configurar o Rserve](http://www.rforge.net/Rserve/doc.html): instruções para instalação geral e configuração para todas as plataformas. - [Rserve para Windows (notas de versão)](https://www.rforge.net/Rserve/rserve-win.html): este tópico aborda as limitações ao instalar o Rserve localmente no Windows. ### Configurar o servidor Rserve para Tableau Server Use as instruções a seguir para configurar uma conexão entre o servidor Rserve e o Tableau Server. - **Versão 2019.3 e posterior**: é possível executar fluxos publicados que incluem etapas de script no Tableau Server. - **Versão 2020.4.1 e posterior**: é possível criar, editar e executar fluxos que incluem etapas de script no Tableau Server. - **Tableau Cloud**: no momento, não é possível criar ou executar fluxos com etapas de script. 1. Abra a linha de comando do TSM. 2. Insira os seguintes comandos para definir o endereço do host, os valores da porta e o tempo limite da conexão: `tsm security maestro-rserve-ssl enable --connection-type {maestro-rserve-secure/maestro-rserve} --rserve-host --rserve-port --rserve-username --rserve-password --rserve-connect-timeout-ms ` - Selecione `{maestro-rserve-secure}` para habilitar uma conexão segura ou `{maestro-rserve}` para habilitar uma conexão não segura. - Se você selecionar `{maestro-rserve-secure}`, especifique o arquivo de certificado `-cf` na linha de comando. - Especifique o `--rserve-connect-timeout-ms ` em milissegundos. Por exemplo, `--rserve-connect-timeout-ms 900000`. 3. Para desabilitar a conexão Rserve, insira o seguinte comando `tsm security maestro-rserve-ssl disable` ### Configuração adicional do Rserve (opcional) Você pode criar um arquivo chamado Rserv.cfg para definir os valores padrão de configuração, personalizar o Rserve e colocá-lo no local de instalação `/etc/Rserve.conf`. Para melhorar a estabilidade com o servidor Rserve e Tableau Prep Builder, você pode adicionar valores à sua configuração Rserve. Ao iniciar o Rserve, você pode fazer referência a esse arquivo para aplicar suas opções de configuração. Por exemplo: - Windows: `Rserve(args="--RS-conf C:\\folder\\Rserv.cfg")` - MacOS e Linux: `Rserve(args=" --no-save --RS-conf ~/Documents/Rserv.cfg")` O exemplo a seguir mostra algumas opções adicionais que você pode incluir no arquivo de configuração `Rserve.conf` : \# If your data includes characters other than ASCII, make it explicit that data should be UTF8 encoded. encoding utf8 # Disable interactive behavior for Rserve or Tableau Prep Builder will stall when trying to run the script as it waits for an input response. interactive no Para obter informações sobre como configurar um arquivo Rserve.conf, consulte a seção de configuração avançada do Rserve nas [notas de implementação do R](https://community.tableau.com/s/question/0D54T00000G54v3SAB/r-implementation-notes) (publicação na comunidade). ## Criar seu script R Ao criar o script, inclua uma função que especifique um dataframe como um argumento da função. Isto chamará seus dados do Tableau Prep Builder. Você também precisará retornar os resultados em um dataframe utilizando os tipos de dados compatíveis. Por exemplo: postal\_cluster <- function(df) { out <- kmeans(cbind(df$Latitude, df$Longitude), 3, iter.max=10) return(data.frame(Latitude=df$Latitude, Longitude=df$Longitude, Cluster=out$cluster)) } Os seguintes tipos de dados são compatíveis:
Tipo de dados no Tableau Prep BuilderTipo de dados no R
Cadeia de caracteresCadeia de caracteres UTF-8 padrão
DecimalDuplo
IntInteiro
BoolLógico
DataCadeia de caracteres no formato ISO_DATE “AAAA-MM-DD” com compensação de zona opcional. Por exemplo, “2011-12-03+01:00” é uma data válida.
DateTimeCadeia de caracteres no formato ISO_DATE_TIME “AAAA-MM-DDT:HH:mm:ss” com compensação de zona opcional. Por exemplo, “2011-12-03T10:15:30+01:00” é uma data vslid.
**Observação**: Date e DateTime sempre devem ser retornados como uma cadeia de caracteres válida. Tipos de data nativa (DateTime) em R não são compatíveis como valores retornados, mas podem ser usados no script. Se quiser retornar campos diferentes dos que você inseriu, será necessário incluir uma função getOutputSchema no script que define a saída e os tipos de dados. Caso contrário, a saída usará os campos dos dados de entrada, que são obtidos na etapa anterior à etapa do script no fluxo. Use a seguinte sintaxe ao especificar os tipos de dados para seus campos no getOutputSchema:
Função no RTipos de dados resultantes
prep_string ()Cadeia de caracteres
prep_decimal ()Decimal
prep_int ()Inteiro
prep_bool ()Booleano
prep_date ()Data
prep_datetime ()DateTime
O exemplo a seguir mostra a função getOutputSchema do script postal\_cluster: getOutputSchema <- function() { return (data.frame ( Latitude = prep\_decimal (), Longitude = prep\_decimal (), Cluster = prep\_int ())); } ## Conecte-se ao servidor Rserve > [!IMPORTANT] > > **Importante**: a partir da versão 2020.3.3 do Tableau Prep Builder, você pode configurar a conexão do servidor uma vez no menu superior Ajuda, em vez de configurar a conexão por fluxo na etapa de Script ao clicar em Conectar-se ao servidor Rserve e inserir os detalhes da conexão. Você precisará reconfigurar a conexão usando este novo menu para os fluxos criados em uma versão mais antiga do Tableau Prep Builder que você abre na versão 2020.3.3. 1. Selecione Ajuda > Configurações e desempenho > Gerenciar conexão de extensões do Analytics. 2. Na lista suspensa Selecionar uma extensão do Analytics, selecione Rserve. ![Formulário de logon de configuração da Conexão de extensão do Analytics.](/tableau/current/pt-br/prep/pt-br/Img/prep_scripts_r_signin.png) 3. Insira as credenciais: - A porta 6311 é a padrão para servidores Rserve com texto sem formatação. - A porta 4912 é a padrão para servidores Rserve com criptografia SSL. - Se o servidor exigir credenciais, insira um Nome de usuário e uma Senha. - Se o servidor usar a criptografia SSL, marque a caixa de seleção Exigir SSL e clique no link Arquivo de configuração personalizado para especificar um certificado para a conexão. **Observação**: o Tableau Prep Builder não fornece uma maneira de testar a conexão. Se houver um problema com a conexão, uma mensagem de erro será exibida quando você tentar e executar o fluxo. ## Adicionar um script ao fluxo Inicie o servidor Rserve e conclua as seguintes etapas: 1. Abra o Tableau Prep Builder e clique no botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png). Em criação na Web, na página Início, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Em seguida, clique em Conectar a dados. 2. Na lista de conectores, selecione o tipo de arquivo ou servidor que hospeda seus dados. Se solicitado, insira as informações necessárias para acessar seus dados. 3. Clique no ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e selecione Adicionar script no menu de contexto. ![Adicione um script ao Tableau Prep.](/tableau/current/pt-br/prep/pt-br/Img/prep_script_add.png) 4. No painel Script, em Tipo de conexão , selecione Rserve. ![Um script para definir as configurações do tipo de conexão.](/tableau/current/pt-br/prep/pt-br/Img/prep_script_script_pane.png) 5. Na seção Nome do arquivo, clique em Procurar para selecionar o arquivo de script. 6. Digite o Nome da função e pressione Enter para executar seu script. ![Um script para definir as configurações do tipo de conexão.](/tableau/current/pt-br/prep/pt-br/Img/prep_script_pane2.png) [Pular para o conteúdo principal](#main-content) # Usar scripts R e Python no fluxo A partir da versão 2019.3.1, você pode usar scripts R e Python para executar operações de limpeza mais complexas ou incorporar dados de modelagem preditiva no fluxo. Os dados são transmitidos do fluxo como entrada por meio da etapa de script R ou Python e depois devolvidos como dados de saída, que você pode continuar limpando com os recursos e as funções do Tableau Prep Builder. **Observação**: a conexão com scripts como uma etapa de entrada para o fluxo ainda não é compatível. Além disso, as etapas do script ainda não são compatíveis com fluxos de autoria ou publicados no Tableau Cloud. ![O Tableau Prep adiciona uma etapa de script.](/tableau/current/pt-br/prep/pt-br/Img/prep_script_step2.png) Configure o servidor Rserve ou o servidor Tableau Python (TabPy) e adicione uma etapa de script ao fluxo. O Tableau Prep transmite os dados para o servidor Rserve para R ou Tableau Python (TabPy) para Python e devolve os dados resultantes para o fluxo na forma de uma tabela. Você pode continuar a aplicar operações de limpeza aos resultados e gerar a saída para análise. Ao criar o script, você precisará incluir uma função que especifica uma estrutura de dados como um argumento da função. Se quiser retornar campos diferentes dos que você inseriu, será necessário incluir uma função getOutputSchema no script que define a saída e os tipos de dados. Caso contrário, a saída utilizará os campos dos dados de entrada. Se você criar ou editar fluxos no Tableau Server (versão 2020.4.1 e posterior) que incluem etapas de script, o Tableau Server também deve ter uma conexão com um servidor Rserve ou TabPy para executar etapas de script. Para obter informações sobre como configurar o R ou o Python para usar em seus fluxos e como criar scripts, consulte [Usar scripts de R (Rserve) no seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts._R.htm) ou [Usar scripts de Python no seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts_TabPy.htm). Precisa de ajuda para depurar um fluxo? Tente ativar Habilitar log de consulta no menu Ajuda\>Configurações e desempenho. Para obter mais informações, consulte [Habilitar log de consulta](https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm#enable-query-logging). ## Outros artigos nesta seção [Pular para o conteúdo principal](#main-content) # Uso da cama hospitalar com o Tableau Prep Alcançar a capacidade em um hospital é problemático, mas abundância de recursos também é. É importante entender as camas hospitalares da perspectiva da cama como um recurso. Contudo, os dados geralmente são armazenados da perspectiva do paciente. Como podemos pegar os dados que capturam quando os pacientes estão nas camas e determinar o uso da cama? **Observação**: para concluir as tarefas nestes tutoriais, é necessário ter o Tableau Prep e, opcionalmente, o Tableau Desktop instalados: Para instalar o Tableau Prep e o Tableau Desktop, consulte o [Guia de implantação do Tableau Desktop e do Tableau Prep](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm#). Caso contrário, é possível baixar a avaliação gratuita do [Tableau Prep](https://www.tableau.com/pt-br/products/prep/download) e o Tableau Desktop Free Edition. Também será necessário baixar os três arquivos de dados. É recomendado salvá-los na pasta Meu repositório do Tableau Prep > Fontes de dados. \- [Beds.xlsx](https://mkt.tableau.com/PrepTutorials/Beds.xlsx) \- [Hours.xlsx](https://mkt.tableau.com/PrepTutorials/Hours.xlsx) \- [Patient Beds.xlsx](https://mkt.tableau.com/PrepTutorials/Patient%20Beds.xlsx) ## Os dados Para nossas quatro camas A, B, C e D, rastreamos qual paciente estava na cama e seu horário de chegada e saída nela. Os dados têm esta aparência: ![visualização do conjunto de dados de cama do paciente](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_patientbeddata.png) ## Análise preliminar Se trouxermos esses dados para o Tableau Desktop, poderemos criar um gráfico de Gantt para mostrar quando os pacientes estão nas camas. ![Gráfico de Gantt no Tableau Desktop do conjunto de dados de cama do paciente](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_originaldatagantt.png) Isso é útil visualmente Podemos ver que há apenas pequenas lacunas em uso para as camas A e B, mas a cama C é pouco utilizada. O paciente da cama D não tem horário de saída, mas pudemos abordar essa questão com alguns cálculos. Isso nos da uma visão geral de como as camas são usadas. Contudo, e se quiséssemos contas as horas que uma cama ficou vazia? Ou comparar o tempo de cama aberto antes e depois que uma nova política foi implementada? Não há uma maneira fácil de fazer isso com o jeito que os dados estão estruturados no momento. ## Estrutura de dados desejada Ao criar alguns conjuntos de dados muito básicos e combiná-los no Tableau Prep, poderemos modificar esse conjunto de dados em um formulário que permitirá executar uma análise mais detalhada e criar visualizações ainda mais úteis. Antes de irmos para o Tableau Prep, vamos dar um passo atrás e pensar sobre o que precisamos criar para responder a pergunta “Quantas horas cada cama ficou vazia?” Precisamos ser capaz de olhar cada cama para cada horário e saber se tinha ou não um paciente nela. No momento, os dados são exclusivamente de quando o paciente estava na cama; não fornecemos informações ao Tableau sobre as horas _vazias_. Para criar essa matriz completa de todas as camas e todos os horários, criaremos dois conjuntos de dados novos. Um é apenas uma lista de camas (A, B, C, D), o outro é uma lista de horários (1, 2, 3, …, 23, 24). Ao executar uma união de colunas cruzada (unindo cada linha no outro conjunto de dados) terminaremos com todas as combinações possíveis de camas e horários.
O conjunto de dados Beds.xlsx tem esta aparência:O conjunto de dados Hours.xlsx tem esta aparência:E os resultados da união cruzada têm esta aparência: 
Visualização do conjunto de dados de CamasVisualização do conjunto de dados de HorasVisualização dos dados da matriz Cama-Hora
Em seguida, traremos a informações das **Camas com pacientes**, rotulando cada combinação de cama e horário como tendo ou não um paciente específico. terminaremos com um conjunto de dados que tem uma linha para cada cama - horário, e se um paciente estava na cama, além de seu número e horários de entrada e saída. Os valores nulos indicam que a cama estava desocupada. ![Visualização dos dados da matriz Cama-Hora-Paciente](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_bedhourpatientmatrix.png) Com os dados nesta estrutura, podemos executar análises dessa forma, o que permite investigar camas desocupadas tão fácil quanto camas com pacientes. ![Painel de dados em forma mostrando o uso da cama por hora e paciente](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_shapeddatadashboard.png) ## Reestruturação dos dados Como fazemos isso com o Tableau Prep? Criaremos o fluxo em duas partes, primeiro criando a matriz Horários das camas, em seguida combinando-a com os dados das Camas com paciente. Certifique-se de que baixou todos os três arquivos Excel (**Beds.xlsx**, **Hours.xlsx** e **Patient Beds.xlsx**) para prosseguir. ### Matriz de Horários das camas Primeiro, vamos conectar ao arquivo **Beds.xls**. 1. Abra o Tableau Prep. 2. Na tela inicial, selecione Conectar a dados. 3. No painel Conexões, selecione Microsoft Excel. Navegue até onde salvou o **Beds.xls** e selecione Abrir. 4. A planilha Camas deverá ser trazida automaticamente para o painel Fluxo. **Dica**: para obter mais informações sobre como se conectar a dados, consulte [Conectar a dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm). Em seguida, vamos criar um campo que podemos usar para fazer a união de colunas cruzada com o conjunto de dados **Horários**. Adicionaremos um cálculo que é simplesmente o valor **1**. 1. No painel Fluxo, selecione Camas e selecione Etapa de limpeza. 2. Com a etapa de Limpeza recém-adicionada, o painel Perfil será exibido. Selecione Criar campo calculado na barra de ferramentas. 3. Nomeie o campo **União de colunas cruzada** e insira o valor **1**. 4. A Grade de dados deverá atualizar para mostrar o estado atual dos dados. ![Uma tabela que exibe o resultado de uma união cruzada.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_crossjoinresults.png "Visual da grade de dados com colunas para União de colunas cruzada e Cama") Agora repetiremos o processo com o conjunto de dados Horários. Expandir para direções 1. No painel Conexões, selecione o botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png) para adicionar outra conexão de dados. 2. Escolha Microsoft Excel, selecione o arquivo **Hours.xlsx** e clique em Abrir. 3. No painel Fluxo, selecione Horas e Etapa de limpeza para adicioná-lo ao fluxo. 4. Na barra de ferramentas do painel Perfil, crie um campo calculado chamado **União de colunas cruzada** e insira o valor **1**. ![Uma tabela que exibe o resultado de uma união cruzada.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_crossjoinresults2.png "Visual da grade de dados com colunas para União de colunas cruzada e Horário") Ambos os conjuntos de dados agora possuem um campo compartilhado, **União de colunas cruzada**, e podem ser unidos. 1. Una as duas etapas de limpeza ao arrastar **Limpeza 2** para **Limpeza 1** e soltar na opção Unir colunas. ![O painel de fluxo mostrando a área para soltar de União de colunas quando a Limpeza 2 é arrastado para Limpeza 1](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_clean1joinclean2.png) 2. No Perfil de união de colunas abaixo, as configurações da união deverão ser preenchidas automaticamente. - Como nomeamos ambos os campos como **União de colunas cruzada**, o Tableau Prep as identifica automaticamente como o campo compartilhado e cria as Cláusulas de união de colunas aplicadas adequadas. - O Tipo de união de colunas padrão é interno, que é o que queremos. - Essa união de colunas corresponderá todas as linha de **Camas** com todas as linhas de **Horários**, como visto na Grade de dados. ![O painel do Perfil de união de colunas com vários elementos chamados para corresponder à lista acima](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_join1profile.png) A. Cláusulas de união de colunas B. Tipo de união de colunas C. Resultado da grade de dados **Dica**: para obter mais informações sobre uniões de colunas, consulte [Unir colunas de dados](https://help.tableau.com/current/prep/pt-br/prep_combine.htm#Join). Não precisamos mais dos campos de **União de colunas cruzada**, então podemos removê-los. 1. No painel Fluxo, selecione **União de colunas 1**, selecione o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e adicione uma etapa de limpeza. 2. Selecione os campos **União de colunas cruzada-1** e **União de colunas cruzada** e, em seguida, Remover campos. 3. Clique duas vezes no rótulo **Limpeza 3** e renomeie essa etapa como **Matriz de Horários das camas**. Agora temos o conjunto de dados Matriz Horários das camas que contém todas as camas e horários. Dessa forma concluímos a primeira parte da criação de nosso conjunto de dados. ### Uso da cama pelo paciente A segunda parte traz o uso da cama pelo paciente. Para começar, nos conectaremos aos dados. 1. No painel Conexões, selecione o botão Adicionar conexão ![Um botão para adicionar uma conexão de dados.](/tableau/current/pt-br/prep/pt-br/Img/prep_addconnection.png) para adicionar outra conexão de dados. 2. Escolha Microsoft Excel, selecione o arquivo **Patient Beds.xlsx** e selecione Abrir. 3. No painel Fluxo, selecione **Leitos de pacientes** e Etapa de limpeza sugerida para adicioná-la ao fluxo. Como o arquivo Matriz Horários das camas é baseado na _hora_ mas Camas com paciente é baseado na _horário real_, precisamos tirar o horário de entrada e saída das Camas com paciente. Além disso, para o horário de saída, queremos garantir que se um paciente ainda estiver na cama no final do dia (meia-noite, hora 24) nós indicaremos que a cama está ocupada, mesmo que não tenha horário de saída no conjunto de dados. Adicionaremos um campo calculado nessa nova etapa. 1. Na barra de ferramentas, clique em Criar campo calculado. 2. Nomeie o campo como **Hora de chegada**. Para o cálculo, insira `DATEPART('hour',[Start Time])`. 3. Isso pega o horário da hora de chegada e o retira. Sendo assim, "1/1/18 9:35 AM” se torna apenas "9". 4. Crie outro campo calculado chamado **Hora de saída**. Para o cálculo, insira `IFNULL(DATEPART('hour',[End Time]), 24)`. A parte `DATEPART` pega o horário da hora de saída. A parte `IFNULL` atribuirá uma hora de saída de 24 (meia-noite) a qualquer hora de saída ausente. Agora estamos prontos para unir colunas do uso das camas por paciente à **Matriz de Horários das camas**. Isso é uma união de colunas pouco mais complexa que a que fizemos anteriormente. Uma união de colunas interna retornaria apenas valores presentes nos dois conjuntos de dados. Como queremos nos certificar de manter todos as faixas cama - horário, independente se tinha ou não um paciente na cama, precisaremos fazer uma união de colunas à esquerda. Isso resultará em muitos nulos, mas é o mais adequado. Também precisaremos corresponder quando uma faixa cama - horário estiver ocupada por um paciente (ou pacientes). Portanto, além de corresponder a cama na qual o paciente está, precisamos considerar a hora. O conjunto de dados Matriz Horários das camas ó possui um campo **Horário**, e o conjunto de dados **Camas com pacientes** possui **Hora de chegada** e **Hora de saída**. Usaremos uma lógica básica para determinar se um paciente deveria estar atribuído a uma determinada faixa cama - horário: _um paciente consta em uma cama se a hora de chegada for menor ou igual (<=) à faixa cama - horário E a hora de saída for maior ou igual (>=) à faixa cama - horário._ Sendo assim, são necessárias três cláusulas de união de colunas para corresponder adequadamente esses dois conjuntos de dados. 1. Una as colunas da etapa **Limpeza 3** à etapa **Matriz de Horários das camas**. 2. Na área Cláusulas de união de colunas aplicadas, o padrão deve ser **Horário** = **Hora de saída**. Selecione a cláusula de união de colunas para alterar o operador de "**\=**" para "**<=**". ![Campos com operadores de união de colunas.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_joinoperator.png "Visual da alteração do operador de união de colunas") 3. Selecione o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addvalueicon.png) no canto superior direito da área Cláusulas de união de colunas aplicadas para adicionar outra cláusula de união. Defina como **Hora >= Hora de chegada.** Adicione uma terceira cláusula de união de colunas para **Cama = Cama de hospital**. 4. Na seção Tipo de união de colunas, selecione a área não sombreada do gráfico, próximo a **Matriz de Horários das camas** para alterar o tipo de união para uma união **à esquerda**. ![O painel de perfil de união de coluna para União de coluna 2 mostrando a configuração correta](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_join2.png) **Observação**: se você arrastar **Matriz de Horários das camas** para **Limpeza 3** em vez do contrário, os resultados esperados podem ser obtidos usando uma união de colunas à direita em vez de à esquerda. A ordem para arrastar as etapas é importante para a orientação da união de colunas. As cláusulas de união de colunas também estarão na ordem contrária, certifique-se de preservar a lógica correta de comparação dos horários. Nossos dados agora estão unidos, mas devemos limpar alguns artefatos da união de colunas e certificar de que os campos estão organizados. Não precisamos mais da **Hora de chagada** e **Hora de saída**. **Cama de hospital** e **Cama** também são redundantes. Finalmente, um valor nulo no campo **Paciente** significa que a cama está desocupada. 1. No painel Fluxo, adicione uma etapa de limpeza para que possamos organizar os dados da união. 2. Ctrl+clique (Command+clique no Mac) para selecionar vários campos **Hora de saída**, **Hora de chagada** e **Cama de hospital** e selecione Remover campos na barra de ferramentas. 3. No cartão de perfil do campo **Paciente**, clique duas vezes no valor **nulo** e digite **Desocupado**. Agora temos uma estrutura de dados com uma linha para cada cama - horário; se houver um paciente na cama durante esse horário, também teremos as informações do paciente. Tudo que resta a fazer é adicionar uma etapa de saída e gerar o conjunto de dados. 1. No painel Fluxo, selecione **Limpeza 4**, selecione o ícone de adição ![Um botão com um sinal de mais.](/tableau/current/pt-br/prep/pt-br/Img/prep_addicon.png) e adicione uma etapa de Saída. 2. No painel Saída, altere o Tipo de saída para .csv e selecione Procurar. 3. Insira **Matriz de Horários das camas com paciente** para o nome e selecione o local desejado antes de selecionar Aceitar para salvar. 4. Selecione o botão Executar fluxo na parte inferior do painel para gerar a saída. Selecione Concluído na caixa de diálogo do status para fechá-la. **Dica**: para obter mais informações sobre as saídas e a execução de um fluxo, consulte [Salvar e compartilhar seu trabalho](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#Export). O fluxo final deve ter esta aparência: ![O painel de fluxo com todas as etapas concluídas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_finalflow.png) ## Análise no Tableau Desktop Para instalar o Tableau Desktop antes de continuar com este tutorial, é possível baixar o Tableau Desktop Free Edition. Agora que temos o conjunto de dados na estrutura desejada, podemos executar uma análise mais detalhada que com os dados originais. 1. Abra o Tableau Desktop. No painel Conectar, selecione Arquivo de texto, navegue até o arquivo **Bed Hour Patient Matrix.csv** e selecione Abrir. 2. Na guia Fonte de dados, os dados deverão aparecer na tela por padrão. Navegue até **Planilha 1**. 3. No painel Dados, arraste **Horário** acima da linha separando Medidas e Dimensões para tornar uma dimensão discreta. ![Arraste um campo Medida para a seção Dimensão para convertê-lo em uma dimensão.](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hospitalbeds_dimmeasure.png) 4. Arraste **Cama** para a divisória Linhas e **Horário** para a divisória Colunas. 5. Arraste **Paciente** para a divisória Cor. ![Exibição básica de dados em forma no Tableau Desktop mostrando o uso da cama por hora](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_desktopbasic.png) A formatação é opcional, mas pode ajudar na leitura do visual. 1. Selecione a divisória Cor e Editar cores. 2. Na área à esquerda, selecione **Desocupado**. No menu suspenso à direita, selecione a paleta de cores Seattle Grays. 3. Selecione o quarto cinza mais claro e clique em OK. 4. Selecione a divisória Cor novamente e clique no menu suspenso Borda. Selecione a segunda opção de cinza mais à direita. 5. Na barra de ferramentas, no menu suspenso Tamanho, altere de Padrão para Ajustar à altura. ![Imagem da localização do menu suspenso de tamanho na barra de ferramentas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_desktopfitwidth.png) 6. Selecione o menu Formatar e Bordas. 7. Em Divisória de linha, selecione o menu suspenso Painel e escolha um cinza bem claro. 8. Ajuste o controle deslizante de Nível para a segunda marca de escala. 9. Repita na Divisória e coluna. Defina a cor do Painel como um cinza claro e o Nível para a segunda marca. ![Um trecho mostrando o painel de formato com as configurações corretas para as bordas](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_desktopborders.png) 10. Clique duas vezes na guia da planilha na parte inferior e renomeie como **Uso da cama por hora**. Essa exibição permite ver rapidamente quando determinada cama estava ocupada ou disponível. ![Uma exibição mostrando o uso da cama por hora](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_desktopbeduse.png) Mas podemos ir além e contar o número de horas cada capa esteve desocupada. 1. Selecione o ícone da nova guia da planilha ![Ícone Nova planilha.](/tableau/current/pt-br/prep/pt-br/Img/newsheet.png) na parte inferior para abrir uma planilha em branco. 2. Arraste **Paciente** para Linhas. 3. Arraste **Horário** para Colunas. Clique com o botão direito do mouse na pílula de Horário para abrir o menu. Selecione Medida \> Contagem. 4. Arraste outra cópia do campo **Paciente** do painel Dados para a divisória Cor. 5. Clique com o botão direito do mouse no eixo e selecione Editar eixo. Altere o título para **Horas** e feche a caixa de diálogo. 6. Renomeie a guia da planilha **Horários das camas por paciente.** ![Uma exibição mostrando as horas de cama por paciente](/tableau/current/pt-br/prep/pt-br/Img/prep_tutorial_hb_desktoppatientbeds.png) Essa exibição permite identificar quantas horas de cama desocupada tivemos, algo que não poderíamos fazer com o conjunto de dados original. Quais outros gráficos ou painéis você pode criar? Tente agora que seus dados estão na estrutura correta. ## Resumo e recursos Para criar esta estrutura de dados usando o Tableau Prep, precisamos executar as seguintes ações: 1. Crie um conjunto de dados para cada aspecto que queremos analisar, neste caso **Camas** e **Horas**. 2. Faça uma união de colunas cruzada desses conjuntos de dados para criar um conjunto de dados **Matriz de Horários das camas** com cada combinação possível de camas e horas. 3. Una as colunas dos dados **Matriz de Horários das camas** aos dados **Cama com paciente**, certificando-se de que a união de colunas mantenha as faixas cama - horário e as cláusulas da união de colunas correspondam adequadamente os dados de cama com paciente às faixas cama - horário. Usamos os cálculos a seguir para criar campos aos quais poderíamos unir as colunas. O segundo e o terceiro pegas as informações de horário dos campos de data e hora originais. - **União de colunas cruzada** = `1` - Isso atribui o valor 1 a todas as linhas - **Hora de chegada** = `DATEPART('hour',[Start Time])` - Isso pega o horário da hora de chegada e o retira. Sendo assim, "1/1/18 9:35 AM” se torna apenas "9". - **Hora de saída** = `IFNULL(DATEPART('hour',[End Time]), 24)` - Poderíamos usar `DATEPART('hour',[End Time])`, como fizemos com **Hora de chegada**. Isso pega o horário da hora de saída e o retira. Sendo assim, "1/1/18 4:34 PM” se torna apenas "4". - Mas queremos indicar que a cama com paciente que ainda está ocupada (sem hora de saída) está em uso, não vazia. Para isso, atribuiremos uma hora de saída de 24 (meia-noite) a qualquer hora de saída ausente usando a função `IFNULL`. Se o primeiro argumento `DATEPART('hour',[End Time])` for nulo, o cálculo retornará "24". **Observação**: quer verificar seu trabalho? Baixe o arquivo de fluxo em pacote do Tableau Prep ([Hospital Beds.tflx](https://mkt.tableau.com/PrepTutorials/Hospital%20Beds.tflx)) e o arquivo de pasta de trabalho em pacote do Tableau Desktop ([Hospital Beds.twbx](https://mkt.tableau.com/PrepTutorials/Hospital%20Beds.twbx)). **Recursos**: precisa de mais treinamento? Faça um curso de [treinamento presencial](https://www.tableau.com/pt-br/learn/classroom/prep). Está curioso sobre os recursos compatíveis? Veja os outros tópicos na Ajuda online do Tableau Prep. Procurando recursos adicionais? O post [Domine o Tableau Prep com essa lista de recursos de aprendizado](https://www.tableau.com/pt-br/about/blog/2018/7/master-tableau-prep-list-learning-resources-92064) no blog é para você.