Dataview 심화: Dataviewjs의 Query Evaluation

Dataview 플러그인의 Query Evaluation은 데이터를 쿼리하고 결과를 구조화된 형태로 반환받을 수 있게 해줍니다.

dv.query(source, [file, settings])

Dataview 쿼리를 실행하고 결과를 구조화된 반환 형태로 제공합니다. 반환되는 객체는 실행된 쿼리 유형에 따라 다르지만, 항상 반환 유형을 나타내는 type 속성을 포함합니다. 쿼리 실행에 실패할 경우 오류를 발생시키는 대신 결과 유형을 반환합니다.

await dv.query("LIST FROM #tag")

태그 기반 리스트 쿼리 결과를 반환합니다.

await dv.query("TABLE WITHOUT ID file.name, value FROM 'path'")

지정된 경로에서 파일 이름과 값으로 구성된 테이블 쿼리 결과를 반환합니다.

await dv.query("TASK WHERE due")

마감 기한이 있는 작업 목록을 반환합니다.

추가 인자

• file: 쿼리를 해석할 기준 파일 경로 (기본값은 현재 파일).
• settings: 쿼리 실행 설정. 고급 사용 사례에 해당하며, 사용 가능한 모든 옵션을 보려면 API 구현을 직접 확인하는 것이 좋습니다.

dv.tryQuery(source, [file, settings])

dv.query와 동일하지만, 쿼리 실행 실패 시 JavaScript 예외를 발생시키므로 짧은 스크립트에서 더 편리하게 사용됩니다.

dv.queryMarkdown(source, [file], [settings])

dv.query()와 동일하지만, 결과를 렌더링된 Markdown으로 반환합니다.

await dv.queryMarkdown("LIST FROM #tag")

태그 기반 리스트를 Markdown 형식으로 반환합니다.

dv.tryQueryMarkdown(source, [file], [settings])

dv.queryMarkdown()과 동일하지만, 구문 분석 실패 시 오류를 발생시킵니다.

dv.tryEvaluate(expression, [context]), dv.evaluate(expression, [context])

임의의 Dataview 표현식을 평가하고 결과를 반환합니다. dv.tryEvaluate는 평가 또는 구문 분석 실패 시 오류를 발생시키며, dv.evaluate는 결과 객체를 반환하여 평가의 성공 여부를 확인할 수 있습니다.

dv.tryEvaluate("2 + 2")

4를 반환합니다.

dv.evaluate("2 + 2")

성공적인 평가 결과로 4를 반환합니다.

---