pasta SharePoint

Resumo

Item Descrição
Estado da versão Disponibilidade Geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (fluxos de dados)
Arquitetura (Dataflow Gen2)
Power Apps (fluxos de dados)
Dynamics 365 Customer Insights
Tipos de autenticação com suporte Anônimo
Conta do Microsoft
Windows
Conta organizacional
Documentação de Referência da Função SharePoint.Contents
SharePoint.Files

Anotação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Anotação

Microsoft Entra ID/OAuth para SharePoint on-premises não é suportado usando o on-premises data gateway.

Capacidades suportadas

  • Caminho da pasta
  • Combinar
    • Combinar e carregar
    • Combinar e transformar

Tipos de autenticação com suporte

Anotação

O suporte à identidade do workspace para Arquivos do SharePoint está sendo implantado com atualizações de serviço recentes e está disponível somente nas experiências com suporte hospedadas no Fabric.
A disponibilidade pode variar de acordo com a carga de trabalho e o host (por exemplo, o Power BI Desktop não tem suporte).

O conector de Pasta do SharePoint dá suporte aos seguintes métodos de autenticação, dependendo da experiência de hospedagem:

  • Conta organizacional: usa a ID do Microsoft Entra de um usuário para autenticar no SharePoint.
  • Identidade do workspace: no Microsoft Fabric, experiências com suporte (como Fluxos de Dados Gen2 e Power BI) podem ser autenticadas nos Arquivos do SharePoint usando a identidade do workspace. Isso permite que o Fabric acesse o conteúdo do arquivo do SharePoint usando a identidade gerenciada do workspace, sem depender das credenciais do usuário ou da autenticação herdada baseada em ACS.

Determinar a URL do site

Quando você estiver se conectando à biblioteca de documentos em um site SharePoint, será solicitado que você insira a URL do site. Para localizar a URL do site que contém sua pasta SharePoint, primeiro abra uma página no SharePoint. Em uma página no SharePoint, você geralmente pode obter o endereço do site selecionando Home no painel de navegação ou o ícone do site na parte superior. Copie o endereço da barra de endereços do navegador da Web e salve para mais tarde.

Captura de tela enfatizando os locais da Página Inicial no painel de navegação, o ícone na parte superior do site e o endereço de URL resultante.

Anotação

Não há suporte para uma página de URL de SharePoint clássica e não será possível se conectar. Há suporte apenas para uma home page moderna do Sharepoint.

seletor de site SharePoint

O seletor de site SharePoint permite que você localize e selecione o site SharePoint correto durante a criação da conexão, sem navegar até páginas separadas para localizar e copiar URLs manualmente.

Seleção de site simplificada: em vez de copiar URLs manualmente, use o menu suspenso de URL do site para escolher entre seus sites favoritos, sites recentes e todos os sites que você pode acessar.

Screenshot de selecionar SharePoint site em SharePoint Site Picker.

Experiência de pesquisa rápida: Digite palavras-chave na caixa de pesquisa suspensa para localizar rapidamente sites relevantes. Depois de selecionar um site, você pode prosseguir imediatamente para carregar dados para análise.

Captura de tela da pesquisa no site do SharePoint.

Anotação

  • O seletor de sites do SharePoint está disponível para fontes do SharePoint no Dataflow Gen1 e Gen2, modelagem web do Power BI, pipelines, tarefa de cópia e atalhos do Lakehouse, e como destino no Dataflow Gen2.
  • Na primeira vez que você usar o seletor de SharePoint site, uma janela de autenticação será exibida. Selecione a mesma conta com a qual você está conectado no momento. Se você fechar ou ignorar a janela, o seletor de site não funcionará, embora você ainda possa colar manualmente SharePoint URLs do site como antes.
  • Ao usar o seletor de SharePoint site, você pode encontrar problemas na pesquisa de sites hospedados em regiões fora de sua própria geografia.

Conectar-se a uma pasta SharePoint do Power Query Desktop

Para se conectar a uma pasta de SharePoint:

  1. Em Get Data, selecione SharePoint pasta. Mais informações: Onde obter dados

  2. Cole a URL do site SharePoint que você copiou em Determine a URL do site na caixa de texto Site URL na caixa de diálogo pasta SharePoint. Neste exemplo, a URL do site é https://contoso.sharepoint.com/marketing/data. Se a URL do site inserida for inválida, um ícone de aviso será exibido ao lado da caixa de texto da URL.

    Screenshot da caixa de diálogo da pasta SharePoint com a URL inserida na URL do Site.

    Selecione OK para continuar.

  3. Se você estiver visitando este endereço do site pela primeira vez, selecione o método de autenticação apropriado. Insira suas credenciais e escolha a qual nível aplicar essas configurações. Selecione Conectar.

    Captura de tela da autenticação de pasta do SharePoint no desktop.

    Para obter mais informações sobre métodos de autenticação e configurações de nível, acesse Autenticação em aplicativos da área de trabalho.

  4. Depois de se conectar, as informações de arquivo sobre todos os arquivos nessa pasta SharePoint serão exibidas. Além disso, as informações de arquivo sobre todos os arquivos em qualquer subpasta também são exibidas.

    Captura de tela do Navegador mostrando as informações da pasta.

  5. Selecione Combine & Transformar Dados para combinar os dados nos arquivos da pasta SharePoint selecionada e carregar os dados no editor de Power Query para edição. Ou selecione Combine & Carregue para carregar os dados de todos os arquivos na pasta SharePoint diretamente em seu aplicativo.

    Captura de tela do Navegador com as opções de combinação no botão Combinar.

Anotação

Os botões Combine & Transformar Dados e Combine & Carregar são as maneiras mais fáceis de combinar dados encontrados nos arquivos da pasta do SharePoint que você especificar. Você também pode usar o botão Carregar ou os botões Transformar Dados para combinar os arquivos também, mas isso requer mais etapas manuais.

Conectar-se a uma pasta SharePoint do Power Query Online

Para se conectar a uma pasta de SharePoint:

  1. Na página Data sources, selecione SharePoint pasta.

  2. Se você tiver acesso ao SharePoint seletor de site, use-o para localizar e selecionar os sites diretamente na página de configurações de conexão. Caso contrário, copia a URL do site SharePoint e cole-a na caixa de texto Site URL na caixa de diálogo SharePoint Pasta. Neste exemplo, a URL do site é https://contoso.sharepoint.com/marketing/data.

    Captura de tela da seleção da pasta online e entrada.

  3. Se a pasta SharePoint estiver no local, insira o nome de um gateway de dados local.

  4. Selecione o tipo de autenticação e insira as credenciais necessárias.

  5. Selecione Avançar.

  6. Quando você seleciona a pasta SharePoint que deseja usar, as informações de arquivo sobre todos os arquivos nessa pasta SharePoint são exibidas. Além disso, as informações de arquivo sobre todos os arquivos em qualquer subpasta também são exibidas.

    Captura de tela do Navegador online mostrando as informações da pasta.

  7. Selecione Combine para combinar os dados nos arquivos da pasta SharePoint selecionada e carregar os dados no editor de Power Query para edição.

    Anotação

    O botão Combine é a maneira mais fácil de combinar dados encontrados nos arquivos da pasta SharePoint especificada. Você também pode usar os botões Transformar Dados para combinar os arquivos também, mas isso requer mais etapas manuais.

Resolução de problemas

Combinando arquivos

Todos os arquivos na pasta SharePoint selecionada são incluídos nos dados a serem combinados. Se você tiver arquivos de dados localizados em uma subpasta da pasta SharePoint selecionada, todos esses arquivos também serão incluídos. Para garantir que a combinação dos dados do arquivo funcione corretamente, verifique se todos os arquivos na pasta e nas subpastas têm o mesmo esquema.

Em alguns casos, você pode ter várias pastas em seu site SharePoint contendo diferentes tipos de dados. Nesse caso, você precisa excluir os arquivos desnecessários. Para excluir esses arquivos:

  1. Na lista de arquivos da pasta SharePoint escolhida, selecione Transform Data.

    Screenshot da lista de exemplo de arquivos de pasta SharePoint.

  2. No editor de Power Query, role para baixo para encontrar os arquivos que você deseja manter.

    Screenshot do editor de Power Query onde você pode encontrar os arquivos que deseja manter.

  3. Neste exemplo, os arquivos necessários são as últimas linhas da tabela. Selecione Remover Linhas>Remover Linhas Superiores, insira o valor da última linha antes dos arquivos a serem mantidos (nesse caso, 909) e selecione OK.

    Screenshot do editor de Power Query com a opção Remover linhas enfatizada.

  4. Depois de remover todos os arquivos desnecessários, selecione Combinar Arquivos na faixa de opções Página Inicial para combinar os dados de todos os arquivos restantes.

Para obter mais informações sobre como combinar arquivos, acesse a visão geral de combinar arquivos.

Caracteres especiais de nome de arquivo

Se um nome de arquivo contiver determinados caracteres especiais, isso poderá levar a erros de autenticação devido ao nome do arquivo ser truncado na URL. Se você estiver recebendo erros de autenticação incomuns, verifique se todos os nomes de arquivo que você está usando não contêm nenhum dos seguintes caracteres especiais.

# % $

Se esses caracteres estiverem presentes no nome do arquivo, o proprietário do arquivo deverá renomear o arquivo para que ele não contenha nenhum desses caracteres.

Permissões

Ao solicitar o conteúdo da biblioteca de documentos, você deve ter acesso de leitura ao site SharePoint, à biblioteca de documentos e a todas as pastas que levem ao arquivo solicitado.

autenticação Microsoft Entra ID

A autenticação do Microsoft Entra ID não tem suporte para fontes locais do SharePoint.