תצוגת ROUTINE_OPTIONS

התצוגה INFORMATION_SCHEMA.ROUTINE_OPTIONS מכילה שורה אחת לכל אפשרות של כל שגרה בקבוצת נתונים.

ההרשאות הנדרשות

כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.ROUTINE_OPTIONS, צריך את ההרשאות הבאות בממשק לניהול זהויות והרשאות גישה (IAM):

• bigquery.routines.get
• bigquery.routines.list

כל אחד מתפקידי ה-IAM המוגדרים מראש הבאים כולל את ההרשאות שדרושות לכם כדי לקבל מטא-נתונים שגרתיים:

• roles/bigquery.admin
• roles/bigquery.metadataViewer
• roles/bigquery.dataViewer

מידע נוסף על הרשאות ב-BigQuery זמין במאמר בקרת גישה באמצעות IAM.

סכימה

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

לתצוגה INFORMATION_SCHEMA.ROUTINE_OPTIONS יש את הסכימה הבאה:

שם העמודה	סוג נתונים	ערך
specific_catalog	STRING	שם הפרויקט שמכיל את השגרה שבה מוגדרת האפשרות
specific_schema	STRING	השם של קבוצת הנתונים שמכילה את השגרה שבה האפשרות מוגדרת
specific_name	STRING	שם התרחיש
option_name	STRING	אחד מערכי השם בטבלת האפשרויות
option_type	STRING	אחד מערכי סוג הנתונים בטבלת האפשרויות
option_value	STRING	אחת מאפשרויות הערכים בטבלת האפשרויות

טבלת אפשרויות

OPTION_NAME	OPTION_TYPE	OPTION_VALUE
description	STRING	התיאור של הפעולה, אם הוגדר
library	ARRAY	שמות הספריות שהשגרה מפנה אליהן. רלוונטי רק לפונקציות מוגדרות על ידי המשתמש (UDF) ב-JavaScript
data_governance_type	DataGovernanceType	השם של סוג נתמך של משילות מידע (data governance). לדוגמה, DATA_MASKING.

כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כל כללי (SELECT *). ציון מפורש של העמודות מונע את השבירה של השאילתות אם הסכימה הבסיסית משתנה.

היקף ותחביר

שאילתות שמופעלות על התצוגה הזו חייבות לכלול מערך נתונים או מסווג אזור. מידע נוסף מופיע במאמר בנושא תחביר. בטבלה הבאה מוסברות רמות הפירוט של האזור והמשאבים בתצוגה הזו:

שם התצוגה	היקף המשאבים	היקף האזור
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS	ברמת הפרויקט	REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS	רמת מערך הנתונים	מיקום מערך הנתונים

מחליפים את מה שכתוב בשדות הבאים:

• אופציונלי: PROJECT_ID: מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
• ‫REGION: כל שם של אזור במערך נתונים. לדוגמה, `region-us`.
• ‫DATASET_ID: המזהה של מערך הנתונים. מידע נוסף מופיע במאמר בנושא מאפיין מסנן של מערך נתונים.
  הערה: כדי לשלוח שאילתה לגבי נתוני הצפיות ב-INFORMATION_SCHEMA, צריך להשתמש במסנן אזור. המיקום של הרצת השאילתה צריך להיות זהה לאזור של התצוגה INFORMATION_SCHEMA.

דוגמה

-- Returns metadata for routines in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

-- Returns metadata for routines in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

דוגמה

דוגמה 1:

בדוגמה הבאה מאחזרים את האפשרויות של השגרה לכל השגרות ב-mydataset בפרויקט שמוגדר כברירת מחדל (myproject) על ידי שליחת שאילתה לתצוגה INFORMATION_SCHEMA.ROUTINE_OPTIONS:

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

הערה: שמות התצוגות המפורטות הם תלויי אותיות רישיות.

INFORMATION_SCHEMA

התוצאה אמורה להיראות כך:

+-------------------+------------------+---------------+----------------------+---------------+------------------+
| specific_catalog  | specific_schema  | specific_name |     option_name      | option_type   | option_value     |
+-------------------+------------------+---------------+----------------------+---------------+------------------+
| myproject         | mydataset        | myroutine1    | description          | STRING        | "a description"  |
| myproject         | mydataset        | myroutine2    | library              | ARRAY<STRING> | ["a.js", "b.js"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+