Menggunakan penjelajah file OneLake untuk mengakses data Fabric

Aplikasi penjelajah file OneLake mengintegrasikan OneLake dengan Windows File Explorer. Aplikasi ini secara otomatis menyinkronkan semua item OneLake yang dapat Anda akses di Windows File Explorer. "Sinkronisasi" mengacu pada menarik metadata terbaru pada file dan folder, dan mengirim perubahan yang dilakukan secara lokal ke layanan OneLake. Sinkronisasi tidak mengunduh data, tetapi membuat tempat penampung. Anda harus mengeklik dua kali file untuk mengunduh data secara lokal.

Saat Anda membuat, memperbarui, atau menghapus file melalui Windows File Explorer, file explorer secara otomatis menyinkronkan perubahan ke layanan OneLake. Pembaruan pada item yang dibuat di luar File Explorer Anda tidak disinkronkan secara otomatis. Untuk menarik pembaruan ini, Anda perlu mengklik kanan item atau subfolder di Windows File Explorer dan memilih OneLake>Sync dari OneLake.

Instruksi penginstalan

Penjelajah file OneLake saat ini mendukung Windows dan divalidasi pada Windows 10 dan 11.

Untuk menginstal:

1. Unduh penjelajah file OneLake.

2. Klik dua kali file untuk mulai menginstal.

   Lokasi penyimpanan di PC Anda untuk placeholder (tempat penampung) dan konten apa pun yang diunduh adalah %USERPROFILE%\OneLake - Microsoft\.

Setelah aplikasi diinstal dan berjalan, Anda dapat melihat data OneLake Anda di Windows File Explorer.

Mulai versi 1.0.13, aplikasi penjelajah file OneLake memberi tahu Anda saat pembaruan baru tersedia. Saat versi baru tersedia, Anda menerima pemberitahuan Windows dan ikon OneLake berubah. Klik kanan ikon OneLake di area pemberitahuan Windows. Pilih Perbarui Tersedia dan ikuti langkah-langkah untuk memperbarui.

Batasan dan pertimbangan

• Nama ruang kerja yang menggunakan karakter "/", karakter pelolosan yang dikodekan seperti %23, dan nama yang serupa dengan GUID tidak dapat disinkronkan.

• File atau folder yang berisi karakter yang dipesan oleh Windows gagal disinkronkan. Untuk informasi selengkapnya, lihat Penamaan file, jalur, dan namespace.

• Jika pencarian Windows dinonaktifkan, penjelajah file OneLake gagal dimulai.

• Windows File Explorer tidak sensitif huruf besar-kecil, sementara OneLake sensitif huruf besar-kecil. Anda dapat membuat file dengan nama yang sama tetapi kasus yang berbeda di layanan OneLake dengan menggunakan alat lain, tetapi Windows File Explorer hanya menampilkan file terlama ini.

• Jika file gagal disinkronkan karena masalah jaringan, Anda harus memicu sinkronisasi ke OneLake. Untuk meminta proses sinkronisasi, buka file dan simpan. Atau, Anda dapat memicu peristiwa modifikasi menggunakan PowerShell dengan menjalankan perintah ini: (Get-Item -Path "<file_path>").LastWriteTimeUtc = Get-Date

• OneLake File Explorer tidak mendukung lingkungan yang memerlukan konfigurasi proksi jaringan. Upaya untuk meluncurkan atau mengautentikasi aplikasi di belakang proksi dapat mengakibatkan kegagalan koneksi atau masalah masuk.

• OneLake File Explorer tidak mendukung sinkronisasi file yang ditandai sebagai baca-saja. Batasan ini berlaku khusus untuk file yang ditandai pengguna sebagai baca-saja di komputer lokal mereka. Perilaku ini dirancang untuk mencegah konflik dengan izin sistem file lokal dan untuk menghindari pengeditan yang tidak diinginkan pada konten yang dilindungi.

Scenarios

Skenario berikut memberikan detail untuk bekerja dengan penjelajah file OneLake.

Mulai dan keluar dari penjelajah file OneLake

Penjelajah file OneLake dimulai secara otomatis saat memulai Windows. Anda dapat menonaktifkan aplikasi dari memulai secara otomatis dengan memilih aplikasi Startup di Windows Task Manager lalu mengklik kanan OneLake, dan memilih Disable.

• Untuk memulai aplikasi secara manual, cari OneLake dengan menggunakan pencarian Windows (Windows+S) dan pilih aplikasi OneLake. Tampilan untuk folder apa pun yang sebelumnya disinkronkan akan diperbarui secara otomatis.

• Untuk keluar, klik kanan ikon OneLake di area pemberitahuan Windows, yang terletak di ujung kanan taskbar, dan pilih Exit. Sinkronisasi berhenti sementara, dan Anda tidak dapat mengakses file dan folder tempat penampung. Anda terus melihat ikonnya berupa awan biru untuk tempat penampung yang telah disinkronkan sebelumnya tetapi belum diunduh.

Menyinkronkan pembaruan dari OneLake

Untuk mengoptimalkan performa selama sinkronisasi awal, file explorer OneLake menyinkronkan file tempat penampung untuk ruang kerja tingkat atas dan nama item. Saat Anda membuka item, penjelajah file OneLake menyinkronkan file langsung di folder tersebut. Kemudian, membuka folder dalam item akan menyinkronkan file langsung di folder tersebut. Fungsionalitas ini memungkinkan Anda menavigasi konten OneLake Anda dengan mulus, tanpa harus menunggu semua file disinkronkan sebelum mulai berfungsi.

Saat Anda membuat, memperbarui, atau menghapus file melalui penjelajah file OneLake, file explorer secara otomatis menyinkronkan perubahan ke layanan OneLake. Pembaruan pada item Anda yang dibuat di luar penjelajah file OneLake Anda tidak disinkronkan secara otomatis. Untuk menarik pembaruan ini, klik kanan pada nama ruang kerja, nama item, nama folder, atau file di penjelajah file OneLake dan pilih OneLake>Sync dari OneLake. Tindakan ini me-refresh tampilan untuk folder apa pun yang sebelumnya disinkronkan. Untuk mengambil pembaruan untuk semua ruang kerja, klik kanan pada folder utama OneLake dan pilih OneLake>Sync dari OneLake.

Masuk ke akun yang berbeda

Mulai versi 1.0.9.0, saat menginstal penjelajah file OneLake, Anda dapat memilih akun mana yang akan masuk. Untuk beralih akun, klik kanan ikon OneLake di area pemberitahuan Windows, pilih Account, lalu Sign Out. Keluar dari penjelajah file OneLake dan menjeda sinkronisasi. Untuk masuk dengan akun lain, mulai kembali penjelajah file OneLake dan pilih akun yang diinginkan.

Saat Anda masuk dengan akun lain, Anda melihat daftar berbagai ruang kerja dan item yang diperbarui di penjelajah file OneLake. Jika Anda menavigasi ke ruang kerja yang terkait dengan akun sebelumnya, Anda dapat me-refresh tampilan secara manual dengan mengklik kanan ruang kerja, lalu memilih OneLake>Sync dari OneLake. Ruang kerja tersebut tidak dapat diakses saat Anda masuk ke akun lain.

Opsi untuk membuka ruang kerja dan item di portal web

Mulai versi 1.0.10.0, Anda dapat beralih antara menggunakan penjelajah file OneLake dan portal web Fabric. Dari penjelajah file OneLake, klik kanan pada ruang kerja dan pilih OneLake>Lihat ruang kerja online. Tindakan ini membuka browser ruang kerja di portal web Fabric.

Anda dapat mengklik kanan item, subfolder, atau file dan memilih OneLake>Menampilkan item secara online. Tindakan ini membuka browser item di portal web Fabric. Jika Anda memilih subfolder atau file, portal web Fabric selalu membuka folder akar item.

Dukungan offline

Penjelajah file OneLake hanya menyinkronkan pembaruan saat Anda online dan aplikasi sedang berjalan. Ketika aplikasi dimulai, tampilan untuk folder apa pun yang sebelumnya disinkronkan refresh secara otomatis. File apa pun yang Anda tambahkan atau perbarui saat offline ditampilkan sebagai sinkronisasi tertunda hingga Anda menyimpannya lagi. File apa pun yang Anda hapus saat offline dibuat ulang selama refresh jika masih ada di layanan.

Membuat file atau folder di penjelajah file OneLake

1. Buka bagian OneLake di Windows File Explorer.

2. Buka folder yang Anda inginkan di item Anda.

3. Klik kanan dan pilih Folder baru atau Jenis file baru.

Note

Sinkronisasi OneLake gagal jika Anda menulis data ke lokasi di mana Anda tidak memiliki izin tulis, seperti akar item atau ruang kerja. Bersihkan file atau folder yang gagal disinkronkan dengan memindahkannya ke lokasi yang benar atau menghapusnya.

Menghapus file atau folder di penjelajah file OneLake

1. Buka bagian OneLake di Windows File Explorer.

2. Buka folder File atau Tabel di item Anda.

3. Pilih file atau folder dan hapus.

Mengedit file

Buka file dengan menggunakan aplikasi favorit Anda dan lakukan pengeditan. Pilih Simpan untuk menyinkronkan file ke OneLake. Mulai versi 1.0.11, Anda juga dapat membuat pembaruan pada file Anda dengan menggunakan Excel. Close file setelah pembaruan di Excel dan memulai sinkronisasi ke OneLake.

Jika Anda mengedit file secara lokal dan memilih Simpan, aplikasi penjelajah file OneLake mendeteksi apakah file tersebut diperbarui di tempat lain (oleh orang lain) sejak Terakhir Anda memilih Sinkronkan dari OneLake. Kotak dialog Konfirmasi tindakan muncul:

Jika Anda memilih Ya, perubahan lokal Anda mengganti semua perubahan lain yang telah dilakukan pada file sejak terakhir kali Anda memilih Sinkronkan dari OneLake.

Jika Anda memilih Tidak, perubahan lokal tidak dikirim ke layanan OneLake. Anda kemudian dapat memilih Sinkronkan dari OneLake untuk mengembalikan perubahan lokal Anda dan menarik file dari layanan. Atau Anda dapat menyalin file dengan nama baru untuk menghindari konflik.

Menyalin atau memindahkan file

Salin file ke, dari, dan di dalam item Anda dengan menggunakan pintasan keyboard standar seperti Ctrl+C dan Ctrl+V. Pindahkan file dengan menyeret dan menjatuhkannya.

Dukungan untuk file berukuran besar dan dalam jumlah banyak

Saat Anda mengunggah atau mengunduh file dengan menggunakan penjelajah file OneLake, performanya mirip dengan menggunakan API OneLake. Secara umum, waktu yang diperlukan untuk menyinkronkan perubahan dari OneLake sebanding dengan jumlah file.

Dukungan pintasan OneLake

Semua folder dalam item Anda termasuk pintasan OneLake terlihat. Anda dapat melihat, memperbarui, dan menghapus file dan folder di pintasan tersebut.

Log sisi klien

Mulai versi 1.0.10, Anda dapat menemukan log sisi klien dengan mengklik kanan ikon OneLake di area pemberitahuan Windows, yang terletak di ujung kanan taskbar. Pilih operasi diagnostik >Buka folder log. Tindakan ini membuka direktori log Anda di jendela penjelajah file Windows baru.

Komputer lokal menyimpan log sisi klien di bawah %temp%\OneLake\Diagnostics\.

Anda dapat mengaktifkan pencatatan log sisi klien lebih lanjut dengan memilih operasi diagnostik >Aktifkan pelacakan.

Catatan Rilis

Mulai versi 1.0.11, Anda dapat menemukan informasi tentang setiap rilis penjelajah file OneLake dengan mengklik kanan ikon OneLake di area pemberitahuan Windows, yang terletak di ujung kanan taskbar. Pilih Tentang>Catatan Rilis. Tindakan ini membuka halaman catatan rilis penjelajah file OneLake di jendela browser Anda.

Instruksi untuk Menghapus Instalasi

Untuk menghapus instalan aplikasi, cari OneLake di Windows. Pilih Hapus instalan dalam daftar opsi di bawah OneLake.

Pengaturan penyewa memungkinkan akses ke penjelajah file OneLake

Admin penyewa dapat membatasi akses ke penjelajah file OneLake untuk organisasi mereka di portal admin Microsoft Fabric. Saat pengaturan dinonaktifkan, tidak ada orang di organisasi Anda yang dapat memulai aplikasi penjelajah file OneLake. Jika aplikasi sudah berjalan dan admin penyewa menonaktifkan pengaturan, aplikasi akan keluar. Tempat penampung dan konten apa pun yang diunduh tetap ada di komputer lokal, tetapi pengguna tidak dapat menyinkronkan data ke atau dari OneLake.

Ikon penjelajah file OneLake

Ikon penjelajah file OneLake ini muncul di Windows File Explorer untuk menunjukkan status sinkronisasi file atau folder.

Icon	Deskripsi ikon	Meaning
	Ikon awan biru	File hanya tersedia secara online. File yang hanya online tidak memakan ruang di komputer Anda.
	Centang hijau	File diunduh ke komputer lokal Anda.
	Sinkronkan panah yang tertunda	Sinkronisasi sedang berlangsung. Ikon ini mungkin muncul saat Anda mengunggah file. Jika panah yang tertunda sinkronisasi tetap ada, maka file atau folder Anda mungkin mengalami kesalahan saat menyinkronkan. Anda dapat menemukan informasi selengkapnya di log sisi klien di komputer lokal Anda di bawah %temp%\OneLake\Diagnostics\.

Konten terkait

• Apa yang baru dalam penjelajah file OneLake terbaru?