Compartilhar via

Texto/CSV

Resumo

Elemento Descrição
Estado da liberação Disponibilidade geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (fluxos de dados)
Fabric (Fluxo de dados Gen2)
Power Apps (fluxos de dados)
Dynamics 365 Customer Insights
Analysis Services
Documentação de referência da função File.Contents
Lines.FromBinary
Csv.Document

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Capacidades suportadas

  • Importação

Conectar-se ao arquivo de texto/CSV local do Power Query Desktop

Para carregar um texto local ou um arquivo CSV:

  1. Selecione a opção Texto/CSV em Obter Dados. Essa ação inicia um navegador de arquivos local no qual você pode selecionar seu arquivo de texto.

    Captura de tela do navegador de arquivos aberto quando você faz sua seleção de arquivo de texto.

    Escolha Abrir para abrir o arquivo.

  2. No Navegador, você pode transformar os dados no editor do Power Query selecionando Transformar Dados ou carregar os dados selecionando Carregar.

    Captura de tela do texto de exemplo no Navegador.

Conectar-se ao arquivo de texto/CSV do Power Query Online

Para carregar um texto local ou um arquivo CSV:

  1. Na página Fontes de dados , selecione Texto/CSV.

  2. Nas configurações de conexão, carregue o arquivo ou insira um caminho de arquivo para o texto local ou o arquivo CSV desejado.

    Captura de tela da tela de seleção de arquivo de texto online.

  3. Selecione um gateway de dados local no gateway de dados.

  4. Digite um nome de usuário e uma senha.

  5. Selecione Próximo.

  6. No Navegador, selecione Transformar Dados para começar a transformar os dados no editor do Power Query.

    Captura de tela da janela do navegador online em que você seleciona Transformar dados.

Carregar da Web

Para carregar um texto ou arquivo CSV da Web, selecione o conector Web, insira o endereço Web do arquivo e siga os prompts de credencial.

Delimitadores de Texto/CSV

O Power Query trata os CSVs como arquivos estruturados com uma vírgula como delimitador— um caso especial de um arquivo de texto. Se você escolher um arquivo de texto, o Power Query tentará determinar automaticamente se ele tem valores separados por delimitador e o que é esse delimitador. Se ele puder inferir um delimitador, ele o tratará automaticamente como uma fonte de dados estruturada.

Texto não estruturado

Se o arquivo de texto não tiver estrutura, você obterá uma única coluna com uma nova linha por linha codificada no texto de origem. Como um exemplo de texto não estruturado, você pode considerar um arquivo de bloco de notas com o seguinte conteúdo:

Hello world.
This is sample data.

Ao carregar o aplicativo, é apresentada uma tela de navegação que carrega cada uma dessas linhas em uma linha separada.

Captura de tela do navegador com dados carregados de um simples arquivo de texto não estruturado.

Há apenas uma coisa que você pode configurar nesta caixa de diálogo, que é o menu suspenso Origem do Arquivo. Esse menu suspenso permite que você selecione qual conjunto de caracteres foi usado para gerar o arquivo. Atualmente, o conjunto de caracteres não é inferido e UTF-8 só é inferido se ele começa com um BOM UTF-8.

Captura de tela da seleção de cultura de arquivo para Texto/CSV.

CSV

Você pode encontrar um arquivo CSV de exemplo aqui.

Além da origem do arquivo, o CSV também dá suporte à especificação do delimitador e à maneira como a detecção de tipo de dados é tratada.

Captura de tela do navegador mostrando dados carregados de um arquivo csv.

Os delimitadores disponíveis incluem dois-pontos, vírgula, sinal de igual, ponto e vírgula, espaço, tabulação, um delimitador personalizado (que pode ser qualquer cadeia de caracteres) e uma largura fixa (dividindo o texto por um número padrão de caracteres).

Captura de tela da seleção do delimitador para um arquivo csv.

A lista suspensa final permite que você selecione como deseja lidar com a detecção de tipo de dados. Isso pode ser feito com base nas primeiras 200 linhas ou em todo o conjunto de dados. Além disso, você pode optar por não fazer a detecção automática de tipo de dados e, em vez disso, permitir que todas as colunas padrão sejam 'Text'. Aviso: se você fizer isso em todo o conjunto de dados, isso poderá fazer com que a carga inicial dos dados no editor seja mais lenta.

Captura de tela da seleção de inferência de tipo de dados para um arquivo csv.

Como a inferência pode estar incorreta, vale a pena verificar duas configurações antes de carregar.

Texto estruturado

Quando o Power Query pode detectar a estrutura para o arquivo de texto, ele trata o arquivo de texto como um arquivo de valor separado delimitador e fornece as mesmas opções disponíveis ao abrir um CSV, que é essencialmente um arquivo com uma extensão que indica o tipo de delimitador.

Por exemplo, se você salvar o exemplo a seguir como um arquivo de texto, ele será lido como tendo um delimitador de guia em vez de texto não estruturado.

Column 1	Column 2	Column 3
This is a string.	1	ABC123
This is also a string.	2	DEF456

Captura de tela mostrando os dados carregados de um arquivo de texto estruturado.

Essa estrutura pode ser usada para qualquer tipo de outro arquivo baseado em delimitador.

Editando origem

Ao editar a etapa de origem (no painel etapas aplicadas do Power Query Desktop), você é apresentado com uma caixa de diálogo ligeiramente diferente do que quando é carregado inicialmente. Dependendo de como você está tratando o arquivo no momento (ou seja, como texto ou csv), você é apresentado a uma tela com vários menus suspensos.

Captura de tela da caixa de diálogo em que você edita a etapa de origem em uma consulta acessando um arquivo CSV.

O menu suspenso Quebras de linha permite que você selecione se deseja aplicar quebras de linha que estão dentro de aspas ou não.

Captura de tela da lista suspensa em que você seleciona o estilo de quebra de linha para um arquivo CSV.

Por exemplo, se você editar o exemplo 'estruturado' fornecido anteriormente, poderá adicionar uma quebra de linha.

Column 1	Column 2	Column 3
This is a string.	1	"ABC
123"
This is also a string.	2	"DEF456"

Se quebras de linha estiverem definidas como Ignorar quebras de linha entre aspas, este exemplo será carregado com a segunda metade da string abaixo da primeira metade na mesma coluna.

Carregamento de um arquivo CSV com quebras de linha entre aspas ignoradas.

Se as quebras de linha estiverem definidas como Aplicar todas as quebras de linha, esse exemplo carregará uma linha extra, com o conteúdo após a quebra de linha sendo o único conteúdo nessa linha (a saída exata pode depender da estrutura do conteúdo do arquivo).

Carregamento de um arquivo CSV com quebras de linha entre aspas aplicadas.

O menu suspenso Abrir arquivo como permite que você edite como deseja carregar o arquivo, o que é importante para a solução de problemas. Para arquivos estruturados que tecnicamente não são CSVs (como um arquivo de valor separado por tabulação salvo como um arquivo de texto), você ainda deve configurar abrir o arquivo como CSV. Essa configuração também determina quais menus suspensos estão disponíveis nas demais partes da caixa de diálogo.

Alterando o tipo de arquivo.

Texto/CSV por exemplo

Texto/CSV por Exemplo no Power Query é um recurso geralmente disponível no Power BI Desktop e no Power Query Online. Ao usar o conector Text/CSV, você verá uma opção para extrair tabela usando exemplos no canto inferior esquerdo do navegador.

Usando a opção Extrair Tabela usando Exemplos.

Ao selecionar esse botão, você será levado para a página Extrair Tabela usando Exemplos . Nesta página, você especifica valores de saída de exemplo para os dados que deseja extrair do arquivo Text/CSV. Depois de inserir a primeira célula da coluna, outras células na coluna serão preenchidas. Para que os dados sejam extraídos corretamente, talvez seja necessário inserir mais de uma célula na coluna. Se algumas células na coluna estiverem incorretas, você poderá corrigir a primeira célula incorreta e os dados serão extraídos novamente. Para garantir que os dados foram extraídos com êxito, verifique os dados nas primeiras células.

Observação

Recomendamos que você insira os exemplos por ordem de coluna. Depois que a coluna for preenchida com êxito, crie uma nova coluna e comece a inserir exemplos na nova coluna.

Especifique valores de saída de exemplo para extrair dados.

Depois de concluir a construção dessa tabela, você poderá selecionar para carregar ou transformar os dados. Observe como as consultas resultantes contêm um detalhamento de todas as etapas que foram inferidas para a extração de dados. Essas etapas são etapas de consulta regulares que você pode personalizar conforme necessário.

Detalhamento das etapas para extração de dados.

Resolução de problemas

Carregando arquivos da Web

Se você estiver solicitando arquivos de texto/csv da Web e também enviando cabeçalhos, e estiver recuperando uma quantidade significativa de arquivos que pode resultar em uma possível restrição devido ao excesso de solicitações, considere usar Web.Contents para envolver sua chamada Binary.Buffer(). Nesse caso, o buffer do arquivo antes de promover cabeçalhos faz com que o arquivo seja solicitado apenas uma vez.

Trabalhando com arquivos CSV grandes

Se você estiver lidando com arquivos CSV grandes no editor do Power Query Online, poderá receber um Erro Interno. Sugerimos que você trabalhe com um arquivo CSV de tamanho menor primeiro, aplique as etapas no editor e, depois de terminar, altere o caminho para o arquivo CSV maior. Esse método permite que você trabalhe com mais eficiência e reduz as chances de ocorrer um timeout no editor online. Não esperamos que você encontre esse erro durante o tempo de atualização, pois permitimos um tempo limite maior.

Texto não estruturado sendo interpretado como estruturado

Em casos raros, um documento com números de vírgula semelhantes entre parágrafos pode ser interpretado como um CSV. Se esse problema acontecer, edite a etapa Origem no editor do Power Query e selecione Texto em vez de CSV na seleção suspensa Abrir Arquivo Como .

Colunas no Power BI Desktop

Quando você importa um arquivo CSV, o Power BI Desktop gera uma columns=x (em que x é o número de colunas no arquivo CSV durante a importação inicial) como uma etapa no editor do Power Query. Se mais tarde você adicionar mais colunas e a fonte de dados estiver definida para atualizar, todas as colunas além da contagem x inicial de colunas não serão atualizadas.

Erro: Conexão fechada por host

Ao carregar arquivos Text/CSV de uma fonte da Web e também promover cabeçalhos, às vezes você pode encontrar os seguintes erros: "An existing connection was forcibly closed by the remote host" ou "Received an unexpected EOF or 0 bytes from the transport stream." o host pode causar esses erros empregando medidas de proteção e fechando uma conexão que pode estar temporariamente pausada, por exemplo, ao aguardar outra conexão de fonte de dados para uma operação de junção ou acréscimo. Para contornar esses erros, tente adicionar uma chamada Binary.Buffer (recomendada) ou Table.Buffer , que baixa o arquivo, carrega-o na memória e fecha imediatamente a conexão. Essa ação deve impedir qualquer pausa durante o download e impedir que o host feche a conexão à força antes que o conteúdo seja recuperado.

O exemplo a seguir ilustra essa solução alternativa. Esse buffer precisa ser feito antes que a tabela resultante seja passada para Table.PromoteHeaders.

  • Original:
Csv.Document(Web.Contents("https://.../MyFile.csv"))
  • Com Binary.Buffer:
Csv.Document(Binary.Buffer(Web.Contents("https://.../MyFile.csv")))
  • Com Table.Buffer:
Table.Buffer(Csv.Document(Web.Contents("https://.../MyFile.csv")))
  • Last updated on