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à.
# Esportazione di dati FHIR con AWS HealthLake
Utilizza AWS HealthLake le azioni native per avviare, descrivere ed elencare i lavori di esportazione FHIR. È possibile mettere in coda i lavori di esportazione. I lavori di esportazione asincroni vengono elaborati in modo FIFO (First In First Out). È possibile mettere in coda i lavori nello stesso modo in cui si iniziano i lavori di esportazione. Se ne è in corso uno, si metterà semplicemente in coda. È possibile creare, leggere, aggiornare o eliminare risorse FHIR mentre è in corso un processo di esportazione.
**Nota**
È inoltre possibile esportare i dati FHIR da un archivio HealthLake dati utilizzando l'operazione FHIR R4. `$export` Per ulteriori informazioni, consulta [Esportazione di HealthLake dati con FHIR `$export`](reference-fhir-operations-export.md).
**Topics**
+ [Avvio di un lavoro di esportazione](exporting-fhir-data-start.md)
+ [Ottenere proprietà lavorative destinate all'esportazione](exporting-fhir-data-describe.md)
+ [Elenco dei lavori di esportazione](exporting-fhir-data-list.md)
# Avvio di un lavoro di esportazione FHIR
Utilizzato `StartFHIRExportJob` per avviare un processo di esportazione FHIR da un archivio HealthLake dati. I seguenti menu forniscono una procedura per Console di gestione AWS e alcuni esempi di codice per and. AWS CLI AWS SDKs Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_StartFHIRExportJob.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_StartFHIRExportJob.html) nella *documentazione di riferimento dell’API AWS HealthLake *.
**Nota**
HealthLake supporta la [specifica FHIR R4](https://hl7.org/fhir/R4/index.html) per lo scambio di dati sanitari. Pertanto, tutti i dati sanitari vengono esportati in formato FHIR R4.
**Come avviare un processo di esportazione FHIR**
Scegli un menu in base alle tue preferenze di accesso a. AWS HealthLake
## AWS CLI e SDKs
------
#### [ CLI ]
**AWS CLI**
**Come avviare un processo di esportazione FHIR**
L'`start-fhir-export-job`esempio seguente mostra come avviare un processo di esportazione FHIR utilizzando AWS HealthLake.
```
aws healthlake start-fhir-export-job \
--output-data-config '{"S3Configuration": {"S3Uri":"s3://(Bucket Name)/(Prefix Name)/","KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"}}' \
--datastore-id (Data store ID) \
--data-access-role-arn arn:aws:iam::(AWS Account ID):role/(Role Name)
```
Output:
```
{
"DatastoreId": "(Data store ID)",
"JobStatus": "SUBMITTED",
"JobId": "9b9a51943afaedd0a8c0c26c49135a31"
}
```
*Per ulteriori informazioni, consulta [Esportazione di file da un data store FHIR](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) nella Guida per gli AWS HealthLake sviluppatori.*
+ Per i dettagli sull'API, consulta [Start FHIRExport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/start-fhir-export-job.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 start_fhir_export_job(
self,
job_name: str,
datastore_id: str,
output_s3_uri: str,
kms_key_id: str,
data_access_role_arn: str,
) -> dict[str, str]:
"""
Starts a HealthLake export job.
:param job_name: The export job name.
:param datastore_id: The data store ID.
:param output_s3_uri: The output S3 URI.
:param kms_key_id: The KMS key ID associated with the output S3 bucket.
:param data_access_role_arn: The data access role ARN.
:return: The export job.
"""
try:
response = self.health_lake_client.start_fhir_export_job(
OutputDataConfig={
"S3Configuration": {"S3Uri": output_s3_uri, "KmsKeyId": kms_key_id}
},
DataAccessRoleArn=data_access_role_arn,
DatastoreId=datastore_id,
JobName=job_name,
)
return response
except ClientError as err:
logger.exception(
"Couldn't start export job. Here's why %s",
err.response["Error"]["Message"],
)
raise
```
+ Per i dettagli sull'API, consulta [Start FHIRExport Job](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/StartFHIRExportJob) in *AWS SDK for Python (Boto3) API Reference*.
C'è altro 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_job_name = 'MyExportJob'
" iv_output_s3_uri = 's3://my-bucket/export/output/'
" iv_kms_key_id = 'arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012'
" iv_data_access_role_arn = 'arn:aws:iam::123456789012:role/HealthLakeExportRole'
oo_result = lo_hll->startfhirexportjob(
iv_jobname = iv_job_name
io_outputdataconfig = NEW /aws1/cl_hlloutputdataconfig(
io_s3configuration = NEW /aws1/cl_hlls3configuration(
iv_s3uri = iv_output_s3_uri
iv_kmskeyid = iv_kms_key_id
)
)
iv_dataaccessrolearn = iv_data_access_role_arn
iv_datastoreid = iv_datastore_id
).
DATA(lv_job_id) = oo_result->get_jobid( ).
MESSAGE |Export job started with ID { lv_job_id }.| 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_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.
CATCH /aws1/cx_hllaccessdeniedex INTO DATA(lo_access_ex).
lv_error = |Access denied: { lo_access_ex->av_err_code }-{ lo_access_ex->av_err_msg }|.
MESSAGE lv_error TYPE 'I'.
RAISE EXCEPTION lo_access_ex.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [Start FHIRExport Job](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
1. Accedi alla pagina degli [archivi dati](https://console.aws.amazon.com/healthlake/home#/list-datastores) sulla HealthLake console.
1. Scegli un data store.
1. Scegli **Export** (Esporta).
Viene visualizzata la pagina **Esporta**.
1. Nella sezione **Dati di output**, inserisci le seguenti informazioni:
+ **Posizione dei dati di output in Amazon S3**
+ **Crittografia dell'output**
1. Nella sezione **Autorizzazioni di accesso**, scegli **Usa un ruolo di servizio IAM esistente** e seleziona il ruolo dal menu **Nome ruolo** o scegli **Crea** un ruolo IAM.
1. Seleziona **Esporta dati**.
**Nota**
Durante l'esportazione, scegli **Copia l'ID del lavoro** sul banner nella parte superiore della pagina. Puoi utilizzare il [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html#HealthLake-DescribeFHIRExportJob-request-JobId](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html#HealthLake-DescribeFHIRExportJob-request-JobId)per richiedere le proprietà del lavoro di esportazione utilizzando AWS CLI. Per ulteriori informazioni, consulta [Far esportare proprietà lavorative dalla FHIR](exporting-fhir-data-describe.md).
# Far esportare proprietà lavorative dalla FHIR
`DescribeFHIRExportJob`Utilizzatelo per esportare le proprietà del lavoro da un archivio HealthLake dati. I seguenti menu forniscono una procedura per Console di gestione AWS e alcuni esempi di codice per AWS CLI and AWS SDKs. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html) nella *documentazione di riferimento dell’API AWS HealthLake *.
**Nota**
HealthLake supporta la [specifica FHIR R4](https://hl7.org/fhir/R4/index.html) per lo scambio di dati sanitari. Pertanto, tutti i dati sanitari vengono esportati in formato FHIR R4.
**Come descrivere un processo di esportazione FHIR**
Scegli un menu in base alle tue preferenze di accesso a. AWS HealthLake
## AWS CLI e SDKs
------
#### [ CLI ]
**AWS CLI**
**Come descrivere un processo di esportazione FHIR**
L'`describe-fhir-export-job`esempio seguente mostra come trovare le proprietà di un processo di esportazione FHIR in AWS HealthLake.
```
aws healthlake describe-fhir-export-job \
--datastore-id (Data store ID) \
--job-id 9b9a51943afaedd0a8c0c26c49135a31
```
Output:
```
{
"ExportJobProperties": {
"DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
"JobStatus": "IN_PROGRESS",
"JobId": "9009813e9d69ba7cf79bcb3468780f16",
"SubmitTime": "2024-11-20T11:31:46.672000-05:00",
"EndTime": "2024-11-20T11:34:01.636000-05:00",
"OutputDataConfig": {
"S3Configuration": {
"S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
"KmsKeyId": "arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"
}
},
"DatastoreId": "(Data store ID)"
}
}
```
*Per ulteriori informazioni, consulta [Esportazione di file da un data store FHIR](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) nella Guida per gli AWS HealthLake sviluppatori.*
+ Per i dettagli sull'API, consulta [Descrivi FHIRExport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/describe-fhir-export-job.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 describe_fhir_export_job(
self, datastore_id: str, job_id: str
) -> dict[str, any]:
"""
Describes a HealthLake export job.
:param datastore_id: The data store ID.
:param job_id: The export job ID.
:return: The export job description.
"""
try:
response = self.health_lake_client.describe_fhir_export_job(
DatastoreId=datastore_id, JobId=job_id
)
return response["ExportJobProperties"]
except ClientError as err:
logger.exception(
"Couldn't describe export job with ID %s. Here's why %s",
job_id,
err.response["Error"]["Message"],
)
raise
```
+ Per i dettagli sull'API, consulta [Descrivi FHIRExport Job](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/DescribeFHIRExportJob) 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_id = 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6'
" iv_job_id = 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6'
oo_result = lo_hll->describefhirexportjob(
iv_datastoreid = iv_datastore_id
iv_jobid = iv_job_id
).
DATA(lo_export_job_properties) = oo_result->get_exportjobproperties( ).
IF lo_export_job_properties IS BOUND.
DATA(lv_job_status) = lo_export_job_properties->get_jobstatus( ).
MESSAGE |Export job status: { lv_job_status }.| TYPE 'I'.
ENDIF.
CATCH /aws1/cx_hllresourcenotfoundex INTO DATA(lo_notfound_ex).
DATA(lv_error) = |Resource not found: { lo_notfound_ex->av_err_code }-{ lo_notfound_ex->av_err_msg }|.
MESSAGE lv_error TYPE 'I'.
RAISE EXCEPTION lo_notfound_ex.
CATCH /aws1/cx_hllvalidationex INTO DATA(lo_validation_ex).
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.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [Descrivi FHIRExport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK per il riferimento all'API SAP ABAP*.
------
**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**
Le informazioni sul processo di esportazione FHIR non sono disponibili sulla HealthLake console. Utilizza invece AWS CLI with `DescribeFHIRExportJob` per richiedere proprietà del lavoro di esportazione come [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ExportJobProperties.html#HealthLake-Type-ExportJobProperties-JobStatus](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ExportJobProperties.html#HealthLake-Type-ExportJobProperties-JobStatus). Per ulteriori informazioni, consulta l' AWS CLI esempio in questa pagina.
# Elenco dei lavori di esportazione FHIR
`ListFHIRExportJobs`Da utilizzare per elencare i lavori di esportazione FHIR per un archivio HealthLake dati. I seguenti menu forniscono una procedura Console di gestione AWS e alcuni esempi di codice per and. AWS CLI AWS SDKs Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListFHIRExportJobs.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListFHIRExportJobs.html) nella *documentazione di riferimento dell’API AWS HealthLake *.
**Nota**
HealthLake supporta la [specifica FHIR R4](https://hl7.org/fhir/R4/index.html) per lo scambio di dati sanitari. Pertanto, tutti i dati sanitari vengono esportati in formato FHIR R4.
**Per elencare i lavori di esportazione FHIR**
Scegliete un menu in base alle vostre preferenze di accesso a AWS HealthLake.
## AWS CLI e SDKs
------
#### [ CLI ]
**AWS CLI**
**Come elencare tutti i processi di esportazione FHIR**
L’esempio `list-fhir-export-jobs` seguente mostra come utilizzare il comando per visualizzare un elenco di processi di esportazione associati a un account.
```
aws healthlake list-fhir-export-jobs \
--datastore-id (Data store ID) \
--submitted-before (DATE like 2024-10-13T19:00:00Z)\
--submitted-after (DATE like 2020-10-13T19:00:00Z )\
--job-name "FHIR-EXPORT" \
--job-status SUBMITTED \
--max-results (Integer between 1 and 500)
```
Output:
```
{
"ExportJobPropertiesList": [
{
"ExportJobProperties": {
"OutputDataConfig": {
"S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
"S3Configuration": {
"S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
"KmsKeyId": "(KmsKey Id)"
}
},
"DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
"JobStatus": "COMPLETED",
"JobId": "c145fbb27b192af392f8ce6e7838e34f",
"JobName": "FHIR-EXPORT",
"SubmitTime": "2024-11-20T11:31:46.672000-05:00",
"EndTime": "2024-11-20T11:34:01.636000-05:00",
"DatastoreId": "(Data store ID)"
}
}
]
}
```
Per ulteriori informazioni, consulta [Esportazione di file da un data store FHIR nella Guida](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) per gli AWS HealthLake sviluppatori.
+ Per i dettagli sull'API, consulta [List FHIRExport Jobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-fhir-export-jobs.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 list_fhir_export_jobs(
self,
datastore_id: str,
job_name: str = None,
job_status: str = None,
submitted_before: datetime = None,
submitted_after: datetime = None,
) -> list[dict[str, any]]:
"""
Lists HealthLake export jobs satisfying the conditions.
:param datastore_id: The data store ID.
:param job_name: The export job name.
:param job_status: The export job status.
:param submitted_before: The export job submitted before the specified date.
:param submitted_after: The export job submitted after the specified date.
:return: A list of export jobs.
"""
try:
parameters = {"DatastoreId": datastore_id}
if job_name is not None:
parameters["JobName"] = job_name
if job_status is not None:
parameters["JobStatus"] = job_status
if submitted_before is not None:
parameters["SubmittedBefore"] = submitted_before
if submitted_after is not None:
parameters["SubmittedAfter"] = submitted_after
next_token = None
jobs = []
# Loop through paginated results.
while True:
if next_token is not None:
parameters["NextToken"] = next_token
response = self.health_lake_client.list_fhir_export_jobs(**parameters)
jobs.extend(response["ExportJobPropertiesList"])
if "NextToken" in response:
next_token = response["NextToken"]
else:
break
return jobs
except ClientError as err:
logger.exception(
"Couldn't list export jobs. Here's why %s",
err.response["Error"]["Message"],
)
raise
```
+ Per i dettagli sull'API, consulta [List FHIRExport Jobs](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/ListFHIRExportJobs) 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_id = 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6'
IF iv_submitted_after IS NOT INITIAL.
oo_result = lo_hll->listfhirexportjobs(
iv_datastoreid = iv_datastore_id
iv_submittedafter = iv_submitted_after
).
ELSE.
oo_result = lo_hll->listfhirexportjobs(
iv_datastoreid = iv_datastore_id
).
ENDIF.
DATA(lt_export_jobs) = oo_result->get_exportjobpropertieslist( ).
DATA(lv_job_count) = lines( lt_export_jobs ).
MESSAGE |Found { lv_job_count } export job(s).| 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_hllresourcenotfoundex INTO DATA(lo_notfound_ex).
lv_error = |Resource not found: { lo_notfound_ex->av_err_code }-{ lo_notfound_ex->av_err_msg }|.
MESSAGE lv_error TYPE 'I'.
RAISE EXCEPTION lo_notfound_ex.
ENDTRY.
```
+ Per i dettagli sull'API, consulta il riferimento all'API [List FHIRExport Jobs](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP*.
------
**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**
Le informazioni sul processo di esportazione FHIR non sono disponibili sulla HealthLake console. Utilizza invece AWS CLI with `ListFHIRExportJobs` per elencare tutti i lavori di esportazione FHIR. Per ulteriori informazioni, fate riferimento all' AWS CLI esempio in questa pagina.