250701_Obsidian Dataview Query Troubleshooting
옵시디언 Dataview 쿼리에서 FROM “folder/**” 사용 시 파일이 보이지 않는 문제 해결 가이드.
1. Dataview 쿼리 이해 및 문법
1.1 FROM 절의 동작 방식
FROM “folder”: 지정 폴더 내 직접 포함 파일 쿼리
FROM “folder/**”: 지정 폴더 및 모든 하위 폴더 파일 쿼리
데이터 소스 정의: Dataview 쿼리의 핵심 요소
1.2 쿼리 문법 정확성
슬래시(/) 사용: Windows 백슬래시() 대신 / 사용 필수
폴더 이름 일치: 대소문자 및 오타 확인
예시 쿼리 구조: TABLE file.mtime 등 기본 쿼리 테스트
2. 오류 원인 분석 및 파일 구조
2.1 경로 및 이름 표기 오류
폴더 구분자: 슬래시(/) 사용 필수 (백슬래시 \ 오류 유발)
이름 불일치: 폴더 이름 오타 및 대소문자 불일치
특수 문자/공백: 파일/폴더명 내 특수 문자, 공백, 한글 사용 주의
2.2 파일 내용 및 메타데이터
빈 파일 제외: 내용 없거나 유효 메타데이터 없는 파일 미포함
파일 존재 여부: 대상 폴더 내 실제 파일 존재 확인
쿼리 파일 위치: 쿼리 파일이 대상 폴더 내 있을 경우 자기 자신 제외 가능성
2.3 Dataview 내부 문제
인덱싱 지연: 새로 생성된 파일/폴더 인덱싱 지연
플러그인 충돌/버그: Dataview 및 관련 플러그인 최신 버전 확인
쿼리 문법/위치: 잘못된 쿼리 문법 또는 쿼리 파일 위치
3. 문제 해결 및 검증
3.1 인덱싱 및 재시작
인덱스 재로드: Dataview 설정에서 강제 인덱스 갱신
옵시디언 재시작: 프로그램 재시작을 통한 문제 해결
플러그인 업데이트: Dataview 플러그인 최신 버전 업데이트/재설치
3.2 쿼리 및 경로 검증
쿼리 비교 테스트: FROM “folder”와 FROM “folder/**” 비교
기본 쿼리 시도: TABLE file.mtime as “마지막 수정” FROM “projects/**” 등
경로/파일명 확인: 오타 및 잘못된 문자 꼼꼼히 확인
3.3 파일 내용 및 메타데이터 확인
내용/메타데이터 포함: 쿼리 대상 파일의 내용 또는 메타데이터 존재 여부
파일명 변경: 특수문자, 공백, 한글 포함 시 영문으로 변경 테스트
실제 파일 존재: 쿼리 결과에 포함되어야 할 파일들의 실제 존재 여부 재확인
