Gérer un datastore de recherche de santé

Après avoir créé des datastores de données de santé et importé des données FHIR R4, vous pouvez effectuer les opérations suivantes pour les gérer:

• Annuler l'importation par lot.
• Mettre en pause ou reprendre la lecture en streaming
• Synchronisation manuelle des données en streaming :
  • Synchronisez tous les documents.
  • Synchroniser des documents de manière sélective
  • Synchroniser les documents après un code temporel donné
• Supprimez le streaming.

Annuler l'importation par lot

Pour annuler une opération d'importation par lot en cours, procédez comme suit:

REST

1. Recherchez l'ID de l'opération d'importation par lot. Cet ID d'opération est identique à celui renvoyé lorsque vous importez les données dans votre entrepôt de données. Si vous disposez déjà de l'ID de l'opération, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder et cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le datastore dont vous souhaitez annuler l'importation.

   3. Sur la page d'informations du data store, cliquez sur Afficher les détails. Cette option n'est disponible qu'une fois l'opération d'importation créée et en cours.

   4. Dans le panneau Détails du journal des activités, obtenez l'ID d'opération.

2. Annuler une importation par lot en cours.

   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" \
   

   Remplacez les éléments suivants :

   • PROJECT_ID: ID de votre Google Cloud projet.
   • DATA_STORE_ID: ID du magasin de données dont vous souhaitez annuler l'importation par lot en cours.
   • IMPORT_OPERATION_ID: ID de l'opération d'importation par lot en cours que vous souhaitez annuler.

   Si l'opération est annulée, vous devriez recevoir un objet JSON vide.

Mettre en pause ou reprendre la lecture en streaming

Pour suspendre ou reprendre une opération de streaming, procédez comme suit:

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

   La page Datastores affiche la liste des datastores de votre projet Google Cloudavec leurs détails.

3. Cliquez sur le datastore pour lequel vous souhaitez suspendre ou reprendre le streaming.

4. Sur la page Données du connecteur de données, cliquez sur Suspendre le streaming de données pour suspendre le streaming ou sur Reprendre le streaming de données pour le reprendre.

REST

1. Recherchez l'ID de votre collection. Si vous disposez déjà de votre ID de collection, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder et cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le nom du connecteur de données dont vous souhaitez suspendre ou reprendre le streaming.

   3. Sur la page Données de votre connecteur de données, obtenez l'ID de la collection.

2. Mettez en pause ou reprenez la diffusion dans un connecteur de données.

   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
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID: ID de votre Google Cloud projet.
   • COLLECTION_ID: ID du connecteur de données dont vous souhaitez suspendre ou reprendre le streaming.
   • PAUSE_STREAM_TRUE|FALSE: valeur booléenne qui, lorsqu'elle est définie sur true, met en pause la diffusion et, lorsqu'elle est définie sur false, reprend une diffusion mise en pause.

   Réponse

   Vous devriez recevoir une réponse JSON semblable à la suivante. Le champ autoRunDisabled n'est renvoyé que lorsque vous mettez en pause le streaming de données.

   {
     "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": {}
   }
   

Synchroniser tous les documents d'un datastore de streaming

Vous pouvez déclencher manuellement un remplissage pour tous les documents avec les types de ressources FHIR compatibles. Vous pouvez ainsi mettre à jour votre data store Vertex AI Search avec votre magasin FHIR de l'API Cloud Healthcare. La synchronisation des données n'est possible que dans les datastores de streaming.

Pour synchroniser tous les documents d'un datastore de streaming, procédez comme suit:

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

   La page Datastores affiche la liste des datastores de votre projet Google Cloudavec leurs détails.

3. Sélectionnez les données du connecteur de données que vous souhaitez synchroniser.

4. Sur la page d'informations du data store, cliquez sur  Réimporter.

5. Dans le volet Réimporter les données, cliquez sur , sélectionnez une date à partir de laquelle vous souhaitez synchroniser les données, puis cliquez sur Fermer.

6. Dans la section Ressources à réimporter, sélectionnez tous les types de ressources FHIR. Tous les documents sont alors renseignés avec les types de ressources FHIR compatibles.

7. Cliquez sur Reimporter.

REST

1. Recherchez l'ID de votre collection. Si vous disposez déjà de votre ID de collection, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder et cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le nom du connecteur de données dont vous souhaitez suspendre ou reprendre le streaming.

   3. Sur la page Données de votre connecteur de données, obtenez l'ID de la collection.

2. Déclencher une synchronisation ou un remplissage de tous les documents avec les types de ressources 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": {}
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID: ID de votre Google Cloud projet.
   • COLLECTION_ID: ID de la collection dont vous souhaitez suspendre ou reprendre le streaming.

   Réponse

   Vous devriez recevoir une réponse JSON semblable à la suivante. La réponse contient un ID d'exécution du connecteur. Le champ state indique l'un des états de l'exécution de la synchronisation. Pour en savoir plus, consultez ConnectorRun.

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

   Si vous appelez à nouveau la méthode startConnectorRun alors qu'elle est toujours en cours d'exécution, une erreur peut s'afficher.

Synchroniser des documents sélectifs dans un magasin de données de streaming

Vous pouvez importer des documents sélectifs avec les types de ressources FHIR compatibles. Cela est utile lorsque vous souhaitez mettre à jour votre datastore Vertex AI Search avec des documents de certains types de ressources FHIR. La synchronisation des données n'est possible que dans les datastores de streaming.

Pour synchroniser des documents sélectifs dans un datastore de streaming, procédez comme suit:

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

   La page Datastores affiche la liste des datastores de votre projet Google Cloudavec leurs détails.

3. Sélectionnez les données du connecteur de données que vous souhaitez synchroniser.

4. Sur la page d'informations du data store, cliquez sur  Réimporter.

5. Dans le volet Réimporter les données, cliquez sur , sélectionnez une date à partir de laquelle vous souhaitez synchroniser les données, puis cliquez sur Fermer.

6. Dans la section Ressources à réimporter, sélectionnez tous les types de ressources FHIR que vous souhaitez importer. Tous les documents des types de ressources FHIR sélectionnés sont alors importés.

7. Cliquez sur Reimporter.

REST

1. Recherchez l'ID de votre collection. Si vous disposez déjà de votre ID de collection, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder et cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le nom du connecteur de données dont vous souhaitez suspendre ou reprendre le streaming.

   3. Sur la page Données de votre connecteur de données, obtenez l'ID de la collection.

2. Déclencher une synchronisation ou un remplissage de documents sélectifs avec des types de ressources 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"
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID: ID de votre Google Cloud projet.
   • COLLECTION_ID: ID de la collection dont vous souhaitez suspendre ou reprendre le streaming.
   • RESOURCE_TYPE: type de ressource des documents FHIR que vous souhaitez remplir.

   Réponse

   Vous devriez recevoir une réponse JSON semblable à la suivante. La réponse contient un ID d'exécution du connecteur. Le champ state indique l'un des états de l'exécution de la synchronisation. Pour en savoir plus, consultez ConnectorRun.

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

   Si vous appelez à nouveau la méthode startConnectorRun alors qu'elle est toujours en cours d'exécution, une erreur peut s'afficher.

Synchroniser les documents après un code temporel donné dans un datastore de flux de données

Vous pouvez importer des documents sélectifs avec les types de ressources FHIR compatibles après un code temporel donné. La synchronisation des données n'est possible que dans les datastores de streaming.

Pour synchroniser des documents après un code temporel donné, procédez comme suit:

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

   La page Datastores affiche la liste des datastores de votre projet Google Cloudavec leurs détails.

3. Sélectionnez les données du connecteur de données que vous souhaitez synchroniser.

4. Sur la page d'informations du data store, cliquez sur  Réimporter.

5. Dans le volet Réimporter les données, cliquez sur , sélectionnez une date à partir de laquelle vous souhaitez synchroniser les données, puis cliquez sur Fermer.

6. Dans la section Ressources à réimporter, sélectionnez tous les types de ressources FHIR que vous souhaitez importer. Tous les documents des types de ressources FHIR sélectionnés sont alors importés.

7. Cliquez sur Reimporter.

REST

1. Recherchez l'ID de votre collection. Si vous disposez déjà de votre ID de collection, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder et cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le nom du connecteur de données dont vous souhaitez suspendre ou reprendre le streaming.

   3. Sur la page Données de votre connecteur de données, obtenez l'ID de la collection.

2. Déclencher une synchronisation ou un remplissage de tous les documents avec les types de ressources 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
     }
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID: ID de votre Google Cloud projet.
   • COLLECTION_ID: ID de la collection dont vous souhaitez suspendre ou reprendre le streaming.
   • TIMESTAMP_SECONDS: valeur du code temporel en secondes à partir de laquelle vous souhaitez importer les documents. Il suit le format Code temporel.
   • TIMESTAMP_NANOS: valeur du code temporel en secondes à partir de laquelle vous souhaitez importer les documents. Il suit le format Code temporel.

   Réponse

   Vous devriez recevoir une réponse JSON semblable à la suivante. La réponse contient un ID d'exécution du connecteur. Le champ state indique l'un des états de l'exécution de la synchronisation. Pour en savoir plus, consultez ConnectorRun.

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

   Si vous appelez à nouveau la méthode startConnectorRun alors qu'elle est toujours en cours d'exécution, une erreur peut s'afficher.

Supprimer le streaming

Pour supprimer une opération de streaming, procédez comme suit:

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

   La page Datastores affiche la liste des datastores de votre projet Google Cloudavec leurs détails.

3. Dans la liste des datastores, cliquez sur Autres options pour le connecteur de données que vous souhaitez supprimer.

4. Cliquez sur Supprimer.

5. Dans la boîte de dialogue qui s'affiche, saisissez yes (Oui) et cliquez sur Confirm (Confirmer) pour confirmer la suppression.

REST

1. Recherchez l'ID de votre collection. Si vous disposez déjà de votre ID de collection, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder et cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le nom du connecteur de données dont vous souhaitez suspendre ou reprendre le streaming.

   3. Sur la page Données de votre connecteur de données, obtenez l'ID de la collection.

2. Déclencher une synchronisation ou un remplissage de tous les documents avec les types de ressources 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
     }
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID: ID de votre Google Cloud projet.
   • COLLECTION_ID: ID de la collection dont vous souhaitez suspendre ou reprendre le streaming.
   • TIMESTAMP_SECONDS: valeur du code temporel en secondes à partir de laquelle vous souhaitez importer les documents. Il suit le format Code temporel.
   • TIMESTAMP_NANOS: valeur du code temporel en secondes à partir de laquelle vous souhaitez importer les documents. Il suit le format Code temporel.

   Réponse

   Vous devriez recevoir une réponse JSON semblable à la suivante. La réponse contient un ID d'exécution du connecteur. Le champ state indique l'un des états de l'exécution de la synchronisation. Pour en savoir plus, consultez ConnectorRun.

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

   Si vous appelez à nouveau la méthode startConnectorRun alors qu'elle est toujours en cours d'exécution, une erreur peut s'afficher.