הרצת סנכרון נתונים של DataConnector. אחרי ש-DataConnector מאותחל בהצלחה, סנכרון הנתונים מתוזמן לשעה DataConnector.refresh_interval. הסמל ConnectorRun מייצג סנכרון נתונים שהתרחש בעבר או מתרחש כרגע. //
| ייצוג ב-JSON |
|---|
{ "name": string, "startTime": string, "endTime": string, "state": enum ( |
| שדות | |
|---|---|
name |
פלט בלבד. שם המשאב המלא של הפעלת המחבר. פורמט: |
startTime |
פלט בלבד. השעה שבה התחילה ההרצה של המחבר. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
endTime |
פלט בלבד. השעה שבה הסתיימה ההרצה של מחבר. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
state |
פלט בלבד. המצב של הרצת הסנכרון. |
errors[] |
מכיל מידע על שגיאות שקרו במהלך הסנכרון. הם קיימים רק אם נתקלים במצב שגיאה. התשובה מכילה קוד שגיאה והודעת שגיאה. משתמשים בשדה |
stateUpdateTime |
חותמת הזמן שבה עודכן לאחרונה סטטוס הסנכרון של הפעלת המחבר. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
latestPauseTime |
פלט בלבד. הזמן שבו ההפעלה של המחבר הופסקה לאחרונה. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
entityRuns[] |
פלט בלבד. פרטי הישויות שמסונכרנות ב-ConnectorRun. כל ConnectorRun מורכב מסנכרון של ישות אחת או יותר. |
trigger |
פלט בלבד. הטריגר של ה- |
מדינה
מצב ההרצה.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל. |
RUNNING |
סנכרון הנתונים מתבצע. |
SUCCEEDED |
סנכרון הנתונים הסתיים. |
FAILED |
סנכרון הנתונים נכשל. |
OVERRUN |
סנכרון הנתונים נמשך יותר זמן מהצפוי, והוא עדיין מתבצע בזמן שבו אמור להתחיל הסנכרון הבא. |
CANCELLED |
סנכרון הנתונים תוכנן אבל בוטל. |
PENDING |
סנכרון הנתונים עומד להתחיל. |
WARNING |
סנכרון הנתונים הושלם עם שגיאות לא קריטיות. |
SKIPPED |
הפעלה של מחבר שנמצאת בעיצומה נמשכת יותר זמן מהצפוי, ולכן ההפעלה הזו תדלג. |
EntityRun
מייצג ישות שסונכרנה ב-ConnectorRun הזה.
| ייצוג ב-JSON |
|---|
{ "entityName": string, "state": enum ( |
| שדות | |
|---|---|
entityName |
השם של ישות המקור. |
state |
המצב של הרצת הסנכרון של הישות. |
errors[] |
השגיאות מהרצת הסנכרון של הישות. הם קיימים רק אם נתקלים במצב שגיאה. התשובה מכילה קוד שגיאה והודעת שגיאה. |
stateUpdateTime |
חותמת הזמן שבה עודכן לאחרונה סטטוס הסנכרון של הישות. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
progress |
מטא-נתונים כדי ליצור את סרגל ההתקדמות. |
statsUpdateTime |
חותמת הזמן של העדכון האחרון של extracted_documents_count, indexed_documents_count או error_documents_count. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
syncType |
סוג הסנכרון של ההרצה הזו. |
scheduledRecordCount |
זה שינוי אופציונלי. מספר המסמכים שמתוזמנים לסריקה או לחילוץ ממקור של מחבר. ההגדרה הזו רלוונטית רק למחברים של צד שלישי. |
extractedRecordCount |
זה שינוי אופציונלי. מספר המסמכים שחולצו ממקור המחבר, ומוכנים להזנה ל-VAIS. |
indexedRecordCount |
זה שינוי אופציונלי. מספר המסמכים שנוספו לאינדקס. |
errorRecordCount |
זה שינוי אופציונלי. המספר הכולל של מסמכים שנכשלו בסנכרון בשלב ההוספה לאינדקס. |
sourceApiRequestCount |
זה שינוי אופציונלי. מספר הבקשות שנשלחו אל API של צד שלישי. |
deletedRecordCount |
זה שינוי אופציונלי. מספר המסמכים שנמחקו. |
התקדמות
מייצג את ההתקדמות של הרצת סנכרון.
| ייצוג ב-JSON |
|---|
{ "currentCount": string, "totalCount": string, "percentile": number } |
| שדות | |
|---|---|
currentCount |
ההתקדמות הנוכחית. |
totalCount |
הסכום הכולל. |
percentile |
נגזרת. אחוזון ההתקדמות.current_count / totalCount. הערך צריך להיות בין 0 ל-1.0, כולל. |
SyncType
סוג סנכרון הנתונים של המחבר.
| טיפוסים בני מנייה (enum) | |
|---|---|
SYNC_TYPE_UNSPECIFIED |
לא צוין סוג הסנכרון. |
FULL |
הסנכרון מפעיל סנכרון מלא של כל המסמכים. |
INCREMENTAL |
סנכרון מצטבר של מסמכים מעודכנים. |
REALTIME |
סנכרון בזמן אמת. |
SCALA_SYNC |
סנכרון Scala. |
הטריגר
הסיבות להפעלת ConnectorRun.
| טיפוסים בני מנייה (enum) | |
|---|---|
TRIGGER_UNSPECIFIED |
ערך ברירת המחדל. |
SCHEDULER |
הפעלת ConnectorRun על ידי מתזמן אם למחבר יש מצב סנכרון PERIODIC. |
INITIALIZATION |
הפעלה אוטומטית של ConnectorRun על ידי הפעלת המחבר. |
RESUME |
הפעלה אוטומטית של ConnectorRun בעקבות הפעלה מחדש של המחבר. |
MANUAL |
הפעלת ConnectorRun על ידי משתמש באופן ידני. |