HealthLake の FHIR R4 $davinci-data-exportオペレーション - AWS HealthLake

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

HealthLake の FHIR R4 $davinci-data-exportオペレーション

$davinci-data-export オペレーションは、メンバー属性リストデータのエクスポートを有効にする非同期 FHIR オペレーションです AWS HealthLake。このオペレーションは、DaVinci メンバー属性 (ATR) リスト実装ガイドの要件を満たすように特別に設計された、標準の FHIR $exportオペレーションの特殊なバージョンです。

主な機能

  • 非同期処理: 標準の FHIR 非同期リクエストパターンに従います

  • グループレベルのエクスポート: 特定の属性リスト (グループ) 内のメンバーのデータをエクスポートします。

  • 特殊なリソース処理: 属性関連のリソースに焦点を当てる

  • 柔軟なフィルタリング: 患者、リソースタイプ、時間範囲によるフィルタリングをサポート

  • NDJSON 出力: データを改行区切りの JSON 形式で提供します

オペレーションエンドポイント

GET [base]/Group/[id]/$davinci-data-export POST [base]/Group/[id]/$davinci-data-export

リクエストパラメーター

パラメータ カーディナリティ 説明
患者 0..* データをエクスポートする特定のメンバー。省略すると、グループ内のすべてのメンバーがエクスポートされます。
_type 0..1 エクスポートする FHIR リソースタイプのカンマ区切りリスト
以降 0..1 この日付/時刻以降に更新されたリソースのみを含める
exportType 0..1 実行するエクスポートのタイプ (デフォルト: hl7.fhir.us.davinci-atr)

サポートされているリソースタイプ

_type パラメータを使用する場合、次のリソースタイプのみがサポートされます。

  • Group

  • 患者

  • カバレッジ

  • RelatedPerson

  • プラクティショナー

  • PractitionerRole

  • 組織

  • ロケーション

リクエスト例

エクスポートジョブの開始

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr or POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr Content-Type: application/json { "DataAccessRoleArn": "arn:aws:iam::444455556666:role/your-healthlake-service-role", "JobName": "attribution-export-job", "OutputDataConfig": { "S3Configuration": { "S3Uri": "s3://your-export-bucket/EXPORT-JOB", "KmsKeyId": "arn:aws:kms:region:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab" } } }

レスポンス例

{ "datastoreId": "eaee622d8406b41eb86c0f4741201ff9", "jobStatus": "SUBMITTED", "jobId": "48d7b91dae4a64d00d54b70862f33f61" }

リソース関係

オペレーションは、メンバー属性リスト内の関係に基づいてリソースをエクスポートします。

Group (Attribution List) ├── Patient (Members) ├── Coverage → RelatedPerson (Subscribers) ├── Practitioner (Attributed Providers) ├── PractitionerRole → Location └── Organization (Attributed Providers)

リソースソース

[リソース] ソースの場所 説明
患者 Group.member.entity 属性リストのメンバーである患者
カバレッジ Group.member.extension:coverageReference 患者メンバーシップにつながるカバレッジ
組織 Group.member.extension:attributedProvider Organizations の患者の属性
プラクティショナー Group.member.extension:attributedProvider 個々のプラクティショナーの患者の属性
PractitionerRole Group.member.extension:attributedProvider 患者が属するプラクティショナーロール
RelatedPerson Coverage.subscriber カバレッジのサブスクライバー
ロケーション PractitionerRole.location 実務者ロールに関連付けられた場所
Group 入力エンドポイント 属性リスト自体

ジョブ管理

ジョブのステータスを確認する

GET [base]/export/[job-id]

ジョブをキャンセルする

DELETE [base]/export/[job-id]

ジョブのライフサイクル

  • SUBMITTED - ジョブが受信およびキューに入れられました

  • IN_PROGRESS - ジョブはアクティブに処理中です

  • COMPLETED - ジョブが正常に終了し、ダウンロード可能なファイル

  • FAILED - ジョブでエラーが発生しました

[Output Format] (出力形式)

  • ファイル形式: NDJSON (Newline Delimited JSON)

  • File Organization: リソースタイプごとにファイルを区切ります。

  • ファイル拡張子: .ndjson

  • 場所: 指定された S3 バケットとパス

エラー処理

オペレーションは、以下の条件で HTTP 400 Bad Request with an OperationOutcome を返します。

認可エラー
  • データアクセスのアクセス許可が無効または不十分

  • S3 バケットアクセスの問題

  • KMS キーアクセスの問題

パラメータ検証エラー
  • patient パラメータが「"/id,"/id..." としてフォーマットされていません

  • 無効な患者参照または グループに含まれていない患者

  • exportType hl7.fhir.us.davinci-atr 以外の値

  • _type サポートされていないリソースタイプを含む パラメータ

  • _type exportType of hl7.fhir.us.davinci-atr に必要な最小タイプ (グループ、患者、カバレッジ) がない パラメータ

リソース検証エラー
  • リクエストされたグループリソースが存在しません

  • グループに空のメンバーリストがある

  • グループメンバーが有効な患者リソースを参照していない

セキュリティと認可

  • 標準の FHIR 認可メカニズムが適用されます

  • クライアントには、 グループおよび関連リソースに対する適切な読み取りアクセス許可が必要です。

  • 出力場所に必要な S3 バケット書き込みアクセス許可

  • 暗号化が指定されている場合に必要な KMS キーのアクセス許可

ベストプラクティス

  • リソースタイプの選択: エクスポートサイズと処理時間を最小限に抑えるために必要なリソースタイプのみをリクエストする

  • 時間ベースのフィルタリング: 増分エクスポートに _sinceパラメータを使用する

  • 患者のフィルタリング: 特定のメンバーのデータのみが必要な場合に patientパラメータを使用します。

  • ジョブのモニタリング: 大規模なエクスポートのジョブステータスを定期的にチェックする

  • エラー処理: 失敗したジョブに適切な再試行ロジックを実装する

制限

  • patient パラメータでは最大 512 人の患者を指定できます

  • エクスポートはグループレベルのオペレーションのみに制限されます

  • は、属性関連のリソースタイプの事前定義されたセットのみをサポートします。

  • 出力は常に NDJSON 形式です