Sdoh Dataset Specification
SDOH Dataset Specification
The SDOH Dataset Specification contains the most recent Social Determinants of Health (SDOH) data for the member obtained from data vendors. Each record corresponds to a single member, with memberId serving as its unique key. It references members by Member_ID.
This dataset is essential for organizations focusing on improving health outcomes through a better understanding of how social factors affect health. It supports informed decision-making and policy development in healthcare and public health sectors by providing a comprehensive view of the social determinants impacting community health.
Key Components
Data Storage
Provides robust storage solutions for comprehensive data on SDOH, such as:
Economic stability
Education access and quality
Healthcare access
Neighborhood and built environment
Social and community context
Data Mapping
Includes tools and tables designed to link SDOH data with:
Health outcomes
Patient records
Other relevant healthcare datasets
Enables effective analysis and insights.
Data Logging
Features tables that capture:
Changes
Updates
Access logs related to SDOH data
Ensures a secure and traceable record of all data interactions.
Data Processing
Facilitates efficient processing of SDOH data, enabling:
Integration
Transformation
Analysis
Supports actionable insights and informs public health strategies.
Table: SDOH_Data
Column Name | Is Nullable | Data Type | Description |
| YES | STRING | Unique identifier for the member (patient) the SDOH data pertains to. Essential for linking SDOH data with specific patient records. |
| YES | TIMESTAMP | Timestamp marking when the SDOH data record was initially created. Indicates the entry point of the data into the system. |
| YES | TIMESTAMP | Timestamp of the most recent update to the SDOH data record. Reflects the latest modifications or updates made to the data. |
| YES | TIMESTAMP | Timestamp indicating when the SDOH data was received from the provider. Helps to track the data flow and its recency. |
| YES | TIMESTAMP | Timestamp of the last request for the member's SDOH data. Supports the capability to pause requests for a member if the provider has no new data. |
| NO | STRING | Entity providing the SDOH data, typically HealthyEngage or Experian. This field indicates the source of the SDOH data. |
| YES | INT64 | Aggregate score ranging from 1 to 9, reflecting the overall social determinants of health status of the member. |
| YES | STRING | Categorization of the total score into Low, Medium, or High, providing a quick reference level of SDOH needs. |
| YES | INT64 | Score from 1 to 9 assessing access to healthcare services. Part of the detailed breakdown of SDOH factors. |
| YES | STRING | Level (Low, Medium, or High) corresponding to the access to care score, indicating the relative ease of accessing healthcare services. |
| YES | INT64 | Score from 1 to 9 evaluating access to medications. Highlights potential barriers in obtaining necessary medications. |
| YES | STRING | Level (Low, Medium, or High) associated with the access to medication score, reflecting the accessibility of medications. |
| YES | INT64 | Score from 1 to 9 that assesses the housing situation of the member, an important aspect of social determinants. |
| YES | STRING | Level (Low, Medium, or High) based on the housing score, indicating the stability and adequacy of the member’s living conditions. |
| YES | INT64 | Score from 1 to 9 that evaluates food security and access. Addresses an essential part of the member's social needs. |
| YES | STRING | Level (Low, Medium, or High) derived from the food score, assessing the adequacy of access to nutritious food. |
| YES | INT64 | Score from 1 to 9 measuring the ease of access to emergency medical services, an important factor in acute health situations. |
| YES | STRING | Level (Low, Medium, or High) indicating the ease of accessing emergency services, crucial for assessing emergency healthcare readiness. |
Table: SDOH_Data_Attribute_Map
Column Name | Is Nullable | Data Type | Description |
| YES | STRING | Represents the unique identifier of the member (patient) for whom the SDOH attributes are recorded. This ID links the attribute data directly to the individual member in the SDOH data. |
| NO | STRING | Array of strings identifying the providers of the SDOH data. Each provider might have unique attributes that they supply, which are stored in this table. |
| YES | STRING | The key for additional attributes provided by the SDOH data providers. These keys are specific to each provider and may not be universally supported across all providers. They represent the extra fields in the SDOH response that provide more detailed insights into the social determinants affecting the member. |
| YES | STRING | The value associated with each key in the attribute map. These values give the actual data for the additional SDOH fields provided by the provider, offering more granular details on the member’s social and environmental conditions. |
Table: SDOH_log
Column Name | Is Nullable | Data Type | Description |
| YES | STRING | The identifier for the tenant under which the SDOH data is logged, aiding in data organization and segregation in multi-tenant environments. |
| YES | STRING | Unique identifier of the member whose social determinants of health data are being logged, crucial for linking the SDOH information to the specific individual in the database. |
| YES | TIMESTAMP | Timestamp indicating when the SDOH record was initially created. Reflects the entry point of the data into the logging system. |
SDOH Dataset Specification
SDOH Log
Columns and Descriptions
lastUpdatedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp showing the most recent update to the SDOH record in the log, reflecting the currency of the data.
receivedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp marking when the SDOH data was received, important for tracking the timeliness of data acquisition.
lastRequestedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp of the last request for the SDOH data, useful for understanding demand and access patterns over time.
provider
Is Nullable: YES
Data Type: STRING
Description: The source or provider of the SDOH data, indicating the origin of the information and aiding in source verification.
totalScore
Is Nullable: YES
Data Type: INT64
Description: An aggregate score representing the overall assessment of the member's social and health determinants, useful in broad health risk assessments.
totalLevel
Is Nullable: YES
Data Type: STRING
Description: A categorical level (Low, Medium, or High) derived from the total score, providing a quick summary of the member's overall SDOH status.
accessToCareScore
Is Nullable: YES
Data Type: INT64
Description: A score evaluating the member's access to healthcare services, a key aspect of SDOH.
accessToCareLevel
Is Nullable: YES
Data Type: STRING
Description: The level (Low, Medium, or High) corresponding to the access to care score, giving a rapid assessment of healthcare accessibility.
accessToMedScore
Is Nullable: YES
Data Type: INT64
Description: Score determining the ease of access to medications for the member, an essential factor in ongoing health management.
accessToMedLevel
Is Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) related to the medication access score, summarizing the member's ability to obtain necessary medication.
housingLevelScore
Is Nullable: YES
Data Type: INT64
Description: A score reflecting the member’s housing situation, an important determinant of overall well-being.
housingLevel
Is Nullable: YES
Data Type: STRING
Description: A level (Low, Medium, or High) based on the housing score, indicating the quality and stability of the member’s living conditions.
foodLevelScore
Is Nullable: YES
Data Type: INT64
Description: Score assessing the member's access to adequate and nutritious food, vital for maintaining good health.
foodLevel
Is Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) derived from the food score, highlighting the member's food security status.
accessToERScore
Is Nullable: YES
Data Type: INT64
Description: Score related to the member's access to emergency room services, crucial in urgent health care situations.
accessToERLevel
Is Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) indicating the ease of accessing emergency medical services, a critical component of healthcare infrastructure.
attributeMap
Is Nullable: NO
Data Type: ARRAY
Description: A collection of additional key-value pairs representing specific SDOH attributes provided by the data source, offering more detailed insights into various social and health determinants.
Attribute Map Details
attributeMapKey
Is Nullable: YES
Data Type: STRING
Description: The key for additional attributes provided by the SDOH data providers. These keys are specific to each provider and may not be universally supported across all providers. They represent the extra fields in the SDOH response that provide more detailed insights into the social determinants affecting the member.
attributeMapValue
Is Nullable: YES
Data Type: STRING
Description: The value associated with each key in the attribute map. These values give the actual data for the additional SDOH fields provided by the provider, offering more granular details on the member’s social and environmental conditions.
date
Is Nullable: YES
Data Type: DATE
Description: The specific date when the SDOH log entry was made, providing a temporal context to the logged data.
SDOH Data Raw
Columns and Descriptions
tenant
Is Nullable: YES
Data Type: STRING
Description: Identifies the tenant or the administrative domain within which the SDOH data is managed. This field helps in segregating data across different tenants in multi-tenant environments.
memberId
Is Nullable: YES
Data Type: STRING
Description: Unique identifier for the member (patient) whose social determinants of health (SDOH) data are captured in this record. It is crucial for linking the SDOH data to the specific individual in the healthcare system.
createdAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp indicating when this SDOH data record was initially created, providing insight into the timeline of data collection.
lastUpdatedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp showing the most recent update made to this SDOH data record, which helps in tracking the latest changes and ensuring data currency.
receivedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp marking when the SDOH data was received by the system. This helps in understanding the data flow and timing.
lastRequestedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp of when the SDOH data was last requested, useful for monitoring data access patterns and managing data requests efficiently.
provider
Is Nullable: YES
Data Type: STRING
Description: The source or provider of the SDOH data, indicating where or whom the data was obtained from, which can be crucial for data verification and analysis purposes.
totalScore
Is Nullable: YES
Data Type: INT64
Description: An overall score representing the aggregated assessment of the member's social determinants of health, often used in health risk assessments.
totalLevel
Is Nullable: YES
Data Type: STRING
Description: Categorization of the total score into levels such as Low, Medium, or High, providing a quick, understandable assessment of the member’s overall SDOH status.
accessToCareScore
Is Nullable: YES
Data Type: INT64
Description: A score assessing the member's access to healthcare services, an important aspect of SDOH.
accessToCareLevel
Is Nullable: YES
Data Type: STRING
Description: The level (Low, Medium, or High) corresponding to the access to care score, indicating the ease or difficulty of accessing healthcare services.
accessToMedScore
Is Nullable: YES
Data Type: INT64
Description: A score evaluating the member's access to medications, which is a crucial element in managing health and wellness.
accessToMedLevel
Is Nullable: YES
Data Type: STRING
Description: Level associated with the access to medication score, denoting the member's ability to obtain necessary medications.
housingLevelScore
Is Nullable: YES
Data Type: INT64
Description: Score assessing the member’s housing situation, an important determinant of overall well-being.
SDOH Dataset Specification
Overview
The SDOH (Social Determinants of Health) dataset provides detailed insights into various factors affecting health outcomes. This specification outlines the structure, attributes, and functionality of the dataset, enabling effective analysis and integration into healthcare systems.
Dataset Attributes
Housing Situation
Column Name:
housingLevelIs Nullable: YES
Data Type: STRING
Description: Categorizes the housing score into Low, Medium, or High, indicating the adequacy and stability of the member’s housing conditions.
Food Security
Column Name:
foodLevelScoreIs Nullable: YES
Data Type: INT64
Description: Score related to the member's access to food, particularly in terms of food security and nutrition.
Column Name:
foodLevelIs Nullable: YES
Data Type: STRING
Description: Level derived from the food score, highlighting the member's food security status as Low, Medium, or High.
Emergency Room Access
Column Name:
accessToERScoreIs Nullable: YES
Data Type: INT64
Description: Score assessing the member's access to emergency room (ER) services, which can be critical in urgent health scenarios.
Column Name:
accessToERLevelIs Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) associated with the access to ER score, reflecting how readily the member can obtain emergency medical services.
Attribute Map
Column Name:
attributeMapIs Nullable: NO
Data Type: ARRAY
Description: A collection of additional key-value pairs representing specific SDOH attributes provided by the data source, offering more detailed insights into various social and health determinants.
Attribute Map Details
Column Name:
attributeMapKeyIs Nullable: YES
Data Type: STRING
Description: The key for additional attributes provided by the SDOH data providers. These keys are specific to each provider and may not be universally supported across all providers. They represent the extra fields in the SDOH response that provide more detailed insights into the social determinants affecting the member.
Column Name:
attributeMapValueIs Nullable: YES
Data Type: STRING
Description: The value associated with each key in the attribute map. These values give the actual data for the additional SDOH fields provided by the provider, offering more granular details on the member’s social and environmental conditions.
Data Partitioning
Column Name:
memberPartitionIs Nullable: YES
Data Type: INT64
Description: Used for data segmentation or partitioning, particularly in large datasets, to enhance data management and querying efficiency.
Functional Features
Data Storage
Provides robust storage solutions for comprehensive data on SDOH, such as:
Economic stability
Education access and quality
Healthcare access
Neighborhood and built environment
Social and community context
Data Mapping
Includes tools and tables designed to link SDOH data with:
Health outcomes
Patient records
Other relevant healthcare datasets
Enables effective analysis and insights.
Data Logging
Features tables that capture changes, updates, and access logs related to SDOH data.
Ensures a secure and traceable record of all data interactions.
Data Processing
Facilitates the efficient processing of SDOH data.
Allows for the integration, transformation, and analysis necessary to derive actionable insights and inform public health strategies.
Table Specifications
SDOH_Data Table
Table Name | Column Name | Is Nullable | Data Type | Description |
SDOH_Data |
| YES | STRING | Unique identifier for the member (patient) the SDOH data pertains to. Essential for linking SDOH data with specific patient records. |
SDOH_Data |
| YES | TIMESTAMP | Timestamp marking when the SDOH data record was initially created. Indicates the entry point of the data into the system. |
SDOH_Data |
| YES | TIMESTAMP | Timestamp of the most recent update to the SDOH data record. Reflects the latest modifications or updates made to the data. |
SDOH_Data |
| YES | TIMESTAMP | Timestamp indicating when the SDOH data was received from the provider. Helps to track the data flow and its recency. |
SDOH_Data |
| YES | TIMESTAMP | Timestamp of the last request for the member's SDOH data. Supports the capability to pause requests for a member if the provider has no new data. |
SDOH_Data |
| NO | STRING | Entity providing the SDOH data, typically HealthyEngage or Experian. This field indicates the source of the SDOH data. |
SDOH_Data |
| YES | INT64 | Aggregate score ranging from 1 to 9, reflecting the overall social determinants of health status of the member. |
SDOH_Data |
| YES | STRING | Categorization of the total score into Low, Medium, or High, providing a quick reference level of SDOH needs. |
SDOH_Data |
| YES | INT64 | Score from 1 to 9 assessing access to healthcare services. Part of the detailed breakdown of SDOH factors. |
SDOH_Data |
| YES | STRING | Level (Low, Medium, or High) corresponding to the access to care score, indicating the relative ease of accessing healthcare services. |
SDOH_Data |
| YES | INT64 | Score from 1 to 9 evaluating access to medications. Highlights potential barriers in obtaining necessary medications. |
SDOH_Data |
| YES | STRING | Level (Low, Medium, or High) associated with the access to medication score, reflecting the accessibility of medications. |
SDOH_Data |
| YES | INT64 | Score from 1 to 9 that assesses the housing situation of the member, an important aspect of social determinants. |
SDOH_Data |
| YES | STRING | Level (Low, Medium, or High) based on the housing score, indicating the stability and adequacy of the member’s living conditions. |
SDOH_Data |
| YES | INT64 | Score from 1 to 9 that evaluates food security and access. Addresses an essential part of the member's social needs. |
SDOH_Data |
| YES | STRING | Level (Low, Medium, or High) derived from the food score, assessing the adequacy of access to nutritious food. |
SDOH_Data |
| YES | INT64 | Score from 1 to 9 measuring the ease of access to emergency medical services, an important factor in acute health situations. |
SDOH_Data |
| YES | STRING | Level (Low, Medium, or High) indicating the ease of accessing emergency services, crucial for assessing emergency healthcare readiness. |
SDOH_Data_Attribute_Map Table
Table Name | Column Name | Is Nullable | Data Type | Description |
SDOH_Data_Attribute_Map |
| YES | INT64 | Used for data segmentation or partitioning, particularly in large datasets, to enhance data management and querying efficiency. |
SDOH Dataset Specification
SDOH Data Attribute Map
Columns
Id
Is Nullable: YES
Data Type: STRING
Description: Represents the unique identifier of the member (patient) for whom the SDOH attributes are recorded. This ID links the attribute data directly to the individual member in the SDOH data.
provider
Is Nullable: NO
Data Type: STRING
Description: Array of strings identifying the providers of the SDOH data. Each provider might have unique attributes that they supply, which are stored in this table.
attributeMapKey
Is Nullable: YES
Data Type: STRING
Description: The key for additional attributes provided by the SDOH data providers. These keys are specific to each provider and may not be universally supported across all providers. They represent the extra fields in the SDOH response that provide more detailed insights into the social determinants affecting the member.
attributeMapValue
Is Nullable: YES
Data Type: STRING
Description: The value associated with each key in the attribute map. These values give the actual data for the additional SDOH fields provided by the provider, offering more granular details on the member’s social and environmental conditions.
SDOH Log
Columns
tenant
Is Nullable: YES
Data Type: STRING
Description: The identifier for the tenant under which the SDOH data is logged, aiding in data organization and segregation in multi-tenant environments.
memberId
Is Nullable: YES
Data Type: STRING
Description: Unique identifier of the member whose social determinants of health data are being logged, crucial for linking the SDOH information to the specific individual in the database.
createdAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp indicating when the SDOH record was initially created in the log, helping track the history of data entry.
lastUpdatedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp showing the most recent update to the SDOH record in the log, reflecting the currency of the data.
receivedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp marking when the SDOH data was received, important for tracking the timeliness of data acquisition.
lastRequestedAt
Is Nullable: YES
Data Type: TIMESTAMP
Description: Timestamp of the last request for the SDOH data, useful for understanding demand and access patterns over time.
provider
Is Nullable: YES
Data Type: STRING
Description: The source or provider of the SDOH data, indicating the origin of the information and aiding in source verification.
totalScore
Is Nullable: YES
Data Type: INT64
Description: An aggregate score representing the overall assessment of the member's social and health determinants, useful in broad health risk assessments.
totalLevel
Is Nullable: YES
Data Type: STRING
Description: A categorical level (Low, Medium, or High) derived from the total score, providing a quick summary of the member's overall SDOH status.
accessToCareScore
Is Nullable: YES
Data Type: INT64
Description: A score evaluating the member's access to healthcare services, a key aspect of SDOH.
accessToCareLevel
Is Nullable: YES
Data Type: STRING
Description: The level (Low, Medium, or High) corresponding to the access to care score, giving a rapid assessment of healthcare accessibility.
accessToMedScore
Is Nullable: YES
Data Type: INT64
Description: Score determining the ease of access to medications for the member, an essential factor in ongoing health management.
accessToMedLevel
Is Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) related to the medication access score, summarizing the member's ability to obtain necessary medication.
housingLevelScore
Is Nullable: YES
Data Type: INT64
Description: A score reflecting the member’s housing situation, an important determinant of overall well-being.
housingLevel
Is Nullable: YES
Data Type: STRING
Description: A level (Low, Medium, or High) based on the housing score, indicating the quality and stability of the member’s living conditions.
foodLevelScore
Is Nullable: YES
Data Type: INT64
Description: Score assessing the member's access to adequate and nutritious food, vital for maintaining good health.
foodLevel
Is Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) derived from the food score, highlighting the member's food security status.
accessToERScore
Is Nullable: YES
Data Type: INT64
Description: Score related to the member's access to emergency room services, crucial in urgent health care situations.
accessToERLevel
Is Nullable: YES
Data Type: STRING
Description: Level (Low, Medium, or High) indicating the ease of accessing emergency medical services, a critical component of healthcare infrastructure.
attributeMap
Is Nullable: NO
Data Type: ARRAY
Description: A collection of additional key-value pairs representing specific SDOH attributes provided by the data source, offering more detailed insights into various social and health determinants.
attributeMapKey
Is Nullable: YES
Data Type: STRING
Description: The key for additional attributes provided by the SDOH data providers. These keys are specific to each provider and may not be universally supported across all providers. They represent the extra fields in the SDOH response that provide more detailed insights into the social determinants affecting the member.
attributeMapValue
Is Nullable: YES
Data Type: STRING
Description: The value associated with each key in the attribute map. These values give the actual data for the additional SDOH fields provided by the provider, offering more granular details on the member’s social and environmental conditions.
date
Is Nullable: YES
Data Type: DATE
Description: The specific date when the SDOH log entry was made, providing a temporal context to the logged data.
SDOH Data Raw
Columns
tenant
Is Nullable: YES
Data Type: STRING
Description: Identifies the tenant or the administrative domain within which the SDOH data is managed. This field helps in segregating data across different tenants in multi-tenant environments.
memberId
Is Nullable: YES
Data Type: STRING
Description: Unique identifier for the member (patient) whose social determinants of health (SDOH) data are captured in this record. It is crucial for linking the SDOH data to the specific individual in the healthcare system.
SDOH Dataset Specification
SDOH_Data_raw Fields
createdAt
Required: YES
Type: TIMESTAMP
Description: Timestamp indicating when this SDOH data record was initially created, providing insight into the timeline of data collection.
lastUpdatedAt
Required: YES
Type: TIMESTAMP
Description: Timestamp showing the most recent update made to this SDOH data record, which helps in tracking the latest changes and ensuring data currency.
receivedAt
Required: YES
Type: TIMESTAMP
Description: Timestamp marking when the SDOH data was received by the system. This helps in understanding the data flow and timing.
lastRequestedAt
Required: YES
Type: TIMESTAMP
Description: Timestamp of when the SDOH data was last requested, useful for monitoring data access patterns and managing data requests efficiently.
provider
Required: YES
Type: STRING
Description: The source or provider of the SDOH data, indicating where or whom the data was obtained from, which can be crucial for data verification and analysis purposes.
totalScore
Required: YES
Type: INT64
Description: An overall score representing the aggregated assessment of the member's social determinants of health, often used in health risk assessments.
totalLevel
Required: YES
Type: STRING
Description: Categorization of the total score into levels such as Low, Medium, or High, providing a quick, understandable assessment of the member’s overall SDOH status.
accessToCareScore
Required: YES
Type: INT64
Description: A score assessing the member's access to healthcare services, an important aspect of SDOH.
accessToCareLevel
Required: YES
Type: STRING
Description: The level (Low, Medium, or High) corresponding to the access to care score, indicating the ease or difficulty of accessing healthcare services.
accessToMedScore
Required: YES
Type: INT64
Description: A score evaluating the member's access to medications, which is a crucial element in managing health and wellness.
accessToMedLevel
Required: YES
Type: STRING
Description: Level associated with the access to medication score, denoting the member's ability to obtain necessary medications.
housingLevelScore
Required: YES
Type: INT64
Description: Score assessing the member's housing situation, an essential factor in SDOH that affects health outcomes.
housingLevel
Required: YES
Type: STRING
Description: Categorizes the housing score into Low, Medium, or High, indicating the adequacy and stability of the member’s housing conditions.
foodLevelScore
Required: YES
Type: INT64
Description: Score related to the member's access to food, particularly in terms of food security and nutrition.
foodLevel
Required: YES
Type: STRING
Description: Level derived from the food score, highlighting the member's food security status as Low, Medium, or High.
accessToERScore
Required: YES
Type: INT64
Description: Score assessing the member's access to emergency room (ER) services, which can be critical in urgent health scenarios.
accessToERLevel
Required: YES
Type: STRING
Description: Level (Low, Medium, or High) associated with the access to ER score, reflecting how readily the member can obtain emergency medical services.
attributeMap
Required: NO
Type: ARRAY
Description: A collection of additional key-value pairs representing specific SDOH attributes provided by the data source, offering more detailed insights into various social and health determinants. See below for detailed information on each parameter in the Array.
attributeMap.attributeMapKey
Required: YES
Type: STRING
Description: The key for additional attributes provided by the SDOH data providers. These keys are specific to each provider and may not be universally supported across all providers. They represent the extra fields in the SDOH response that provide more detailed insights into the social determinants affecting the member.
attributeMap.attributeMapValue
Required: YES
Type: STRING
Description: The value associated with each key in the attribute map. These values give the actual data for the additional SDOH fields provided by the provider, offering more granular details on the member’s social and environmental conditions.
memberPartition
Required: YES
Type: INT64
Description: Used for data segmentation or partitioning, particularly in large datasets, to enhance data management and querying efficiency.
