הגדרת עותקים משוכפלים חיצוניים

בדף הזה מוסבר איך להגדיר מכונה של Cloud SQL שיוצרת רפליקה מחוץ ל-Cloud SQL באמצעות תוסף pglogical עם logical decoding.

מידע נוסף על רפליקציה זמין במאמר מידע על רפליקציה ב-Cloud SQL.

הגדרת התצורה של הרפליקה החיצונית

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

לפני שמתחילים את המשימה, צריך לוודא שיש לכם מכונה של Cloud SQL ומכונה חיצונית של PostgreSQL.

הדרישות לגבי מופע המקור

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

הגדרת המכונה הראשית

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .
  2. במכונה הראשית, מאפשרים גישה לכתובת ה-IP של הרפליקה החיצונית.

    במאמר הגדרת גישה לקישורים דרך IP מוסבר איך מפעילים גישה ל-IP.

  3. שומרים את כתובת ה-IP הציבורית ואת כתובת ה-IP הציבורית לתעבורה יוצאת של המכונה הראשית, כדי להשתמש בהן בהמשך. אפשר למצוא את הערכים האלה בדף Overview של המכונה.
  4. לוחצים על הסמל של Cloud Shell בפינה הימנית העליונה.
  5. בשורת הפקודה של Cloud Shell, משתמשים בלקוח המובנה של PostgreSQL כדי להתחבר למכונה הראשית:
       
    gcloud sql connect PRIMARY_INSTANCE_NAME \
    --user=postgres
       
       
  6. מזינים את סיסמת הבסיס. אחרי זה אמורה להופיע ההנחיה של postgres.
  7. יוצרים משתמש PostgreSQL עם המאפיין REPLICATION.
    CREATE USER REPLICATION_USER WITH REPLICATION IN ROLE cloudsqlsuperuser LOGIN PASSWORD 'REPLICATION_USER_PASSWORD';
       
  8. מתקינים ומגדירים את התוסף pglogical:

    עורכים את המכונה של Cloud SQL כדי להוסיף ולהגדיר את הדגלים הבאים:

    • cloudsql.enable_pglogical
    • cloudsql.logical_decoding
    • max_replication_slots
    • max_worker_processes
    • max_wal_senders
    • מידע נוסף על הדגלים האלה זמין בדף משאבי PostgreSQL.

    מפעילים מחדש את מסד הנתונים, מתחברים, עוברים ל-replication_user ויוצרים את התוסף pglogical:

    CREATE EXTENSION pglogical;
       

  9. יוצרים צומת pglogical:

    _צומת_ pglogical מייצג מכונה פיזית של PostgreSQL, ומאחסן את פרטי החיבור של המכונה הזו.

    SELECT pglogical.create_node(
      node_name := 'provider',
      dsn := 'host=PRIMARY_PUBLIC_IP_ADDRESS port=5432 dbname=DATABASE_NAME user=REPLICATION_USER password=REPLICATION_USER_PASSWORD'
       );
       
  10. אם אתם מתחילים עם מסד נתונים חדש, צרו את אותו מסד נתונים ואותן טבלאות גם במכונה הראשית וגם במכונת הרפליקה. לדוגמה:
    CREATE DATABASE test;
    
    \connect test;
    
    CREATE TABLE replica_test (id SERIAL PRIMARY KEY, data text);
    INSERT INTO replica_test (data) VALUES ('apple'), ('banana'), ('cherry');
    
    CREATE EXTENSION pglogical;
  11. אם כבר יש לכם מסד נתונים במכונה הראשית, אתם צריכים ליצור את אותו מסד נתונים ברפליקה. כדי לעשות את זה, מייצאים את מסד הנתונים מהמכונה הראשית לקטגוריה של Cloud Storage ומייבאים אותו לרפליקה. מידע נוסף על ייצוא נתונים מ-Cloud SQL לקובץ SQL מוכן לשימוש ב-Cloud Storage
  12. כדי לתמוך בשכפול של קבוצות שונות של נתונים ליעדים שונים, ב-pglogical יש קונספט של קבוצת שכפול. לדוגמה, כדי להוסיף טבלה לקבוצת הרפליקציה שמוגדרת כברירת מחדל:
    SELECT pglogical.replication_set_add_table('default', 'replica_test', true);
       

הגדרת הרפליקה החיצונית

  1. יוצרים משתמש מיוחד לרפליקציה ומעניקים לו הרשאות רפליקציה:
    CREATE USER REPLICATION_USER WITH REPLICATION SUPERUSER LOGIN PASSWORD 'REPLICATION_USER_PASSWORD';
       
  2. אם אתם מתחילים עם מסד נתונים חדש, השתמשו ב-REPLICATION_USER כדי ליצור את אותו מסד נתונים ואותן טבלאות גם במכונה הראשית וגם במכונת הרפליקה. לדוגמה:
    CREATE DATABASE test;
    \connect test;
    CREATE TABLE replica_test (id SERIAL PRIMARY KEY, data text);
    INSERT INTO replica_test (data) VALUES ('apple'), ('banana'), ('cherry');
      
  3. אם אתם מאתחלים את מכונת הרפליקה החיצונית באמצעות קובץ שייצאתם מהמכונה הראשית, הורידו את הקובץ המיוצא מ-Cloud Storage. אם הרפליקה החיצונית נמצאת במכונה של Compute Engine, אפשר להוריד את הקובץ באמצעות הפקודה gcloud storage:
    gcloud storage cp gs://BUCKET_NAME/DUMP_FILE_NAME .
        
  4. מייבאים את הקובץ למסד הנתונים.
    psql --user=postgres --password < DUMP_FILE_NAME.
    
  5. מתקינים את pglogical בהתאם למערכת ההפעלה. לדוגמה, במערכות Debian שבהן פועלת גרסה 13 של PostgreSQL, sudo apt-get install postgresql-13-pglogical.
  6. מתחברים למסד הנתונים בתור replication_user ומגדירים את הפרמטרים הבאים:
    ALTER SYSTEM SET shared_preload_libraries = 'pglogical';
    ALTER SYSTEM SET max_replication_slots = #; (where # is the same as you set on the primary).
    ALTER SYSTEM SET max_worker_processes = #; (where # is the same as you set on the primary).
    # Logout of the database and restart it. For example,
    # sudo /etc/init.d/postgresql restart
    # Log back in the database as the replication_user.
    # Since the pglogical extension is created local to each database, you need to
    # execute CREATE EXTENSION pglogical in each database you create, so if you
    # haven't already done that:
    CREATE EXTENSION pglogical;
       

    For more information about these flags, see the PostgreSQL resources page.

  7. יוצרים צומת pglogical:
    SELECT pglogical.create_node(
      node_name := 'subscriber',
      dsn := 'host=REPLICA_PUBLIC_IP_ADDRESS port=5432 dbname=DATABASE_NAME user=REPLICATION_USER password=REPLICATION_USER_PASSWORD'
      );
      
  8. יוצרים מינוי pglogical:
    SELECT pglogical.create_subscription(
        subscription_name := 'SUBSCRIPTION_NAME',
        provider_dsn := 'host=PRIMARY_PUBLIC_IP_ADDRESS port=5432 dbname=DATABASE_NAME user=REPLICATION_USER password=REPLICATION_USER_PASSWORD'
    );
      
  9. בודקים את סטטוס המינוי:
    SELECT * FROM pglogical.show_subscription_status('SUBSCRIPTION_NAME');
       
  10. אם הסטטוס שמופיע הוא replicating, סימן שההגדרה הושלמה בלי שגיאות.
  11. מזינים נתונים במופע הראשי ובודקים את הרפליקה כדי לוודא שהנתונים מופיעים גם בה.

פתרון בעיות

פתרון בעיות ב-pglogical

המאמרים הבאים