Creating a data store in AWS HealthLake
After you complete Setting up permissions to start using AWS HealthLake, you are ready to create a data store. In AWS HealthLake, you use a data store to store data in HL7 FHIR (R4) format. The topics in this chapter describe how to create a data store.
To both create analytics enabled data stores and
to grant access to them in Athena, add the AWSLakeFormationDataAdmin
managed policy to your IAM user,
group or role. The AWSLakeFormationDataAdmin
policy allows you to create data lake administrators and to
grant access to data stores in Athena. For information
about setting permissions, see Setting up permissions to start using AWS HealthLake.
HealthLake is also integrated with AWS CloudTrail. You can use CloudTrail to provide a record of actions taken by a user, role, or an AWS service in HealthLake. CloudTrail captures all API calls and console actions for HealthLake as events. To learn more, see Logging AWS HealthLake API Calls with AWS CloudTrail.
To learn more about the Fast Healthcare Interoperability Resources (FHIR) resource types that are supported by HealthLake, see Supported FHIR resource types in AWS HealthLake.
Amazon Athena compatibility
HealthLake date stores created prior to November, 14, 2022 cannot perform SQL queries using Athena. To use Athena search capabilities on your preexisting data store, first migrate the data to a new data store. To learn more about migrating preexisting data stores, see Migrating an existing data store to use Amazon Athena.
After you create a data store, you can get its properties, including its status, with the API_DescribeFHIRDatastore or API_ListFHIRDatastores.html API operations. Or you can find data store statuses and other details on the Data stores page in the HealthLake console.
A HealthLake data store can have the following statuses:
-
Creating – Your data store is being created.
-
Active – Your data store is active. You can import and export data from it. You can also manage and search the FHIR resources you have stored in the data store.
-
Deleting – Your data store is being deleted.
-
Deleted – Your data store has been deleted.
Creating a data store (AWS Management Console)
HealthLake console differences
The HealthLake console does not support creating a SMART on FHIR enabled data store. To create a SMART on FHIR enabled data store, you must use the AWS CLI or one of the AWS supported SDKS. To learn more, see Integrating SMART on FHIR with AWS HealthLake. Also, the console does not differentiate between the two types of data stores supported by HealthLake when you view an individual data store's details page.
To create a HealthLake data store
-
Open the HealthLake console at https://console.aws.amazon.com//healthlake/home
. -
Open the Navigation pane (≡).
-
Then, choose Data Stores.
-
Next, choose Create Data Store.
-
In the Data Store settings section, for Data Store name specify a name.
-
(Optional) In the Data Store settings section, for Preload sample data select the check box to preload Synthea data.
-
Synthea data is a preloaded sample dataset. For more information, see Preloaded data types.
-
-
In the Data Store encryption section, choose either Use AWS owned key (default) or Choose a different AWS KMS key (advanced).
-
In the Tags - optional section, you can add tags to your data store.
-
To learn more about tagging your data store, see Adding a tag to a data store.
-
-
Next, choose Create Data Store. The status of your data stores are available on the Data stores page.
Creating a data store (AWS CLI and AWS SDKs)
You can use the following code examples to create a HealthLake data store.