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

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

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

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

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

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