בדף הזה מוסבר איך להגדיר זמן קצוב לתפוגה של עסקאות באמצעות ספריות הלקוח של Spanner. העסקה נכשלת עם השגיאה DEADLINE_EXCEEDED אם היא לא מסתיימת בתוך ערך הזמן הקצוב שניתן.
אם שגיאת הזמן הקצוב לתפוגה מתרחשת במהלך הביצוע של הבקשה Commit, עדיין יכול להיות שהטרנזקציה בוצעה.
זמנים קצובים לתפוגת RPC ולולאות של ניסיונות חוזרים לביצוע טרנזקציות
זמני קצובים לתפוגה של RPC וזמנים קצובים לתפוגה של טרנזקציות מגבילים היקפי עבודה שונים:
- זמן קצוב לתפוגה של RPC מגביל את משך הזמן שבו בקשה אחת, כמו שאילתה, קריאה או בקשת
Commit, יכולה לפעול. אם הזמן הקצוב לתפוגה של עסקה ארוך יותר מהזמן הקצוב לתפוגה של RPC, הזמן הקצוב לתפוגה של RPC לא יוארך. מידע נוסף מופיע במאמר הגדרת זמן קצוב לתפוגה וניסיונות חוזרים בהתאמה אישית. - זמן קצוב לתפוגה של עסקה מגביל את משך הזמן הכולל שספריית הלקוח מקדישה להרצת עסקה של קריאה וכתיבה, כולל כל ניסיון שספריית הלקוח מבצעת אחרי ש-Spanner מבטל את העסקה.
כש-Spanner מבטל עסקה של קריאה וכתיבה, ספריית הלקוח מריצה מחדש את פונקציית העסקה. זמני קצובים קצרים של RPC לא מגבילים את משך הזמן שבו ספריית הלקוח ממשיכה לנסות מחדש עסקה שבוטלה. אם לא מגדירים זמן קצוב לתפוגה של טרנזקציה, התנהגות ברירת המחדל של הניסיונות החוזרים תלויה בספריית הלקוח:
- Java: מריץ הטרנזקציות מנסה שוב לבצע טרנזקציות שבוטלו במשך עד 24 שעות, ללא הגבלה על מספר הניסיונות.
- Go: ספריית הלקוח מנסה שוב לבצע עסקאות שבוטלו עד שהעסקה מתבצעת, או עד שהאובייקט
context.Contextשאתם מעבירים לעסקה מגיע למועד האחרון או מבוטל. - Node.js: ספריית הלקוח מפסיקה לנסות שוב עסקאות שבוטלו אחרי שעה אחת (
3600000אלפיות השנייה). כדי לשנות את המגבלה הזו, מגדירים את השדהtimeoutבאובייקטRunTransactionOptionsשמעבירים ל-methodrunTransactionאוrunTransactionAsync. - Python: ספריית הלקוח מפסיקה לנסות מחדש טרנזקציות שבוטלו אחרי 30 שניות. כדי לשנות את המגבלה הזו, מעבירים את הארגומנט
timeout_secsל-methodrun_in_transaction.
בעומסי עבודה עם תחרות גבוהה על נעילות, כל ניסיון חוזר מתחרה על אותן נעילות, כך שלולאת ניסיונות חוזרים ארוכה יכולה להאריך את זמני ההמתנה לנעילה של טרנזקציות אחרות. כדי להגביל את משך הזמן הכולל שבו טרנזקציה יכולה לפעול, מגדירים זמן קצוב לתפוגה של טרנזקציה, כמו שמוצג בדוגמאות שבדף הזה.
הגדרת זמן קצוב לתפוגה של עסקה
אפשר להגדיר זמן קצוב לתפוגה של עסקה באמצעות ספריות הלקוח של Go, Java, Python ו-Node.js.
המשך
Java
Node.js
Python
הגדרת זמן קצוב לתפוגה של טרנזקציות Java אסינכרוניות
בדוגמה של Java בדף הזה, נעשה שימוש באובייקט Context של gRPC עם מועד אחרון להגדרת הזמן הקצוב לתפוגה של העסקה. האובייקט Context של gRPC מצורף ל-thread הנוכחי.
כשמריצים טרנזקציה באופן אסינכרוני באמצעות השיטה AsyncRunner.runAsync(), ספריית הלקוח מריצה את הטרנזקציה באובייקט Executor שאתם מספקים. ספריית הלקוח לא מעבירה לאותו executor את האובייקט Context של ה-thread שקורא, כולל המועד האחרון שלו. כתוצאה מכך, הטרנזקציה פועלת ללא זמן קצוב לתפוגה ויכולה להמשיך לנסות שוב ניסיונות שבוטלו במשך עד 24 שעות.
כדי להחיל את הזמן הקצוב לתפוגה על טרנזקציה אסינכרונית, מבצעים אחת מהפעולות הבאות:
- עוטפים את ה-executor באמצעות קריאה ל-method
Context.currentContextExecutor(executor)בזמן שהאובייקטContextעם המועד האחרון הוא הנוכחי, ומעבירים את ה-executor העטוף ל-methodrunAsync(). - משתמשים בממשק
AsyncTransactionManagerאוTransactionManagerבמקום בממשקAsyncRunner. כשמשתמשים במנהל טרנזקציות, כותבים את לולאת הניסיון החוזר בעצמכם ואפשר להפסיק את הניסיונות החוזרים כשתוקף הזמן הקצוב לתפוגה פג.