DataConnector의 데이터 동기화 실행 DataConnector가 성공적으로 초기화되면 DataConnector.refresh_interval에서 데이터 동기화가 예약됩니다. ConnectorRun는 과거 또는 현재 진행 중인 데이터 동기화를 나타냅니다. //
| JSON 표현 | 
|---|
{ "name": string, "startTime": string, "endTime": string, "state": enum (  | 
            
| 필드 | |
|---|---|
name | 
              
                 
 출력 전용입니다. 커넥터 실행의 전체 리소스 이름입니다. 형식은   | 
            
startTime | 
              
                 
 출력 전용입니다. 커넥터 실행이 시작된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
            
endTime | 
              
                 
 출력 전용입니다. 커넥터 실행이 종료된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
            
state | 
              
                 
 출력 전용입니다. 동기화 실행의 상태입니다.  | 
            
errors[] | 
              
                 
 동기화 중에 발생한 오류에 관한 정보를 포함합니다. 오류 상태가 발생한 경우에만 존재합니다. 오류 코드와 오류 메시지가 포함됩니다.   | 
            
stateUpdateTime | 
              
                 
 커넥터 실행 동기화 상태가 마지막으로 업데이트된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
            
latestPauseTime | 
              
                 
 출력 전용입니다. 커넥터 실행이 가장 최근에 일시중지된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
            
entityRuns[] | 
              
                 
 출력 전용입니다. ConnectorRun에서 동기화된 항목의 세부정보입니다. 각 ConnectorRun은 하나 이상의 항목을 동기화하는 것으로 구성됩니다.  | 
            
trigger | 
              
                 
 출력 전용입니다. 이   | 
            
주
실행 상태입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED | 
                기본값 | 
RUNNING | 
                데이터 동기화가 진행 중입니다. | 
SUCCEEDED | 
                데이터 동기화가 완료되었습니다. | 
FAILED | 
                데이터 동기화에 실패했습니다. | 
OVERRUN | 
                데이터 동기화가 예상보다 오래 걸려 다음 실행의 시작 시간에도 여전히 실행 중입니다. | 
CANCELLED | 
                데이터 동기화가 예약되었지만 취소되었습니다. | 
PENDING | 
                데이터 동기화가 곧 시작됩니다. | 
WARNING | 
                데이터 동기화가 완료되었으나 심각하지 않은 오류가 발생했습니다. | 
SKIPPED | 
                진행 중인 커넥터 실행이 예상보다 오래 실행되어 이 실행이 건너뛰었습니다. | 
EntityRun
이 ConnectorRun에서 동기화된 항목을 나타냅니다.
| JSON 표현 | 
|---|
{ "entityName": string, "state": enum (  | 
              
| 필드 | |
|---|---|
entityName | 
                
                   
 소스 항목의 이름입니다.  | 
              
state | 
                
                   
 항목의 동기화 실행 상태입니다.  | 
              
errors[] | 
                
                   
 엔티티의 동기화 실행에서 발생한 오류입니다. 오류 상태가 발생한 경우에만 존재합니다. 오류 코드와 오류 메시지가 포함됩니다.  | 
              
stateUpdateTime | 
                
                   
 엔티티 동기화 상태가 마지막으로 업데이트된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
              
progress | 
                
                   
 메타데이터를 사용하여 진행률 표시줄을 생성합니다.  | 
              
statsUpdateTime | 
                
                   
 extracted_documents_count, indexed_documents_count, error_documents_count가 마지막으로 업데이트된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
              
syncType | 
                
                   
 이 실행의 동기화 유형입니다.  | 
              
scheduledRecordCount | 
                
                   
 (선택사항) 커넥터 소스에서 크롤링/추출되도록 예약된 문서 수입니다. 이는 서드 파티 커넥터에만 적용됩니다.  | 
              
extractedRecordCount | 
                
                   
 (선택사항) 커넥터 소스에서 추출되어 VAIS로 인그레션할 준비가 된 문서 수입니다.  | 
              
indexedRecordCount | 
                
                   
 (선택사항) 색인이 생성된 문서 수입니다.  | 
              
errorRecordCount | 
                
                   
 (선택사항) 색인 생성 단계에서 동기화에 실패한 문서의 총개수입니다.  | 
              
sourceApiRequestCount | 
                
                   
 (선택사항) 서드 파티 API로 전송된 요청 수입니다.  | 
              
deletedRecordCount | 
                
                   
 (선택사항) 삭제된 문서 수입니다.  | 
              
진행률
동기화 실행의 진행 상황을 나타냅니다.
| JSON 표현 | 
|---|
{ "currentCount": string, "totalCount": string, "percentile": number }  | 
              
| 필드 | |
|---|---|
currentCount | 
                
                   
 현재 진행 상황입니다.  | 
              
totalCount | 
                
                   
 총계입니다.  | 
              
percentile | 
                
                   
 파생됨 progress.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입니다. |