ConnectorRun

DataConnector 的資料同步處理作業。成功初始化 DataConnector 後，系統會在 DataConnector.refresh_interval 排定資料同步作業。ConnectorRun 代表過去或目前正在進行的資料同步作業。//

JSON 表示法 
{
  "name": string,
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "errors": [
    {
      object (Status)
    }
  ],
  "stateUpdateTime": string,
  "latestPauseTime": string,
  "entityRuns": [
    {
      object (EntityRun)
    }
  ],
  "trigger": enum (Trigger)
}
欄位
name

string

僅供輸出。連接器執行的完整資源名稱。格式：projects/*/locations/*/collections/*/dataConnector/connectorRuns/*。connectorRunId 是由系統產生。
startTime

string (Timestamp format)

僅供輸出。連接器執行作業的開始時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

僅供輸出。連接器執行作業結束的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
state

enum (State)

僅供輸出。同步執行作業的狀態。
errors[]

object (Status)

內含同步處理期間發生的錯誤資訊。只有在發生錯誤時才會存在。包含錯誤代碼和錯誤訊息。搭配 state 欄位使用。
stateUpdateTime

string (Timestamp format)

連接器執行同步狀態上次更新的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
latestPauseTime

string (Timestamp format)

僅供輸出。連接器執行作業最近一次暫停的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
entityRuns[]

object (EntityRun)

僅供輸出。在 ConnectorRun 同步處理的實體詳細資料。每個 ConnectorRun 都包含一或多個實體的同步作業。
trigger

enum (Trigger)

僅供輸出。這個 ConnectorRun 的觸發條件。

狀態

執行狀態。

列舉
STATE_UNSPECIFIED 預設值。
RUNNING 正在同步處理資料。
SUCCEEDED 資料同步處理作業已完成。
FAILED 資料同步處理失敗。
OVERRUN 資料同步處理作業的執行時間超出預期，在下一項同步處理作業的預定開始時間仍未完成。
CANCELLED 排定的資料同步處理作業遭到取消。
PENDING 即將開始同步處理資料。
WARNING 資料同步處理完畢，但發生非致命錯誤。
SKIPPED 正在執行的連接器作業超出預期時間，因此系統略過本次作業。

EntityRun

代表在這個 ConnectorRun 中同步處理的實體。

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
}
欄位
entityName

string

來源實體的名稱。
state

enum (State)

實體同步執行的狀態。
errors[]

object (Status)

實體同步執行時發生的錯誤。只有在發生錯誤時才會存在。包含錯誤代碼和錯誤訊息。
stateUpdateTime

string (Timestamp format)

實體同步狀態上次更新的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
progress

object (Progress)

中繼資料，以產生進度列。
statsUpdateTime

string (Timestamp format)

上次更新 extracted_documents_count、indexed_documents_count 和 error_documents_count 的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
syncType

enum (SyncType)

本次執行的同步類型。
scheduledRecordCount

string (int64 format)

(選用步驟) 預定要從連接器來源檢索/擷取的文件數量。這項功能僅適用於第三方連結器。
extractedRecordCount

string (int64 format)

(選用步驟) 從連接器來源擷取的文件數量，可擷取至 VAIS。
indexedRecordCount

string (int64 format)

(選用步驟) 已編入索引的文件數量。
errorRecordCount

string (int64 format)

(選用步驟) 在建立索引階段同步處理失敗的文件總數。
sourceApiRequestCount

string (int64 format)

(選用步驟) 傳送至第三方 API 的要求數量。
deletedRecordCount

string (int64 format)

(選用步驟) 已刪除的文件數量。

進度

代表同步執行作業的進度。

JSON 表示法 
{
  "currentCount": string,
  "totalCount": string,
  "percentile": number
}
欄位
currentCount

string (int64 format)

目前進度。
totalCount

string (int64 format)

總金額。
percentile

number

衍生。進度百分位數。current_count / totalCount。值介於 [0, 1.0] 之間 (含 0 和 1.0)。

SyncType

連接器的資料同步類型。

列舉
SYNC_TYPE_UNSPECIFIED 未指定同步類型。
FULL 同步會觸發所有文件的完整同步。
INCREMENTAL 遞增同步更新的文件。
REALTIME 即時同步處理。
SCALA_SYNC Scala 同步。

觸發條件

觸發 ConnectorRun 的原因。

列舉
TRIGGER_UNSPECIFIED 預設值。
SCHEDULER 如果連接器採用 PERIODIC 同步模式，排程器會觸發 ConnectorRun。
INITIALIZATION 連接器初始化作業會自動觸發 ConnectorRun。
RESUME 系統在恢復連接器時自動觸發 ConnectorRun。
MANUAL 使用者手動觸發 ConnectorRun。