HealthRecordCommunity
FHIR🌏 International🏛 HAPI FHIREnriched

HAPI FHIR HFQL Module Explained: Running SQL-like Queries Against FHIR Repositories

HFQL Module - HAPI FHIR Documentation HAPI FHIR The HAPI

HAPI FHIR JPA server can optionally be configured to support SQL-like queries against the FHIR repository.

October 10, 2025HAPI FHIR

Summary

HAPI FHIR provides an optional 'HFQL Module' allowing the execution of SQL-like queries against a FHIR repository. Intended for analytical purposes, developers can connect directly to the server via a JDBC driver to perform complex data searches.

Key Players

HAPI FHIR

Details

This article details the experimental 'HFQL Module' provided by the HAPI FHIR JPA Server. This feature enables running SQL-like queries against the FHIR repository. It is intended for analytical use cases and users should be aware that performance optimization is not prioritized, meaning execution may take significant time. The module uses a proprietary flavor of SQL specific to HAPI FHIR (similar to Firely Query Language). An example query demonstrates how to extract data such as family names, birth dates, and SSNs from Patient resources. Furthermore, when HFQL is enabled on the server, a JDBC-compatible driver becomes available. This allows direct connection to the FHIR server from database browsers like DBeaver. Implementing this requires specific class name and URL settings for the driver. This functionality is useful in system designs requiring advanced data analysis.

Technology Note

FHIR(Fast Healthcare Interoperability Resources)は医療データ交換の国際標準。このエントリの関連技術: FHIR

📰
Read Original Article
hapifhir.io

Original content copyright by respective publishers