Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire un datastore di ricerca sanitaria

Dopo aver creato datastore di dati sanitari e importato i dati FHIR R4, puoi eseguire le seguenti operazioni per gestirli:

Annulla importazione batch.
Mettere in pausa o riprendere lo streaming.
Sincronizzazione manuale dei dati in streaming:
Elimina streaming.

Annullare l'importazione collettiva

Per annullare un'operazione di importazione collettiva in corso:

REST

Trova l'ID operazione per l'operazione di importazione collettiva. Questo ID operazione è uguale a quello restituito quando importi i dati nel tuo data store. Se hai già l'ID operazione, vai al passaggio successivo.
1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
  
  Vai alla pagina Datastore
2. Fai clic sul datastore di cui vuoi annullare l'importazione.
3. Nella pagina dei dettagli del datastore, fai clic su Visualizza dettagli. Questa opzione è disponibile solo dopo la creazione e l'avvio dell'operazione di importazione.
4. Nel riquadro Dettagli del log delle attività, ottieni l'ID operazione.
Annullare un'importazione batch in corso.
```
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" \
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo Google Cloud progetto.
- DATA_STORE_ID: l'ID del datastore di cui vuoi annullare l'importazione collettiva in corso.
- IMPORT_OPERATION_ID: l'ID dell'operazione di importazione collettiva in corso che vuoi annullare.
Se l'operazione viene annullata correttamente, dovresti ricevere un oggetto JSON vuoto.

Mettere in pausa o riprendere lo streaming

Per mettere in pausa o riprendere un'operazione di streaming:

Console

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel progetto Google Cloudcon i relativi dettagli.
Fai clic sul data store per cui vuoi mettere in pausa o riprendere lo streaming.
Nella pagina Dati del connettore dati, fai clic su Metti in pausa flusso di dati per mettere in pausa lo streaming o su Riprendi flusso di dati per riprendere lo streaming.

REST

Trova l'ID collezione. Se hai già l'ID collezione, vai al passaggio successivo.
1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
  
  Vai alla pagina Datastore
2. Fai clic sul nome del connettore dati di cui vuoi mettere in pausa o riprendere lo streaming.
3. Nella pagina Dati del connettore dati, ottieni l'ID raccolta.

Metti in pausa o riprendi lo streaming all'interno di un connettore dati.

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

Sostituisci quanto segue:

PROJECT_ID: l'ID del tuo Google Cloud progetto.
COLLECTION_ID: l'ID del connettore di dati di cui vuoi mettere in pausa o riprendere lo streaming.
PAUSE_STREAM_TRUE|FALSE: un valore booleano che, se impostato su true, mette in pausa lo streaming e, se impostato su false, riprende uno streaming in pausa.

Risposta

Dovresti ricevere una risposta JSON simile alla seguente. Il campoautoRunDisabled viene restituito solo quando metti in pausa lo streaming di dati.

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

Sincronizzare tutti i documenti in un data store di streaming

Puoi attivare manualmente un backfill per tutti i documenti con i tipi di risorse FHIR supportati. In questo modo, puoi mantenere aggiornato il tuo datastore Vertex AI Search con il tuo datastore FHIR dell'API Cloud Healthcare. La sincronizzazione dei dati è possibile solo nei datastore in streaming.

Per sincronizzare tutti i documenti in un data store di streaming:

Console

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel progetto Google Cloudcon i relativi dettagli.
Seleziona i dati del connettore dati che vuoi sincronizzare.
Nella pagina dei dettagli del datastore, fai clic su Riimporta.
Nel riquadro Importa di nuovo i dati, fai clic su , seleziona una data dopo la quale vuoi sincronizzare i dati e fai clic su Chiudi.
Nella sezione Risorse da importare di nuovo, seleziona tutti i tipi di risorse FHIR. In questo modo, viene eseguito il backfill di tutti i documenti con i tipi di risorse FHIR supportati.
Fai clic su Importa di nuovo.

REST

Trova l'ID collezione. Se hai già l'ID collezione, vai al passaggio successivo.
1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
  
  Vai alla pagina Datastore
2. Fai clic sul nome del connettore dati di cui vuoi mettere in pausa o riprendere lo streaming.
3. Nella pagina Dati del connettore dati, ottieni l'ID raccolta.
Attivare una sincronizzazione o un backfill di tutti i documenti con i tipi di risorse FHIR supportati.
```
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": {}
}'
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo Google Cloud progetto.
- COLLECTION_ID: l'ID della raccolta di cui vuoi mettere in pausa o riprendere lo streaming.
Risposta

Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene un ID esecuzione del connettore. Il campo state mostra uno degli stati dell'esecuzione della sincronizzazione. Per saperne di più, consulta ConnectorRun.
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
Se chiami di nuovo il metodo startConnectorRun mentre è ancora in esecuzione, potresti ricevere un errore.

Sincronizzare documenti selettivi in un data store di streaming

Puoi importare documenti selezionati con i tipi di risorse FHIR supportati. Questa funzionalità è utile quando vuoi aggiornare il tuo datastore di Vertex AI Search con documenti di determinati tipi di risorse FHIR. La sincronizzazione dei dati è possibile solo nei datastore in streaming.

Per sincronizzare documenti selettivi in un data store di streaming:

Console

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel progetto Google Cloudcon i relativi dettagli.
Seleziona i dati del connettore dati che vuoi sincronizzare.
Nella pagina dei dettagli del datastore, fai clic su Riimporta.
Nel riquadro Importa di nuovo i dati, fai clic su , seleziona una data dopo la quale vuoi sincronizzare i dati e fai clic su Chiudi.
Nella sezione Risorse da importare di nuovo, seleziona tutti i tipi di risorse FHIR che vuoi importare. In questo modo vengono importati tutti i documenti dei tipi di risorse FHIR selezionati.
Fai clic su Importa di nuovo.

REST

Trova l'ID collezione. Se hai già l'ID collezione, vai al passaggio successivo.
1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
  
  Vai alla pagina Datastore
2. Fai clic sul nome del connettore dati di cui vuoi mettere in pausa o riprendere lo streaming.
3. Nella pagina Dati del connettore dati, ottieni l'ID raccolta.
Attivare una sincronizzazione o un backfill di documenti selettivi con i tipi di risorse FHIR supportati.
```
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"
}'
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo Google Cloud progetto.
- COLLECTION_ID: l'ID della raccolta di cui vuoi mettere in pausa o riprendere lo streaming.
- RESOURCE_TYPE: il tipo di risorsa dei documenti FHIR di cui vuoi eseguire il backfill.
Risposta

Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene un ID esecuzione del connettore. Il campo state mostra uno degli stati dell'esecuzione della sincronizzazione. Per ulteriori informazioni, consulta ConnectorRun.
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
Se chiami di nuovo il metodo startConnectorRun mentre è ancora in esecuzione, potresti ricevere un errore.

Sincronizzare i documenti dopo un determinato timestamp in un data store di streaming

Puoi importare documenti selettivi con i tipi di risorse FHIR supportati dopo un determinato timestamp. La sincronizzazione dei dati è possibile solo nei datastore in streaming.

Per sincronizzare i documenti dopo un determinato timestamp:

Console

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel progetto Google Cloudcon i relativi dettagli.
Seleziona i dati del connettore dati che vuoi sincronizzare.
Nella pagina dei dettagli del datastore, fai clic su Riimporta.
Nel riquadro Importa di nuovo i dati, fai clic su , seleziona una data dopo la quale vuoi sincronizzare i dati e fai clic su Chiudi.
Nella sezione Risorse da importare di nuovo, seleziona tutti i tipi di risorse FHIR che vuoi importare. In questo modo vengono importati tutti i documenti dei tipi di risorse FHIR selezionati.
Fai clic su Importa di nuovo.

REST

Trova l'ID collezione. Se hai già l'ID collezione, vai al passaggio successivo.
1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
  
  Vai alla pagina Datastore
2. Fai clic sul nome del connettore dati di cui vuoi mettere in pausa o riprendere lo streaming.
3. Nella pagina Dati del connettore dati, ottieni l'ID raccolta.
Attivare una sincronizzazione o un backfill di tutti i documenti con i tipi di risorse FHIR supportati.
```
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
  }
}'
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo Google Cloud progetto.
- COLLECTION_ID: l'ID della raccolta di cui vuoi mettere in pausa o riprendere lo streaming.
- TIMESTAMP_SECONDS: il valore del timestamp in secondi a partire dal momento in cui vuoi importare i documenti. Deve essere nel formato Timestamp.
- TIMESTAMP_NANOS: il valore del timestamp in secondi a partire dal momento in cui vuoi importare i documenti. Deve essere nel formato Timestamp.
Risposta

Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene un ID esecuzione del connettore. Il campo state mostra uno degli stati dell'esecuzione della sincronizzazione. Per ulteriori informazioni, consulta ConnectorRun.
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
Se chiami di nuovo il metodo startConnectorRun mentre è ancora in esecuzione, potresti ricevere un errore.

Eliminare lo streaming

Per eliminare un'operazione di streaming:

Console

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel progetto Google Cloudcon i relativi dettagli.
Nell'elenco degli archivi dati, fai clic su Altre opzioni per il connettore di dati che vuoi eliminare.
Fai clic su Elimina.
Nella finestra di dialogo visualizzata, digita yes e fai clic su Conferma per confermare l'eliminazione.

REST

Trova l'ID collezione. Se hai già l'ID collezione, vai al passaggio successivo.
1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
  
  Vai alla pagina Datastore
2. Fai clic sul nome del connettore dati di cui vuoi mettere in pausa o riprendere lo streaming.
3. Nella pagina Dati del connettore dati, ottieni l'ID raccolta.
Attivare una sincronizzazione o un backfill di tutti i documenti con i tipi di risorse FHIR supportati.
```
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
  }
}'
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo Google Cloud progetto.
- COLLECTION_ID: l'ID della raccolta di cui vuoi mettere in pausa o riprendere lo streaming.
- TIMESTAMP_SECONDS: il valore del timestamp in secondi a partire dal momento in cui vuoi importare i documenti. Deve essere nel formato Timestamp.
- TIMESTAMP_NANOS: il valore del timestamp in secondi a partire dal momento in cui vuoi importare i documenti. Deve essere nel formato Timestamp.
Risposta

Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene un ID esecuzione del connettore. Il campo state mostra uno degli stati dell'esecuzione della sincronizzazione. Per ulteriori informazioni, consulta ConnectorRun.
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
Se chiami di nuovo il metodo startConnectorRun mentre è ancora in esecuzione, potresti ricevere un errore.