As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exportando dados FHIR com AWS HealthLake
Use AWS HealthLake ações nativas para iniciar, descrever e listar trabalhos de exportação do FHIR. Você pode colocar trabalhos de exportação em fila. As tarefas de exportação assíncrona são processadas de forma FIFO (First In First Out). Você pode colocar trabalhos em fila da mesma forma que inicia trabalhos de exportação. Se um estiver em andamento, ele simplesmente entrará na fila. Você pode criar, ler, atualizar ou excluir recursos do FHIR enquanto um trabalho de exportação está em andamento.
**nota**
Você também pode exportar dados FHIR de um armazenamento de HealthLake dados usando a operação FHIR R4. `$export` Para obter mais informações, consulte [Exportação de HealthLake dados com o FHIR `$export`](reference-fhir-operations-export.md).
**Topics**
+ [Iniciando um trabalho de exportação](exporting-fhir-data-start.md)
+ [Obtendo propriedades de trabalho de exportação](exporting-fhir-data-describe.md)
+ [Listando trabalhos de exportação](exporting-fhir-data-list.md)
# Iniciando um trabalho de exportação do FHIR
Use `StartFHIRExportJob` para iniciar um trabalho de exportação FHIR a partir de um armazenamento de HealthLake dados. Os menus a seguir fornecem um procedimento para o Console de gerenciamento da AWS e exemplos de código para AWS CLI AWS SDKs e. Para obter mais informações, consulte [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_StartFHIRExportJob.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_StartFHIRExportJob.html) na *Referência de APIs do AWS HealthLake *.
**Observação**
HealthLake suporta a [especificação FHIR R4 para troca de dados](https://hl7.org/fhir/R4/index.html) de assistência médica. Portanto, todos os dados de saúde são exportados no formato FHIR R4.
**Iniciar um serviço de exportação do FHIR**
Escolha um menu com base na sua preferência de acesso AWS HealthLake a.
## AWS CLI and SDKs
------
#### [ CLI ]
**AWS CLI**
**Iniciar um serviço de exportação do FHIR**
O `start-fhir-export-job` exemplo a seguir mostra como iniciar um trabalho de exportação do FHIR usando o. 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)
```
Saída:
```
{
"DatastoreId": "(Data store ID)",
"JobStatus": "SUBMITTED",
"JobId": "9b9a51943afaedd0a8c0c26c49135a31"
}
```
*Para obter mais informações, consulte [Exportação de arquivos de um armazenamento de dados FHIR no Guia](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) do AWS HealthLake desenvolvedor.*
+ Para obter detalhes da 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 obter detalhes da API, consulte Referência da API [Start FHIRExport Job](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/StartFHIRExportJob) in *AWS SDK for Python (Boto3*).
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](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 obter detalhes da API, consulte [a referência da API Start FHIRExport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) *in AWS SDK for SAP ABAP*.
------
**Exemplo de disponibilidade**
Não consegue encontrar o que precisa? Solicite um exemplo de código usando o link **Fornecer feedback** na barra lateral direita desta página.
## AWS Console
1. Faça login na página [Armazenamentos de dados](https://console.aws.amazon.com/healthlake/home#/list-datastores) no HealthLake console.
1. Escolha um datastore.
1. Escolha **Exportar**.
A página **Exportar** é aberta.
1. Na seção **Dados de saída**, insira as seguintes informações:
+ **Localização dos dados de saída no Amazon S3**
+ **Criptografia de saída**
1. Na seção **Permissões de acesso**, escolha **Usar uma função de serviço do IAM existente** e selecione a função no menu **Nome da função** ou escolha **Criar uma função do IAM**.
1. Escolha **Exportar dados**.
**nota**
Durante a exportação, escolha **Copiar ID do trabalho** no banner na parte superior da página. Você pode usar o [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 propriedades do trabalho de exportação usando AWS CLI o. Para obter mais informações, consulte [Obtendo propriedades de trabalho de exportação do FHIR](exporting-fhir-data-describe.md).
# Obtendo propriedades de trabalho de exportação do FHIR
Use `DescribeFHIRExportJob` para obter propriedades da tarefa de exportação de um armazenamento HealthLake de dados. Os menus a seguir fornecem um procedimento para o Console de gerenciamento da AWS e exemplos de código para AWS CLI AWS SDKs e. Para obter mais informações, consulte [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DescribeFHIRExportJob.html) na *Referência de APIs do AWS HealthLake *.
**Observação**
HealthLake suporta a [especificação FHIR R4 para troca de dados](https://hl7.org/fhir/R4/index.html) de assistência médica. Portanto, todos os dados de saúde são exportados no formato FHIR R4.
**Descrever um serviço de exportação do FHIR**
Escolha um menu com base na sua preferência de acesso AWS HealthLake a.
## AWS CLI and SDKs
------
#### [ CLI ]
**AWS CLI**
**Descrever um serviço de exportação do FHIR**
O `describe-fhir-export-job` exemplo a seguir mostra como encontrar as propriedades de um trabalho de exportação FHIR em. AWS HealthLake
```
aws healthlake describe-fhir-export-job \
--datastore-id (Data store ID) \
--job-id 9b9a51943afaedd0a8c0c26c49135a31
```
Saída:
```
{
"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 obter mais informações, consulte [Exportação de arquivos de um armazenamento de dados FHIR no Guia](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) do AWS HealthLake desenvolvedor.*
+ Para obter detalhes da API, consulte [Descreve 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 obter detalhes da API, consulte Referência da API [Descreve FHIRExport Job](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/DescribeFHIRExportJob) in *AWS SDK for Python (Boto3*).
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](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 obter detalhes da API, consulte a referência da *API [Describe FHIRExport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in AWS SDK for SAP ABAP*.
------
**Exemplo de disponibilidade**
Não consegue encontrar o que precisa? Solicite um exemplo de código usando o link **Fornecer feedback** na barra lateral direita desta página.
## AWS Console
**nota**
As informações do trabalho de exportação do FHIR não estão disponíveis no HealthLake console. Em vez disso, use AWS CLI with `DescribeFHIRExportJob` para solicitar propriedades do trabalho de exportação, 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 obter mais informações, consulte o AWS CLI exemplo nesta página.
# Listando trabalhos de exportação do FHIR
Use `ListFHIRExportJobs` para listar trabalhos de exportação FHIR para um armazenamento de HealthLake dados. Os menus a seguir fornecem um procedimento para o Console de gerenciamento da AWS e exemplos de código para AWS CLI AWS SDKs e. Para obter mais informações, consulte [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListFHIRExportJobs.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListFHIRExportJobs.html) na *Referência de APIs do AWS HealthLake *.
**Observação**
HealthLake suporta a [especificação FHIR R4 para troca de dados](https://hl7.org/fhir/R4/index.html) de assistência médica. Portanto, todos os dados de saúde são exportados no formato FHIR R4.
**Para listar trabalhos de exportação do FHIR**
Escolha um menu com base na sua preferência de acesso AWS HealthLake a.
## AWS CLI and SDKs
------
#### [ CLI ]
**AWS CLI**
**Listar todos os serviços de exportação do FHIR**
O exemplo `list-fhir-export-jobs` a seguir mostra como usar o comando para exibir uma lista de serviços de exportação associados a uma conta.
```
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)
```
Saída:
```
{
"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 obter mais informações, consulte [Exportação de arquivos de um armazenamento de dados FHIR no Guia](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) do AWS HealthLake desenvolvedor.
+ Para obter detalhes da API, consulte [Listar FHIRExport trabalhos](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-fhir-export-jobs.html) na *Referência 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 obter detalhes da API, consulte Referência da API [Listar FHIRExport trabalhos](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/ListFHIRExportJobs) no *AWS SDK for Python (Boto3*).
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](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 obter detalhes da API, consulte [Listar FHIRExport trabalhos](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) no *AWS SDK para referência da API SAP ABAP*.
------
**Exemplo de disponibilidade**
Não consegue encontrar o que precisa? Solicite um exemplo de código usando o link **Fornecer feedback** na barra lateral direita desta página.
## AWS Console
**nota**
As informações do trabalho de exportação do FHIR não estão disponíveis no HealthLake console. Em vez disso, use AWS CLI com `ListFHIRExportJobs` para listar todos os trabalhos de exportação do FHIR. Para obter mais informações, consulte o AWS CLI exemplo nesta página.