View a markdown version of this page

开始使用 AWS 管理控制台 - AWS HealthLake
步骤 1：导航到数据转换代理步骤 2：创建转换配置文件步骤 3：使用数据转换 AI 代理进行自定义（可选）第 4 步：发布个人资料步骤 5：运行转换作业步骤 6：查看结果

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

开始使用 AWS 管理控制台

步骤 1：导航到数据转换代理

  1. 打开 AWS HealthLake 控制台。

  2. 在登录页面上，单击 “开始”，然后选择 “转换数据”。

  3. 在左侧导航栏的 “数据转换代理” 部分下，选择 “配置文件” 以管理配置文件，或选择 “作业” 以运行转换。

步骤 2：创建转换配置文件

  1. 在左侧导航栏中选择 “个人资料”，然后单击 “创建个人资料”。

  2. 选择源格式：

    • C-CDA: 临床 XML 文档（医院记录、出院摘要、持续护理文件）。

    • CSV：表格导出（数据仓库摘录、EHR 平面文件、索赔数据）。

  3. 选择如何初始化配置文件：

    • 适用于 C-CDA：从 AWS 入门配置文件（具有常见分区到资源映射的预建配置文件）开始。

    • 对于 CSV：提供指向包含代表性 CSV 文件的文件夹的 Amazon S3 路径。AI 代理会分析您的文件并生成基本配置文件。

  4. 输入配置文件名称和可选描述。

  5. 选择创建。

配置文件是在草稿状态（版本 0）下创建的：一个可以自由编辑的可变工作副本。

步骤 3：使用数据转换 AI 代理进行自定义（可选）

对于 C-CDA 个人资料：

  1. 打开配置文件并进入编辑视图；数据转换 AI 代理面板显示在右侧。

  2. 描述自然语言的变化（例如，“将患者资源的默认州设置为华盛顿州”）。

  3. 代理编辑 Velocity 模板。

  4. 选择 “测试” 选项卡，粘贴您的示例， C-CDA 然后单击 “运行测试” 以预览转换。

  5. 迭代直到输出正确。

对于 CSV 配置文件：

  1. 代理会分析您的示例文件并提出 YAML 映射：列到 FHIR 的映射、转 date/value 换、 PK/FK 关系和聚合规则。

  2. 查看每个建议的映射：接受、拒绝或完善。

  3. 要求以自然语言进行调整（例如，“将 RACE_CD 列映射到 FHIR 扩展名”）。

  4. 在测试选项卡中预览转换结果（左边是源代码，右边是 FHIR 输出）。

第 4 步：发布个人资料

  1. 如果满意，请选择 “发布”。这将创建一个不可变的版本。

  2. 您的草稿仍可编辑。批量作业始终使用最新发布的版本。

回滚：选择以前的版本并重新发布。这会根据之前的快照创建新版本：不会删除任何内容。

步骤 5：运行转换作业

  1. 在左侧导航栏中的 “数据转换代理” 下，选择 “作业”。

  2. 选择 “开始新作业”。

  3. 填写 Job 详情：

    • Job 名称：描述性名称（出现在 CloudWatch 日志和指标中）。

    • 描述：可选。

  4. 配置转换设置：

    • 数据源格式： C-CDA 或 CSV。

    • 转换配置文件：选择已发布的配置文件（仅显示版本 ≥ 1 的已发布配置文件）。

    • 输出模式：

      • 亚马逊 Amazon S3：将转换后的 FHIR 写入亚马逊 S3 地点（独立转换）。

      • AWS HealthLake：直接转换并采集到 HealthLake 数据存储中。如果选中，请选择目标 HealthLake 数据存储（必须处于 ACTIVE 状态）。

    • 来源：默认启用。生成 FHIR 来源资源，将输出追溯到源头。只有在不需要出处时才禁用。

    • 漂移检测：默认启用。生成显示未映射源元素的报告。

  5. 配置源数据：

    • Amazon S3 源位置：包含您的源文件的 Amazon S3 文件夹（必须包含前缀，而不仅仅是存储桶名称）。

    • 数据访问角色：IAM 角色 HealthLake 假设读取您的源文件并写入输出。设置有关信任和权限策略，请参阅。

  6. 配置输出配置（如果）：

    • 输出 Amazon S3 URI：在哪里写入转换后的输出和任务日志。

    • AWS KMS key：加密静态输出的 AWS KMS 密钥（必填）。

  7. 请选择创建任务。

步骤 6：查看结果

  1. 作业详细信息页面显示实时进度：状态、已处理的文件（CSV 行数）、生成的 FHIR 资源和失败。

  2. 完成后，导航到输出的 Amazon S3 位置。该服务使用作业 ID 在您的输出 URI 下创建一个任务范围的文件夹。在那个文件夹里：

    • converted/: FHIR NDJSON 输出文件（每个输入文件一个，例如-record.ndjson）。 converted/patient

    • ERROR/：失败输入的错误详情（例如，带有 inputFile 和 ErrorMessage 字段的 JSON 文件）。 ERROR/bad-file.json

    • Manifest.json：包含汇总指标的任务摘要（文件已扫描、已转换、失败、生成的资源）。

    • jobLevelDriftResult.json：作业的汇总偏差报告（如果启用了偏差检测）。

    • driftDetectionPerFileResults/： C-CDA 作业的每个文件偏差报告（如果启用了偏差检测），例如 driftDetectionPerFileResults/patient-Metrics.json record_drift。