אישור חשבונות להעברת נתונים
שירות העברת הנתונים ל-BigQuery מאפשר לאמת חשבונות משתמשים, חשבונות שירות וסוכני שירות ולתת להם הרשאות לנהל הגדרות העברה ולהפעיל העברות נתונים אוטומטיות. כדי לשלוט בגישה לנתוני המקור ולקבוצות הנתונים ביעד, ולפתור שגיאות נפוצות שקשורות להרשאות, אתם צריכים לתת את ההרשאות הנדרשות לחשבונות בפרויקט. למידע על הרשאות ספציפיות למקור נתונים, עיינו במסמכי התיעוד של ההעברה לכל מקור נתונים.
מושגים מרכזיים
שירות העברת הנתונים ל-BigQuery מאפשר להעביר נתונים באופן אוטומטי ממקורות שונים ל-BigQuery. מודל האימות וההרשאה פועל בשני שלבים שונים, מישור הבקרה ומישור הנתונים, ולשני סוגים של משתמשים: יוצר ההעברה או בעלי ההעברה.
מישור הבקרה
מישור הבקרה מייצג את השלב בתהליך ההרשאה שבו משתמש מאומת יכול לשלוט בהגדרות ובהפעלות של ההעברות ולנהל אותן. למשתמש במישור הבקרה צריכות להיות הרשאות מתאימות לניהול זהויות והרשאות גישה (IAM) כדי לשלוט בהגדרות ובהפעלות של ההעברות ולנהל אותן:
- ההרשאה
bigquery.transfers.update, שמאפשרת למשתמשים:- להגדיר את הגדרות העברת הנתונים.
- לנהל את ההעברות הקיימות, למשל לעדכן, להשבית או למחוק העברה.
- ההרשאה
bigquery.transfers.get, שמאפשרת למשתמשים לעקוב אחרי הפעלות של העברות, למשל לבדוק את הסטטוס של הפעלת העברה או להציג את ההיסטוריה והיומנים של הפעלת העברה.
אם אתם משתמשים במסוף Google Cloud או בכלי שורת הפקודה של BigQuery כדי ליצור העברה, אתם צריכים גם את ההרשאה bigquery.transfers.get.
ההרשאה bigquery.transfers.update לא נדרשת כדי להגדיר שאילתה מתוזמנת. למידע נוסף, קראו על ההרשאות הנדרשות לשאילתות מתוזמנות.
מישור הנתונים
מישור הנתונים מייצג את השלב שמחוץ לשליטה הישירה של המשתמש. במישור הנתונים, שירות העברת הנתונים ל-BigQuery יכול להפעיל העברות נתונים במצב אופליין, ולהפעיל הרצות של העברות באופן אוטומטי על סמך לוח זמנים שהמשתמשים מציינים. במישור הנתונים, פרטי הכניסה של בעלי ההעברה משמשים כדי לגשת לנתוני המקור, ובהתאם למקור הנתונים, פרטי הכניסה של בעלי ההעברה או סוכן השירות של שירות העברת הנתונים ל-BigQuery משמשים כדי להפעיל משימות ב-BigQuery ולכתוב נתונים במערך הנתונים של היעד.
למידע נוסף על ההרשאות הנדרשות, קראו את הסעיפים הבאים במדריך הזה:
- הרשאת גישה לקריאה למקורות נתונים חיצוניים
- הרשאה להפעלת משימות ב-BigQuery
- הרשאה להריץ משימות ב-BigQuery ולכתוב נתונים במערך הנתונים של היעד
יוצר ההעברה לעומת בעלי ההעברה
יוצר ההעברה הוא המשתמש שיצר והגדיר את הגדרות ההעברה. המשתמש בשירות העברת הנתונים ל-BigQuery ויוצר ההעברה יכולים להיות חשבון משתמש או חשבון שירות.
הבעלים של ההעברה הוא זהות המשתמש שבה שירות העברת הנתונים ל-BigQuery משתמש כדי לאשר את העברת הנתונים, ובאופן ספציפי כדי לחלץ את נתוני המקור. במקורות נתונים שתומכים בחשבונות שירות, הבעלים של ההעברה יכול להיות חשבון משתמש או חשבון שירות. במקורות נתונים אחרים, הבעלים של ההעברה חייב להיות חשבון משתמש.
הבעלים של ההעברה ויוצר ההעברה יכולים להיות אותו משתמש, אבל זו לא דרישה. יש כמה דרכים להגדיר את הבעלים של ההעברה כמשתמש שונה מהיוצר של ההעברה:
- כשיוצרים העברה, אפשר להגדיר את הבעלים כחשבון שירות אם מקור הנתונים תומך בחשבונות שירות.
- אחרי שיוצרים העברה, אפשר להעביר את הבעלות לחשבון משתמש חדש (או לחשבון שירות, אם מקור הנתונים תומך בחשבונות שירות) שיש לו את ההרשאות
bigquery.transfers.updateו-bigquery.transfers.get. אתם צריכים להיות מחוברים לחשבון החדש כשאתם מעדכנים את פרטי הכניסה.
הרשאת גישה לקריאה למקורות נתונים חיצוניים
ההרשאות שנדרשות כדי לקרוא נתוני מקור יכולות להשתנות ממקור נתונים אחד לאחר. לדוגמה, כדי לגשת אל Google Ads נדרשות הרשאות גישה לקריאה למספר הלקוח ב-Google Ads. באופן דומה, ב-Google Play נדרשת גישה לדוחות במסוף Google Play. למידע נוסף על הרשאות ספציפיות למקור נתונים, עיינו במדריכי ההעברה של כל מקור נתונים.
בהתאם לסוג הזהות של בעלי ההעברה, נדרשת שיטת הרשאה שונה כדי לאחזר את אסימון הגישה לנתוני המקור.
העברת בעלות כחשבון שירות
כשמשתמשים בחשבון שירות כבעלים של ההעברה, ההרשאות הנדרשות ניתנות באופן אוטומטי כשמפעילים את BigQuery Data Transfer Service API בפרויקט. שירות העברת הנתונים ל-BigQuery משתמש בסוכן שירות כדי לקבל את אסימון הגישה לחשבון השירות שסופק על ידי המשתמש (הבעלים של ההעברה).
כשמפעילים את שירות העברת נתונים ל-BigQuery API, נוצר סוכן שירות בפרויקט. המערכת גם מקצה לסוכן השירות את התפקיד "סוכן שירות העברת נתונים ל-BigQuery" (roles/bigquerydatatransfer.serviceAgent), שכולל את ההרשאה iam.serviceAccounts.getAccessToken. ההרשאה הזו מאפשרת לסוכן השירות של שירות העברת הנתונים ל-BigQuery להתחזות לחשבון השירות של בעלי ההעברה כדי לאחזר את אסימון הגישה.
למידע נוסף על סוכן השירות של שירות העברת הנתונים ל-BigQuery, קראו את המאמר סוכן שירות. למידע נוסף על השימוש בחשבונות שירות ולרשימה העדכנית של מקורות נתונים שתומכים בחשבונות שירות, קראו את המאמר שימוש בחשבונות שירות.
העברת בעלות כחשבון משתמש
אם הבעלים של ההעברה שיוצר את הגדרות ההעברה הוא חשבון משתמש (ולא חשבון שירות), צריך לתת ידנית לשירות העברת הנתונים ל-BigQuery הרשאה לקבל את טוקן הגישה לחשבון המשתמש ולגשת לנתוני המקור בשם הבעלים של ההעברה. אתם יכולים לאשר ידנית באמצעות ממשק תיבת הדו-שיח של OAuth.
צריך לתת הרשאה לשירות העברת הנתונים ל-BigQuery רק בפעם הראשונה שיוצרים העברה למקור נתונים נתון. צריך לתת את ההרשאה שוב כשיוצרים את ההעברה הראשונה לאזור חדש, גם אם משתמשים באותו מקור נתונים. העברות נתונים מערוצי YouTube הן יוצאות מן הכלל – צריך לאשר הרשאות באופן ידני בכל פעם שיוצרים העברת נתונים מערוץ YouTube.
אם הבעלים החדש של ההעברה אף פעם לא יצר העברה של מקור הנתונים באזור הזה, צריך לאשר ידנית גם את שינוי הבעלים של ההעברה באמצעות עדכון פרטי הכניסה.
בצילום המסך הבא מוצג ממשק תיבת הדו-שיח של OAuth כשיוצרים העברה ב-Google Ads. בתיבת הדו-שיח מוצגות ההרשאות הספציפיות למקור הנתונים שצריך לתת:
כדי לבטל את ההרשאות שניתנו, פועלים לפי השלבים הבאים:
- עוברים אל הדף של החשבון ב-Google.
- לוחצים על שירות העברת נתונים ל-BigQuery.
- כדי לבטל את ההרשאות, לוחצים על הסרת הגישה.
הרשאה להפעלת משימות ב-BigQuery
כשמעבירים נתונים מרוב מקורות הנתונים, למעט העברה באמצעות שאילתות מתוזמנות או עותקים של מערכי נתונים, שירות העברת הנתונים ל-BigQuery מסתמך על סוכני שירות כדי להתחיל משימות ב-BigQuery בפרויקט. ההרשאה הנדרשת bigquery.job.create ניתנת באופן אוטומטי לסוכן השירות כשמפעילים את BigQuery Data Transfer Service API בפרויקט. מידע נוסף זמין במאמר הפעלת שירות העברת הנתונים ל-BigQuery.
כשמעבירים נתונים באמצעות שאילתות מתוזמנות או עותקים של מערכי נתונים, שירות העברת הנתונים ל-BigQuery משתמש בפרטי הכניסה של בעלי ההעברה כדי להתחיל את המשימות ב-BigQuery.
הרשאה להריץ משימות ב-BigQuery ולכתוב נתונים במערך הנתונים של היעד
כשמעבירים נתונים מרוב מקורות הנתונים, למעט העברה באמצעות שאילתות מתוזמנות או עותקים של מערכי נתונים, שירות העברת הנתונים ל-BigQuery מסתמך על סוכן השירות כדי לכתוב נתונים במערך הנתונים של היעד ב-BigQuery. ההרשאה הנדרשת, roles/bigquery.dataEditor, ניתנת לסוכן השירות על ידי שירות העברת הנתונים ל-BigQuery כשיוצרים את ההעברה. כדי להעניק את ההרשאה, צריך להיות לכם את ההרשאה bigquery.datasets.update במערך הנתונים של היעד.
כשמעבירים נתונים באמצעות שאילתות מתוזמנות או עותקים של מערכי נתונים, שירות העברת הנתונים ל-BigQuery משתמש בפרטי הכניסה של בעלי ההעברה כדי להריץ את המשימות ב-BigQuery ולכתוב את הנתונים במערך הנתונים של היעד ב-BigQuery.
שיקולים בנושא הרשאות להעברות של ערוצי YouTube
בהעברת נתונים של ערוץ YouTube, המחבר של ערוץ YouTube יכול להעביר רק נתונים מערוץ YouTube שמשויך לפרטי הכניסה של המשתמש שיוצר את העברת הנתונים. כדי להעביר נתונים מערוצי YouTube שונים, צריך ליצור העברת נתונים לכל ערוץ, ולהשתמש בפרטי הכניסה של המשתמש שמשויכים לאותו ערוץ YouTube.
פתרון בעיות שקשורות לשגיאות בהרשאות
אם נתקלתם בבעיות שקשורות להרשאות או לאישורים בהעברה, קראו את המאמר בעיות שקשורות להרשאות ולאישורים.