תיעוד 54
העלאות מקומיות
עודכן לאחרונה: 18 בספטמבר 2026
באפשרותך להפעיל העלאות מקומיות (Local Uploads) ב-bucket שלך כדי לשפר את הביצועים של בקשות העלאה כאשר לקוחות מעלים נתונים מאזור שונה מזה של ה-bucket שלך. העלאות מקומיות כותבות את נתוני האובייקט למיקום קרוב, ולאחר מכן מעתיקות אותם בצורה אסינכרונית אל ה-bucket שלך. הנתונים זמינים באופן מיידי ונשארים בעלי עקביות חזקה (strongly consistent).
#איך זה עובד
הסעיפים הבאים מתארים כיצד R2 מטפל בבקשות העלאה כאשר העלאות מקומיות מופעלות וכאשר הן אינן מופעלות.
#ללא העלאות מקומיות
כאשר לקוח מעלה אובייקט אל ה-bucket של R2 שלך, נתוני האובייקט חייבים לנוע מהלקוח אל תשתית האחסון של ה-bucket שלך. התנהגות זו יכולה לגרום להשהיה גבוהה יותר ולאמינות נמוכה יותר כאשר הלקוח שלך נמצא באזור שונה מזה של ה-bucket. לפרטים נוספים, עיין במדריך כיצד R2 עובד.
#עם העלאות מקומיות
כאשר אתה מבצע בקשת העלאה (כלומר PutObject ו-UploadPart) אל bucket שהופעלו בו העלאות מקומיות, מטופלים שני מקרים:
- לקוח ו-bucket באותו אזור: R2 פועל לפי תהליך ההעלאה הרגיל, שבו נתוני האובייקט מועלים מהלקוח אל תשתית האחסון של ה-bucket שלך.
- לקוח ו-bucket באזורים שונים: נתוני האובייקט נכתבים לאחסון קרוב ללקוח, ולאחר מכן משוכפלים בצורה אסינכרונית אל ה-bucket שלך. האובייקט נגיש באופן מיידי ונשאר עמיד לאורך התהליך.
תרשים תהליך העלאות מקומיות (Local uploads):
- לקוח (
Client): מזרח צפון אמריקה (Eastern North America). - שרת קצה (
Edge): מזרח צפון אמריקה (Eastern North America),R2 Gateway Worker. - מטא-דאטה של האובייקט (
Object metadata) ונתוני האובייקט (Object data). - שרת קצה (
Edge): מזרח צפון אמריקה (Eastern North America),R2 Gateway Worker, תשתית נתוני אובייקט (Object Data Infra). - מטא-דאטה של האובייקט (
Object metadata). - נתוני האובייקט (
Object data). - ה-bucket שלך (
Your bucket): מזרח אירופה (Eastern Europe), שירות מטא-דאטה (Metadata Service), תשתית נתוני אובייקט (Object Data Infra). - הנתונים מועלים ונגישים (
Data is uploaded and accessible).
#מתי להשתמש בהעלאות מקומיות
העלאות מקומיות מיועדות לעומסי עבודה שמקבלים העלאות רבות שמקורן באזורים גאוגרפיים שונים מהאזור שבו ממוקם ה-bucket שלך. תכונה זו אידיאלית כאשר:
- המשתמשים שלך מבוזרים ברחבי העולם
- ביצועי ההעלאה והאמינות קריטיים ליישום שלך
- ברצונך לבצע אופטימיזציה לביצועי הכתיבה מבלי לשנות את המיקום הראשי של ה-bucket שלך
כדי להבין את ההתפלגות הגאוגרפית של המקומות שמהם מתחילות בקשות הקריאה והכתיבה שלך:
- התחבר ללוח הבקרה של Cloudflare, ועבור אל סקירת R2 (
R2 Overview). מעבר אל Overview ↗ - בחר את ה-bucket שלך.
- בחר ב-Metrics ועיין בתרשים Request Distribution.
#שיקולי השהיית קריאה
כאשר העלאות מקומיות מופעלות, נתונים שהועלו עשויים להימצא באופן זמני קרוב ללקוח לפני שהשכפול מסתיים.
אם עומס העבודה שלך דורש קריאה מיידית לאחר כתיבה, שקול מהיכן מקורן של בקשות הקריאה שלך. קריאות מאזור המעלה יהיו מהירות, בעוד שקריאות מאזור קרוב לאזור ה-bucket עלולות לחוות השהיה בין אזורים עד להשלמת השכפול.
#הגבלת סמכות שיפוט
העלאות מקומיות אינן נתמכות עבור buckets בעלי הגבלות סמכות שיפוט, מכיוון שהתכונה דורשת ניתוב זמני של נתונים דרך מיקומים מחוץ לאזור של ה-bucket.
#הפעלת העלאות מקומיות
כאשר אתה מפעיל העלאות מקומיות, העלאות קיימות יושלמו כמצופה ללא הפרעה לתעבורה.
לוח בקרה (Dashboard):
- התחבר ללוח הבקרה של Cloudflare, ועבור אל סקירת R2 (
R2 Overview). מעבר אל Overview ↗ - בחר את ה-bucket שלך.
- בחר ב-Settings.
- תחת Local Uploads, בחר ב-Enable.
Wrangler:
הפעל את הפקודה הבאה:
npx wrangler r2 bucket local-uploads enable <BUCKET_NAME>#השבתת העלאות מקומיות
באפשרותך להשבית העלאות מקומיות בכל עת. בקשות קיימות שבוצעו עם העלאות מקומיות ישלימו את השכפול ללא הפרעה לתעבורה שלך.
לוח בקרה (Dashboard):
- התחבר ללוח הבקרה של Cloudflare, ועבור אל סקירת R2 (
R2 Overview). מעבר אל Overview ↗ - בחר את ה-bucket שלך.
- בחר ב-Settings.
- תחת Local Uploads, בחר ב-Disable.
Wrangler:
הפעל את הפקודה הבאה:
npx wrangler r2 bucket local-uploads disable <BUCKET_NAME>#תמחור
אין עלות נוספת על הפעלת העלאות מקומיות. בקשות העלאה שמתבצעות כאשר תכונה זו מופעלת כרוכות בעלויות התפעול הרגילות של פעולות Class A, בדיוק כמו בקשות העלאה שמתבצעות ללא העלאות מקומיות.