Cette page explique comment créer, modifier, afficher, répertorier et supprimer des jeux de données. Après avoir créé un ensemble de données, vous pouvez créer des datastores contenant des dossiers médicaux électroniques et des données d'imagerie médicale, anonymiser l'ensemble de données, etc.
Avant de commencer
Consultez le modèle de données de l'API Cloud Healthcare.
Créer un ensemble de données
Les exemples suivants montrent comment créer un ensemble de données.
Console
Dans la console Google Cloud, accédez à la page Navigateur.
Cliquez sur add_box Créer un ensemble de données. La page Propriétés de l'ensemble de données s'affiche.
Dans le champ Nom, saisissez un identifiant pour l'ensemble de données concerné par le caractères autorisés et exigences de taille pour l'ensemble de données.
Sélectionnez l'un des types d'emplacements suivants :
Région : L'ensemble de données réside en permanence dans une région Google Cloud. Après avoir sélectionné cette option, saisissez ou sélectionnez un emplacement dans le champ Région.
Multirégional L'ensemble de données réside de façon permanente dans un emplacement qui couvre plusieurs régions Google Cloud. Après avoir sélectionné cette option, saisissez ou sélectionnez un emplacement multirégional dans le champ Multirégional.
Cliquez sur Créer. La page Navigateur s'affiche. Le nouvel ensemble de données s'affiche dans la liste des ensembles de données.
gcloud
Exécutez la commande gcloud healthcare datasets create
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
LOCATION
: emplacement compatible pour l'ensemble de donnéesDATASET_ID
: Identifiant soumis aux exigences de taille et de caractères autorisés pour l'ensemble de données
Exécutez la commande suivante :
Linux, macOS ou 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
Vous devriez obtenir un résultat semblable à celui-ci :
Create request issued for: [DATASET_ID] Created dataset [DATASET_ID].
REST
Créez l'ensemble de données à l'aide de la méthode
projects.locations.datasets.create
.Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement compatible pour l'ensemble de donnéesDATASET_ID
: Identifiant soumis aux exigences de taille et de caractères autorisés pour l'ensemble de données
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 ContentAPI Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
OPERATION_ID
. Vous en aurez besoin à l'étape suivante.Obtenez l'état de l'opération de longue durée à l'aide de la méthode
projects.locations.datasets.operations.get
.Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de donnéesOPERATION_ID
: ID renvoyé par l'opération de longue durée
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 ContentAPI Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
"done": true
, l'opération de longue durée est terminée.
Go
Java
Node.js
Python
Modifier un ensemble de données
Les exemples suivants montrent comment modifier un ensemble de données.
Console
La console Google Cloud ne permet pas de modifier un ensemble de données. Utilisez plutôt Google Cloud CLI ou l'API REST.
gcloud
Exécutez la commande gcloud healthcare datasets update
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
LOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de donnéesTIME_ZONE
: fuseau horaire compatible, tel queUTC
Exécutez la commande suivante :
Linux, macOS ou 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
Vous devriez obtenir un résultat semblable à celui-ci :
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Utilisez la méthode projects.locations.datasets.patch
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de donnéesTIME_ZONE
: fuseau horaire compatible, tel queUTC
Corps JSON de la requête :
{ "timeZone": "TIME_ZONE" }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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
API Explorer
Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Obtenir les détails d'un ensemble de données
Les exemples suivants montrent comment obtenir des informations détaillées sur un ensemble de données.
Console
Dans la console Google Cloud, accédez à la page Navigateur.
Sélectionnez l'ensemble de données. La page Ensemble de données et les datastores contenus dans l'ensemble de données s'affichent.
gcloud
Exécutez la commande gcloud healthcare datasets describe
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
LOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de données
Exécutez la commande suivante :
Linux, macOS ou 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
Vous devriez obtenir un résultat semblable à celui-ci :
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Utilisez la méthode projects.locations.datasets.get
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de données
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Répertorier des ensembles de données
Les exemples suivants montrent comment répertorier les ensembles de données de votre projet.
Console
Dans la console Google Cloud, accédez à la page Navigateur.
gcloud
Exécutez la
gcloud healthcare datasets list
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
LOCATION
: emplacement de l'ensemble de données
Exécutez la commande suivante :
Linux, macOS ou 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
Vous devriez obtenir un résultat semblable à celui-ci :
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
Utilisez la méthode projects.locations.datasets.list
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de données
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
PowerShell
Exécutez la commande suivante :
$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
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir une réponse JSON de ce type :
Go
Java
Node.js
Python
Supprimer un ensemble de données
Les exemples suivants montrent comment supprimer un ensemble de données.
Console
Dans la console Google Cloud, accédez à la page Navigateur.
Sur la ligne de l'ensemble de données, cliquez sur l'option
Actions, puis sélectionnez Supprimer.Dans la boîte de dialogue de confirmation, saisissez l'ID de l'ensemble de données, puis cliquez sur Supprimer.
gcloud
Exécutez la
gcloud healthcare datasets delete
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
LOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de données
Exécutez la commande suivante :
Linux, macOS ou 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
Pour confirmer, saisissez Y.
Le résultat est le suivant :
Deleted dataset [DATASET_ID]
REST
Utilisez la méthode projects.locations.datasets.delete
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ID de l'ensemble de données
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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
API Explorer
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.
Go
Java
Node.js
Python
Étape suivante
- Supprimer l'identification des données sensibles
- Créer et gérer des magasins DICOM
- Créer et gérer des magasins FHIR
- Créer et gérer des magasins HL7v2