Gestionar un almacén de datos de búsqueda de asistencia sanitaria

Después de crear almacenes de datos sanitarios e importar datos de FHIR R4, puedes realizar las siguientes operaciones para gestionarlos:

• Cancelar importación por lotes.
• Pausar o reanudar la emisión.
• Sincronización manual de datos transmitidos:
  • Sincronizar todos los documentos.
  • Sincronizar documentos concretos.
  • Sincronizar documentos después de una marca de tiempo determinada.
• Eliminar streaming.

Cancelar importación por lotes

Para cancelar una operación de importación por lotes en curso, siga estos pasos:

REST

1. Busca el ID de operación de la operación de importación por lotes. Este ID de operación es el mismo que el que se devuelve cuando importas los datos en tu almacén de datos. Si ya tienes el ID de operación, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA y, en el menú de navegación, haz clic en Almacenes de datos.

      Ir a la página Almacenes de datos

   2. Haga clic en el almacén de datos cuya importación quiera cancelar.

   3. En la página de detalles del almacén de datos, haga clic en Ver detalles. Esta opción solo está disponible después de crear la operación de importación y cuando esté en curso.

   4. En el panel Detalles del registro de actividad, obtén el ID de operación.

2. Cancelar una importación por lotes en curso.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/OPERATION_ID:cancel" \
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • DATA_STORE_ID: el ID del almacén de datos cuya importación por lotes en curso quieres cancelar.
   • IMPORT_OPERATION_ID: el ID de la operación de importación por lotes en curso que quieres cancelar.

   Si la operación se cancela correctamente, deberías recibir un objeto JSON vacío.

Pausar o reanudar la emisión

Para pausar o reanudar una operación de streaming, haz lo siguiente:

Consola

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. En el menú de navegación, haga clic en Almacenes de datos.

   En la página Data Stores (Almacenes de datos) se muestra una lista de los almacenes de datos de tu proyecto Google Cloud con sus detalles.

3. Haga clic en el almacén de datos para el que quiera pausar o reanudar la transmisión.

4. En la página Datos del conector de datos, haga clic en Pausar la transmisión de datos para pausarla o en Reanudar la transmisión de datos para reanudarla.

REST

1. Busca el ID de tu colección. Si ya tienes el ID de tu colección, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA y, en el menú de navegación, haz clic en Almacenes de datos.

      Ir a la página Almacenes de datos

   2. Haga clic en el nombre del conector de datos cuya transmisión quiera pausar o reanudar.

   3. En la página Datos de su conector de datos, obtenga el ID de recogida.

2. Pausar o reanudar el streaming en un conector de datos.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector?updateMask=auto_run_disabled" \
   -d ' {
     "name":"projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector",
     "autoRunDisabled": PAUSE_STREAM_TRUE|FALSE
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID del conector de datos cuya transmisión quieres pausar o reanudar.
   • PAUSE_STREAM_TRUE|FALSE: valor booleano que, cuando se le asigna el valor true, pausa la emisión y, cuando se le asigna el valor false, reanuda una emisión pausada.

   Respuesta

   Deberías recibir una respuesta JSON similar a la siguiente. El campo autoRunDisabled solo se devuelve cuando pausas el flujo de datos.

   {
     "name": "projects/PROJECT_NUMBER/locations/us/collections/COLLECTION_ID/dataConnector",
     "state": "ACTIVE",
     "dataSource": "gcp_fhir",
     "params": {
       "instance_uri": "projects/PROJECT_ID/locations/us-central1/datasets/synthea-mock"
     },
     "refreshInterval": "0s",
     "entities": [
       {
         "entityName": "DATA_STORE_NAME",
         "dataStore": "projects/PROJECT_NUMBER/locations/us/collections/default_collection/dataStores/DATA_STORE_ID"
       }
     ],
     "createTime": "DATA_STORE_CREATE_TIMESTAMP",
     "syncMode": "STREAMING",
     "autoRunDisabled": true,
     "actionConfig": {},
     "latestPauseTime": "PAUSE_TIMESTAMP",
     "lastSyncTime": "LAST_SYNC_TIMESTAMP",
     "updateTime": "UPDATE_TIMESTAMP",
     "identityScheduleConfig": {}
   }
   

Sincronizar todos los documentos de un almacén de datos de streaming

Puede activar manualmente un relleno para todos los documentos con los tipos de recursos FHIR admitidos. De esta forma, puedes mantener actualizado tu almacén de datos de Vertex AI Search con tu almacén FHIR de la API Cloud Healthcare. La sincronización de datos solo es posible en los almacenes de datos de streaming.

Para sincronizar todos los documentos de un almacén de datos de streaming, haz lo siguiente:

Consola

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. En el menú de navegación, haga clic en Almacenes de datos.

   En la página Data Stores (Almacenes de datos) se muestra una lista de los almacenes de datos de tu proyecto Google Cloud con sus detalles.

3. Selecciona el conector de datos que quieras sincronizar.

4. En la página de detalles del almacén de datos, haga clic en Volver a importar.

5. En el panel Volver a importar datos, haz clic en , selecciona una fecha posterior a la que quieras sincronizar los datos y haz clic en Cerrar.

6. En la sección Recursos que se van a volver a importar, selecciona todos los tipos de recursos FHIR. De esta forma, se rellenarán todos los documentos con los tipos de recursos FHIR admitidos.

7. Haz clic en Volver a importar.

REST

1. Busca el ID de tu colección. Si ya tienes el ID de tu colección, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA y, en el menú de navegación, haz clic en Almacenes de datos.

      Ir a la página Almacenes de datos

   2. Haga clic en el nombre del conector de datos cuya transmisión quiera pausar o reanudar.

   3. En la página Datos de su conector de datos, obtenga el ID de recogida.

2. Activa una sincronización o un relleno de todos los documentos con tipos de recursos FHIR admitidos.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {}
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección cuya transmisión quieres pausar o reanudar.

   Respuesta

   Deberías recibir una respuesta JSON similar a la siguiente. La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de la sincronización. Para obtener más información, consulta ConnectorRun.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   Si vuelves a llamar al método startConnectorRun mientras se está ejecutando, es posible que se produzca un error.

Sincronizar documentos concretos en un almacén de datos de streaming

Puede importar documentos concretos con los tipos de recursos FHIR admitidos. Esto resulta útil cuando quieres actualizar tu almacén de datos de Vertex AI Search con documentos de determinados tipos de recursos de FHIR. La sincronización de datos solo es posible en almacenes de datos de streaming.

Para sincronizar documentos concretos en un almacén de datos de streaming, haz lo siguiente:

Consola

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. En el menú de navegación, haga clic en Almacenes de datos.

   En la página Data Stores (Almacenes de datos) se muestra una lista de los almacenes de datos de tu proyecto Google Cloud con sus detalles.

3. Selecciona el conector de datos que quieras sincronizar.

4. En la página de detalles del almacén de datos, haga clic en Volver a importar.

5. En el panel Volver a importar datos, haz clic en , selecciona una fecha posterior a la que quieras sincronizar los datos y haz clic en Cerrar.

6. En la sección Recursos que se van a volver a importar, seleccione todos los tipos de recursos FHIR que quiera importar. De esta forma, se importarán todos los documentos de los tipos de recursos FHIR seleccionados.

7. Haz clic en Volver a importar.

REST

1. Busca el ID de tu colección. Si ya tienes el ID de tu colección, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA y, en el menú de navegación, haz clic en Almacenes de datos.

      Ir a la página Almacenes de datos

   2. Haga clic en el nombre del conector de datos cuya transmisión quiera pausar o reanudar.

   3. En la página Datos de su conector de datos, obtenga el ID de recogida.

2. Activa una sincronización o un relleno de documentos selectivos con tipos de recursos FHIR compatibles.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {},
     "healthcareFhirResourceTypes": "Patient",
     "healthcareFhirResourceTypes": "RESOURCE_TYPE"
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección cuya transmisión quieres pausar o reanudar.
   • RESOURCE_TYPE: el tipo de recurso de los documentos FHIR que quieras rellenar.

   Respuesta

   Deberías recibir una respuesta JSON similar a la siguiente. La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de la sincronización. Para obtener más información, consulta ConnectorRun.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   Si vuelves a llamar al método startConnectorRun mientras se está ejecutando, es posible que se produzca un error.

Sincronizar documentos después de una marca de tiempo determinada en un almacén de datos de streaming

Puede importar documentos selectivos con los tipos de recursos FHIR admitidos después de una marca de tiempo determinada. La sincronización de datos solo es posible en almacenes de datos de streaming.

Para sincronizar documentos después de una marca de tiempo determinada, haz lo siguiente:

Consola

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. En el menú de navegación, haga clic en Almacenes de datos.

   En la página Data Stores (Almacenes de datos) se muestra una lista de los almacenes de datos de tu proyecto Google Cloud con sus detalles.

3. Selecciona el conector de datos que quieras sincronizar.

4. En la página de detalles del almacén de datos, haga clic en Volver a importar.

5. En el panel Volver a importar datos, haz clic en , selecciona una fecha posterior a la que quieras sincronizar los datos y haz clic en Cerrar.

6. En la sección Recursos que se van a volver a importar, seleccione todos los tipos de recursos FHIR que quiera importar. De esta forma, se importarán todos los documentos de los tipos de recursos FHIR seleccionados.

7. Haz clic en Volver a importar.

REST

1. Busca el ID de tu colección. Si ya tienes el ID de tu colección, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA y, en el menú de navegación, haz clic en Almacenes de datos.

      Ir a la página Almacenes de datos

   2. Haga clic en el nombre del conector de datos cuya transmisión quiera pausar o reanudar.

   3. En la página Datos de su conector de datos, obtenga el ID de recogida.

2. Activa una sincronización o un relleno de todos los documentos con tipos de recursos FHIR admitidos.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {
       "seconds": TIMESTAMP_SECONDS,
       "nanos": TIMESTAMP_NANOS
     }
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección cuya transmisión quieres pausar o reanudar.
   • TIMESTAMP_SECONDS: el valor de la marca de tiempo en segundos desde el momento en que quieras importar los documentos. Sigue el formato Timestamp.
   • TIMESTAMP_NANOS: el valor de la marca de tiempo en segundos desde el momento en que quieras importar los documentos. Sigue el formato Timestamp.

   Respuesta

   Deberías recibir una respuesta JSON similar a la siguiente. La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de la sincronización. Para obtener más información, consulta ConnectorRun.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   Si vuelves a llamar al método startConnectorRun mientras se está ejecutando, es posible que se produzca un error.

Eliminar streaming

Para eliminar una operación de streaming, siga estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. En el menú de navegación, haga clic en Almacenes de datos.

   En la página Data Stores (Almacenes de datos) se muestra una lista de los almacenes de datos de tu proyecto Google Cloud con sus detalles.

3. En la lista de almacenes de datos, haz clic en Más opciones del conector de datos que quieras eliminar.

4. Haz clic en Eliminar.

5. En el cuadro de diálogo que aparece, escribe yes (sí) y haz clic en Confirm (Confirmar) para confirmar la eliminación.

REST

1. Busca el ID de tu colección. Si ya tienes el ID de tu colección, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA y, en el menú de navegación, haz clic en Almacenes de datos.

      Ir a la página Almacenes de datos

   2. Haga clic en el nombre del conector de datos cuya transmisión quiera pausar o reanudar.

   3. En la página Datos de su conector de datos, obtenga el ID de recogida.

2. Activa una sincronización o un relleno de todos los documentos con tipos de recursos FHIR admitidos.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {
       "seconds": TIMESTAMP_SECONDS,
       "nanos": TIMESTAMP_NANOS
     }
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección cuya transmisión quieres pausar o reanudar.
   • TIMESTAMP_SECONDS: el valor de la marca de tiempo en segundos desde el momento en que quieras importar los documentos. Sigue el formato Timestamp.
   • TIMESTAMP_NANOS: el valor de la marca de tiempo en segundos desde el momento en que quieras importar los documentos. Sigue el formato Timestamp.

   Respuesta

   Deberías recibir una respuesta JSON similar a la siguiente. La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de la sincronización. Para obtener más información, consulta ConnectorRun.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   Si vuelves a llamar al método startConnectorRun mientras se está ejecutando, es posible que se produzca un error.