Para obter dados do SharePoint no Power BI, você pode usar três caminhos principais: conectar uma pasta inteira do SharePoint, importar uma lista diretamente ou apontar para um arquivo específico, como uma planilha Excel. O caminho certo depende de como seus dados estão organizados no SharePoint.
Essa integração é especialmente útil para equipes que já armazenam relatórios, planilhas e registros no SharePoint e querem transformar essas informações em dashboards e relatórios visuais sem precisar exportar ou copiar dados manualmente.
O Power BI Desktop oferece conectores nativos para o SharePoint Online, o que torna o processo relativamente direto. Mas alguns detalhes, como o formato correto da URL do site, o tipo de autenticação e as permissões necessárias, fazem diferença entre uma conexão que funciona e uma que gera erro. Este guia cobre cada um desses pontos de forma prática.
Qual é a URL do site do SharePoint que devo usar?
A URL correta é a do site raiz ou do subsite onde seus dados estão armazenados, e não a URL completa de uma pasta ou arquivo específico. Esse é um dos erros mais comuns ao tentar configurar a conexão.
Por exemplo, se o endereço completo de uma pasta no seu SharePoint é:
https://suaempresa.sharepoint.com/sites/Marketing/Documentos/Relatórios
A URL que você deve usar no Power BI é apenas:
https://suaempresa.sharepoint.com/sites/Marketing
Tudo que vem depois do nome do site, como o nome da biblioteca ou da pasta, é configurado dentro do próprio Power BI após a conexão ser estabelecida. Inserir a URL completa com subpastas costuma gerar erros de conexão ou retornar resultados vazios.
Se você não sabe exatamente qual é o endereço do seu site, acesse o SharePoint pelo navegador e copie apenas a parte da URL até o nome do site. Para entender melhor como o SharePoint organiza seus endereços e estruturas, vale conferir o que é o SharePoint e para que ele serve.
Sites de equipe no Microsoft Teams geralmente seguem o padrão /sites/NomeDoSite, enquanto sites de comunicação podem usar /sites/ ou caminhos personalizados definidos pelo administrador.
Como conectar o Power BI a uma pasta do SharePoint?
Essa abordagem é ideal quando você tem vários arquivos do mesmo formato em uma pasta e quer consolidar todos os dados em um único conjunto. O Power BI lê todos os arquivos da pasta e os combina automaticamente.
Para fazer a conexão, siga estes passos no Power BI Desktop:
- Clique em Obter Dados na aba Início.
- Pesquise por Pasta do SharePoint e selecione o conector.
- Insira a URL do site (apenas até o nome do site, como explicado anteriormente).
- Clique em OK e autentique com sua conta Microsoft.
- Na janela de navegação, localize a pasta desejada dentro da biblioteca de documentos.
- Clique em Transformar Dados para abrir o Power Query e filtrar ou combinar os arquivos conforme necessário.
Depois de autenticado, o Power BI exibirá uma lista com todos os arquivos encontrados no site, incluindo metadados como nome, data de modificação e caminho. Você pode filtrar essa lista para trabalhar apenas com os arquivos da pasta específica que deseja.
Se você ainda não tem uma estrutura de pastas organizada no SharePoint, entender como criar pastas no SharePoint pode ser um bom ponto de partida antes de configurar a conexão.
Como combinar vários arquivos de uma pasta?
Depois de conectar a pasta do SharePoint, o Power Query exibe uma tabela com todos os arquivos encontrados. Para combinar o conteúdo deles em uma única tabela, clique no ícone de expansão no cabeçalho da coluna Content e selecione Combinar Arquivos.
O Power BI abrirá um assistente que usa o primeiro arquivo como modelo para definir a estrutura esperada. Certifique-se de que todos os arquivos da pasta tenham o mesmo layout, com os mesmos nomes de coluna e tipos de dados. Diferenças de estrutura entre os arquivos costumam gerar erros durante a combinação ou colunas nulas no resultado final.
Após a combinação, o Power Query adiciona automaticamente uma coluna chamada Source.Name, que identifica de qual arquivo cada linha veio. Essa coluna é útil para auditorias e para criar filtros por origem dos dados.
Se novos arquivos forem adicionados à pasta no futuro, basta atualizar o conjunto de dados no Power BI que eles serão incluídos automaticamente, sem necessidade de reconfigurar a conexão.
Como importar dados de uma lista do SharePoint?
Listas do SharePoint funcionam como tabelas estruturadas, com colunas e linhas definidas, e são uma das fontes de dados mais práticas para conectar ao Power BI. Registros de chamados, inventários, aprovações e cadastros de clientes são exemplos comuns de listas usadas para análise.
Para importar uma lista, siga estes passos:
- No Power BI Desktop, clique em Obter Dados.
- Selecione Lista do SharePoint Online.
- Insira a URL do site (não a URL da lista em si).
- Clique em OK e faça a autenticação com sua conta Microsoft.
- Na janela de navegação, todas as listas disponíveis no site aparecerão listadas.
- Selecione a lista desejada e clique em Carregar ou Transformar Dados.
Uma atenção importante: listas do SharePoint retornam muitas colunas de metadados internos que raramente são necessários para análise, como colunas de controle de versão, permissões e campos de sistema. No Power Query, é recomendável remover essas colunas logo no início para deixar o modelo de dados mais limpo e com melhor desempenho.
Colunas de pessoas, colunas de escolha múltipla e colunas de lookup costumam vir em formato expandível no Power Query. Você precisará expandir esses campos manualmente para acessar os valores que eles contêm.
Como conectar arquivos do Excel salvos no SharePoint?
Planilhas Excel armazenadas no SharePoint podem ser conectadas ao Power BI de duas formas: por meio do conector de Pasta do SharePoint, que traz todos os arquivos da pasta, ou diretamente pelo link de um arquivo específico usando o conector Web.
Para usar o conector de Pasta e filtrar um único arquivo Excel, basta seguir o processo descrito anteriormente e, no Power Query, filtrar a lista de arquivos pelo nome do arquivo desejado antes de expandir o conteúdo.
Uma vantagem desse método é que, se o arquivo for movido dentro da mesma pasta, a conexão continua funcionando, já que o filtro é feito pelo nome e não pelo caminho completo.
Independentemente do método escolhido, certifique-se de que o arquivo Excel esteja formatado como tabela no Excel (atalho Ctrl + T), pois isso facilita a leitura dos dados pelo Power BI e evita problemas com linhas em branco ou cabeçalhos mal definidos.
Para saber mais sobre como os arquivos funcionam no SharePoint e como organizá-los bem, veja este guia sobre como usar o SharePoint para compartilhar arquivos.
Como usar o conector Web para arquivos individuais?
O conector Web permite apontar diretamente para um arquivo específico armazenado no SharePoint usando o link de compartilhamento ou o endereço direto do arquivo. Essa abordagem é útil quando você precisa conectar apenas um arquivo e não quer trazer toda a estrutura de uma pasta.
Para obter o link correto do arquivo no SharePoint, abra o arquivo no navegador e copie a URL da barra de endereços. Em seguida, no Power BI Desktop:
- Clique em Obter Dados e selecione Web.
- Cole a URL do arquivo.
- Clique em OK e autentique com sua conta organizacional.
O Power BI identificará o tipo de arquivo e apresentará as opções de importação disponíveis, como tabelas, planilhas ou intervalos nomeados no caso de arquivos Excel.
Um ponto de atenção: links de compartilhamento gerados pelo botão “Compartilhar” do SharePoint nem sempre funcionam bem nesse conector. Prefira usar a URL direta que aparece na barra do navegador ao abrir o arquivo, pois ela aponta diretamente para o recurso sem redirecionamentos.
Se o arquivo estiver em um site ao qual você tem acesso pelo navegador mas o Power BI apresentar erro de autenticação, verifique se está usando a opção Conta Organizacional na tela de credenciais do conector Web.
Quais são as permissões e autenticações necessárias?
Para que o Power BI consiga acessar dados do SharePoint, o usuário que está configurando a conexão precisa ter, no mínimo, permissão de leitura no site ou na lista de destino. Sem esse acesso, a autenticação ocorre, mas os dados não aparecem ou retornam um erro de autorização.
Ao conectar pela primeira vez, o Power BI solicita autenticação. Selecione sempre a opção Conta Organizacional e faça login com a mesma conta que você usa para acessar o SharePoint no navegador. Usar conta Microsoft pessoal ou deixar em anônimo gerará erro de acesso.
Depois de autenticado, o Power BI armazena as credenciais localmente. Se a sua senha ou token expirar, será necessário atualizar as credenciais em Arquivo > Opções e Configurações > Configurações de Fonte de Dados.
Para relatórios publicados no Power BI Service que precisam ser atualizados automaticamente, é necessário configurar um gateway de dados ou usar o modo de conexão direta com credenciais de serviço. Sem essa configuração, a atualização agendada falhará mesmo que a conexão no Desktop funcione corretamente.
Administradores do SharePoint podem restringir o acesso por site, biblioteca ou item individualmente. Se você tem acesso ao site mas não consegue ver uma lista específica, verifique com o administrador se as permissões dessa lista foram herdadas ou definidas de forma independente.
Como configurar o Microsoft Entra ID para acesso?
O Microsoft Entra ID, anteriormente conhecido como Azure Active Directory, é o serviço de identidade que gerencia quem pode acessar o quê dentro do ecossistema Microsoft 365, incluindo o SharePoint. Para conexões mais controladas e seguras entre o Power BI e o SharePoint, especialmente em ambientes corporativos, pode ser necessário configurar um registro de aplicativo no Entra ID.
Essa configuração é especialmente relevante quando o acesso precisa ser feito por uma identidade de serviço, sem depender da conta de um usuário específico. Isso evita que a atualização do relatório pare de funcionar quando um colaborador sai da empresa ou muda de função.
Para criar um registro de aplicativo no Entra ID, um administrador de TI precisa:
- Acessar o portal do Microsoft Entra em entra.microsoft.com.
- Criar um novo registro de aplicativo com as permissões de leitura no SharePoint (Sites.Read.All ou Sites.Selected).
- Gerar um segredo de cliente ou certificado para autenticação.
- Usar o ID do aplicativo e o segredo ao configurar as credenciais no Power BI Service.
Essa abordagem exige conhecimento técnico e coordenação com o time de TI ou com o administrador do Microsoft 365. Se a sua empresa não tem esse perfil internamente, contar com uma consultoria especializada no ecossistema Microsoft pode acelerar bastante essa configuração sem riscos de segurança.
Como resolver problemas comuns de conexão?
A maioria dos erros ao conectar o Power BI ao SharePoint se enquadra em algumas categorias específicas. Identificar em qual categoria o seu problema se encaixa facilita muito a resolução.
Erro de URL inválida ou não encontrada: verifique se a URL inserida termina no nome do site, sem barras adicionais ou subpastas no final. URLs com caracteres especiais ou espaços também podem causar esse problema.
Erro de autenticação ou acesso negado: confirme que está usando a opção Conta Organizacional e que a conta tem permissão de leitura no site. Tente acessar o mesmo endereço pelo navegador com a mesma conta para verificar se o acesso funciona fora do Power BI.
Dados não atualizam no Power BI Service: se o relatório foi publicado na nuvem e a atualização agendada falha, o motivo mais comum é a ausência de um gateway configurado ou credenciais expiradas. Acesse as configurações do conjunto de dados no Power BI Service e atualize as credenciais da fonte de dados.
Colunas aparecem como erros ou nulas: isso costuma acontecer quando o esquema de uma lista ou arquivo foi alterado depois que a conexão foi criada. Atualize a consulta no Power Query para refletir a estrutura atual dos dados.
Lentidão ao carregar listas grandes: listas com muitos itens e colunas podem ser lentas. Aplique filtros no Power Query logo na etapa de importação para trazer apenas os registros necessários, em vez de carregar tudo e filtrar depois.
Se a sua empresa usa o SharePoint como base para armazenar dados corporativos e ainda não explorou o potencial de integração com ferramentas de análise, entender como usar o SharePoint de forma estratégica pode abrir novas possibilidades para a gestão da informação. A criação de um ambiente SharePoint bem estruturado desde o início também facilita muito as conexões com o Power BI e outras ferramentas do Microsoft 365.
