View a markdown version of this page

Drift-Berichte verstehen - AWS HealthLake

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Drift-Berichte verstehen

Wenn die Drift-Erkennung aktiviert ist, schreibt der Bulk-Job einen aggregierten Bericht, der jobLevelDriftResult.json nach Ihrem Ausgabespeicherort benannt ist. In dem Bericht erfahren Sie, wie viele Ihrer Quelldaten das Profil tatsächlich erfasst hat und welche nicht, sodass Sie wissen, wo Sie Ihre Zuordnungen verbessern können.

Die Struktur des Berichts hängt vom Quellformat ab: C-CDA Berichte sind nach Dokumentabschnitten und Einträgen (identifiziert durch OIDs) organisiert, während CSV-Berichte nach Tabellen, Spalten und Zeilen angeordnet sind. Beide haben das gleiche Konzept der Deckungsrate (ein Bruchteil von 0,0 bis 1,0, wobei ein höherer Wert bedeutet, dass ein größerer Teil Ihrer Quelle erfasst wurde).

C-CDA Drift-Bericht

{ "jobId": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "profileId": "0f1e2d3c4b5a69788796a5b4c3d2e1f0", "profileVersion": 3, "timestamp": "2026-07-14T18:30:00Z", "filesProcessed": 500, "totalFilesFailed": 2, "avgSectionCoverageRate": 0.92, "avgEntryCoverageRate": 0.85, "avgOverallCoverageRate": 0.88, "avgResourceAccuracy": 0.97, "totalUnknownSections": 14, "totalUnknownEntries": 63, "documentOids": { "2.16.840.1.113883.10.20.22.1.2": 480 }, "unknownSectionOidCount": 2, "unknownSections": { "2.16.840.1.113883.10.20.22.2.14": 12 }, "unknownEntryOidCount": 5, "unknownEntries": { "2.16.840.1.113883.10.20.22.4.13": 40 }, "missingResources": { "2.16.840.1.113883.10.20.22.2.6.1": { "AllergyIntolerance": 8 } }, "perFileDrift": { "patient-001.xml": 0.95, "patient-002.xml": 0.61 } }

So wird es interpretiert

Fangen Sie mit den Deckungsraten an. Dabei handelt es sich um Durchschnittswerte für alle verarbeiteten Dateien, ausgedrückt als Bruch von 0,0 bis 1,0 (multipliziert mit 100 für einen Prozentsatz). Höher ist besser: Eine höhere Rate bedeutet, dass mehr Quelldaten in die FHIR-Ausgabe aufgenommen wurden.

Feld Bedeutung
avgOverallCoverageRate Die Schlagzeile. Der durchschnittliche Anteil der Quellinhalte (Abschnitte und Einträge), den das Profil FHIR zugeordnet hat. 0,88 bedeutet, dass ~ 88% Ihrer Quelldaten erfasst wurden.
avgSectionCoverageRate Durchschnittlicher Anteil der C-CDA Abschnitte (z. B. Probleme, Medikamente, Allergien), die zugeordnet wurden.
avgEntryCoverageRate Durchschnittlicher Anteil der einzelnen Einträge innerhalb von Abschnitten (z. B. ein einzelnes Problem oder ein einzelnes Medikament), die zugeordnet wurden.
avgResourceAccuracy Der durchschnittliche Anteil der erwarteten FHIR-Ressourcen ist der Anteil, der tatsächlich produziert wurde.

Finden Sie dann heraus, was verpasst wurde. Diese Felder verweisen Sie auf die spezifischen Zuordnungen, die hinzugefügt werden müssen:

Feld Bedeutung Vorgehensweise
unknownSections Eine Zuordnung der Quellabschnitt-OIDs, die das Profil nicht erkannt hat, und wie oft sie jeweils angezeigt wurden. Fügen Sie Zuordnungen für die Abschnitt-OIDs mit hoher Anzahl hinzu.
unknownEntries Eine Zuordnung der Quelleintrags-OIDs, die das Profil nicht erkannt hat, sowie deren Häufigkeit. Fügen Sie Zuordnungen für die Eintrags-OIDs mit hoher Anzahl hinzu.
missingResources Eine Zuordnung der Quell-OID → der FHIR-Ressourcentypen, die erwartet, aber nicht erzeugt wurden, mit Zählungen. Korrigieren Sie die Zuordnungen, die diese Ressourcen hätten generieren sollen.
totalUnknownSections / totalUnknownEntries Gesamtzahl der nicht zugewiesenen Abschnitte und Einträge im gesamten Job. Verwenden Sie es als schnelles Signal für die Angabe, wie viel noch übrig ist.
documentOids Eine Übersicht der C-CDA dokumentypischen OIDs, die im Job angezeigt wurden, und wie viele davon jeweils vorhanden sind. Bestätigt, welche Dokumenttypen Ihre Daten enthalten.

Priorisieren Sie nach Häufigkeit. Die Zählungen in unknownSectionsunknownEntries, und geben missingResources Aufschluss darüber, welche Lücken die meisten Datensätze betreffen. Eine OID, die 40 Mal erscheint, ist ein größerer Gewinn bei der Zuordnung als eine, die zweimal erscheint.

Sehen Sie sich bestimmte Dateien genauer an. perFileDriftordnet jede Quelldatei ihrer Gesamtabdeckungsrate zu. Sortiert nach den niedrigsten Werten, um die Dateien zu finden, die das Profil am schlechtesten verarbeitet hat: patient-002.xml Bei 0,61 lohnt es sich beispielsweise, sie zu überprüfen. Eine vollständige Aufschlüsselung pro Datei (welche spezifischen OIDs jede Datei verpasst hat) finden Sie in den einzelnen Berichten unter dem Ordner. driftDetectionPerFileResults/

Verbesserung der Reichweite

  1. Identifizieren Sie die Einträge mit der höchsten Häufigkeit in unknownSectionsunknownEntries, und. missingResources

  2. Verwenden Sie den Data Transformation AI-Agent (UpdateProfileWithAgent), um Zuordnungen für diese OIDs und Ressourcen hinzuzufügen: Sie können eine OID einfügen und den Agenten bitten, sie zuzuordnen.

  3. Veröffentlichen Sie eine neue Profilversion und führen Sie den Job erneut aus.

  4. Vergleichen Sie die neuen DatenavgOverallCoverageRate, um zu bestätigen, dass die Lücke geschlossen wurde.

CSV-Drift-Bericht

Bei CSV-Jobs ist der Bericht nach Tabellen (jede CSV-Datei ist eine Tabelle), Spalten und Zeilen angeordnet, nicht nach Abschnitten und OIDs.

{ "jobId": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "profileId": "0f1e2d3c4b5a69788796a5b4c3d2e1f0", "profileVersion": 3, "summary": { "totalTablesInProfile": 4, "totalTablesInInput": 5, "tablesProcessed": 4, "tablesUnmapped": 1, "totalColumnsInInput": 42, "columnsMapped": 35, "columnsUnmapped": 7, "totalRowsScanned": 120000, "rowsConvertedSuccessfully": 119850, "rowsFailedCustomerError": 140, "rowsFailedServerError": 10, "totalResourcesGenerated": 245000, "tablesCoverageRate": 0.80, "columnsCoverageRate": 0.83, "overallCoverageRate": 0.83 }, "unmappedTables": [ { "tableName": "billing", "fileName": "billing.csv", "reason": "No matching table declared in the mapping profile", "columns": ["invoice_id", "amount", "payer"] } ], "unmappedColumns": [ { "tableName": "patients", "columns": ["preferred_language", "ethnicity_detail"], "reason": "Present in CSV but not referenced by any field mapping" } ] }

So wird es interpretiert

Beginnen Sie mit der Zusammenfassung. Die Deckungsraten sind Bruchteile von 0,0 bis 1,0 (höher ist besser):

Feld Bedeutung
overallCoverageRate Die Überschriftennummer: Der Anteil aller Spalten in allen Eingabetabellen, die Ihr Profil tatsächlich verwendet. 0,83 bedeutet, dass ~ 83% Ihrer Quellspalten zugeordnet sind.
tablesCoverageRate Bruchteil Ihrer CSV-Eingabedateien (Tabellen), denen das Profil zuordnet (tablesProcessed/totalTablesInInput).
columnsCoverageRate Anteil der Spalten in den zugewiesenen Tabellen, auf die durch eine Feldzuordnung verwiesen wird.

Überprüfen Sie dann die Anzahl, um die Konversionsergebnisse zu verstehen:

Feld Bedeutung
totalTablesInInputvs tablesProcessed Wie viele Ihrer CSV-Dateien wurden tatsächlich verwendet und gefunden?
totalColumnsInInput / columnsMapped / columnsUnmapped Wie viele Quellspalten existieren, verwendet wurden und ignoriert wurden.
totalRowsScanned / rowsConvertedSuccessfully Wie viele Zeilen wurden gelesen oder erfolgreich konvertiert?
rowsFailedCustomerError / rowsFailedServerError Zeilen, die aufgrund von Datenqualitätsproblemen oder internen Fehlern ausgefallen sind.
totalResourcesGenerated Insgesamt produzierte FHIR-Ressourcen.

Finden Sie dann heraus, was verpasst wurde:

Feld Bedeutung Vorgehensweise
unmappedTables CSV-Dateien in Ihrer Eingabe, die das Profil nicht deklariert (mit dem Grund und den Spalten in dieser Datei). Fügen Sie eine Tabellenzuordnung hinzu, wenn diese Datei konvertiert werden soll.
unmappedColumns Pro Tabelle die Spalten, die in der CSV-Datei vorhanden sind, aber von keiner Feldzuweisung verwendet werden. Fügen Sie Feldzuordnungen für die Spalten hinzu, die Sie in der FHIR-Ausgabe haben möchten.

Verbesserung der Reichweite (beide Formate)

  1. Identifizieren Sie die Lücken mit den größten Auswirkungen: für C-CDA die Einträge mit der höchsten Häufigkeit inunknownSections/unknownEntries/missingResources; für CSV die Einträge inunmappedTables, unmappedColumns und Warnungen.

  2. Verwenden Sie den Data Transformation AI-Agenten (UpdateProfileWithAgent), um die fehlenden Zuordnungen hinzuzufügen: Sie können eine nicht zugeordnete OID (C-CDA) oder einen Spaltennamen (CSV) einfügen und den Agenten bitten, sie zuzuordnen.

  3. Veröffentlichen Sie eine neue Profilversion und führen Sie den Job erneut aus.

  4. Vergleichen Sie die neuen DatenoverallCoverageRate, um zu bestätigen, dass die Lücke geschlossen wurde.

Anmerkung

Die Drift-Erkennung meldet, welches Profil nicht zugeordnet wurde. Sie weist nicht auf einen Konvertierungsfehler hin. Quelldaten können absichtlich nicht zugeordnet werden, wenn sie für Ihren Anwendungsfall nicht relevant sind. Entscheiden Sie anhand des Berichts, was eine Zuordnung wert ist.