En esta página se describe cómo crear, editar, ver, enumerar y eliminar conjuntos de datos. Después de crear un conjunto de datos, puedes crear almacenes de datos que contengan historias clínicas electrónicas y datos de imágenes médicas, anonimizar el conjunto de datos y más.
Antes de empezar
Consulta el modelo de datos de la API Cloud Healthcare.
Crear conjunto de datos
En los siguientes ejemplos se muestra cómo crear un conjunto de datos.
Consola
En la Google Cloud consola, ve a la página Navegador.
Haz clic en add_box Crear conjunto de datos. Se mostrará la página Propiedades del conjunto de datos.
En el campo Nombre, introduce un identificador para el conjunto de datos que cumpla los requisitos de caracteres y tamaño permitidos para los conjuntos de datos.
Seleccione uno de los siguientes tipos de ubicación:
Región. El conjunto de datos reside de forma permanente en una Google Cloud región. Después de seleccionar esta opción, escribe o selecciona una ubicación en el campo Región.
Multirregión. El conjunto de datos reside permanentemente en una ubicación que abarca varias Google Cloud regiones. Después de seleccionar esta opción, escribe o selecciona una ubicación multirregional en el campo Multirregión.
Haz clic en Crear. Se muestra la página Navegador. El nuevo conjunto de datos se muestra en la lista de conjuntos de datos.
gcloud
Ejecuta el comando gcloud healthcare datasets create
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: una ubicación admitida del conjunto de datosDATASET_ID
: un identificador sujeto a los requisitos de tamaño y caracteres permitidos del conjunto de datos
Ejecuta el siguiente 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
Deberías recibir una respuesta similar a la siguiente:
Create request issued for: [DATASET_ID] Created dataset [DATASET_ID].
REST
Crea el conjunto de datos con el método
projects.locations.datasets.create
.Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: una ubicación admitida del conjunto de datosDATASET_ID
: un identificador sujeto a los requisitos de tamaño y caracteres permitidos del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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
Ejecuta el comando siguiente:
$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 ContentExplorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
OPERATION_ID
. Necesitarás este valor en el siguiente paso.Obtén el estado de la operación de larga duración mediante el método
projects.locations.datasets.operations.get
.Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datosOPERATION_ID
: el ID devuelto por la operación de larga duración
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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
Ejecuta el comando siguiente:
$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 ContentExplorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
"done": true
, la operación de larga duración ha finalizado.
Go
Java
Node.js
Python
Editar un conjunto de datos
En los siguientes ejemplos se muestra cómo editar un conjunto de datos.
Consola
La Google Cloud consola no permite editar un conjunto de datos. En su lugar, usa Google Cloud CLI o la API REST.
gcloud
Ejecuta el comando gcloud healthcare datasets update
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datosTIME_ZONE
: una zona horaria admitida, comoUTC
Ejecuta el siguiente 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
Deberías recibir una respuesta similar a la siguiente:
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Usa el método projects.locations.datasets.patch
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datosTIME_ZONE
: una zona horaria admitida, comoUTC
Cuerpo JSON de la solicitud:
{ "timeZone": "TIME_ZONE" }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$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
Explorador de APIs
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente:
Go
Java
Node.js
Python
Obtener detalles de un conjunto de datos
En los siguientes ejemplos se muestra cómo obtener detalles de un conjunto de datos.
Consola
En la Google Cloud consola, ve a la página Navegador.
Seleccione el conjunto de datos. Se mostrarán la página Conjunto de datos y los almacenes de datos del conjunto de datos.
gcloud
Ejecuta el comando
gcloud healthcare datasets describe
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datos
Ejecuta el siguiente 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
Deberías recibir una respuesta similar a la siguiente:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Usa el método projects.locations.datasets.get
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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
Ejecuta el comando siguiente:
$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
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente:
Go
Java
Node.js
Python
Mostrar conjuntos de datos
En los siguientes ejemplos se muestra cómo ver una lista de los conjuntos de datos de un proyecto.
Consola
En la Google Cloud consola, ve a la página Navegador.
gcloud
Ejecuta el comando
gcloud healthcare datasets list
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datos
Ejecuta el siguiente 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
Deberías recibir una respuesta similar a la siguiente:
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
Usa el método projects.locations.datasets.list
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
PowerShell
Ejecuta el comando siguiente:
$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
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente:
Go
Java
Node.js
Python
Eliminar un conjunto de datos
En los siguientes ejemplos se muestra cómo eliminar un conjunto de datos.
Consola
En la Google Cloud consola, ve a la página Navegador.
En la misma fila que el conjunto de datos, haga clic en la opción
Acciones y, a continuación, seleccione Eliminar.En el cuadro de diálogo de confirmación, introduce el ID del conjunto de datos y, a continuación, haz clic en Eliminar.
gcloud
Ejecuta el comando
gcloud healthcare datasets delete
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datos
Ejecuta el siguiente 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
Para confirmar, escribe S.
El resultado es el siguiente:
Deleted dataset [DATASET_ID]
REST
Usa el método projects.locations.datasets.delete
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el ID del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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
Ejecuta el comando siguiente:
$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
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.
Go
Java
Node.js
Python
Siguientes pasos
- Desidentificar datos sensibles
- Crear y gestionar almacenes DICOM
- Crear y gestionar almacenes FHIR
- Crear y gestionar almacenes HL7v2