{
  "resourceType" : "Library",
  "id" : "UniquePatientAddressesQuery",
  "meta" : {
    "profile" : ["http://hl7.org/fhir/uv/sql-on-fhir/StructureDefinition/SQLQuery"]
  },
  "language" : "en",
  "text" : {
    "status" : "extensions",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n  <table class=\"narrative-table\">\n    <tbody>\n<tr>\n\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\">Metadata</th>\n\n\n</tr>\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Title</th>\n\n\n\n<td class=\"content-container\">Unique Patient Addresses</td>\n\n\n</tr>\n\n\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Version</th>\n\n\n\n<td class=\"content-container\">3.0.0-ballot</td>\n\n\n</tr>\n\n\n\n\n\n\n\n  \n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Identifier</th>\n\n\n\n<td class=\"content-container\">urn:oid:2.16.840.1.113883.4.642.40.77.28.5</td>\n\n\n</tr>\n\n\n\n\n\n\n\n\n\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Jurisdiction</th>\n\n\n\n<td class=\"content-container\">\n    World\n\n\n</td>\n\n\n</tr>\n\n\n\n\n\n\n\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Steward (Publisher)</th>\n\n\n\n<td class=\"content-container\">HL7 International / FHIR Infrastructure</td>\n\n\n</tr>\n\n\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Steward Contact</th>\n\n\n\n<td class=\"content-container\">HL7 International / FHIR Infrastructure</td>\n\n\n</tr>\n\n\n\n\n\n\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Description</th>\n\n\n\n<td class=\"content-container\"><div><p>Retrieves each patient's most recent address in a given city. Includes two\ndialects for the same logical query.</p>\n<p><strong>Standard SQL:</strong></p>\n<pre><code class=\"language-sql\">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\n</code></pre>\n<p><strong>PostgreSQL dialect:</strong></p>\n<pre><code class=\"language-sql\">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\n</code></pre>\n</div></td>\n\n\n</tr>\n\n\n\n\n\n\n<tr>\n\n\n<th scope=\"row\" class=\"row-header\">Type</th>\n\n\n\n<td class=\"content-container\">\n    sql-query from <a href=\"CodeSystem-LibraryTypesCodes.html\">http://hl7.org/fhir/uv/sql-on-fhir/CodeSystem/LibraryTypesCodes</a> \n\n\n</td>\n\n\n</tr>\n\n\n\n<tr>\n  \n  \n  \n  \n  \n\n<th scope=\"row\" class=\"row-header\">Dependency</th>\n\n\n  \n  \n  <td class=\"content-container\">\n    \n    \n    \n    \n    \n    <em>Resource</em>: <code>https://example.org/ViewDefinition/patient_view</code>\n    <br/>\n    <em>Canonical URL</em>: <tt>https://example.org/ViewDefinition/patient_view</tt>\n    \n    \n    \n  </td>\n</tr>\n\n<tr>\n  \n  \n  \n  \n  \n\n<th scope=\"row\" class=\"row-header\">Dependency</th>\n\n\n  \n  \n  <td class=\"content-container\">\n    \n    \n    \n    \n    \n    <em>Resource</em>: <code>https://example.org/ViewDefinition/patient_address_view</code>\n    <br/>\n    <em>Canonical URL</em>: <tt>https://example.org/ViewDefinition/patient_address_view</tt>\n    \n    \n    \n  </td>\n</tr>\n\n\n\n\n\n\n\n\n<tr>\n\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\"><a name=\"parameters\"> </a>Parameters</th>\n\n\n</tr>\n\n<tr>\n  \n\n<th scope=\"row\" class=\"row-header\"/>\n\n\n  <td class=\"content-container\">\n    <table>\n      <thead>\n        <tr>\n          <td><em>Name</em></td>\n          <td><em>Use</em></td>\n          <td><em>Card.</em></td>\n          <td><em>Type</em></td>\n          <td><em>Documentation</em></td>\n        </tr>\n      </thead>\n      <tbody>\n      \n        <tr>\n          <td>city</td>\n          <td>In</td>\n          <td>0..1</td>\n          <td>string</td>\n          <td>City to filter addresses</td>\n        </tr>\n      \n      </tbody>\n    </table>\n  </td>\n</tr>\n\n\n\n\n\n\n\n  <tr>\n\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\">Library Content</th>\n\n\n</tr>\n  \n    \n    <tr>\n      <th scope=\"row\" class=\"row-header\">application/sqlContent</th>\n      <td>\n        <pre style=\"border: none;\" class=\"content-container highlight language-cql\"><code>Encoded data </code></pre>\n      </td>\n    </tr>\n    \n  \n    \n    <tr>\n      <th scope=\"row\" class=\"row-header\">application/sql;dialect=postgresqlContent</th>\n      <td>\n        <pre style=\"border: none;\" class=\"content-container highlight language-cql\"><code>Encoded data </code></pre>\n      </td>\n    </tr>\n    \n  \n\n<tr>\n  <th colspan=\"2\" scope=\"row\" class=\"row-header\">Generated using version 0.5.4 of the sample-content-ig Liquid templates</th>\n</tr>\n\n    </tbody>\n  </table>\n</div>"
  },
  "url" : "http://hl7.org/fhir/uv/sql-on-fhir/Library/UniquePatientAddressesQuery",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.77.28.5"
  }],
  "version" : "3.0.0-ballot",
  "name" : "UniquePatientAddressesQuery",
  "title" : "Unique Patient Addresses",
  "status" : "active",
  "type" : {
    "coding" : [{
      "system" : "http://hl7.org/fhir/uv/sql-on-fhir/CodeSystem/LibraryTypesCodes",
      "code" : "sql-query"
    }]
  },
  "date" : "2026-08-13T15:42:34+00:00",
  "publisher" : "HL7 International / FHIR Infrastructure",
  "contact" : [{
    "name" : "HL7 International / FHIR Infrastructure",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/fiwg"
    }]
  }],
  "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" : "http://hl7.org/fhir/uv/sql-on-fhir/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" : "http://hl7.org/fhir/uv/sql-on-fhir/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"
  }]
}