יצירה וניהול של תיקיות

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

התיקיות ב-BigQuery מופעלות באמצעות Dataform.

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

לפני שמתחילים

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the BigQuery and Dataform APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

התפקידים הנדרשים

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

כדי לקבל את ההרשאות שדרושות לשימוש בדפדפן הקבצים של BigQuery, בקשו מהאדמין להקצות לכם את התפקיד משתמש ב-BigQuery (roles/bigquery.user) או משתמש ב-BigQuery Studio (roles/bigquery.studioUser) בפרויקט.

הרשאות שניתנות בתיקייה מועברות לכל הקבצים והתיקיות שבתוכה.

הכללים הבאים חלים על קבצים ועל התיקיות שמכילות אותם:

תפקיד	ניתנה ב-	הרשאות ותרחישי שימוש
בעלי הקוד (roles/dataform.codeOwner)	קובץ או תיקייה	התפקיד הזה נותן שליטה מלאה על משאב במערכת הקבצים והתיקיות. משתמש עם התפקיד הזה יכול לבצע את כל הפעולות, כולל מחיקת המשאב, הגדרת מדיניות ה-IAM שלו והעברה שלו.
עורך קוד (roles/dataform.codeEditor)	קובץ או תיקייה	מאפשרת לערוך ולנהל תוכן. משתמש עם התפקיד הזה יכול להוסיף תוכן לתיקיות, לערוך קבצים ולקבל את מדיניות ה-IAM של קובץ או תיקייה. התפקיד הזה נדרש גם בתיקיית היעד כשמעבירים משאב.
הוספת הערות לקוד (roles/dataform.codeCommenter)	קובץ או תיקייה	מאפשר להגיב על נכסי קוד או תיקיות.
צפייה בקוד (roles/dataform.codeViewer)	קובץ או תיקייה	הרשאת קריאה בלבד. משתמש עם התפקיד הזה יכול לשלוח שאילתות לגבי התוכן של קבצים ותיקיות.
יוצר הקוד (roles/dataform.codeCreator)	פרויקט	נותנת הרשאה ליצור קבצים ותיקיות חדשים בפרויקט.

התפקידים הבאים ספציפיים לניהול תיקיות של צוותים:

תפקיד	ניתנה ב-	הרשאות ותרחישי שימוש
הבעלים של התיקייה של הצוות (roles/dataform.teamFolderOwner)	תיקיית צוות	התפקיד הזה נותן שליטה מלאה על תיקיית צוות במערכת הקבצים והתיקיות. משתמש עם התפקיד הזה יכול למחוק את תיקיית הצוות ולהגדיר את מדיניות ה-IAM שלה.
בעל הרשאת עריכה בתיקייה של הצוות (roles/dataform.teamFolderContributor)	תיקיית צוות	מאפשרת לנהל את התוכן בתיקייה של הצוות. משתמש עם התפקיד הזה יכול לעדכן תיקיית צוות.
מגיב בתיקייה של הצוות (roles/dataform.teamFolderCommenter)	תיקיית צוות	מאפשרת להגיב על תיקייה של צוות ועל נכסי הקוד שהיא מכילה.
צפייה בתיקייה של הצוות (roles/dataform.teamFolderViewer)	תיקיית צוות	הרשאת קריאה בלבד לתיקייה של הצוות ולתוכן שלה. משתמש עם התפקיד הזה יכול לראות תיקיית צוות ולקבל את מדיניות ה-IAM שלה.
יצירת תיקיות צוות (roles/dataform.teamFolderCreator)	פרויקט	הרשאה ליצור תיקיות צוות חדשות בפרויקט.

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

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

ההרשאות הנדרשות

• יוצרים תיקייה:
  • folders.create בתיקיית המשתמש, בתיקיית הצוות או בפרויקט ברמה שמעל
  • folders.addContents בתיקיית ההורה או בתיקיית הצוות
• אחזור המאפיינים של תיקייה: folders.get בתיקייה
• שליחת שאילתה על התוכן של תיקייה או תיקייה של צוות: folders.queryContents בתיקייה
• עדכון תיקייה: folders.update בתיקייה
• מחיקת תיקייה: folders.delete בתיקייה
• קבלת מדיניות ה-IAM של תיקייה: folders.getIamPolicy בתיקייה
• הגדרת מדיניות ה-IAM של תיקייה: folders.setIamPolicy בתיקייה
• העברת תיקייה:
  • folders.move בתיקייה שמועברת
  • folders.addContents בתיקיית היעד או בתיקיית הצוות (לא נדרש אם מעבירים לתיקיית שורש)
• יצירת תיקייה לצוות: teamFolders.create בפרויקט
• מחיקת תיקייה של צוות: teamFolders.delete בתיקייה של הצוות
• קבלת מדיניות ה-IAM של תיקיית צוות: teamFolders.getIamPolicy בתיקיית הצוות
• הגדרת מדיניות IAM לתיקיית צוות: teamFolders.setIamPolicy בתיקיית הצוות
• אחזור המאפיינים של תיקיית צוות: teamFolders.get בתיקיית הצוות
• עדכון תיקיית צוות: teamFolders.update בתיקיית הצוות

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

כדי לקבל גישה מלאה לכל התיקיות והקבצים בפרויקט, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט:

• אדמין ב-Dataform (roles/dataform.admin)
• עריכה ב-Dataform (roles/dataform.editor)
• צפייה ב-Dataform (roles/dataform.viewer)

לעיון במשאבים

כדי לראות תיקיות ונכסי קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

   אם החלונית הימנית לא מוצגת, לוחצים על הרחבת החלונית הימנית כדי לפתוח אותה.

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

   • מרחיבים את הצומת User (your email address) כדי לראות את התיקיות והקבצים שיצרתם.
   • מרחיבים את הצומת Team folders כדי לראות את כל תיקיות הצוות שיש לכם גישה אליהן.
   • מרחיבים את הצומת Shared with me כדי לראות את כל התיקיות והקבצים שמשתמשים אחרים שיתפו איתכם.

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

הגדרת אזור ברירת המחדל לנכסי קוד

יכולים להיות לכם תיקיות ונכסי קוד באזורי קוד שונים.

כל נכסי הקוד החדשים בפרויקט Google Cloud משתמשים באזור ברירת המחדל. אחרי שיוצרים את הנכס, אי אפשר לשנות את האזור שלו.

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

כדי להגדיר את אזור ברירת המחדל לנכסי קוד חדשים:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. ליד שם הפרויקט, לוחצים על View files panel actions > Switch code region.

4. בוחרים את אזור הקוד שרוצים להשתמש בו כברירת מחדל.

5. לוחצים על Save.

רשימת האזורים הנתמכים ב-BigQuery Studio

רענון תוכן התיקייה

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

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

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

4. לוחצים על הצגת פעולות > רענון התוכן.

יצירת תיקייה או נכס קוד

אפשר להשתמש בתהליך הזה כדי ליצור את המשאבים הבאים:

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

איך יוצרים תיקייה לצוות

כדי ליצור תיקייה או נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את צומת הבסיס של המשתמש או את התיקייה שבה רוצים ליצור את המשאב.

4. לוחצים על View actions > Create ובוחרים את סוג המשאב שרוצים ליצור.

5. בחלונית ליצירת משאב, מקלידים שם למשאב החדש.

6. לוחצים על Save.

יצירת תיקייה לצוות

כדי ליצור תיקיית צוות ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את צומת הרמה הבסיסית של התיקייה של הצוות.

4. לוחצים על הצגת פעולות > יצירת תיקייה של צוות.

5. בתיבת הדו-שיח Create team folder, מקלידים שם לתיקיית הצוות.

6. לוחצים על יצירה.

העלאת נכס קוד

כדי להעלות נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את התיקייה שאליה רוצים להעלות את נכס הקוד.

4. לוחצים על View actions > Upload ובוחרים את סוג נכס הקוד שרוצים להעלות.

5. בחלונית של העלאת המשאב, מבצעים אחת מהפעולות הבאות:

   • לוחצים על כפתור הבחירה File upload, מחפשים קובץ מקומי ובוחרים אותו.
   • לוחצים על כפתור הבחירה URL ומקלידים את כתובת ה-URL של קובץ נכס הקוד שנמצא במאגר ב-GitHub.

6. מקלידים שם לנכס הקוד.

7. אופציונלי: בוחרים אזור שבו רוצים לאחסן את נכס הקוד.

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

8. לוחצים על Save.

הורדת נכס קוד

כדי להוריד נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את נכס הקוד שרוצים להוריד.

4. לוחצים על הצגת פעולות > הורדה.

שינוי השם של תיקייה או נכס קוד

כדי לשנות את השם של תיקייה או של נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את התיקייה או את נכס הקוד שרוצים לשנות את השם שלהם.

4. לוחצים על הצגת פעולות > שינוי שם.

5. בתיבת הדו-שיח לשינוי שם המשאב, מקלידים שם חדש למשאב.

6. לוחצים על שינוי שם.

שיתוף תיקייה או נכס קוד

כדי לשתף תיקייה או נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את התיקייה או את נכס הקוד שרוצים לשתף.

4. בחלונית Share permissions, לוחצים על Add User/Group.

5. בשדה New principals, מזינים חשבון משתמש.

6. מבצעים אחת מהפעולות הבאות:

   • ברשימה Role, בוחרים אחד מהתפקידים הבאים כדי לשתף נכס קוד, כולל תיקיית משתמש:

     • ‫roles/dataform.codeOwner: יכולים לבצע כל פעולה בנכס הקוד, כולל מחיקה או שיתוף שלו.
     • ‫roles/dataform.codeEditor: יכולים לבצע כל פעולה בנכס הקוד, חוץ מלמחוק או לשתף אותו.
     • ‫roles/dataform.codeCommenter: יכולים לצפות בנכס הקוד ולהוסיף לו הערות.
     • ‫roles/dataform.codeViewer: יכולים לראות את נכס הקוד.

   • ברשימה Role, בוחרים אחד מהתפקידים הבאים כדי לשתף תיקיית צוות:

     • roles/dataform.teamFolderOwner: יכולים לבצע כל פעולה בתיקייה של הצוות, כולל למחוק או לשתף אותה.
     • ‫roles/dataform.teamFolderContributor: יכולים לבצע כל פעולה בתיקייה של הצוות, חוץ מלמחוק או לשתף אותה.
     • roles/dataform.teamFolderCommenter: יכולים לצפות בתיקיית הצוות ובנכסי הקוד שהיא מכילה, ולהגיב עליהם.
     • ‫roles/dataform.teamFolderViewer: יכולים לראות את התיקייה של הצוות ואת נכסי הקוד שהיא מכילה.

7. לוחצים על Save.

8. כדי לחזור לדף המידע של ה-Notebook, לוחצים על סגירה.

העברת תיקייה או נכס קוד

כדי להעביר תיקייה או נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בהתאם למספר המשאבים שרוצים להעביר, מבצעים אחת מהפעולות הבאות:

   • העברת משאב אחד: בדפדפן הקבצים, בוחרים את התיקייה או את נכס הקוד שרוצים להעביר, ואז לוחצים על View actions > Move.
   • העברת כמה משאבים: בתצוגת התיקיות, מסמנים את התיבה לצד כל משאב שרוצים להעביר ולוחצים על Move.

4. בתיבת הדו-שיח להעברת משאבים, בוחרים את תיקיית המשתמש או את התיקייה של הצוות שאליה רוצים להעביר את המשאב.

5. לוחצים על Move.

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

העתקת נכס קוד

כדי להעתיק נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בוחרים את נכס הקוד שרוצים להעתיק.

4. לוחצים על הצגת הפעולות > העתקה.

5. בתיבת הדו-שיח להעתקת המשאב, בוחרים את תיקיית המשתמש או התיקייה של הצוות שאליה רוצים להעתיק את המשאב.

6. לוחצים על Copy.

מחיקת תיקייה או נכס קוד

כדי למחוק תיקייה או נכס קוד ב-BigQuery:

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

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

   

3. בהתאם למספר המשאבים שרוצים למחוק, מבצעים אחת מהפעולות הבאות:

   • מחיקת משאב יחיד: בדפדפן הקבצים, בוחרים את התיקייה או את נכס הקוד שרוצים למחוק, ואז לוחצים על View actions > Delete.
   • מחיקה של כמה משאבים: בתצוגת התיקיות, מסמנים את התיבה לצד כל משאב שרוצים למחוק ולוחצים על Delete.

4. בתיבת הדו-שיח למחיקת המשאב, לוחצים על מחיקה.

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

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

• ארגון נכסי קוד באמצעות תיקיות
• יצירת תיקיות Notebook
• יצירת שאילתות שמורות
• יצירת קנבסי נתונים
• יצירת תהליכים להכנת נתונים