Texto/CSV

Resumo

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.

   

   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.

   

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.

   

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.

   

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

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 para cada linha codificada no texto de origem. Como exemplo de texto não estruturado, considere 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.

Você pode configurar apenas uma opção nesta caixa de diálogo: a lista suspensa 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.

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.

Os delimitadores incluem os dois-pontos, a vírgula, o sinal de igualdade, o ponto e vírgula, o espaço, a tabulação, um delimitador personalizado (que pode ser qualquer sequência de caracteres) e uma largura fixa (dividindo o texto por um determinado número de caracteres).

O menu suspenso final permite selecionar como você deseja lidar com a detecção de tipos de dados. Você pode baseá-lo nas primeiras 200 linhas ou em todo o conjunto de dados. Você também pode optar por desativar 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ê escolher todo o conjunto de dados, isso poderá fazer com que a carga inicial dos dados no editor seja mais lenta.

Como a inferência pode estar incorreta, verifique duas vezes as configurações antes de carregar.

Texto estruturado

Quando Power Query detecta estrutura em seu arquivo de texto, ele trata o arquivo de texto como um arquivo de valor separado por delimitador. Ele oferece as mesmas opções disponíveis ao abrir um CSV. Um CSV é 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, Power Query lê-o 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

Você pode usar essa estrutura para qualquer tipo de outro arquivo baseado em delimitador.

Editando origem

Ao editar a etapa de origem (no painel Etapas Aplicadas do Power Query Área de Trabalho), você verá uma caixa de diálogo ligeiramente diferente de quando carregar o arquivo inicialmente. Dependendo de como o arquivo é tratado atualmente (como texto ou CSV), é exibida uma tela com vários menus suspensos.

Use a lista suspensa Quebras de linha para selecionar se deseja aplicar ou não quebras de linha dentro de aspas.

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 você definir Quebras de linha como Ignorar quebras de linha entre aspas, o exemplo é carregado com a segunda metade da string abaixo da primeira metade, na mesma coluna.

Se você definir quebras de linha para Aplicar todas as quebras de linha, o 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).

Use o menu suspenso Abrir arquivo como para definir como deseja carregar o arquivo. Essa configuração é importante para solução de problemas. Para arquivos estruturados que tecnicamente não são CSVs (como um arquivo de valores separados por tabulação salvo como arquivo de texto), mantenha Abrir arquivo como definido como CSV. Essa configuração também determina quais menus suspensos estão disponíveis nas demais partes da caixa de diálogo.

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.

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.

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.

Resolução de problemas

Carregando arquivos da Web

Se você estiver solicitando arquivos text/csv da web e também promovendo os cabeçalhos, e estiver recuperando arquivos em quantidade suficiente para precisar se preocupar com uma possível limitação de taxa, considere encapsular a chamada Web.Contents com Binary.Buffer(). Nesse caso, armazenar o arquivo em buffer antes de promover os 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. 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. Você não espera encontrar esse erro durante o tempo de atualização, pois o serviço permite um tempo limite maior.

O texto não estruturado é interpretado como estruturado

Em casos raros, Power Query interpreta um documento como um CSV quando números de vírgula semelhantes aparecem entre parágrafos. Se esse problema ocorrer, edite a etapa Origem no editor de 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, Power BI Desktop gera uma etapa columns=x no editor de Power Query, em que x é o número de colunas no arquivo CSV durante a importação inicial. Se mais tarde você adicionar mais colunas e definir a fonte de dados para atualizar, a operação de atualização não inclui nenhuma coluna além da contagem x inicial de colunas.

Erro: Conexão fechada por host

Ao carregar arquivos text/CSV de uma fonte da Web e 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, como 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 . Essas funções baixam o arquivo, carregam-no na memória e fecham imediatamente a conexão. Essa ação impede qualquer pausa durante o download e impede 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")))