‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

מבוא ל-INFORMATION_SCHEMA

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

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

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

סוג המשאב	תצוגת INFORMATION_SCHEMA
בקרת גישה	`OBJECT_PRIVILEGESscience`
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`
המלצות ותובנות	`INSIGHTSscience` `RECOMMENDATIONSscience` `RECOMMENDATIONS_BY_ORGANIZATIONscience`
הזמנות	`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_OPTIONSscience` `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` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_FOLDER` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDERscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
אינדקסים של וקטורים	`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 מחויבות במינימום של 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 שמוגדר לה אזור גיאוגרפי, מופעלות באזור שאתם מציינים. כלומר, אי אפשר לכתוב שאילתה אחת שתצטרף לנתונים מתצוגות מפורטות באזורים שונים. כדי לשלב 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, ההרשאות נבדקות רק ברמת ההורה ולא ברמה של שורה בודדת. לכן, המערכת מתעלמת מכל מדיניות דחייה (בתצוגה מקדימה) שמטרגטת שורה ספציפית באמצעות תגים באופן מותנה.