Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire un datastore di ricerca sanitaria

Dopo aver creato i datastore 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.

Annulla importazione batch

Per annullare un'operazione di importazione batch in corso:

REST

Trova l'ID operazione per l'operazione di importazione batch. Questo ID operazione è lo stesso restituito quando importi i dati nel tuo archivio dati. Se hai già l'ID operazione, vai al passaggio successivo.
1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.
  
  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 log attività, recupera l'ID operazione.
Annulla 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 batch in corso.
- IMPORT_OPERATION_ID: l'ID dell'operazione di importazione batch 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 Google Cloud console, vai alla pagina AI Applications.

Applicazioni di AI
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel tuo progetto Google Cloudcon i relativi dettagli.
Fai clic sul datastore 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 il flusso o su Riprendi flusso di dati per riprenderlo.

REST

Trova l'ID raccolta. Se hai già l'ID raccolta, vai al passaggio successivo.
1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.
  
  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 Data (Dati) del connettore dati, recupera l'ID raccolta.

Mettere in pausa o riprendere 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 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 campo autoRunDisabled viene restituito solo quando metti in pausa lo streaming dei 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 datastore 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 datastore di Vertex AI Search con l'archivio FHIR dell'API Cloud Healthcare. La sincronizzazione dei dati è possibile solo nei datastore di streaming.

Per sincronizzare tutti i documenti in un datastore di dati di streaming:

Console

Nella Google Cloud console, vai alla pagina AI Applications.

Applicazioni di AI
Nel menu di navigazione, fai clic su Datastore.

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

REST

Trova l'ID raccolta. Se hai già l'ID raccolta, vai al passaggio successivo.
1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.
  
  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 Data (Dati) del connettore dati, recupera 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/v1alpha/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ù, vedi 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 datastore di streaming

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

Per sincronizzare documenti selettivi in un datastore di streaming:

Console

Nella Google Cloud console, vai alla pagina AI Applications.

Applicazioni di AI
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel tuo progetto Google Cloudcon i relativi dettagli.
Seleziona il connettore dati che vuoi sincronizzare.
Nella pagina dei dettagli del datastore, fai clic su Reimporta.
Nel riquadro Reimporta dati, fai clic su , seleziona una data dopo la quale vuoi sincronizzare i dati e fai clic su Chiudi.
Nella sezione Risorse da reimportare, 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 Reimporta.

REST

Trova l'ID raccolta. Se hai già l'ID raccolta, vai al passaggio successivo.
1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.
  
  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 Data (Dati) del connettore dati, recupera l'ID raccolta.
Attiva una sincronizzazione o un backfill di documenti selettivi con 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/v1alpha/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 che vuoi riempire.
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ù, vedi 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 datastore 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 di streaming.

Per sincronizzare i documenti dopo un determinato timestamp:

Console

Nella Google Cloud console, vai alla pagina AI Applications.

Applicazioni di AI
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel tuo progetto Google Cloudcon i relativi dettagli.
Seleziona il connettore dati che vuoi sincronizzare.
Nella pagina dei dettagli del datastore, fai clic su Reimporta.
Nel riquadro Reimporta dati, fai clic su , seleziona una data dopo la quale vuoi sincronizzare i dati e fai clic su Chiudi.
Nella sezione Risorse da reimportare, 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 Reimporta.

REST

Trova l'ID raccolta. Se hai già l'ID raccolta, vai al passaggio successivo.
1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.
  
  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 Data (Dati) del connettore dati, recupera 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/v1alpha/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 da quando vuoi importare i documenti. Segue il formato Timestamp.
- TIMESTAMP_NANOS: il valore del timestamp in secondi da quando vuoi importare i documenti. Segue il 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 saperne di più, vedi 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.

Elimina streaming

Per eliminare un'operazione di streaming:

Console

Nella Google Cloud console, vai alla pagina AI Applications.

Applicazioni di AI
Nel menu di navigazione, fai clic su Datastore.

La pagina Datastore mostra un elenco dei datastore nel tuo progetto Google Cloudcon i relativi dettagli.
Nell'elenco degli archivi dati, fai clic su Altre opzioni per il connettore 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 raccolta. Se hai già l'ID raccolta, vai al passaggio successivo.
1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.
  
  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 Data (Dati) del connettore dati, recupera 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/v1alpha/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 da quando vuoi importare i documenti. Segue il formato Timestamp.
- TIMESTAMP_NANOS: il valore del timestamp in secondi da quando vuoi importare i documenti. Segue il 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 saperne di più, vedi 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.