איך יוצרים ומנהלים סביבות עבודה

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

הערה: כדי לשלוח משוב או לשאול שאלות שקשורות לתכונה הזו בגרסת טרום-השקה (Preview), אפשר לפנות לכתובת [e-mail].

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

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

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

אם עדיין לא עשיתם את זה, צרו מאגר BigQuery.

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

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

יצירת סביבת עבודה

האופן שבו יוצרים סביבת עבודה משתנה בהתאם למאגר שבו משתמשים – מאגר BigQuery או מאגר של צד שלישי.

יצירת סביבת עבודה במאגר BigQuery

כדי ליצור סביבת עבודה חדשה במאגר BigQuery:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. בכלי העריכה, לוחצים על הוספת סביבת עבודה.

5. בחלונית Create development workspace, בשדה Workspace ID, מזינים מזהה ייחודי לסביבת העבודה.

   המזהים יכולים לכלול רק מספרים, אותיות, מקפים וקווים תחתונים.

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

יצירת סביבת עבודה במאגר של צד שלישי

כדי ליצור סביבת עבודה חדשה במאגר של צד שלישי:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. בכלי העריכה, לוחצים על הוספת סביבת עבודה. החלונית Create development workspace תיפתח.

5. בוחרים באפשרות Existing remote branch או New branch, בהתאם לסוג ההסתעפות שרוצים להשתמש בה בסביבת העבודה.

6. מציינים את הענף שבו רוצים להשתמש:

   1. אם בחרתם באפשרות Existing remote branch, בוחרים הסתעפות קיימת בשדה Remote branch.

   2. אם בחרתם בכפתור הבחירה New branch, מקלידים שם של הסתעפות בשדה Workspace ID. שם ההסתעפות שנוצר במאגר של הצד השלישי זהה למזהה של סביבת העבודה ב-BigQuery.

      המזהים יכולים לכלול רק מספרים, אותיות, מקפים וקווים תחתונים.

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

יצירת ספרייה בסביבת עבודה

כדי ליצור ספרייה בסביבת עבודה, פועלים לפי השלבים הבאים:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. לוחצים על פתיחת תפריט היצירה.

6. לוחצים על Create in repository > Directory.

7. בשדה הוספת נתיב לספרייה, מקלידים נתיב לספרייה.

8. לוחצים על יצירת ספרייה.

עבודה עם קבצים בסביבת עבודה

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

אפשר ליצור או להעלות למאגר את סוגי הקבצים הבאים:

• שאילתות SQL
• קובצי notebook של Python
• קנבסי נתונים
• הכנת הנתונים
• קבצים מכל סוג אחר

יצירת קובץ

כדי ליצור קובץ בסביבת עבודה, פועלים לפי השלבים הבאים:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. לוחצים על פתיחת תפריט היצירה.

6. לוחצים על Create in repository ואז על סוג הקובץ שרוצים ליצור.

7. בשדה Name, מקלידים שם לקובץ.

8. אופציונלי: בשדה ספריית אם, מקלידים את נתיב הספרייה שבה רוצים ליצור את הקובץ.

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

העלאת קובץ

כדי להעלות קובץ לסביבת עבודה, פועלים לפי השלבים הבאים:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. לוחצים על פתיחת תפריט היצירה.

6. לוחצים על Upload to repository ואז על סוג הקובץ שרוצים להעלות.

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

   • בשדה File upload, לוחצים על Browse, בוחרים קובץ ולוחצים על Open.
   • בשדה כתובת URL, מקלידים את כתובת ה-URL של הקובץ.

8. אופציונלי: בשדה ספריית אם, מקלידים את נתיב הספרייה שבה רוצים ליצור את הקובץ.

9. לוחצים על Upload.

מחיקת קובץ

כדי למחוק קובץ מסביבת עבודה, פועלים לפי השלבים הבאים:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בוחרים את הקובץ שרוצים למחוק, לוחצים על View actions ואז על Delete.

6. לוחצים על מחיקה כדי לאשר.

שימוש בניהול גרסאות בקובץ

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

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

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

ב-BigQuery מוצגות האפשרויות הבאות לניהול גרסאות:

שמירת X שינויים

מבצעים את מספר השינויים המקומיים (X) בסביבת העבודה או בקבצים שנבחרו. ב-BigQuery יוצגו השינויים שלא בוצעו.

דחיפה להסתעפות ברירת המחדל

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

לחיצה על your-branch-name

דוחפים את השינויים שנשמרו אל your-branch-name. האפשרות הזו זמינה במאגר שמקושר למאגר Git של צד שלישי, אם אין לכם שינויים שלא בוצע להם commit בסביבת העבודה. שם ההסתעפות המרוחקת במאגר של הצד השלישי זהה למזהה של סביבת העבודה ב-BigQuery.

משיכה מההסתעפות שמוגדרת כברירת מחדל

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

משיכה מ-your-branch-name

עדכון סביבת העבודה עם השינויים האחרונים מ-your-branch-name. האפשרות הזו זמינה במאגר שמקושר למאגר Git של צד שלישי, אם אין לכם שינויים שלא בוצע להם commit בסביבת העבודה. שם ההסתעפות המרוחקת במאגר של הצד השלישי זהה למזהה של סביבת העבודה ב-BigQuery.

חזרה לשמירה האחרונה

משחזרים את הקבצים בסביבת העבודה למצב שלהם מה-commit האחרון.

משיכת שינויים

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בחלונית סביבת העבודה:

   1. אם אתם נמצאים במאגר BigQuery, לוחצים על Pull from default branch.

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

      1. לוחצים על Pull from default branch כדי למשוך מההסתעפות שמוגדרת כברירת מחדל במאגר של הצד השלישי.
      2. לוחצים על Pull from your-branch-name (משיכה מ-) כדי למשוך מההסתעפות של מאגר הצד השלישי שתואמת לסביבת העבודה הנוכחית.

שמירת השינויים

אחרי שמבצעים שינוי בסביבת עבודה, האפשרות Commit מופיעה ב-BigQuery. אתם יכולים לבצע את כל השינויים המקומיים או הקבצים שנבחרו. קבצים שהוספתם או שיניתם מסומנים בנקודה כחולה לצד הקובץ בחלונית סביבת העבודה.

הערה: כברירת מחדל, BigQuery משתמש בכתובת האימייל של המשתמש המאומת Google Cloud כמחבר של ה-commit, אבל Dataform API מאפשר להגדיר כתובת אימייל מותאמת אישית למחבר של ה-commit. ההתנהגות הזו דומה לפקודה git commit --author ומשפיעה רק על היסטוריית ה-commit ב-Git. זהות המחבר של ה-commit לא מאומתת באופן קריפטוגרפי.

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בחלונית סביבת העבודה, לוחצים על Commit X changes.

6. בחלונית Commit changes:

   1. בוחרים את הקבצים ששונו ורוצים לבצע בהם commit.

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

   2. בשדה Add a commit message, מקלידים תיאור ל-commit.

   3. לוחצים על Commit All changes או על Commit X changes.

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

שליחת השינויים

האפשרות Push מופיעה ב-BigQuery אחרי ששומרים את השינויים.

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בחלונית סביבת העבודה:

   1. אם אתם נמצאים במאגר BigQuery, לוחצים על Push to default branch.

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

      1. לוחצים על Push to default branch כדי להעביר את השינויים להסתעפות ברירת המחדל של המאגר של הצד השלישי.
      2. לוחצים על Push to your-branch-name כדי להעביר את השינויים להסתעפות של המאגר של הצד השלישי שתואמת לסביבת העבודה הנוכחית.

ביטול שינויים שלא נשמרו

כדי לבטל שינויים שלא נשמרו:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בחלונית סביבת העבודה, לוחצים על החץ למטה בכפתור של ניהול הגרסאות ואז על Revert to last commit.

פתרון התנגשויות במיזוג

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

בדרך כלל נתקלים בהתנגשות מיזוג כשמבצעים pull מענף אחרי שמשתמש אחר ביצע push של שינוי מתנגש לאותו ענף. צריך לפתור את ההתנגשות במיזוג באופן ידני על ידי עריכת הקובץ המושפע.

בדוגמת הקוד הבאה מוצג קונפליקט במיזוג בקובץ SQL:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

כדי לפתור התנגשות במיזוג:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בוחרים את הקובץ הרלוונטי ועורכים אותו לפי השינויים הרצויים.

6. thought שומרים את השינויים.

7. אופציונלי: מעבירים את השינויים.

הצגת היסטוריית השמירות

כדי לראות את היסטוריית השינויים, פועלים לפי השלבים הבאים:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על פתיחה.

   סביבת העבודה תיפתח בחלונית Source control.

5. בחלונית סביבת העבודה, לוחצים על החץ לתפריט הנפתח בלחצן של ניהול הגרסאות ואז על View commit history.

מחיקת סביבת עבודה

כדי למחוק סביבת עבודה ואת כל התוכן שלה:

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Source control.

   

   אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

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

4. מאתרים את סביבת העבודה ולוחצים על Open actions > Delete.

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

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

• איך מנהלים קוד באמצעות מאגרי Git ב-BigQuery Studio
• איך יוצרים מאגרים