Faça a gestão de um repositório de dados de pesquisa de cuidados de saúde

Depois de criar repositórios de dados de cuidados de saúde e importar dados FHIR R4, pode realizar as seguintes operações para os gerir:

• Cancelar importação em lote.
• Pausar ou retomar o streaming.
• Sincronização manual de dados transmitidos:
  • Sincronizar todos os documentos.
  • Sincronize documentos seletivos.
  • Sincronizar documentos após uma determinada data/hora.
• Eliminar streaming.

Cancele a importação em lote

Para cancelar uma operação de importação em lote em curso, faça o seguinte:

REST

1. Encontre o ID da operação de importação em lote. Este ID da operação é igual ao devolvido quando importa os dados para o seu repositório de dados. Se já tiver o ID da operação, avance para o passo seguinte.

   1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

   2. Clique no arquivo de dados cuja importação quer cancelar.

   3. Na página de detalhes da loja de dados, clique em Ver detalhes. Esta opção só está disponível depois de a operação de importação ser criada e estar em curso.

   4. No painel Detalhes do Registo de atividade, obtenha o ID da operação.

2. Cancele uma importação em lote em 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" \
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .
   • DATA_STORE_ID: o ID do armazenamento de dados cuja importação em lote em curso quer cancelar.
   • IMPORT_OPERATION_ID: o ID da operação de importação em lote em curso que quer cancelar.

   Se a operação for cancelada com êxito, deve receber um objeto JSON vazio.

Pausar ou retomar o streaming

Para pausar ou retomar uma operação de streaming, faça o seguinte:

Consola

1. Na Google Cloud consola, aceda à página Aplicações de IA.

   Aplicações de IA

2. No menu de navegação, clique em Armazenamentos de dados.

   A página Armazenamentos de dados apresenta uma lista de armazenamentos de dados no seu Google Cloud projeto com os respetivos detalhes.

3. Clique no arquivo de dados para o qual quer pausar ou retomar o streaming.

4. Na página Dados do conetor de dados, clique em Pausar streaming de dados para pausar o streaming ou em Retomar streaming de dados para retomar o streaming de dados.

REST

1. Encontre o ID da coleção. Se já tiver o ID da coleção, avance para o passo seguinte.

   1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

   2. Clique no nome do conector de dados cuja transmissão quer pausar ou retomar.

   3. Na página Dados do conetor de dados, obtenha o ID de recolha.

2. Pause ou retome o streaming num conetor de dados.

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

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .
   • COLLECTION_ID: o ID do conetor de dados cuja transmissão em stream quer pausar ou retomar.
   • PAUSE_STREAM_TRUE|FALSE: um valor booleano que, quando definido como true, pausa o streaming e, quando definido como false, retoma um streaming pausado.

   Resposta

   Deve receber uma resposta JSON semelhante à seguinte. O campo autoRunDisabled só é devolvido quando pausa o streaming de dados.

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

Sincronize todos os documentos num arquivo de dados de streaming

Pode acionar manualmente um preenchimento para todos os documentos com os tipos de recursos FHIR suportados. Isto permite-lhe manter o seu arquivo de dados do Vertex AI Search atualizado com o seu arquivo FHIR da Cloud Healthcare API. A sincronização de dados só é possível em armazenamentos de dados de streaming.

Para sincronizar todos os documentos num arquivo de dados de streaming, faça o seguinte:

Consola

1. Na Google Cloud consola, aceda à página Aplicações de IA.

   Aplicações de IA

2. No menu de navegação, clique em Armazenamentos de dados.

   A página Armazenamentos de dados apresenta uma lista de armazenamentos de dados no seu Google Cloud projeto com os respetivos detalhes.

3. Selecione os dados do conetor de dados que quer sincronizar.

4. Na página de detalhes do arquivo de dados, clique em Reimportar.

5. No painel Reimporte dados, clique em , selecione uma data após a qual quer sincronizar os dados e clique em Fechar.

6. Na secção Recursos a reimportar, selecione todos os tipos de recursos FHIR. Ao fazê-lo, preenche todos os documentos com os tipos de recursos FHIR suportados.

7. Clique em Reimportar.

REST

1. Encontre o ID da coleção. Se já tiver o ID da coleção, avance para o passo seguinte.

   1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

   2. Clique no nome do conector de dados cuja transmissão quer pausar ou retomar.

   3. Na página Dados do conetor de dados, obtenha o ID de recolha.

2. Acionar uma sincronização ou um preenchimento de todos os documentos com tipos de recursos FHIR suportados.

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

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cuja transmissão quer pausar ou retomar.

   Resposta

   Deve receber uma resposta JSON semelhante à seguinte. A resposta contém um ID de execução do conetor. O campo state mostra um dos estados da execução da sincronização. Para mais informações, consulte o artigo ConnectorRun.

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

   Se chamar o método startConnectorRun novamente enquanto ainda estiver em execução, pode receber um erro.

Sincronize documentos seletivos num arquivo de dados de streaming

Pode importar documentos seletivos com os tipos de recursos FHIR suportados. Isto é útil quando quer atualizar o seu repositório de dados do Vertex AI Search com documentos de determinados tipos de recursos FHIR. A sincronização de dados só é possível em armazenamentos de dados de streaming.

Para sincronizar documentos seletivos num arquivo de dados de streaming, faça o seguinte:

Consola

1. Na Google Cloud consola, aceda à página Aplicações de IA.

   Aplicações de IA

2. No menu de navegação, clique em Armazenamentos de dados.

   A página Armazenamentos de dados apresenta uma lista de armazenamentos de dados no seu Google Cloud projeto com os respetivos detalhes.

3. Selecione os dados do conetor de dados que quer sincronizar.

4. Na página de detalhes do arquivo de dados, clique em Reimportar.

5. No painel Reimporte dados, clique em , selecione uma data após a qual quer sincronizar os dados e clique em Fechar.

6. Na secção Recursos a reimportar, selecione todos os tipos de recursos FHIR que quer importar. Ao fazê-lo, importa todos os documentos dos tipos de recursos FHIR selecionados.

7. Clique em Reimportar.

REST

1. Encontre o ID da coleção. Se já tiver o ID da coleção, avance para o passo seguinte.

   1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

   2. Clique no nome do conector de dados cuja transmissão quer pausar ou retomar.

   3. Na página Dados do conetor de dados, obtenha o ID de recolha.

2. Acionar uma sincronização ou um preenchimento de documentos seletivos com tipos de recursos FHIR suportados.

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

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cuja transmissão quer pausar ou retomar.
   • RESOURCE_TYPE: o tipo de recurso dos documentos FHIR que quer preencher.

   Resposta

   Deve receber uma resposta JSON semelhante à seguinte. A resposta contém um ID de execução do conetor. O campo state mostra um dos estados da execução da sincronização. Para mais informações, consulte o artigo ConnectorRun.

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

   Se chamar o método startConnectorRun novamente enquanto ainda estiver em execução, pode receber um erro.

Sincronize documentos após uma determinada indicação de tempo num arquivo de dados de streaming

Pode importar documentos seletivos com os tipos de recursos FHIR suportados após uma determinada data/hora. A sincronização de dados só é possível em armazenamentos de dados de streaming.

Para sincronizar documentos após uma determinada data/hora, faça o seguinte:

Consola

1. Na Google Cloud consola, aceda à página Aplicações de IA.

   Aplicações de IA

2. No menu de navegação, clique em Armazenamentos de dados.

   A página Armazenamentos de dados apresenta uma lista de armazenamentos de dados no seu Google Cloud projeto com os respetivos detalhes.

3. Selecione os dados do conetor de dados que quer sincronizar.

4. Na página de detalhes do arquivo de dados, clique em Reimportar.

5. No painel Reimporte dados, clique em , selecione uma data após a qual quer sincronizar os dados e clique em Fechar.

6. Na secção Recursos a reimportar, selecione todos os tipos de recursos FHIR que quer importar. Ao fazê-lo, importa todos os documentos dos tipos de recursos FHIR selecionados.

7. Clique em Reimportar.

REST

1. Encontre o ID da coleção. Se já tiver o ID da coleção, avance para o passo seguinte.

   1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

   2. Clique no nome do conector de dados cuja transmissão quer pausar ou retomar.

   3. Na página Dados do conetor de dados, obtenha o ID de recolha.

2. Acionar uma sincronização ou um preenchimento de todos os documentos com tipos de recursos FHIR suportados.

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

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cuja transmissão quer pausar ou retomar.
   • TIMESTAMP_SECONDS: o valor da data/hora em segundos desde quando quer importar os documentos. Segue o formato Data/hora.
   • TIMESTAMP_NANOS: o valor da data/hora em segundos desde quando quer importar os documentos. Segue o formato Data/hora.

   Resposta

   Deve receber uma resposta JSON semelhante à seguinte. A resposta contém um ID de execução do conetor. O campo state mostra um dos estados da execução da sincronização. Para mais informações, consulte o artigo ConnectorRun.

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

   Se chamar o método startConnectorRun novamente enquanto ainda estiver em execução, pode receber um erro.

Elimine o streaming

Para eliminar uma operação de streaming, faça o seguinte:

Consola

1. Na Google Cloud consola, aceda à página Aplicações de IA.

   Aplicações de IA

2. No menu de navegação, clique em Armazenamentos de dados.

   A página Armazenamentos de dados apresenta uma lista de armazenamentos de dados no seu Google Cloud projeto com os respetivos detalhes.

3. Na lista das bases de dados, clique em Mais opções para o conetor de dados que quer eliminar.

4. Clique em Eliminar.

5. Na caixa de diálogo apresentada, escreva sim e clique em Confirmar para confirmar a eliminação.

REST

1. Encontre o ID da coleção. Se já tiver o ID da coleção, avance para o passo seguinte.

   1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

   2. Clique no nome do conector de dados cuja transmissão quer pausar ou retomar.

   3. Na página Dados do conetor de dados, obtenha o ID de recolha.

2. Acionar uma sincronização ou um preenchimento de todos os documentos com tipos de recursos FHIR suportados.

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

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cuja transmissão quer pausar ou retomar.
   • TIMESTAMP_SECONDS: o valor da data/hora em segundos desde quando quer importar os documentos. Segue o formato Data/hora.
   • TIMESTAMP_NANOS: o valor da data/hora em segundos desde quando quer importar os documentos. Segue o formato Data/hora.

   Resposta

   Deve receber uma resposta JSON semelhante à seguinte. A resposta contém um ID de execução do conetor. O campo state mostra um dos estados da execução da sincronização. Para mais informações, consulte o artigo ConnectorRun.

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

   Se chamar o método startConnectorRun novamente enquanto ainda estiver em execução, pode receber um erro.