医療データ ソリューションで Azure Health Data Services - データ エクスポートを使用する
注意
このコンテンツは現在更新中です。
Azure Health Data Services - データ エクスポートは、高速ヘルスケア相互運用性リソース (FHIR) データを Azure Health Data Services FHIR サービスから Fabric OneLake に取り込むのに役立ちます。 この機能の詳細と、その展開と構成の方法については、以下を参照してください:
Azure Health Data Services - データ エクスポート パイプラインを実行する
前提条件と展開手順を完了したら、Azure Health Data Services FHIR サービスから FHIR データの取り込みを開始し、ブロンズ レイヤーとシルバー レイクハウス レイヤーを介して変換できます。 このセクションでは、Bring Your Own Storage (BYOS) インジェスト パターン を使用して FHIR データを取り込むためのガイダンスを提供します。
注意
Azure Health Data Services FHIR サービスは、FHIR R4 v4.0.1 をサポートしています。 サポートされている FHIR 形式の詳細については、臨床データを取り込むための使用上の考慮事項 を参照してください。
データを取り込むには、healthcare#_msft_clinical_ahds_fhirservice_export データ パイプラインを実行します。 healthcare#_msft_ahds_fhirservice_export ノートブックは、最初に Azure Health Data Services FHIR サービスから指定された Azure Data Lake Storage Gen2 コンテナーにデータをエクスポートします。 後続のノートブックの healthcare#_msft_fhir_ndjson_bronze_ingestion と healthcare#_msft_bronze_silver_flatten は、医療データ ファンデーションを使用して臨床データを取り込む で説明されているように、データをさらに処理します。
healthcare#_msft_ahds_fhirservice_export ノートブックは、次のアクションを実行します。
- Azure Marketplace オファーに関連付けられている Azure Key Vault からファンクション キーを取得します。
- このファンクション キーを使用して、Azure Marketplace オファーで展開された Azure Function をトリガーします。
- グローバル構成の FHIR サービス URL を使用して、Azure Health Data Services FHIR サービスからの一括エクスポートを要求します。
- FHIR サービスをポーリングして一括エクスポートの完了を確認し、成功状態または最大ポーリング日数のしきい値に達するまで再試行します。
一括エクスポートが完了すると、パイプラインは healthcare#_msft_fhir_ndjson_bronze_ingestion および healthcare#_msft_bronze_silver_flatten ノートブックを順番に実行し、データを変換して読み込みます。
セキュリティ レコメンデーション
Microsoft Fabric の医療データ ソリューション向けの Azure Marketplace オファーを展開したら、次のセキュリティ レコメンデーションを検討してください。
Azure Key Vault へのパブリック アクセスを無効にします。
Azure Functions アクセス キー のローテーションに関するベスト プラクティスに従います。
Shared Access Signature (SAS) の代わりに OneLake プライベート エンドポイント のマネージド ID を使用します。
Azure Health Data Services - データ エクスポートのトラブルシューティング
このセクションでは、Azure Health Data Services - データ エクスポート機能の使用時に発生する可能性がある一般的な問題やエラーの概要を示し、解決手順について説明します。
FHIR エクスポート ノートブックで認証エラーを解決する
FHIR エクスポート ノートブック healthcare#_msft_ahds_fhirservice_export の実行時に、Azure 関数アプリまたは FHIR サーバーに必要なアクセス許可を割り当てていない場合、HTTP 401: 未承認 エラーが表示されることがあります。
FHIR データ エクスポーター ロールを FHIR サービスの関数アプリに割り当て、Storage Blob データ共同作成者 ロールを構成されたエクスポート ストレージ アカウントの FHIR サービスに割り当ててください。
詳細については、Azure Marketplace オファーの展開とリソースの設定 を参照してください。
FHIR エクスポート ノートブックで競合エラーを解決する
FHIR エクスポートノートブック healthcare#_msft_ahds_fhirservice_export の実行時に、HTTP 409: 競合 エラーが表示される場合があります。
Azure 関数アプリは、どの時点でもエクスポートのインスタンスを 1 つだけ実行するように構成されています。 HTTP 409 エラーは、別のエクスポート操作が既に実行中であることを意味します。 完了するまで待ってから、別のエクスポートをトリガーしてください。
Azure Log Analytics で関数アプリのログを監視する
エクスポート関数アプリ サービスのログは、Azure リソース グループに展開された Log Analytics ワークスペースで監視できます。 関数アプリのトレースを表示するためのサンプル Kusto クエリを次に示します。
AppTraces
| where AppRoleName startswith "msft-func-datamanager-export"