Creazione di un archivio HealthLake dati - AWS HealthLake

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di un archivio HealthLake dati

Utilizzato CreateFHIRDatastore per creare un AWS HealthLake data store conforme alla specifica FHIR R4. HealthLake gli archivi dati vengono utilizzati per importare, gestire, cercare ed esportare dati FHIR. Puoi scegliere di importare (precaricare) i dati sanitari FHIR R4 open source di Synthea nel tuo archivio dati al momento della creazione. Per ulteriori informazioni, consulta Tipi di dati precaricati.

Importante

HealthLake supporta due tipi di strategie di autorizzazione dell'archivio dati FHIR, AWS SigV4 o SMART su FHIR. È necessario scegliere una delle strategie di autorizzazione prima di creare un HealthLake archivio dati FHIR. Per ulteriori informazioni, consulta Strategia di autorizzazione all'archiviazione dei dati.

Quando si crea un HealthLake data store, un archivio di dati FHIR viene reso disponibile tramite un RESTful endpoint API. Dopo aver creato il tuo HealthLake data store, puoi richiederne la dichiarazione di capacità per trovare tutte le funzionalità (comportamenti) associate al FHIR.

I menu seguenti forniscono esempi per AWS CLI AWS SDKs e una procedura per. AWS Management Console Per ulteriori informazioni, consulta CreateFHIRDatastore nella documentazione di riferimento dell'API AWS HealthLake .

Per creare un archivio HealthLake dati

Scegli un menu in base alle tue preferenze di accesso a AWS HealthLake.

CLI
AWS CLI

Esempio 1: creazione di un data store abilitato per SIGV4 HealthLake

L'create-fhir-datastoreesempio seguente mostra come creare un nuovo archivio dati in. AWS HealthLake

aws healthlake create-fhir-datastore \
    --datastore-type-version R4 \
    --datastore-name "FhirTestDatastore"

Output:

{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)",
    "DatastoreStatus": "CREATING",
    "DatastoreId": "(Data store ID)"
}

Esempio 2: creare uno SMART su un data store abilitato per FHIR HealthLake

L'create-fhir-datastoreesempio seguente mostra come creare un nuovo SMART su un data store abilitato per FHIR in. AWS HealthLake

aws healthlake create-fhir-datastore \
    --datastore-name "your-data-store-name" \
    --datastore-type-version R4 \
    --preload-data-config PreloadDataType="SYNTHEA" \
    --sse-configuration '{ "KmsEncryptionConfig": {  "CmkType": "CUSTOMER_MANAGED_KMS_KEY", "KmsKeyId": "arn:aws:kms:us-east-1:your-account-id:key/your-key-id" } }' \
    --identity-provider-configuration  file://identity_provider_configuration.json

Contenuto di identity_provider_configuration.json.

{
    "AuthorizationStrategy": "SMART_ON_FHIR_V1",
    "FineGrainedAuthorizationEnabled": true,
    "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
    "Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\"]}"
}

Output:

{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)",
    "DatastoreStatus": "CREATING",
    "DatastoreId": "(Data store ID)"
}

Per ulteriori informazioni, consulta Creazione e monitoraggio di un data store FHIR nella Developer Guide.AWS HealthLake

Python
SDK per Python (Boto3)
    @classmethod
    def from_client(cls) -> "HealthLakeWrapper":
        """
        Creates a HealthLakeWrapper instance with a default AWS HealthLake client.

        :return: An instance of HealthLakeWrapper initialized with the default HealthLake client.
        """
        health_lake_client = boto3.client("healthlake")
        return cls(health_lake_client)


    def create_fhir_datastore(
        self,
        datastore_name: str,
        sse_configuration: dict[str, any] = None,
        identity_provider_configuration: dict[str, any] = None,
    ) -> dict[str, str]:
        """
        Creates a new HealthLake data store.
        When creating a SMART on FHIR data store, the following parameters are required:
        - sse_configuration: The server-side encryption configuration for a SMART on FHIR-enabled data store.
        - identity_provider_configuration: The identity provider configuration for a SMART on FHIR-enabled data store.

        :param datastore_name: The name of the data store.
        :param sse_configuration: The server-side encryption configuration for a SMART on FHIR-enabled data store.
        :param identity_provider_configuration: The identity provider configuration for a SMART on FHIR-enabled data store.
        :return: A dictionary containing the data store information.
        """
        try:
            parameters = {"DatastoreName": datastore_name, "DatastoreTypeVersion": "R4"}
            if (
                sse_configuration is not None
                and identity_provider_configuration is not None
            ):
                # Creating a SMART on FHIR-enabled data store
                parameters["SseConfiguration"] = sse_configuration
                parameters[
                    "IdentityProviderConfiguration"
                ] = identity_provider_configuration

            response = self.health_lake_client.create_fhir_datastore(**parameters)
            return response
        except ClientError as err:
            logger.exception(
                "Couldn't create data store %s. Here's why %s",
                datastore_name,
                err.response["Error"]["Message"],
            )
            raise

Il codice seguente mostra un esempio di parametri per un archivio dati SMART su FHIR. HealthLake 

            sse_configuration = {
                "KmsEncryptionConfig": {"CmkType": "AWS_OWNED_KMS_KEY"}
            }
            # TODO: Update the metadata to match your environment.
            metadata = {
                "issuer": "https://ehr.example.com",
                "jwks_uri": "https://ehr.example.com/.well-known/jwks.json",
                "authorization_endpoint": "https://ehr.example.com/auth/authorize",
                "token_endpoint": "https://ehr.token.com/auth/token",
                "token_endpoint_auth_methods_supported": [
                    "client_secret_basic",
                    "foo",
                ],
                "grant_types_supported": ["client_credential", "foo"],
                "registration_endpoint": "https://ehr.example.com/auth/register",
                "scopes_supported": ["openId", "profile", "launch"],
                "response_types_supported": ["code"],
                "management_endpoint": "https://ehr.example.com/user/manage",
                "introspection_endpoint": "https://ehr.example.com/user/introspect",
                "revocation_endpoint": "https://ehr.example.com/user/revoke",
                "code_challenge_methods_supported": ["S256"],
                "capabilities": [
                    "launch-ehr",
                    "sso-openid-connect",
                    "client-public",
                ],
            }
            # TODO: Update the IdpLambdaArn.
            identity_provider_configuration = {
                "AuthorizationStrategy": "SMART_ON_FHIR_V1",
                "FineGrainedAuthorizationEnabled": True,
                "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
                "Metadata": json.dumps(metadata),
            }
            data_store = self.create_fhir_datastore(
                datastore_name, sse_configuration, identity_provider_configuration
            )

  • Per i dettagli sull'API, consulta Create FHIRDatastore in AWS SDK for Python (Boto3) API Reference.

Nota

C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel Repository di esempi di codice AWS.

Esempio di disponibilità

Non riesci a trovare quello che ti serve? Richiedi un esempio di codice utilizzando il link Fornisci feedback nella barra laterale destra di questa pagina.

Nota

La procedura seguente crea un archivio HealthLake dati con autorizzazione AWS SigV4. La HealthLake console non supporta la creazione di un archivio dati SMART su FHIR.

Per creare un archivio HealthLake dati con autorizzazione AWS SIGv4

  1. Accedi alla pagina Crea archivio dati sulla HealthLake console.

  2. Scegli Crea Data Store.

  3. Nella sezione Impostazioni Data Store, per Nome Data Store, specifica un nome.

  4. (Facoltativo) Nella sezione Impostazioni Data Store, per Precarica dati di esempio, seleziona la casella di controllo per precaricare i dati Synthea. I dati Synthea sono un set di dati di esempio open source. Per ulteriori informazioni, consulta Tipi di dati precaricati Synthea per HealthLake.

  5. Nella sezione Crittografia del Data Store, scegli Usa la chiave di proprietà di AWS (impostazione predefinita) o Scegli una chiave AWS KMS diversa (avanzata).

  6. Nella sezione Tag - opzionale, puoi aggiungere tag al tuo data store. Per ulteriori informazioni sull'etichettatura del data store, consultaEtichettatura degli HealthLake archivi dati.

  7. Scegli Crea Data Store.

    Lo stato del tuo data store è disponibile nella pagina Data stores.