リリース ノート: Azure API for FHIR
重要
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 年 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できます。 この数には、論理的に削除されたリソースが含まれます。 詳細については、履歴管理を参照してください。
エクスポート操作 のスループットを向上させる "_isparallel" クエリ パラメーターをエクスポート操作に追加して、そのスループットを向上させることができます。 このパラメーターを使用すると、エクスポートの有効期間中に要求ユニットの消費量が増加する可能性があることに注意してください。 詳細については、「エクスポート操作のクエリ パラメーター」を参照してください。
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操作 に追加された追加機能で、バージョン管理されたリソースと論理的に削除されたリソースのエクスポートがサポートされるようになりました。 詳細については、「クエリ パラメーターのエクスポート」を参照してください。
2023 年 11 月
プレビュー の '$bulk-delete' で一括削除機能を使用できるようになりました。これにより、FHIR サーバーからリソースを非同期的に削除できます。 一括削除操作は、システム レベルで実行することも、個々のリソースの種類に対して実行することもできます。 詳細については、「一括削除操作」を参照してください。
一括削除操作は現在パブリック プレビュー段階にあります。 詳細については、免責事項を参照してください。 [!INCLUDE パブリック プレビュー免責事項]
バグ修正: 改ページ位置と再割り当てを使用した FHIR クエリで、次のリンクを使用するとエラーが発生する
問題が解決され、継続トークンを使用する FHIR クエリで包含/再許可が発生し、例外が報告されなくなりました。 修正プログラムの詳細については、#3525 を参照してください。
2023 年 6月
バグ修正: Capability ステートメントのメタデータ エンドポイント URL は FHIR 仕様ごとの相対 URL であり、capability ステートメントのメタデータ エンドポイント URL は絶対 URL である必要があります。 FHIR の仕様の詳細については、「機能ステートメント」を参照してください。 この 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 による作成 | PUT で作成された問題を修正しました。バージョン管理ポリシーが構成 versioned-updateされている場合にエラーが発生しました。 詳細については、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 日から有効になっています。 |
バグの修正
| バグ修正 | 関連情報 |
|---|---|
| コンパートメント検索インデックスを更新 | まれに、コンパートメント検索インデックスがリソースに設定されていないことがありました。 すべてのデータが確実に返されるように、コンパートメント検索のメイン検索と同じインデックスを使用するようにしました。 このコード修正の詳細については、PR #2430 を参照してください。 |
2021 年 12 月
機能と機能強化
| 機能強化 | 関連情報 |
|---|---|
CapabiilityStatement.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 サービス) の機能とバグの修正については、以下を参照してください。
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示