הגדרת תוספים למסד נתונים

בדף הזה מוסבר איך להפעיל ולהשבית תוספים של PostgreSQL ב-AlloyDB.

במאמר תוספים נתמכים למסדי נתונים מפורטת רשימת התוספים שנתמכים ב-AlloyDB.

הפעלת תוסף

באופן כללי, כדי להפעיל תוסף צריך להתחבר למסד נתונים במכונה הראשית של אשכול AlloyDB ולהזין פקודה של LOAD או CREATE EXTENSION.

עם זאת, כדי להשתמש בפקודה LOAD או בפקודה CREATE EXTENSION כדי להפעיל תוסף מסוים, צריך להגדיר דגל מסד נתונים אחד או יותר לפני כן. מגדירים את הדגלים האלה במופע AlloyDB שבו רוצים להשתמש בתוסף, בין אם המופע הזה הוא המופע הראשי או מופע מאגר לקריאה.

התהליך

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

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

2. מחברים לקוח psql למופע הראשי של האשכול, כמו שמתואר במאמר חיבור לקוח psql למופע.

   הערה: צריך להתחבר למופע הראשי גם אם מפעילים את התוסף במופע של מאגר לקריאה.
3. בשורת הפקודה psql, מתחברים למסד הנתונים ויוצרים את התוסף:

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   הערה: כדי ליצור את התוסף auto_explain, משתמשים בפקודה LOAD.
4. אם רוצים, חוזרים על השלב הקודם כדי להתחבר למסדי נתונים אחרים וליצור את התוסף בכל אחד מהם.

עדכון תוסף

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

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

מתחברים למסד הנתונים ומריצים את הפקודה הבאה כדי לראות את הגרסאות המותקנות:

SELECT * FROM pg_extension;

כדי לעדכן תוסף לגרסה העדכנית ביותר שזמינה במכונה, משתמשים בפקודה ALTER EXTENSION.

מתחברים למופע הראשי של האשכול באמצעות לקוח לבחירתכם, כמו AlloyDB Studio או לקוח psql, ומריצים את הפקודה הבאה לכל תוסף שרוצים לעדכן:

ALTER EXTENSION EXTENSION_NAME UPDATE;

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

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

השבתה של תוסף

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

1. מחברים לקוח psql למופע הראשי של האשכול, כמו שמתואר במאמר חיבור לקוח psql למופע.

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

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

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

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

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