本頁面由 Cloud Translation API 翻譯而成。

ConnectorRun

JSON 表示法
狀態
EntityRun
- JSON 表示法
進度
- JSON 表示法
SyncType
觸發條件

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

JSON 表示法

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,
  "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 表示法

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,
  "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)。

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。