Usare OneLake File Explorer per accedere ai dati di Fabric

L'applicazione OneLake file explorer integra facilmente OneLake con Windows Esplora file. Questa applicazione sincronizza automaticamente tutti gli elementi di OneLake a cui si ha accesso in Windows Esplora file. "Sincronizzazione" si riferisce al pull dei metadati aggiornati su file e cartelle e all'invio di modifiche apportate localmente al servizio OneLake. La sincronizzazione non scarica i dati, ma crea segnaposto. È necessario fare doppio clic su un file per scaricare i dati in locale.

Screenshot dei file OneLake integrati nella schermata di Windows Esplora file.

Importante

Questa funzionalità è disponibile in anteprima.

Quando si crea, aggiorna o elimina un file tramite Windows Esplora file, le modifiche vengono sincronizzate automaticamente con il servizio OneLake. Aggiornamenti all'elemento creato all'esterno del Esplora file non vengono sincronizzati automaticamente. Per eseguire il pull di questi aggiornamenti, è necessario fare clic con il pulsante destro del mouse sull'elemento o sulla sottocartella in Windows Esplora file e scegliere Sincronizza daOneLake.

Istruzioni per l'installazione

OneLake File Explorer supporta attualmente Windows ed è stato convalidato in Windows 10 e 11.

Per effettuare l'installazione:

  1. Scaricare OneLake File Explorer.

  2. Fare doppio clic sul file per avviare l'installazione.

    Il percorso di archiviazione nel PC per i segnaposto e qualsiasi contenuto scaricato è \%USERPROFILE%\OneLake - Microsoft\.

Dopo aver installato e avviato l'applicazione, è ora possibile visualizzare i dati di OneLake in Windows Esplora file.

A partire dalla versione 1.0.12, l'app OneLake File Explorer invia una notifica quando è disponibile un nuovo aggiornamento. Riceverai una notifica di Windows quando diventa disponibile una nuova versione e l'icona OneLake cambierà. Fare clic con il pulsante destro del mouse sull'icona OneLake nell'area di notifica di Windows. Selezionare Aggiorna disponibile e seguire i passaggi per eseguire l'aggiornamento.

Limitazioni e considerazioni

  • Nomi dell'area di lavoro con il carattere "/", caratteri di escape codificati, ad %23esempio , e nomi simili a GUID non sincronizzati.

  • I file o le cartelle contenenti caratteri riservati di Windows (altre informazioni) non riescono a eseguire la sincronizzazione.

  • Se Windows Search è disabilitato, l'avvio di OneLake File Explorer non riesce.

  • Windows Esplora file non fa distinzione tra maiuscole e minuscole, mentre OneLake fa distinzione tra maiuscole e minuscole. È possibile creare file con lo stesso nome ma casi diversi nel servizio OneLake usando altri strumenti, ma Windows Esplora file mostra solo uno dei file (quello meno recente).

  • Se una sincronizzazione di un file non riesce a causa di un problema di rete, sarà necessario attivare la sincronizzazione in OneLake. A tale scopo, aprire il file e salvarlo, richiedendo il processo di sincronizzazione. In alternativa, è possibile attivare un evento di modifica usando PowerShell eseguendo questo comando: (Get-Item -Path "<file_path>").LastWriteTimeUtc = Get-Date

Scenari

Gli scenari seguenti forniscono informazioni dettagliate per l'uso di OneLake File Explorer.

Avvio e uscita da OneLake File Explorer

OneLake File Explorer viene avviato automaticamente all'avvio di Windows. È possibile disabilitare l'avvio automatico dell'applicazione selezionando App di avvio in Gestione attività di Windows, quindi fare clic con il pulsante destro del mouse su OneLake e scegliere Disabilita.

  • Per avviare manualmente l'applicazione, cercare OneLake usando Windows Search (Windows+S) e selezionare l'applicazione OneLake. Le visualizzazioni per tutte le cartelle sincronizzate in precedenza vengono aggiornate automaticamente.

  • Per uscire, fare clic con il pulsante destro del mouse sull'icona OneLake nell'area di notifica di Windows, all'estrema destra della barra delle applicazioni e selezionare Esci. La sincronizzazione viene sospesa e non è possibile accedere a file e cartelle segnaposto. Si continua a visualizzare l'icona della nuvola blu per i segnaposto sincronizzati in precedenza ma non scaricati.

Sincronizzare gli aggiornamenti da OneLake

Per ottimizzare le prestazioni durante la sincronizzazione iniziale, Esplora file OneLake sincronizza i file segnaposto per le aree di lavoro di primo livello e i nomi degli elementi. Quando si apre un elemento, Esplora file di OneLake sincronizza i file direttamente in tale cartella. Quindi, aprendo una cartella all'interno dell'elemento, i file vengono sincronizzati direttamente in tale cartella. Questa funzionalità consente di esplorare facilmente il contenuto di OneLake, senza dover attendere che tutti i file si sincronizzino prima di iniziare a funzionare.

Quando si crea, si aggiorna o si elimina un file tramite Esplora file di OneLake, le modifiche vengono sincronizzate automaticamente nel servizio OneLake. Aggiornamenti all'elemento creato all'esterno di OneLake File Explorer non vengono sincronizzati automaticamente. Per eseguire il pull di questi aggiornamenti, è necessario fare clic con il pulsante destro del mouse sul nome dell'area di lavoro, sul nome dell'elemento, sul nome della cartella o sul file in Esplora file di OneLake e scegliere Sincronizza da OneLake. Questa azione aggiorna la visualizzazione per tutte le cartelle sincronizzate in precedenza. Per eseguire il pull degli aggiornamenti per tutte le aree di lavoro, fare clic con il pulsante destro del mouse sulla cartella radice di OneLake e scegliere Sincronizza da OneLake.

Accedere a account diversi

A partire dalla versione 1.0.9.0, quando si installa OneLake File Explorer, è possibile scegliere l'account con cui eseguire l'accesso. Per cambiare account, fare clic con il pulsante destro del mouse sull'icona OneLake nell'area di notifica di Windows, selezionare Account e quindi Disconnettersi. La disconnessione esce da OneLake File Explorer e sospende la sincronizzazione. Per accedere con un altro account, avviare di nuovo OneLake File Explorer e scegliere l'account desiderato.

Quando si accede con un altro account, viene visualizzato l'elenco di aree di lavoro e gli elementi aggiornati in Esplora file di OneLake. Se si passa alle aree di lavoro associate all'account precedente, è possibile aggiornare manualmente la visualizzazione selezionando Sincronizza da OneLake. Queste aree di lavoro non sono accessibili mentre si è connessi a un account diverso.

Opzione per aprire aree di lavoro ed elementi nel portale Web

A partire dalla versione 1.0.10.0, è possibile eseguire facilmente la transizione tra l'uso di OneLake File Explorer e il portale Web di Fabric. Quando si esplorano i dati di OneLake usando Esplora file OneLake, fare clic con il pulsante destro del mouse su un'area di lavoro e selezionare "OneLake-View> Workspace Online". Verrà aperto il browser dell'area di lavoro nel portale Web di Fabric.
Inoltre, è possibile fare clic con il pulsante destro del mouse su un elemento, sottocartella o file e selezionare "OneLake-View> Item Online". Verrà aperto il browser degli elementi nel portale Web di Fabric. Se si seleziona una sottocartella o un file, il portale Web fabric apre sempre la cartella radice dell'elemento.

Supporto offline

OneLake File Explorer sincronizza gli aggiornamenti solo quando si è online e l'applicazione è in esecuzione. All'avvio dell'applicazione, le visualizzazioni per tutte le cartelle sincronizzate in precedenza vengono aggiornate automaticamente. Tutti i file aggiunti o aggiornati durante la visualizzazione offline come sincronizzazione in sospeso fino a quando non vengono salvati di nuovo. Tutti i file eliminati durante la modalità offline vengono ricreati durante l'aggiornamento, se sono ancora presenti nel servizio.

Creare file o cartelle in Esplora file di OneLake

  1. Passare alla sezione OneLake in Windows Esplora file.

  2. Passare alla cartella appropriata nell'elemento.

  3. Fare clic con il pulsante destro del mouse e selezionare Nuova cartella o Nuovo tipo di file.

Nota

Se si scrivono dati in posizioni in cui non si dispone dell'autorizzazione di scrittura, ad esempio la radice dell'elemento o dell'area di lavoro, la sincronizzazione avrà esito negativo. Pulire i file o le cartelle che non riescono a eseguire la sincronizzazione spostandoli nel percorso corretto o eliminandoli.

Eliminare file o cartelle in Esplora file di OneLake

  1. Passare alla sezione OneLake in Windows Esplora file.

  2. Passare alla cartella File o Tabelle nell'elemento.

  3. Selezionare un file o una cartella ed eliminare.

Modificare file

È possibile aprire i file usando le app preferite e apportare modifiche. Se si seleziona Salva , il file viene sincronizzato con OneLake. A partire dalla versione 1.0.11, è anche possibile apportare aggiornamenti con Excel ai file. Chiudere il file dopo l'aggiornamento in Excel e verrà avviata la sincronizzazione con OneLake.

Se si modifica un file in locale e si seleziona Salva, l'app Esplora file OneLake rileva se il file è stato aggiornato altrove (da un altro utente) dopo l'ultima selezione sincronizzazione da OneLake. Viene visualizzata una finestra di dialogo Conferma azione :

Screenshot della finestra di dialogo Conferma modifica file.

Se si seleziona , le modifiche locali sovrascrivono eventuali altre modifiche apportate al file dall'ultima volta che è stata selezionata l'opzione Sincronizza da OneLake.

Se si seleziona No, le modifiche locali non vengono inviate al servizio OneLake. È quindi possibile selezionare Sincronizza da OneLake per ripristinare le modifiche locali ed eseguire il pull del file dal servizio. In alternativa, è possibile copiare il file con un nuovo nome per evitare conflitti.

Copia o spostamento di file

È possibile copiare file da e all'interno degli elementi usando tasti di scelta rapida standard, ad esempio CTRL+C e CTRL+V. È anche possibile spostare i file trascinandoli e rilasciandoli.

Supporto per file di grandi dimensioni e un numero elevato di file

Quando si caricano o si scaricano file usando OneLake File Explorer, le prestazioni dovrebbero essere simili all'uso delle API OneLake. In generale, il tempo necessario per sincronizzare le modifiche da OneLake è proporzionale al numero di file.

Supporto dei tasti di scelta rapida di OneLake

Tutte le cartelle negli elementi, inclusi i collegamenti a OneLake, sono visibili. È possibile visualizzare, aggiornare ed eliminare i file e le cartelle in tali collegamenti.

Log lato client

A partire dalla versione 1.0.10, è possibile trovare i log lato client facendo clic con il pulsante destro del mouse sull'icona OneLake nell'area di notifica di Windows, che si trova all'estrema destra della barra delle applicazioni. Selezionare Operazioni di>diagnostica Aprire la directory dei log. Verrà aperta la directory dei log in una nuova finestra di Esplora file di Windows.

I log sul lato client vengono archiviati nel computer locale in %temp%\OneLake\Diagnostics\.

È possibile abilitare la registrazione lato client aggiuntiva selezionando Operazioni>di diagnostica Abilita traccia.

Note sulla versione

A partire dalla versione 1.0.11, è possibile trovare informazioni su ogni versione di OneLake File Explorer facendo clic con il pulsante destro del mouse sull'icona OneLake nell'area di notifica di Windows, che si trova all'estrema destra della barra delle applicazioni. Selezionare Informazioni sulle>note sulla versione. Verrà visualizzata la pagina note sulla versione di OneLake File Explorer nella finestra del browser.

Istruzioni di disinstallazione

Per disinstallare l'app, cercare OneLake in Windows. Selezionare Disinstalla nell'elenco delle opzioni in OneLake.

L'impostazione del tenant consente l'accesso a Esplora file di OneLake

Gli amministratori tenant possono limitare l'accesso a OneLake File Explorer per l'organizzazione nel portale di amministrazione di Microsoft Fabric. Quando l'impostazione è disabilitata, nessun utente dell'organizzazione può avviare l'app OneLake File Explorer. Se l'applicazione è già in esecuzione e l'amministratore tenant disabilita l'impostazione, l'applicazione viene chiusa. I segnaposto e i contenuti scaricati rimangono nei computer locali, ma gli utenti non possono sincronizzare i dati da o verso OneLake.

Icone di Esplora file oneLake

Queste icone di Esplora file OneLake vengono visualizzate in Windows Esplora file per indicare lo stato di sincronizzazione del file o della cartella.

Icon Descrizione icona Significato
Icona a forma di nuvola blu Il file è disponibile solo online. I file solo online non occupano spazio sul computer.
Segno di graduazione verde Il file viene scaricato nel computer locale.
Sincronizzare le frecce in sospeso La sincronizzazione è in corso. Questa icona può essere visualizzata quando si caricano file. Se le frecce in sospeso di sincronizzazione sono persistenti, il file o la cartella potrebbe avere un errore di sincronizzazione. Per altre informazioni, vedere i log sul lato client nel computer locale in %temp%\OneLake\Diagnostics\.