התצוגה SESSIONS_BY_USER
התצוגה INFORMATION_SCHEMA.SESSIONS_BY_USER מכילה מטא-נתונים בזמן אמת על סשנים של BigQuery שנוצרו על ידי המשתמש הנוכחי בפרויקט הנוכחי.
ההרשאות הנדרשות
כדי לשלוח שאילתה לתצוגה המפורטת INFORMATION_SCHEMA.SESSIONS_BY_USER, צריך הרשאה לניהול זהויות והרשאות גישה (IAM) bigquery.jobs.list בפרויקט.
כל אחד מהתפקידים המוגדרים מראש הבאים ב-IAM כולל את ההרשאה הנדרשת:
- צפייה בחשבון לחיוב
- משתמש BigQuery
מידע נוסף על הרשאות ב-BigQuery זמין במאמר בקרת גישה באמצעות IAM.
סכימה
כשמריצים שאילתה על התצוגות המפורטות INFORMATION_SCHEMA.SESSIONS_BY_*, תוצאות השאילתה מכילות שורה אחת לכל סשן ב-BigQuery.
לתצוגה INFORMATION_SCHEMA.SESSIONS_BY_* יש את הסכימה הבאה:
| שם העמודה | סוג נתונים | ערך |
|---|---|---|
creation_time |
TIMESTAMP |
(Partitioning column) מועד היצירה של הסשן הזה. החלוקה למחיצות מבוססת על זמן UTC של חותמת הזמן הזו. |
expiration_time |
TIMESTAMP |
(עמודת חלוקה) מועד התפוגה של הסשן הזה. החלוקה למחיצות מבוססת על זמן UTC של חותמת הזמן הזו. |
is_active |
BOOL |
האם הסשן עדיין פעיל? TRUE אם כן, אחרת
FALSE.
|
last_modified_time |
TIMESTAMP |
(Partitioning column) השעה שבה בוצע השינוי האחרון בסשן. החלוקה למחיצות מבוססת על זמן UTC של חותמת הזמן הזו. |
project_id |
STRING |
(Clustering column) מזהה הפרויקט. |
project_number |
INTEGER |
מספר הפרויקט. |
session_id |
STRING |
מזהה הסשן. לדוגמה, bquxsession_1234. |
user_email |
STRING |
(Clustering column) כתובת האימייל או חשבון השירות של המשתמש שהפעיל את הסשן. |
כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כל כללי (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;
INFORMATION_SCHEMA
התוצאות צריכות להיראות כך:
+-------------------------------------------------------------------------+ | session_id | creation_time | +-------------------------------------------------------------------------+ | CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm | 2021-06-01 08:04:26 | | CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 | +-------------------------------------------------------------------------+