リリースノート: Azure API for FHIR

[アーティクル]
12/06/2024

重要

Azure API for FHIR は、2026 年 9 月 30 日に廃止されます。 移行戦略に従って、その日までに Azure Health Data Services FHIR® サービスに切り替えてください。 Azure API for FHIR が廃止されたため、2025 年 4 月 1 日以降、新しいデプロイは許可されません。 Azure Health Data Services FHIR サービスは、お客様が他の Azure サービスへの統合を使用して、FHIR、DICOM、および MedTech サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。

Azure API for FHIR® は、Microsoft FHIR Server for Azure のフルマネージドデプロイを提供します。このサーバーは、FHIR 標準の実装です。このドキュメントでは、Azure API for FHIR の機能と機能強化について詳しく説明します。

2024 年 11 月

FHIR サービス

バグの修正

エクスポートの検証の改善: 無効な検索パラメーターにもかかわらずエクスポートが続行される問題が見つかりました。これらの条件下でのエクスポートを防ぐために、新しい変更が実装されます。これは既定の動作です。お客様は、lenient フラグを使用してオーバーライドできます。この変更は先月お客様に伝達されました。
バンドルパフォーマンスの強化: バンドルの実行中のプロファイル更新プロセスが簡略化されました。バンドルに ValueSet、 StructureDefinition、 CodeSystemの変更が含まれている場合、バンドルが完全に完了するまでプロファイルの更新は行われません。この変更により、これらのリソースの種類の変更を処理するときに複数の更新によって発生する遅延を減らすことで、バンドルのパフォーマンスが向上します。
コンテンツタイプヘッダーの解析: application/x-www-form-urlencoded コンテンツタイプヘッダーの解析に関連する問題が解決されました。
インデックスの再作成の機能強化: 以前は大規模な履歴データセットの処理を制限していた人為的な制限や、お客様が限られたクエリサイズを要求した場合を削除することで、インデックス再作成操作が改善されました。さらに、インデックス再作成プロセスでは、既定のクエリサイズで多数の連続した履歴または削除されたリソースを処理するときに、"完了" と誤って報告されます。この問題は、インデックス再作成プロセスが正しく完了し、適切な状態を報告するために対処されています。

2024 年 10 月

FHIR サービス

バグの修正

エクスポートの検証: 無効な検索パラメーターにもかかわらずエクスポートが続行される問題が特定されました。これらの条件下でのエクスポートを防ぐ変更が導入されています。この機能は現在、厳密な検証フラグの背後にあり、10 月 30 日以降の既定の動作になります。
検索パラメーターの包含: 追加の検索パラメーター (たとえば、 _include、 _has) が期待される結果をすべて返せず、次のリンクを省略する場合がある問題を解決しました。
エクスポートジョブの実行: エクスポートジョブの完了時に System.ObjectDisposedException がまれに発生し、早期終了を防ぐことで対処されました。
HTTP 状態コードの更新: $reindex ジョブの作成時に無効なパラメーターの HTTP 状態コードが 400 に更新され、エラー処理が向上しました。
検索パラメーターのクリーンアップ: 削除 API 呼び出しでトリガーされたときにデータベース内の検索パラメーターを完全にクリーンアップし、不完全な削除に関連する問題に対処するための修正プログラムが実装されました。

2024 年 8 月

FHIR サービス

バグ修正 子タスクの処理中に大きなエクスポートで "完了" 状態が正しく表示されない問題に対処するための修正プログラムが実装されました。このソリューションには、これらの状態エラーの発生を軽減するための遅延が組み込まれており、エクスポートの信頼性が向上します。

2024 年 7 月

FHIR サービス

バグ修正

修正: SMART ユーザーとしてデータをエクスポートする SMART ユーザーとしてデータをエクスポートする場合、書き込みスコープが不要になりました。以前は、SMART ユーザーにデータをエクスポートするための "書き込み" 特権を付与する必要がありました。これは、より高い特権レベルを意味していました。 SMART ユーザーとしてエクスポートジョブを開始するには、ユーザーが RBAC の FHIR エクスポートロールのメンバーであることを確認し、SMART 臨床スコープの "読み取り" を要求します。

修正: ステータスコードを HTTP 500 から HTTP 400 に更新する パッチ操作中に、ペイロードが Parameter 以外のリソースの種類の更新を要求した場合、内部サーバーエラー (HTTP 500) が最初にスローされました。代わりに HTTP 400 エラーをスローするように更新されました。

2024 年 5 月

FHIR サービス

消去履歴操作の機能強化 消去履歴操作では、クエリパラメーター 'allowPartialSuccess' を使用して部分的な削除を実行できます。既定では、消去履歴操作は正常に完了するまで待機してからリソースを削除します。ただし、実行中にエラーが発生した場合、リソースの削除はロールバックされます。 'allowPartialSuccess' クエリパラメーターを使用すると、エラーが発生した場合にトランザクションがロールバックされないようにすることができます。

バグの修正

修正済み: 実行時間の長い要求の HTTP 状態コード。実行に 100 秒を超える時間がかかる FHIR 要求では、HTTP 500 ではなく HTTP 408 状態コードが返されます。
修正済み: バンドル内の履歴要求。修正前に、バンドル内の履歴要求から HTTP 状態コード 404 が返されました。

2024 年 3 月

Batch バンドルの並列化 Batch バンドルは、既定で FHIR サービスで順次実行されます。バンドル呼び出しでスループットを向上させるために、バッチバンドルの並列処理を有効にしました。

詳細情報:

バッチバンドルの並列化

バグ修正

修正済み: バンドル処理のパフォーマンスを向上させる。タスク実行メソッドが更新され、バンドル処理のパフォーマンスが向上します。 PR#3727 を参照してください。

2024 年 2 月

リソースのすべてのバージョン (履歴および論理的に削除された) のカウントを有効にします クエリパラメーター _summary=count および _count=0 をエンドポイント _historyに追加して、すべてのバージョン管理されたリソースの数を取得できます。この数には、論理的に削除されたリソースが含まれます。詳細については、「 history management」を参照してください。

エクスポート操作のスループットを向上させます "_isparallel" クエリパラメーターをエクスポート操作に追加して、そのスループットを向上させることができます。このパラメーターを使用すると、エクスポートの有効期間中に要求ユニットの消費量が増加する可能性があることに注意してください。詳細については、「 Export 操作クエリパラメーター」を参照してください。

Note

$export操作には既知の問題があり、その結果、状態が成功するとエクスポートが不完全になる可能性があります。 is_parallel フラグが使用されたときに問題が発生します。 2024 年 2 月 13 日以降、_isparallel クエリパラメーターで実行されたエクスポートジョブは、この問題の影響を受けます。

エクスポートされたファイル名と既定のストレージアカウントの名前名名の変更 この変更により、エクスポートされたファイル名は '{FHIR リソース名}-{Number}-{Number}.ndjson' の形式に従います。ファイルの順序は、データベース内のリソースの順序に対応するとは限りません。既定のストレージアカウント名が 'Export-{Number}' に更新されます。エクスポートされた個々のファイルに追加されるリソースの数に変更はありません。

パフォーマンスの向上 FHIR クエリの並列最適化は、HTTP ヘッダー "x-ms-query-latency-over-efficiency" を使用して有効にすることができます。クエリの実行中に最大コンカレンシーを実現するには、この値を true に設定する必要があります。詳細については、「 Batch バンドル」を参照してください。

2024 年 1 月

条件付き対話を使用したクエリの同時実行 条件付き操作は複雑でパフォーマンスが高い場合があります。条件付き対話に関連するクエリの待機時間を長くするには、要求ヘッダー x-conditionalquery-processing-logic を利用するオプションがあります。詳細については、「条件付き API 操作のパフォーマンスに関する考慮事項を参照してください。

2023 年 12 月

エクスポート操作に追加された機能 $exportバージョン管理されたリソースと論理的に削除されたリソースのエクスポートがサポートされるようになりました。詳細については、「 Export クエリパラメーター」を参照してください。

2023 年 11 月

プレビューで一括削除機能を使用できるようになりました '$bulk-delete' を使用すると、FHIR サーバーからリソースを非同期的に削除できます。一括削除操作は、システムレベルで実行することも、個々のリソースの種類に対して実行することもできます。詳細については、 bulk-delete 操作を参照してください。

一括削除操作は現在パブリックプレビュー段階にあります。詳細については、免責事項を参照してください。 [!INCLUDE パブリックプレビュー免責事項]

バグ修正: 改ページ位置と再割り当てを使用した FHIR クエリで、次のリンクを使用するとエラーが発生する

問題が解決され、継続トークンを使用する FHIR クエリで包含/再許可が発生し、例外が報告されなくなりました。修正プログラムの詳細については、 #3525 を参照してください。

2023 年 6月

バグ修正: Capability ステートメントのメタデータエンドポイント URL は相対 URL です FHIR 仕様に従って、capability ステートメントのメタデータエンドポイント URL は絶対 URL である必要があります。 FHIR の仕様の詳細については、 Capability ステートメントを参照してください。この fanix はこの問題に対処します。詳細については、 3265を参照してください。

2023年5月

SMART on FHIR : アプリケーション用の臨床スコープマッピングを修正

このバグ修正により、バックエンドアプリケーションで臨床スコープが正しく解釈されない問題が対処されます。詳細については、 #3250 を参照してください。

2023 年 4 月

カスタム検索パラメーターの読み込みに関連する一時的な問題を修正しました このバグは、エラーが発生した場合に FHIR サービスが最新の SearchParameter 状態を読み込まない問題に対処します。詳細については、 #3222 を参照してください。

2022 年 11 月

if-match ヘッダーと PATCH を使用してリソースが更新された場合に生成されるエラーを修正

バグが修正され、リソースが Etag ヘッダーと一致するとリソースが更新されるようになりました。詳細については、「 #2877|」を参照してください。

2022 年 5 月

エンハンスメント

拡張機能	関連情報
リソースのコンテンツが変更されていない場合、Azure API for FHIR はリソースの新しいバージョンを作成しません。	ユーザーが既存のリソースを更新し、meta.versionId または meta.lastUpdated のみが変更された場合は、VersionId と lastUpdated を更新せずに、既存のリソース情報と共に OK が返されます。詳細については、#2519 を参照してください。

2022 年 4 月

機能強化

機能強化	関連情報
FHIRPath Patch	FHIRPath Patch が機能として両方の Azure API for FHIR に追加されました。これにより、HL7 Web サイトで定義されている FHIRPath Patch が実装されます。
バンドル通知を Core に移動	Resource.Bundle 名前空間を Core に導入する場合、文字列リソースファイルへのリソース参照をより明示的にする必要がありました。詳細については、PR #2478 を参照してください。
バージョン管理された更新プログラムの無効なヘッダーの処理	バージョン管理ポリシーが "versioned-update" に設定されている場合、更新プログラムで要求の if-match ヘッダーに最新バージョンのリソースを指定する必要がありました。指定するバージョンは ETag 形式である必要があります。以前は、バージョンが無効であるか、または正しくない形式である場合、500 が返されていました。この更新プログラムでは、"400 無効な要求" を返すようになりました。詳細については、PR #2467 を参照してください。

バグの修正

バグ修正	関連情報
リソースパスにコアを追加	文字列リソースへのパスの一部が、バージョン管理ポリシーで誤って削除されていました。この修正プログラムでも、この問題が発生します。詳細については、PR #2470 を参照してください。
SQL のタイムアウトで 500 エラーが返される	SQL 要求がタイムアウトになると要求から 500 が返されるバグを修正しました。ログでは、429 エラーがフロントエンドから発生するのに対して、これは SQL からのタイムアウトです。詳細については、PR #2497 を参照してください。

2022 年 3 月

機能

機能	関連情報
FHIRPath Patch	この新機能を使用すると、FHIR リソースで FHIRPath Patch 操作を使用できます。詳細については、「Azure API for FHIR の FHIR REST API 機能」を参照してください。

バグの修正

バグ修正	関連情報
`_include` を含む検索でリソースが重複する	`_include` を含む検索で、単一のリソースが 2 回返される場合がある問題を修正しました。詳細については、PR #2448 を参照してください。
バージョン管理された更新プログラムでの PUT による作成	問題を修正しました。バージョン管理ポリシーが `versioned-update`するように構成されている場合、PUT を使用して作成するとエラーが発生しました。詳細については、PR #2457 を参照してください。
バージョン管理された更新プログラムの無効なヘッダーの処理	無効な `if-match` ヘッダーによって HTTP 500 エラーが発生する問題を修正しました。代わりに、"HTTP 無効な要求" が返されるようになりました。詳細については、PR #2467 を参照してください。

2022 年 2 月

機能と機能強化

機能強化関連情報

BundleHandler で "429 再試行" とログ記録を追加バンドルの処理中に 429 エラーが発生することがあります。 FHIR サービスでは、BundleHandler レイヤーで 429 を受信した場合、バンドルの処理を中止し、残りのリソースをスキップします。 (データストアレイヤーに存在する再試行に加えて) 別の再試行を追加しました。これは、リソースで 429 が発生するたびに 1 回実行されます。この機能強化の詳細については、PR #2400 を参照してください。

$convert-data と $de-id への課金 Azure API for FHIR のデータ変換および匿名化エクスポートの機能が一般公開されました。 Azure API for FHIR での $convert-data 操作と $de-id 操作の課金が有効になりました。課金メーターは、2022 年 3 月 1 日から有効になっています。

機能強化	関連情報
BundleHandler で "429 再試行" とログ記録を追加	バンドルの処理中に 429 エラーが発生することがあります。 FHIR サービスでは、BundleHandler レイヤーで 429 を受信した場合、バンドルの処理を中止し、残りのリソースをスキップします。 (データストアレイヤーに存在する再試行に加えて) 別の再試行を追加しました。これは、リソースで 429 が発生するたびに 1 回実行されます。この機能強化の詳細については、PR #2400 を参照してください。
`$convert-data` と `$de-id` への課金	Azure API for FHIR のデータ変換および匿名化エクスポートの機能が一般公開されました。 Azure API for FHIR での `$convert-data` 操作と `$de-id` 操作の課金が有効になりました。課金メーターは、2022 年 3 月 1 日から有効になっています。

バグの修正

バグ修正	関連情報
コンパートメント検索インデックスを更新	まれに、コンパートメント検索インデックスがリソースに設定されていないことがありました。すべてのデータが確実に返されるように、コンパートメント検索のメイン検索と同じインデックスを使用するようにしました。このコード修正の詳細については、PR #2430 を参照してください。

2021 年 12 月

機能と機能強化

機能強化	関連情報
`CapabilityStatement.name` に発行元を追加	機能ステートメントの `CapabilityStatement.name` で発行元がわかるようになりました。 #2319
要求メトリックへの匿名呼び出しにリンクされた `FhirOperation` をログ記録	認証を必要としない操作はログ記録されていませんでした。匿名呼び出しの `RequestMetrics` で `FhirOperation` 型を取得できるように機能を拡張しました。 #2295

バグの修正

バグ修正	関連情報
`SearchParameter` Code が null の場合の 500 エラーを修正	`SearchParameter` で Code が null 値の場合に 500 が発生する問題を修正しました。他の値と同様に、`InvalidResourceException` が発生するようになりました。 #2343
入力の JSON 本文が無効な場合、有効なメッセージを含む `BadRequestException` が返される	JSON 本文の要求が無効な場合、FHIR サーバーによって 500 エラーが返されていました。次に、500 ではなく有効なメッセージを含む `BadRequestException` を返します。 #2239
`_sort` で、`ChainedSearch` によって誤った結果が返されることがある	以前は、チェーン検索の `SearchOption` オブジェクトの並べ替えオプションがクリアされず、チェーン化されたサブ検索に渡されていました。これは無効です。これにより、結果があるのにそれを得られない可能性がありました。このバグは修正されました (#2347)。 GitHub のバグ #2344 に対処しました。

2021 年 11 月

機能と機能強化

機能強化	関連情報
Patient-everything リンクの処理	患者リンクを処理できるように Patient-everything 機能を拡張しました (#2305)。詳細については、FHIR の Patient-everything に関するページを参照してください。
機能ステートメントにソフトウェアの名前とバージョンを追加	機能ステートメントのソフトウェア名で、Azure API for FHIR または Azure Health Data Services のどちらを使用しているかを区別できるようになりました。ソフトウェアバージョンによって、管理サービスで現在使用されているオープンソースのリリースパッケージが指定されるようになりました (#2294)。対処: #1778 および #2241
500 秒をログに記録する `RequestMetric`	以前は、500 や不明または未処理のエラーは `RequestMetric` にログ記録されていませんでした。これらがログ記録されるようになりました (#2240)。詳細については、「Azure API for FHIR で診断ログを有効にする」を参照してください
後続トークンの圧縮	特定のインスタンスで、後続トークンが長すぎて、検索で次のリンクをたどることができないために 404 が発生していました。これを解決するために、後続トークンを圧縮して、サイズが確実に制限を下回るようにしました (#2279)。問題 #2250 に対処します。

バグの修正

バグ修正	関連情報
タイムゾーンを指定した日付が渡されたときの 500 エラーを解決しました。	これは、タイムゾーンを指定した日付が datetime フィールドに渡されたときの 500 エラーを修正します (#2270)。
メディアの種類が正しくないバンドルを投稿すると、500 エラーが返される問題を解決しました。	以前は、特定の文字を含むキーで検索を投稿すると、500 エラーが返されていました。これは、この問題を修正し (#2264)、#2148 に対処します。

2021 年 10 月

バグの修正

無限ループのバグ	関連情報
条件付き削除によって無限ループが発生する問題を修正しました。	#2269

2021 年 9 月

機能と機能強化

機能強化	関連情報
条件付きパッチのサポートを追加	条件付きパッチ
条件付きパッチ	#2163
条件付きパッチ監査イベントを追加しました。	#2213

バンドルで JSON パッチを許可	バンドルの JSON パッチ
パッチ要求を含む検索履歴バンドルを使用できます。	#2156
バイナリリソースを使用してバンドルで JSON パッチを有効にしました。	#2143

監査イベントの新しいサブタイプ	関連情報
監査の新しいサブタイプ OperationName を追加しました。	#2170

インデックス再作成の機能強化	関連情報
インデックス再作成パラメーターの境界を追加しました。	#2103
インデックス再作成パラメーターの境界に関するエラーメッセージを更新しました。	#2109
インデックス再作成カウントの最終チェックを追加しました。	#2099

バグの修正

バグ修正	関連情報
パッチ適用時の例外のキャッチ範囲を拡大しました。	#2192
STU3 の PATCH の履歴を修正しました。	#2177

カスタム検索のバグ	関連情報
カスタム検索パラメーターを使用してエラーに対処します。	#2133
検索パラメーターの削除中に再試行ロジックを追加しました。	#2121
SearchParameterDefinitionManager の検索オプションで最大項目数を設定します。	#2141
検索パラメーターに不正な式がある場合の例外を改善します。	#2157

503 エラーの再試行を解決	関連情報
Azure Cosmos DB からの 503 エラーを再試行します。	#2106
StoreProcedures からの 429 の処理を修正します。	#2165

解決した GitHub の問題	関連情報
CarePlan 医療デバイスのカスタム検索パラメーターを作成できない。	#2146
ID のない条件付き作成に関するエラーメッセージが不明確です。	#2168

IoT Connector for FHIR (プレビュー)

バグ修正	関連情報
壊れたリンクを修正しました。	Azure API for FHIR ポータルの Azure IoT コネクタドキュメントへのリンクを更新しました。

次のステップ

Azure Health Data Services (FHIR サービス、DICOM サービス、MedTech サービス) の機能とバグの修正については、以下を参照してください。

リリースノート: Azure Health Data Services

Note

FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。

次の方法で共有

リリース ノート: Azure API for FHIR

2024 年 11 月

FHIR サービス

2024 年 10 月

FHIR サービス

2024 年 8 月

FHIR サービス

2024 年 7 月

FHIR サービス

2024 年 5 月

FHIR サービス

2024 年 3 月

2024 年 2 月

2024 年 1 月

2023 年 12 月

2023 年 11 月

2023 年 6月

2023年5月

2023 年 4 月

2022 年 11 月

2022 年 5 月

エンハンスメント

2022 年 4 月

機能強化

バグの修正

2022 年 3 月

機能

バグの修正

2022 年 2 月

機能と機能強化

バグの修正

2021 年 12 月

機能と機能強化

バグの修正

2021 年 11 月

機能と機能強化

バグの修正

2021 年 10 月

バグの修正

2021 年 9 月

機能と機能強化

バグの修正

IoT Connector for FHIR (プレビュー)

次のステップ

フィードバック

その他のリソース

リリースノート: Azure API for FHIR