Azure API for FHIR 的常見問題集

快速健康照護互通資源 (FHIR - 發音同 "fire") 是一種互通性標準，目的是要在不同的醫療系統之間交換醫療保健資料。 此標準是由 HL7 組織所開發，並由世界各地的醫療保健組織所採用。 最新可用的 FHIR 版本是 R4 (第 4 版)。 Azure API for FHIR 支援 R4 和舊版 STU3 (試用標準 3)。 如需 FHIR 的詳細資訊，請瀏覽 HL7.org (英文)。

是，資料會儲存於 Azure 的受控資料庫中。 Azure API for FHIR 不提供對基礎資料存放區的直接存取權。

在受管理的服務中，您無法存取基礎資料。 這是為了確保 Azure API for FHIR 會提供健康照護資料所需的隱私權和合規性認證。 如果您需要存取基礎資料，可以使用開放原始碼 FHIR 伺服器 (英文)。

我們支援使用 Microsoft Entra ID 作為識別提供者。

否，我們不支援 Azure API for FHIR 中的 B2C。 如果您需要更細微的存取控制，建議您查看開放原始碼 FHIR Proxy (英文)。

受管理服務的資料每隔 4 小時就會自動備份一次，並保有兩個備份。 因此，保留期間為 8 小時。 資料復原會由支援小組完成，而復原點目標 (RPO) 小於 240 分鐘。

客戶可以要求還原資料，也可透過支援票證變更預設資料備份原則。

我們支援版本 4.0.0 和 3.0.1。 如需詳細資訊，請參閱 FHIR 支援的功能。 您也可以閱讀 HL7 FHIR 版本歷程記錄中 FHIR 版本 (STU3 至 R4) 之間已變更的內容。

Azure IoT Connector for FHIR (預覽) 目前僅支援 FHIR 版本 R4，而且會顯示在 Azure API for FHIR 的 R4 執行個體上。

Azure API for FHIR 是正式推出的受管理 FHIR 服務。 Azure 健康資料服務可讓您在相同的工作區中部署 FHIR 服務和 DICOM 服務。 Azure 健康資料服務概觀提供更多詳細資料。

Azure API for FHIR 是開放原始碼 Microsoft FHIR Server for Azure 的託管和受控版本。 在受管理的服務中，Microsoft 提供所有維修和更新。

當您執行適用於 Azure 的 FHIR 伺服器時，可以直接存取基礎服務，但如果您正在儲存 PHI 資料，我們就會負責維修和更新伺服器及所有必要的合規性工作。

我們已為多個地理區域中的公眾和政府正式提供服務。 如需有關 Microsoft 政府雲端服務的資訊，請參閱 FedRAMP 提供的 Azure 服務。

發行備註頁面會概述上個月交付至受管理服務的所有項目。

如需 Azure API for FHIR 中發行內容的詳細資訊，請參閱開放原始碼 FHIR 伺服器的發行版本 (英文)。 我們已設定好當項目將發行至受管理的服務，且通常會在其以開放原始碼形式存在於發行版本頁面上兩週後可供使用時，使用 Azure-API-for-FHIR 來標記它們。 如果您想要在自己的環境中進行測試，我們也包含了如何測試組建 (英文) 的指示。

若要查看目前在受管理服務中的發行版本套件，您可以在 software.version 屬性底下檢視 Azure API for FHIR 的功能陳述式。 您將會看到已部署的套件。

您可以在 fhirVersion 屬性底下，找到在功能陳述式中公開的確切 FHIR 版本。

否。 我們沒有辦法變更現有資料庫的版本。 您必須建立新的 Azure API for FHIR 並重新載入資料。 您可以利用 JSON 到 FHIR 轉換器 (英文) 作為開始將 STU3 資料轉換至 R4 的地方。

否。 您無法變更 Azure API for FHIR 的 URL。

SMART (可替代醫療應用程式與可重複使用技術) on FHIR 是一組開放規格，可將合作夥伴應用程式與 FHIR 伺服器和其他健康資訊 IT 系統 (例如，電子健康記錄和健康資訊交換) 整合。 透過建立 SMART on FHIR 應用程式，您就能確保應用程式可由大量不同的系統存取及利用。 如需 SMART 的詳細資訊，請瀏覽 SMART 健康資訊 IT (英文) 網站。

是，使用 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 JSON 資料載入到伺服器。 如果您想要儲存定義延伸模組的結構定義，您可以將其儲存為結構定義資源。 若要搜尋延伸模組，您必須定義自己的搜尋參數。

您的資源必須低於 2 MB。 這是基礎資料存放區的限制，我們無法增加此值。

在受管理的服務中，我們僅支援 JSON。 開放原始碼 FHIR 伺服器支援 JSON 和 XML。 若要在開放原始碼中檢視 XML 版本，請使用 _format= application/fhir+xml。

_count 目前的限制為 1000。 如果您將 _count 設定為 1000 以上，您將收到套件組合中只會顯示 1000 筆記錄的警告。

針對群組匯出，我們只會匯出群組中包含的參考，而不會匯出群組資源 (英文) 的所有特性。

我們目前支援張貼批次套件組合 (英文)，但不支援在 Azure API for FHIR 中張貼交易套件組合。 如果您需要支援交易套件組合，則可在 Azure 健康資料服務中使用 FHIR 服務。

您可以使用 Patient-$everything 運算，也可以在 Azure API for FHIR 中使用區間搜尋 (英文)。 這可讓您取得與特定病患相關的所有資源。 請注意，病患區間會包含與該病患相關的所有資源，但不包含病患本身，因此，如果您需要結果中的病患資源，也必須搜尋以取得該病患。

我們支援依上次更新日期排序：_sort=_lastUpdated。 我們也在 FirstName、LastName、BirthDate 和 ClinicalDate 元素上支援 _sort。 如需其他支援搜尋參數的詳細資訊，請參閱 FHIR 搜尋概觀。

是，我們確實支援 patient-$everything。 如需詳細資訊，請參閱 Patient-$Everything 操作指南。

否，Azure API for FHIR 目前不支援術語運算。

$export 是 FHIR 規格 (英文) 的一部分。 如果 FHIR 服務是使用受控識別和儲存體帳戶來設定，而且如果受控識別有權存取該儲存體帳戶，則您可以在 FHIR API 上呼叫 $export，並將所有 FHIR 資源匯出至該儲存體帳戶。 如需詳細資訊，請參閱 $export 一文。

我們提供開放原始碼工具來針對 FHIR 資料進行去身分識別。 相同的技術也會以去身分識別匯出的形式整合到 Azure API for FHIR。

目前僅完整系統匯出 (/$export) 支援匿名匯出，病患匯出 (/Patient/$export) 並未提供支援。 我們正努力使其也可在病患層級使用。

Azure API for FHIR 內支援兩種基本刪除類型。 其為刪除和條件式刪除。

• 使用刪除，您可以選擇執行虛刪除 (最常見的類型)，且仍能復原記錄的歷程記錄版本。
• 使用條件式刪除，您可以傳遞搜尋準則，刪除資源時一次刪除一個項目或一次刪除數個項目。
• 使用刪除或條件式刪除時，如果您傳遞了 hardDelete 參數，則會刪除所有記錄和歷程記錄且無法復原。

如果您未使用 hardDelete 參數，則可復原已刪除的檔案。 Azure API for FHIR 中的記錄仍應存在。 您可以在資源上執行歷程記錄搜尋，並尋找含有資料的最後一個版本，從而找到記錄。

如需啟用稽核記錄和範例查詢的詳細資訊，請參閱在 Azure API for FHIR 中啟用診斷記錄。 如果您要在記錄中包含其他資訊，請參閱使用自訂 HTTP 標頭。

若要解決此問題，您可以提高輸送量，或切換至自動調整，以確保您有足夠的計算來處理要求。 如果您仍遇到問題，請開啟支援票證。

最小 RU 值必須是每 GB 至少 40 RU。 當您載入資料時，如果低於此最小值，資料庫上的 RU 將會增加。

我們在健康情況架構 GitHub 頁面 (英文) 上提供了一組參考架構。

若要在 FHIR 服務上執行健康情況檢查，請在 GET 要求中輸入 {{fhirurl}}/health/check。 您應該可以看到 FHIR 服務的狀態。 HTTP 狀態碼回應 200，且回應中的 OverallStatus 為「良好」，表示您的健康情況檢查成功。 如果發生錯誤，您將收到 HTTP 狀態碼 404 (找不到) 或狀態碼 500 (內部伺服器錯誤) 的錯誤回應，在某些情況下，將會在回應本文中提供詳細資訊。

是，Azure API for FHIR 允許設定客戶自控金鑰，並利用 Azure Cosmos DB 的支援。 如需使用個人金鑰加密資料的詳細資訊，請參閱在 REST 上設定客戶自控金鑰。