Usar o explorador de arquivos do OneLake para acessar dados de malha

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.

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 Sincronizar no OneLake.

Instruções de instalação

O explorador de ficheiros OneLake suporta atualmente o Windows e foi 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 espaços reservados e qualquer conteúdo transferido é \%USERPROFILE%\OneLake - Microsoft\.

Depois de instalar e iniciar o aplicativo, agora você pode 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 agora irá notificá-lo quando uma nova atualização estiver disponível. Você receberá uma notificação do Windows quando uma nova versão estiver disponível e o ícone do OneLake for 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 carateres reservados do Windows (saiba mais) não são sincronizados.

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

• O Explorador de Arquivos do Windows não diferencia maiúsculas de minúsculas, enquanto o OneLake diferencia maiúsculas de 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 um dos arquivos (o mais antigo).

• Se um arquivo não conseguir sincronizar devido a um problema de rede, você terá que acionar a sincronização com o OneLake. Você pode fazer isso abrindo o arquivo e salvando-o, solicitando o processo de sincronizaçã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.

Iniciando e saindo do explorador de arquivos 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 pausa e você não pode acessar arquivos e pastas de espaço reservado. Você continua a ver o ícone de nuvem azul para espaços reservados 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 arquivos OneLake sincroniza os arquivos de espaço reservado para os espaços de trabalho de nível superior 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, você precisa clicar com o botão direito do mouse no nome do espaço de trabalho, nome do item, nome da pasta ou arquivo no explorador de arquivos do OneLake e selecionar Sincronizar do 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 Sincronizar do OneLake.

Iniciar sessão 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 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, termine sessão. Sair sai do explorador de arquivos OneLake e pausa a sincronização. Para entrar com outra conta, inicie o explorador de arquivos 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 selecionando Sincronizar no 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 sem problemas entre o uso do explorador de arquivos do OneLake e o portal da Web do Fabric. Ao navegar pelos dados do OneLake usando o explorador de arquivos do OneLake, clique com o botão direito do mouse em um espaço de trabalho e selecione "OneLake-View> Workspace Online". Isso abre o navegador de espaço de trabalho no portal da Web do Fabric.
Além disso, você pode clicar com o botão direito do mouse em um item, subpasta ou arquivo e selecionar "OneLake-View> Item Online". Isso 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, se ainda existirem 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.

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. Selecionar Salvar sincroniza 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 o arquivo após a atualização no Excel e ele iniciará 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 em seus itens, incluindo 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 diretório de logs. Isso 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 o log adicional do lado do cliente selecionando Operações>de diagnóstico Habilitar rastreamento.

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. Isso 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.
	Carrapato verde	O ficheiro é transferido para o computador local.
	Sincronizar 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 arquivo ou pasta pode 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?