En esta página, se describe cómo crear, editar, ver, enumerar y borrar conjuntos de datos. Después de crear un conjunto de datos, puedes crear almacenes de datos que contienen historias clínicas electrónicas y datos de imágenes médicas desidentificar el conjunto de datos y más.
Antes de comenzar
Consulta el modelo de datos de la API de Cloud Healthcare.
Crea un conjunto de datos
En los siguientes ejemplos, se muestra cómo crear un conjunto de datos.
Console
En la consola de Google Cloud, ve a la página Navegador.
Haz clic en add_boxCrear conjunto de datos. Se muestra la página Propiedades del conjunto de datos.
En el campo Nombre, ingresa un identificador para el conjunto de datos sujeto al Caracteres permitidos y requisitos de tamaño del conjunto de datos.
Selecciona uno de los siguientes tipos de ubicaciones:
Region. El conjunto de datos reside de forma permanente dentro de una región de Google Cloud. 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 en varias regiones de Google Cloud. Después de seleccionar esta opción, escribe o selecciona Una ubicación multirregional en el campo Multirregional.
Haz clic en Crear. Se muestra la página Navegador. El conjunto de datos nuevo aparecerá en la lista de conjuntos de datos.
gcloud
Ejecuta el comando gcloud healthcare datasets create
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
LOCATION
: Es una ubicación compatible para el conjunto de datos.DATASET_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 que figura a continuación:
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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: Es una ubicación compatible para el conjunto de datos.DATASET_ID
: un identificador sujeto a los caracteres y requisitos de tamaño permitidos del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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
Ejecuta el siguiente 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 ContentExplorador de API
Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
OPERATION_ID
. Necesitarás este valor en el paso siguiente.Obtén el estado de la operación de larga duración con el método
projects.locations.datasets.operations.get
.Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datos.DATASET_ID
: El ID del conjunto de datosOPERATION_ID
: Es el ID que muestra la operación de larga duración.
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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
Ejecuta el siguiente 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 ContentExplorador de API
Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
"done": true
, significa que la operación de larga duración finalizó.
Go
Java
Node.js
Python
Edita un conjunto de datos
En los siguientes ejemplos, se muestra cómo editar un conjunto de datos.
Console
La consola de Google Cloud no admite la edición de un conjunto de datos. En cambio, usa con Google Cloud CLI o la API de REST.
gcloud
Ejecuta el comando gcloud healthcare datasets update
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
LOCATION
: La ubicación del conjunto de datosDATASET_ID
: El ID del conjunto de datosTIME_ZONE
: Es una zona horaria compatible, 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 que figura a continuación:
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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datos.DATASET_ID
: El ID del conjunto de datosTIME_ZONE
: Es una zona horaria compatible, 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 API
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API 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, completa cualquier otro campo obligatorio y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Obtener detalles del conjunto de datos
En los siguientes ejemplos, se muestra cómo obtener detalles sobre un conjunto de datos.
Console
En la consola de Google Cloud, ve a la página Navegador.
Selecciona 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 cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
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 que figura a continuación:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Usa el método projects.locations.datasets.get
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datos.DATASET_ID
: El ID del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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
Ejecuta el siguiente 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
Explorador de API
Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Mostrar lista de conjuntos de datos
En los siguientes ejemplos, se muestra cómo enumerar los conjuntos de datos en tu proyecto.
Console
En la consola de Google Cloud, ve a la página Navegador.
gcloud
Ejecuta el comando gcloud healthcare datasets list
:
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
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 que figura a continuación:
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
Usa el método projects.locations.datasets.list
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datos.
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
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 siguiente 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
Explorador de API
Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Borra un conjunto de datos
En los siguientes ejemplos, se muestra cómo borrar un conjunto de datos.
Console
En la consola de Google Cloud, ve a la página Navegador.
En la misma fila que el conjunto de datos, haz clic en la opción
Acciones y, luego, selecciona Borrar.En el diálogo de confirmación, ingresa el ID del conjunto de datos y, luego, haz clic en Borrar.
gcloud
Ejecuta el comando gcloud healthcare datasets delete
:
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
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 Y.
Esta es la salida:
Deleted dataset [DATASET_ID]
REST
Usa el método projects.locations.datasets.delete
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datos.DATASET_ID
: El ID del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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
Ejecuta el siguiente 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
Explorador de API
Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.
Go
Java
Node.js
Python
¿Qué sigue?
- Desidentifica datos sensibles
- Crea y administra tiendas de DICOM
- Crea y administra tiendas de FHIR
- Crea y administra tiendas de HL7v2