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á.
# Criando um armazenamento HealthLake de dados
Use `CreateFHIRDatastore` para criar um armazenamento de AWS HealthLake dados em conformidade com a especificação FHIR R4. HealthLake os armazenamentos de dados são usados para importar, gerenciar, pesquisar e exportar dados FHIR. Você pode optar por importar (pré-carregar) dados de saúde FHIR R4 de código aberto do Synthea para seu armazenamento de dados ao criá-los. Para obter mais informações, consulte [Tipos de dados pré-carregados](reference-healthlake-preloaded-data-types.md).
**Importante**
HealthLake suporta dois tipos de estratégias de autorização de armazenamento de dados FHIR, AWS SigV4 ou SMART no FHIR. Você deve escolher uma das estratégias de autorização antes de criar um armazenamento de dados HealthLake FHIR. Para obter mais informações, consulte [Estratégia de autorização do armazenamento de dados](getting-started-concepts.md#concept-data-store-authorization-strategy).
[Quando você cria um armazenamento de HealthLake dados, um repositório de dados FHIR é disponibilizado por meio de um RESTful endpoint de API.](reference-healthlake-endpoints-quotas.md#reference-healthlake-endpoints) Depois de criar seu armazenamento de HealthLake dados, você pode solicitar sua [Declaração de Capacidade](reference-fhir-capability-statement.md) para encontrar todos os recursos (comportamentos) relacionados ao FHIR associados.
Os menus a seguir fornecem exemplos para o AWS CLI AWS SDKs e e um procedimento para Console de gerenciamento da AWS o. Para obter mais informações, consulte [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_CreateFHIRDatastore.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_CreateFHIRDatastore.html) na *Referência de APIs do AWS HealthLake *.
**Para criar um armazenamento HealthLake de dados**
Escolha um menu com base na sua preferência de acesso AWS HealthLake a.
## AWS CLI and SDKs
------
#### [ CLI ]
**AWS CLI**
**Exemplo 1: Criar um armazenamento de dados habilitado para SIGv4 HealthLake **
O `create-fhir-datastore` exemplo a seguir demonstra como criar um novo armazenamento de dados em AWS HealthLake.
```
aws healthlake create-fhir-datastore \
--datastore-type-version {{R4}} \
--datastore-name {{"FhirTestDatastore"}}
```
Saída:
```
{
"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)"
}
```
**Exemplo 2: Crie um SMART no armazenamento de dados habilitado para FHIR HealthLake **
O `create-fhir-datastore` exemplo a seguir demonstra como criar um novo SMART no armazenamento de dados habilitado para FHIR em. 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}}
```
Conteúdo de `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\"]}"
}
```
Saída:
```
{
"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)"
}
```
Para obter mais informações, consulte [Criação e monitoramento de um armazenamento de dados FHIR](https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html) no Guia do *AWS HealthLake desenvolvedor*.
+ Para obter detalhes da API, consulte [Create FHIRDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/create-fhir-datastore.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 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
```
O código a seguir mostra um exemplo de parâmetros para um SMART no armazenamento de dados habilitado para 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
)
```
+ Para obter detalhes da API, consulte Referência da API [Create FHIRDatastore](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/CreateFHIRDatastore) 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_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.
```
+ Para obter detalhes da API, consulte a referência da *API [Create FHIRDatastore](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
**Observação**
O procedimento a seguir cria um armazenamento HealthLake de dados com autorização [AWS SigV4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). O HealthLake console não suporta a criação de um SMART no armazenamento de dados FHIR.
**Para criar um armazenamento HealthLake de dados com autorização AWS SigV4**
1. Faça login na página [Criar armazenamento de dados](https://console.aws.amazon.com/healthlake/home#/create-datastore) no HealthLake console.
1. Escolha **Criar armazenamento de dados**.
1. Na seção **Configurações do Armazenamento de Dados**, em **Nome do Armazenamento de Dados**, especifique um nome.
1. (Opcional) Na seção **Configurações do Data Store**, em **Pré-carregar dados de amostra**, marque a caixa de seleção para pré-carregar dados do Synthea. Os dados Synthea são um conjunto de dados de amostra de código aberto. Para obter mais informações, consulte [Tipos de dados pré-carregados do Synthea para HealthLake](reference-healthlake-preloaded-data-types.md).
1. Na seção **Criptografia do armazenamento de dados**, escolha **Usar chave própria da AWS (padrão)** ou **Escolher uma chave diferente do AWS KMS (avançada)**.
1. Na seção **Tags - *opcional***, você pode adicionar tags ao seu armazenamento de dados. Para saber mais sobre como marcar seu armazenamento de dados, consulte[Marcando armazenamentos HealthLake de dados](managing-data-stores-tagging.md).
1. Escolha **Criar armazenamento de dados**.
O status do seu armazenamento de dados está disponível na página **Armazenamentos de dados**.