הפניה להליכים במערכת

‫BigQuery תומך בהליכים הבאים של המערכת, שאפשר להשתמש בהם באופן דומה לתהליכים מאוחסנים שנוצרו על ידי משתמשים.

BQ.ABORT_SESSION

תחביר

CALL BQ.ABORT_SESSION([session_id]);

תיאור

סיום הסשן הנוכחי.

אפשר לציין את מזהה הסשן, כדי לסיים סשן אם לא קוראים לפרוצדורה של המערכת מהסשן הזה.

מידע נוסף זמין במאמר סיום סשנים.

BQ.JOBS.CANCEL

תחביר

CALL BQ.JOBS.CANCEL(job);

תיאור

ביטול של משימה שפועלת.

מציינים את ההזמנה כמחרוזת בפורמט '[project_id.]job_id'. אם מריצים את הפרוצדורה הזו ממערכת פרויקט שונה מהפרויקט של העבודה, צריך לכלול את מזהה הפרויקט. צריך להריץ את התהליך באותו מיקום שבו נמצאת המשימה.

מידע נוסף מופיע במאמר ביטול עבודה.

BQ.CANCEL_INDEX_ALTERATION

תחביר

CALL BQ.CANCEL_INDEX_ALTERATION(table_name, index_name);

תיאור

ביטול של בנייה מחדש של אינדקס וקטורי שהופעלה על ידי משתמש.

מציינים את שם הטבלה כמחרוזת בפורמט '[project_id.]dataset.table' ואת שם האינדקס כמחרוזת. אם מריצים את ההליך הזה של המערכת מפרויקט אחר שבו נמצאת הטבלה, צריך לכלול את מזהה הפרויקט.

צריך להריץ את התהליך הזה באותו מיקום שבו נמצאת הטבלה עם האינדקס. במאמר ציון מיקומים מוסבר איך מגדירים את המיקום של השאילתה.

דוגמה

CALL BQ.CANCEL_INDEX_ALTERATION('my_project.my_dataset.indexed_table', 'my_index');

BQ.REFRESH_EXTERNAL_METADATA_CACHE

תחביר

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE(table_name [, [subdirectory_uri, …]]);

תיאור

מרענן את מטמון המטא-נתונים של טבלת BigLake או של טבלת אובייקטים. הפעולה הזו תיכשל אם תפעילו אותה על טבלה שהגדרת מצב מטמון המטא-נתונים שלה היא AUTOMATIC.

כדי להריץ את הפרוצדורה הזו של המערכת, צריך את ההרשאות bigquery.tables.update ו-bigquery.tables.updateData.

מציינים את שם הטבלה כמחרוזת בפורמט '[project_id.]dataset.table'. אם מריצים את ההליך הזה של המערכת מפרויקט אחר שבו נמצאת הטבלה, צריך לכלול את מזהה הפרויקט.

בטבלאות BigLake, אפשר לציין באופן אופציונלי ספריית משנה אחת או יותר של ספריית נתוני הטבלה ב-Cloud Storage בפורמט 'gs://table_data_directory/subdirectory/.../'. כך תוכלו לרענן רק את המטא-נתונים של הטבלה מתיקיות המשנה האלה, וכך להימנע מעיבוד מיותר של מטא-נתונים.

דוגמאות

כדי לרענן את כל המטא-נתונים של טבלה:

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table')

כדי לרענן באופן סלקטיבי את המטא-נתונים של טבלת BigLake:

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table', ['gs://source/uri/sub/path/d1/*', 'gs://source/uri/sub/path/d2/*'])

מגבלה

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

BQ.REFRESH_MATERIALIZED_VIEW

תחביר

CALL BQ.REFRESH_MATERIALIZED_VIEW(view_name);

תיאור

רענון של תצוגה מהותית.

מציינים את השם של התצוגה החומרית כמחרוזת בפורמט '[project_id.]dataset.table'. אם מריצים את הפרוצדורה הזו של המערכת מפרויקט אחר ולא מהתצוגה החומרית, צריך לכלול את מזהה הפרויקט.

מידע נוסף זמין במאמר בנושא רענון ידני.