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

‫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/.../'. כדי שהרענון הסלקטיבי יפעל בצורה תקינה, פרמטרים של הנתיב ב-Cloud Storage צריכים לכלול נתיב ספציפי או תבנית wildcard. מידע נוסף זמין במאמר תמיכה בתווים כלליים בכתובות URI של Cloud Storage. כך תוכלו לרענן רק את המטא-נתונים של הטבלה מתיקיות המשנה האלה, וכך להימנע מעיבוד מיותר של מטא-נתונים.

דוגמאות

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

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'. אם מריצים את הפרוצדורה הזו של המערכת מפרויקט אחר מזה של התצוגה החומרית, צריך לכלול את מזהה הפרויקט.

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

BQ.SHOW_GRAPH_EXPAND_SCHEMA

תחביר

CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA(graph_name, output_schema);

תיאור

מאכלס את המשתנה output_schema שצוין בסכימה של הטבלה שמוחזרת על ידי קריאה ל-TVF‏ GRAPH_EXPAND ב-graph_name.

מציינים את שם הגרף כמחרוזת בפורמט '[project_id.]dataset.graph'. כל עמודה שמוחזרת על ידי פונקציית GRAPH_EXPAND TVF מייצגת מאפיין בתרשים. הפלט כולל את השם, הסוג והמצב של כל עמודה. אם יש מאפיין עם תיאור או מילים נרדפות, הם יופיעו בdescriptionשדה של העמודה. אם המאפיין מגדיר מדד, הפלט כולל את "is_measure":true בשדה הזה.

דוגמאות

DECLARE schema STRING;
CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA('my_project.my_dataset.my_graph', schema);
SELECT schema;

הפלט אמור להיראות כך:

{
  "fields":[
    {
      "name":"Department_dept_name",
      "type":"STRING",
      "mode":"NULLABLE",
      "description":
        "{\"description\":\"The name of the academic department\",
          \"synonyms\":[\"division\"]}"
    },
    {
      "name":"Department_budget",
      "type":"FLOAT",
      "mode":"NULLABLE"
    },
    {
      "name":"Department_total_budget",
      "type":"FLOAT",
      "mode":"NULLABLE",
      "is_measure":true
    }
  ]
}