מידע על תיקיות בקטגוריות עם מרחב שמות היררכי

בדף הזה מוסבר על תיקיות בקטגוריות שמופעל בהן מרחב שמות היררכי.

סקירה כללית

כשיוצרים קטגוריה עם מרחב שמות היררכי, הקטגוריה משתמשת במבנה אמיתי של מערכת קבצים, בניגוד למרחב שמות שטוח רגיל. תיקיות קיימות כמשאב בקטגוריות שבהן מופעל מרחב שמות היררכי. בעזרת תיקיות, אתם יכולים לארגן את האובייקטים בצורה יעילה יותר ולקבל גישה ליכולות אמיתיות של ספריות, כמו שינוי שמות של תיקיות אטומיות ופעולות יעילות של מטא-נתונים.

תיקיות בקטגוריות שמופעל בהן מרחב שמות היררכי שונות מתיקיות מנוהלות ומתיקיות מדומות. תיקיות מדומות קיימות בקטגוריות עם מרחב שמות שטוח, ואפשר להחיל תיקיות מנוהלות גם בקטגוריות עם מרחב שמות שטוח וגם בקטגוריות עם מרחב שמות היררכי. תיקיות מנוהלות משמשות בעיקר כדי לתת הרשאות IAM לקבוצות של אובייקטים. מידע נוסף על סוגי התיקיות האחרים זמין במאמר סוגי תיקיות.

אתם יכולים לנהל תיקיות באמצעות פעולות בתיקיות. במאמר יצירה וניהול של תיקיות מוסבר איך ליצור, להציג ולמחוק תיקיות, ואיך לקבל מטא-נתונים של תיקיות. כדי ללמוד איך לשנות שם של תיקייה או להעביר אותה, קראו את המאמר שינוי שם של תיקייה.

המטא-נתונים של התיקיות

המטא-נתונים של תיקייה מכילים מידע מובנה על התיקייה. מידע מפורט על המטא-נתונים של תיקיות מופיע במשאב Folder במאמרי העזרה של ה-API בפורמט JSON של Cloud Storage.

הרכיבים העיקריים של מטא-נתונים של תיקייה הם:

• ‫bucket: שם הקטגוריה שבה נמצאת התיקייה. לדוגמה, my-bucket.
• ‫id: מזהה ייחודי של התיקייה בתוך הקטגוריה. לדוגמה, hns-bucket/dir1/.
• ‫kind: סוג המשאב. בתיקייה, הערך הזה הוא תמיד storage#folder.
• ‫name: שם התיקייה. לדוגמה, dir1/.
• ‫selfLink: כתובת URL שמפנה לתיקייה ב-Cloud Storage API.
• ‫timeCreated: חותמת הזמן של יצירת התיקייה. לדוגמה, 2023-05-05T16:32:08.878000+00:00.
• ‫updated: חותמת הזמן של העדכון האחרון של התיקייה. לדוגמה, 2024-05-06T16:32:08.878000+00:00.

פעולות בתיקיות

בקטע הזה מתוארות הפעולות שאפשר לבצע בתיקיות. פעולות מסוימות מתחילות פעולה ממושכת שאפשר לעקוב אחריה כדי לבדוק את ההתקדמות והסטטוס שלה.

יצירת תיקייה

אפשר ליצור תיקיות באופן מפורש באמצעות פעולת יצירת התיקיות. בנוסף, כשיוצרים אובייקט ומציינים תיקייה שלא קיימת בנתיב שלו, התיקייה הראשית החסרה נוצרת באופן אוטומטי. לדוגמה, אם יוצרים אובייקט בשם dir1/foo.txt, התיקייה dir1/ נוצרת באופן אוטומטי אם היא עדיין לא קיימת.

מידע נוסף על מתן שמות לתיקיות זמין בקטע שיקולים.

הצגת רשימה של תיקיות

כדי לאחזר רשימה של תיקיות בקטגוריה, אפשר להשתמש בפעולה list folders. מכיוון שתיקיות הן משאבים נפרדים בקטגוריות שבהן מופעל מרחב שמות היררכי, הפעולה הזו מעריכה את מבנה התיקיות האמיתי במקום לדמות תיקיות מנתיבי אובייקטים.

כשמציגים תיקיות, אפשר לסנן את התוצאות באמצעות פרמטרים כמו prefix,‏ delimiter,‏ lexicographicStart ו-lexicographicEnd. לדוגמה, אם מגדירים את הפרמטר delimiter לערך /, אפשר להציג תיקיות במצב דמוי ספרייה, ולהחזיר רק את התיקיות שתואמות לתחילית או שנמצאות רמה אחת מתחתיה.

הפעולה של הצגת רשימת התיקיות מחזירה תוצאות עם חלוקה לדפים. דף תשובה אחד יכול להכיל עד 1,000 תיקיות.

קבלת המטא-נתונים של תיקייה

כדי לאחזר את המאפיינים של תיקייה, משתמשים בפעולה get folder metadata. הפעולה הזו מאחזרת מידע על משאב התיקייה עצמו, ולא על האובייקטים שהוא מכיל.

הפעולה הזו מחזירה את המטא-נתונים של התיקייה, שמספקים מידע מובנה כמו חותמת הזמן של היצירה, המזהה הייחודי והקטגוריה שבה היא נמצאת. רשימה מפורטת של המאפיינים שהפעולה הזו מחזירה מופיעה במאמר מטא-נתונים של תיקיות.

שינוי שם או העברה של תיקייה

שינוי שם של תיקייה והעברה של תיקייה מתבצעים באמצעות אותה פעולה בסיסית. הפעולה היא שינוי אטומי של מטא-נתונים בלבד, שמעדכן את הנתיב של התיקייה בלי להעתיק או למחוק פיזית את האובייקטים הבסיסיים. שינוי השם של תיקייה מעדכן גם את הנתיב של התיקייה למשאבים שבתוך התיקייה, כמו תיקיות צאצא, אובייקטים ותיקיות מנוהלות. כך הפעולה מתבצעת במהירות ונמנעות עלויות של העתקת אובייקטים.

הפעולה של שינוי שם התיקייה מתחילה פעולה ממושכת.

במהלך פעולה של שינוי שם של תיקייה, אתם יכולים לקרוא את התיקיות ששמן משתנה ולהציג אותן ברשימה, אבל אתם לא יכולים להפעיל עליהן פעולות כתיבה.

ב-API בפורמט JSON וב-Google Cloud CLI, פעולות שינוי השם וההעברה משתמשות באותה נקודת קצה (endpoint) של כתובת URL או באותה פקודה. במסוף Google Cloud , האפשרויות Rename folder ו-Move folder מוצגות כשתי אפשרויות נפרדות, אבל שתיהן מבצעות את אותה פעולה בקצה העורפי.

מחיקת תיקייה

כדי למחוק תיקייה באופן סופי, צריך להשתמש בפעולה למחיקת תיקייה. אפשר ליצור תיקיות באופן אוטומטי במהלך פעולות על אובייקטים, אבל הן לא נמחקות באופן אוטומטי כשהן מתרוקנות. צריך למחוק אותם באופן מפורש.

אינטראקציות בין תיקיות לבין תיקיות מנוהלות משויכות

תיקיות מנוהלות משויכות משמשות כדי לשלוט בגישה לתיקיות בקטגוריות שבהן מופעל מרחב שמות היררכי. התיקיות והתיקיות המנוהלות שמשויכות אליהן פועלות יחד בדרכים הבאות:

• יצירת תיקיות: כשיוצרים תיקייה מנוהלת בקטגוריה שמופעל בה מרחב שמות היררכי, כל התיקיות החסרות בנתיב שלה נוצרות באופן אוטומטי, כולל תיקיות הורה ותיקיית היעד בפועל (שנקראת גם התיקייה המשויכת).

  לדוגמה, נניח שאתם יוצרים קטגוריה בשם my-bucket עם מרחב שמות היררכי מופעל. אם יוצרים בקטגוריה תיקייה מנוהלת בשם 2025/training-data/, המערכת של Cloud Storage יוצרת בקטגוריה באופן אוטומטי את תיקיית ההורה 2025/ ואת התיקייה המשויכת training-data/.

• מחיקת תיקייה: כשמוחקים תיקייה שיש לה תיקייה מנוהלת משויכת, Cloud Storage מוחק גם את התיקייה המנוהלת המשויכת. הסיבה לכך היא שכאשר מוחקים תיקייה, מוחקים את הנתיב כולו. הנתיב כבר לא קיים, ולכן התיקייה המנוהלת שמשויכת אליו וכל כללי מדיניות ה-IAM שמצורפים אליה נמחקים. בקטגוריות שבהן מופעל מרחב שמות היררכי, תיקייה מנוהלת לא יכולה להתקיים בלי תיקייה משויכת.

  אם אין לכם את ההרשאות הנדרשות כדי למחוק את התיקייה המנוהלת שמשויכת לתיקייה, פעולת המחיקה של התיקייה תיכשל. כדי לראות אילו הרשאות נדרשות למחיקת תיקיות מנוהלות, קראו את המאמר קבלת התפקידים הנדרשים לתיקיות מנוהלות.

• שינוי שם של תיקייה: כשמשנים שם של תיקייה שיש לה תיקייה מנוהלת משויכת, Cloud Storage משנה גם את השם של התיקייה המנוהלת המשויכת.

במאמר מתן שמות לתיקיות מוסבר על הדרישות למתן שמות לתיקיות שיש להן תיקייה מנוהלת משויכת.

לתשומת ליבכם

כשיוצרים תיקיות, כדאי להביא בחשבון את הדברים הבאים:

• שמות של אובייקטים ותיקיות: בקטגוריות שבהן מופעל מרחב שמות היררכי, אפשר להשתמש בכל שמות האובייקטים החוקיים, כולל שמות עם לוכסנים (/) בהתחלה, בסוף או ברצף. כל קו נטוי (/) בשם של אובייקט מייצג תיקייה. בטבלה הבאה מוצגות דוגמאות לקשר בין שמות האובייקטים לבין המיקום שלהם בהיררכיית התיקיות:

  שם האובייקט	המיקום בהיררכיית התיקיות
  foo.txt	כל קטגוריה כוללת תיקיית בסיס. האובייקט foo.txt נמצא בתיקיית הבסיס של הקטגוריה.
  dir1/foo.txt	האובייקט foo.txt נמצא בתיקייה ברמה העליונה בשם dir1/. התיקייה ברמה העליונה שונה מתיקיית הבסיס.
  dir1/	הקו הנטוי בסוף שמות של אובייקטים כמו dir1/ מציין שהאובייקט נמצא בתוך התיקייה. בדוגמה הזו, שם האובייקט dir1/ זהה לשם של תיקיית ההורה dir1/.
  dir1//foo.txt	האובייקט foo.txt נמצא בתיקייה ברמה השנייה בשם dir1//, שהיא תיקיית צאצא של dir1/.

• עומק תיקייה מקסימלי: קטגוריות שמופעל בהן מרחב שמות היררכי תומכות בעומק תיקייה מקסימלי של 50. אפשר ליצור תיקיות עם עד 50 תיקיות צאצא מוערמות (לדוגמה, folder1/folder2/folder3/.../folder50/my-data.txt). עם זאת, אם לתיקייה יש תיקייה מנוהלת משויכת, יכולות להיות לה רק עד 15 תיקיות צאצא מוערמות.

• הגודל המקסימלי של שם התיקייה: 512 בייטים (בקידוד UTF-8).

• מידע רגיש או פרטים אישיים מזהים (PII): שמות של תיקיות גלויים באופן נרחב יותר מאשר המטא-נתונים של התיקיות. לדוגמה, שמות של תיקיות מופיעים בכתובות URL וברשימת התיקיות או האובייקטים בקטגוריה. אל תכללו מידע רגיש או פרטים אישיים מזהים (PII) בשמות של תיקיות.

המאמרים הבאים

• יצירה וניהול של תיקיות
• שינוי שם של תיקייה.
• אופטימיזציה של ניהול התיקיות.

נסו בעצמכם

אנחנו ממליצים למשתמשים חדשים ב-Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של Cloud Storage בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300 $להרצה, לבדיקה ולפריסה של עומסי העבודה.

להתנסות ב-Cloud Storage בחינם