Power Query do Excel não consegue combinar arquivos do SharePoint: Correção

Ao tentar combinar vários arquivos de uma pasta do SharePoint usando o Power Query no Excel, a operação pode falhar com erros como ‘Acesso ao recurso proibido’ ou ‘Não foi possível autenticar com o SharePoint.’ Esse problema geralmente ocorre porque o Power Query não consegue estabelecer uma conexão confiável com o site do SharePoint devido a configurações de autenticação incorretas, permissões ausentes ou uma incompatibilidade na forma como o caminho da pasta é fornecido. Este artigo explica as causas raiz dessa falha e fornece um conjunto claro de etapas para combinar arquivos do SharePoint com sucesso usando o Power Query.

Por que o Power Query falha ao combinar arquivos do SharePoint

O Power Query usa a API REST do SharePoint ou o serviço web legado do SharePoint para ler listas de arquivos e baixar conteúdos. Quando você se conecta a uma pasta do SharePoint usando uma URL como https://contoso.sharepoint.com/sites/marketing/Shared%20Documents/PastaA, o Power Query precisa autenticar no site e então enumerar os arquivos. A operação de combinação falha se alguma destas condições for verdadeira:

• O site do SharePoint exige autenticação moderna (OAuth 2.0) e o Power Query está tentando autenticação legada.
• A conta de usuário não tem permissões de ‘Leitura’ ou ‘Contribuição’ no site ou na pasta específica.
• A pasta contém tipos de arquivo não suportados (como .exe ou .zip) que o Power Query não consegue ler.
• O nível de privacidade da fonte de dados do SharePoint está definido como ‘Particular’, bloqueando a etapa de combinação que mescla dados de vários arquivos.
• A URL inclui um nome de biblioteca de documentos que não é uma lista válida do SharePoint.

A causa raiz mais comum é que os usuários tentam conectar-se diretamente a uma URL de pasta do SharePoint no conector ‘Da Pasta’, que espera um caminho local ou de rede, não uma URL web do SharePoint. O conector ‘Da Lista do SharePoint’ do Power Query foi projetado para funcionar com sites e bibliotecas de documentos do SharePoint, sendo o ponto de partida correto para combinar arquivos.

Etapas para conectar ao SharePoint e combinar arquivos

Siga estas etapas para conectar-se a uma biblioteca de documentos do SharePoint e combinar todos os arquivos Excel de uma pasta específica. Estas etapas pressupõem que você está usando Excel para Microsoft 365 ou Excel 2019 ou posterior.

1. Abra uma pasta de trabalho em branco no Excel
   Comece com uma nova pasta de trabalho. Vá para a guia Dados e clique em Obter Dados > De Outras Fontes > Da Lista do SharePoint.
2. Insira a URL do site do SharePoint
   Na caixa de diálogo, insira a URL raiz do seu site do SharePoint, por exemplo, https://contoso.sharepoint.com/sites/marketing. Não inclua a biblioteca de documentos ou o caminho da pasta. Clique em OK.
3. Faça login com sua conta Microsoft 365
   Se solicitado, selecione Conta Microsoft ou Conta organizacional e faça login com as credenciais que têm acesso ao site do SharePoint. Marque a caixa Usar minhas credenciais atuais se você já estiver logado no Excel. Clique em Conectar.
4. Selecione a biblioteca de documentos
   Após a autenticação, a janela do Navegador mostra uma lista de listas e bibliotecas do SharePoint. Encontre a biblioteca de documentos que contém seus arquivos, por exemplo, Shared Documents. Selecione-a e clique em Transformar Dados para abrir o Editor do Power Query.
5. Filtre para a pasta específica
   No Editor do Power Query, você verá uma tabela com colunas como Nome, Caminho da Pasta e Conteúdo. Clique no ícone de filtro na coluna Caminho da Pasta e escolha Filtros de Texto > Contém. Digite o nome da pasta, por exemplo, PastaA, e clique em OK.
6. Filtre pelo tipo de arquivo desejado
   Clique no ícone de filtro na coluna Nome e escolha Filtros de Texto > Termina Com. Digite .xlsx ou a extensão dos seus arquivos. Clique em OK.
7. Combine os arquivos
   Selecione a coluna Conteúdo. Na guia Página Inicial, clique em Combinar Arquivos. Na caixa de diálogo que aparece, o Power Query irá amostrar um arquivo para determinar a estrutura. Escolha o parâmetro que deseja usar para combinar, como Planilha1, e clique em OK.
8. Carregue os dados combinados
   Após a operação de combinação ser concluída, clique em Fechar e Carregar na guia Página Inicial. O Excel carregará os dados combinados em uma nova planilha.

Se o Power Query ainda não conseguir combinar arquivos do SharePoint

Mesmo após seguir o método de conexão correto, você ainda pode encontrar erros. Abaixo estão os padrões de falha mais comuns e suas correções específicas.

Erro: ‘Acesso ao recurso proibido’

Esse erro significa que o Power Query não tem permissão para ler os arquivos. Verifique se sua conta Microsoft 365 tem pelo menos permissões de Leitura no site do SharePoint e na biblioteca de documentos. Se você estiver usando uma conta de convidado, o administrador do site deve conceder acesso explícito à biblioteca. Para testar, abra o site do SharePoint em um navegador e confirme que você pode visualizar os arquivos manualmente.

Erro: ‘Não foi possível autenticar com o SharePoint’

Esse erro geralmente ocorre porque o token de autenticação expirou ou porque o Power Query está usando credenciais em cache. Vá para Arquivo > Opções > Pasta de Trabalho Atual > Opções de Privacidade e defina o nível de privacidade para fontes de dados do SharePoint como Nenhum. Em seguida, no Power Query, vá para Configurações da Fonte de Dados (na guia Página Inicial do Editor de Consultas), selecione a entrada do SharePoint e clique em Alterar Credenciais. Faça login novamente com sua conta Microsoft 365.

Power Query mostra apenas nomes de pastas, não conteúdos de arquivos

Isso acontece quando o conector de lista do SharePoint retorna a estrutura de pastas, mas não os dados dos arquivos. O problema é que o caminho da pasta contém caracteres especiais ou espaços que não estão codificados corretamente. No Editor do Power Query, use a guia Transformar e selecione Substituir Valores para substituir %20 por um espaço, ou use a função Extrair para analisar o nome correto da pasta a partir da coluna Caminho da Pasta. Em seguida, aplique o filtro novamente.

Operação de combinação falha com ‘DataFormat.Error’

Esse erro indica que um ou mais arquivos na pasta estão corrompidos ou não são arquivos Excel válidos. Antes de combinar, filtre a coluna Nome para excluir quaisquer arquivos que não sejam .xlsx, .xlsb ou .csv. Se você precisar incluir arquivos .xls mais antigos, converta-os para .xlsx usando a interface web do SharePoint ou um conversor de desktop antes de executar o Power Query.

Conector Da Pasta vs Conector Da Lista do SharePoint: Principais Diferenças

Item	Conector Da Pasta	Conector Da Lista do SharePoint
Método de conexão	Usa caminho do sistema de arquivos (local ou rede)	Usa API REST do SharePoint
Autenticação	Autenticação Windows ou anônima	OAuth 2.0 com conta Microsoft 365
Suporta pastas do SharePoint	Não, falha com URL web	Sim, lista todos os arquivos e pastas
Nível de privacidade necessário	Nenhum ou Organizacional	Nenhum ou Organizacional
Etapa de combinar arquivos	Não disponível diretamente	Integrada na coluna Conteúdo

Agora você pode conectar-se a qualquer biblioteca de documentos do SharePoint e combinar vários arquivos Excel em uma única tabela usando o Power Query. Após a configuração inicial, atualize a consulta clicando com o botão direito na consulta no painel Consultas e Conexões e selecionando Atualizar. Para pastas grandes com centenas de arquivos, considere usar o parâmetro Arquivo de Amostra da caixa de diálogo Combinar Arquivos para especificar a planilha e os cabeçalhos exatos, o que evita erros devido a estruturas de arquivo inconsistentes.