FHIR-adatok exportálása az Azure API for FHIR-ben
Fontos
Az Azure API for FHIR 2026. szeptember 30-án megszűnik. A migrálási stratégiákat követve válthat az Azure Health Data Services FHIR szolgáltatásra ezen a napon. Az Azure API for FHIR megszűnése miatt 2025. április 1-től nem lesz lehetőség új üzembe helyezéseket végezni. Az Azure Health Data Services FHIR szolgáltatás az Azure API for FHIR továbbfejlesztett verziója, amely lehetővé teszi az ügyfelek számára az FHIR, a DICOM és a MedTech szolgáltatások kezelését más Azure-szolgáltatásokba való integrációval.
A tömeges exportálás funkcióval az FHIR-kiszolgáló adatai az FHIR-specifikációknak megfelelően exportálhatók.
A $export használata előtt győződjön meg arról, hogy az Azure API for FHIR a használatára van konfigurálva. Az exportálási beállítások konfigurálásához és az Azure Storage-fiók létrehozásához tekintse meg az exportálási adatok konfigurálását ismertető oldalt.
Feljegyzés
Csak az Azure API for FHIR-hez tartozó előfizetésben lévő tárfiókok regisztrálhatók célként $export műveletekhez.
$export parancs használata
Miután konfigurálta az Azure API for FHIR-t az exportáláshoz, a $export paranccsal exportálhatja az adatokat a szolgáltatásból. Az adatok az exportálás konfigurálása során megadott tárfiókba lesznek tárolva. Ha meg szeretné tudni, hogyan hívhatja meg $export parancsot az FHIR-kiszolgálón, olvassa el a HL7 FHIR $export specifikációjának dokumentációját.
Rossz állapotban elakadt feladatok
Bizonyos helyzetekben előfordulhat, hogy egy feladat rossz állapotban ragad. Ez különösen akkor fordulhat elő, ha a tárfiók engedélyei nincsenek megfelelően beállítva. Az exportálás ellenőrzésének egyik módja, ha ellenőrzi a tárfiókot, ndjsonhogy a megfelelő tárolófájlok (vagyis ) vannak-e jelen. Ha nincsenek jelen, és nem futnak más exportálási feladatok, akkor előfordulhat, hogy az aktuális feladat rossz állapotban van. Az exportálási feladatot le kell mondania egy lemondási kérelem elküldésével, és próbálja meg újból lekérni a feladatot. A rossz állapotú exportálás alapértelmezett futási ideje 10 perc, mielőtt leáll, és új feladatra vált, vagy újra megkísérli az exportálást.
Az Azure API for FHIR a következő szinteken támogatja a $export:
- Rendszer:
GET https://<<FHIR service base URL>>/$export>> - Beteg:
GET https://<<FHIR service base URL>>/Patient/$export>> - Betegcsoport* – Az Azure API for FHIR exportálja az összes kapcsolódó erőforrást, de nem exportálja a csoport jellemzőit:
GET https://<<FHIR service base URL>>/Group/[ID]/$export>>
Az exportálás során az adatok több fájlban lesznek exportálva, amelyek mindegyike csak egy típusú erőforrásokat tartalmaz. Az egyes fájlokban lévő erőforrások száma korlátozott lesz. Az erőforrások maximális száma a rendszerteljesítményen alapul. Jelenleg 5000-ra van állítva, de változhat. Ennek az az eredménye, hogy egy erőforrástípushoz több fájlt is lekérhet. A fájlnevek a "resourceName-number-number.ndjson" formátumot követik. A fájlok sorrendje nem garantáltan megfelel az adatbázis erőforrásainak sorrendjének.
Feljegyzés
Patient/$export és Group/[ID]/$export exportálhat ismétlődő erőforrásokat, ha az erőforrás egynél több erőforrásból áll, vagy több csoportban található.
Emellett az exportálási állapotnak a hely fejléce által a sorban állás során visszaadott URL-címen keresztül történő ellenőrzése, valamint a tényleges exportálási feladat megszakítása is támogatott.
FHIR-adatok exportálása az ADLS Gen2-be
Jelenleg az ADLS Gen2-kompatibilis tárfiókok $export támogatjuk, az alábbi korlátozásokkal:
- A felhasználó nem tudja kihasználni a hierarchikus névterek előnyeit, de nincs mód arra, hogy a tárolón belül egy adott alkönyvtárba exportáljon. Csak egy adott tárolót célozhatunk meg (ahol minden exportáláshoz létrehozunk egy új mappát).
- Az exportálás befejezése után soha többé nem exportálunk semmit az adott mappába, mivel az ugyanabba a tárolóba irányuló későbbi exportálások egy újonnan létrehozott mappában lesznek.
Beállítások és paraméterek
Fejlécek
Két szükséges fejlécparamétert kell beállítani $export feladatokhoz. Az értékeket az aktuális $export specifikáció határozza meg.
- Elfogadás – alkalmazás/fhir+json
- Prefer – válasz-aszinkron
Paraméterek lekérdezése
Az Azure API for FHIR a következő lekérdezési paramétereket támogatja. Ezek a paraméterek nem kötelezőek:
| Lekérdezési paraméter | Az FHIR Specifikáció határozza meg? | Leírás |
|---|---|---|
| _outputFormat | Igen | Jelenleg három értéket támogat az FHIR-specifikációhoz való igazításhoz: application/fhir+ndjson, application/ndjson vagy ndjson. Minden exportálási feladat visszatér ndjson , és az átadott érték nincs hatással a kód viselkedésére. |
| _Mivel | Igen | Lehetővé teszi, hogy csak a megadott idő óta módosított erőforrásokat exportálja |
| _Típus | Igen | Itt adhatja meg, hogy mely típusú erőforrások legyenek belefoglalva. Például _type=A beteg csak a beteg erőforrásait adja vissza |
| _typefilter | Igen | A részletesebb szűrés igényléséhez használhatja a _typefilter és a _type paramétert. A _typeFilter paraméter értéke az FHIR-lekérdezések vesszővel tagolt listája, amely tovább korlátozza az eredményeket |
| _Konténer | Nem | Megadja azt a tárolót a konfigurált tárfiókon belül, ahol az adatokat exportálni kell. Ha meg van adva tároló, az adatok egy mappába lesznek exportálva ebbe a tárolóba. Ha a tároló nincs megadva, az adatok egy új tárolóba lesznek exportálva. |
| _Amíg | Nem | Lehetővé teszi, hogy csak a megadott időpontig módosított erőforrásokat exportálja. Ez a paraméter csak rendszerszintű exportálásra alkalmazható. Ebben az esetben, ha az előzményverziókat nem tiltották le vagy törölték, az exportálás garantálja a valódi pillanatkép-nézetet, vagy más szóval lehetővé teszi az időutazást. |
| includeAssociatedData | Nem | Lehetővé teszi az előzmények és a helyreállíthatóan törölt erőforrások exportálását. Ez a szűrő nem működik a "_typeFilter" lekérdezési paraméterrel. Adja meg az értéket "_history" értékként az előzmények és a nem legújabb verziójú erőforrások exportálásához. A helyreállíthatóan törölt erőforrások exportálásához adjon meg értéket "_deleted" értékként. |
| _isparallel | Nem | A "_isparallel" lekérdezési paraméter hozzáadható az exportálási művelethez az átviteli sebesség növelése érdekében. Az értéket igaz értékre kell állítani a párhuzamosítás engedélyezéséhez. Fontos megjegyezni, hogy ennek a paraméternek a használata a kérelemegységek fogyasztásának növekedését eredményezheti az exportálási élettartam alatt. |
Feljegyzés
A $export művelettel kapcsolatban ismert probléma merült fel, amely az állapot sikerességét eredményező, hiányos exportálást eredményezhet. A probléma a is_parallel jelző használatakor fordul elő. A 2024. február 13-tól _isparallel lekérdezési paraméterrel végrehajtott exportálási feladatokra ez a probléma hatással van.
Biztonságos exportálás az Azure Storage-ba
Az Azure API for FHIR támogatja a biztonságos exportálási műveletet. Válasszon az alábbi két lehetőség közül:
Az Azure API for FHIR microsoftos megbízható szolgáltatásként való elérésének engedélyezése az Azure Storage-fiókhoz.
Az Azure API for FHIR-hez társított meghatározott IP-címek hozzáférésének engedélyezése az Azure Storage-fiókhoz. Ez a beállítás két különböző konfigurációt biztosít attól függően, hogy a tárfiók ugyanabban a helyen van-e, mint az FHIR-hez készült Azure API- vagy más helyen.
Az Azure API for FHIR engedélyezése Microsoft Megbízható szolgáltatásként
Válasszon ki egy tárfiókot az Azure Portalon, majd válassza a Hálózatkezelés panelt. Válassza a Kijelölt hálózatok lehetőséget a Tűzfalak és virtuális hálózatok lap alatt.
Fontos
Győződjön meg arról, hogy hozzáférési engedélyt adott az Azure API for FHIR-hez tartozó tárfiókhoz a felügyelt identitás használatával. További információ: Exportálási beállítás konfigurálása és a tárfiók beállítása.
A Kivételek szakaszban jelölje be a Megbízható Microsoft-szolgáltatások engedélyezése a tárfiók eléréséhez és a beállítás mentéséhez jelölőnégyzetet.
Most már készen áll az FHIR-adatok biztonságos exportálására a tárfiókba. Vegye figyelembe, hogy a tárfiók a kiválasztott hálózatokon található, és nem érhető el nyilvánosan. A fájlok eléréséhez engedélyezheti és használhatja a tárfiók privát végpontjait, vagy engedélyezheti a tárfiók összes hálózatát rövid ideig.
Fontos
A felhasználói felület később frissül, így kiválaszthatja az Azure API for FHIR erőforrástípusát és egy adott szolgáltatáspéldányt.
Adott IP-címek hozzáférésének engedélyezése az Azure Storage-fiókhoz más Azure-régiókból
Az Azure Portalon nyissa meg az Azure Data Lake Storage Gen2-fiókot.
A bal oldali menüben válassza a Hálózatkezelés lehetőséget.
Válassza az Engedélyezve lehetőséget a kijelölt virtuális hálózatok és IP-címek közül.
A Tűzfal szakaszban, a Címtartomány mezőben adja meg az IP-címet. Adjon hozzá IP-tartományokat az internetről vagy a helyszíni hálózatokról való hozzáférés engedélyezéséhez. Az IP-címet az alábbi táblázatban találja annak az Azure-régiónak, ahol az FHIR szolgáltatás ki van építve.
Azure-régió Nyilvános IP-cím Kelet-Ausztrália 20.53.44.80 Közép-Kanada 20.48.192.84 Az USA középső régiója 52.182.208.31 USA keleti régiója 20.62.128.148 USA 2. keleti régiója 20.49.102.228 USA 2. keleti régiója – EUAP 20.39.26.254 Észak-Németország 51.116.51.33 Középnyugat-Németország 51.116.146.216 Kelet-Japán 20.191.160.26 Dél-Korea középső régiója 20.41.69.51 USA északi középső régiója 20.49.114.188 Észak-Európa 52.146.131.52 Dél-Afrika északi régiója 102.133.220.197 USA déli középső régiója 13.73.254.220 Délkelet-Ázsia 23.98.108.42 Észak-Svájc 51.107.60.95 Az Egyesült Királyság déli régiója 51.104.30.170 Az Egyesült Királyság nyugati régiója 51.137.164.94 USA nyugati középső régiója 52.150.156.44 Nyugat-Európa 20.61.98.66 USA 2. nyugati régiója 40.64.135.77
Adott IP-címek hozzáférésének engedélyezése az Azure Storage-fiókhoz ugyanabban a régióban
Az ugyanabban a régióban lévő IP-címek konfigurációs folyamata az előző eljáráshoz hasonlóan történik, azzal a kivételrel, hogy egy adott IP-címtartományt használ osztály nélküli tartományközi útválasztás (CIDR) formátumban (azaz 100.64.0.0/10). Meg kell adnia az IP-címtartományt (100.64.0.0–100.127.255.255), mert az FHIR szolgáltatás IP-címe minden műveletkéréskor le van foglalva.
Feljegyzés
A 10.0.2.0/24 tartományon belül használható magánhálózati IP-cím, de nincs garancia arra, hogy ilyen esetben a művelet sikeres lesz. A műveletkérés sikertelensége esetén újra próbálkozhat, de amíg a 100.64.0.0/10 tartományon belüli IP-címet nem használ, a kérés nem fog sikerülni.
Ez az IP-címtartományok hálózati viselkedése terv szerint történik. Másik lehetőségként konfigurálhatja a tárfiókot egy másik régióban.
Következő lépések
Ebben a cikkben megtanulta, hogyan exportálhat FHIR-erőforrásokat $export paranccsal. A következő lépésben megismerheti, hogyan exportálhatja az azonosított adatokat:
Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.