Questa pagina descrive come creare, modificare, visualizzare, elencare ed eliminare i set di dati. Dopo aver creato un set di dati, puoi creare datastore che contengono cartelle cliniche elettroniche e dati di imaging medico, deidentificare il set di dati e altro ancora.
Prima di iniziare
Consulta il modello di dati dell'API Cloud Healthcare.
Crea un set di dati
Gli esempi riportati di seguito mostrano come creare un set di dati.
Console
Nella console Google Cloud, vai alla pagina Browser.
Fai clic su add_box Crea set di dati. Viene visualizzata la pagina Proprietà set di dati.
Nel campo Nome, inserisci un identificatore per il set di dati, rispettando i requisiti relativi alle dimensioni e ai caratteri consentiti per i set di dati.
Seleziona uno dei seguenti tipi di località:
Regione. Il set di dati risiede in modo permanente in un'area geografica Google Cloud. Dopo aver selezionato questa opzione, digita o seleziona una località nel campo Regione.
Più regioni. Il set di dati risiede in modo permanente in una posizione che si estende su più regioni Google Cloud. Dopo aver selezionato questa opzione, digita o seleziona una località multiregionale nel campo Più regioni.
Fai clic su Crea. Viene visualizzata la pagina Browser. Il nuovo set di dati viene visualizzato nell'elenco dei set di dati.
gcloud
Esegui il comando gcloud healthcare datasets create
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: una posizione supportata per il set di datiDATASET_ID
: un identificatore soggetto ai requisiti relativi alle dimensioni e ai caratteri consentiti del set di dati
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare datasets create DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets create DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets create DATASET_ID ^ --location=LOCATION
Dovresti ricevere una risposta simile alla seguente:
Create request issued for: [DATASET_ID] Created dataset [DATASET_ID].
REST
Crea il set di dati utilizzando il metodo
projects.locations.datasets.create
.Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: una posizione supportata per il set di datiDATASET_ID
: un identificatore soggetto ai requisiti relativi alle dimensioni e ai caratteri consentiti del set di dati
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID"PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID" | Select-Object -Expand ContentExplorer API
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
OPERATION_ID
. Questo valore ti servirà nel passaggio successivo.Recupera lo stato dell'operazione a lunga esecuzione utilizzando il metodo
projects.locations.datasets.operations.get
.Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di datiOPERATION_ID
: l'ID restituito dall'operazione a lunga esecuzione
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentExplorer API
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
"done": true
, l'operazione a lunga esecuzione è terminata.
Go
Java
Node.js
Python
Modificare un set di dati
Gli esempi riportati di seguito mostrano come modificare un set di dati.
Console
La console Google Cloud non supporta la modifica di un set di dati. Utilizza invece l'interfaccia a Google Cloud CLI o l'API REST.
gcloud
Esegui il comando gcloud healthcare datasets update
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di datiTIME_ZONE
: un fuso orario supportato, ad esempioUTC
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare datasets update DATASET_ID \ --location=LOCATION \ --time-zone=TIME_ZONE
Windows (PowerShell)
gcloud healthcare datasets update DATASET_ID ` --location=LOCATION ` --time-zone=TIME_ZONE
Windows (cmd.exe)
gcloud healthcare datasets update DATASET_ID ^ --location=LOCATION ^ --time-zone=TIME_ZONE
Dovresti ricevere una risposta simile alla seguente:
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Utilizza il metodo projects.locations.datasets.patch
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di datiTIME_ZONE
: un fuso orario supportato, ad esempioUTC
Corpo JSON della richiesta:
{ "timeZone": "TIME_ZONE" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Ottieni dettagli del set di dati
Gli esempi riportati di seguito mostrano come recuperare i dettagli di un set di dati.
Console
Nella console Google Cloud, vai alla pagina Browser.
Seleziona il set di dati. Viene visualizzata la pagina Set di dati e i datastore nel set di dati.
gcloud
Esegui il comando
gcloud healthcare datasets describe
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di dati
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare datasets describe DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets describe DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets describe DATASET_ID ^ --location=LOCATION
Dovresti ricevere una risposta simile alla seguente:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Utilizza il metodo projects.locations.datasets.get
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di dati
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Elenca set di dati
Gli esempi riportati di seguito mostrano come elencare i set di dati nel progetto.
Console
Nella console Google Cloud, vai alla pagina Browser.
gcloud
Esegui il comando
gcloud healthcare datasets list
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di dati
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare datasets list --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets list --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets list --location=LOCATION
Dovresti ricevere una risposta simile alla seguente:
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
Utilizza il metodo projects.locations.datasets.list
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di dati
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Eliminazione di un set di dati
Gli esempi riportati di seguito mostrano come eliminare un set di dati.
Console
Nella console Google Cloud, vai alla pagina Browser.
Nella stessa riga del set di dati, fai clic sull'opzione
Azioni e poi seleziona Elimina.Nella finestra di dialogo di conferma, inserisci l'ID set di dati e fai clic su Elimina.
gcloud
Esegui il comando
gcloud healthcare datasets delete
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di dati
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare datasets delete DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets delete DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets delete DATASET_ID ^ --location=LOCATION
Per confermare, digita Y.
L'output è il seguente:
Deleted dataset [DATASET_ID]
REST
Utilizza il metodo projects.locations.datasets.delete
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: l'ID set di dati
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.
Go
Java
Node.js
Python
Passaggi successivi
- Anonimizzazione dei dati sensibili
- Creare e gestire gli archivi DICOM
- Creare e gestire gli archivi FHIR
- Creare e gestire gli archivi HL7v2