Texto/CSV

Resumo

Capacidades suportadas

• Importação

Ligar a um ficheiro de texto/CSV local a partir do Power Query Desktop

Para carregar um texto local ou um arquivo CSV:

1. Selecione a opção Texto/CSV em Obter dados. Esta ação inicia um navegador de arquivos local onde você pode selecionar seu arquivo de texto.

   

   Selecione Abrir para abrir o ficheiro.

2. A partir do Navegador, pode transformar os dados no editor do Power Query selecionando Transformar Dados ou carregar os dados selecionando Carregar.

   

Ligar a um ficheiro de texto/CSV a partir do Power Query Online

Para carregar um texto local ou um arquivo CSV:

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

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

   

3. Selecione um gateway de dados local em Gateway de dados.

4. Introduza um nome de utilizador e uma palavra-passe.

5. Selecione Seguinte.

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

   

Carregar a partir da Web

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

Delimitadores de texto/CSV

O Power Query trata os CSVs como ficheiros estruturados com uma vírgula como delimitador – um caso especial de ficheiro de texto. Se escolher um ficheiro de texto, o Power Query tenta determinar automaticamente se tem valores separados pelo delimitador e qual é esse delimitador. Se ele puder inferir um delimitador, ele o tratará automaticamente como uma fonte de dados estruturada.

Texto não estruturado

Se o teu ficheiro de texto não tiver estrutura, recebes uma única coluna com uma nova linha para cada linha codificada no texto de origem. Como exemplo de texto não estruturado, considere um ficheiro Notepad com o seguinte conteúdo:

Hello world.
This is sample data.

Ao carregá-lo, é apresentada uma tela de navegação que carrega cada uma dessas linhas em sua própria fila.

Só pode configurar uma opção neste diálogo, que é a seleção suspensa de Origem do Ficheiro . Esta lista suspensa permite selecionar qual conjunto de caracteres foi usado para gerar o ficheiro. Atualmente, o conjunto de caracteres não é inferido, e a codificação UTF-8 só é inferida se o conteúdo começar por uma BOM UTF-8.

CSV

Você pode encontrar um arquivo CSV de exemplo aqui.

Além da origem do arquivo, o CSV também suporta a especificação do delimitador e como a deteção de tipo de dados é tratada.

Os delimitadores incluem dois pontos, vírgula, sinal de igual, ponto e vírgula, espaço, tabulação, um delimitador personalizado (que pode ser qualquer sequência de caracteres) e uma largura fixa (dividindo o texto em blocos com um número fixo de caracteres).

O menu suspenso final permite-lhe selecionar como pretende lidar com a deteção de tipos de dados. Pode basear-se nas primeiras 200 linhas ou em todo o conjunto de dados. Também pode optar por desligar a deteção automática de tipos de dados e, em vez disso, deixar todas as colunas para 'Texto'. Aviso: se escolher todo o conjunto de dados, isso pode fazer com que a carga inicial dos dados no editor seja mais lenta.

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

Texto estruturado

Quando o Power Query deteta estrutura no seu ficheiro de texto, trata o ficheiro de texto como um ficheiro de valores separados por delimitadores. Dá-te as mesmas opções disponíveis ao abrir um CSV. Um CSV é essencialmente um ficheiro com uma extensão que indica o tipo de delimitador.

Por exemplo, se guardar o exemplo seguinte como ficheiro de texto, o Power Query lê-lo como tendo um delimitador de tabulação 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

Pode usar esta estrutura para qualquer outro tipo de ficheiro baseado em delimitador.

Fonte de edição

Quando editas a etapa de origem (no painel Passos Aplicados do Power Query Desktop), vês um diálogo ligeiramente diferente do que aconteceu quando carregaste o ficheiro inicialmente. Dependendo de como o ficheiro é atualmente tratado (como texto ou CSV), é apresentado um ecrã com vários menus suspensos.

Utilize o menu suspenso Quebras de linha para selecionar se pretende aplicar quebras de linha no interior de aspas ou não.

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 definires as quebras de linha para Ignorar quebras de linha entre aspas, a amostra carrega com a segunda metade da cadeia por baixo da primeira metade na mesma coluna.

Se definires as quebras de linha para Aplicar todas as quebras de linha, a amostra carrega uma linha extra, sendo o conteúdo após as quebras de linha o único conteúdo nessa linha (a saída exata pode depender da estrutura do conteúdo do ficheiro).

Utilize a lista pendente Abrir ficheiro como para definir como pretende carregar o ficheiro. Esta definição é importante para a resolução de problemas. Para ficheiros estruturados que não são tecnicamente CSV (como um ficheiro de valores separados por tabulações guardado como ficheiro de texto), mantenha Abrir ficheiro como definido para CSV. Essa configuração também determina quais menus suspensos estão disponíveis no restante da caixa de diálogo.

Texto/CSV por exemplo

Texto/CSV Por Exemplo no Power Query é uma funcionalidade disponível geralmente no Power BI Desktop e no Power Query Online. Ao usar o conector Texto/CSV, você verá uma opção para Extrair Tabela Usando Exemplos no canto inferior esquerdo do navegador.

Ao selecionar esse botão, você é 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 Texto/CSV. Depois de inserir a primeira célula da coluna, outras células na coluna sã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 são extraídos com êxito, verifique os dados nas primeiras células.

Depois de concluir a construção dessa tabela, você pode selecionar para carregar ou transformar os dados. Observe como as consultas resultantes contêm um detalhamento detalhado 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.

Solução de problemas

Carregamento de ficheiros a partir da web

Se estiveres a pedir ficheiros de texto/csv da web e também a promover cabeçalhos, e estiveres a recuperar ficheiros suficientes para te preocupares com uma possível limitação, considera envolver a tua Web.Contents chamada com Binary.Buffer(). Neste caso, colocar o ficheiro em memória intermédia antes de promover os cabeçalhos faz com que o ficheiro seja solicitado apenas uma vez.

Trabalhando com arquivos CSV grandes

Se estiver a lidar com ficheiros CSV grandes no editor do Power Query Online, poderá receber um Erro Interno. Trabalha primeiro com um ficheiro CSV de menor tamanho, aplica os passos no editor e, quando terminares, muda o caminho para o ficheiro CSV maior. Este método permite que você trabalhe de forma mais eficiente e reduz suas chances de encontrar um tempo limite no editor online. Não espera encontrar este erro durante o tempo de atualização, pois o serviço permite um tempo de espera mais longo.

Texto não estruturado é interpretado como estruturado

Em casos raros, o Power Query interpreta um documento como um CSV quando números de vírgula semelhantes aparecem ao longo dos parágrafos. Se este problema ocorrer, edite o passo Source no editor do Power Query e selecione Texto em vez de CSV na lista pendente Abrir ficheiro como.

Colunas no Power BI Desktop

Quando importa um ficheiro CSV, o Power BI Desktop gera um passo columns=x no editor Power Query, onde x é o número de colunas no ficheiro CSV durante a importação inicial. Se mais tarde adicionares mais colunas e definires a fonte de dados para atualizar, a operação de atualização não inclui colunas para além do número inicial x de colunas.

Erro: Conexão fechada pelo host

Ao carregar ficheiros Text/CSV de uma fonte web e promover cabeçalhos, pode por vezes 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 estes erros ao empregar medidas de proteção e fechar uma ligação que pode ser temporariamente pausada, como ao esperar por outra ligação de fonte de dados para uma operação de junção ou anexação. Para contornar estes erros, tente adicionar uma chamada a Binary.Buffer (recomendado) ou a Table.Buffer. Estas funções descarregam o ficheiro, carregam-no na memória e fecham imediatamente a ligação. Esta ação impede qualquer pausa durante o download e impede que o host feche à força a ligação antes de o conteúdo ser recuperado.

O exemplo a seguir ilustra essa solução alternativa. Esse buffering 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")))