Administra un almacén de datos de búsqueda de atención médica

Después de crear almacenes de datos de atención médica e importar datos de FHIR R4, puedes realizar las siguientes operaciones para administrarlos:

• Cancela la importación por lotes.
• Pausar o reanudar la transmisión
• Sincronización manual de datos transmitidos:
  • Sincroniza todos los documentos.
  • Sincroniza documentos de forma selectiva.
  • Sincroniza documentos después de una marca de tiempo determinada.
• Borrar transmisión.

Cancela la importación por lotes

Para cancelar una operación de importación por lotes en curso, haz lo siguiente:

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 se muestra cuando importas los datos a tu almacén de datos. Si ya tienes el ID de la operación, ve al siguiente paso.

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

      Ve a la página Almacenes de datos.

   2. Haz clic en el almacén de datos cuya importación deseas cancelar.

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

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

2. Cancela 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" \
   

   Reemplaza lo siguiente:

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

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

Pausar o reanudar la transmisión

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

Console

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

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

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

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

4. En la página Datos del conector de datos, haz clic en Pausar transmisión de datos para pausar la transmisión o en Reanudar 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 consola de Google Cloud, ve a la página Agent Builder y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

   2. Haz clic en el nombre del conector de datos cuyo flujo deseas pausar o reanudar.

   3. En la página Datos de tu conector de datos, obtén el ID de la colección.

2. Pausar o reanudar la transmisión dentro de 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
   }'
   

   Reemplaza lo siguiente:

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

   Respuesta

   Deberías recibir una respuesta JSON similar a la que se muestra a continuación: El campo autoRunDisabled solo se muestra cuando pausas la transmisión 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": {}
   }
   

Sincroniza todos los documentos en un almacén de datos de transmisión

Puedes activar manualmente un reabastecimiento para todos los documentos con los tipos de recursos de FHIR compatibles. Esto te permite mantener tu almacén de datos de Vertex AI Search actualizado con tu almacén de FHIR de la API de Cloud Healthcare. La sincronización de datos solo es posible en almacenes de datos de transmisión.

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

Console

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

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

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

3. Selecciona los datos del conector de datos que quieres sincronizar.

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

5. En el panel Volver a importar datos, haz clic en , selecciona una fecha a partir de la cual deseas sincronizar los datos y haz clic en Cerrar.

6. En la sección Recursos para volver a importar, selecciona todos los tipos de recursos de FHIR. De esta manera, se reabastecen todos los documentos con los tipos de recursos de FHIR compatibles.

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 consola de Google Cloud, ve a la página Agent Builder y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

   2. Haz clic en el nombre del conector de datos cuyo flujo deseas pausar o reanudar.

   3. En la página Datos de tu conector de datos, obtén el ID de la colección.

2. Activa una sincronización o un reabastecimiento de todos los documentos con tipos de recursos de 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/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {}
   }'
   

   Reemplaza lo siguiente:

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

   Respuesta

   Deberías recibir una respuesta JSON similar a la que se muestra a continuación: La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de 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 aún se está ejecutando, es posible que recibas un error.

Sincroniza documentos selectivos en un almacén de datos de transmisión

Puedes importar documentos de forma selectiva con los tipos de recursos de FHIR admitidos. Esto es útil cuando deseas actualizar tu almacén de datos de Vertex AI Search con documentos de ciertos tipos de recursos de FHIR. La sincronización de datos solo es posible en los almacenes de datos de transmisión.

Para sincronizar documentos selectivos en un almacén de datos de transmisión, haz lo siguiente:

Console

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

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

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

3. Selecciona los datos del conector de datos que quieres sincronizar.

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

5. En el panel Volver a importar datos, haz clic en , selecciona una fecha a partir de la cual deseas sincronizar los datos y haz clic en Cerrar.

6. En la sección Reimportar recursos, selecciona todos los tipos de recursos de FHIR que deseas importar. De esta manera, se importan todos los documentos de los tipos de recursos de 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 consola de Google Cloud, ve a la página Agent Builder y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

   2. Haz clic en el nombre del conector de datos cuyo flujo deseas pausar o reanudar.

   3. En la página Datos de tu conector de datos, obtén el ID de la colección.

2. Activa una sincronización o un reabastecimiento de documentos selectivos con tipos de recursos de 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/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {},
     "healthcareFhirResourceTypes": "Patient",
     "healthcareFhirResourceTypes": "RESOURCE_TYPE"
   }'
   

   Reemplaza lo siguiente:

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

   Respuesta

   Deberías recibir una respuesta JSON similar a la que se muestra a continuación: La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de 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 aún se está ejecutando, es posible que recibas un error.

Sincroniza documentos después de una marca de tiempo determinada en un almacén de datos de transmisión

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

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

Console

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

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

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

3. Selecciona los datos del conector de datos que quieres sincronizar.

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

5. En el panel Volver a importar datos, haz clic en , selecciona una fecha a partir de la cual deseas sincronizar los datos y haz clic en Cerrar.

6. En la sección Reimportar recursos, selecciona todos los tipos de recursos de FHIR que deseas importar. De esta manera, se importan todos los documentos de los tipos de recursos de 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 consola de Google Cloud, ve a la página Agent Builder y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

   2. Haz clic en el nombre del conector de datos cuyo flujo deseas pausar o reanudar.

   3. En la página Datos de tu conector de datos, obtén el ID de la colección.

2. Activa una sincronización o un reabastecimiento de todos los documentos con tipos de recursos de 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/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {
       "seconds": TIMESTAMP_SECONDS,
       "nanos": TIMESTAMP_NANOS
     }
   }'
   

   Reemplaza lo siguiente:

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

   Respuesta

   Deberías recibir una respuesta JSON similar a la que se muestra a continuación: La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de 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 aún se está ejecutando, es posible que recibas un error.

Borra la transmisión

Para borrar una operación de transmisión, haz lo siguiente:

Console

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

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

   En la página 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 para el conector de datos que deseas borrar.

4. Haz clic en Borrar.

5. En el diálogo que aparece, escribe sí y haz clic en 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 consola de Google Cloud, ve a la página Agent Builder y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

   2. Haz clic en el nombre del conector de datos cuyo flujo deseas pausar o reanudar.

   3. En la página Datos de tu conector de datos, obtén el ID de la colección.

2. Activa una sincronización o un reabastecimiento de todos los documentos con tipos de recursos de 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/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {
       "seconds": TIMESTAMP_SECONDS,
       "nanos": TIMESTAMP_NANOS
     }
   }'
   

   Reemplaza lo siguiente:

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

   Respuesta

   Deberías recibir una respuesta JSON similar a la que se muestra a continuación: La respuesta contiene un ID de ejecución del conector. El campo state muestra uno de los estados de la ejecución de 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 aún se está ejecutando, es posible que recibas un error.