הגדרת תוספים ל-PostgreSQL

אפשר להרחיב את PostgreSQL על ידי איגוד אובייקטים של SQL לחבילה ושימוש בהם כיחידה אחת. בדף הזה מוסבר איך להגדיר את התוספים של PostgreSQL שנתמכים ב-Cloud SQL.

שימוש בתוספים ל-PostgreSQL

אפשר להתקין רק את התוספים ש-Cloud SQL תומך בהם. מידע נוסף זמין במאמר בנושא תוספים ל-PostgreSQL שנתמכים על ידי Cloud SQL.

התקנה של תוסף

לפני שמשתמשים בתוסף, צריך להתקין אותו:

• בכלי psql, מריצים את הפקודה CREATE EXTENSION.

דרישה להרשאות של משתמש-על

ב-Cloud SQL, רק משתמשים ששייכים לתפקיד cloudsqlsuperuser יכולים ליצור תוספים. כשיוצרים מופע חדש של PostgreSQL, נוצר בשבילכם משתמש ברירת המחדל postgres (אבל אתם צריכים להגדיר את הסיסמה של המשתמש). משתמש ברירת המחדל postgres הוא חלק מהתפקיד cloudsqlsuperuser. מידע נוסף זמין במאמר בנושא משתמשי PostgreSQL.

חיבורים בין מסדי נתונים

מכונות היעד לחיבורים צריכות להיות באותה רשת VPC כמו המכונה שממנה מתבצע החיבור.

במקרים של מופעי אשכולות, אי אפשר לבחור באפשרות Require trusted client certificates (נדרשים אישורי לקוח מהימנים) במסוףCloud de Confiance . בנוסף, כדי להתחבר למסדי נתונים באותו מופע, אי אפשר להגדיר את המארח ל-localhost או ל-127.0.0.1. במקום זאת, צריך להשתמש בכתובת ה-IP שמוצגת עבור המופע שלכם במסוף Cloud de Confiance .

בקשת תמיכה בתוסף חדש

אי אפשר ליצור תוספים משלכם ב-Cloud SQL.

כדי לבקש תמיכה בתוסף, לוחצים על +1 בבעיה הפתוחה או יוצרים בעיה חדשה. רשימת הבעיות הפתוחות בנושא Cloud SQL ומידע על יצירת בעיות חדשות זמינים במאמר איך מחפשים או יוצרים דיווחים על בעיות ואיך שולחים בקשות למאפיינים חדשים לפי מוצר.

תוספי PostgreSQL שנתמכים על ידי Cloud SQL

בטבלאות שבהמשך מופיעים קישורים לתיעוד שבו אפשר לקבל מידע על שימוש בתוסף ספציפי.

התמיכה בתוספים של PostgreSQL ב-Cloud SQL מתחלקת לקטגוריות הבאות:

• תוספי PostGIS
• הרחבות של סוגי נתונים
• תוספי שפה
• תוספים שונים

PostGIS

התוסף PostGIS נתמך ב-Cloud SQL ל-PostgreSQL בכל הגרסאות העיקריות.

בטבלה הבאה מפורטות הגרסאות של תוסף PostGIS לכל גרסה של Cloud SQL ל-PostgreSQL:

בפקודה CREATE EXTENSION, אפשר לציין גרסה של תוסף PostGIS באמצעות התנאי VERSION, עבור גרסה ראשית ספציפית של PostgreSQL.

התוסף PostGIS כולל את הפריטים הבאים:

• postgis
• postgis_raster
• postgis_sfcgal
• postgis_tiger_geocoder
• postgis_topology
• address_standardizer
• address_standardizer_data_us

מידע נוסף זמין במאמר בנושא התקנת PostGIS.

בנוסף, Cloud SQL ל-PostgreSQL כולל את גרסה 3.6.2 של התוסף pgRouting, שמרחיב את PostGIS. התוסף pgRouting משפר את העיבוד הגיאו-מרחבי באמצעות ניתוח וניתוב ברשת.

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

הרחבות של סוגי נתונים

תוספים לשפה

תוספים שונים

מידע נוסף על חלק מהתוספים של PostgreSQL

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

auto_explain

כדי להתחיל להשתמש בתוסף הזה במופע, צריך להגדיר את הדגל cloudsql.enable_auto_explain ל-on. מידע על הגדרת דגלים ועל הדגלים שנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

כדי לראות את הנתונים והאירועים ביומן שמשויכים ליומנים של תוכניות ההרצה שהתוסף הזה מאפשר, אפשר לעיין במסמכי התיעוד של Cloud Logging.

לחלופין, אם למשתמש יש רק את התפקיד cloudsqlsuperuser, אפשר להשתמש בפקודה load כדי לטעון את התוסף הזה לסשן אחד.

dblink

במהלך סשן במסד נתונים, אפשר להשתמש בתוסף הזה כדי להתחבר למסדי נתונים של PostgreSQL ולהריץ שאילתות.

בשלב הזה, התוסף הזה פועל בשתי מכונות עם כתובות IP פרטיות של Cloud SQL באותה רשת VPC, או במסדי נתונים שונים באותה מכונה.

מידע נוסף זמין במאמר dblink במסמכי התיעוד של PostgreSQL.

שימוש ב-dblink כדי להתחבר באמצעות סיסמה

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

  SELECT * FROM dblink (
    'dbname=name port=1234 host=host user=user password=password',
    'select id, name from table' \
  ) AS t(id int, name text);

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

  SELECT dblink_connect('dbname=dblinktest user=postgres host=name_or_ip password=xxx');

שימוש ב-dblink כדי להתחבר בלי סיסמה

כדי להתחבר לאותו מופע כאותו משתמש, אפשר להתחבר בלי סיסמה. לדוגמה:

1. מגדירים את הדגל הבא של מסד הנתונים כדי להפעיל חיבורים מקומיים ללא סיסמה
   cloudsql.allow_passwordless_local_connections

2. התחברות בלי לציין מארח, מה שאומר התחברות לאותו מופע. לדוגמה:

   SELECT *
     FROM dblink('dbname=finance user=alice',
                 'select income from revenue')
       AS revenue(income integer);
   

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

         income
         --------
         1000
         (1 row)
   

כדי להתחבר למסדי נתונים באותו מופע, אי אפשר להגדיר את המארח ל-localhost או ל-127.0.0.1. במקום זאת, צריך להשתמש בכתובת ה-IP שמוצגת עבור המופע במסוף Cloud de Confiance .

אפשר לעיין גם בpostgres_fdw וב-PL/Proxy במסמך הזה.

pageinspect

התוסף הזה בודק את התוכן של דפי מסד נתונים ברמה נמוכה. מידע נוסף זמין במאמר pageinspect במאמרי העזרה של PostgreSQL.

pg_bigm

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

כדי להתחיל להשתמש בתוסף הזה במופע, צריך להגדיר את הדגל cloudsql.enable_pg_bigm ל-on. יש תמיכה גם בדגלים הבאים:

• pg_bigm.enable_recheck
• pg_bigm.gin_key_limit
• pg_bigm.similarity_limit

מידע על הגדרת דגלים ועל הדגלים שנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

pg_cron

כדי להתחיל להשתמש ב-pg_cron במופע, מגדירים את הדגל cloudsql.enable_pg_cron לערך on. מידע על הגדרת דגלים ועל הדגלים הנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

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

בתוסף הזה, Cloud SQL תומך במצב של עובד ברקע, אבל לא בממשק libpq. לכן, לא נדרש אימות מהימן ישירות בתוסף הזה.

pgfincore

התוסף הזה מכיל פונקציות לניהול דפים בזיכרון מטמון של דיסק מערכת ההפעלה מ-PostgreSQL. מידע נוסף זמין במאמרי העזרה בנושא pgfincore.

pg_freespacemap

התוסף הזה בודק את מפת הנפח הפנוי (FSM). מידע נוסף זמין במאמר pg_freespacemap במסמכי התיעוד של PostgreSQL.

pg_hint_plan

כדי להתחיל להשתמש בתוסף הזה במופע, צריך להגדיר את הדגל cloudsql.enable_pg_hint_plan ל-on. מידע על הגדרת דגלים ועל הדגלים שנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

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

pg_partman

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

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

pg_proctab

כדי להפעיל את כלי השירות pg_top, צריך להשתמש בתוסף pg_proctab. כך עושים את זה:

1. בכלי psql, מריצים את הפקודה CREATE EXTENSION עבור pg_proctab.
2. מורידים ומריצים את pg_top.
3. כשמתחברים למופע של Cloud SQL ל-PostgreSQL, מוסיפים את האפשרות -r כדי להתחבר למסד נתונים מרוחק ולקבל מדדים.

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

• ממוצע עומס
• מצבי המעבד (CPU) (% user, nice, system, idle, and iowait)
• זיכרון (בשימוש, פנוי ובמטמון)

pg_repack

התוסף הזה מאפשר לכם להסיר נתונים מיותרים מטבלאות ומאינדקסים. אפשר גם להשתמש בתוסף הזה כדי לבצע CLUSTER אונליין (סידור טבלאות לפי אינדקס אשכול). מידע נוסף מופיע במאמרי העזרה בנושא pg_repack. בנוסף, כדי להשתמש בתוסף הזה ב-Cloud SQL, צריך לבצע הליך מיוחד כדי להוסיף הרשאות למשתמש.

אם משתמש שלא הוקצה לו התפקיד cloudsqlsuperuser רוצה להשתמש בתוסף, צריך להעניק לו הרשאות cloudsqlsuperuser. דרישות להרשאות סופר-משתמש בדוגמה הבאה משתמשים בפקודה GRANT כדי להוסיף את ההרשאות הנדרשות.

דוגמה להוספת הרשאות

לצורך הדוגמה שבהמשך, csuper1 הוא cloudsqlsuperuser ו-testdb הוא מסד נתונים בבעלות testuser. כדי ליצור את התוסף pg_repack ב-testdb, מריצים את הפקודות הבאות:

1. התחברות אל testdb בתור cloudsqlsuperuser:

   psql -U csuper1 -d testdb;
   

2. הענקת הרשאה לבעלים של מסד הנתונים, שהוא testuser,, ל-csuper1:

   GRANT testuser TO csuper1;
   

3. יוצרים את התוסף:

   CREATE EXTENSION pg_repack;
   

4. מריצים את הפקודה pg_repack בטבלה, כמו t1 ב-testdb, בתור csuper1:

   pg_repack -h <hostname> -d testdb -U csuper1 -k -t t1
   

5. אחרי שהמשימה pg_repack מסתיימת, מבטלים את ההרשאה שביצעתם בשלב 2:

    REVOKE testuser FROM csuper1;
   

יכול להיות שהפקודה pg_repack תיכשל עם השגיאה הבאה:
"ERROR: query failed: SSL SYSCALL error: EOF detected"

אם השגיאה הזו מתרחשת, מנסים להגדיר ערך קטן יותר ל-TCP keepalives ואז מריצים את הפקודה pg_repack. מידע נוסף זמין במאמר בנושא זמן קצוב לתפוגה של חיבורים (מ-Compute Engine).

pg_squeeze

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

התוסף הזה תומך גם בפענוח לוגי על ידי כתיבת מידע נוסף ליומן הפעולות (WAL). כדי להפעיל את הפונקציונליות הזו בתוסף, צריך להגדיר את פרמטר ההגדרה wal_level לערך logical או לערך גבוה יותר על ידי הגדרת הדגל cloudsql.logical_decoding לערך on.

צריך להגדיר ערך לדגל max_replication_slots בתוסף. אם לא ציינתם ערך לדגל הזה, צריך להגדיר את הערך 1. אחרת, מוסיפים 1 לערך שמוגדר לדגל.

מידע על הגדרת דגלים ועל הדגלים שנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

pgtt

כדי להתחיל להשתמש בתוסף הזה במופע, צריך להגדיר את הדגל pgtt.enabled ל-on. מידע על הגדרת דגלים ועל הדגלים שנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

pg_visibility

התוסף הזה מאפשר לבדוק את מפת החשיפה (VM) ואת פרטי החשיפה ברמת הדף של טבלה. מידע נוסף זמין במאמר בנושא pg_visibility במסמכי התיעוד של PostgreSQL.

PL/Proxy

התוסף הזה הוא handler של שפה פרוצדורלית שמאפשר קריאות לפרוצדורות מרוחקות בין מסדי נתונים של PostgreSQL, עם אפשרות לשיתוף.

מידע נוסף מופיע במאמרי העזרה בנושא PL/Proxy.

מכונות היעד לחיבורים צריכות להיות באותה רשת VPC כמו המכונה שממנה מתבצע החיבור. בנוסף, אי אפשר לבחור במסוףCloud de Confiance את הלחצן Allow only SSL connections (אפשר לאשר רק חיבורי SSL) עבור מופעי אשכול.

כדי להתחבר למסדי נתונים באותו מופע, אי אפשר להגדיר את המארח ל-localhost או ל-127.0.0.1. במקום זאת, צריך להשתמש בכתובת ה-IP שמוצגת עבור המופע במסוף Cloud de Confiance .

אפשר לעיין גם ב-postgres_fdw וב-dblink במסמך הזה.

postgresql_anonymizer

כדי להתחיל להשתמש בתוסף הזה במופע, צריך להגדיר את הדגל cloudsql.enable_anon ל-on. מידע על הגדרת דגלים ועל הדגלים שנתמכים בתוסף הזה זמין במאמר הגדרת דגלים של מסד נתונים.

postgres_fdw

התוסף הזה מאפשר לחשוף טבלאות ממסדי נתונים אחרים ("חיצוניים") של PostgreSQL כטבלאות "חיצוניות" במסד הנתונים הנוכחי. אחר כך אפשר להשתמש בטבלאות האלה, כאילו הן טבלאות מקומיות. מידע נוסף זמין במאמר postgres_fdw במסמכי התיעוד של PostgreSQL.

התוסף הזה פועל בשני מקרים: כשמדובר בשני מופעים של Cloud SQL עם כתובות IP פרטיות באותה רשת VPC, או כשמדובר במסדי נתונים שונים באותו מופע.

כדי להתחבר למסדי נתונים באותו מופע, אי אפשר להגדיר את המארח כ-localhost או כ-127.0.0.1. במקום זאת, צריך להשתמש בכתובת ה-IP שמוצגת עבור המופע שלכם במסוף Cloud de Confiance .

בנוסף, אם יש לכם מופע שבו מאוחסנים נתונים ממדינות אחרות, אתם יכולים לבחור באפשרות Allow only SSL connections [אפשרות רק לחיבורי SSL] במסוף Cloud de Confiance . אי אפשר לבחור באפשרות נדרשים אישורי לקוח מהימנים. רק cloudsqlsuperuser יכול להיות הבעלים של postgres_fdw foreign data wrapper.

אפשר לעיין גם בPL/Proxy וב-dblink במסמך הזה.

postgresql-hll

התוסף הזה מציג סוג נתונים חדש, hll, שהוא מבנה נתונים של HyperLogLog. מידע נוסף זמין במסמכי התיעוד של postgresql-hll.