View a markdown version of this page

開始使用 AWS Management Console - AWS HealthLake
步驟 1：導覽至資料轉換代理程式步驟 2：建立轉換設定檔步驟 3：使用資料轉換 AI 代理器自訂 （選用）步驟 4：發佈設定檔步驟 5：執行轉換任務步驟 6：檢閱結果

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

開始使用 AWS Management Console

步驟 1：導覽至資料轉換代理程式

  1. 開啟 AWS HealthLake 主控台。

  2. 在登陸頁面上，按一下開始使用，然後選擇轉換資料。

  3. 在左側導覽中，在資料轉換代理程式區段下，選擇設定檔以管理設定檔，或選擇任務以執行轉換。

步驟 2：建立轉換設定檔

  1. 在左側導覽中選擇設定檔，然後按一下建立設定檔。

  2. 選擇來源格式：

    • C-CDA：臨床 XML 文件 （醫院記錄、出院摘要、continuity-of-care文件）。

    • CSV：表格式匯出 （資料倉儲擷取、EHR 一般檔案、宣告資料）。

  3. 選擇如何初始化設定檔：

    • 對於 C-CDA：從 AWS 入門設定檔 （具有常見section-to-resource映射的預先建置設定檔） 開始。

    • 對於 CSV：提供包含代表性 CSV 檔案的資料夾的 Amazon S3 路徑。AI 代理器會分析您的檔案並產生基本設定檔。

  4. 輸入設定檔名稱和選用描述。

  5. 選擇建立。

設定檔會以草稿狀態 （版本 0) 建立：您可以自由編輯的可變工作副本。

步驟 3：使用資料轉換 AI 代理器自訂 （選用）

對於 C-CDA 設定檔：

  1. 開啟設定檔並前往編輯檢視；資料轉換 AI 代理程式面板會顯示在右側。

  2. 描述自然語言的變更 （例如，「將預設狀態設定為 Washington for Patient 資源」)。

  3. 代理程式會編輯 Velocity 範本。

  4. 選取測試索引標籤，貼上您的範例 C-CDA，然後按一下執行測試以預覽轉換。

  5. 反覆運算，直到輸出正確為止。

對於 CSV 設定檔：

  1. 代理程式會分析您的範例檔案，並提議 YAML 映射：column-to-FHIR 映射、日期/值轉譯、PK/FK 關係和彙總規則。

  2. 檢閱每個提議的映射：接受、拒絕或精簡。

  3. 要求以自然語言進行調整 （例如，「將 RACE_CD 資料欄映射至 FHIR 延伸模組」)。

  4. 預覽轉換會在測試索引標籤中產生 （來源位於左側，FHIR 輸出位於右側）。

步驟 4：發佈設定檔

  1. 滿足時，選擇發佈。這會建立不可變的版本。

  2. 您的草稿仍然可以編輯。大量任務一律使用最新發佈的版本。

若要復原：選擇先前的版本，然後再次發佈。這會從先前的快照建立新的版本：不會刪除任何內容。

步驟 5：執行轉換任務

  1. 在資料轉換代理程式下的左側導覽中，選擇任務。

  2. 選擇開始新任務。

  3. 填寫任務詳細資訊：

    • 任務名稱：描述性名稱 （出現在 CloudWatch 日誌和指標中）。

    • 描述：選用。

  4. 設定轉換設定：

    • 資料來源格式：C-CDA 或 CSV。

    • 轉換設定檔：選擇已發佈的設定檔 （僅顯示版本 ≥ 1 的已發佈設定檔）。

    • 輸出模式：

      • Amazon Amazon S3：將轉換後的 FHIR 寫入 Amazon S3 位置 （獨立轉換）。

      • AWS HealthLake：將 和 直接轉換為 HealthLake 資料存放區。如果選取，請選擇目標 HealthLake 資料存放區 （必須處於 ACTIVE 狀態）。

    • Provenance：預設為啟用。產生 FHIR Provenance 資源，將輸出追蹤回來源。只有在不需要來源時才停用。

    • 偏離偵測：預設為啟用。產生顯示未映射來源元素的報告。

  5. 設定來源資料：

    • Amazon S3 來源位置：包含來源檔案的 Amazon S3 資料夾 （必須包含字首，而不只是儲存貯體名稱）。

    • 資料存取角色：HealthLake 擔任的 IAM 角色會讀取您的來源檔案和寫入輸出。如需信任和許可政策設定，請參閱 。

  6. 設定輸出組態 （如果）：

    • 輸出 Amazon S3 URI：寫入轉換後的輸出和任務日誌的位置。

    • AWS KMS 金鑰：加密靜態輸出的 AWS KMS 金鑰 （必要）。

  7. 選擇建立任務。

步驟 6：檢閱結果

  1. 任務詳細資訊頁面會顯示即時進度：狀態、處理的檔案 (CSV 的資料列）、產生的 FHIR 資源和失敗。

  2. 完成後，導覽至輸出的 Amazon S3 位置。服務會使用任務 ID，在您的輸出 URI 下建立任務範圍資料夾。在該資料夾中：

    • converted/：FHIR NDJSON 輸出檔案 （每個輸入檔案一個，例如 converted/patient-record.ndjson)。

    • ERROR/：失敗輸入的錯誤詳細資訊 （具有 inputFile 和 errorMessage 欄位的 JSON 檔案，例如 ERROR/bad-file.json)。

    • Manifest.json：具有彙總指標的任務摘要 （掃描、轉換、失敗、產生資源的檔案）。

    • jobLevelDriftResult.json:任務的彙總偏離報告 （如果啟用偏離偵測）。

    • driftDetectionPerFileResults/：C-CDA 任務的每個檔案偏離報告 （如果已啟用偏離偵測），例如 driftDetectionPerFileResults/patient-record_driftMetrics.json。