FHIR サービスを開始する
この記事では、Azure Health Data Services で FHIR® サービスを開始するための基本的な手順について説明します。
前提条件として、Azure リソース グループを作成して Azure リソースをデプロイするには、Azure サブスクリプションとアクセス許可が必要です。 すべての手順に従うことも、既存の環境がある場合は一部をスキップすることもできます。 また、すべての手順を組み合わせて、PowerShell、Azure CLI、REST API のスクリプトで実行することもきます。
Azure サブスクリプションでワークスペースを作成する
Azure portal から、または PowerShell、Azure CLI、REST API を使って、ワークスペースを作成します。 Azure Health Data Services のサンプルからスクリプトを見つけることができます。
Note
ワークスペースの数と、各 Azure サブスクリプションで作成できる FHIR サービス インスタンスの数には制限があります。
ワークスペースに FHIR サービスを作成する
FHIR サービス インスタンスは、Azure portal から作成することも、PowerShell、Azure CLI、REST API を使用して作成することもできます。 Azure Health Data Services のサンプルからスクリプトを見つけることができます。
必要に応じて、ワークスペースに DICOM サービス と MedTech サービス を作成できます。
FHIR サービスにアクセスする
FHIR サービスは、無効にできない Microsoft Entra ID によって保護されます。 サービス API にアクセスするには、Microsoft Entra ID でクライアント アプリケーション (サービス プリンシパルとも呼ばれます) を作成し、それに適切なアクセス許可を付与する必要があります。
クライアント アプリケーションを登録する
クライアント アプリケーションは、Azure portal から作成または登録することも、PowerShell と Azure CLI スクリプトを使用して登録することもできます。 このクライアント アプリケーションは、1 つ以上の FHIR サービス インスタンスに使用できます。 また、Azure Health Data Services の他のサービスにも使用できます。
クライアント アプリケーションが証明書またはクライアント シークレットで作成されている場合は、有効期限が切れる前に証明書またはクライアント シークレットを更新し、アプリケーションのクライアント資格情報を置き換えてください。
クライアント アプリケーションは削除できます。 クライアント アプリケーションを削除する前に、運用環境、開発環境、テスト環境、または品質保証 (QA) 環境で使用されていないことを確認します。
アクセス許可を付与する
アクセス許可を付与したりロールを割り当てたりするには、Azure portal、または PowerShell と Azure CLI のスクリプトを使用します。
作成、読み取り、更新、および削除 (CRUD) トランザクションを実行する
アプリケーション内で、または Postman、REST Client、cURL などのツールを使って、FHIR サービスに対する作成、読み取り (検索)、更新、削除 (CRUD) トランザクションを実行できます。 FHIR サービスは既定で保護されているため、アクセス トークンを取得し、それをトランザクション要求に含める必要があります。
アクセス トークンを取得する
Microsoft Entra アクセス トークンを取得するには、PowerShell、Azure CLI、REST CCI、または .NET SDK を使用します。 詳細については、「アクセス トークンを取得する」を参照してください。
既存のツールを使用してアクセスする
データの読み込み
データを直接読み込むには、FHIR サービスに対して POST メソッドまたは PUT メソッドを使用します。 データを一括読み込みするために、$import 操作を使用できます。 詳細については、インポート操作に関するページを参照してください。
CMS、検索、プロファイル検証、インデックス再作成
相互運用性と患者アクセス、検索、プロファイル検証、インデックス再作成の詳細については、FHIR サービス のドキュメントを 参照してください。
データのエクスポート
必要に応じて、($export) データをエクスポートして Azure Storage し、分析または機械学習プロジェクトで使用できます。 "そのまま" の状態で、または ndjson 形式で匿名化して、データをエクスポートできます。
データの変換
必要に応じて、HL7 v2 データおよびその他の形式を FHIR に変換できます。
Power BI ダッシュボードでの FHIR データの使用
必要に応じて、FHIR データを使用して Power BI ダッシュボード レポートを作成できます。
次のステップ
Azure Health Data Services に FHIR サービスをデプロイする
Note
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。