סכימת מידע למסדי נתונים בניב 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, לדוגמה:

    • ‫executeQuery API
    • הפקודה 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 for PostgreSQL-dialect.

applicable_roles

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

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

שם העמודה סוג תיאור
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

בתצוגה הזו, שכוללת סינון לפי שורות, מפורטות כל ההרשאות של בקרת גישה ברמת גרנולריות גבוהה שניתנו בכל הזרמים של השינויים לכל תפקיד במסד הנתונים, כולל 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 או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל הישויות המורשות האחרות יכולות לראות רק סנכרון שינויים בזרמי נתונים שבהם ההרשאה 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 עצמה). העמודה הזו אף פעם לא מכילה ערך null.
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 עצמה). העמודה הזו אף פעם לא מכילה ערך null.
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 או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל החשבונות הראשיים האחרים יכולים לראות רק עמודות שהוענקו להן הרשאות של בקרת גישה ברמת דיוק גבוהה (או ההרשאות SELECT, INSERT או UPDATE שהוענקו לטבלאות שמכילות אותן) לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-public.

שם העמודה סוג תיאור
table_catalog character varying שם מסד הנתונים.
table_schema character varying שם הסכימה שמכילה את הטבלה. השם הוא public עבור סכימת ברירת המחדל ולא ריק עבור סכימות אחרות (לדוגמה, information_schema עצמה). העמודה הזו אף פעם לא מכילה ערך null.
table_name character varying שם הטבלה
column_name character varying שם העמודה
ordinal_position BIGINT המיקום הסידורי של העמודה בטבלה, החל מערך של 1
column_default character varying ייצוג מחרוזתי של ביטוי PostgreSQL בקוד פתוח של ערך ברירת המחדל של העמודה, לדוגמה, '9'::bigint.
is_nullable character varying מחרוזת שמציינת אם העמודה יכולה להכיל ערך null. בהתאם לתקן 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. בתצוגה הזו מופיע שם הטבלה שאליה שייך האילוץ של מפתח ייחודי או מפתח ראשי. האילוצים מסוג Check והאילוצים מסוג not-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 מחרוזת שמציינת אם העמודה יכולה להכיל ערך null. בהתאם לתקן 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_constraints.CHECK

שם העמודה סוג תיאור
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 בקרת גישה ברמת גרנולריות גבוהה לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-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 מחרוזת שמציינת אם העמודה יכולה להכיל ערך null. בהתאם לתקן 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 או 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 או לחברים בתפקיד הזה יכולים לראות את כל השורות בתצוגה הזו. כל החשבונות האחרים יכולים לראות רק אפשרויות של פונקציות קריאה של זרם שינויים שההרשאה 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 מוענקת לתפקיד הנוכחי במסד הנתונים, לתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ל-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 האם חבילת הנתונים הסטטיסטיים פטורה מ-garbage collection. בהתאם לתקן 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 או לחברים בתפקיד הזה יכולים לראות את כל הטבלאות והתצוגות. כל שאר הגורמים המורשים יכולים לראות רק טבלאות שעומדות באחת מהדרישות הבאות:

  • הרשאות בקרת גישה ברמת דיוק גבוהה 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 סוג הטבלה. הערכים האפשריים כוללים 'BASE TABLE',‏ 'VIEW' או 'SYNONYM'.
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 fine-grained access control (בקרת גישה ברמת גרנולריות גבוהה) בתפקיד הנוכחי במסד הנתונים, בתפקידים שהתפקיד הנוכחי במסד הנתונים הוא חבר בהם או ב-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.