Доступ к данным Fabric с помощью проводника OneLake

Приложение для работы с файлами OneLake бесшовно интегрируется с Проводником Windows. Это приложение автоматически синхронизирует все элементы OneLake, к которым у вас есть доступ в Windows проводнике. "Синхронизация" относится к извлечению актуальных метаданных файлов и папок и отправке изменений, внесенных локально в службу OneLake. Синхронизация не загружает данные, а создает заполнители. Чтобы скачать данные локально, необходимо дважды щелкнуть файл.

Снимок экрана файлов OneLake, интеграция с экраном Проводника Windows.

При создании, обновлении или удалении файла с помощью проводника Windows он автоматически синхронизирует изменения в службе OneLake. Обновления вашего элемента, сделанные за пределами вашего Проводника, не синхронизируются автоматически. Чтобы получить эти обновления, щелкните правой кнопкой мыши элемент или вложенную папку в проводнике Windows и выберите OneLake>Синхронизировать из OneLake.

Инструкции по установке

В настоящее время проводник OneLake поддерживает Windows и проверяется на Windows 10 и 11.

Чтобы установить:

  1. Скачайте OneLake File Explorer.

  2. Дважды щелкните файл, чтобы начать установку.

    Расположение хранилища на компьютере для заполнителей и скачаемое содержимое — %USERPROFILE%\OneLake - Microsoft\.

После установки и запуска приложения можно просмотреть данные OneLake в Windows проводнике.

Начиная с версии 1.0.13 приложение OneLake уведомляет вас о доступности нового обновления. Когда новая версия станет доступной, вы получите уведомление Windows, а значок OneLake изменится. Щелкните правой кнопкой мыши значок OneLake в области уведомлений Windows. Выберите Доступно обновление и выполните действия по обновлению.

Рекомендации и ограничения

  • Имена рабочих областей с символом "/", закодированные escape-символы, такие как %23 и имена, которые выглядят как идентификаторы GUID, не могут синхронизироваться.

  • Файлы или папки, содержащие зарезервированные символы Windows, не синхронизируются. Дополнительную информацию см. в разделе Именование файлов, путей и пространств имен.

  • Если Windows поиск отключен, проводник OneLake не запускается.

  • Проводник файлов Windows регистр не учитывает, а OneLake регистр учитывает. Вы можете создавать файлы с одинаковым именем, но с различными регистрами в службе OneLake с помощью других средств, но в Проводнике Windows отображается только самый старый из этих файлов.

  • Если файл не удается синхронизировать из-за сетевой проблемы, необходимо активировать синхронизацию с OneLake. Чтобы заставить процесс синхронизации, откройте файл и сохраните его. Кроме того, можно активировать событие изменения с помощью PowerShell , выполнив следующую команду: (Get-Item -Path "<file_path>").LastWriteTimeUtc = Get-Date

  • Проводник OneLake не поддерживает среды, для которых требуются конфигурации сетевого прокси-сервера. Попытки запуска или проверки подлинности приложения за прокси-сервером могут привести к сбоям подключения или проблемам входа.

  • Обозреватель файлов OneLake не поддерживает синхронизацию файлов, помеченных как доступные только для чтения. Это ограничение применяется специально к файлам, которые пользователь помечает как доступные только для чтения на локальном компьютере. Это поведение преднамеренно сконструировано для предотвращения конфликтов с разрешениями локальной файловой системы и избежания непреднамеренного редактирования защищенного содержимого.

Scenarios

Следующие сценарии предоставляют детали для работы с файловым проводником OneLake.

Запуск и закрытие проводника OneLake

Файловый менеджер OneLake запускается автоматически при запуске операционной системы Windows. Приложение можно отключить автоматически, выбрав Startup apps в диспетчере задач Windows и щелкнув правой кнопкой мыши OneLake и выбрав Disable.

  • Чтобы запустить приложение вручную, найдите OneLake с помощью поиска Windows (Windows+S) и выберите приложение OneLake. Вида для любых папок, которые ранее были синхронизированы, обновляются автоматически.

  • Чтобы выйти, щелкните правой кнопкой мыши значок OneLake в области уведомлений Windows, расположенной справа от панели задач, и выберите Exit. Синхронизация приостанавливается, и вы не можете получить доступ к заполнителям файлов и папок. Вы продолжаете видеть синий значок облака для заполнителей, которые ранее были синхронизированы, но не загружены.

Синхронизация обновлений из OneLake

Чтобы оптимизировать производительность во время начальной синхронизации, обозреватель файлов OneLake синхронизирует файлы-заполнители для рабочих областей верхнего уровня и названия элементов. При открытии элемента обозреватель файлов OneLake синхронизирует файлы непосредственно в этой папке. Затем открытие папки в элементе синхронизирует файлы непосредственно в этой папке. Эта функция позволяет легко перемещать содержимое OneLake без необходимости ждать синхронизации всех файлов перед началом работы.

При создании, обновлении или удалении файла с помощью проводника OneLake он автоматически синхронизирует изменения в службе OneLake. Обновления вашего элемента, сделанные за пределами проводника OneLake, не синхронизируются автоматически. Чтобы извлечь эти обновления, щелкните правой кнопкой мыши имя рабочей области, имя элемента, имя папки или файл в проводнике OneLake и выберите OneLake>Sync из OneLake. Это действие обновляет представление для всех папок, которые ранее были синхронизированы. Чтобы извлечь обновления для всех рабочих областей, щелкните правой кнопкой мыши корневую папку OneLake и выберите OneLake>Sync из OneLake.

Вход в разные учетные записи

Начиная с версии 1.0.9.0 при установке проводника OneLake можно выбрать учетную запись для входа. Чтобы переключить учетные записи, щелкните правой кнопкой мыши значок OneLake в области уведомлений Windows, выберите Account, а затем Выйти. Этот процесс завершит работу проводника OneLake и приостановит синхронизацию. Чтобы войти с другой учетной записью, запустите проводник OneLake еще раз и выберите нужную учетную запись.

При входе с другой учетной записью вы увидите, что список рабочих областей и элементов обновляется в проводнике OneLake. Если перейти к рабочим областям, связанным с предыдущей учетной записью, можно вручную обновить представление, щелкнув правой кнопкой мыши рабочую область, а затем выбрав OneLake>Sync из OneLake. Эти рабочие области недоступны при входе в другую учетную запись.

Возможность открытия рабочих областей и элементов на веб-портале

Начиная с версии 1.0.10.0, можно перейти между помощью проводника OneLake и веб-портала Fabric. В проводнике OneLake щелкните правой кнопкой мыши рабочую область и выберите OneLake>Просмотреть рабочую область в Интернете. Это действие открывает браузер рабочей области на веб-портале Fabric.

Щелкните правой кнопкой мыши на элементе, вложенной папке или файле и выберите OneLake>Просмотреть элемент онлайн. Это действие открывает браузер элементов на веб-портале Fabric. Если выбрать вложенную папку или файл, веб-портал Fabric всегда открывает корневую папку элемента.

Поддержка работы в автономном режиме

Обозреватель файлов OneLake синхронизирует обновления только тогда, когда вы подключены к сети и приложение запущено. При запуске приложения представления для всех папок, которые ранее были синхронизированы, автоматически обновляются. Все файлы, добавленные или обновленные в автономном режиме, отображаются как ожидающие синхронизации, пока не сохраните их еще раз. Файлы, которые вы удалили в офлайн-режиме, воссоздаются во время обновления, если они по-прежнему существуют в системе.

Создание файлов или папок в проводнике OneLake

  1. Перейдите в раздел OneLake в проводнике Windows.

  2. Перейдите в папку, которую вы хотите в вашем элементе.

  3. Щелкните правой кнопкой мыши и выберите "Создать папку " или "Создать тип файла".

Note

Синхронизация OneLake терпит неудачу, если вы записываете данные в расположения, где у вас нет разрешения на запись, например, корневой каталог элемента или рабочей области. Очистка файлов или папок, которые не удалось синхронизировать, переместив их в правильное расположение или удалив их.

Удаление файлов или папок в проводнике OneLake

  1. Перейдите в раздел OneLake в проводнике Windows.

  2. Перейдите в папку "Файлы " или "Таблицы " в элементе.

  3. Выберите файл или папку и удалите его.

Изменение файлов

Откройте файлы с помощью любимых приложений и внесите изменения. Выберите Сохранить, чтобы синхронизировать файл с OneLake. Начиная с версии 1.0.11, вы также можете обновлять файлы с помощью Excel. Закройте файл после обновления в Excel, это инициирует синхронизацию с OneLake.

Если вы редактируете файл локально и выберите "Сохранить", приложение обозревателя файлов OneLake обнаруживает, был ли этот файл обновлен в другом месте (другим пользователем), так как вы последний раз выбрали синхронизацию из OneLake. Откроется диалоговое окно подтверждения действия :

Снимок экрана: диалоговое окно

Если вы выбрали "Да", локальные изменения перезаписывают любые другие изменения, внесенные в файл с момента последнего выбора синхронизации из OneLake.

Если выбрать "Нет", локальные изменения не отправляются в службу OneLake. Затем можно выбрать "Синхронизация" из OneLake , чтобы восстановить локальные изменения и извлечь файл из службы. Вы также можете скопировать файл с новым именем, чтобы избежать конфликтов.

Копирование или перемещение файлов

Копируйте файлы в, из и внутри ваших элементов, используя стандартные сочетания клавиш, такие как Ctrl+C и Ctrl+V. Перемещайте файлы, перетаскивая и отпуская их.

Поддержка больших файлов и большого количества файлов

При отправке или скачивании файлов с помощью проводника OneLake производительность аналогична использованию API OneLake. Как правило, время синхронизации изменений из OneLake пропорционально количеству файлов.

Поддержка сочетаний клавиш OneLake

Все папки в ваших элементах, включая ярлыки OneLake, видны. Вы можете просматривать, обновлять и удалять файлы и папки в этих сочетаниях клавиш.

Журналы на стороне клиента

Начиная с версии 1.0.10, вы можете найти журналы на стороне клиента, щелкнув правой кнопкой мыши значок OneLake в области уведомлений Windows, расположенной в правой части панели задач. Выберите диагностические операции>. Откройте папку журналов. Это действие открывает каталог журналов в новом окне проводника Windows.

Локальный компьютер хранит клиентские журналы в %temp%\OneLake\Diagnostics\.

Вы можете активировать больше журналирования на стороне клиента, выбрав Диагностические операции>Включить трассировку.

Заметки о релизе

Начиная с версии 1.0.11, вы можете найти сведения о каждом выпуске проводника OneLake, щелкнув правой кнопкой мыши значок OneLake в области уведомлений Windows справа от панели задач. Выберите О программе>Заметки о выпуске. Это действие открывает в окне браузера страницу заметок о выпуске проводника файлов OneLake.

Руководство по удалению

Чтобы удалить приложение, найдите OneLake в Windows. Выберите "Удалить " в списке параметров в OneLake.

Настройка арендатора предоставляет доступ к проводнику OneLake.

Администраторы клиентов могут ограничить доступ к проводнику OneLake для своей организации на портале администрирования Microsoft Fabric. Если параметр отключен, никто в организации не может запустить приложение обозревателя файлов OneLake. Если приложение уже запущено, а администратор клиента отключает параметр, приложение завершает работу. Заполнители и скачанный контент остаются на локальных компьютерах, но пользователи не могут синхронизировать данные с OneLake или из нее.

Иконки проводника файлов OneLake

Эти значки OneLake отображаются в Проводнике Windows, чтобы указать состояние синхронизации файла или папки.

Icon Описание значка Meaning
Значок синего облака Файл доступен только в Интернете. Файлы, доступные только в Интернете, не занимают места на компьютере.
Зеленая галочка Файл скачан на локальный компьютер.
Синхронизация ожидающих стрелок Синхронизация выполняется. Этот значок может отображаться при отправке файлов. Если ожидающие синхронизации стрелки постоянны, файл или папка могут иметь ошибку синхронизации. Дополнительные сведения см. в журналах на стороне клиента на локальном компьютере %temp%\OneLake\Diagnostics\.