Config Database Tables

advertisement
MPOG Config Database
Tables and Their Uses
Introduction
The MPOG configuration database (MPOG_MAS_CONFIG) is used to store data and procedures relevant to ETL
processes that pull data out of an AIMS and into MPOG.
These data pulls are divided into two steps. First, “concept extracts” are used to scan the source database for
variables. The results of this scan are then inserted into the MPOG config database for later mapping. Once the
mapping is complete, “data extracts” are run to pull data from the source database, apply the mappings from the
config database, and finally inserting into the main MPOG database (MPOG_MAS).
Note that because each institution can have very different ETL processes, the config database is not coupled to the
main MPOG database. Aside from being compatible with the variable mapping utility, the config database tables
are used largely as a convention.
Mapping Tables
The mapping tables, those prefixed with “Configuration_”, are used to map the relationship between variables
found in an institution’s AIMS and MPOG concepts. Creating this relationship is important as it establishes a
standard data dictionary across multiple contributing centers.
As an example, a systolic blood pressure measured from an arterial line could be represented with an internal type
identifier of 3245. The MPOG equivalent concept is “BP Sys Arterial Line (Invasive, Peripheral)”, represented in
MPOG as 3030. In order to create this relationship, the internal identifier of 3245, an appropriate description, and
an estimated row count are inserted into the Configuration_PhysiologicVariableTranslation. An individual with
clinical knowledge can then use the variable mapping utility provided to map the two identifiers together based
upon the provided description. Once mapped, the extract that will pull vital sign monitor data can then join to this
mapping table to transform variable 3245 to MPOG concept 3030.
1
Figure 1: Screenshot of the variable mapping utility
Configuration_IntraopMedication
This table is used to store variable mappings for both medications and fluids. This applies to two locations in the
main MPOG database:
Associated Columns in Main Database
AIMS_IntraopInputOutputs
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_IO_Concept_ID
MPOG_IO_Concept_ID
AIMS_IntraopMedications
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Med_Concept_ID
MPOG_Med_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for medication or fluid type
AIMS_Concept_Desc
Readable description for medication or fluid type (e.g. “Propofol” or “Urine Output”)
AIMS_Usage
The estimated row count for this identifier. This is important as it lets the individual using the utility know how
relevant a particular variable is.
2
Incremental_Running_Total
Indicates if a particular concept is documented as a running total or if each record is a separate measurement
 True = 100 mL, 200 mL, 300 mL -> 300 mL total was documented
 False = 100 mL, 200 mL, 300 mL -> 600 mL total was documented
Source_Table
The table from which this variable originated from. This can be useful for telling the mapping user the context of a
particular variable.
Active_From
The starting date for when this description was valid for this identifier. This is useful only if your institution reuses
variable identifiers. If not, please insert a dummy value such as “Jan 1, 1900”. This was made part of the primary
key as medication definitions can change more often than other variable types.
Active_To
The ending date for when this description was valid for this identifier. This is useful only if your institution reuses
variable identifiers. If not, please insert a dummy value such as “Jan 1, 2100”. This was made part of the primary
key as medication definitions can change more often than other variable types.
MPOG_Concept_id
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
3
Configuration_IntraopNoteDetails
Please read the documentation for Configuration_IntraopNotes first as this table is dependent on it. Furthermore,
AIMS_IntraopNoteDetails is an optional table and therefore this mapping table may not be used. Also be aware
that if variables are shared between parent and child notes i.e. there is only one set of concepts, only
Configuration_IntraopNotes should be used.
Associated Columns in Main Database
AIMS_IntraopNoteDetails
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Component_Concept_ID
MPOG_Component_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
Exclude_From_Extract
Whether or not to exclude this variable from being extracted into MPOG
This commonly is applied to variables considered sensitive and should not be imported into MPOG
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
4
Configuration_IntraopNotes
This table stores variable mappings used in intraoperative notes, which is essentially a catch-all for any
intraoperative documentation that does fit into the other categories.
Associated Columns in Main Database
AIMS_IntraopNotes
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Note_Concept_ID
MPOG_Note_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Concept_Type
Can be used to group variables together. If not applicable, leave NULL.
AIMS_Concept_Additional_Info
Any additional information can be placed into this field.
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Source_Table
The table from which this variable originated from.
This can be useful for telling the mapping user the context of a particular variable.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
Exclude_From_Extract
Whether or not to exclude this variable from being extracted into MPOG
This commonly is applied to variables considered sensitive and should not be imported into MPOG
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
5
Configuration_LaboratoryFlags
This table is a legacy component and can be ignored.
6
Configuration_LaboratoryVariables
Associated Columns in Main Database
AIMS_LabValues
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Lab_Concept_ID
MPOG_Lab_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Source_Table
The table from which this variable originated from.
This can be useful for telling the mapping user the context of a particular variable.
Source_Form
If applicable, the form in the AIMS on which the variable is found.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900”
This was made part of the primary key as lab definitions can change more often than other variable types.
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100”
This was made part of the primary key as lab definitions can change more often than other variable types.
Exclude_From_Extract
Whether or not to exclude this variable from being extracted into MPOG
This commonly is applied to variables considered sensitive and should not be imported into MPOG
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
7
Configuration_MedicationUnits
This table stores variable mappings relevant to units of measure such as milliliters and kilograms.
Associated Columns in Main Database
AIMS_IntraopInputOutputs
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_IO_UOM
MPOG_UOM_Concept_ID
AIMS_IntraopMedications
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Med_UOM
MPOG_UOM_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Unit_Of_Measure_Detail
Any additional information about the unit of measure
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
8
Configuration_Outcomes
Associated Columns in Main Database
AIMS_Outcomes
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Outcome_Concept_ID
MPOG_Outcomes_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
Source_Form
If applicable, the form in the AIMS on which the variable is found.
Source_Table
The table from which this variable originated from.
This can be useful for telling the mapping user the context of a particular variable.
Centricity_Case_Linked
A Centricity specific option for stating the outcome variable is linked to an operation or not.
Postoperative_Days_Limit
The maximum number of days after an operation to look for this variable. This is useful for when outcome data is
linked to patients and not operations.
Centricity_Observation_Date_Var_Type_Sys
Centricity specific column, please ignore.
AIMS_Detail_Concept_ID
Used in the event an outcome is in a well-structured hierarchy e.g. an outcome note has a parent row and multiple
children in the source database, this can be used to store the identifier of the child’s variable identifier. If not
applicable, insert “N/A”.
AIMS_Detail_Concept_Desc
The readable description for the identifier in AIMS_Detail_Concept_ID.
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
Exclude_From_Extract
Whether or not to exclude this variable from being extracted into MPOG
This commonly is applied to variables considered sensitive and should not be imported into MPOG
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
9
10
Configuration_PhysiologicVariableTranslation
Associated Columns in Main Database
AIMS_IntraopPhysiologic
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Physiologic_Concept_ID
MPOG_Physiologic_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Source_Table
The table from which this variable originated from.
This can be useful for telling the mapping user the context of a particular variable.
Manual_Entry_CD
Whether this variable is meant to be manually entered by the provider or captured by a monitor.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
11
Configuration_PreoperativeConcepts
Associated Columns in Main Database
AIMS_Preop
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Preop_Concept_ID
MPOG_Preop_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Source_Form
If applicable, the form in the AIMS on which the variable is found.
Source_Table
The table from which this variable originated from.
This can be useful for telling the mapping user the context of a particular variable.
Centricity_Case_Linked
A Centricity specific option for stating the outcome variable is lined to an operation or not.
Preoperative_Days_Limit
The maximum number of days before an operation to look for this variable. This is useful for when preop data is
linked to patients and not operations.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
Exclude_From_Extract
Whether or not to exclude this variable from being extracted into MPOG
This commonly is applied to variables considered sensitive and should not be imported into MPOG
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
12
13
Configuration_ProcedureNotes
This table is a component specific to the Centricity AIMS only. Please ignore.
14
Configuration_ProcedureRoomTypes
This table stores the mappings for the types of operating rooms used at your institution.
Associated Columns in Main Database
AIMS_IntraopCaseInfo
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Procedure_Room_Name
MPOG_Procedure_Room_Type_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable.
Procedure rooms are typically not classified by type in an AIMS, so this is often the room’s identifier or name.
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
15
Configuration_ProcedureServices
This table stores the mappings for cases’ primary service, such as cardiac, general, and orthopedics.
Associated Columns in Main Database
AIMS_IntraopCaseInfo
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Primary_Procedural_Service
MPOG_Primary_Procedural_Service_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
16
Configuration_Races
This table stores the mappings for patient race.
Associated Columns in Main Database
AIMS_Patients
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Race_Text
MPOG_Race_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
Race is often stored directly as a string in most AIMS. If this is the case, duplicate the string for both ID and
description.
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
17
Configuration_Routes
This table is used to store the types of routes used for medications and fluids such as IV and epidural.
Associated Columns in Main Database
AIMS_IntraopInputOutputs
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_IO_Route
MPOG_Route_Concept_ID
AIMS_IntraopMedications
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Med_Route
MPOG_Route_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Route_Detail
Any additional information about the route can be placed in this field
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
18
Configuration_Sites
This table stores the mappings for access sites. This table is unique among the mapping tables as it maps to MPOG
concepts of different types. The concept type determines how the concept can be mapped, so this will need to be
inserted prior to using the utility.
It is not uncommon for the same variable to be mapped multiple times. For example, “Left Hand IV” would need to
be mapped for side, location, and type (MPOG concept IDs 13, 15, and 16). In these cases, the same AIMS variable
would have multiple rows with different concept types.
Associated Columns in Main Database
AIMS_Sites
MPOG_Concept_Type_ID = 13
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Site_Location_CD
MPOG_Site_Location_ID
MPOG_Concept_Type_ID = 14
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Site_Size_CD
MPOG_Site_Size_ID
MPOG_Concept_Type_ID = 15
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Site_Type_CD
MPOG_Site_Type_ID
MPOG_Concept_Type_ID = 16
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Site_Side_CD
MPOG_Site_Side_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
MPOG_Concept_Type_ID
Used to differentiate the attributes of an access site.
 13
Access Location
 14
Access Size
 15
Access Type
 16
Access Side
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
AIMS_Detail_Concept_ID
19
Used in the event a site is in a well-structured hierarchy e.g. a site has a parent row and multiple children in the
source database, this can be used to store the identifier of the child’s variable identifier. If not applicable, insert
“N/A”.
AIMS_Detail_Concept_Desc
The readable description for the identifier in AIMS_Detail_Concept_ID.
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
20
Configuration_Staff
This table stores the mappings for staff roles such as anesthesia attending, anesthesia resident, CRNA, or surgery
attending.
Associated Columns in Main Database
AIMS_IntraopStaff
Column for Original Identifier:
Column for Mapped Identifier:
AIMS_Staff_Role
MPOG_Staff_Role_Concept_ID
Columns
AIMS_Concept_ID
Internal identifier for the variable
AIMS_Concept_Desc
Readable description for the variable
AIMS_Usage
How often this variable is found in the database. This can be either a row count or a case count.
AIMS_Seniority_Level
Applicable only to residents. Useful for differing the years of each resident (years 1 – 3)
If not applicable, use the value “N/A”
Active_From
The starting date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
1900” or null
Active_To
The ending date for when this description was valid for this identifier.
This is useful only if your institution reuses variable identifiers. If not, please insert a dummy value such as “Jan 1,
2100” or null
MPOG_Concept_ID
The equivalent MPOG concept identifier for this variable. Use the value 0 for this field when inserting new rows.
21
Misc. Tables
Config_Extraction_History
This table contains a log of all extraction execution. MPOG supplies procedures to interact with this table.
To illustrate, let’s say the extract notes for cases that occurred between Jan 1 and Jan 5, 2010 was executed
starting at Dec 25, 2013 12:00AM and finished at 12:10AM. The corresponding record in this table would have the
values given as examples for each column.
Columns
Extraction_Start_Time
When the module started execution
Value for above scenario: Dec 25, 2013 12:00AM
Extraction_End_Time
When the module finished execution
Value for above scenario: Dec 25, 2013 12:10AM
Extraction_Module
The module being reference in this record e.g. physiologic, labs, notes, etc.
Value for above scenario: Notes
Extraction_Range_Start
The start of the date range that is being extracted for this module
Value for above scenario: Jan 1, 2010
Extraction_Range_End
The end of the date range that is being extracted for this module
Value for above scenario: Jan 5, 2010
Had_Error
The SQL error code encountered during execution. If none, this field is null.
Config_Extraction_Preferences
This table contains various settings and preferences for the extracts. A common value used in this table is the date
to start extraction from.
Columns
MPOG_Concept_ID
The MPOG concept for this value. All preference concepts are found under MPOG Concept Type ID 18.
Preference_Value
The value of this setting. This column’s data type is varchar to support any type of value.
Config_PatientsTest
22
This table can be used to store all patients considered as test records and therefore should be excluded from the
extract. This table provides two ways of recording the patient identifiers to exclude, reg_num (or MRN) or
patient_sys (or the internal patient identifier in the AIMS). Either or both can be used, whatever makes it easiest
for your institution.
Columns
reg_num
Reg number or MRN of the patient to be excluded
patient_sys
Internal patient identifier of the patient to be excluded
23
Additional Tables
If you find that the above tables do not fully support the needs of your institution’s MPOG extract, you are free to
create your own tables in the config database. If you choose to do so however, it is strongly encouraged that any
tables you add are used to supplement the existing ones rather than replace them.
24
Download