Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Exportación de datos del FHIR con AWS HealthLake
Utilice AWS HealthLake acciones nativas para iniciar, describir y enumerar los trabajos de exportación del FHIR. Puede poner en cola los trabajos de exportación. Los trabajos de exportación asíncronos se procesan de forma FIFO (primero en entrar, primero en salir). Puede poner los trabajos en cola de la misma manera que se inician los trabajos de exportación. Si hay alguno en curso, simplemente se pondrá en cola. Puede crear, leer, actualizar o eliminar los recursos del FHIR mientras se está realizando un trabajo de exportación.
**nota**
También puede exportar los datos del FHIR desde un banco de HealthLake datos mediante la operación FHIR R4. `$export` Para obtener más información, consulte [Exportación HealthLake de datos con FHIR `$export`](reference-fhir-operations-export.md).
**Topics**
+ [Empezar un trabajo de exportación](exporting-fhir-data-start.md)
+ [Conseguir propiedades de trabajo de exportación](exporting-fhir-data-describe.md)
+ [Listado de trabajos de exportación](exporting-fhir-data-list.md)
# Inicio de un trabajo de exportación del FHIR
Se utiliza `StartFHIRExportJob` para iniciar un trabajo de exportación del FHIR desde un almacén de HealthLake datos. Los siguientes menús proporcionan un procedimiento Consola de administración de AWS y ejemplos de código para AWS CLI y AWS SDKs. Para obtener más información, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_StartFHIRExportJob.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_StartFHIRExportJob.html) en la *AWS HealthLake Referencia de la API de *.
**Nota**
HealthLake es compatible con la [especificación R4 del FHIR](https://hl7.org/fhir/R4/index.html) para el intercambio de datos de atención médica. Por lo tanto, todos los datos de salud se exportan en formato FHIR R4.
**Para iniciar un trabajo de exportación de FHIR**
Elija un menú en función de sus preferencias de acceso a. AWS HealthLake
## AWS CLI y SDKs
------
#### [ CLI ]
**AWS CLI**
**Para iniciar un trabajo de exportación de FHIR**
El siguiente `start-fhir-export-job` ejemplo muestra cómo iniciar un trabajo de exportación del FHIR utilizando 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)
```
Salida:
```
{
"DatastoreId": "(Data store ID)",
"JobStatus": "SUBMITTED",
"JobId": "9b9a51943afaedd0a8c0c26c49135a31"
}
```
Para obtener más información, consulte [Exportación de archivos desde un banco de datos del FHIR en la Guía para AWS](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) *HealthLake desarrolladores*.
+ Para obtener información sobre la API, consulte [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 para 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
```
+ Para obtener más información sobre la API, consulta la referencia de la API [Start FHIRExport Job](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/StartFHIRExportJob) in *AWS SDK for Python (Boto3*).
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [Start FHIRExport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK para obtener una referencia sobre la API ABAP de SAP*.
------
**Ejemplo de disponibilidad**
¿No encuentra lo que necesita? Solicita un ejemplo de código mediante el enlace **Enviar comentarios** que aparece en la barra lateral derecha de esta página.
## AWS Consola
1. Inicie sesión en la página [de almacenes de datos](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake consola.
1. Elija un almacén de datos.
1. Seleccione **Exportar**.
Se abre la página de **exportación**.
1. En la sección **Datos de salida**, introduce la siguiente información:
+ **Ubicación de los datos de salida en Amazon S3**
+ **Cifrado de salida**
1. En la sección **Permisos de acceso**, elija **Usar un rol de servicio de IAM existente y seleccione el rol** en el menú **Nombre del rol** o elija **Crear** un rol de IAM.
1. Elija **Exportar datos**.
**nota**
Durante la exportación, seleccione **Copiar el identificador del trabajo** en el banner de la parte superior de la página. Puede utilizar el [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)para solicitar la exportación de las propiedades del trabajo mediante el AWS CLI. Para obtener más información, consulte [Conseguir que el FHIR exporte propiedades laborales](exporting-fhir-data-describe.md).
# Conseguir que el FHIR exporte propiedades laborales
Se utiliza `DescribeFHIRExportJob` para obtener las propiedades de los trabajos de exportación desde un banco de HealthLake datos. Los siguientes menús proporcionan un procedimiento Consola de administración de AWS y ejemplos de código para AWS CLI y AWS SDKs. Para obtener más información, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html) en la *AWS HealthLake Referencia de la API de *.
**Nota**
HealthLake es compatible con la [especificación R4 del FHIR](https://hl7.org/fhir/R4/index.html) para el intercambio de datos de atención médica. Por lo tanto, todos los datos de salud se exportan en formato FHIR R4.
**Para describir un trabajo de exportación de FHIR**
Elija un menú en función de sus preferencias de acceso a. AWS HealthLake
## AWS CLI y SDKs
------
#### [ CLI ]
**AWS CLI**
**Para describir un trabajo de exportación de FHIR**
El siguiente `describe-fhir-export-job` ejemplo muestra cómo encontrar las propiedades de un trabajo de exportación FHIR en AWS HealthLake.
```
aws healthlake describe-fhir-export-job \
--datastore-id (Data store ID) \
--job-id 9b9a51943afaedd0a8c0c26c49135a31
```
Salida:
```
{
"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)"
}
}
```
Para obtener más información, consulte [Exportación de archivos desde un banco de datos del FHIR en la Guía para AWS](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) *HealthLake desarrolladores*.
+ Para obtener más información sobre la API, consulte [Describe FHIRExport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/describe-fhir-export-job.html) in *AWS CLI Command Reference*.
------
#### [ Python ]
**SDK para 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
```
+ Para obtener más información sobre la API, consulta [Describe FHIRExport Job](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/DescribeFHIRExportJob) in *AWS SDK for Python (Boto3) API Reference*.
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [Describe FHIRExport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) en el *AWS SDK para la referencia de la API ABAP de SAP*.
------
**Ejemplo de disponibilidad**
¿No encuentra lo que necesita? Solicita un ejemplo de código mediante el **enlace Enviar comentarios** en la barra lateral derecha de esta página.
## AWS Consola
**nota**
La información sobre los trabajos de exportación del FHIR no está disponible en la HealthLake consola. En su lugar, utilice el comando AWS CLI with `DescribeFHIRExportJob` para solicitar la exportación de propiedades del trabajo, como [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). Para obtener más información, consulta el AWS CLI ejemplo de esta página.
# Listado de trabajos de exportación del FHIR
Se usa `ListFHIRExportJobs` para enumerar los trabajos de exportación del FHIR para un almacén de HealthLake datos. Los siguientes menús proporcionan un procedimiento Consola de administración de AWS y ejemplos de código para AWS CLI y AWS SDKs. Para obtener más información, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListFHIRExportJobs.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListFHIRExportJobs.html) en la *AWS HealthLake Referencia de la API de *.
**Nota**
HealthLake es compatible con la [especificación R4 del FHIR](https://hl7.org/fhir/R4/index.html) para el intercambio de datos de atención médica. Por lo tanto, todos los datos de salud se exportan en formato FHIR R4.
**Para enumerar los trabajos de exportación del FHIR**
Elija un menú en función de sus preferencias de acceso a AWS HealthLake.
## AWS CLI y SDKs
------
#### [ CLI ]
**AWS CLI**
**Para enumerar todos los trabajos de exportación de FHIR**
En el siguiente ejemplo de `list-fhir-export-jobs`, se muestra cómo utilizar el comando para ver una lista de trabajos de exportación asociados a una cuenta.
```
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)
```
Salida:
```
{
"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)"
}
}
]
}
```
Para obtener más información, consulte [Exportación de archivos desde un banco de datos del FHIR](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) en la Guía para AWS HealthLake desarrolladores.
+ Para obtener más información sobre la API, consulte [Listar FHIRExport trabajos](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-fhir-export-jobs.html) en la *referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para 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
```
+ Para obtener más información sobre la API, consulta la [sección Lista de FHIRExport trabajos](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/ListFHIRExportJobs) en la referencia de la API del *AWS SDK for Python (Boto3*).
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [Listar FHIRExport trabajos](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) en el *AWS SDK para obtener una referencia sobre la API ABAP de SAP*.
------
**Ejemplo de disponibilidad**
¿No encuentra lo que necesita? Solicita un ejemplo de código mediante el **enlace Enviar comentarios** en la barra lateral derecha de esta página.
## AWS Consola
**nota**
La información sobre los trabajos de exportación del FHIR no está disponible en la HealthLake consola. En su lugar, utilice AWS CLI with `ListFHIRExportJobs` para enumerar todos los trabajos de exportación del FHIR. Para obtener más información, consulte el AWS CLI ejemplo de esta página.