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](reference-healthlake-preloaded-data-types.md).
**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](getting-started-concepts.md#concept-data-store-authorization-strategy).
[Quando si crea un HealthLake data store, un archivio di dati FHIR viene reso disponibile tramite un RESTful endpoint API.](reference-healthlake-endpoints-quotas.md#reference-healthlake-endpoints) Dopo aver creato il tuo HealthLake data store, puoi richiederne la [dichiarazione di capacità](reference-fhir-capability-statement.md) per trovare tutte le funzionalità (comportamenti) associate al FHIR.
I menu seguenti forniscono esempi per AWS CLI AWS SDKs e una procedura per. Console di gestione AWS Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_CreateFHIRDatastore.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_CreateFHIRDatastore.html) 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.
## AWS CLI e SDKs
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: creare un data store abilitato per SIGV4 HealthLake **
L'`create-fhir-datastore`esempio 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-datastore`esempio 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](https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html) nella Developer Guide.AWS HealthLake *
+ Per i dettagli sull'API, consulta [Create FHIRDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/create-fhir-datastore.html) in *AWS CLI Command Reference.*
------
#### [ 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](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/CreateFHIRDatastore) in *AWS SDK for Python (Boto3) API Reference*.
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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
C'è altro da fare. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/hll#code-examples).
```
TRY.
" iv_datastore_name = 'MyHealthLakeDataStore'
oo_result = lo_hll->createfhirdatastore(
iv_datastorename = iv_datastore_name
iv_datastoretypeversion = 'R4'
).
MESSAGE 'Data store created successfully.' TYPE 'I'.
CATCH /aws1/cx_hllvalidationex INTO DATA(lo_validation_ex).
DATA(lv_error) = |Validation error: { lo_validation_ex->av_err_code }-{ lo_validation_ex->av_err_msg }|.
MESSAGE lv_error TYPE 'I'.
RAISE EXCEPTION lo_validation_ex.
CATCH /aws1/cx_hllinternalserverex INTO DATA(lo_internal_ex).
lv_error = |Internal server error: { lo_internal_ex->av_err_code }-{ lo_internal_ex->av_err_msg }|.
MESSAGE lv_error TYPE 'I'.
RAISE EXCEPTION lo_internal_ex.
CATCH /aws1/cx_hllthrottlingex INTO DATA(lo_throttling_ex).
lv_error = |Throttling error: { lo_throttling_ex->av_err_code }-{ lo_throttling_ex->av_err_msg }|.
MESSAGE lv_error TYPE 'I'.
RAISE EXCEPTION lo_throttling_ex.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [Create FHIRDatastore](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP* API reference.
------
**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.
## AWS Console
**Nota**
La procedura seguente crea un archivio HealthLake dati con autorizzazione [AWS SigV4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). 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](https://console.aws.amazon.com/healthlake/home#/create-datastore) sulla HealthLake console.
1. Scegli **Crea Data Store**.
1. Nella sezione **Impostazioni Data Store**, per **Nome Data Store**, specifica un nome.
1. (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](reference-healthlake-preloaded-data-types.md).
1. Nella sezione **Crittografia del Data Store**, scegli **Usa la chiave di proprietà di AWS (impostazione predefinita)** o **Scegli una chiave AWS KMS diversa (avanzata**).
1. Nella sezione **Tag - *opzionale***, puoi aggiungere tag al tuo data store. Per ulteriori informazioni sull'etichettatura del data store, consulta[Etichettatura degli HealthLake archivi dati](managing-data-stores-tagging.md).
1. Scegli **Crea Data Store**.
Lo stato del tuo data store è disponibile nella pagina **Data stores**.