Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O aplicativo gerenciador de arquivos OneLake integra perfeitamente o OneLake ao Explorador de Arquivos do Windows. Esse aplicativo sincroniza automaticamente todos os itens do OneLake aos quais você tem acesso no Explorador de Arquivos do 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. Ela cria espaços reservados. Você deve clicar duas vezes em um arquivo para baixar os dados localmente.
Importante
Esse recurso está em versão prévia.
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. Atualizações no seu 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
Atualmente, o Gerenciador de Arquivos do OneLake dá suporte ao Windows e é validado no Windows 10 e 11.
Para instalar:
Baixe o explorador de arquivos do OneLake.
Clique duas vezes no arquivo para iniciar a instalação.
O local de armazenamento no computador no qual 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 do 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 estiver disponível, você receberá uma notificação do Windows e o ícone do OneLake será 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ç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 caracteres reservados do Windows não são sincronizados. Para obter mais informações, consulte Arquivos de nomenclatura, caminhos e namespaces.
Se a pesquisa do Windows estiver desabilitada, o gerenciador de arquivos do OneLake falhará ao iniciar.
O Explorador de Arquivos do Windows não diferencia maiúsculas de minúsculas, enquanto o OneLake diferencia. 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 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
Cenários
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 gerenciador de arquivos do OneLake é iniciado automaticamente na inicialização do Windows. Você pode desabilitar o aplicativo de iniciar automaticamente selecionando Aplicativos de inicialização no Gerenciador de Tarefas do Windows, clicando com o botão direito do mouse em OneLake e selecionando Desabilitar.
Para iniciar manualmente o aplicativo, pesquise "OneLake" usando a pesquisa do Windows (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 OneLake na área de notificação do Windows, localizada na extrema 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ê 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 OneLake na área de notificação do Windows, selecione Conta e, em seguida, Sair. Sair do serviço sairá do explorador de arquivos do OneLake e pausará 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 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>Exibir espaço de trabalho online. Essa ação abre o navegador do espaço de trabalho no portal da 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 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 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
Navegue até a seção OneLake no Explorador de Arquivos do Windows.
Navegue até a pasta apropriada em seu item.
Clique com o botão direito do mouse e selecione Nova pasta ou Novo tipo de arquivo.
Observação
A sincronização do OneLake falhará se você gravar dados em locais em que não tem permissão de gravação, como a raiz do item ou do workspace. Limpe arquivos ou pastas que não foram sincronizados movendo-os para o local correto ou excluindo-os.
Excluir arquivos ou pastas no explorador de arquivos do OneLake
Navegue até a seção OneLake no Explorador de Arquivos do Windows.
Navegue até a pasta Arquivos ou Tabelas em seu item.
Selecione um arquivo ou pasta e exclua.
Editar arquivos
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. Fechar o 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 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
Você pode copiar arquivos para, de e em 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 de APIs 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 do Windows, localizada na extremidade 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 do Windows.
Os logs do lado do cliente são armazenados no computador local em %temp%\OneLake\Diagnostics\.
Você pode habilitar registro em log adicional do lado do cliente selecionando Operações de Diagnóstico>Habilitar rastreamento.
Notas sobre a versão
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 do Windows, localizada na extremidade 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, pesquise 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 explorador 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 do Windows para indicar o estado de sincronização do arquivo ou pasta.
| Ícone | Descrição do ícone | Significado |
|---|---|---|
|
Ícone de nuvem azul | O arquivo só está disponível online. Os arquivos somente online não ocuparão espaço no computador. |
|
Marca de seleção 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\. |