Usar o Explorador de Arquivos do OneLake para acessar dados Fabric

O aplicativo explorador de arquivos OneLake integra perfeitamente o OneLake ao Explorador de Arquivos Windows. Esse aplicativo sincroniza automaticamente todos os itens do OneLake aos quais você tem acesso no Explorador de Arquivos Windows. "Sincronização refere-se a obter metadados atualizados de arquivos e pastas, e enviar alterações feitas localmente para o serviço do OneLake." A sincronização não baixa os dados, cria espaços reservados. Você deve clicar duas vezes em um arquivo para baixar os dados localmente.

Quando você cria, atualiza ou exclui um arquivo por meio do Explorador de Arquivos Windows, ele sincroniza automaticamente as alterações no serviço OneLake. Atualizações no seu item feitas fora do Explorador de Arquivos não são sincronizadas automaticamente. Para baixar essas atualizações, clique com o botão direito do mouse sobre o item ou subpasta no Windows Explorer e selecione OneLake>Sincronizar do OneLake.

Instruções de instalação

No momento, o Gerenciador de Arquivos do OneLake dá suporte a Windows e é validado em Windows 10 e 11.

Para instalar:

1. Baixe o explorador de arquivos do OneLake.

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

   O local de armazenamento em seu computador para os espaços reservados e qualquer conteúdo baixado é %USERPROFILE%\OneLake - Microsoft\.

Depois que o aplicativo estiver instalado e em execução, você poderá ver seus dados do OneLake no Explorador de Arquivos Windows.

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

Limitações e considerações

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

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

• Se a pesquisa do Windows estiver desabilitada, o gerenciador de arquivos do OneLake não conseguirá iniciar.

• Explorador de Arquivos do Windows não é sensí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 Windows Explorador de Arquivos mostra apenas o mais antigo desses arquivos.

• Se um arquivo não for sincronizado devido a um problema de rede, você precisará disparar 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 Gerenciador de Arquivos Do OneLake não dá suporte a ambientes que exigem configurações de proxy de rede. Tentativas de iniciar ou autenticar o aplicativo por trás de um proxy podem resultar em falhas de conexão ou problemas de entrada.

• O Gerenciador de Arquivos Do OneLake não dá suporte à sincronização de arquivos marcados como somente leitura. Essa limitação se aplica especificamente aos arquivos que o usuário marca como somente leitura em seu computador local. Esse comportamento é projetado para evitar conflitos com permissões do sistema de arquivos local e evitar edições não intencionais para conteúdo protegido.

Scenarios

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

Iniciar e sair do gerenciador de arquivos do OneLake

O Explorador de Arquivos do OneLake é iniciado automaticamente na inicialização do Windows. Você pode desabilitar o aplicativo de iniciar automaticamente selecionando aplicativos Startup no Gerenciador de Tarefas Windows e clicando com o botão direito do mouse em OneLake e selecionando Disable.

• Para iniciar manualmente o aplicativo, pesquise o OneLake usando Windows pesquisa (Windows+S) e selecione o aplicativo OneLake. As exibições de todas as pastas que foram sincronizadas anteriormente atualizam automaticamente.

• Para sair, clique com o botão direito do mouse no ícone do OneLake na área de notificação Windows, localizada à extrema direita da barra de tarefas e selecione Exit. A sincronização pausa e você não pode acessar arquivos e pastas de espaço reservado. Você continuará vendo o ícone de nuvem azul para marcadores de posição já sincronizados, mas não baixados.

Sincronizar atualizações do OneLake

Para otimizar o desempenho durante a sincronização inicial, o Explorador de Arquivos do OneLake sincroniza os arquivos de espaço reservado para os nomes de itens e espaços de trabalho de nível superior. Quando você abre um item, o Explorador de Arquivos do 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 diretamente no conteúdo do OneLake, sem precisar esperar que todos os arquivos sejam sincronizados antes de começar a funcionar.

Quando você cria, atualiza ou exclui um arquivo por meio do gerenciador de arquivos do OneLake, ele sincroniza automaticamente as alterações no serviço OneLake. Atualizações feitas no seu item fora do explorador de arquivos do OneLake não são sincronizadas automaticamente. Para efetuar pull dessas 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>Sincronizar do OneLake. Essa ação atualiza a exibição de todas as pastas que foram sincronizadas anteriormente. Para buscar 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.

Fazer login em 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 alternar contas, clique com o botão direito do mouse no ícone do OneLake na área de notificação Windows, selecione Conta e, em seguida, Sign Out. A saída sai do gerenciador de arquivos do OneLake e pausa a sincronização. Para entrar com outra conta, inicie o Explorador de Arquivos do OneLake novamente e escolha a conta desejada.

Ao entrar com outra conta, você vê a lista de espaços de trabalho e itens atualizadas no explorador de arquivos do OneLake. Se você navegar até os espaços de trabalho associados à conta anterior, poderá atualizar manualmente o modo de exibição clicando com o botão direito do mouse no espaço de trabalho e depois selecionando OneLake>Sincronizar do OneLake. Esses workspaces são inacessíveis enquanto você está conectado a uma conta diferente.

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

A partir da versão 1.0.10.0, você pode fazer a transição entre o uso do Gerenciador de Arquivos do OneLake e o Fabric portal da Web. No explorador de arquivos do OneLake, clique com o botão direito do mouse em um espaço de trabalho e selecione OneLake>Exibir espaço de trabalho online. Essa ação abre o navegador da área 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. Essa ação abre o navegador de itens no portal da Web Fabric. Se você selecionar uma subpasta ou arquivo, o portal da Web Fabric sempre abrirá a pasta raiz do item.

Suporte offline

O gerenciador de arquivos do OneLake sincroniza apenas as atualizações quando você está online e o aplicativo está em execução. Quando o aplicativo é iniciado, as exibições de todas as pastas que foram sincronizadas anteriormente são atualizadas automaticamente. Todos os arquivos que foram adicionados ou atualizados enquanto estiverem offline são mostrados como sincronização pendente até que você os salve novamente. Todos os arquivos que você excluiu enquanto estiver offline serão recriados durante a atualização se eles ainda existirem no serviço.

Criar arquivos ou pastas no explorador de arquivos do OneLake

1. Vá para a seção OneLake no Explorador de Arquivos Windows.

2. Vá para a pasta desejada em 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á para a seção OneLake no Explorador de Arquivos Windows.

2. Vá para a pasta Arquivos ou Tabelas em seu item.

3. Selecione um arquivo ou pasta e exclua.

Editar arquivos

Abra arquivos usando seus aplicativos favoritos e faça 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 em seus arquivos usando Excel. Close o arquivo após a atualização no Excel e inicia a sincronização com o OneLake.

Se você editar um arquivo localmente e selecionar Salvar, o aplicativo explorador de arquivos OneLake detectará 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, suas 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 efetuar pull do arquivo do serviço. Ou você pode copiar o arquivo com um novo nome para evitar conflitos.

Copiar ou mover arquivos

Copie arquivos para, de e dentro de seus itens usando atalhos de teclado padrão como Ctrl+C e Ctrl+V. Mova os 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 é semelhante ao uso de APIs do OneLake. Em geral, o tempo necessário para sincronizar as alterações do OneLake é proporcional ao número de arquivos.

Suporte a atalhos do OneLake

Todas as pastas em seus itens, incluindo atalhos do OneLake, estão visíveis. Você pode exibir, 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 Windows, localizada à extrema direita da barra de tarefas. Selecione Operações de diagnóstico>Abrir pasta de logs. Essa ação abre o diretório de logs em uma nova janela do explorador de arquivos Windows.

O computador local armazena logs do lado do cliente em %temp%\OneLake\Diagnostics\.

Você pode habilitar registro em log adicional do lado do cliente selecionando Operações de Diagnóstico>Habilitar rastreamento.

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 do OneLake clicando com o botão direito do mouse no ícone do OneLake na área de notificação Windows, localizada à direita da barra de tarefas. Selecione Sobre>Notas de Lançamento. Essa ação abre a página de notas de lançamento do explorador de arquivos OneLake na janela do navegador.

Instruções de desinstalação

Para desinstalar o aplicativo, procure o OneLake no Windows. Selecione Desinstalar na lista de opções em OneLake.

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

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

Ícones do explorador de arquivos do OneLake

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

Icon	Descrição do ícone	Meaning
	Ícone de nuvem azul	O arquivo só está disponível online. Os arquivos somente online não ocuparão espaço no computador.
	Tique verde	O arquivo é baixado em seu computador local.
	Setas de sincronização pendente	A sincronização está em andamento. Esse ícone pode aparecer quando você estiver carregando arquivos. Se as setas pendentes de sincronização forem persistentes, seu arquivo ou pasta poderá ter uma sincronização de erro. Você pode encontrar mais informações nos logs do lado do cliente em seu computador local em %temp%\OneLake\Diagnostics\.

Conteúdo relacionado

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