Condividi tramite

Usare Servizi per i dati sanitari di Azure - Esportazione dati nelle soluzioni per dati sanitari

  • Articolo

Nota

Questo contenuto è in fase di aggiornamento.

Servizi per i dati sanitari di Azure - Esportazione dati consente di esportare i dati FHIR (Fast Healthcare Interoperability Resources) in Fabric OneLake dal servizio FHIR di Servizi per i dati sanitari di Azure. Per altre informazioni sulla funzionalità e su come distribuirla e configurarla, vedi:

Eseguire la pipeline Servizi per i dati sanitari di Azure - Esportazione dati

Dopo aver completato i prerequisiti e i passaggi di distribuzione, puoi iniziare a inserire i dati FHIR dal servizio FHIR di Servizi per i dati sanitari di Azure e trasformarli attraverso i livelli dei lakehouse Bronze e Silver. Questa sezione fornisce indicazioni sull'uso del modello di inserimento BYOS (Bring Your Own Storage) per inserire i dati FHIR.

Nota

Il servizio FHIR di Servizi per i dati sanitari di Azure supporta FHIR R4 v4.0.1. Per altre informazioni sui formati FHIR supportati, vedi Considerazioni sull'utilizzo per l'inserimento di dati clinici.

Per inserire i dati, esegui la pipeline di dati healthcare#_msft_clinical_ahds_fhirservice_export. Il notebook healthcare#_msft_ahds_fhirservice_export esporta prima i dati dal servizio FHIR di Servizi per i dati sanitari di Azure al contenitore Azure Data Lake Storage Gen2 specificato. I notebook successivi, healthcare#_msft_fhir_ndjson_bronze_ingestion e healthcare#_msft_bronze_silver_flatten, elaborano ulteriormente i dati come descritto in Inserire dati clinici utilizzando Data foundation per il settore sanitario.

Il notebook healthcare#_msft_ahds_fhirservice_export esegue le azioni seguenti:

  • Recupera il tasto funzione dall'Azure Key Vault associato all'offerta di Azure Marketplace.
  • Usa questo tasto funzione per attivare la funzione Azure distribuita con l'offerta di Azure Marketplace.
  • Richiede un'esportazione in blocco dal servizio FHIR di Servizi per i dati sanitari di Azure usando l'URL del servizio FHIR dalla configurazione globale.
  • Esegue il polling del servizio FHIR per confermare il completamento dell'esportazione in blocco, riprovando fino a quando non viene raggiunto uno stato di esito positivo o la soglia del numero massimo di giorni di polling.

Al termine dell'esportazione in blocco, la pipeline esegue in sequenza i notebook healthcare#_msft_fhir_ndjson_bronze_ingestion e healthcare#_msft_bronze_silver_flatten per trasformare e caricare i dati.

Raccomandazioni sulla sicurezza

Dopo aver distribuito l'offerta di Azure Marketplace per le soluzioni per dati sanitari in Microsoft Fabric, prendi in considerazione le seguenti raccomandazioni sulla sicurezza:

Risolvere i problemi relativi a Servizi per i dati sanitari di Azure - Esportazione dati

Questa sezione descrive i problemi o gli errori comuni che si possono verificare quando si usa la funzionalità Servizi per i dati sanitari di Azure - Esportazione dati e fornisce i passaggi per la risoluzione.

Risolvere gli errori di autorizzazione con il notebook di esportazione FHIR

Quando si esegue il notebook di esportazione FHIR healthcare#_msft_ahds_fhirservice_export, è possibile che venga visualizzato un errore HTTP 401: non autorizzato se non sono state assegnate le autorizzazioni necessarie all'app per le funzioni di Azure o al server FHIR.

Assicurati di assegnare il ruolo Esportatore dati FHIR all'app per le funzioni nel servizio FHIR e il ruolo Collaboratore dati BLOB di archiviazione al servizio FHIR nell'account di archiviazione di esportazione configurato.

Per altre informazioni, vedi Distribuire l'offerta di Azure Marketplace e configurare le risorse.

Risolvere gli errori di conflitto con il notebook di esportazione FHIR

Quando esegui il notebook di esportazione FHIR healthcare#_msft_ahds_fhirservice_export, a volte è possibile che venga visualizzato un errore HTTP 409: conflitto.

Screenshot del messaggio di errore.

L'app per le funzioni Azure è configurata per eseguire una sola istanza di esportazione in qualsiasi momento. Un errore HTTP 409 significa che è già in esecuzione un'altra operazione di esportazione. Attendi fino al termine, quindi attiva un'altra esportazione.

Monitorare i registri dell'app per le funzioni con Log Analytics di Azure

È possibile monitorare i log del servizio dell'app per le funzioni di esportazione nell'area di lavoro Log Analytics distribuita nel gruppo di risorse Azure. Di seguito è riportata una query Kusto di esempio per visualizzare le tracce dell'app per le funzioni:

AppTraces
| where AppRoleName startswith "msft-func-datamanager-export"