En esta página se explica cómo exportar instancias DICOM e importar objetos DICOM desde Cloud Storage. Por lo general, una instancia DICOM es una imagen. Sin embargo, también puede referirse a otros tipos de datos persistentes, como un informe estructurado. Un objeto DICOM de Cloud Storage es una instancia DICOM que se encuentra en Cloud Storage. Para obtener más información, consulta Cloud Storage.
Configurar permisos de Cloud Storage
Antes de exportar datos DICOM a Cloud Storage e importarlos desde este servicio, debes conceder permisos adicionales a la cuenta de servicio del agente de servicio de Cloud Healthcare. Para obtener más información, consulta Permisos de Cloud Storage para almacenes DICOM.
Importar objetos DICOM
Para importar varios archivos de instancia DICOM a un almacén DICOM, puedes usar cualquiera de los siguientes métodos:
- Almacena los datos directamente en un almacén DICOM de forma programática desde tu máquina local mediante el servicio web RESTful Store Transaction, tal como se implementa en la API Cloud Healthcare.
- Sube los datos DICOM a un segmento de Cloud Storage y, a continuación, importa los archivos a un almacén DICOM mediante una sola operación de importación, tal como se explica en esta sección.
En los ejemplos siguientes se muestra cómo importar objetos DICOM desde un segmento de Cloud Storage.
Consola
Para importar objetos DICOM desde un segmento de Cloud Storage, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
Ir a conjuntos de datos - Haga clic en el conjunto de datos que contenga el almacén DICOM al que quiera importar objetos DICOM.
- En la lista de almacenes de datos, elige Importar de la lista Acciones del almacén DICOM.
Aparecerá la página Importar a almacén DICOM. - En la lista Proyecto, selecciona un proyecto de Cloud Storage.
- En la lista Ubicación, selecciona un segmento de Cloud Storage.
- Para definir una ubicación específica para importar archivos, sigue estos pasos:
- Despliega Opciones avanzadas.
- Selecciona Reemplazar ruta de Cloud Storage.
- Para definir una fuente específica para importar archivos, define la ruta
con las siguientes variables en el cuadro de texto Ubicación:
*
: coincide con caracteres que no sean separadores.**
: busca coincidencias de caracteres, incluidos los separadores. Se puede usar con una extensión de nombre de archivo para que coincida con todos los archivos del mismo tipo.?
: coincide con 1 carácter.
- Haz clic en Importar para importar objetos DICOM de la fuente definida.
- Para hacer un seguimiento del estado de la operación, haga clic en la pestaña Operaciones. Una vez que se haya completado la operación, aparecerán las siguientes indicaciones:
- La sección Estado de la operación de larga duración tiene una marca de verificación verde en el encabezado OK.
- La sección Resumen tiene una marca de verificación verde y un indicador OK en la misma fila que el ID de operación.
gcloud
Para importar objetos DICOM desde un segmento de Cloud Storage, usa el comando gcloud healthcare dicom-stores import gcs
. Especifica el nombre del conjunto de datos superior, el nombre del almacén DICOM y la ubicación del objeto en un segmento de Cloud Storage.
- La ubicación de los archivos dentro del segmento es arbitraria y no tiene por qué coincidir exactamente con el formato especificado en el siguiente ejemplo.
- Al especificar la ubicación de los objetos DICOM en Cloud Storage, puedes utilizar comodines para importar varios archivos desde uno o más directorios.
Se admiten los siguientes comodines:
- Usa
*
para hacer coincidir 0 o más caracteres que no sean de separación. Por ejemplo,gs://BUCKET/DIRECTORY/Example*.dcm
coincide con Example.dcm y Example22.dcm en DIRECTORY. - Usa
**
para hacer coincidir 0 o más caracteres (incluidos los de separación). Se debe usar al final de una ruta y no debe haber otros comodines en la ruta. También se puede usar con una extensión de nombre de archivo (como .dcm), que importa todos los archivos con la extensión de nombre de archivo del directorio especificado y sus subdirectorios. Por ejemplo,gs://BUCKET/DIRECTORY/**.dcm
importa todos los archivos con la extensión .dcm en DIRECTORY y sus subdirectorios. - Usa
?
para hacer que coincida 1 carácter. Por ejemplo,gs://BUCKET/DIRECTORY/Example?.dcm
coincide con Example1.dcm, pero no con Example.dcm ni con Example01.dcm.
- Usa
En el siguiente ejemplo se muestra cómo importar objetos DICOM desde un segmento de Cloud Storage.
gcloud healthcare dicom-stores import gcs DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --gcs-uri=gs://BUCKET/DIRECTORY/DICOM_INSTANCE.dcm
La línea de comandos muestra el ID de la operación:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID
Para ver el estado de la operación, ejecuta el comando
gcloud healthcare operations describe
y proporciona OPERATION_ID de la respuesta:
gcloud healthcare operations describe OPERATION_ID \ --location=LOCATION \ --dataset=DATASET_ID
Una vez que se haya completado el comando, la respuesta incluirá done: true
.
done: true metadata: '@type': type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata apiMethodName: google.cloud.healthcare.v1.dicom.DicomService.ImportDicomData counter: success: SUCCESSFUL_INSTANCES failure: FAILED_INSTANCES createTime: "CREATE_TIME" endTime: "END_TIME" name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID response: '@type': "..."
API
Para importar objetos DICOM desde un segmento de Cloud Storage, usa el método projects.locations.datasets.dicomStores.import
.
- La ubicación de los archivos dentro del segmento puede variar y no tiene por qué coincidir con el formato especificado en los siguientes ejemplos.
- Al especificar la ubicación de los objetos DICOM en Cloud Storage, utiliza comodines para importar varios archivos desde uno o más directorios.
Se admiten los siguientes comodines:
- Usa
*
para hacer coincidir 0 o más caracteres que no sean de separación. Por ejemplo,gs://BUCKET/DIRECTORY/Example*.dcm
coincide con Example.dcm y Example22.dcm en DIRECTORY. - Usa
**
para hacer coincidir 0 o más caracteres (incluidos los de separación). Se debe usar al final de una ruta y no debe haber otros comodines en la ruta. También se puede usar con una extensión de nombre de archivo (como .dcm), que importa todos los archivos con la extensión de nombre de archivo del directorio especificado y sus subdirectorios. Por ejemplo,gs://BUCKET/DIRECTORY/**.dcm
importa todos los archivos con la extensión .dcm en DIRECTORY y sus subdirectorios. - Usa
?
para hacer que coincida 1 carácter. Por ejemplo,gs://BUCKET/DIRECTORY/Example?.dcm
coincide con Example1.dcm, pero no con Example.dcm ni con Example01.dcm.
- Usa
REST
Importa el objeto DICOM.
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 conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOMBUCKET/PATH/TO/FILE
: la ruta al objeto DICOM en Cloud Storage
Cuerpo JSON de la solicitud:
{ "gcsSource": { "uri": "gs://BUCKET/PATH/TO/FILE.dcm" } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado
request.json
. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:cat > request.json << 'EOF' { "gcsSource": { "uri": "gs://BUCKET/PATH/TO/FILE.dcm" } } EOF
A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:import"PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado
request.json
. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:@' { "gcsSource": { "uri": "gs://BUCKET/PATH/TO/FILE.dcm" } } '@ | Out-File -FilePath request.json -Encoding utf8
A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:import" | Select-Object -Expand ContentObtén el estado de la operación de larga duración.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID de tu Google Cloud proyecto
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén DICOM
- OPERATION_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 Content
Go
Java
Node.js
Python
Para recuperar una sola instancia o un estudio de un almacén DICOM, recupera datos DICOM mediante el servicio web RESTful Retrieve Transaction (Recuperar transacción) implementado en la API Cloud Healthcare.
Especificar una clase de almacenamiento para importar objetos DICOM (vista previa)
De forma predeterminada, el método projects.locations.datasets.dicomStores.import
importa un objeto DICOM a un almacén DICOM con una clase de almacenamiento estándar. Puedes definir la clase de almacenamiento al importar objetos DICOM desde Cloud Storage.
Para obtener más información, consulta Cambiar la clase de almacenamiento de DICOM.
En los ejemplos siguientes se muestra cómo especificar la clase de almacenamiento al importar objetos DICOM desde Cloud Storage.
REST
Usa el método projects.locations.datasets.dicomStores.import
.
Importa el objeto DICOM.
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 conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOMBUCKET/PATH/TO/FILE
: la ruta al objeto DICOM en Cloud StorageSTORAGE_CLASS
: la clase de almacenamiento del objeto DICOM en el almacén DICOM deSTANDARD
,NEARLINE
,COLDLINE
yARCHIVE
Cuerpo JSON de la solicitud:
{ "gcsSource": { "uri": "gs://BUCKET/PATH/TO/FILE.dcm" }, "blob_storage_settings": { "blob_storage_class": "STORAGE_CLASS" } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado
request.json
. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:cat > request.json << 'EOF' { "gcsSource": { "uri": "gs://BUCKET/PATH/TO/FILE.dcm" }, "blob_storage_settings": { "blob_storage_class": "STORAGE_CLASS" } } EOF
A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:import"PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado
request.json
. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:@' { "gcsSource": { "uri": "gs://BUCKET/PATH/TO/FILE.dcm" }, "blob_storage_settings": { "blob_storage_class": "STORAGE_CLASS" } } '@ | Out-File -FilePath request.json -Encoding utf8
A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:import" | Select-Object -Expand ContentObtén el estado de la operación de larga duración.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID de tu Google Cloud proyecto
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén DICOM
- OPERATION_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/v1beta1/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/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
Solucionar problemas con solicitudes de importación de DICOM
Si se producen errores durante una solicitud de importación de DICOM, se registran en Cloud Logging. Para obtener más información, consulta Ver registros de errores en Cloud Logging.
Exportar instancias DICOM
En los ejemplos siguientes se muestra cómo exportar instancias DICOM a un segmento de Cloud Storage. Al exportar instancias DICOM desde un almacén DICOM, se exportan todas las instancias que se encuentran en el almacén.
Consola
Para exportar instancias DICOM a Cloud Storage, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
Ir a conjuntos de datos - Haga clic en el conjunto de datos que contiene el almacén DICOM del que quiere exportar instancias DICOM.
- En la lista de almacenes de datos, elija Exportar en la lista Acciones del almacén DICOM.
- En la página Exportar almacén DICOM que aparece, selecciona Segmento de Google Cloud Storage.
- En la lista Proyecto, selecciona un proyecto de Cloud Storage.
- En la lista Ubicación, selecciona un segmento de Cloud Storage.
- En Configuración de exportación de DICOM, selecciona el tipo de archivo que se usará para exportar las instancias DICOM. Están disponibles los siguientes tipos:
- Archivo DICOM (
.dcm
) - octet-stream
- Imagen (
.jpg
,.png
)
- Archivo DICOM (
- Para definir una sintaxis de transferencia adicional, elija la sintaxis en la lista Sintaxis de transferencia.
- Haz clic en Exportar para exportar las instancias DICOM a la ubicación definida en Cloud Storage.
- Para hacer un seguimiento del estado de la operación, haga clic en la pestaña Operaciones. Una vez que se haya completado la operación, aparecerán las siguientes indicaciones:
- La sección Estado de la operación de larga duración tiene una marca de verificación verde en el encabezado OK.
- La sección Resumen tiene una marca de verificación verde y un indicador OK en la misma fila que el ID de operación.
gcloud
Para exportar instancias DICOM a un segmento de Cloud Storage, usa el comando
gcloud healthcare dicom-stores export gcs
.
- Proporciona el nombre del conjunto de datos superior, el nombre del almacén DICOM y el segmento de Cloud Storage de destino.
- Escribe en un segmento o directorio de Cloud Storage en lugar de en un objeto, ya que la API Cloud Healthcare crea un archivo
.dcm
por cada objeto. - Si el comando especifica un directorio que no existe, se crea.
En el siguiente ejemplo se muestra el comando gcloud healthcare dicom-stores export gcs
.
gcloud healthcare dicom-stores export gcs DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --gcs-uri-prefix=gs://BUCKET/DIRECTORY
La línea de comandos muestra el ID de la operación:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID
Para ver el estado de la operación, ejecuta el comando
gcloud healthcare operations describe
y proporciona OPERATION_ID de la respuesta:
gcloud healthcare operations describe OPERATION_ID \ --location=LOCATION \ --dataset=DATASET_ID
Una vez que se haya completado el comando, la respuesta incluirá done: true
.
done: true metadata: '@type': type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata apiMethodName: google.cloud.healthcare.v1.dicom.DicomService.ExportDicomData counter: success: SUCCESSFUL_INSTANCES failure: FAILED_INSTANCES createTime: "CREATE_TIME" endTime: "END_TIME" name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID response: '@type': "..."
API
Para exportar instancias DICOM a un segmento de Cloud Storage, usa el método projects.locations.datasets.dicomStores.export
.
- Escribe en un segmento o directorio de Cloud Storage en lugar de en un objeto, ya que la API Cloud Healthcare crea un archivo
.dcm
por cada objeto DICOM. - Si el comando especifica un directorio que no existe, se crea.
curl
Para exportar instancias DICOM, haz una solicitud POST
y proporciona la siguiente información:
- Nombre y ubicación del conjunto de datos principal
- Nombre del almacén DICOM
- El segmento de destino de Cloud Storage
En el siguiente ejemplo se muestra una solicitud POST
que utiliza curl
.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'gcsDestination': { 'uriPrefix': 'gs://BUCKET/DIRECTORY' } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:export"
Si la solicitud se realiza de forma correcta, el servidor devuelve la respuesta en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" }
La respuesta contiene un nombre de operación. Para hacer un seguimiento del estado de la operación, utiliza el método Operation get
:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
Si la solicitud se realiza de forma correcta, el servidor devuelve una respuesta con el estado de la operación en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1.dicom.DicomService.ExportDicomData", "createTime": "CREATE_TIME", "endTime": "END_TIME", "logsUrl": "https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL", "counter":{ "success": SUCCESSFUL_INSTANCES "failure": FAILED_INSTANCES } }, "done": true, "response": { "@type": "..." } }
PowerShell
Para exportar instancias DICOM, haz una solicitud POST
y proporciona la siguiente información:
- Nombre y ubicación del conjunto de datos principal
- Nombre del almacén DICOM
- El segmento de destino de Cloud Storage
En el siguiente ejemplo se muestra una solicitud POST
que utiliza Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'gcsDestination': { 'uriPrefix': 'gs://BUCKET/DIRECTORY' } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:export" | Select-Object -Expand Content
Si la solicitud se realiza de forma correcta, el servidor devuelve la respuesta en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" }
La respuesta contiene un nombre de operación. Para hacer un seguimiento del estado de la operación, utiliza el método Operation get
:
$cred = gcloud auth application-default 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 Content
Si la solicitud se realiza de forma correcta, el servidor devuelve una respuesta con el estado de la operación en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1.dicom.DicomService.ExportDicomData", "createTime": "CREATE_TIME", "endTime": "END_TIME", "logsUrl": "https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL", "counter":{ "success": SUCCESSFUL_INSTANCES "failure": FAILED_INSTANCES }, }, "done": true, "response": { "@type": "..." } }
Go
Java
Node.js
Python
Exportar instancias DICOM mediante filtros
De forma predeterminada, al exportar archivos DICOM a Cloud Storage, se exportan todos los archivos DICOM del almacén DICOM. Del mismo modo, cuando exportas metadatos DICOM a BigQuery, se exportan los metadatos de todos los datos DICOM del almacén DICOM.
Puedes exportar un subconjunto de datos o metadatos DICOM mediante un archivo de filtro.
Configurar un archivo de filtro
- Cada línea del archivo de filtro define el estudio, la serie o la instancia y usa el formato
/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID
. - Puedes truncar una línea para especificar el nivel en el que funciona el filtro.
Por ejemplo, puedes seleccionar un estudio completo especificando
/studies/STUDY_INSTANCE_UID
o una serie completa especificando/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID
.
Considera el siguiente archivo de filtro:
/studies/1.123.456.789 /studies/1.666.333.111/series/123.456 /studies/1.666.333.111/series/567.890 /studies/1.888.999.222/series/123.456/instances/111 /studies/1.888.999.222/series/123.456/instances/222 /studies/1.888.999.222/series/123.456/instances/333
Este archivo de filtro de ejemplo se aplica a lo siguiente:
- Todo el estudio con el UID de instancia de estudio
1.123.456.789
- Dos series independientes con los UIDs de instancia de serie
123.456
y567.890
en el estudio1.666.333.111
- Tres instancias individuales con los IDs de instancia
111
,222
y333
en el estudio1.888.999.222
y la serie123.456
Crear un archivo de filtro con BigQuery
Para crear un archivo de filtro con BigQuery, primero debes exportar los metadatos de tu almacén DICOM a BigQuery. Los metadatos exportados muestran los UIDs del estudio, la serie y la instancia de los datos DICOM de tu almacén DICOM.
Después de exportar los metadatos, sigue estos pasos:
Ejecuta una consulta para obtener los UIDs del estudio, la serie y las instancias que quieras añadir al archivo de filtro.
Por ejemplo, la siguiente consulta muestra cómo concatenar los UIDs de estudio, serie e instancia para cumplir los requisitos del formato de archivo de filtro:
SELECT CONCAT ('/studies/', StudyInstanceUID, '/series/', SeriesInstanceUID, '/instances/', SOPInstanceUID) FROM [PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE]
Opcional: Si la consulta devuelve un conjunto de resultados grande que supera el tamaño máximo de respuesta, guarda los resultados de la consulta en una nueva tabla de destino en BigQuery.
Guarda los resultados de la consulta en un archivo y expórtalo a Cloud Storage. Si has guardado los resultados de la consulta en una tabla de destino nueva en el paso 2, consulta Exportar datos de tablas para exportar el contenido de la tabla a Cloud Storage.
Edita el archivo exportado según sea necesario e inclúyelo en tu solicitud para cambiar la clase de almacenamiento de varios objetos DICOM.
Crear un archivo de filtro manualmente
Para crear un archivo de filtro manualmente, siga estos pasos:
- Crea un archivo de filtro que contenga los objetos DICOM por los que quieres filtrar.
- Sube el archivo de filtro a Cloud Storage. Para obtener instrucciones, consulta Subir objetos desde un sistema de archivos.
Pase en el archivo de filtro
Después de crear un archivo de filtro, llama a la operación de exportación de DICOM y envía el archivo de filtro mediante la API REST. En los siguientes ejemplos se muestra cómo exportar datos DICOM mediante un filtro.
gcloud
Para exportar metadatos DICOM a Cloud Storage mediante un filtro, usa el comando
gcloud beta healthcare dicom-stores export gcs
:
gcloud beta healthcare dicom-stores export gcs DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --gcs-uri-prefix=gs://DESTINATION_BUCKET/DIRECTORY \ --filter-config-gcs-uri=gs://BUCKET/DIRECTORY/FILTER_FILE
Haz los cambios siguientes:
- DICOM_STORE_ID: el identificador del almacén DICOM
- DATASET_ID: el nombre del conjunto de datos superior del almacén DICOM
- LOCATION: la ubicación del conjunto de datos superior del almacén DICOM
- DESTINATION_BUCKET/DIRECTORY: el segmento de Cloud Storage de destino
- BUCKET/DIRECTORY/FILTER_FILE: la ubicación del archivo de filtro en un segmento de Cloud Storage
El resultado es el siguiente:
Request issued for: [DICOM_STORE_ID] Waiting for operation [projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID] to complete...done. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
Para ver el estado de la operación, ejecuta el comando
gcloud healthcare operations describe
y proporciona OPERATION_ID de la respuesta:
gcloud healthcare operations describe OPERATION_ID \ --location=LOCATION \ --dataset=DATASET_ID
Haz los cambios siguientes:
- OPERATION_ID: el número de ID devuelto en la respuesta anterior.
- DATASET_ID: el nombre del conjunto de datos superior del almacén DICOM
- LOCATION: la ubicación del conjunto de datos superior del almacén DICOM
El resultado es el siguiente:
done: true metadata: '@type': type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata apiMethodName: google.cloud.healthcare.v1beta1.dicom.DicomService.ExportDicomData counter: success: SUCCESSFUL_INSTANCES failure: FAILED_INSTANCES createTime: 'CREATE_TIME' endTime: 'END_TIME' logsUrl: 'https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL' name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID response: '@type': '...'
API
Para exportar datos DICOM mediante un filtro, usa el método projects.locations.datasets.dicomStores.export
.
curl
Para exportar datos DICOM mediante un archivo de filtro, haz una solicitud POST
y proporciona la siguiente información:
- Nombre y ubicación del conjunto de datos principal
- Nombre del almacén DICOM
- El segmento de destino de Cloud Storage
- Ubicación del archivo de filtro en un segmento de Cloud Storage
En el siguiente ejemplo se muestra una solicitud POST
que utiliza curl
.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'gcsDestination': { 'uriPrefix': 'gs://BUCKET/DIRECTORY' }, 'filterConfig': { 'resourcePathsGcsUri': 'gs://BUCKET/DIRECTORY/FILTER_FILE' } }" "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:export"
Si la solicitud se realiza correctamente, el servidor devuelve la siguiente respuesta en formato JSON:
{ "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/operations/OPERATION_ID" }
La respuesta contiene un nombre de operación. Usa el método Operation get
para hacer un seguimiento del estado de la operación:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/operations/OPERATION_NAME"
Si la solicitud se realiza correctamente, el servidor devuelve la siguiente respuesta en formato JSON:
{ "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1beta1.dicom.DicomService.ExportDicomData", "createTime": "CREATE_TIME", "endTime": "END_TIME" }, "done": true, "response": { "@type": "..." } }
PowerShell
Para exportar datos DICOM mediante un archivo de filtro, haz una solicitud POST
y proporciona la siguiente información:
- Nombre y ubicación del conjunto de datos principal
- Nombre del almacén DICOM
- El segmento de destino de Cloud Storage
- Ubicación del archivo de filtro en un segmento de Cloud Storage
En el siguiente ejemplo se muestra una solicitud POST
que utiliza Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'gcsDestination': { 'uriPrefix': 'gs://BUCKET/DIRECTORY' }, 'filterConfig': { 'resourcePathsGcsUri': 'gs://BUCKET/DIRECTORY/FILTER_FILE' }" ` -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:export" | Select-Object -Expand Content
Si la solicitud se realiza correctamente, el servidor devuelve la siguiente respuesta en formato JSON:
{ "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/operations/OPERATION_ID" }
La respuesta contiene un nombre de operación. Usa el método Operation get
para hacer un seguimiento del estado de la operación:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/operations/OPERATION_NAME" | Select-Object -Expand Content
Si la solicitud se realiza de forma correcta, el servidor devuelve la siguiente respuesta con el estado de la operación en formato JSON:
{ "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1beta1.dicom.DicomService.ExportDicomData", "createTime": "CREATE_TIME", "endTime": "END_TIME" }, "done": true, "response": { "@type": "..." } }
Solucionar problemas con las solicitudes de exportación de DICOM
Si se producen errores durante una solicitud de exportación de DICOM, se registran en Cloud Logging. Para obtener más información, consulta Ver registros de errores en Cloud Logging.
Si toda la operación devuelve un error, consulta Solucionar problemas de operaciones de larga duración.