Gerenciar um repositório de dados de pesquisa de saúde

Depois de criar armazenamentos de dados de saúde e importar dados do FHIR R4, você pode realizar as seguintes operações para gerenciá-los:

• Cancelar a importação em lote.
• Pausar ou retomar o streaming.
• Sincronização manual de dados transmitidos por streaming:
  • Sincronizar todos os documentos.
  • Sincronizar documentos seletivos.
  • Sincronize documentos após um determinado carimbo de data/hora.
• Excluir streaming.

Cancelar importação em lote

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

REST

1. Encontre o ID da operação de importação em lote. Esse ID de operação é o mesmo que é retornado quando você importa os dados para a armazenagem. Se você já tiver o ID da operação, pule para a próxima etapa.

   1. No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no armazenamento de dados que você quer cancelar.

   3. Na página de detalhes do repositório de dados, clique em Ver detalhes. Essa opção só fica disponível depois que a operação de importação é criada e está em andamento.

   4. No painel Detalhes do registro de atividades, confira o ID da operação.

2. Cancelar uma importação em lote em andamento.

   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:

   • PROJECT_ID: o ID do projeto Google Cloud .
   • DATA_STORE_ID: o ID do repositório de dados com a importação em lote em andamento que você quer cancelar.
   • IMPORT_OPERATION_ID: o ID da operação de importação em lote que você quer cancelar.

   Se a operação for cancelada, você vai receber um objeto JSON vazio.

Pausar ou retomar a transmissão

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

Console

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. No menu de navegação, clique em Repositórios de dados.

   A página Armazenamentos de dados mostra uma lista de repositórios de dados no projeto Google Cloud com os detalhes deles.

3. Clique no repositório de dados em que você quer pausar ou retomar o streaming.

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

REST

1. Encontre o ID da coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.

   1. No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no nome do conector de dados cujo streaming você quer pausar ou retomar.

   3. Na página Dados do conector de dados, encontre o ID da coletora.

2. Pausar ou retomar o streaming em um conector 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:

   • PROJECT_ID: o ID do projeto Google Cloud .
   • COLLECTION_ID: o ID do conector de dados cujo streaming você quer pausar ou retomar.
   • PAUSE_STREAM_TRUE|FALSE: um booleano que, quando definido como true, pausa o streaming e, quando definido como false, retoma um streaming pausado.

   Resposta

   Você receberá uma resposta JSON semelhante a seguinte. O campo autoRunDisabled só é retornado quando você 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": {}
   }
   

Sincronizar todos os documentos em um repositório de dados de streaming

É possível acionar manualmente um preenchimento para todos os documentos com os tipos de recursos FHIR compatíveis. Assim, você mantém o repositório de dados da Vertex AI Search atualizado com o armazenamento FHIR da API Cloud Healthcare. A sincronização de dados só é possível em repositórios de dados de streaming.

Para sincronizar todos os documentos em um repositório de dados de streaming, faça o seguinte:

Console

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. No menu de navegação, clique em Repositórios de dados.

   A página Armazenamentos de dados mostra uma lista de repositórios de dados no projeto Google Cloud com os detalhes deles.

3. Selecione os dados do conector que você quer sincronizar.

4. Na página de detalhes do repositório de dados, clique em Importar novamente.

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

6. Na seção Recursos a serem reimportados, selecione todos os tipos de recurso do FHIR. Isso preenche todos os documentos com os tipos de recurso FHIR com suporte.

7. Clique em Importar novamente.

REST

1. Encontre o ID da coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.

   1. No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no nome do conector de dados cujo streaming você quer pausar ou retomar.

   3. Na página Dados do conector de dados, encontre o ID da coletora.

2. Acionar uma sincronização ou preenchimento de todos os documentos com tipos de recurso FHIR compatíveis.

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

   Substitua:

   • PROJECT_ID: o ID do projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cujo streaming você quer pausar ou retomar.

   Resposta

   Você receberá uma resposta JSON semelhante a seguinte. A resposta contém um ID de execução do conector. O campo state mostra um dos estados da execução de sincronização. Para mais informações, consulte ConnectorRun.

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

   Se você chamar o método startConnectorRun novamente enquanto ele ainda estiver em execução, poderá receber um erro.

Sincronizar documentos seletivos em um repositório de dados de streaming

É possível importar documentos seletivos com os tipos de recursos FHIR compatíveis. Isso é útil quando você quer atualizar o repositório de dados da Vertex AI para Pesquisa com documentos de determinados tipos de recursos do FHIR. A sincronização de dados só é possível em repositórios de dados de streaming.

Para sincronizar documentos seletivos em um repositório de dados de streaming, faça o seguinte:

Console

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. No menu de navegação, clique em Repositórios de dados.

   A página Armazenamentos de dados mostra uma lista de repositórios de dados no projeto Google Cloud com os detalhes deles.

3. Selecione o conector de dados que você quer sincronizar.

4. Na página de detalhes do repositório de dados, clique em Importar novamente.

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

6. Na seção Recursos a serem reimportados, selecione todos os tipos de recurso FHIR que você quer importar. Isso importa todos os documentos dos tipos de recursos FHIR selecionados.

7. Clique em Importar novamente.

REST

1. Encontre o ID da coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.

   1. No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no nome do conector de dados cujo streaming você quer pausar ou retomar.

   3. Na página Dados do conector de dados, encontre o ID da coletora.

2. Acionar uma sincronização ou preenchimento de documentos seletivos com tipos de recurso FHIR compatíveis.

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

   Substitua:

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

   Resposta

   Você receberá uma resposta JSON semelhante a seguinte. A resposta contém um ID de execução do conector. O campo state mostra um dos estados da execução de sincronização. Para mais informações, consulte ConnectorRun.

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

   Se você chamar o método startConnectorRun novamente enquanto ele ainda estiver em execução, poderá receber um erro.

Sincronizar documentos após um determinado carimbo de data/hora em um repositório de dados de streaming

É possível importar documentos seletivos com os tipos de recurso FHIR compatíveis após um determinado carimbo de data/hora. A sincronização de dados só é possível em repositórios de dados de streaming.

Para sincronizar documentos após um determinado carimbo de data/hora, faça o seguinte:

Console

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. No menu de navegação, clique em Repositórios de dados.

   A página Armazenamentos de dados mostra uma lista de repositórios de dados no projeto Google Cloud com os detalhes deles.

3. Selecione o conector de dados que você quer sincronizar.

4. Na página de detalhes do repositório de dados, clique em Importar novamente.

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

6. Na seção Recursos a serem reimportados, selecione todos os tipos de recurso FHIR que você quer importar. Isso importa todos os documentos dos tipos de recursos FHIR selecionados.

7. Clique em Importar novamente.

REST

1. Encontre o ID da coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.

   1. No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no nome do conector de dados cujo streaming você quer pausar ou retomar.

   3. Na página Dados do conector de dados, encontre o ID da coletora.

2. Acionar uma sincronização ou preenchimento de todos os documentos com tipos de recurso FHIR compatíveis.

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

   Substitua:

   • PROJECT_ID: o ID do projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cujo streaming você quer pausar ou retomar.
   • TIMESTAMP_SECONDS: o valor do carimbo de data/hora em segundos desde quando você quer importar os documentos. Ele segue o formato Carimbo de data/hora.
   • TIMESTAMP_NANOS: o valor do carimbo de data/hora em segundos desde quando você quer importar os documentos. Ele segue o formato Carimbo de data/hora.

   Resposta

   Você receberá uma resposta JSON semelhante a seguinte. A resposta contém um ID de execução do conector. O campo state mostra um dos estados da execução de sincronização. Para mais informações, consulte ConnectorRun.

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

   Se você chamar o método startConnectorRun novamente enquanto ele ainda estiver em execução, poderá receber um erro.

Excluir streaming

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

Console

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. No menu de navegação, clique em Repositórios de dados.

   A página Armazenamentos de dados mostra uma lista de repositórios de dados no projeto Google Cloud com os detalhes deles.

3. Na lista de armazenamentos de dados, clique em Mais opções para o conector de dados que você quer excluir.

4. Clique em Excluir.

5. Na caixa de diálogo que aparece, digite yes e clique em Confirm para confirmar a exclusão.

REST

1. Encontre o ID da coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.

   1. No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no nome do conector de dados cujo streaming você quer pausar ou retomar.

   3. Na página Dados do conector de dados, encontre o ID da coletora.

2. Acionar uma sincronização ou preenchimento de todos os documentos com tipos de recurso FHIR compatíveis.

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

   Substitua:

   • PROJECT_ID: o ID do projeto Google Cloud .
   • COLLECTION_ID: o ID da coleção cujo streaming você quer pausar ou retomar.
   • TIMESTAMP_SECONDS: o valor do carimbo de data/hora em segundos desde quando você quer importar os documentos. Ele segue o formato carimbo de data/hora.
   • TIMESTAMP_NANOS: o valor do carimbo de data/hora em segundos desde quando você quer importar os documentos. Ele segue o formato Carimbo de data/hora.

   Resposta

   Você receberá uma resposta JSON semelhante a seguinte. A resposta contém um ID de execução do conector. O campo state mostra um dos estados da execução de sincronização. Para mais informações, consulte ConnectorRun.

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

   Se você chamar o método startConnectorRun novamente enquanto ele ainda estiver em execução, poderá receber um erro.