Os 5 principais erros ao conectar o Power BI a pastas do SharePoint

By Mirko Peters · 2026-08-12 · Updated 2026-08-29

Bem-vindo de volta ao podcast! Se você já tentou puxar dados do SharePoint para o Power BI, sabe que isso pode parecer montar um quebra-cabeça no escuro…

Automatically translated with AI from the original post. Read the English original

Bem-vindo de volta ao podcast! Se você já tentou importar dados do SharePoint para o Power BI, sabe que pode parecer um quebra-cabeça montado no escuro. Entre falhas misteriosas de atualização, loops de autenticação sem fim e arquivos ocultos inesperados inflando seus modelos semânticos, transformar o caos do SharePoint em clareza exige uma boa dose de habilidade. Neste guia completo, aprofundamos tudo o que abordamos no nosso episódio mais recente. Se você quer se aprofundar em como transformar bibliotecas de documentos desorganizadas em painéis bem acabados, não deixe de conferir o episódio relacionado Connect Power BI Desktop to SharePoint Folders.

Evite falhas frustrantes de atualização de dados e erros de autenticação entendendo como o Power BI lida com fontes do SharePoint. A seguir, detalhamos os principais erros, as verdades surpreendentes por trás dos bastidores e as melhores práticas para garantir que seus pipelines de relatórios funcionem como um relógio.

Pré-requisitos para Power BI e SharePoint

Antes de conectar as bibliotecas de documentos do SharePoint aos painéis do Power BI, a preparação é sua melhor defesa. Ir direto para o assistente de conexão sem verificar as especificações do seu sistema ou as permissões é receita certa para modelos de dados quebrados e horas perdidas com solução de problemas.

5 fatos surpreendentes sobre como usar o Power BI com pastas do SharePoint

Se você precisa conectar o SharePoint ao Power BI, aqui estão cinco fatos surpreendentes que podem melhorar seus fluxos de trabalho e evitar erros comuns.

1. A atualização no nível da pasta pode ignorar arquivos alterados: o conector de Pasta do SharePoint do Power BI trata a pasta como uma única fonte de dados; quando arquivos são adicionados ou atualizados, a atualização incremental ou as configurações de cache podem não detectar alterações em arquivos individuais, a menos que os metadados da pasta (como a data de modificação) sejam incluídos na consulta.
2. Diferenças de autenticação importam para a mesma URL: a mesma URL de site do SharePoint pode exigir métodos de autenticação diferentes (OAuth vs. Organizacional) dependendo de como você se conecta (Pasta do SharePoint vs. Lista Online do SharePoint), o que pode causar falhas de atualização no serviço do Power BI se não for configurado de forma consistente.
3. Arquivos ocultos e arquivos de sistema aparecem por padrão: ao usar o conector de Pasta do SharePoint, o Power BI retorna todos os arquivos da pasta, incluindo arquivos ocultos e de sistema (como desktop.ini ou arquivos temporários ~$). Filtrar por extensão de arquivo ou caminho costuma ser necessário para evitar ruído na importação.
4. Caminhos relativos oferecem portabilidade, mas quebram a atualização automática se não forem configurados corretamente: usar caminhos relativos e a raiz do site do SharePoint nas consultas torna os arquivos PBIX portáteis entre ambientes, mas o serviço do Power BI precisa de credenciais gateway configuradas corretamente e da mesma URL base para atualizar; divergências levam a erros de fonte de dados desconhecida.
5. Os metadados do SharePoint podem ser mais ricos do que o conteúdo dos arquivos: o SharePoint armazena metadados (colunas, propriedades personalizadas) que você pode trazer junto com o conteúdo dos arquivos no Power BI; às vezes, esses metadados fornecem campos de relatório mais valiosos do que a análise do próprio conteúdo dos arquivos, permitindo evitar transformações de dados pesadas.

Instalar o Power BI Desktop

Você precisa do Power BI Desktop para se conectar e trabalhar com dados do SharePoint. O Power BI Desktop é um aplicativo gratuito da Microsoft. Ele permite criar, transformar e visualizar seus dados antes de compartilhá-los com outras pessoas. Certifique-se de que seu computador atende aos requisitos mínimos do sistema antes de iniciar o instalador.

Acesso e permissões

Você precisa ter as permissões corretas para acessar dados do SharePoint no Power BI. O SharePoint usa configurações de segurança para controlar quem pode visualizar ou editar dados. O Power BI respeita essas configurações, então é preciso garantir que você tenha acesso antes de começar.

Identificar o tipo de dados do SharePoint

Você deve saber que tipo de dados deseja conectar ao Power BI. O SharePoint armazena dados de diferentes maneiras, como listas, pastas ou bibliotecas de documentos. Cada tipo funciona melhor com um conector específico no Power BI.

Dica: faça uma lista dos sites, listas ou pastas do SharePoint que você pretende usar. Anote as URLs e verifique se você tem acesso. Essa etapa economiza tempo e ajuda a evitar erros durante a configuração.

Reunir URLs de sites e credenciais

Você precisa coletar as URLs corretas dos sites do SharePoint e as credenciais antes de conectar seus dados ao Power BI. Comece identificando o site do SharePoint que contém seus dados. Procure o endereço do site na barra de endereços do navegador quando você acessar a página do SharePoint.

Escolha o conector certo

Selecionar o conector certo é essencial quando você quer conectar dados do SharePoint ao Power BI. Cada conector tem uma finalidade específica e funciona melhor com determinados tipos de dados do SharePoint.

Conector de pasta do SharePoint

Quando usar

Você deve usar o Conector de pasta do SharePoint quando seus dados estiverem armazenados como arquivos em bibliotecas ou pastas de documentos do SharePoint. Esse conector é ideal para situações em que você precisa importar arquivos do Excel, CSVs ou outros documentos de várias pastas.

Dados compatíveis

O Conector de pasta do SharePoint oferece suporte a arquivos como pastas de trabalho do Excel, arquivos CSV e outros tipos de documento. Você pode extrair metadados desses arquivos, incluindo nomes de arquivo, caminhos e datas de modificação.

Conector de lista do SharePoint

Quando usar

Você deve usar o Conector de lista do SharePoint quando quiser recuperar dados de uma lista do SharePoint. As listas do SharePoint são coleções de dados estruturados, como tarefas, contatos ou inventário.

Dados compatíveis

O Conector de lista do SharePoint oferece suporte a dados de lista estruturados. Você pode acessar colunas, linhas e metadados das listas.

Conector de lista do SharePoint Online

Principais diferenças

O Conector de lista do SharePoint Online foi projetado especificamente para o SharePoint Online. Ele simplifica o acesso a listas estruturadas e oferece desempenho melhor em comparação com os outros conectores.

Melhores casos de uso

Você deve usar o Conector de lista do SharePoint Online quando precisar de acesso rápido a listas estruturadas no SharePoint Online. Esse conector é eficaz para painéis que exigem informações atualizadas e taxas de atualização rápidas.

Passo a passo: conectar dados do SharePoint

Conectar seus dados do SharePoint ao Power BI envolve alguns passos claros. Você pode seguir este guia para garantir uma integração tranquila e bem-sucedida.

Abrir o Power BI e obter dados

Comece iniciando o Power BI Desktop no seu computador. Use o recurso "Obter Dados", pesquise por SharePoint e selecione o conector apropriado.

Informar a URL do site do SharePoint

Depois de selecionar o conector certo, informe a URL do seu site do SharePoint. Use sempre o endereço do site raiz, em vez de um caminho de arquivo mais profundo, para manter suas consultas estáveis.

Autenticar a conexão

Autentique-se usando sua conta organizacional. Esteja preparado para solicitações de autenticação multifator caso as políticas de segurança corporativas exijam.

Selecionar e transformar dados

Use a janela Navegador para visualizar seus dados. Abra o Power Query para filtrar arquivos do sistema, remover colunas desnecessárias e promover cabeçalhos antes de carregar o conjunto de dados.

Carregar dados no Power BI

Quando as transformações estiverem concluídas, clique em "Fechar e Aplicar" para importar seus dados tratados para o modelo semântico.

Solucionar problemas de conexão

Mesmo com um planejamento cuidadoso, às vezes as coisas podem falhar. Vamos ver como lidar com URLs inválidas, problemas de autenticação, arquivos ausentes e atualizações de dados travadas.

URL inválida

Verifique novamente a barra de endereços. Erros de URL inválida geralmente decorrem de erros de digitação, barras finais ou caracteres especiais em nomes de pastas.

Erros de autenticação

Certifique-se de que você está entrando com as credenciais organizacionais corretas. Lembre-se de que o Power BI não oferece suporte a redirecionamentos não HTTPS.

Dados ausentes

Se arquivos estiverem faltando, verifique os limites de tamanho de arquivo (arquivos acima de 1 GB podem causar problemas) e confirme que arquivos ocultos do sistema não sobrecarregaram a consulta da sua pasta.

Problemas de atualização

Desconexões do gateway e tokens OAuth expirados são os principais causadores de falhas nas atualizações agendadas no serviço do Power BI. Mantenha seu gateway atualizado e alinhe as credenciais da sua conta.

Melhores práticas para dados do SharePoint

Para manter seu ambiente de relatórios escalável e saudável, mantenha estruturas de pastas organizadas, implemente segurança em nível de linha quando necessário e agende as atualizações em horários de menor uso.

Manter os dados atualizados

Aproveite o agendamento automatizado ou os gatilhos do Power Automate para atualizar os modelos semânticos imediatamente após os documentos de origem serem modificados.

Organizar para relatórios

Mantenha seus arquivos de origem estruturados, com nomes de colunas consistentes e hierarquias de diretórios claras, para tornar o dobramento de consultas e as transformações de dados mais simples.

Proteger dados sensíveis

Restrinja o acesso às listas e bibliotecas subjacentes do SharePoint apenas aos usuários que realmente precisam de visibilidade administrativa, espelhando as restrições de público do Power BI.

Criar e compartilhar painéis do Power BI

Depois que seus dados estiverem limpos e carregados, é hora de criar visuais impactantes e distribuí-los pela sua equipe.

Criar visuais

Use gráficos de barras para comparações entre categorias, gráficos de linhas para tendências e tabelas de matriz para detalhamentos. Mantenha a poluição visual no mínimo.

Publicar e compartilhar

Publique seus relatórios no Power BI Service e incorpore-os diretamente em sites de equipe do SharePoint Online para uma colaboração sem atritos.

Programar a atualização de dados

Configure as definições de atualização automática para garantir que as partes interessadas estejam sempre visualizando os dados mais recentes disponíveis.

Conectar dados do SharePoint ao Power BI é uma das formas mais eficazes de democratizar dados na sua organização. Ao respeitar a estrutura de pastas, tratar as credenciais corretamente e usar o Power Query para as transformações iniciais, você pode eliminar silos de dados de uma vez por todas. Para acompanhar a conversa completa, ouça o episódio inteiro e acesse recursos adicionais em Connect Power BI Desktop to SharePoint Folders!

Conectar o SharePoint ao Power BI Desktop - Checklist

• Confirme a URL da pasta do SharePoint e as permissões de acesso
• Entre no Power BI Desktop com a mesma conta que tem acesso ao SharePoint
• No Power BI Desktop, acesse Obter Dados > Pasta do SharePoint
• Informe a URL do site ou da pasta raiz do SharePoint (use a URL do site para o SharePoint Online)
• Escolha o método de autenticação adequado (conta organizacional / OAuth)
• Valide a conexão e visualize a lista de arquivos antes de carregar
• Filtre os resultados da pasta pelo caminho da pasta ou pela extensão do arquivo (por exemplo, .csv, .xlsx)
• Use Combinar Arquivos ou Transformar Dados no Power Query, conforme necessário
• Configure as etapas da consulta para remover colunas desnecessárias e promover os cabeçalhos
• Configure a atualização incremental ou as definições de carregamento de dados para conjuntos de dados grandes
• Substitua caminhos fixos por parâmetros se for implantar em vários ambientes
• Teste a atualização no Power BI Desktop antes de publicar
• Publique o relatório no Power BI Service e configure as credenciais do conjunto de dados
• Configure o gateway (se estiver usando o SharePoint local) ou garanta a autenticação na nuvem para o SharePoint Online
• Programe a atualização e verifique o histórico de atualizações e as falhas
• Documente as fontes de dados, as etapas de transformação e os requisitos de acesso

Perguntas frequentes

Como encontro a URL correta do site do SharePoint para o Power BI?

Você pode copiar a URL do site na barra de endereços do navegador ao acessar o seu site do SharePoint. Certifique-se de usar o endereço principal do site, e não um link de arquivo ou de lista específica.

Quais permissões são necessárias para conectar o Power BI ao SharePoint?

Você precisa de pelo menos acesso de "Leitura" ao site, à lista ou à biblioteca do SharePoint. Se você não consegue ver os dados no SharePoint, também não os verá no Power BI.

É possível atualizar os painéis do Power BI automaticamente com dados do SharePoint?

Sim. Você pode configurar atualizações programadas no Power BI Service. Assim, seus painéis permanecem atualizados com os dados mais recentes do SharePoint, sem etapas manuais.

Qual conector do SharePoint devo usar para bibliotecas de documentos?

Você deve usar o conector Pasta do SharePoint. Ele funciona melhor para importar arquivos como Excel ou CSV de bibliotecas de documentos.

É possível compartilhar painéis do Power BI com pessoas de fora da sua organização?

Sim, você pode compartilhar painéis com usuários externos se o seu administrador permitir o acesso de convidados. Sempre siga as políticas de compartilhamento de dados da sua empresa antes de compartilhar informações sensíveis.

O Power BI oferece suporte à autenticação multifator para conexões com o SharePoint?

Sim. O Power BI oferece suporte à autenticação multifator. Você pode precisar aprovar os logins pelo seu telefone ou aplicativo de autenticação durante o processo de conexão.

conecte um SharePoint para integração de dados e visualização com o Power BI

Como conecto o SharePoint ao Power BI usando uma pasta do SharePoint ou um único arquivo?

Para conectar ao SharePoint, abra o Power BI Desktop e escolha Obter Dados > Pasta do SharePoint (para vários arquivos) ou Obter Dados > Lista do SharePoint Online / Excel (para um único arquivo do SharePoint). Informe a URL do site ou o caminho da pasta, autentique-se com sua conta Microsoft ou as credenciais organizacionais e, em seguida, use o Editor de Consultas para filtrar a subpasta ou o arquivo específico e carregar os dados para análise.

Posso conectar uma biblioteca do SharePoint hospedada no OneDrive ou no Microsoft 365 ao Power BI?

Sim. O OneDrive para Empresas e o SharePoint Online (parte do Microsoft 365) podem ser conectados ao Power BI. Use o conector Pasta do SharePoint ou o conector do OneDrive, dependendo de onde os arquivos estão armazenados.

Qual é a forma recomendada de carregar os dados se eu tiver muitos arquivos e subpastas?

Use o conector de pasta do SharePoint para carregar os dados no Power BI e, em seguida, no Editor de Consultas, aplique filtros na coluna de caminho da pasta ou no nome da subpasta para limitar os resultados ao local específico do SharePoint ou aos arquivos e pastas de que você precisa.

Como configuro a atualização agendada e quando preciso de um Power BI Gateway?

Se o seu conteúdo do SharePoint estiver no SharePoint Online (nuvem), a atualização agendada pode ser configurada no serviço do Power BI sem um gateway local. Se os arquivos estiverem em um servidor SharePoint local ou em um servidor de arquivos on-premises, instale e configure o Power BI Gateway para habilitar a atualização dos dados.

Posso usar Power Query e DAX ao conectar o SharePoint ao Power BI?

Sim. Use o Editor de Consultas (Power Query) para limpar, transformar e combinar os dados dos arquivos do SharePoint antes de carregá-los. Depois do carregamento, use DAX no Power BI para criar colunas calculadas, medidas e análises avançadas para visualização e geração de relatórios.

Como me conecto a uma subpasta específica do SharePoint ou a um único arquivo Excel do SharePoint?

Depois de se conectar à pasta do SharePoint, use a coluna de caminho da pasta no Editor de Consultas para filtrar pela subpasta ou pelo nome do arquivo específico. Para um único arquivo Excel do SharePoint, você também pode colar o link direto do arquivo em Obter Dados > Web ou Excel.

Quais são os problemas comuns de autenticação ao tentar conectar o SharePoint ao Power BI e como resolvê-los?

Os problemas mais comuns incluem o uso de uma conta Microsoft pessoal em vez de uma conta organizacional do Microsoft 365, URL do site incorreta ou credenciais expiradas. Certifique-se de entrar com a conta Microsoft correta, que tenha acesso ao local do SharePoint.

Existe uma forma de conectar arquivos do SharePoint diretamente para visualização em tempo real ou preciso importar os dados?

Normalmente você importa os dados para o Power BI para visualização, mas, em cenários quase em tempo real, é possível configurar atualizações agendadas frequentes. O Power BI não oferece nativamente uma conexão ativa com arquivos do SharePoint como acontece com um banco de dados.

Como trato arquivos aninhados e mantenho a estrutura de pastas ao carregar arquivos no Power BI?

Conecte-se à pasta do SharePoint e mantenha a coluna de caminho da pasta durante a importação. No Editor de Consultas, você pode expandir e analisar o caminho da pasta para extrair segmentos específicos, preservando a hierarquia e criando filtros.

Onde posso encontrar mais orientações ou tutoriais sobre como conectar o SharePoint ao Power BI, incluindo recursos da comunidade?

O Microsoft Learn oferece documentação oficial e guias passo a passo sobre a integração do SharePoint com o Power BI. Os fóruns da comunidade do Microsoft Fabric e da comunidade do Power BI também oferecem exemplos práticos e soluções de outros usuários.