כשיוצרים קטגוריה עם מרחב שמות היררכי, הקטגוריה מאחסנת נתונים במבנה אמיתי של מערכת קבצים, בניגוד למרחב שמות שטוח רגיל. תיקיות בקטגוריות שבהן מופעל מרחב שמות היררכי מאפשרות לארגן אובייקטים באמצעות ספריות, כולל יכולות כמו שינוי שמות של תיקיות אטומיות. במסמך הזה מתוארים המטא-נתונים של תיקיות, פעולות בתיקיות, האינטראקציה של תיקיות עם תיקיות מנוהלות ושיקולים לשימוש בתיקיות.
תיקיות בקטגוריות שמופעל בהן מרחב שמות היררכי שונות מתיקיות מדוּמות ומתיקיות מנוהלות. תיקיות מדומות קיימות בקטגוריות עם מרחב שמות שטוח, ואפשר להחיל תיקיות מנוהלות גם בקטגוריות עם מרחב שמות שטוח וגם בקטגוריות עם מרחב שמות היררכי. תיקיות מנוהלות משמשות בעיקר כדי לתת הרשאות 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 לערך /, אפשר להציג תיקיות במצב דמוי ספרייה, ולהחזיר רק את התיקיות שתואמות לתחילית או שנמצאות רמה אחת מתחתיה.
הפעולה list folders מחזירה תוצאות עם חלוקה לדפים. דף תשובה אחד יכול להכיל עד 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 משנה גם את השם של התיקייה המנוהלת המשויכת.
במאמר מתן שמות לתיקיות מוסבר על הדרישות למתן שמות לתיקיות שיש להן תיקייה מנוהלת משויכת.
הנחיות למתן שמות לתיקיות
כשיוצרים תיקיות, צריך לפעול לפי ההנחיות הבאות:
הקשר בין שמות של אובייקטים לשמות של תיקיות: בקטגוריות שבהן מופעל מרחב שמות היררכי, תיקיות ואובייקטים הם משאבים נפרדים, למרות שהשם של האובייקט כולל את הנתיב לתיקייה שלו. שם האובייקט הוא תמיד הנתיב המלא בתוך הקטגוריה (למשל
dir1/foo.txt), וכל לוכסן (/) משמש כמפריד שממקם את האובייקט בתוך משאב תיקייה (למשלdir1/).קטגוריות שמופעל בהן מרחב שמות היררכי תומכות בכל שמות האובייקטים התקינים, כולל כאלה עם קווים נטויים בתחילת השם, בסוף השם או ברצף. כשמעלים אובייקט, Cloud Storage יוצר באופן אוטומטי את כל משאבי התיקיות החסרים בנתיב שלו.
בטבלה הבאה מוסבר איך שמות של אובייקטים ממופים למשאבי תיקיות:
שם האובייקט תיקיית האב המיקום בהיררכיית התיקיות foo.txtתיקיית בסיס לכל קטגוריה יש תיקיית בסיס ללא שם. מכיוון ש- foo.txtלא מכיל לוכסן, האובייקט נמצא ישירות בתיקיית הבסיס.dir1/foo.txtdir1/השם המלא של האובייקט הוא dir1/foo.txt, ולאfoo.txt. הוא נמצא בתיקייה ברמה העליונהdir1/, שהיא שונה מתיקיית הבסיס.dir1/dir1/לוכסן בסוף לא הופך אובייקט לתיקייה. במקום זאת, אובייקט בשם dir1/הוא משאב אובייקט נפרד שנמצא בתוך התיקייהdir1/./foo.txt/לוכסן בתחילת השם מגדיר תיקייה ברמה העליונה בשם /, שהיא שונה מתיקיית הבסיס. האובייקט/foo.txtנמצא בתוך התיקייה/.dir1//foo.txtdir1//לוכסנים עוקבים מגדירים תיקיות בתצוגת עץ. האובייקט dir1//foo.txtנמצא בתיקייהdir1//ברמה השנייה, שהיא צאצא שלdir1/.מידע רגיש או פרטים אישיים מזהים (PII): שמות של תיקיות גלויים באופן נרחב יותר מאשר המטא-נתונים של התיקיות. לדוגמה, שמות של תיקיות מופיעים בכתובות URL וברשימת התיקיות או האובייקטים בקטגוריה. אל תכללו מידע רגיש או פרטים אישיים מזהים בשמות של תיקיות.
הגודל המקסימלי של שם התיקייה: 512 בייטים (בקידוד UTF-8).
עומק תיקייה מקסימלי: קטגוריות שבהן מופעל מרחב שמות היררכי תומכות בעומק תיקייה מקסימלי של 50. אפשר ליצור תיקיות עם עד 50 תיקיות צאצאים מוערמות (לדוגמה,
folder1/folder2/folder3/.../folder50/my-data.txt). עם זאת, אם לתיקייה יש תיקייה מנוהלת משויכת, יכולות להיות לה רק עד 15 תיקיות צאצאים מוערמות.