使用醫療保健資料解決方案中的 Azure 健康資料服務 - 資料匯出
注意
目前正在更新此內容。
Azure 健康資料服務 - 資料匯出能協助您將快速健康照護互通資源 (FHIR) 資料從 Azure 健康資料服務 FHIR 服務帶到 Fabric OneLake。 若要了解此功能的詳細資訊並了解如何部署和設定它,請參閱:
執行 Azure 健康資料服務 - 資料匯出管線
完成先決條件和部署步驟後,您就可以開始從 Azure 健康資料服務 FHIR 服務擷取 FHIR 資料,並通過銅牌和銀牌湖倉層進行轉換。 本部分提供有關使用自備儲存體 (BYOS) 擷取模式來擷取 FHIR 資料的指南。
注意
Azure 健康資料服務 FHIR 服務支援 FHIR R4 v4.0.1。 有關支援的 FHIR 格式的詳細資訊,請參閱擷取臨床資料的使用注意事項。
若要擷取數據,請執行 healthcare#_msft_clinical_ahds_fhirservice_export 資料管線。 healthcare#_msft_ahds_fhirservice_export 筆記本首先將資料從 Azure 健康資料服務 FHIR 服務匯出到指定的 Azure Data Lake Storage Gen2 容器。 後續的筆記本 healthcare#_msft_fhir_ndjson_bronze_ingestion 和 healthcare#_msft_bronze_silver_flatten 會如使用醫療保健資料基礎擷取臨床資料中所述,進一步處理資料。
healthcare#_msft_ahds_fhirservice_export 筆記本會執行以下動作:
- 從與 Azure Marketplace 供應項目關聯的 Azure Key Vault 中檢索函數金鑰。
- 使用此函數金鑰觸發與 Azure Marketplace 供應項目一起部署的 Azure 函數。
- 請求使用全域設定中的 FHIR 服務 URL,從 Azure 健康資料服務 FHIR 服務大量匯出。
- 輪詢 FHIR 服務以確認大量匯出完成,重試直到達到成功狀態,或最大輪詢天數閾值。
大量匯出完成後,管線將按順序執行 healthcare#_msft_fhir_ndjson_bronze_ingestion 和 healthcare#_msft_bronze_silver_flatten 筆記本來轉換和載入資料。
安全性建議
部署完 Microsoft Fabric中的醫療保健資料解決方案的 Azure Marketplace 供應項目後,請考慮以下安全性建議:
遵循輪流Azure 函數存取金鑰的最佳做法。
對 OneLake 私人端點使用受控識別,而不是共用存取簽章 (SAS)。
疑難排解 Azure 健康資料服務 - 資料匯出
此部分概述使用 Azure 健康資料 - 資料匯出功能時可能會遇到的常見問題或錯誤,並提供解決步驟。
解決 FHIR 匯出筆記本的授權錯誤
當您執行 FHIR 匯出筆記本 healthcare#_msft_ahds_fhirservice_export 時,如果未將所需權限指派給 Azure 函數應用程式或 FHIR 伺服器,則可能會看到 HTTP 401:未經授權錯誤。
請務必將 FHIR 資料匯出者 角色指派給 FHIR 服務上的函數應用程式,並將儲存體 blob 資料參與者角色指派給已設定的匯出儲存體帳戶上的 FHIR 服務。
如需詳細資訊,請參閱部署 Azure Marketplace 供應項目和設定資源。
解決 FHIR 匯出筆記本的衝突錯誤
執行 FHIR 匯出筆記本 healthcare#_msft_ahds_fhirservice_export 時,您有時可能會看到 HTTP 409:衝突錯誤。
Azure 函數應用程式是設定用來在任何時候僅執行一個匯出的執行個體。 HTTP 409 錯誤表示另一個匯出作業已在執行中。 等待它完成,然後觸發另一個匯出。
使用 Azure Log Analytics 監看函數應用程式記錄
可以在部署到 Azure 資源群組的 Log Analytics 工作區中監看匯出函數應用程式服務的記錄。 下面是用於查看函式應用程式追蹤的樣本 Kusto 查詢:
AppTraces
| where AppRoleName startswith "msft-func-datamanager-export"