ConnectorRun

Uma execução de sincronização de dados de DataConnector. Depois que DataConnector é inicializado, as sincronizações de dados são programadas em DataConnector.refresh_interval. Um ConnectorRun representa uma sincronização de dados no passado ou em andamento no momento. //

Representação JSON
{
  "name": string,
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "errors": [
    {
      object (Status)
    }
  ],
  "stateUpdateTime": string,
  "latestPauseTime": string,
  "entityRuns": [
    {
      object (EntityRun)
    }
  ],
  "trigger": enum (Trigger)
}
Campos
name

string

Apenas saída. O nome completo do recurso da execução do conector. Formato: projects/*/locations/*/collections/*/dataConnector/connectorRuns/*. O connectorRunId é gerado pelo sistema.

startTime

string (Timestamp format)

Apenas saída. O horário em que a execução do conector foi iniciada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Apenas saída. O horário em que a execução do conector terminou.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

state

enum (State)

Apenas saída. O estado da execução da sincronização.

errors[]

object (Status)

Contém informações sobre erros ocorridos durante a sincronização. Só existe se houver um estado de erro. Contém o código e a mensagem de erro. Use com o campo state.

stateUpdateTime

string (Timestamp format)

Carimbo de data/hora em que o estado de sincronização da execução do conector foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

latestPauseTime

string (Timestamp format)

Apenas saída. O horário em que a execução do conector foi pausada pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

entityRuns[]

object (EntityRun)

Apenas saída. Os detalhes das entidades sincronizadas no ConnectorRun. Cada ConnectorRun consiste em sincronizar uma ou mais entidades.

trigger

enum (Trigger)

Apenas saída. O gatilho para este ConnectorRun.

Estado

O estado da execução.

Tipos enumerados
STATE_UNSPECIFIED Valor padrão.
RUNNING A sincronização de dados está em andamento.
SUCCEEDED A sincronização de dados foi concluída.
FAILED A sincronização de dados falhou.
OVERRUN A sincronização de dados está em execução há mais tempo do que o esperado e continua sendo realizada quando a próxima execução deveria começar.
CANCELLED A sincronização de dados foi programada, mas foi cancelada.
PENDING A sincronização de dados está prestes a começar.
WARNING A sincronização de dados foi concluída com erros não fatais.
SKIPPED Uma execução de conector em andamento está demorando mais do que o esperado, fazendo com que ela seja ignorada.

EntityRun

Representa uma entidade sincronizada neste ConnectorRun.

Representação JSON
{
  "entityName": string,
  "state": enum (State),
  "errors": [
    {
      object (Status)
    }
  ],
  "stateUpdateTime": string,
  "progress": {
    object (Progress)
  },
  "statsUpdateTime": string,
  "syncType": enum (SyncType),
  "scheduledRecordCount": string,
  "extractedRecordCount": string,
  "indexedRecordCount": string,
  "errorRecordCount": string,
  "sourceApiRequestCount": string,
  "deletedRecordCount": string
}
Campos
entityName

string

O nome da entidade de origem.

state

enum (State)

O estado da execução da sincronização da entidade.

errors[]

object (Status)

Os erros da execução de sincronização da entidade. Só existe se houver um estado de erro. Contém o código e a mensagem de erro.

stateUpdateTime

string (Timestamp format)

Carimbo de data/hora em que o estado de sincronização da entidade foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

progress

object (Progress)

metadados para gerar a barra de progresso.

statsUpdateTime

string (Timestamp format)

O carimbo de data/hora em que extracted_documents_count, indexed_documents_count e error_documents_count foram atualizados pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

syncType

enum (SyncType)

Tipo de sincronização desta execução.

scheduledRecordCount

string (int64 format)

Opcional. O número de documentos programados para serem rastreados/extraídos da origem do conector. Isso só se aplica a conectores de terceiros.

extractedRecordCount

string (int64 format)

Opcional. O número de documentos extraídos da origem do conector, prontos para serem ingeridos no VAIS.

indexedRecordCount

string (int64 format)

Opcional. O número de documentos indexados.

errorRecordCount

string (int64 format)

Opcional. O número total de documentos com falha na sincronização na etapa de indexação.

sourceApiRequestCount

string (int64 format)

Opcional. O número de solicitações enviadas à API de terceiros.

deletedRecordCount

string (int64 format)

Opcional. O número de documentos excluídos.

Progresso

Representa o progresso de uma execução de sincronização.

Representação JSON
{
  "currentCount": string,
  "totalCount": string,
  "percentile": number
}
Campos
currentCount

string (int64 format)

O progresso atual.

totalCount

string (int64 format)

O total.

percentile

number

Derivada. O percentil de progress.current_count / totalCount. O valor está entre [0, 1,0], inclusive.

SyncType

tipo de sincronização de dados do conector.

Tipos enumerados
SYNC_TYPE_UNSPECIFIED Tipo de sincronização não especificado.
FULL A sincronização aciona a sincronização completa de todos os documentos.
INCREMENTAL Sincronização incremental de documentos atualizados.
REALTIME Sincronização em tempo real.
SCALA_SYNC Sincronização do Scala.

Gatilho

Motivos para acionar ConnectorRun.

Tipos enumerados
TRIGGER_UNSPECIFIED Valor padrão.
SCHEDULER ConnectorRun acionado pelo programador se o conector tiver o modo de sincronização PERIÓDICO.
INITIALIZATION O ConnectorRun é acionado automaticamente pela inicialização do conector.
RESUME ConnectorRun acionado automaticamente ao retomar o conector.
MANUAL ConnectorRun acionado manualmente pelo usuário.