התצוגה SESSIONS_BY_USER
התצוגה INFORMATION_SCHEMA.SESSIONS_BY_USER מכילה מטא-נתונים בזמן אמת על סשנים ב-BigQuery שנוצרו על ידי המשתמש הנוכחי בפרויקט הנוכחי.
ההרשאות הנדרשות
כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.SESSIONS_BY_USER, צריך את ההרשאה bigquery.jobs.list לניהול זהויות והרשאות גישה (IAM) בפרויקט.
כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל את ההרשאה הנדרשת:
- צפייה בחשבון לחיוב
- משתמש ב-BigQuery
למידע נוסף על הרשאות ב-BigQuery, קראו את המאמר בקרת גישה באמצעות IAM.
סכימה
כששולחים שאילתה לתצוגות INFORMATION_SCHEMA.SESSIONS_BY_*, תוצאות השאילתה מכילות שורה אחת לכל סשן ב-BigQuery.
הסכימה של התצוגה INFORMATION_SCHEMA.SESSIONS_BY_* היא:
| שם העמודה | סוג נתונים | ערך |
|---|---|---|
creation_time |
TIMESTAMP |
(עמודת חלוקה למחיצות) מועד היצירה של הסשן הזה. החלוקה למחיצות מבוססת על זמן ה-UTC של חותמת הזמן הזו. |
expiration_time |
TIMESTAMP |
(עמודת חלוקה למחיצות) מועד התפוגה של הסשן הזה. החלוקה למחיצות מבוססת על זמן ה-UTC של חותמת הזמן הזו. |
folder_numbers |
ARRAY<INT64> |
המזהים של התיקיות בהיררכיה שמכילה את הפרויקט, מהרמה הנמוכה ביותר לרמה הגבוהה ביותר בהיררכיה. |
is_active |
BOOL |
האם הסשן עדיין פעיל? TRUE אם כן, אחרת FALSE.
|
last_modified_time |
TIMESTAMP |
(עמודת חלוקה למחיצות) הזמן שבו הסשן השתנה לאחרונה. החלוקה למחיצות מבוססת על זמן ה-UTC של חותמת הזמן הזו. |
principal_subject |
STRING |
המזהה של חשבון המשתמש שהפעיל את הסשן. user:USER_EMAIL למשתמשים בחשבון Google, serviceAccount:SA_EMAIL לחשבונות שירות או מזהה ישות מורשית שמתחיל ב-principal:// עבור איחוד זהויות של כוח עבודה וישויות מורשות של איחוד זהויות של עומסי עבודה (WIF).
|
project_id |
STRING |
(עמודת אשכול) מזהה הפרויקט. |
project_number |
INTEGER |
מספר הפרויקט. |
session_id |
STRING |
מזהה הסשן. לדוגמה, bquxsession_1234. |
user_email |
STRING |
(עמודת אשכול) כתובת האימייל או חשבון השירות של המשתמש שהפעיל את הסשן. |
כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כללי לחיפוש (SELECT *). ציון מפורש של העמודות מונע את קריסת השאילתות אם הסכימה הבסיסית משתנה.
שמירת נתונים
התצוגה הזו מכילה סשנים שפועלים כרגע והיסטוריה של סשנים שהושלמו ב-180 הימים האחרונים.
היקף ותחביר
שאילתות בתצוגה הזו חייבות לכלול מזהה אזור. אם לא מציינים מזהה אזורי, המטא-נתונים מאוחזרים מכל האזורים. בטבלה הבאה מוסבר היקף האזור של התצוגה הזו:
| הצגת השם | היקף המשאבים | היקף האזור |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_USER |
סשנים שנוצרו על ידי המשתמש הנוכחי בפרויקט שצוין. | REGION |
-
PROJECT_ID: אופציונלי, מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל. -
REGION: כל שם של אזור של מערך נתונים. לדוגמה,`region-us`.
דוגמה
כדי להריץ את השאילתה בפרויקט אחר, ולא בפרויקט ברירת המחדל, מוסיפים את מזהה הפרויקט בפורמט הבא:
`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_USER
`myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER.
בדוגמה הבאה מוצגת רשימה של סשנים שנוצרו על ידי המשתמש הנוכחי:
SELECT session_id, creation_time FROM `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER WHERE creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY) ORDER BY creation_time DESC;
התוצאות אמורות להיראות כך:
+-------------------------------------------------------------------------+ | session_id | creation_time | +-------------------------------------------------------------------------+ | CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm | 2021-06-01 08:04:26 | | CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 | +-------------------------------------------------------------------------+