FHIR 服務的常見問題
重要
Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR® 服務。 由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是 Azure API for FHIR 的進化版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。
本節涵蓋有關 Azure Health Data Services FHIR® 服務的一些常見問題。
FHIR 服務：基本概念
什麼是 FHIR？
Fast Healthcare 互操作性資源 （FHIR） 是一種互操作性標準，旨在讓不同健康系統之間交換醫療保健數據。 此標準是由 HL7 組織所開發，並由世界各地的醫療保健組織所採用。 最新可用的 FHIR 版本是 R4 (第 4 版)。 FHIR 服務支援 R4 和舊版 STU3（試用版標準 3）。 如需 FHIR 的詳細資訊，請瀏覽 HL7.org (英文)。
FHIR API 背後的資料是否會儲存於 Azure 中？
是，資料會儲存於 Azure 的受控資料庫中。 Azure Health Data Services 中的 FHIR 服務無法直接存取基礎數據存放區。
如何取得對基礎資料的存取權？
在受管理的服務中，您無法存取基礎資料。 這是為了確保 FHIR 服務提供醫療保健數據所需的隱私權和合規性認證。 如果您需要存取基礎資料，可以使用開放原始碼 FHIR 伺服器 (英文)。
您支援哪一個識別提供者？
我們支援Microsoft支援 OpenID 連線的 Entra ID 和第三方識別提供者。
我可以搭配 FHIR 服務使用 Azure AD B2C 嗎？
是。 您可以使用 Azure Active Directory B2C （Azure AD B2C） 搭配 FHIR 服務來授與應用程式和使用者的存取權。 如需詳細資訊，請參閱 使用 Azure Active Directory B2C 來授與 FHIR 服務的存取權。
您支援哪一個 FHIR 版本？
我們支援版本 4.0.0 和 3.0.1。
如需詳細資訊，請參閱 支援的 FHIR 功能。 您也可以閱讀 HL7 FHIR 版本歷程記錄中 FHIR 版本 (STU3 至 R4) 之間已變更的內容。
Azure API for FHIR 與 Azure Health Data Services 中的 FHIR 服務有何差異？
Azure API for FHIR 是我們一開始正式推出的產品，自 2026 年 9 月 30 日起即將淘汰。 下表說明 Azure API for FHIR 與 Azure Health Data Services、FHIR 服務之間的差異。
| Capabilities | Azure API for FHIR | Azure 健康資料服務 |
|---|---|---|
| 資料輸入 | OSS 中可用的工具 | $import作業。 如需詳細資訊，請造訪 匯入作業 |
| 自動調整 | 依要求支援並須支付費用 | 默認會啟用自動調整 ，不需額外費用 |
| 搜尋參數 | 支援的套件組合類型：批次 • Include 和 revinclude，不支援 iterate 修飾元 • 支援名字、姓氏、出生日期和臨床日期排序 |
支援的套件組合類型：批次和交易 • 可選取的搜尋參數 • Include 和 revinclude，並支援 iterate 修飾元 • 支援字串和 dateTime 欄位排序 |
| 事件 | 不支援 | 支援 |
| Convert-data | 支援在帳戶容器登錄中啟用「允許信任的服務」 | 有一個已知問題：使用 Azure Container Registry 啟用私人連結可能會導致嘗試從 FHIR 服務使用容器登錄時發生存取問題。 |
| 業務持續性 | 支援： • 跨區域 DR (災害復原) |
支援： • PITR (時間點還原) • 可用性區域支援 |
根據預設，每個 Azure Health Data Services 的 FHIR 實例受限於 4TB 的記憶體容量。 若要布建記憶體容量超過 4TB 的 FHIR 實例，請建立具有「服務」和「訂用帳戶限制」類型的支援要求（配額）。
Azure Health Data Services 中的 FHIR 服務與開放原始碼 FHIR 伺服器之間的差異為何？
Azure Health Data Services 中的 FHIR 服務是適用於 Azure 的開放原始碼Microsoft FHIR 伺服器的託管和管理版本。 在受管理的服務中，Microsoft 提供所有維修和更新。
當您執行適用於 Azure 的 FHIR 伺服器時，可以直接存取基礎服務，但如果您正在儲存 PHI 資料，我們就會負責維修和更新伺服器及所有必要的合規性工作。
FHIR 服務可在哪些區域中使用？
FHIR 服務可在 Azure Health Data Services 可供使用的所有區域中使用。 您可以在 [依區域的產品] 頁面上看到支持的區域。
哪裡可以找到哪些項目會發行至 FHIR 服務？
發行備註頁面會概述上個月交付至受管理服務的所有項目。
若要查看將發行至受控服務的內容，您可以檢閱 開放原始碼 FHIR 伺服器的發行頁面 。 如果專案會發行至受控服務，且在中的開放原始碼發行頁面上兩周后，我們已使用 Azure Health Data Services 標記專案。 如果您想要在自己的環境中進行測試，我們也包含如何 測試組建的指示。 我們正在評估如何最好共用其他受控服務更新。
若要查看受控服務中目前有哪些發行套件，您可以檢視 FHIR 服務和 屬性下 software.version 的功能語句。 您將會看到已部署的套件。
哪裡可以找到我的資料庫上執行哪個版本的 FHIR （R4/STU3？
您可以在 屬性 （FHIR URL/metadata） 下 fhirVersion 的功能語句中找到公開的確切 FHIR 版本。
我可以將 FHIR 服務從 STU3 切換至 R4 嗎？
否。 我們沒有辦法變更現有資料庫的版本。 您必須建立新的 FHIR 服務，並重載數據。 您可以利用 JSON 到 FHIR 轉換器 (英文) 作為開始將 STU3 資料轉換至 R4 的地方。
我可以自定義 FHIR 服務的 URL 嗎？
否。 您無法變更 FHIR 服務的網址。
Azure Health Data Services 中與 FHIR 服務相關聯的限制為何？
請參閱 Azure FHIR 服務限制中的 一節
FHIR 實作和規格
什麼是 SMART on FHIR？
SMART (可替代醫療應用程式與可重複使用技術) on FHIR 是一組開放規格，可將合作夥伴應用程式與 FHIR 伺服器和其他健康資訊 IT 系統 (例如，電子健康記錄和健康資訊交換) 整合。 藉由建立 SMART on FHIR 應用程式，您可以確保應用程式可供許多不同的系統存取和使用。 如需SMART的詳細資訊，請參閱 SMART Health IT。
FHIR 服務是否支援 SMART on FHIR？
是，使用 AHDS 範例 (英文) 支援 SMART on FHIR 功能。 這稱為 SMART on FHIR(Enhanced)。 您可以將 SMART on FHIR(Enhanced) 視為符合 SMART on FHIR 實作指南 (v 1.0.0) (英文) 和適用於病患與人口服務的 §170.315(g)(10) 標準化 API 準則 (英文) 的需求。 如需詳細資訊，請瀏覽 SMART on FHIR(Enhanced) 文件。
我是否可建立自訂 FHIR 資源？
我們不允許自訂 FHIR 資源。 如果您需要自訂 FHIR 資源，您可以在具有延伸模組的基本資源 (英文) 之上建置自訂資源。
FHIR 服務是否支援擴充功能？
是。 我們可讓您將任何有效的 FHIR JSON 資料載入到伺服器。 如果您想要儲存定義 延伸模組的結構定義，您可以將它儲存為結構定義資源。 若要搜尋延伸模組，您必須定義自己的搜尋參數。
如何? XML 中看到 FHIR 服務嗎？
在受管理的服務中，我們僅支援 JSON。 開放原始碼 FHIR 伺服器支援 JSON 和 XML。 若要在開放原始碼中檢視 XML 版本，請使用 _format= application/fhir+xml。
_count 有什麼限制?
_count 目前的限制為 1000。 如果您將_count設定為超過 1000 筆，您會收到套件組合中只會顯示 1,000 筆記錄的警告。
我可以將套件組合張貼至 FHIR 服務嗎？
我們目前支援在 FHIR 服務中張貼 批次配套 和張貼 交易配套 。
如何在 FHIR 服務中取得單一患者的所有資源？
我們支援 $patient一切作業 ，讓您取得與單一患者相關的所有數據。
FHIR 服務是否支援任何術語作業？
否，FHIR 服務目前不支援術語作業。
使用 FHIR 服務
我是否可在 FHIR 服務上執行健康情況檢查？
若要在 FHIR 服務上執行健康情況檢查，請在 GET 要求中輸入 {{fhirurl}}/health/check 。 您應該可以看到 FHIR 服務的狀態。 HTTP 狀態代碼回應，200 和 OverallStatus 為 [狀況良好 ] 表示健康情況檢查成功。
如果發生錯誤，您可能會收到 HTTP 狀態代碼 404（找不到）或狀態代碼 500（內部伺服器錯誤）的錯誤回應，以及回應本文中的詳細資訊。
在 FHIR 服務與 Dataverse 之間同步處理數據的建議方法為何？
下一步
在本文中，您已瞭解 FHIR 服務常見問題的解答。 若要查看 Azure API for FHIR 中 FHIR 服務的常見問題，請參閱
注意
FHIR® 是 HL7 的註冊商標，在 HL7 的許可下使用。