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

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

במאמר תוספים נתמכים של מסדי נתונים מפורטים התוספים שנתמכים ב-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 מתקינים באופן אוטומטי את קובצי ה-extension הבינאריים העדכניים ביותר בתוכנה הבסיסית של המכונה, אבל הם לא מעדכנים באופן אוטומטי את קטלוג מסד הנתונים של התוסף. אתם צריכים לעדכן את התוספים באופן ידני כדי לוודא שהם משתמשים בגרסאות הנתמכות העדכניות ביותר.

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

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

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. אם התוסף דרש להגדיר דגלים לניהול מסד נתונים במכונות שבהן הוא היה בשימוש, מסירים את הדגלים מכל אחת מהמכונות שבהן הוא היה בשימוש לפי ההוראות במאמר הגדרת דגלים לניהול מסד נתונים של מכונה.

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