Use o explorador de ficheiros OneLake para aceder aos dados do Fabric

A aplicação de explorador de ficheiros OneLake integra de forma fluida o OneLake com o Explorador de Ficheiros do Windows. Esta aplicação sincroniza automaticamente todos os itens do OneLake a que tem acesso no Explorador de Ficheiros do Windows. "Sincronização" refere-se à obtenção de metadados atualizados em arquivos e pastas e ao envio de alterações feitas localmente para o serviço OneLake. A sincronização não faz o download dos dados, apenas cria marcadores de posição. Você deve clicar duas vezes em um arquivo para baixar os dados localmente.

Quando cria, atualiza ou elimina um ficheiro através do Explorador de Ficheiros do Windows, ele sincroniza automaticamente as alterações ao serviço OneLake. As atualizações do item feitas fora do Explorador de Arquivos não são sincronizadas automaticamente. Para obter estas atualizações, precisa de clicar com o botão direito no item ou subpasta no Explorador de Ficheiros Windows e selecionar OneLake>Sync from OneLake.

Instruções de instalação

O explorador de ficheiros OneLake suporta atualmente o Windows e está validado no Windows 10 e 11.

Para instalar:

1. Baixe o explorador de arquivos OneLake.

2. Clique duas vezes no arquivo para iniciar a instalação.

   O local de armazenamento no teu PC para os marcadores de posição e qualquer conteúdo descarregado é %USERPROFILE%\OneLake - Microsoft\.

Depois de a aplicação estar instalada e a funcionar, pode ver os seus dados do OneLake no Explorador de Ficheiros do Windows.

A partir da versão 1.0.13, o aplicativo explorador de arquivos OneLake notifica quando uma nova atualização está disponível. Quando uma nova versão fica disponível, recebe uma notificação do Windows e o ícone do OneLake muda. Clique com o botão direito no ícone do OneLake na área de notificações do Windows. Selecione Atualizar disponível e siga as etapas para atualizar.

Limitações e considerações

• Nomes de espaço de trabalho com o caractere "/", caracteres de escape codificados como %23, e nomes que se parecem com GUIDs não conseguem sincronizar.

• Ficheiros ou pastas que contêm caracteres reservados no Windows deixam de sincronizar. Para mais informações, consulte Ficheiros de nomes, caminhos e espaços de nomes.

• Se a pesquisa do Windows estiver desativada, o explorador de ficheiros OneLake falha em iniciar.

• O Explorador de Ficheiros do Windows não diferencia maiúsculas de minúsculas, enquanto o OneLake diferencia maiúsculas de minúsculas. Podes criar ficheiros com o mesmo nome mas casos diferentes no serviço OneLake usando outras ferramentas, mas o Explorador de Ficheiros do Windows só mostra os ficheiros mais antigos destes ficheiros.

• Se um arquivo falhar ao sincronizar devido a um problema de rede, você terá que acionar a sincronização com o OneLake. Para solicitar o processo de sincronização, abra o arquivo e salve-o. Como alternativa, você pode disparar um evento modify usando o PowerShell executando este comando: (Get-Item -Path "<file_path>").LastWriteTimeUtc = Get-Date

• O OneLake File Explorer não suporta ambientes que exijam configurações de proxy de rede. Tentativas de iniciar ou autenticar a aplicação atrás de um proxy podem resultar em falhas de ligação ou problemas de iniciação de sessão.

• O OneLake File Explorer não suporta sincronizar ficheiros marcados como apenas leitura. Esta limitação aplica-se especificamente a ficheiros que o utilizador marca como apenas leitura na sua máquina local. Este comportamento é, por natureza, para evitar conflitos com permissões do sistema de ficheiros local e para evitar edições não intencionais em conteúdos protegidos.

Scenarios

Os cenários a seguir fornecem detalhes para trabalhar com o explorador de arquivos OneLake.

Iniciar e sair do explorador de ficheiros OneLake

O explorador de ficheiros OneLake inicia automaticamente no arranque do Windows. Pode desativar a aplicação para que não inicie automaticamente selecionando Apps de Arranque no Gestor de Tarefas Windows e depois clicando com o botão direito OneLake, selecionando Desabilitar.

• Para iniciar manualmente a aplicação, procure o OneLake usando a pesquisa do Windows (Windows+S) e selecione a aplicação OneLake. Os modos de exibição de todas as pastas que foram sincronizadas anteriormente são atualizados automaticamente.

• Para sair, clique com o botão direito no ícone OneLake na área de notificações de Windows, localizada no extremo direito da barra de tarefas, e selecione Exit. A sincronização é pausada e não é possível acessar ficheiros e pastas de espaços reservados. Você continua a ver o ícone de nuvem azul para marcadores de posição que foram sincronizados anteriormente, mas não baixados.

Sincronizar atualizações do OneLake

Para otimizar o desempenho durante a sincronização inicial, o explorador de ficheiros do OneLake sincroniza os ficheiros de espaço reservado para os principais espaços de trabalho e nomes de itens. Quando você abre um item, o explorador de arquivos OneLake sincroniza os arquivos diretamente nessa pasta. Em seguida, abrir uma pasta dentro do item sincroniza os arquivos diretamente nessa pasta. Essa funcionalidade permite que você navegue pelo conteúdo do OneLake perfeitamente, sem ter que esperar que todos os arquivos sejam sincronizados antes de começar a trabalhar.

Quando você cria, atualiza ou exclui um arquivo por meio do explorador de arquivos do OneLake, ele sincroniza automaticamente as alterações no serviço OneLake. As atualizações do item feitas fora do explorador de arquivos do OneLake não são sincronizadas automaticamente. Para obter essas atualizações, clique com o botão direito do mouse no nome do espaço de trabalho, no nome do item, no nome da pasta ou no arquivo no explorador de arquivos do OneLake e selecione OneLake>Sync no OneLake. Esta ação atualiza a exibição de todas as pastas que foram sincronizadas anteriormente. Para obter atualizações para todos os espaços de trabalho, clique com o botão direito do mouse na pasta raiz do OneLake e selecione OneLake>Sync do OneLake.

Aceder a contas diferentes

A partir da versão 1.0.9.0, ao instalar o explorador de arquivos do OneLake, você pode escolher com qual conta entrar. Para mudar de conta, clique com o botão direito no ícone OneLake na área de notificações Windows, selecione Conta e depois Logout. Ao fazer logout, sai o explorador de ficheiros do OneLake e pausa a sincronização. Para iniciar sessão com outra conta, inicie novamente o explorador de ficheiros do OneLake e escolha a conta desejada.

Quando você entra com outra conta, você vê a lista de espaços de trabalho e itens atualizados no explorador de arquivos do OneLake. Se você navegar para espaços de trabalho associados à conta anterior, poderá atualizar manualmente a exibição clicando com o botão direito do mouse no espaço de trabalho e, em seguida, selecionando OneLake>Sync do OneLake. Esses espaços de trabalho ficam inacessíveis enquanto você está conectado a uma conta diferente.

Opção para abrir espaços de trabalho e itens no portal da Web

A partir da versão 1.0.10.0, podes transitar entre o explorador de ficheiros do OneLake e o portal web do Fabric. No explorador de arquivos do OneLake, clique com o botão direito do mouse em um espaço de trabalho e selecione OneLake>Ver espaço de trabalho online. Esta ação abre o navegador de espaço de trabalho no portal web Fabric.

Você pode clicar com o botão direito do mouse em um item, subpasta ou arquivo e selecionar OneLake>Exibir item online. Esta ação abre o navegador de itens no portal web da Fabric. Se selecionares uma subpasta ou ficheiro, o portal web do Fabric abre sempre a pasta raiz do item.

Suporte offline

O explorador de arquivos OneLake só sincroniza atualizações quando você está online e o aplicativo está em execução. Quando o aplicativo é iniciado, os modos de exibição de todas as pastas que foram sincronizadas anteriormente são atualizados automaticamente. Todos os arquivos que você adicionou ou atualizou enquanto estava offline são exibidos como sincronização pendente até que você os salve novamente. Todos os arquivos excluídos enquanto estiver offline serão recriados durante a atualização, caso ainda existam no serviço.

Criar ficheiros ou pastas no explorador de ficheiros OneLake

1. Vá à secção OneLake no Explorador de Ficheiros Windows.

2. Vá à pasta que deseja no seu item.

3. Clique com o botão direito do mouse e selecione Nova pasta ou Novo tipo de arquivo.

Excluir arquivos ou pastas no explorador de arquivos do OneLake

1. Vá à secção OneLake no Explorador de Ficheiros Windows.

2. Vai à pasta Ficheiros ou Tabelas no teu item.

3. Selecione um arquivo ou pasta e exclua.

Editar ficheiros

Abre ficheiros usando as tuas aplicações favoritas e faz edições. Selecione Salvar para sincronizar o arquivo com o OneLake. A partir da versão 1.0.11, também pode fazer atualizações aos seus ficheiros usando o Excel. Close o ficheiro após a atualização no Excel, o que inicia a sincronização com OneLake.

Se você editar um arquivo localmente e selecionar Salvar, o aplicativo explorador de arquivos OneLake detetará se esse arquivo foi atualizado em outro lugar (por outra pessoa) desde a última vez que você selecionou Sincronizar do OneLake. Uma caixa de diálogo Confirmar a ação é exibida:

Se você selecionar Sim, as alterações locais substituirão quaisquer outras alterações feitas no arquivo desde a última vez que você selecionou Sincronizar do OneLake.

Se você selecionar Não, as alterações locais não serão enviadas para o serviço OneLake. Em seguida, você pode selecionar Sincronizar do OneLake para reverter suas alterações locais e extrair o arquivo do serviço. Ou você pode copiar o arquivo com um novo nome para evitar conflitos.

Copiar ou mover ficheiros

Copie ficheiros para, de e dentro dos seus itens usando atalhos de teclado padrão como Ctrl+C e Ctrl+V. Move ficheiros arrastando-os e largando-os.

Suporte para arquivos grandes e um grande número de arquivos

Quando carrega ou descarrega ficheiros usando o explorador de ficheiros OneLake, o desempenho é semelhante ao de usar APIs OneLake. Em geral, o tempo necessário para sincronizar as alterações do OneLake é proporcional ao número de arquivos.

Suporte de atalho OneLake

Todas as pastas nos seus itens, incluindo os atalhos do OneLake, estão visíveis. Você pode visualizar, atualizar e excluir os arquivos e pastas nesses atalhos.

Registos do lado do cliente

A partir da versão 1.0.10, pode encontrar os seus registos do lado do cliente clicando com o botão direito no ícone OneLake na área de notificações do Windows, localizada no extremo direito da barra de tarefas. Selecione Operações de diagnóstico>Abrir pasta de logs. Esta ação abre o diretório de registos numa nova janela do explorador de ficheiros do Windows.

A máquina local armazena registos do lado do cliente em %temp%\OneLake\Diagnostics\.

Você pode habilitar mais registos no lado do cliente selecionando Operações de diagnóstico>Ativar rastreio.

Notas de lançamento

A partir da versão 1.0.11, pode encontrar informações sobre cada versão do explorador de ficheiros OneLake clicando com o botão direito no ícone OneLake na área de notificações do Windows, localizado no extremo direito da barra de tarefas. Selecione Sobre>as Notas de Versão. Esta ação abre a página de notas de versão do explorador de arquivos OneLake na janela do navegador.

Instruções para desinstalar

Para desinstalar a aplicação, procure por OneLake no Windows. Selecione Desinstalar na lista de opções em OneLake.

A configuração do locatário permite o acesso ao explorador de arquivos do OneLake

Os administradores de inquilinos podem restringir o acesso ao explorador de ficheiros OneLake para a sua organização no portal de administração Microsoft Fabric. Quando a configuração está desabilitada, ninguém na sua organização pode iniciar o aplicativo explorador de arquivos OneLake. Se o aplicativo já estiver em execução e o administrador do locatário desativar a configuração, o aplicativo será encerrado. Os espaços reservados e qualquer conteúdo baixado permanecem em máquinas locais, mas os usuários não podem sincronizar dados de ou para o OneLake.

Ícones do explorador de arquivos OneLake

Estes ícones do explorador de ficheiros OneLake aparecem no Windows File Explorer para indicar o estado de sincronização do ficheiro ou pasta.

Icon	Descrição do ícone	Meaning
	Ícone de nuvem azul	O ficheiro só está disponível online. Os ficheiros apenas online não ocupam espaço no seu computador.
	Assinaque verde	O ficheiro é transferido para o computador local.
	Sincronização de setas pendentes	A sincronização está em andamento. Este ícone pode aparecer quando estiver a carregar ficheiros. Se as setas pendentes de sincronização forem persistentes, o seu ficheiro ou pasta poderá ter um erro de sincronização. Você pode encontrar mais informações nos logs do lado do cliente em sua máquina local em %temp%\OneLake\Diagnostics\.

Conteúdo relacionado

• O que há de novo no explorador de arquivos OneLake mais recente?