Exportar dados de lista do SharePoint para Power BI: checklist prático para proprietários

Você precisa trazer dados de lista do SharePoint para o Power BI, mas a conexão falha ou os dados aparecem errados. O problema é que o Power BI usa um conector específico que exige o formato correto da URL da lista e permissões adequadas. Este artigo fornece um checklist prático para proprietários de SharePoint exportarem dados de lista de forma confiável para o Power BI.

Como o Power BI se conecta a listas do SharePoint

O Power BI Desktop inclui um conector nativo SharePoint List. Esse conector consulta a API REST do SharePoint para recuperar itens da lista. O conector funciona com sites e listas modernos do SharePoint. Sites e listas clássicos podem exigir o conector SharePoint Online List ou uma abordagem diferente.

Antes de começar, verifique se você tem pelo menos acesso de leitura ao site do SharePoint. Você também precisa do Power BI Desktop instalado em uma máquina que esteja na mesma rede ou tenha acesso à internet ao locatário do SharePoint. O conector usa suas credenciais atuais do Windows ou um login baseado em navegador se você escolher a opção de conta organizacional.

O que o conector suporta

O conector SharePoint List pode ler linhas de texto únicas, várias linhas de texto, colunas de escolha, colunas numéricas, colunas de moeda, colunas de data e hora, colunas sim/não, colunas de pessoa ou grupo e colunas de pesquisa. Ele não suporta colunas de metadados gerenciados, colunas de dados externos ou colunas calculadas que referenciam outras listas. Anexos de arquivo não são incluídos na exportação de dados.

Checklist para exportar dados de lista do SharePoint para o Power BI

Siga estas etapas em ordem para garantir uma exportação bem-sucedida. Cada etapa inclui o caminho exato do menu ou nome do botão.

1. Abra o Power BI Desktop e selecione Obter Dados
   Inicie o Power BI Desktop. Na guia Página Inicial, clique em Obter Dados. No menu suspenso, escolha Mais. Na caixa de diálogo Obter Dados, pesquise por SharePoint. Selecione SharePoint List e clique em Conectar.
2. Insira a URL do site do SharePoint
   Na caixa de diálogo SharePoint List, cole a URL completa do site no campo Site URL. A URL deve terminar com o nome do site, por exemplo https://contoso.sharepoint.com/sites/Marketing. Não inclua o nome da lista ou o caminho "/Lists/". Clique em OK.
3. Faça login com a conta correta
   Se solicitado, selecione Conta organizacional e faça login usando a mesma conta que tem acesso ao site do SharePoint. O conector lembra suas credenciais para a sessão atual. Se você receber um erro 401, sua conta pode não ter permissões de leitura no site.
4. Selecione a lista no painel Navegador
   Após a autenticação, o painel Navegador mostra todas as listas e bibliotecas do site. Localize sua lista de destino. Marque a caixa de seleção ao lado do nome da lista. Você pode visualizar as primeiras 200 linhas no painel direito. Clique em Carregar para importar todos os dados ou Transformar Dados para editar colunas e filtros.
5. Verifique o mapeamento de colunas no Editor do Power Query
   Se você clicou em Transformar Dados, o Editor do Power Query será aberto. Verifique se cada coluna tem o tipo de dados correto. Colunas de pessoa ou grupo aparecem como registros; expanda-as clicando no ícone de expansão (duas setas) no cabeçalho da coluna. Remova as colunas desnecessárias clicando com o botão direito no cabeçalho e selecionando Remover.
6. Aplique as alterações de tipo de dados e carregue
   Após limpar os dados, clique em Fechar & Aplicar na guia Página Inicial. O Power BI carrega os dados no modelo de dados. Agora você pode criar visuais, medidas e relatórios usando os dados da lista do SharePoint.

Falhas comuns na exportação e como evitá-las

O conector SharePoint List retorna "Não foi possível autenticar"

Esse erro geralmente significa que a URL está incorreta ou a conta não tem permissões. Verifique novamente a URL do site. Ela deve ser a raiz do site, não um subsite ou caminho de lista. Confirme também que sua conta tem pelo menos acesso de leitura ao site. Se sua organização usa autenticação multifator, use a opção de conta organizacional e conclua o prompt de login no navegador.

Dados truncados ou linhas ausentes

O SharePoint tem um limite de visualização de lista de 5000 itens. Se sua lista contiver mais de 5000 itens, o conector pode retornar apenas os primeiros 5000. Para corrigir isso, crie uma nova exibição no SharePoint que filtre a lista para menos de 5000 itens. No Editor do Power Query, você também pode aplicar um filtro antes de carregar para reduzir o número de linhas.

Coluna de pessoa ou grupo mostra IDs em vez de nomes

O conector retorna colunas de pessoa como registros contendo o ID do usuário e o e-mail. Para ver nomes de exibição, expanda a coluna no Editor do Power Query. Clique no ícone de expansão e selecione os campos desejados, como DisplayName e Email. Desmarque a caixa de seleção Usar nome original da coluna como prefixo para manter os nomes das colunas limpos.

Dados de coluna de pesquisa não aparecem

Colunas de pesquisa referenciam outra lista. O conector retorna o ID da pesquisa, não o valor de exibição. Para trazer o valor de exibição, use o recurso Mesclar Consultas no Editor do Power Query para unir a lista de pesquisa. Alternativamente, crie uma coluna calculada no SharePoint que puxe o valor da pesquisa e exporte essa coluna.

Item	Conector SharePoint List	Conector SharePoint Online List (Legado)
Descrição	Conector nativo para listas modernas	Conector antigo para listas clássicas
Autenticação	Conta organizacional ou Windows	Apenas credenciais do Windows
Tipos de site suportados	Sites de equipe e comunicação modernos	Sites clássicos e alguns sites modernos
Suporte a colunas	Suporte completo para a maioria dos tipos de coluna	Suporte limitado; colunas de metadados gerenciados podem falhar
Desempenho	Mais rápido para listas com menos de 5000 itens	Mais lento; frequentemente atinge limites de limitação

Agora você pode exportar dados de lista do SharePoint para o Power BI usando o conector e o formato de URL corretos. Comece com uma lista pequena para verificar se a conexão funciona. Em seguida, aplique filtros e expansões de coluna para modelar os dados antes de criar relatórios. Como dica avançada, agende uma atualização de dados do Power BI usando um gateway para manter seus relatórios atualizados automaticamente.