Usar o Explorador de Ficheiros OneLake (visualização) para aceder dados do Fabric

O aplicativo explorador de arquivos OneLake integra perfeitamente o OneLake com o Explorador de Arquivos do Windows. Este aplicativo sincroniza automaticamente todos os itens do OneLake aos quais você tem acesso no Explorador de Arquivos 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 baixa os dados, ela cria espaços reservados. Você deve clicar duas vezes em um arquivo para baixar os dados localmente.

Importante

Este recurso está em pré-visualização.

Quando você cria, atualiza ou exclui um arquivo por meio do Explorador de Arquivos do Windows, ele sincroniza automaticamente as alterações no serviço OneLake. As atualizações do item feitas fora do Explorador de Arquivos não são sincronizadas automaticamente. Para obter essas atualizações, você precisa clicar com o botão direito do mouse no item ou subpasta no Explorador de Arquivos do Windows e selecionar OneLake>Sync do OneLake.

Instruções de instalação

O explorador de ficheiros OneLake suporta atualmente o Windows e é 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 seu PC para os placeholders e todo o conteúdo transferido é \%USERPROFILE%\OneLake - Microsoft\.

Depois que o aplicativo estiver instalado e em execução, você poderá ver seus dados do OneLake no Explorador de Arquivos 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, você recebe uma notificação do Windows e o ícone do OneLake é alterado. Clique com o botão direito do mouse no ícone OneLake na área de notificação 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.

• Os ficheiros ou pastas que contêm caracteres reservados do Windows não são sincronizados. Para obter mais informações, consulte Nomeando arquivos, caminhos e namespaces.

• Se a pesquisa do Windows estiver desativada, o explorador de arquivos do OneLake não será iniciado.

• O Explorador de Arquivos do Windows é insensível a maiúsculas e minúsculas, enquanto o OneLake é sensível a maiúsculas e minúsculas. Você pode criar arquivos com o mesmo nome, mas casos diferentes no serviço OneLake usando outras ferramentas, mas o Explorador de Arquivos do Windows mostra apenas o mais antigo desses arquivos.

• 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

Cenários

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 arquivos OneLake é iniciado automaticamente na inicialização do Windows. Você pode desabilitar a inicialização automática do aplicativo selecionando Aplicativos de inicialização no Gerenciador de Tarefas do Windows e, em seguida, clicando com o botão direito do mouse em OneLake e selecionando Desabilitar.

• Para iniciar manualmente o aplicativo, procure OneLake usando a pesquisa do Windows (Windows + S) e selecione o aplicativo 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 do mouse no ícone do OneLake na área de notificação do Windows, localizada na extremidade direita da barra de tarefas, e selecione Sair. 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 do rato no ícone do OneLake na área de notificação do Windows, selecione Conta e, em seguida, Terminar sessão. Ao terminar sessão, o Explorador de Ficheiros OneLake é encerrado e a sincronização é pausada. Para entrar com outra conta, inicie o Explorador de Ficheiros OneLake novamente 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, você pode fazer a transição entre o uso do explorador de arquivos do OneLake e o portal da 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 explorador de espaço de trabalho no portal web do 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 da Web do Fabric. Se você selecionar uma subpasta ou arquivo, o portal da Web do Fabric sempre abrirá 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. Navegue até a seção OneLake no Explorador de Arquivos do Windows.

2. Navegue até a pasta apropriada no seu item.

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

Nota

A sincronização do OneLake falhará se você gravar dados em locais onde não tem permissão de gravação, como a raiz do item ou espaço de trabalho. Limpe arquivos ou pastas que não conseguem sincronizar, movendo-os para o local correto ou excluindo-os.

Excluir arquivos ou pastas no explorador de arquivos do OneLake

1. Navegue até a seção OneLake no Explorador de Arquivos do Windows.

2. Navegue até a pasta Arquivos ou Tabelas no item.

3. Selecione um arquivo ou pasta e exclua.

Editar ficheiros

Você pode abrir arquivos usando seus aplicativos favoritos e fazer edições. Selecione Salvar para sincronizar o arquivo com o OneLake. A partir da versão 1.0.11, você também pode fazer atualizações com o Excel em seus arquivos. Feche arquivo após a atualização no Excel e ele inicia a sincronização com o 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

Você pode copiar arquivos para, de e dentro de seus itens usando atalhos de teclado padrão como Ctrl+C e Ctrl+V. Você também pode mover arquivos arrastando-os e soltando-os.

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

Quando você carrega ou baixa arquivos usando o explorador de arquivos do OneLake, o desempenho deve ser semelhante ao uso das APIs do 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.

Logs do lado do cliente

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

Os logs do lado do cliente são armazenados em sua máquina local em %temp%\OneLake\Diagnostics\.

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

Release Notes (Notas de Lançamento)

A partir da versão 1.0.11, você pode encontrar informações sobre cada versão do explorador de arquivos OneLake clicando com o botão direito do mouse no ícone do OneLake na área de notificação do Windows, localizada na extremidade direita 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 de desinstalação

Para desinstalar o aplicativo, procure 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 locatários podem restringir o acesso ao explorador de arquivos do OneLake para sua organização no portal de administração do 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

Esses ícones do explorador de arquivos OneLake aparecem no Explorador de Arquivos do Windows para indicar o estado de sincronização do arquivo ou pasta.

Ícone	Descrição do ícone	Significado
	Ícone de nuvem azul	O ficheiro só está disponível online. Os ficheiros apenas online não ocupam espaço no seu computador.
	Visto 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údos relacionados

• Saiba mais sobre a segurança do Fabric e do OneLake.
• O que há de novo no explorador de arquivos OneLake mais recente?