Esta página foi traduzida pela API Cloud Translation.

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

Depois de criar repositórios de dados de saúde e importar dados do FHIR R4, é possível realizar as seguintes operações para gerenciá-los:

Cancelar importação em lote.
Pausar ou retomar o streaming.
Sincronização manual de dados transmitidos:
Excluir transmissão.

Cancelar importação em lote

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

REST

Encontre o ID da operação de importação em lote. Esse ID de operação é o mesmo retornado quando você importa os dados para seu repositório de dados. Se você já tiver o ID da operação, pule para a próxima etapa.
1. No console Google Cloud , acesse a página Aplicativos de IA e, no menu de navegação, clique em Repositórios de dados.
  
  Acesse a página "Repositórios de dados"
2. Clique no repositório de dados cuja importação 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, encontre o ID da operação.
Cancela 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 seu Google Cloud projeto.
- DATA_STORE_ID: o ID do repositório de dados cuja importação em lote em andamento você quer cancelar.
- IMPORT_OPERATION_ID: o ID da operação de importação em lote em andamento que você quer cancelar.
Se a operação for cancelada, você vai receber um objeto JSON vazio.

Pausar ou retomar o streaming

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

Console

No console Google Cloud , acesse a página Aplicativos de IA.

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

A página Repositórios de dados mostra uma lista de repositórios no seu projeto Google Cloudcom os detalhes deles.
Clique no repositório de dados em que você quer pausar ou retomar o streaming.
Na página Dados do conector de dados, clique em Pausar o fluxo de dados para pausar ou em Retomar o fluxo de dados para retomar.

REST

Encontre o ID da sua coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.
1. No console Google Cloud , acesse a página Aplicativos de IA 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 que você quer pausar ou retomar.
3. Na página Dados do seu conector de dados, encontre o ID da coleta.

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 seu Google Cloud projeto.
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

No console Google Cloud , acesse a página Aplicativos de IA.

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

A página Repositórios de dados mostra uma lista de repositórios no seu projeto Google Cloudcom os detalhes deles.
Selecione os dados e o conector que você quer sincronizar.
Na página de detalhes do repositório de dados, clique em Reimportar.
No painel Reimportar dados, clique em , selecione uma data após a qual você quer sincronizar os dados e clique em Fechar.
Na seção Recursos a serem reimportados, selecione todos os tipos de recursos do FHIR. Isso preenche todos os documentos com os tipos de recursos FHIR compatíveis.
Clique em Importar novamente.

REST

Encontre o ID da sua coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.
1. No console Google Cloud , acesse a página Aplicativos de IA 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 que você quer pausar ou retomar.
3. Na página Dados do seu conector de dados, encontre o ID da coleta.
Aciona uma sincronização ou um backfill de todos os documentos com tipos de recursos 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/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
-d ' {
  "syncSinceTimestamp": {}
}'
```
Substitua:
- PROJECT_ID: o ID do seu Google Cloud projeto.
- COLLECTION_ID: o ID da coleção cuja transmissão 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 da 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 seu 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

No console Google Cloud , acesse a página Aplicativos de IA.

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

A página Repositórios de dados mostra uma lista de repositórios no seu projeto Google Cloudcom os detalhes deles.
Selecione os dados e o conector que você quer sincronizar.
Na página de detalhes do repositório de dados, clique em Reimportar.
No painel Reimportar dados, clique em , selecione uma data após a qual você quer sincronizar os dados e clique em Fechar.
Na seção Recursos a serem reimportados, selecione todos os tipos de recursos FHIR que você quer importar. Isso importa todos os documentos dos tipos de recursos FHIR selecionados.
Clique em Importar novamente.

REST

Encontre o ID da sua coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.
1. No console Google Cloud , acesse a página Aplicativos de IA 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 que você quer pausar ou retomar.
3. Na página Dados do seu conector de dados, encontre o ID da coleta.
Acione uma sincronização ou um backfill de documentos seletivos com tipos de recursos 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/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
-d ' {
  "syncSinceTimestamp": {},
  "healthcareFhirResourceTypes": "Patient",
  "healthcareFhirResourceTypes": "RESOURCE_TYPE"
}'
```
Substitua:
- PROJECT_ID: o ID do seu Google Cloud projeto.
- COLLECTION_ID: o ID da coleção cuja transmissão 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 da 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 recursos 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

No console Google Cloud , acesse a página Aplicativos de IA.

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

A página Repositórios de dados mostra uma lista de repositórios no seu projeto Google Cloudcom os detalhes deles.
Selecione os dados e o conector que você quer sincronizar.
Na página de detalhes do repositório de dados, clique em Reimportar.
No painel Reimportar dados, clique em , selecione uma data após a qual você quer sincronizar os dados e clique em Fechar.
Na seção Recursos a serem reimportados, selecione todos os tipos de recursos FHIR que você quer importar. Isso importa todos os documentos dos tipos de recursos FHIR selecionados.
Clique em Importar novamente.

REST

Encontre o ID da sua coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.
1. No console Google Cloud , acesse a página Aplicativos de IA 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 que você quer pausar ou retomar.
3. Na página Dados do seu conector de dados, encontre o ID da coleta.
Aciona uma sincronização ou um backfill de todos os documentos com tipos de recursos 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/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
-d ' {
  "syncSinceTimestamp": {
    "seconds": TIMESTAMP_SECONDS,
    "nanos": TIMESTAMP_NANOS
  }
}'
```
Substitua:
- PROJECT_ID: o ID do seu Google Cloud projeto.
- COLLECTION_ID: o ID da coleção cuja transmissão 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 Timestamp.
- TIMESTAMP_NANOS: o valor do carimbo de data/hora em segundos desde quando você quer importar os documentos. Ele segue o formato Timestamp.
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 da 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

No console Google Cloud , acesse a página Aplicativos de IA.

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

A página Repositórios de dados mostra uma lista de repositórios no seu projeto Google Cloudcom os detalhes deles.
Na lista de armazenamentos de dados, clique em Mais opções no conector de dados que você quer excluir.
Clique em Excluir.
Na caixa de diálogo que aparece, digite yes e clique em Confirm para confirmar a exclusão.

REST

Encontre o ID da sua coleção. Se você já tiver o ID da coleção, pule para a próxima etapa.
1. No console Google Cloud , acesse a página Aplicativos de IA 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 que você quer pausar ou retomar.
3. Na página Dados do seu conector de dados, encontre o ID da coleta.
Aciona uma sincronização ou um backfill de todos os documentos com tipos de recursos 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/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
-d ' {
  "syncSinceTimestamp": {
    "seconds": TIMESTAMP_SECONDS,
    "nanos": TIMESTAMP_NANOS
  }
}'
```
Substitua:
- PROJECT_ID: o ID do seu Google Cloud projeto.
- COLLECTION_ID: o ID da coleção cuja transmissão 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 Timestamp.
- TIMESTAMP_NANOS: o valor do carimbo de data/hora em segundos desde quando você quer importar os documentos. Ele segue o formato Timestamp.
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 da 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.

Gerenciar um repositório de dados de pesquisa de saúde Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Cancelar importação em lote

REST

Pausar ou retomar o streaming

Console

REST

Resposta

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

Console

REST

Resposta

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

Console

REST

Resposta

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

Console

REST

Resposta

Excluir streaming

Console

REST

Resposta

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