Note sulla versione 2024: Servizi dati di integrità di Azure
Questo articolo descrive funzionalità, miglioramenti e correzioni di bug rilasciati nel 2024 per il servizio FHIR®, il servizio DICOM® e il servizio MedTech in Servizi dati di integrità di Azure.
Ottobre 2024
Servizi per i dati sanitari di Azure
Servizio FHIR
Correzioni di bug
- Convalida dell'esportazione: è stato identificato un problema per cui le esportazioni sono state eseguite nonostante i parametri di ricerca non validi. Stiamo introducendo una modifica che impedisce le esportazioni in queste condizioni. Questa funzionalità è attualmente dietro un flag di convalida rigoroso e diventerà il comportamento predefinito il 30 ottobre o dopo il 30 ottobre.
- Inclusione di parametri di ricerca: è stato risolto un problema per cui altri parametri di ricerca (ad esempio,
_include
,_has
) non restituivano tutti i risultati previsti, a volte omettendo il collegamento successivo. - Esportazione dell'esecuzione del processo: una rara occorrenza di
System.ObjectDisposedException
durante il completamento del processo di esportazione è stata risolta impedendo le uscite premature. - Aggiornamento del codice di stato HTTP: il codice di stato HTTP per i parametri non validi durante
$reindex
la creazione del processo viene ora aggiornato a 400, garantendo una migliore gestione degli errori. - Pulizia dei parametri di ricerca: è stata implementata una correzione per garantire la pulizia completa dei parametri di ricerca nel database quando viene attivata con chiamate API di eliminazione, risolvendo i problemi relativi alle eliminazioni incomplete.
- Problema di ordinamento decrescente: è stato risolto un problema per cui le operazioni di ordinamento decrescente non restituivano risorse se il campo ordinato non aveva dati nel database, anche quando esistevano risorse pertinenti.
- Gestione degli errori di autenticazione: è stato aggiunto un nuovo blocco catch per gestire gli errori di autenticazione quando le richieste di importazione vengono eseguite con l'identità gestita disattivata.
Settembre 2024
Servizi per i dati sanitari di Azure
Servizio FHIR
Miglioramento dell'efficienza di esportazione
La funzionalità di esportazione è stata migliorata per ottimizzare l'utilizzo della memoria. Con questa modifica, il processo di esportazione esegue ora il push dei dati nell'archivio BLOB una risorsa alla volta, riducendo il consumo di memoria.
Agosto 2024
Servizi per i dati sanitari di Azure
Servizio FHIR
Gestione degli errori dell'operazione di importazione
- L'operazione di importazione restituisce un errore HTTP 400 quando una risorsa del parametro di ricerca viene inserita tramite il processo di importazione. Questa modifica è progettata per impedire che i parametri di ricerca vengano inseriti in uno stato non valido durante l'inserimento con un'operazione di importazione.
- L'operazione di importazione restituisce un codice di stato HTTP 400, anziché il codice di stato HTTP 500 precedente, nei casi in cui si verificano problemi di configurazione con l'account di archiviazione. Questo aggiornamento mira a migliorare la gestione degli errori associata alle identità gestite durante le operazioni di importazione.
Luglio 2024
Servizi per i dati sanitari di Azure
Servizio FHIR
Consentire la gestione delle date nei dati JSON come stringhe nell'operazione Convert-Data
È possibile che le date fornite all'interno dei dati JSON vengano restituite in un formato diverso da quello fornito. Durante la deserializzazione delle stringhe di payload JSON identificate come date vengono convertite in oggetti DateTime .NET. Questi oggetti vengono quindi convertiti di nuovo in stringhe prima di passare attraverso il motore modello Liquid. Questa conversione può causare la riformattazione del valore di data e rappresentato nel fuso orario locale del servizio FHIR.
La coercizione delle stringhe negli oggetti DateTime .NET può essere disabilitata usando il parametro jsonDeserializationTreatDatesAsStrings
booleano . Se impostato su true
, i dati forniti vengono considerati come stringa e non verranno modificati prima di essere forniti al motore Liquid.
Miglioramento dell'operazione di importazione
Il servizio FHIR consente ora l'inserimento di dati senza specificare una versione a livello di risorsa. L'ordine delle risorse viene mantenuto usando il valore lastUpdated. Questo miglioramento introduce il flag "allowNegativeVersions". Il flag di impostazione true consente al servizio FHIR di assegnare versioni negative per i record di risorse con un valore lastUpdated esplicito e nessuna versione specificata.
Correzioni di bug
- Correzione dell'inclusione di risorse eliminate soft quando si usa _security:not parametro di ricerca quando si usa il parametro _security:not search nelle operazioni di ricerca, gli ID per le risorse eliminate temporanea venivano inclusi nei risultati della ricerca. È stato risolto il problema in modo che le risorse eliminate temporaneo siano ora escluse dai risultati della ricerca.
- L'esportazione di dati come smart user export data as a SMART user non richiede più ambiti di scrittura. In precedenza, era necessario concedere privilegi di "scrittura" a un utente SMART per l'esportazione dei dati, che implicavano livelli di privilegi più elevati. Per avviare un processo di esportazione come utente SMART, assicurarsi che l'utente sia membro del ruolo di esportazione FHIR nel controllo degli accessi in base al ruolo e richieda l'ambito clinico SMART "read". Aggiornamento del codice di stato da HTTP 500 a HTTP 400
- Aggiornamento del codice di stato da HTTP 500 a HTTP 400 Durante un'operazione di patch, se il payload ha richiesto un aggiornamento per un tipo di risorsa diverso dal parametro, inizialmente è stato generato un errore interno del server (HTTP 500). È stato aggiornato per generare invece un errore HTTP 400.
Miglioramento delle prestazioni
L'ottimizzazione delle query viene aggiunta durante la ricerca di risorse FHIR con un intervallo di dati. Questa ottimizzazione delle query consente di eseguire query efficienti quando viene generata una CTE combinata.
Maggio 2024
Servizi per i dati sanitari di Azure
Servizio FHIR
Miglioramento della scalabilità per l'operazione di importazione
La logica di ridimensionamento per le operazioni di importazione è migliorata, consentendo l'esecuzione in parallelo di più processi. Questa modifica influisce sui log di controllo per l'operazione di importazione. I log di controllo per i singoli processi di importazione hanno più righe, con ogni riga corrispondente a un processo di elaborazione interno.
Correzioni di bug
- Correzione: codice di stato HTTP per le richieste con esecuzione prolungata. Le richieste FHIR che richiedono più di 100 secondi per l'esecuzione restituiscono un codice di stato HTTP 408 anziché HTTP 500.
- Correzione: richiesta di cronologia nel bundle. Prima della correzione, la richiesta di cronologia in un bundle ha restituito il codice di stato HTTP 404.
Convertitore FHIR autonomo (anteprima)
L'API del convertitore FHIR autonoma disponibile per l'anteprima è disaccoppiata dal servizio FHIR e inserita in un pacchetto come immagine contenitore (Docker). Oltre a consentire di convertire i dati dall'origine del record ai bundle FHIR R4, il convertitore FHIR offre:
- Conversione bidirezionale dei dati dall'origine del record ai bundle FHIR R4 e indietro. Ad esempio, il convertitore FHIR può convertire i dati dal formato FHIR R4 al formato HL7v2.
- Esperienza migliorata per la personalizzazione dei modelli Liquid predefiniti.
- Esempi che illustrano come creare una pipeline ETL (estrazione, trasformazione, caricamento) con Azure Data Factory (ADF).
Per implementare l'immagine del contenitore del convertitore FHIR, vedere il progetto GitHub del convertitore FHIR.
Aprile 2024
Servizio DICOM
Operazione upsert avanzata
L'operazione Upsert avanzata consente di caricare un'immagine DICOM nel server e sostituirla facilmente se esiste già. Prima di questo miglioramento, gli utenti dovevano eseguire un'operazione di eliminazione seguita da uno STOW-RS per ottenere lo stesso risultato. Con l'operazione Upsert migliorata, la gestione delle immagini DICOM è più efficiente e semplificata.
Archiviazione espansa per gli attributi necessari
Il servizio DICOM consente agli utenti di caricare file DICOM di dimensioni fino a 4 GB. Nessun singolo file DICOM o combinazione di file in una singola richiesta può superare questo limite.
Servizio FHIR
L'operazione di eliminazione bulk è disponibile a livello generale
L'operazione di eliminazione in blocco consente l'eliminazione di risorse FHIR in diversi livelli, consentendo alle organizzazioni sanitarie di rispettare i criteri di conservazione dei dati, fornendo al tempo stesso funzionalità di elaborazione asincrone. I vantaggi dell'operazione di eliminazione in blocco sono i seguenti:
- Eseguire l'eliminazione bulk a livelli diversi: l'operazione di eliminazione bulk consente di eliminare le risorse dal server FHIR in modo asincrono. È possibile eseguire l'eliminazione bulk a livelli diversi:
- Livello di sistema: abilita l'eliminazione delle risorse FHIR in tutti i tipi di risorse.
- Tipo di risorsa individuale: consente l'eliminazione di risorse FHIR specifiche.
- Personalizzabile: i parametri di query consentono di filtrare le risorse non elaborate per le eliminazioni mirate.
- Elaborazione asincrona: l'operazione è asincrona, fornendo un endpoint di polling per tenere traccia dello stato di avanzamento.
Altre informazioni:
Marzo 2024
Servizio DICOM
L'integrazione con Azure Data Lake Storage è disponibile a livello generale
L'integrazione di Azure Data Lake Storage per il servizio DICOM in Azure Health Data Services è disponibile a livello generale. Il servizio DICOM fornisce l'archiviazione su scala cloud per i dati di imaging medico usando lo standard DICOMweb. Grazie all'integrazione di Azure Data Lake Storage, le organizzazioni possono avere il controllo completo sui dati di imaging e aumentare la flessibilità per l'accesso e l'uso di tali dati tramite l'ecosistema di archiviazione di Azure e le API.
Usando Azure Data Lake Storage con il servizio DICOM, le organizzazioni possono:
- Abilitare l'accesso diretto ai dati di imaging medicali archiviati dal servizio DICOM usando le API di archiviazione di Azure e le API DICOMweb, offrendo maggiore flessibilità per l'accesso e l'uso dei dati.
- Aprire i dati di imaging medico fino all'intero ecosistema di strumenti per l'uso dell'archiviazione di Azure, tra cui AzCopy, Archiviazione di Azure Explorer e la libreria di spostamento dei dati.
- Sbloccare nuovi scenari di analisi e intelligenza artificiale/MACHINE usando i servizi che si integrano in modo nativo con Azure Data Lake Storage, tra cui Azure Synapse, Azure Databricks, Azure Machine Learning e Microsoft Fabric.
- Concedere controlli per gestire autorizzazioni di archiviazione, controlli di accesso, livelli e regole.
Altre informazioni:
- Gestire i dati di imaging medico con il servizio DICOM e Azure Data Lake Storage
- Distribuire il servizio DICOM con Azure Data Lake Storage
Servizio FHIR
Parallelizzazione bundle (GA)
I bundle vengono eseguiti serialmente nel servizio FHIR per impostazione predefinita. Per migliorare la velocità effettiva con le chiamate bundle, è stata abilitata l'elaborazione parallela.
Altre informazioni:
L'operazione di importazione accetta più tipi di risorse in un singolo file
L'operazione di importazione può avere il tipo di risorsa per ogni file di input nei parametri della richiesta. Con questa funzionalità di miglioramento, è possibile passare più tipi di risorse in un singolo file.
Correzioni di bug
Correzione: l'operazione di importazione inserisce le risorse con lo stesso tipo di risorsa e il valore del campo lastUpdated. Prima di questa modifica, le risorse eseguite in un batch con lo stesso tipo e
lastUpdated
lo stesso valore di campo non sono stati inseriti nel servizio FHIR. Questa correzione di bug risolve il problema. Vedere PR#3768.Correzione: ricerca FHIR con 3 o più parametri di ricerca personalizzati. Prima di questa correzione, una query di ricerca FHIR nella radice con tre o più parametri di ricerca personalizzati ha generato il codice di stato HTTP 504. Vedere PR#3701.
Correzione: migliorare le prestazioni per l'elaborazione del bundle. Aggiornamenti al metodo di esecuzione dell'attività, abilitando il miglioramento delle prestazioni di elaborazione dei bundle. Vedere PR#3727.
Febbraio 2024
Servizio FHIR
Il conteggio di tutte le versioni delle risorse è abilitato
Il parametro _summary=count
di query e _count=0
può essere aggiunto all'endpoint _history
per ottenere un conteggio di tutte le risorse con controllo delle versioni. Questo conteggio include risorse cronologiche e eliminate soft.
La ricerca revinclude può fare riferimento a tutte le risorse con carattere jolly
Il servizio FHIR supporta le ricerche con caratteri jolly con revinclude
. Aggiungere *.*
al parametro di query in una revinclude
query per indirizzare il servizio FHIR a fare riferimento a tutte le risorse mappate alla risorsa di origine.
Correzioni di bug
Correzione: migliorare il tempo di risposta delle query FHIR con miglioramenti delle prestazioni. Per migliorare le prestazioni, è possibile specificare un modificatore mancante per un parametro di ricerca usato per l'ordinamento. Vedere PR#3655.
Correzione: l'operazione di importazione rispetta l'inserimento di versioni di risorse non sequenziali. Prima di questa modifica, la modalità incrementale nell'operazione
import
presuppone che le versioni siano numeri interi sequenziali. Dopo questa correzione di bug, le versioni possono essere inserite in ordine non sequenziale. Vedere PR#3685.
Gennaio 2024
Servizio DICOM
Aggiornamento bulk dei file
L'operazione di aggiornamento bulk consente di modificare i metadati di creazione dell'immagine per più file archiviati nel servizio DICOM. Ad esempio, l'aggiornamento in blocco consente di modificare gli attributi DICOM per uno o più studi in un'unica operazione asincrona. È possibile usare un'API per eseguire aggiornamenti ai dati demografici dei pazienti ed evitare il costo di caricamenti ripetuti che richiedono molto tempo.
Oltre ai miglioramenti di efficienza, la funzionalità di aggiornamento in blocco mantiene un record delle modifiche nel feed di modifiche e rende persistenti le istanze originali e non modificate per il recupero futuro.
Altre informazioni:
Servizio FHIR
Parametri di ricerca selezionabili (anteprima)
La funzionalità dei parametri di ricerca selezionabile disponibile per l'anteprima consente di personalizzare e ottimizzare le ricerche sulle risorse FHIR. La funzionalità consente di scegliere quali parametri di ricerca predefiniti abilitare o disabilitare per il servizio FHIR. Abilitando solo i parametri di ricerca necessari, è possibile archiviare più risorse FHIR e migliorare potenzialmente le prestazioni delle query di ricerca FHIR.
Altre informazioni:
Integrazione del servizio FHIR con Azure Active Directory B2C
Le organizzazioni sanitarie possono usare il servizio FHIR in Azure Health Data Services con Azure Active Directory B2C (Azure AD B2C). Le organizzazioni ottengono un modo sicuro e pratico per concedere l'accesso al servizio FHIR con un controllo di accesso granulare per utenti o gruppi diversi, senza creare o venire account utente nel tenant Microsoft Entra ID dell'organizzazione. Con questa integrazione, le organizzazioni possono:
- Usare provider di identità aggiuntivi per autenticare e accedere alle risorse FHIR con ambiti SMART on FHIR.
- Gestire e personalizzare i diritti di accesso utente o le autorizzazioni con ambiti SMART on FHIR che supportano il controllo di accesso con granularità fine, i tipi di risorse FHIR e le interazioni e i privilegi sottostanti di un utente.
Contenuto correlato:
- Usare Azure Active Directory B2C per concedere l'accesso al servizio FHIR
- Configurare più provider di identità del servizio per il servizio FHIR
- Risolvere i problemi di configurazione del provider di identità per il servizio FHIR
- Abilitare SMART on FHIR per il servizio FHIR
- Esempio: Azure ONC (g)(10) SMART on FHIR
Richiedere fino a 100 TB di spazio di archiviazione
Il servizio FHIR può archiviare e scambiare grandi quantità di dati di integrità e ogni istanza del servizio FHIR ha un limite di archiviazione di 4 TB per impostazione predefinita. Se si dispone di più dati, è possibile chiedere a Microsoft di aumentare lo spazio di archiviazione fino a 100 TB per il servizio FHIR.
Con più spazio di archiviazione, le organizzazioni possono gestire set di dati di grandi dimensioni per abilitare scenari di analisi. Ad esempio, è possibile usare più spazio di archiviazione per gestire l'integrità della popolazione, condurre ricerche e ottenere nuove informazioni dai dati sanitari. Inoltre, più archiviazione consente ai clienti dell'API di Azure per FHIR di eseguire la migrazione al servizio FHIR in Servizi dati di integrità di Azure con dati con volumi elevati (superiori a 4 TB).
Per richiedere spazio di archiviazione maggiore di 4 TB, creare una richiesta di supporto nel portale di Azure e usare il tipo di problema Limite di servizio e sottoscrizione (quote).
Nota
A causa di un problema relativo alle metriche di fatturazione per l'archiviazione, i clienti che optano per più di 4 TB di capacità di archiviazione non verranno fatturati per l'archiviazione fino a quando il problema non viene risolto.