翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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..." としてフォーマットされていません無効な患者参照または グループに含まれていない患者
exportTypehl7.fhir.us.davinci-atr 以外の値_typeサポートされていないリソースタイプを含む パラメータ_typeexportType of hl7.fhir.us.davinci-atr に必要な最小タイプ (グループ、患者、カバレッジ) がない パラメータ
- リソース検証エラー
-
リクエストされたグループリソースが存在しません
グループに空のメンバーリストがある
グループメンバーが有効な患者リソースを参照していない
セキュリティと認可
標準の FHIR 認可メカニズムが適用されます
クライアントには、 グループおよび関連リソースに対する適切な読み取りアクセス許可が必要です。
出力場所に必要な S3 バケット書き込みアクセス許可
暗号化が指定されている場合に必要な KMS キーのアクセス許可
ベストプラクティス
リソースタイプの選択: エクスポートサイズと処理時間を最小限に抑えるために必要なリソースタイプのみをリクエストする
時間ベースのフィルタリング: 増分エクスポートに
_sinceパラメータを使用する患者のフィルタリング: 特定のメンバーのデータのみが必要な場合に
patientパラメータを使用します。ジョブのモニタリング: 大規模なエクスポートのジョブステータスを定期的にチェックする
エラー処理: 失敗したジョブに適切な再試行ロジックを実装する
制限
patientパラメータでは最大 512 人の患者を指定できますエクスポートはグループレベルのオペレーションのみに制限されます
は、属性関連のリソースタイプの事前定義されたセットのみをサポートします。
出力は常に NDJSON 形式です