FHIR IG analytics| Package | org.sql-on-fhir.ig |
| Resource Type | Library |
| Id | Library-UniquePatientAddressesQuery.json |
| FHIR Version | R5 |
No resources found
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: Library UniquePatientAddressesQuery
Profile: SQL Query Library
| Depends On | patient_view | https://example.org/ViewDefinition/patient_view |
| Depends On | patient_address_view | https://example.org/ViewDefinition/patient_address_view |
| city | in | string | City to filter addresses |
application/sql
WITH ranked_addresses AS (
SELECT
patient_view.id AS patient_id,
patient_view.name,
patient_address_view.address_line1,
patient_address_view.city,
patient_address_view.state,
patient_address_view.postal_code,
patient_address_view.updated_at,
ROW_NUMBER() OVER (
PARTITION BY patient_view.id
ORDER BY patient_address_view.updated_at DESC, patient_address_view.address_id DESC
) AS address_rank
FROM patient_view
JOIN patient_address_view
ON patient_view.id = patient_address_view.patient_id
WHERE patient_view.active = true
AND patient_address_view.city = :city
)
SELECT
patient_id,
name,
address_line1,
city,
state,
postal_code
FROM ranked_addresses
WHERE address_rank = 1application/sql;dialect=postgresql
SELECT DISTINCT ON (patient_view.id)
patient_view.id AS patient_id,
patient_view.name,
patient_address_view.address_line1,
patient_address_view.city,
patient_address_view.state,
patient_address_view.postal_code
FROM patient_view
JOIN patient_address_view
ON patient_view.id = patient_address_view.patient_id
WHERE patient_view.active = true
AND patient_address_view.city = :city
ORDER BY patient_view.id, patient_address_view.updated_at DESC, patient_address_view.address_id DESC{
"resourceType": "Library",
"id": "UniquePatientAddressesQuery",
"meta": {
"profile": [
"https://sql-on-fhir.org/ig/StructureDefinition/SQLQuery"
]
},
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"url": "https://sql-on-fhir.org/ig/Library/UniquePatientAddressesQuery",
"version": "2.1.0-pre",
"name": "UniquePatientAddressesQuery",
"title": "Unique Patient Addresses",
"status": "active",
"type": {
"coding": [
{
"system": "https://sql-on-fhir.org/ig/CodeSystem/LibraryTypesCodes",
"code": "sql-query"
}
]
},
"date": "2026-03-31T14:17:59+00:00",
"publisher": "SQL on FHIR Working Group",
"contact": [
{
"name": "SQL on FHIR Working Group",
"telecom": [
{
"system": "url",
"value": "https://sql-on-fhir.org"
}
]
}
],
"description": "Retrieves each patient's most recent address in a given city. Includes two\ndialects for the same logical query.\n\n**Standard SQL:**\n```sql\nWITH ranked_addresses AS (\n SELECT\n patient_view.id AS patient_id,\n patient_view.name,\n patient_address_view.address_line1,\n patient_address_view.city,\n patient_address_view.state,\n patient_address_view.postal_code,\n patient_address_view.updated_at,\n ROW_NUMBER() OVER (\n PARTITION BY patient_view.id\n ORDER BY patient_address_view.updated_at DESC, patient_address_view.address_id DESC\n ) AS address_rank\n FROM patient_view\n JOIN patient_address_view\n ON patient_view.id = patient_address_view.patient_id\n WHERE patient_view.active = true\n AND patient_address_view.city = :city\n)\nSELECT\n patient_id,\n name,\n address_line1,\n city,\n state,\n postal_code\nFROM ranked_addresses\nWHERE address_rank = 1\n```\n\n**PostgreSQL dialect:**\n```sql\nSELECT DISTINCT ON (patient_view.id)\n patient_view.id AS patient_id,\n patient_view.name,\n patient_address_view.address_line1,\n patient_address_view.city,\n patient_address_view.state,\n patient_address_view.postal_code\nFROM patient_view\nJOIN patient_address_view\n ON patient_view.id = patient_address_view.patient_id\nWHERE patient_view.active = true\n AND patient_address_view.city = :city\nORDER BY patient_view.id, patient_address_view.updated_at DESC, patient_address_view.address_id DESC\n```",
"jurisdiction": [
{
"coding": [
{
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code": "001",
"display": "World"
}
]
}
],
"relatedArtifact": [
{
"type": "depends-on",
"label": "patient_view",
"resource": "https://example.org/ViewDefinition/patient_view"
},
{
"type": "depends-on",
"label": "patient_address_view",
"resource": "https://example.org/ViewDefinition/patient_address_view"
}
],
"parameter": [
{
"name": "city",
"use": "in",
"documentation": "City to filter addresses",
"type": "string"
}
],
"content": [
{
"extension": [
{
"url": "https://sql-on-fhir.org/ig/StructureDefinition/sql-text",
"valueString": "WITH ranked_addresses AS (\n SELECT\n patient_view.id AS patient_id,\n patient_view.name,\n patient_address_view.address_line1,\n patient_address_view.city,\n patient_address_view.state,\n patient_address_view.postal_code,\n patient_address_view.updated_at,\n ROW_NUMBER() OVER (\n PARTITION BY patient_view.id\n ORDER BY patient_address_view.updated_at DESC, patient_address_view.address_id DESC\n ) AS address_rank\n FROM patient_view\n JOIN patient_address_view\n ON patient_view.id = patient_address_view.patient_id\n WHERE patient_view.active = true\n AND patient_address_view.city = :city\n)\nSELECT\n patient_id,\n name,\n address_line1,\n city,\n state,\n postal_code\nFROM ranked_addresses\nWHERE address_rank = 1"
}
],
"contentType": "application/sql",
"data": "V0lUSCByYW5rZWRfYWRkcmVzc2VzIEFTICgKICBTRUxFQ1QKICAgIHBhdGllbnRfdmlldy5pZCBBUyBwYXRpZW50X2lkLAogICAgcGF0aWVudF92aWV3Lm5hbWUsCiAgICBwYXRpZW50X2FkZHJlc3Nfdmlldy5hZGRyZXNzX2xpbmUxLAogICAgcGF0aWVudF9hZGRyZXNzX3ZpZXcuY2l0eSwKICAgIHBhdGllbnRfYWRkcmVzc192aWV3LnN0YXRlLAogICAgcGF0aWVudF9hZGRyZXNzX3ZpZXcucG9zdGFsX2NvZGUsCiAgICBwYXRpZW50X2FkZHJlc3Nfdmlldy51cGRhdGVkX2F0LAogICAgUk9XX05VTUJFUigpIE9WRVIgKAogICAgICBQQVJUSVRJT04gQlkgcGF0aWVudF92aWV3LmlkCiAgICAgIE9SREVSIEJZIHBhdGllbnRfYWRkcmVzc192aWV3LnVwZGF0ZWRfYXQgREVTQywgcGF0aWVudF9hZGRyZXNzX3ZpZXcuYWRkcmVzc19pZCBERVNDCiAgICApIEFTIGFkZHJlc3NfcmFuawogIEZST00gcGF0aWVudF92aWV3CiAgSk9JTiBwYXRpZW50X2FkZHJlc3NfdmlldwogICAgT04gcGF0aWVudF92aWV3LmlkID0gcGF0aWVudF9hZGRyZXNzX3ZpZXcucGF0aWVudF9pZAogIFdIRVJFIHBhdGllbnRfdmlldy5hY3RpdmUgPSB0cnVlCiAgICBBTkQgcGF0aWVudF9hZGRyZXNzX3ZpZXcuY2l0eSA9IDpjaXR5CikKU0VMRUNUCiAgcGF0aWVudF9pZCwKICBuYW1lLAogIGFkZHJlc3NfbGluZTEsCiAgY2l0eSwKICBzdGF0ZSwKICBwb3N0YWxfY29kZQpGUk9NIHJhbmtlZF9hZGRyZXNzZXMKV0hFUkUgYWRkcmVzc19yYW5rID0gMQ=="
},
{
"extension": [
{
"url": "https://sql-on-fhir.org/ig/StructureDefinition/sql-text",
"valueString": "SELECT DISTINCT ON (patient_view.id)\n patient_view.id AS patient_id,\n patient_view.name,\n patient_address_view.address_line1,\n patient_address_view.city,\n patient_address_view.state,\n patient_address_view.postal_code\nFROM patient_view\nJOIN patient_address_view\n ON patient_view.id = patient_address_view.patient_id\nWHERE patient_view.active = true\n AND patient_address_view.city = :city\nORDER BY patient_view.id, patient_address_view.updated_at DESC, patient_address_view.address_id DESC"
}
],
"contentType": "application/sql;dialect=postgresql",
"data": "U0VMRUNUIERJU1RJTkNUIE9OIChwYXRpZW50X3ZpZXcuaWQpCiAgcGF0aWVudF92aWV3LmlkIEFTIHBhdGllbnRfaWQsCiAgcGF0aWVudF92aWV3Lm5hbWUsCiAgcGF0aWVudF9hZGRyZXNzX3ZpZXcuYWRkcmVzc19saW5lMSwKICBwYXRpZW50X2FkZHJlc3Nfdmlldy5jaXR5LAogIHBhdGllbnRfYWRkcmVzc192aWV3LnN0YXRlLAogIHBhdGllbnRfYWRkcmVzc192aWV3LnBvc3RhbF9jb2RlCkZST00gcGF0aWVudF92aWV3CkpPSU4gcGF0aWVudF9hZGRyZXNzX3ZpZXcKICBPTiBwYXRpZW50X3ZpZXcuaWQgPSBwYXRpZW50X2FkZHJlc3Nfdmlldy5wYXRpZW50X2lkCldIRVJFIHBhdGllbnRfdmlldy5hY3RpdmUgPSB0cnVlCiAgQU5EIHBhdGllbnRfYWRkcmVzc192aWV3LmNpdHkgPSA6Y2l0eQpPUkRFUiBCWSBwYXRpZW50X3ZpZXcuaWQsIHBhdGllbnRfYWRkcmVzc192aWV3LnVwZGF0ZWRfYXQgREVTQywgcGF0aWVudF9hZGRyZXNzX3ZpZXcuYWRkcmVzc19pZCBERVND"
}
]
}