סכימת מידע למסדי נתונים בניב PostgreSQL

סכימת המידע היא סכימה מובנית שמשותפת לכל מסד נתונים של PostgreSQL. אתם יכולים להריץ שאילתות SQL על טבלאות ב-information_schema כדי לאחזר מטא-נתונים של סכימה למסד נתונים.

לדוגמה, השאילתה הבאה מאחזרת את השמות של כל הטבלאות שהוגדרו על ידי המשתמש במסד נתונים:

  SELECT
    table_schema,
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema NOT IN ('pg_catalog', 'information_schema', 'SPANNER_SYS')
    AND table_type = 'BASE TABLE'

Usage

  • טבלאות information_schema זמינות רק דרך ממשקי SQL, לדוגמה:

    • ‫API של executeQuery
    • הפקודה gcloud spanner databases execute-sql
    • הדף Query של מסד נתונים במסוף Google Cloud .

    שיטות קריאה בודדות אחרות לא תומכות ב-information_schema.

ההבדלים בין information_schema ל-PostgreSQL

הטבלאות במסדי הנתונים של information_schema לניב של PostgreSQL כוללות עמודות מהטבלאות של information_schema ל-PostgreSQL בקוד פתוח, ובמקרים מסוימים גם עמודות מ-Spanner. בטבלאות האלה, העמודות של PostgreSQL בקוד פתוח מופיעות קודם ובאותו סדר כמו במסד נתונים של PostgreSQL בקוד פתוח, וכל העמודות הייחודיות של Spanner מתווספות לאחר מכן. שאילתות שנכתבו לגרסת הקוד הפתוח של PostgreSQL ב-information_schema אמורות לפעול בלי שינוי כשמשתמשים במסדי נתונים של ניב PostgreSQL ב-Google Cloud CLI.

הבדלים בולטים אחרים במסדי נתונים של information_schema לניב PostgreSQL:

  • חלק מהעמודות בטבלה של PostgreSQL בקוד פתוח זמינות, אבל לא מאוכלסות במסדי נתונים בניב של PostgreSQL.
  • במסדי נתונים עם ניב PostgreSQL, שם הסכימה שמוגדר כברירת מחדל הוא public.
  • שמות של אילוצים שנוצרים באופן אוטומטי משתמשים בפורמט שונה מזה של מסדי נתונים של PostgreSQL בקוד פתוח.
  • טבלאות שקשורות לתכונות של PostgreSQL בקוד פתוח שלא נתמכות במסדי נתונים עם ניב PostgreSQL לא זמינות.
  • חלק מהטבלאות שזמינות ב-Spanner אבל לא ב-PostgreSQL בקוד פתוח, כמו database_options,‏ index_columns,‏ indexes ו-spanner_statistics, זמינות.

סינון שורות בטבלאות ובתצוגות ב-information_schema

חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader (או לחברים בתפקיד הזה) יכולים לראות את כל השורות בכל הטבלאות והתצוגות של information_schema. בחשבונות משתמשים אחרים, Spanner מסנן שורות על סמך התפקיד הנוכחי במסד הנתונים. בתיאורים של הטבלאות והתצוגות בקטעים הבאים מוסבר איך Spanner מסנן שורות בכל טבלה ותצוגה.

טבלאות בפרויקט information_schema למסדי נתונים בניב PostgreSQL

הטבלאות והתצוגות ב-information_schema תואמות לטבלאות ולתצוגות ב-information_schema של PostgreSQL בקוד פתוח.

בקטעים הבאים מתוארות הטבלאות והתצוגות ב-information_schema למסדי נתונים בניב PostgreSQL.

applicable_roles

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

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

שם העמודה סוג תיאור
grantee character varying שם התפקיד במסד הנתונים שמוענקת לו חברות.
role_name character varying שם התפקיד הראשי במסד הנתונים שבו ניתנה החברות הזו.
is_grantable character varying לא בשימוש. תמיד NO.

change_stream_columns

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

חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל שאר החשבונות הראשיים יכולים לראות רק שורות של סנכרון שינויים בזרמי נתונים שבהן ההרשאה SELECT ניתנה לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים חבר בהם או ל-public.

שם העמודה סוג תיאור
change_stream_catalog character varying השם של מסד הנתונים.
change_stream_schema character varying השם של הסכימה של סנכרון השינויים בזרמי הנתונים. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
change_stream_name character varying השם של סנכרון השינויים בזרמי הנתונים.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה של הטבלה. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
table_name character varying שם הטבלה שהשורה הזו מתייחסת אליה.
column_name character varying שם העמודה שהשורה הזו מתייחסת אליה.

change_stream_options

התצוגה המסוננת לפי שורות מכילה את אפשרויות ההגדרה של סנכרון שינויים בזרמי נתונים. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל שאר הישויות המורשות יכולות לראות רק אפשרויות לסנכרון שינויים בזרמי נתונים שבהם ההרשאה SELECT ניתנת לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא גורם בהם, או ל-public.

שם העמודה סוג תיאור
change_stream_catalog character varying השם של מסד הנתונים.
change_stream_schema character varying השם של הסכימה של סנכרון השינויים בזרמי הנתונים. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
change_stream_name character varying השם של סנכרון השינויים בזרמי הנתונים.
option_name character varying השם של האפשרות "סנכרון שינויים בזרמי נתונים".
option_type character varying סוג הנתונים של האפשרות לשינוי זרמי נתונים.
option_value character varying הערך של האפשרות "סנכרון שינויים בזרמי נתונים".

change_stream_privileges

התצוגה המסוננת לפי שורות מפרטת את כל הרשאות בקרת הגישה המפורטת (FGAC) שניתנו לכל תפקיד במסד הנתונים, כולל public, בכל סנכרון שינויים בזרמי נתונים. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים, וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה, יכולים לראות את כל השורות בתצוגה הזו. כל שאר חשבונות המשתמשים יכולים לראות רק את ההרשאות שניתנו בסנכרון שינויים בזרמי נתונים לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-public.

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד במסד הנתונים שההרשאה הזו ניתנת לו.
change_stream_catalog character varying השם של מסד הנתונים.
change_stream_schema character varying שם הסכימה שמכילה את סנכרון השינויים בזרמי הנתונים. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
change_stream_name character varying השם של סנכרון השינויים בזרמי הנתונים.
privilege_type character varying סוג ההרשאה (SELECT בלבד).
is_grantable character varying לא בשימוש. תמיד NO.

change_stream_tables

התצוגה המסוננת לפי שורות מכילה מידע על הטבלאות ועל סנכרון השינויים בזרמי הנתונים שצופים בהן. כל שורה מתארת טבלה אחת וסנכרון שינויים אחד בזרמי נתונים. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים, וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה, יכולים לראות את כל השורות בתצוגה הזו. כל שאר חשבונות המשתמשים יכולים לראות רק שורות של סנכרון שינויים בזרמי נתונים שבהם ההרשאה SELECT ניתנה לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-public.

הנתונים ב-change_stream_tables לא כוללים את הקשרים המשתמעים בין טבלאות לבין סנכרון שינויים בזרמי נתונים שעוקבים אחרי מסד הנתונים כולו.

שם העמודה סוג תיאור
change_stream_catalog character varying השם של מסד הנתונים.
change_stream_schema character varying השם של הסכימה של סנכרון השינויים בזרמי הנתונים. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
change_stream_name character varying השם של סנכרון השינויים בזרמי הנתונים שאליו מתייחסת השורה הזו.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה של הטבלה. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
table_name character varying שם הטבלה שהשורה הזו מתייחסת אליה.
all_columns character varying ‫YES אם סנכרון השינויים בזרמי הנתונים של השורה הזו עוקב אחרי כל הטבלה שהשורה הזו מתייחסת אליה. אחרת, NO. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.

change_streams

בתצוגה המסוננת לפי שורות מפורטים כל סנכרוני השינויים בזרמי הנתונים של מסד הנתונים, ומצוין אילו מהם עוקבים אחרי מסד הנתונים כולו ואילו עוקבים אחרי טבלאות או עמודות ספציפיות. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים, וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה, יכולים לראות את כל השורות בתצוגה הזו. כל שאר הישויות המורשות יכולות לראות רק את סנכרון שינויים בזרמי נתונים שבהם הרשאת בקרת גישה מפורטת (FGAC) SELECT ניתנה לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא גורם בהם או ל-public.

שם העמודה סוג תיאור
change_stream_catalog character varying השם של מסד הנתונים.
change_stream_schema character varying השם של הסכימה של סנכרון השינויים בזרמי הנתונים. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
change_stream_name character varying השם של סנכרון השינויים בזרמי הנתונים.
all character varying ‫YES אם סנכרון השינויים בזרמי הנתונים עוקב אחרי מסד הנתונים כולו. ‫NO אם סנכרון השינויים בזרמי הנתונים עוקב אחרי טבלאות או עמודות ספציפיות. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.

check_constraints

התצוגה check_constraints מכילה שורה אחת לכל אילוץ בדיקה שמוגדר על ידי מילת המפתח CHECK או NOT NULL.

שם העמודה סוג תיאור
constraint_catalog character varying השם של מסד הנתונים.
constraint_schema character varying שם הסכימה של האילוץ. ברירת המחדל היא public במסדי נתונים עם ניב PostgreSQL.
constraint_name character varying שם האילוץ. אם שם האילוץ לא צוין במפורש בסכימה, המערכת משתמשת בשם שנוצר אוטומטית.
check_clause character varying הביטוי של אילוץ הבדיקה.
spanner_state character varying המצב הנוכחי של אילוץ הבדיקה. אלה המצבים האפשריים:
  • ‫VALIDATING: מסד הנתונים של ניב PostgreSQL מאמת את הנתונים הקיימים לפקודה ALTER CONSTRAINT או ADD CONSTRAINT.
  • ‫COMMITTED: אין שינוי סכימה פעיל לאילוץ הזה.

column_column_usage

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

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה. השם הוא public לסכימת ברירת המחדל, והוא לא ריק לסכימות אחרות (לדוגמה, information_schema עצמה). העמודה הזו אף פעם לא ריקה.
table_name character varying שם הטבלה שמכילה את העמודות שנוצרו.
column_name character varying שם עמודת הבסיס שעליה מסתמכת העמודה שנוצרה.
dependent_column character varying השם של העמודה שנוצרה.

column_options

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

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה החיצונית. השם הוא public לסכימת ברירת המחדל, ולא ריק לסכימות אחרות (לדוגמה, information_schema עצמו). העמודה הזו אף פעם לא ריקה.
table_name character varying שם הטבלה החיצונית.
column_name character varying שם העמודה.
option_name character varying מזהה SQL שמזהה באופן ייחודי את האפשרות. המזהה הזה הוא המפתח של הסעיף OPTIONS ב-DDL.
option_value character varying ליטרל SQL שמתאר את הערך של האפשרות הזו. אפשר לנתח את הערך של העמודה הזו כחלק משאילתה.
option_type character varying שם של סוג נתונים שהוא הסוג של ערך האפשרות הזו.

column_privileges

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

התצוגה כוללת את ההרשאות SELECT, INSERT ו-UPDATE שהעמודה יורשת מהטבלה או מהתצוגה שמכילה את העמודה.

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד במסד הנתונים שההרשאה הזו ניתנת לו.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה או התצוגה. ערך ברירת המחדל הוא public למסדי נתונים בניב PostgreSQL.
table_name character varying שם הטבלה או התצוגה שמכילה את העמודה.
column_name character varying שם העמודה.
privilege_type character varying סוג ההרשאה (SELECT,‏ INSERT או UPDATE).
is_grantable character varying לא בשימוש. תמיד NO.

columns

התצוגה הזו, שמסוננת לפי שורות, מספקת מידע על כל העמודות בטבלה ועל עמודות התצוגה במסד הנתונים. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים, וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה, יכולים לראות את כל השורות בתצוגה הזו. כל שאר הישויות המורשות יכולות לראות רק עמודות שניתנו להן הרשאות לבקרת גישה מפורטת (FGAC) (או הרשאות SELECT,‏ INSERT או UPDATE שניתנו לטבלאות שמכילות אותן) לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים חבר בהם או ל-public.

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה. השם הוא public לסכימת ברירת המחדל, ולא ריק לסכימות אחרות (לדוגמה, information_schema עצמו). העמודה הזו אף פעם לא ריקה.
table_name character varying שם הטבלה
column_name character varying שם העמודה
ordinal_position BIGINT המיקום הסידורי של העמודה בטבלה, החל מהערך 1
column_default character varying ייצוג מחרוזת של הביטוי בקוד פתוח של PostgreSQL של ערך ברירת המחדל של העמודה, לדוגמה '9'::bigint.
is_nullable character varying מחרוזת שמציינת אם העמודה יכולה להיות ריקה. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.
data_type character varying סוג הנתונים בעמודה. הערך הוא אחד מהבאים:
  • בסוגים מובְנים, השם של סוג הנתונים.
  • למערכים, הערך ARRAY.
character_maximum_length BIGINT האורך המקסימלי שהוצהר לסוגי נתונים של תווים ומחרוזות ביטים. אם לא צוין אורך מקסימלי, הערך הוא NULL. אם סוג הנתונים של העמודה הוא לא תו או מחרוזת ביטים, הערך הוא NULL.
character_octet_length BIGINT לא בשימוש. הערך הוא תמיד NULL.
numeric_precision BIGINT הדיוק של סוג הנתונים המספריים בעמודה הנוכחית. בשביל double precision, הערך הוא 53. בשביל bigint, הערך הוא 64. לכל שאר סוגי הנתונים, הערך הוא NULL.
numeric_precision_radix BIGINT הבסיס (יחידה) של הדיוק לסוגים מספריים. יש תמיכה רק בשני ערכים:
  • ‫2 ל-double precision float8, וגם bigint
  • ‫10 תמורת numeric
לכל סוגי הנתונים האחרים הערך הוא NULL.
numeric_scale BIGINT מכיל את קנה המידה של סוג העמודה המספרית, שהוא מספר יחידות הבסיס של הדיוק אחרי הנקודה העשרונית. בשביל bigint, הערך הוא 0. לכל שאר סוגי הנתונים, הערך הוא NULL.
datetime_precision BIGINT לא בשימוש. הערך הוא תמיד NULL.
interval_type character varying לא בשימוש. הערך הוא תמיד NULL.
interval_precision BIGINT לא בשימוש. הערך הוא תמיד NULL.
character_set_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
character_set_schema character varying לא בשימוש. הערך הוא תמיד NULL.
character_set_name character varying לא בשימוש. הערך הוא תמיד NULL.
collation_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
collation_schema character varying לא בשימוש. הערך הוא תמיד NULL.
collation_name character varying לא בשימוש. הערך הוא תמיד NULL.
domain_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
domain_schema character varying לא בשימוש. הערך הוא תמיד NULL.
domain_name character varying לא בשימוש. הערך הוא תמיד NULL.
udt_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
udt_schema character varying לא בשימוש. הערך הוא תמיד NULL.
udt_name character varying לא בשימוש. הערך הוא תמיד NULL.
scope_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
scope_schema character varying לא בשימוש. הערך הוא תמיד NULL.
scope_name character varying לא בשימוש. הערך הוא תמיד NULL.
maximum_cardinality BIGINT לא בשימוש. הערך הוא תמיד NULL.
dtd_identifier character varying לא בשימוש. הערך הוא תמיד NULL.
is_self_referencing character varying לא בשימוש. הערך הוא תמיד NULL.
is_identity character varying לא בשימוש. הערך הוא תמיד NULL.
identity_generation character varying לא בשימוש. הערך הוא תמיד NULL.
identity_start character varying לא בשימוש. הערך הוא תמיד NULL.
identity_increment character varying לא בשימוש. הערך הוא תמיד NULL.
identity_maximum character varying לא בשימוש. הערך הוא תמיד NULL.
identity_minimum character varying לא בשימוש. הערך הוא תמיד NULL.
identity_cycle character varying לא בשימוש. הערך הוא תמיד NULL.
is_generated character varying מחרוזת שמציינת אם העמודה נוצרה. המחרוזת היא ALWAYS לעמודה שנוצרה או NEVER לעמודה שלא נוצרה.
generation_expression character varying מחרוזת שמייצגת את ביטוי ה-SQL של עמודה שנוצרה, או NULL אם העמודה היא לא עמודה שנוצרה.
is_updatable character varying לא בשימוש. הערך הוא תמיד NULL.
spanner_type character varying מחרוזת שמכילה את סוג העמודה שתואם ל-DDL.
is_stored character varying מחרוזת שמציינת אם העמודה שנוצרה מאוחסנת. המחרוזת היא תמיד YES או NO בעמודות שנוצרו, ו-NULL בעמודות שלא נוצרו.
spanner_state character varying המצב הנוכחי של העמודה. עמודה חדשה שנוצרת ומאוחסנת בטבלה קיימת עשויה לעבור כמה מצבים שגלויים למשתמשים לפני שאפשר להשתמש בה באופן מלא. הערכים האפשריים הם:
  • ‫NO_WRITE: אי אפשר לקרוא או לכתוב בעמודות. עמודה שנוצרה ונשמרה במצב הזה לא משפיעה על הלקוח.
  • ‫WRITE_ONLY: העמודה מתמלאת. אין הרשאת קריאה.
  • ‫COMMITTED: אפשר להשתמש בעמודה באופן מלא.
  • ‫NULL: משמש לעמודות בסכימות של המערכת.
on_update_expression character varying ייצוג מחרוזת של הביטוי `ON UPDATE` לעמודה. אם לעמודה אין ביטוי `ON UPDATE`, הערך הוא `NULL`.

constraint_column_usage

התצוגה הזו מכילה שורה אחת לכל עמודה שמשמשת לאילוץ.

  • התצוגה מכילה את העמודות של האילוצים PRIMARY KEY ו-CHECK שמוגדרים על ידי מילת המפתח NOT NULL.
  • באילוצים מסוג CHECK שנוצרו באמצעות מילת המפתח CHECK, התצוגה כוללת את העמודות שבהן נעשה שימוש בביטוי של אילוץ הבדיקה.
  • באילוצים של מפתחות זרים, התצוגה מכילה את העמודות של הטבלה שאליה מפנים.
  • במגבלות UNIQUE, התצוגה מכילה את העמודות מ-KEY_COLUMN_USAGE.

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה שמכילה את העמודה שבה משתמש האילוץ.
table_name character varying שם הטבלה שמכילה את העמודה שמשמשת את האילוץ.
column_name character varying שם העמודה שבה משתמש האילוץ.
constraint_catalog character varying השם של מסד הנתונים.
constraint_schema character varying שם הסכימה של האילוץ.
constraint_name character varying שם האילוץ.

constraint_table_usage

התצוגה הזו מכילה שורה אחת לכל טבלה שמשמשת לאילוץ. במגבלות FOREIGN KEY, המידע בטבלה מיועד לטבלאות בסעיף REFERENCES. לאילוץ של מפתח ייחודי או ראשי, התצוגה הזו מזהה את הטבלה שאליה שייך האילוץ. התצוגה הזו לא כוללת אילוצי בדיקה ואילוצים שאינם null.

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה של הטבלה המוגבלת.
table_name character varying שם הטבלה שבה משתמשים באילוץ מסוים.
constraint_catalog character varying השם של מסד הנתונים.
constraint_schema character varying שם הסכימה שמכילה את האילוץ.
constraint_name character varying שם האילוץ.

database_options

בטבלה הזו מפורטות האפשרויות שמוגדרות במסד הנתונים.

שם העמודה סוג תיאור
catalog_name character varying השם של מסד הנתונים.
schema_name character varying שם הסכימה. ערך ברירת המחדל הוא public למסדי נתונים עם ניב PostgreSQL.
option_name character varying השם של אפשרות מסד הנתונים. זה הערך של key בסעיף OPTIONS ב-DDL.
option_type character varying סוג הנתונים של האפשרות במסד הנתונים.
option_value character varying הערך של האפשרות במסד הנתונים.

enabled_roles

בתצוגה הזו, שמסוננת לפי שורות, מפורטים התפקידים שהוגדרו במסד הנתונים. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים, וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה, יכולים לראות את כל התפקידים במסד הנתונים. כל שאר החשבונות הראשיים יכולים לראות רק את התפקידים במסד הנתונים שקיבלו אליהם גישה, באופן ישיר או באמצעות ירושה. כל תפקידי המערכת, חוץ מ-public, מופיעים גם בתצוגה הזו.

שם העמודה סוג תיאור
role_name character varying שם התפקיד.
spanner_is_system character varying ‫YES אם התפקיד הוא תפקיד מערכת. אחרת, NO.

index_columns

בתצוגה הזו מפורטות העמודות באינדקס.

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את האינדקס. ערך ברירת המחדל הוא public.
table_name character varying שם הטבלה שמשויכת לאינדקס.
index_name character varying שם האינדקס. לטבלאות עם מפרט PRIMARY KEY יש רשומת אינדקס מדומה שנוצרה עם השם PRIMARY_KEY.
index_type character varying סוג האינדקס. הערכים האפשריים הם PRIMARY_KEY,‏ LOCAL או GLOBAL.
column_name character varying שם העמודה.
ordinal_position BIGINT המיקום הסידורי של העמודה באינדקס (או במפתח הראשי), החל מהערך 1. הערך הזה הוא NULL לעמודות שהן לא מפתחות (לדוגמה, עמודות שצוינו במשפט INCLUDE של אינדקס).
column_ordering character varying סדר המיון של העמודה. הערך הוא ASC או DESC לעמודות מפתח, ו-NULL לעמודות שהן לא מפתח (לדוגמה, עמודות שצוינו בסעיף STORING של אינדקס).
is_nullable character varying מחרוזת שמציינת אם העמודה יכולה להיות ריקה. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.
spanner_type character varying מחרוזת שמכילה את סוג העמודה שתואם ל-DDL.

indexes

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

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה. ערך ברירת המחדל הוא public.
table_name character varying שם הטבלה.
index_name character varying שם האינדקס. לטבלאות שנוצרו עם משפט PRIMARY KEY יש רשומת אינדקס מדומה שנוצרה עם השם PRIMARY_KEY, שמאפשרת לזהות את השדות של המפתח הראשי.
index_type character varying סוג האינדקס. הערכים כוללים את PRIMARY_KEY, LOCAL או GLOBAL.
parent_table_name character varying אפשר להוסיף אינדקסים משניים לטבלת הורה, כמו שמוסבר במאמר יצירת אינדקס משני. בעמודה הזו מופיע השם של טבלת ההורה, או מחרוזת ריקה אם האינדקס לא משולב.
is_unique character varying אם מפתחות האינדקס חייבים להיות ייחודיים. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.
is_null_filtered character varying אם האינדקס כולל רשומות עם ערכי NULL. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.
index_state character varying המצב הנוכחי של האינדקס. הערכים האפשריים והמצבים שהם מייצגים:
  • ‫NULL: סוג האינדקס הוא PRIMARY_KEY
  • ‫PREPARE: יצירת טבלאות ריקות לאינדקס חדש
  • ‫WRITE_ONLY: מילוי חוסרים בנתונים לאינדקס חדש
  • ‫WRITE_ONLY_CLEANUP: ניקוי אינדקס חדש
  • ‫WRITE_ONLY_VALIDATE_UNIQUE: בדיקת הייחודיות של הנתונים באינדקס חדש
  • ‫READ_WRITE: פעולת אינדקס רגילה
spanner_is_managed character varying אם האינדקס מנוהל על ידי Spanner. לדוגמה, Spanner מנהל אינדקסים משניים לגיבוי של מפתחות זרים. המחרוזת היא YES או NO, ולא ערך בוליאני, בהתאם לתקן SQL.

information_schema_catalog_name

הטבלה הזו מכילה שורה אחת ועמודה אחת עם שם מסד הנתונים.

שם העמודה סוג תיאור
catalog_name character varying השם של מסד הנתונים.

key_column_usage

בתצוגה הזו מוצגות כל העמודות במסד הנתונים הנוכחי, שיש להן הפניה מאילוץ ייחודי, מאילוץ של מפתח ראשי או מאילוץ של מפתח זר. למידע על עמודות של אילוצים ב-CHECK, אפשר לעיין בתצוגה check_constraints.

שם העמודה סוג תיאור
constraint_catalog character varying השם של מסד הנתונים.
constraint_schema character varying שם הסכימה של האילוץ. ערך ברירת המחדל הוא public.
constraint_name character varying שם האילוץ.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה עם העמודה המוגבלת. ערך ברירת המחדל הוא public.
table_name character varying שם הטבלה שמכילה את העמודה שמוגבלת על ידי האילוץ הזה.
column_name character varying שם העמודה שמוגבלת.
ordinal_position BIGINT המיקום הסידורי של העמודה במפתח של האילוץ, החל מהערך 1.
position_in_unique_constraint BIGINT ב-FOREIGN KEY, המיקום הסידורי של העמודה בתוך האילוץ הייחודי, החל מהערך 1. בעמודה הזו יש ערך NULL לסוגי אילוצים אחרים.

parameters

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

חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל שאר הישויות המורשות יכולות לראות רק פרמטרים של פונקציות קריאה של סנכרון שינויים בזרמי נתונים ופונקציות שמוגדרות על ידי המשתמש, שבהן ניתנה הרשאת EXECUTE בקרת גישה מפורטת (FGAC) לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא גורם בהם או ל-public.

שם העמודה סוג תיאור
specific_catalog character varying השם של מסד הנתונים.
specific_schema character varying שם הסכימה של השגרה. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
specific_name character varying שם התרחיש. מזהה באופן ייחודי את השגרה, גם אם השם שלה עמוס מדי.
ordinal_position bigint המיקום הסידורי של הפרמטר ברשימת הארגומנטים של השגרה, החל מהערך 1.
parameter_mode character varying לא בשימוש. תמיד NULL.
is_result character varying לא בשימוש. תמיד NULL.
as_locator character varying לא בשימוש. תמיד NULL.
parameter_name character varying שם הפרמטר.
data_type character varying סוג הנתונים של הפרמטר. הערך הוא אחד מהבאים:
  • בסוגים מובְנים, השם של סוג הנתונים.
  • במערכים, הערך ARRAY.
character_maximum_length bigint לא בשימוש. תמיד NULL.
character_octet_length bigint לא בשימוש. הערך הוא תמיד NULL.
character_set_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
character_set_schema character varying לא בשימוש. הערך הוא תמיד NULL.
character_set_name character varying לא בשימוש. הערך הוא תמיד NULL.
collation_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
collation_schema character varying לא בשימוש. הערך הוא תמיד NULL.
collation_name character varying לא בשימוש. הערך הוא תמיד NULL.
numeric_precision bigint לא בשימוש. הערך הוא תמיד NULL.
numeric_precision_radix bigint לא בשימוש. הערך הוא תמיד NULL.
numeric_scale bigint לא בשימוש. הערך הוא תמיד NULL.
datetime_precision bigint לא בשימוש. הערך הוא תמיד NULL.
interval_type character varying לא בשימוש. הערך הוא תמיד NULL.
interval_precision bigint לא בשימוש. הערך הוא תמיד NULL.
udt_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
udt_schema character varying לא בשימוש. הערך הוא תמיד NULL.
udt_name character varying לא בשימוש. הערך הוא תמיד NULL.
scope_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
scope_schema character varying לא בשימוש. הערך הוא תמיד NULL.
scope_name character varying לא בשימוש. הערך הוא תמיד NULL.
maximum_cardinality bigint לא בשימוש. הערך הוא תמיד NULL.
dtd_identifier character varying לא בשימוש. הערך הוא תמיד NULL.
parameter_default character varying לא בשימוש. הערך הוא תמיד NULL.
spanner_type character varying סוג ההחזרה המפורט של השגרה. כולל את סוג המשנה אם מוחזר ARRAY.

placements

בטבלה הזו מפורטים מיקומי המודעות במסד הנתונים.

שם העמודה סוג תיאור
placement_name character varying שם המיקום.
is_default character varying מחרוזת שמציינת אם העמודה יכולה להיות ריקה. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.

placement-options

בטבלה הזו מפורטות האפשרויות שמוגדרות לכל מיקום בסעיף OPTIONS של ההצהרה CREATE PLACEMENT.

שם העמודה סוג תיאור
placement_name character varying שם המיקום.
option_name character varying השם של אפשרות המיקום. הערכים התקינים של option_name כוללים:
  • instance_partition
  • default_leader
option_type character varying סוג הנתונים של אפשרות המיקום.
option_value character varying הערך של אפשרות המיקום. ב-instance_partition, זה השם של מחיצת המכונה. ב-default_leader, זה השם של האזור הראשי שמוגדר כברירת מחדל.

locality-group-options

בטבלה הזו מפורטים השם והאפשרויות שמוגדרים לכל קבוצת מיקומים בסעיף OPTIONS של ההצהרה CREATE LOCALITY GROUP.

שם העמודה סוג תיאור
locality_group_name character varying שם קבוצת היישובים.
option_name character varying השם של האפשרות "קבוצת יישובים". האפשרויות התקינות הן:
  • ‫storage: מגדיר את סוג האחסון של קבוצת המיקום.
  • ‫ssd_to_hdd_spill_timespan: מגדיר כמה זמן הנתונים מאוחסנים ב-SSD לפני שהם מועברים לאחסון ב-HDD.
option_value character varying הערך של האפשרות "קבוצת יישובים". ב-storage, הערך הוא ssd או hdd. ב-ssd_to_hdd_spill_timespan, זה משך הזמן שבו הנתונים צריכים להיות מאוחסנים ב-SSD לפני שהם מועברים לאחסון ב-HDD. לדוגמה, 10d הוא 10 ימים. משך הזמן המינימלי שאפשר להגדיר הוא שעה.

referential_constraints

התצוגה הזו מכילה שורה אחת לכל אילוץ של FOREIGN KEY. אתם יכולים לראות רק את האילוצים שיש לכם גישת כתיבה לטבלה שמפנה אליהם. בתצוגה הזו אפשר גם לזהות את האילוצים PRIMARY KEY ו-UNIQUE בטבלאות שאליהן מפנים המפתחות הזרים, שמשמשים לאכיפת האילוצים ולפעולות ההפניה.

שם העמודה סוג תיאור
constraint_catalog character varying השם של מסד הנתונים.
constraint_schema character varying שם הסכימה שמכילה את אילוץ המפתח הזר. ערך ברירת המחדל הוא public.
constraint_name character varying השם של אילוץ המפתח הזר.
unique_constraint_catalog character varying השם של מסד הנתונים.
unique_constraint_schema character varying שם הסכימה שמכילה את אילוץ המפתח הראשי או הייחודי שאליו מתייחס אילוץ המפתח הזר.
unique_constraint_name character varying השם של אילוץ המפתח הראשי או הייחודי שאליו מתייחס אילוץ המפתח הזר.
match_option character varying שיטת ההתאמה שבה משתמש אילוץ המפתח הזר. הערך הוא תמיד NONE.
update_rule character varying כלל העדכון של אילוץ המפתח הזר. הערך הזה הוא תמיד NO ACTION.
delete_rule character varying כלל המחיקה של אילוץ המפתח הזר. הערך הזה הוא CASCADE, SET NULL או NO ACTION.
spanner_state character varying המצב הנוכחי של המפתח הזר. ‫Spanner לא מתחיל לאכוף את האילוץ עד שהאינדקסים לגיבוי של המפתח הזר נוצרים וממולאים. אחרי שהאינדקסים מוכנים, Spanner מתחיל לאכוף את האילוץ על עסקאות חדשות בזמן שהוא מאמת את הנתונים הקיימים. הערכים האפשריים והמצבים שהם מייצגים הם:
  • ‫BACKFILLING_INDEXES: מתבצע מילוי חוסרים באינדקסים.
  • VALIDATING_DATA: הנתונים הקיימים והכתיבות החדשות מאומתים.
  • ‫WAITING_FOR_COMMIT: הפעולות בכמות גדולה של המפתח הזר הושלמו בהצלחה, או שלא היה צורך בהן, אבל המפתח הזר עדיין בהמתנה.
  • ‫COMMITTED: השינוי בסכימה בוצע.

role_change_stream_grants

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

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד במסד הנתונים שההרשאה הזו ניתנת לו.
change_stream_catalog character varying השם של מסד הנתונים.
change_stream_schema character varying שם הסכימה שמכילה את סנכרון השינויים בזרמי הנתונים. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
change_stream_name character varying השם של סנכרון השינויים בזרמי הנתונים.
privilege_type character varying סוג ההרשאה (SELECT בלבד).
is_grantable character varying לא בשימוש. תמיד NO.

role_column_grants

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

התצוגה כוללת את ההרשאות SELECT, INSERT ו-UPDATE שהעמודה יורשת מהטבלה או מהתצוגה שמכילה את העמודה.

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד במסד הנתונים שההרשאה הזו ניתנת לו.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה או התצוגה. ערך ברירת המחדל הוא public למסדי נתונים בניב PostgreSQL.
table_name character varying שם הטבלה או התצוגה שמכילה את העמודה.
column_name character varying שם העמודה.
privilege_type character varying סוג ההרשאה (SELECT,‏ INSERT או UPDATE).
is_grantable character varying לא בשימוש. תמיד NO.

role_routine_grants

בתצוגה הזו, שמסוננת לפי שורות, מופיעות EXECUTE ההרשאות שניתנו לכל פונקציות הקריאה של סנכרון שינויים בזרמי נתונים לכל תפקיד במסד הנתונים, כולל public. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל שאר החשבונות הראשיים יכולים לראות רק את ההרשאות שניתנו לפונקציות הקריאה של סנכרון שינויים בזרמי נתונים לתפקיד הנוכחי במסד הנתונים ולתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם, לא כולל public.

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד שההרשאה הוענקה לו.
specific_catalog character varying השם של מסד הנתונים.
specific_schema character varying שם הסכימה של השגרה. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
specific_name character varying שם התרחיש. מזהה באופן ייחודי את השגרה, גם אם השם שלה עמוס מדי.
routine_catalog character varying השם של מסד הנתונים.
routine_schema character varying שם הסכימה של השגרה. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
routine_name character varying שם התרחיש. (יכול להיות שיופיעו כפילויות במקרה של עומס יתר).
privilege_type character varying סוג ההרשאה שניתנה. תמיד EXECUTE.
is_grantable character varying לא בשימוש. תמיד NO.

role_table_grants

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

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד במסד הנתונים שההרשאה הזו ניתנת לו.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה או התצוגה. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
table_name character varying שם הטבלה או התצוגה.
privilege_type character varying סוג ההרשאה (SELECT,‏ INSERT,‏ UPDATE או DELETE).
is_grantable character varying לא בשימוש. תמיד NO.
with_hierarchy character varying לא בשימוש. תמיד NULL.

routine_options

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

חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל שאר הישויות המורשות יכולות לראות רק אפשרויות לפונקציות קריאה של סנכרון שינויים בזרמי נתונים, שבהן הרשאת בקרת הגישה המפורטת (FGAC) של EXECUTE ניתנת לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים חבר בהם או ל-public.

שם העמודה סוג תיאור
specific_catalog character varying השם של מסד הנתונים.
specific_schema character varying שם הסכימה של השגרה. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
specific_name character varying שם התרחיש. מזהה באופן ייחודי את השגרה, גם אם השם שלה עמוס מדי.
option_name character varying שם האפשרות.
option_type character varying סוג הנתונים של האפשרות. הערך הוא אחד מהבאים:
  • בסוגים מובְנים, השם של סוג הנתונים.
  • במערכים, הערך ARRAY.
option_value character varying הערך של האפשרות.

routine_privileges

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

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד שההרשאה הוענקה לו.
specific_catalog character varying השם של מסד הנתונים.
specific_schema character varying שם הסכימה של השגרה. במסדי נתונים עם דיאלקט PostgreSQL, ברירת המחדל היא public.
specific_name character varying שם התרחיש. מזהה באופן ייחודי את השגרה, גם אם השם שלה עמוס מדי.
routine_catalog character varying השם של מסד הנתונים.
routine_schema character varying שם הסכימה של השגרה. ערך ברירת המחדל הוא public.
routine_name character varying שם התרחיש. (יכול להיות שההודעה תופיע פעמיים אם יש עומס).
privilege_type character varying סוג ההרשאה שניתנה.
is_grantable character varying לא בשימוש. תמיד NO.

routines

התצוגה הזו מסוננת לפי שורות, ומופיעות בה כל הפונקציות לקריאת נתונים שהוגדרו על ידי המשתמשים ופונקציות לקריאת נתונים של סנכרון שינויים בזרמי נתונים במסד נתונים. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים, וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה, יכולים לראות את כל השורות בתצוגה הזו. כל שאר הישויות המורשות יכולות לראות רק פונקציות קריאה של סנכרון שינויים בזרמי נתונים ופונקציות שמוגדרות על ידי המשתמש, שבהן ניתנה הרשאת EXECUTE לבקרת גישה מפורטת (FGAC) לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא גורם בהם או ל-public.

שם העמודה סוג תיאור
specific_catalog character varying השם של מסד הנתונים.
specific_schema character varying שם הסכימה של השגרה. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
specific_name character varying שם התרחיש. מזהה באופן ייחודי את השגרה, גם אם השם שלה עמוס מדי.
routine_catalog character varying השם של מסד הנתונים.
routine_schema character varying שם הסכימה של השגרה.
routine_name character varying שם התרחיש. (יכול להיות שיופיעו כפילויות במקרה של עומס יתר).
routine_type character varying סוג התרחיש (FUNCTION או PROCEDURE). תמיד FUNCTION
module_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
module_schema character varying לא בשימוש. הערך הוא תמיד NULL.
module_name character varying לא בשימוש. הערך הוא תמיד NULL.
udt_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
udt_schema character varying לא בשימוש. הערך הוא תמיד NULL.
udt_name character varying לא בשימוש. הערך הוא תמיד NULL.
data_type character varying סוג הערך שמוחזר מהשגרה. הערך הוא אחד מהבאים:
  • בסוגים מובְנים, השם של סוג הנתונים.
  • במערכים, הערך ARRAY.
character_maximum_length bigint לא בשימוש. הערך הוא תמיד NULL.
character_octet_length bigint לא בשימוש. הערך הוא תמיד NULL.
character_set_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
character_set_schema character varying לא בשימוש. הערך הוא תמיד NULL.
character_set_name character varying לא בשימוש. הערך הוא תמיד NULL.
collation_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
collation_schema character varying לא בשימוש. הערך הוא תמיד NULL.
collation_name character varying לא בשימוש. הערך הוא תמיד NULL.
numeric_precision bigint לא בשימוש. הערך הוא תמיד NULL.
numeric_precision_radix bigint לא בשימוש. הערך הוא תמיד NULL.
numeric_scale bigint לא בשימוש. הערך הוא תמיד NULL.
datetime_precision bigint לא בשימוש. הערך הוא תמיד NULL.
interval_type character varying לא בשימוש. הערך הוא תמיד NULL.
interval_precision bigint לא בשימוש. הערך הוא תמיד NULL.
type_udt_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
type_udt_schema character varying לא בשימוש. הערך הוא תמיד NULL.
type_udt_name character varying לא בשימוש. הערך הוא תמיד NULL.
scope_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
scope_schema character varying לא בשימוש. הערך הוא תמיד NULL.
scope_name character varying לא בשימוש. הערך הוא תמיד NULL.
maximum_cardinality bigint לא בשימוש. הערך הוא תמיד NULL.
dtd_identifier character varying לא בשימוש. הערך הוא תמיד NULL.
routine_body character varying סוג גוף השגרה (SQL או EXTERNAL).
routine_definition character varying ההגדרה של routine_body SQL, אחרת ריק.
external_name character varying לא בשימוש. הערך הוא תמיד NULL.
external_language character varying לא בשימוש. הערך הוא תמיד NULL.
parameter_style character varying לא בשימוש. הערך הוא תמיד NULL.
is_deterministic character varying לא בשימוש. הערך הוא תמיד NULL.
sql_data_access character varying לא בשימוש. הערך הוא תמיד NULL.
is_null_call character varying לא בשימוש. הערך הוא תמיד NULL.
sql_path character varying לא בשימוש. הערך הוא תמיד NULL.
schema_level_routine character varying לא בשימוש. הערך הוא תמיד NULL.
max_dynamic_result_sets character varying לא בשימוש. הערך הוא תמיד NULL.
is_user_defined_cast character varying לא בשימוש. הערך הוא תמיד NULL.
is_implicitly_invocable character varying לא בשימוש. הערך הוא תמיד NULL.
security_type character varying סוג האבטחה של התרחיש. יש תמיכה רק ב-INVOKER.
to_sql_specific_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
to_sql_specific_schema character varying לא בשימוש. הערך הוא תמיד NULL.
to_sql_specific_name character varying לא בשימוש. הערך הוא תמיד NULL.
as_locator character varying לא בשימוש. הערך הוא תמיד NULL.
created timestamp with time zone לא בשימוש. הערך הוא תמיד NULL.
last_altered timestamp with time zone לא בשימוש. הערך הוא תמיד NULL.
new_savepoint_level character varying לא בשימוש. הערך הוא תמיד NULL.
is_udt_dependent character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_from_data_type character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_as_locator character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_char_max_length bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_char_octet_length bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_char_set_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_char_set_schema character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_char_set_name character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_collation_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_collation_schema character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_collation_name character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_numeric_precision bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_numeric_precision_radix bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_numeric_scale bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_datetime_precision bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_interval_type character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_interval_precision bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_type_udt_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_type_udt_schema character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_type_udt_name character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_scope_catalog character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_scope_schema character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_scope_name character varying לא בשימוש. הערך הוא תמיד NULL.
result_cast_maximum_cardinality bigint לא בשימוש. הערך הוא תמיד NULL.
result_cast_dtd_identifier character varying לא בשימוש. הערך הוא תמיד NULL.
spanner_type character varying סוג ההחזרה המפורט של השגרה. כולל את סוג המשנה אם מוחזר ARRAY.
spanner_determinism character varying הדטרמיניזם של הפונקציה שצוין על ידי המשתמש (DETERMINISTIC, NOT_DETERMINISTIC_STABLE או NOT_DETERMINISTIC_VOLATILE). מידע נוסף זמין בתיאור של [provolatile](https://www.postgresql.org/docs/current/catalog-pg-proc.html#:~:text=provolatile).

schemata

התצוגה information_schema.schemata מכילה שורה אחת לכל סכימה במסד הנתונים הנוכחי. הסכימות כוללות את סכימת המידע וסכימת ברירת מחדל בשם public.

שם העמודה סוג תיאור
catalog_name character varying השם של מסד הנתונים.
schema_name character varying שם הסכימה. הערך הזה מוגדר כ-public בסכימת ברירת המחדל, ולא ריק בסכימות עם שם.
schema_owner character varying השם של בעלי הסכימה.
default_character_set_catalog character varying לא בשימוש.
default_character_set_schema character varying לא בשימוש.
default_character_set_name character varying לא בשימוש.
sql_path character varying לא בשימוש.
effective_timestamp timestamp with timezone חותמת הזמן שבה כל הנתונים בסכימה הזו נכנסו לתוקף. ההגדרה הזו משמשת רק לסכימה שמוגדרת כברירת מחדל.

sequences

התצוגה information_schema.sequences מכילה את המטא-נתונים של sequences.

שם העמודה סוג תיאור
sequence_catalog character varying השם של מסד הנתונים.
sequence_schema character varying שם הסכימה של הרצף. ברירת המחדל היא public במסד נתונים עם דיאלקט PostgreSQL.
sequence_name character varying שם הרצף.
data_type character varying אפשר להשתמש רק ב-int8 ברצף.
numeric_precision bigint לא בשימוש. הערך הוא תמיד `NULL`.
numeric_precision_radix bigint לא בשימוש. הערך הוא תמיד `NULL`.
numeric_scale bigint לא בשימוש. הערך הוא תמיד `NULL`.
start_value bigint לא בשימוש. הערך הוא תמיד `NULL`.
minimum_value bigint לא בשימוש. הערך הוא תמיד `NULL`.
maximum_value bigint לא בשימוש. הערך הוא תמיד `NULL`.
increment bigint לא בשימוש. הערך הוא תמיד `NULL`.
cycle_option character varying האפשרות היחידה ש-sequence מקבל היא no.
sequence_kind character varying סוג הרצף. bit_reversed_positive הוא הערך הקביל היחיד.
counter_start_value bigint הערך ההתחלתי של מונה הרצף.
skip_range_min bigint הערך המינימלי בטווח שדילגתם עליו. אם לא מגדירים את הערך הזה, הוא יהיה NULL.
skip_range_max bigint הערך המקסימלי בטווח שדילגתם עליו. אם לא מגדירים את הערך הזה, הוא יהיה NULL.

spanner_statistics

בטבלה הזו מפורטות חבילות הנתונים הסטטיסטיים הזמינות של הכלי לאופטימיזציה של שאילתות.

שם העמודה סוג תיאור
catalog_name character varying השם של מסד הנתונים.
schema_name character varying שם הסכימה. ערך ברירת המחדל של הסכימה הוא public.
package_name character varying שם חבילת הנתונים הסטטיסטיים.
allow_gc character varying אם חבילת הנתונים הסטטיסטיים פטורה מאיסוף. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני. צריך להגדיר את המאפיין הזה לערך NO לפני שאפשר להפנות לחבילת הנתונים הסטטיסטיים ברמז או דרך ה-API של הלקוח.

table_constraints

התצוגה הזו מכילה את כל האילוצים ששייכים לטבלאות שלמשתמש הנוכחי יש גישה אליהן (חוץ מ-SELECT).

שם העמודה סוג תיאור
constraint_catalog character varying השם של מסד הנתונים.
constraint_schema character varying שם הסכימה שמכילה את האילוץ.
constraint_name character varying שם האילוץ.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה שמשויכת לאילוץ.
table_name character varying שם הטבלה.
constraint_type character varying סוג האילוץ. הערכים האפשריים הם:
  • CHECK
  • FOREIGN KEY
  • PLACEMENT KEY
  • PRIMARY KEY
  • UNIQUE
is_deferrable character varying הערך הוא תמיד NO.
initially_deferred character varying הערך הוא תמיד NO.
enforced character varying אם האילוץ נאכף. אם אילוץ נאכף (אחרי שהוא מגיע למצב מסוים), הוא מאומת גם בזמן הכתיבה וגם על ידי מאמת תקינות ברקע. בהתאם לתקן SQL, המחרוזת היא YES או NO, ולא ערך בוליאני.

table_privileges

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

שם העמודה סוג תיאור
grantor character varying לא בשימוש. תמיד NULL.
grantee character varying שם התפקיד במסד הנתונים שההרשאה הזו ניתנת לו.
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה או התצוגה. ברירת המחדל היא public למסדי נתונים בניב PostgreSQL.
table_name character varying שם הטבלה או התצוגה.
privilege_type character varying סוג ההרשאה (SELECT,‏ INSERT,‏ UPDATE או DELETE).
is_grantable character varying לא בשימוש. תמיד NO.
that have_hierarchy character varying לא בשימוש. תמיד NULL.

tables

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

  • הרשאות בקרת הגישה המפורטת (FGAC) SELECT,‏ INSERT,‏ UPDATE או DELETE ניתנות בטבלה לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים חבר בהם או ל-public.
  • ההרשאות SELECT,‏ INSERT או UPDATE ניתנות בכל עמודה בטבלה לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-public.

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה או התצוגה.
table_name character varying שם הטבלה, התצוגה או המילה הנרדפת.
table_type character varying סוג הטבלה. כמה מהערכים האפשריים: "מסד נתונים טבלאי",‏ "VIEW" או "מילה נרדפת".
self_referencing_column_name character varying לא בשימוש.
reference_generation character varying לא בשימוש.
user_defined_type_catalog character varying לא בשימוש.
user_defined_type_schema character varying לא בשימוש.
user_defined_type_name character varying לא בשימוש.
is_insertable_into character varying לא בשימוש.
is_typed character varying לא בשימוש.
commit_action character varying לא בשימוש.
parent_table_name character varying השם של טבלת ההורה אם הטבלה הזו משולבת, או NULL.
on_delete_action character varying הערך הזה מוגדר כ-CASCADE או כ-NO ACTION בטבלאות משולבות, וכ-NULL במקרים אחרים. מידע נוסף זמין במאמר הצהרות TABLE.
spanner_state character varying מצב היצירה הנוכחי של הטבלה.
טבלה יכולה לעבור כמה מצבים במהלך היצירה, אם מעורבות פעולות בכמות גדולה, למשל, כשהטבלה נוצרת עם מפתח זר שדורש מילוי חוזר של האינדקס שאליו הוא מפנה. הסטטוסים האפשריים הם:
  • ‫ADDING_FOREIGN_KEY: הוספת המפתחות הזרים של הטבלה
  • ‫WAITING_FOR_COMMIT: סיום השינוי בסכימה
  • ‫COMMITTED: השינוי בסכימה ליצירת הטבלה בוצע. אי אפשר לכתוב בטבלה עד שהשינוי יבוצע.
  • ‫NULL: טבלאות או תצוגות שהן לא מסדי נתונים טבלאיים.
interleave_type character varying אם יש קשר הורה-צאצא בין הטבלה הזו לבין הטבלה שבה היא משולבת. הערכים האפשריים הם:
  • ‫IN: טבלה ב-INTERLEAVE IN שאין בה קשרי הורה-צאצא. שורה בטבלה הזו יכולה להתקיים בלי קשר לקיום של שורת הטבלה ההורה שלה.
  • ‫IN PARENT: טבלה ב-INTERLEAVE IN PARENT שיש בה קשר הורה-צאצא. כדי ששורה תהיה קיימת בטבלה הזו, צריכה להיות קיימת שורה בטבלת ההורה שלה.
row_deletion_policy_expression character varying מחרוזת שמכילה את טקסט הביטוי שמגדיר את ROW DELETION POLICY.

table_synonyms

בטבלה הזו מפורט מידע על מילים נרדפות לטבלה.

שם העמודה סוג תיאור
CATALOG STRING שם הקטלוג שמכיל את הטבלה.
SCHEMA STRING שם הסכימה שמכילה את הטבלה.
TABLE_NAME STRING שם הטבלה.
SYNONYM_CATALOG STRING שם הקטלוג של המילה הנרדפת.
SYNONYM_SCHEMA STRING שם הסכימה של המילה הנרדפת.
SYNONYM_TABLE_NAME STRING שם הטבלה של המילה הנרדפת.

views

התצוגה הזו, שמסוננת לפי שורות, מציגה את כל התצוגות במסד הנתונים הנוכחי. חשבונות משתמשים עם הרשאות IAM ברמת מסד הנתונים וחשבונות משתמשים שקיבלו גישה לתפקיד המערכת spanner_info_reader או לחברים בתפקיד הזה יכולים לראות את כל התצוגות. כל שאר החשבונות הראשיים יכולים לראות רק תצוגות שבהן הוענקה הרשאת בקרת הגישה המפורטת SELECT לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-public.

שם העמודה סוג תיאור
table_catalog character varying השם של מסד הנתונים.
table_schema character varying שם הסכימה. ערך ברירת המחדל הוא public.
table_name character varying שם התצוגה.
view_definition character varying טקסט ה-SQL של השאילתה שמגדירה את התצוגה.
check_option character varying לא בשימוש.
is_updatable character varying לא בשימוש.
is_insertable_into character varying לא בשימוש.
is_trigger_updatable character varying לא בשימוש.
is_trigger_deletable character varying לא בשימוש.
is_trigger_insertable_into character varying לא בשימוש.
security_type character varying סוג האבטחה של התצוגה. ‫INVOKER או DEFINER.

מידע נוסף זמין במאמר מידע על תצוגות מפורטות.

דוגמאות

החזרת מידע על כל טבלה בסכימה של המשתמש:

SELECT
  t.table_schema,
  t.table_catalog,
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_schema NOT IN ('pg_catalog', 'information_schema', 'SPANNER_SYS')
  AND t.table_type = 'BASE TABLE'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

החזרת השם של כל הטבלאות והתצוגות במסדי נתונים של information_schema בניב PostgreSQL:

SELECT table_name
FROM information_schema.tables
WHERE table_schema = "information_schema"

החזרת מידע על עמודות בטבלת המשתמשים my_table בסכימת ברירת המחדל:

SELECT
  t.ordinal_position,
  t.column_name,
  t.data_type,
  t.spanner_type,
  t.is_nullable
FROM
  information_schema.columns AS t
WHERE
  t.table_schema = 'public'
  AND
  t.table_name = 'my_table'
ORDER BY
  t.ordinal_position

החזרת מידע על כל אינדקס בסכימת ברירת המחדל במסד הנתונים הנוכחי: ```postgresql SELECT t.table_name, t.index_name, t.parent_table_name FROM information_schema.indexes AS t WHERE t.table_schema = 'public' AND t.index_type != 'PRIMARY_KEY' ORDER BY t.table_schema, t.table_name, t.index_name

החזרת עמודות שמשתמשות באפשרויות שאינן ברירת מחדל בסכימת ברירת המחדל:

SELECT
  t.table_name,
  t.column_name,
  t.option_type,
  t.option_value,
  t.option_name
FROM
  information_schema.column_options AS t
WHERE
  t.table_schema = 'public'
ORDER BY
  t.table_schema,
  t.table_name,
  t.column_name,
  t.option_name

מחזירים את האפשרויות הנוכחיות של מסד הנתונים שקשורות לאופטימיזציה:

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.schema_name='public'
  AND s.option_name IN ('optimizer_version',
    'optimizer_statistics_package')

החזרת כל חבילות הנתונים הסטטיסטיים הזמינות:

SELECT *
FROM information_schema.spanner_statistics;
``` ## What's
next {: #whats-next}

+   Learn about available [Introspection tools](/spanner/docs/introspection) to
help you investigate database issues.