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

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

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

לפני שמתחילים

  • בפרויקט שבו אתם משתמשים צריך להפעיל גישה ל-AlloyDB. Google Cloud
  • צריך להיות לכם אחד מתפקידי ה-IAM האלה בפרויקט Google Cloud שבו אתם משתמשים:
    • ‫roles/alloydb.admin (תפקיד IAM מוגדר מראש של אדמין AlloyDB)
    • ‫roles/owner (תפקיד בסיסי ב-IAM: בעלים)
    • ‫roles/editor (תפקיד בסיסי ב-IAM עם הרשאת עריכה)

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

הפעלת תוסף

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

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

התהליך

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

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

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

  3. בשורת הפקודה psql, מתחברים למסד הנתונים ויוצרים את התוסף: 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. אם רוצים, חוזרים על השלב הקודם כדי להתחבר למסדי נתונים אחרים וליצור את התוסף בכל אחד מהם.

השבתה של תוסף

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

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

  2. בשורת הפקודה של psql, מתחברים למסד הנתונים שבו התוסף מופעל ומסירים את התוסף: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. חוזרים על השלב הקודם כדי להתחבר לכל מסד נתונים אחר שבו התוסף מופעל, ומסירים את התוסף מכל אחד מהם.

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

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