מבוא ל-INFORMATION_SCHEMA

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

ב-BigQuery, מריצים שאילתות על INFORMATION_SCHEMA תצוגות באמצעות GoogleSQL על ידי ציון היקף ותצוגה. לדוגמה, כדי לקבל מטא-נתונים של טבלאות במערך נתונים, מציינים myDataset.INFORMATION_SCHEMA.TABLES.

בטבלה הבאה מפורטות התצוגות הזמינות:

סוג המשאב	תצוגת INFORMATION_SCHEMA
בקרת גישה	OBJECT_PRIVILEGES
BI Engine	BI_CAPACITIES BI_CAPACITY_CHANGES
הגדרות אישיות	EFFECTIVE_PROJECT_OPTIONS ORGANIZATION_OPTIONS ORGANIZATION_OPTIONS_CHANGES PROJECT_OPTIONS PROJECT_OPTIONS_CHANGES
מערכי נתונים	SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICAS SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION
גרפים	PROPERTY_GRAPHS
תעסוקה	JOBS_BY_PROJECT^† JOBS_BY_USER JOBS_BY_FOLDER JOBS_BY_ORGANIZATION
משרות לפי חלון זמן	JOBS_TIMELINE_BY_PROJECT^† JOBS_TIMELINE_BY_USER JOBS_TIMELINE_BY_FOLDER JOBS_TIMELINE_BY_ORGANIZATION
המלצות ותובנות	INSIGHTS RECOMMENDATIONS RECOMMENDATIONS_BY_ORGANIZATION
הזמנות	ASSIGNMENTS_BY_PROJECT^† ASSIGNMENT_CHANGES_BY_PROJECT^† CAPACITY_COMMITMENTS_BY_PROJECT^† CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^† RESERVATIONS_BY_PROJECT^† RESERVATION_CHANGES_BY_PROJECT^† RESERVATIONS_TIMELINE_BY_PROJECT^†
תרחישים	PARAMETERS ROUTINES ROUTINE_OPTIONS
אינדקסים של חיפושים	SEARCH_INDEXES SEARCH_INDEX_COLUMNS SEARCH_INDEX_COLUMN_OPTIONS SEARCH_INDEX_OPTIONS SEARCH_INDEXES_BY_ORGANIZATION
סשנים	SESSIONS_BY_PROJECT^† SESSIONS_BY_USER
סטרימינג	STREAMING_TIMELINE_BY_PROJECT^† STREAMING_TIMELINE_BY_FOLDER STREAMING_TIMELINE_BY_ORGANIZATION
Tables	COLUMNS COLUMN_FIELD_PATHS CONSTRAINT_COLUMN_USAGE KEY_COLUMN_USAGE PARTITIONS TABLES TABLE_OPTIONS TABLE_CONSTRAINTS TABLE_SNAPSHOTS TABLE_STORAGE_BY_PROJECT^† TABLE_STORAGE_BY_FOLDER TABLE_STORAGE_BY_ORGANIZATION TABLE_STORAGE_USAGE_TIMELINE TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
אינדקסים של וקטורים	VECTOR_INDEXES VECTOR_INDEX_COLUMNS VECTOR_INDEX_OPTIONS
תצוגות	VIEWS MATERIALIZED_VIEWS
Write API	WRITE_API_TIMELINE_BY_PROJECT^† WRITE_API_TIMELINE_BY_FOLDER WRITE_API_TIMELINE_BY_ORGANIZATION

‫^† בתצוגות *BY_PROJECT, הסיומת BY_PROJECT היא אופציונלית. לדוגמה, שאילתות לגבי INFORMATION_SCHEMA.JOBS_BY_PROJECT ו-INFORMATION_SCHEMA.JOBS מחזירות את אותן תוצאות.

הערה: לא כל התצוגות המפורטות של INFORMATION_SCHEMA נתמכות בטבלאות המערכת של BigQuery Omni. אפשר להציג את המטא-נתונים של המשאבים באמצעות INFORMATION_SCHEMA עבור Amazon S3 ו-Azure Storage.

תמחור

בפרויקטים שבהם משתמשים בתמחור על פי דרישה, שאילתות שמופעלות על תצוגות INFORMATION_SCHEMA מחויבות במינימום של 10 MB של עיבוד נתונים, גם אם מספר הבייטים שעובדו על ידי השאילתה קטן מ-10 MB. סכום החיוב המינימלי עבור שאילתות על פי דרישה הוא 10 MB. מידע נוסף זמין במאמר בנושא תמחור על פי דרישה.

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

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

לא נחייב אתכם על אחסון של INFORMATION_SCHEMA צפיות.

תחביר

צריך לציין מערך נתונים או אזור כדי להגדיר תצוגה מסוג INFORMATION_SCHEMA.

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

Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

מחרוזת להגדרת מערך נתונים

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

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

התצוגות הבאות של INFORMATION_SCHEMA תומכות במאפייני מערך נתונים:

• COLUMNS
• COLUMN_FIELD_PATHS
• MATERIALIZED_VIEWS
• PARAMETERS
• PARTITIONS
• ROUTINES
• ROUTINE_OPTIONS
• TABLES
• TABLE_OPTIONS
• VIEWS

מגדיר אזור

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

• region-us
• region-asia-east2
• region-europe-north1

אם יש מסנן אזור, התוצאות מוגבלות למיקום שצוין. המסווגים של האזורים לא היררכיים, כלומר האזור הגיאוגרפי הנרחב שכולל מספר אזורים באיחוד האירופי לא כולל את האזורים europe-*, והאזור הגיאוגרפי הנרחב שכולל מספר אזורים בארה"ב לא כולל את האזורים us-*. לדוגמה, השאילתה הבאה מחזירה מטא-נתונים של כל מערכי הנתונים באזור US מרובה האזורים של הפרויקט שבו השאילתה מופעלת, אבל היא לא כוללת מערכי נתונים באזור us-west1:

-- Returns metadata for all datasets in the US multi-region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

התצוגות הבאות של INFORMATION_SCHEMA לא תומכות במאפייני אזור:

• INFORMATION_SCHEMA.PARTITIONS
• INFORMATION_SCHEMA.SEARCH_INDEXES
• INFORMATION_SCHEMA.SEARCH_INDEX_COLUMNS
• INFORMATION_SCHEMA.SEARCH_INDEX_OPTIONS

אם לא מציינים מסנן אזור או מסנן מערך נתונים, תוצג שגיאה.

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

מאפיין הפרויקט

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

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

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

ציון מסנן פרויקט לתצוגות ברמת הארגון (לדוגמה, STREAMING_TIMELINE_BY_ORGANIZATION) לא משפיע על התוצאות.

מגבלות

• שאילתות BigQuery INFORMATION_SCHEMA צריכות להיות בתחביר של GoogleSQL. ‫INFORMATION_SCHEMA לא תומך ב-SQL מדור קודם.
• INFORMATION_SCHEMA תוצאות השאילתה לא נשמרות במטמון.
• אי אפשר להשתמש בתצוגות INFORMATION_SCHEMA בהצהרות DDL.
• תצוגות INFORMATION_SCHEMA לא מכילות מידע על מערכי נתונים מוסתרים.
• INFORMATION_SCHEMA שאילתות עם מסנני אזורים עשויות לכלול מטא-נתונים ממקורות באותו אזור ממערכי נתונים שנמחקו ונמצאים בחלון הזמן שלכם.
• כשמציגים רשימה של משאבים מתצוגה מסוג INFORMATION_SCHEMA, ההרשאות נבדקות רק ברמת ההורה ולא ברמה של שורה בודדת. לכן, המערכת מתעלמת מכל מדיניות דחייה (בתצוגה מקדימה) שמטרגטת שורה ספציפית באמצעות תגים באופן מותנה.

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

• קבלת מידע על טבלה
• הצגת מטא-נתונים של טבלאות שמנוהלות על ידי Iceberg
• הצגת סכימות של גרפים
• מעקב אחרי משימות.
• פתרון בעיות באמצעות סכימת מידע