느린 SharePoint 디렉터리 목록 해결 — NetDrive
NetDrive가 대용량 SharePoint 문서 라이브러리를 마운트할 때 목록 조회가 느려지는 원인을 진단하고 해결합니다. 비동기 목록, 캐시 크기, 라이브러리 구조를 다룹니다.
한 마케팅 팀이 공유 SharePoint 문서 라이브러리를 NetDrive로 마운트해서 다른 드라이브처럼 파일을 끌어다 놓을 수 있게 했습니다. 라이브러리는 십여 개의 캠페인 폴더에 걸쳐 20,000개가 넘는 파일로 늘어났고, 이제 탐색기에서 최상위 폴더를 열면 화면이 뜨기까지 몇 초 동안 로딩 표시만 돌아갑니다. 고장난 것은 아닙니다 — 라이브러리가 커서 NetDrive가 목록을 만드는 데 실제로 시간이 걸리는 것뿐입니다.

기다림 없이 SharePoint 마운트하기
NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.
- 대용량 문서 라이브러리를 위한 비동기 디렉터리 목록
- 최대 1TB까지 설정 가능한 디렉터리 캐시
- 상위 파일이 바뀌면 폴더 하나만 강제 새로고침
무료 체험. 평생 라이선스와 구독 플랜 제공.
대용량 SharePoint 라이브러리의 목록 조회가 느린 이유
SharePoint는 로컬 파일시스템처럼 폴더 내용을 한 번의 응답으로 NetDrive에 넘겨주지 않습니다 — SharePoint API를 통해 라이브러리를 열거하는데, 항목이 수천 개인 라이브러리는 이를 훑는 데 실제 시간과 여러 번의 왕복이 필요합니다. NetDrive 3.17.799(2022-11-25) 이전에는 이 열거 작업이 동기적으로 실행되어, 폴더 화면이 전체 목록을 받을 때까지 아무것도 보여주지 못한 채 기다렸습니다. 3.17.799는 바로 이 문제를 해결하기 위해 SharePoint 전용 비동기 목록을 도입했고, 그 덕분에 폴더는 전체 배치가 끝나기를 기다리지 않고 항목이 도착하는 대로 바로 표시할 수 있게 되었습니다.
같은 시기의 릴리스들은 NetDrive가 SharePoint 메타데이터를 보여주는 방식도 개선했습니다 — SharePoint 드라이브의 용량 표시는 비동기 목록 바로 이전 릴리스인 3.16.667(2022-06-30)에 추가되었습니다. 팀이 오래된 NetDrive 설치본에 SharePoint를 마운트한 채 업데이트한 적이 없다면, 대용량 라이브러리에서 목록이 느린 것은 설정 오류가 아니라 예상된 증상입니다.

비동기 목록이 지원되는 버전인지 확인하기
- NetDrive의 Drive Manager를 열고 About 패널(또는 Help 메뉴)에 표시된 버전을 확인합니다.
- 이를 3.17.799와 비교합니다 — 그보다 오래된 버전은 SharePoint 비동기 목록이 도입되기 전입니다. 현재 릴리스는 3.19.7입니다.
- 버전이 뒤처져 있다면 netdrive.net/download에서 최신 설치 프로그램을 받아 재설치하세요. SharePoint 연결과 자격 증명은 그대로 유지됩니다.

디렉터리 캐시에 더 많은 공간 할당하기
한 번 목록이 조회된 폴더는 NetDrive가 그 결과를 로컬에 캐시해 두어서, 다음 방문 시 SharePoint 왕복을 반복하지 않습니다. 캐시 크기는 설정 가능하며 — 3.16.589(2022-03-31)에 도입된 설정으로 최대 1TB까지 가능합니다. 십여 개의 캠페인 폴더와 수만 개의 파일로 이루어진 라이브러리는 기본값보다 큰 할당을 사용할 때 이득을 봅니다. 트리의 더 많은 부분이 세션 사이에도 캐시된 상태로 유지되기 때문입니다. 이 설정은 Drive Manager 안의 드라이브 설정에서 조정할 수 있습니다.
여기에는 신선도라는 트레이드오프가 있습니다: 동료가 브라우저를 통해 SharePoint에 직접 파일을 추가하면, 캐시가 만료되거나 수동으로 새로고침하기 전까지는 해당 폴더에 대한 NetDrive의 캐시된 화면에 그 파일이 보이지 않습니다.

캐시를 기다리는 대신 폴더를 강제로 새로고침하기
특정 캠페인 폴더가 상위에서 방금 바뀐 것을 알고 있다면, 캐시가 만료되기를 기다리거나 NetDrive를 재시작할 필요가 없습니다. 탐색기나 Finder에서 해당 폴더를 우클릭하고 3.8.921부터 NetDrive에 있던 기능인 Force folder refresh를 사용해 그 폴더만 다시 열거하여 캐시된 목록을 갱신하세요.

이렇게 하면 SharePoint 왕복이 변경된 폴더 하나로 국한되어, 다른 곳에 수천 개의 항목이 있는 라이브러리에서도 이 수정 작업이 빠르게 끝납니다.
목록 조회 속도를 유지하도록 라이브러리 구조 잡기
버전과 캐시 설정 외에도, 라이브러리 자체가 어떻게 구성되어 있는지는 NetDrive뿐 아니라 이를 읽는 모든 도구의 목록 조회 속도에 영향을 줍니다.
- 평평한 폴더를 연도나 캠페인별로 나누세요. 여러 해의 자산을 한 폴더에 담아 두면 모든 목록 조회 호출이 그 전체를 훑어야 합니다.
2025/,2026/또는 캠페인별 하위 폴더로 나누면 개별 목록 조회 범위가 작아집니다. - 완료된 캠페인은 활성 폴더에서 보관 처리하세요. 완료된 작업을 팀이 거의 열지 않는 별도 라이브러리나 폴더 트리로 옮기면, 사람들이 매일 둘러보는 폴더가 가볍게 유지됩니다.
마무리
NetDrive에서 SharePoint 목록이 느린 것은 거의 항상 연결 문제가 아니라 버전 및 캐시 문제입니다: 비동기 목록을 위해 3.17.799 이상인지 확인하고, 라이브러리 트리를 담을 만큼 디렉터리 캐시에 여유를 주고, 일회성 업데이트에는 캐시 만료를 기다리는 대신 force folder refresh를 사용하세요. SharePoint 연결 설정 자체에 대해서는 Mount SharePoint on Windows with NetDrive 또는 Mount SharePoint on macOS with NetDrive를 참고하고, S3에 적용되는 동일한 캐싱 메커니즘은 Fix Slow S3 Directory Listing with NetDrive를 참고하세요.
— Robin, NetDrive