Gérer un datastore de recherche de santé

Une fois que vous avez 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 le streaming
• Synchronisation manuelle des données diffusées :
  • Synchronisez tous les documents.
  • Synchronisez des documents spécifiques.
  • Synchronisez les documents après un code temporel donné.
• Supprimer la diffusion.

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 d'opération pour l'opération d'importation par lot. Cet ID d'opération est identique à celui renvoyé lorsque vous importez les données dans votre data store. Si vous avez déjà votre ID d'opération, passez à l'étape suivante.

   1. Dans la console Google Cloud , accédez à la page Applications d'IA et cliquez sur Data stores dans le menu de navigation.

      Accéder à la page "Data stores"

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

   3. Sur la page des détails 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 d'activité, 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 projet Google Cloud .
   • DATA_STORE_ID : ID du data store 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 avec succès, vous devriez recevoir un objet JSON vide.

Mettre en pause ou reprendre le streaming

Pour suspendre ou reprendre une opération de streaming :

Console

1. Dans la console Google Cloud , accédez à la page AI Applications.

   AI Applications

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

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

3. Cliquez sur le data store 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. Trouvez l'ID de votre collection. Si vous avez déjà l'ID de votre collection, passez à l'étape suivante.

   1. Dans la console Google Cloud , accédez à la page Applications d'IA et cliquez sur Data stores dans le menu de navigation.

      Accéder à la page "Data stores"

   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. Mettre en pause ou reprendre 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 projet Google Cloud .
   • COLLECTION_ID : ID du connecteur de données dont vous souhaitez suspendre ou reprendre le flux.
   • PAUSE_STREAM_TRUE|FALSE : valeur booléenne. Si elle est définie sur true, la diffusion est suspendue. Si elle est définie sur false, la diffusion suspendue reprend.

   Réponse

   Vous devriez recevoir une réponse JSON semblable à la suivante. Le champ autoRunDisabled n'est renvoyé que lorsque vous suspendez le flux 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 flux de données

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

Pour synchroniser tous les documents d'un data store de flux, procédez comme suit :

Console

1. Dans la console Google Cloud , accédez à la page AI Applications.

   AI Applications

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

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

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

4. Sur la page des détails du data store, cliquez sur Réimporter.

5. Dans le volet Réimporter les données, cliquez sur , sélectionnez une date après 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. Cela permet de remplir tous les documents avec les types de ressources FHIR compatibles.

7. Cliquez sur Réimporter.

REST

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

   1. Dans la console Google Cloud , accédez à la page Applications d'IA et cliquez sur Data stores dans le menu de navigation.

      Accéder à la page "Data stores"

   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éclenchez 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/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {}
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet Google Cloud .
   • 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 affiche 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, vous risquez de recevoir une erreur.

Synchroniser des documents spécifiques dans un data store de flux

Vous pouvez importer des documents spécifiques avec les types de ressources FHIR compatibles. Cela s'avère utile lorsque vous souhaitez mettre à jour votre data store 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 flux.

Pour synchroniser des documents spécifiques dans un datastore de flux de données, procédez comme suit :

Console

1. Dans la console Google Cloud , accédez à la page AI Applications.

   AI Applications

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

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

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

4. Sur la page des détails du data store, cliquez sur Réimporter.

5. Dans le volet Réimporter les données, cliquez sur , sélectionnez une date après 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. Cela permet d'importer tous les documents des types de ressources FHIR sélectionnés.

7. Cliquez sur Réimporter.

REST

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

   1. Dans la console Google Cloud , accédez à la page Applications d'IA et cliquez sur Data stores dans le menu de navigation.

      Accéder à la page "Data stores"

   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éclenchez une synchronisation ou un remplissage de documents sélectifs 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/v1alpha/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 projet Google Cloud .
   • 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 compléter.

   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 affiche 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, vous risquez de recevoir une erreur.

Synchroniser les documents après un code temporel donné dans un data store de flux

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 flux.

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

Console

1. Dans la console Google Cloud , accédez à la page AI Applications.

   AI Applications

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

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

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

4. Sur la page des détails du data store, cliquez sur Réimporter.

5. Dans le volet Réimporter les données, cliquez sur , sélectionnez une date après 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. Cela permet d'importer tous les documents des types de ressources FHIR sélectionnés.

7. Cliquez sur Réimporter.

REST

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

   1. Dans la console Google Cloud , accédez à la page Applications d'IA et cliquez sur Data stores dans le menu de navigation.

      Accéder à la page "Data stores"

   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éclenchez 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/v1alpha/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 projet Google Cloud .
   • COLLECTION_ID : ID de la collection dont vous souhaitez suspendre ou reprendre le streaming.
   • TIMESTAMP_SECONDS : valeur du code temporel en secondes depuis la date à laquelle vous souhaitez importer les documents. Il suit le format Timestamp.
   • TIMESTAMP_NANOS : valeur du code temporel en secondes depuis la date à laquelle vous souhaitez importer les documents. Il suit le format Timestamp.

   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 affiche 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, vous risquez de recevoir une erreur.

Supprimer le streaming

Pour supprimer une opération de streaming :

Console

1. Dans la console Google Cloud , accédez à la page AI Applications.

   AI Applications

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

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

3. Dans la liste des data stores, cliquez sur Plus d'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 oui, puis cliquez sur Confirmer pour confirmer la suppression.

REST

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

   1. Dans la console Google Cloud , accédez à la page Applications d'IA et cliquez sur Data stores dans le menu de navigation.

      Accéder à la page "Data stores"

   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éclenchez 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/v1alpha/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 projet Google Cloud .
   • COLLECTION_ID : ID de la collection dont vous souhaitez suspendre ou reprendre le streaming.
   • TIMESTAMP_SECONDS : valeur du code temporel en secondes depuis la date à laquelle vous souhaitez importer les documents. Il suit le format Timestamp.
   • TIMESTAMP_NANOS : valeur du code temporel en secondes depuis la date à laquelle vous souhaitez importer les documents. Il suit le format Timestamp.

   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 affiche 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, vous risquez de recevoir une erreur.