יצירה וניהול של קבוצות רשויות מוניציפאליות

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

יצירת קבוצת יישובים

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

אם יוצרים קבוצת מיקום בלי מדיניות אחסון מדורג, קבוצת המיקום מקבלת בירושה את מדיניות האחסון המדורג של קבוצת המיקום default. אם לא הגדרתם באופן ידני את מדיניות האחסון של קבוצת המיקומים default, מדיניות האחסון מוגדרת ל-SSD בלבד.

המסוף

  1. נכנסים לדף Instances של Spanner במסוףGoogle Cloud .

    מכונות

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

  3. בוחרים את מסד הנתונים שבו רוצים להשתמש באחסון מדורג.

  4. בתפריט הניווט, לוחצים על Spanner Studio.

  5. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  6. מזינים את הצהרת ה-DDL של CREATE LOCALITY GROUP באמצעות GoogleSQL או PostgreSQL.

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

    GoogleSQL 

    CREATE LOCALITY GROUP separate_storage;

    PostgreSQL 

    CREATE LOCALITY GROUP separate_storage;

    לדוגמה, אפשר להריץ את הפקודה הבאה כדי ליצור קבוצת מיקום, ssd_only, שמאחסנת נתונים באחסון SSD:

    GoogleSQL 

    CREATE LOCALITY GROUP ssd_only OPTIONS (storage='ssd');

    PostgreSQL 

    CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';

    לדוגמה, אפשר להריץ את הפקודה הבאה כדי ליצור קבוצת מיקום, hdd_only, שמאחסנת נתונים באחסון HDD:

    GoogleSQL 

    CREATE LOCALITY GROUP hdd_only OPTIONS (storage='hdd');

    PostgreSQL 

    CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';

  7. לוחצים על Run.

gcloud

כדי ליצור קבוצת מיקומים באמצעות הפקודה של Google Cloud CLI, משתמשים ב-gcloud spanner databases ddl update.

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

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP separate_storage"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP separate_storage"

לדוגמה, אפשר להריץ את הפקודה הבאה כדי ליצור קבוצת מיקום, ssd_only, שמאחסנת נתונים ב-SSD:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP ssd_only OPTIONS (storage='ssd')"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP ssd_only STORAGE 'ssd'"

לדוגמה, אפשר להריץ את הפקודה הבאה כדי ליצור קבוצת מיקום, hdd_only, שמאחסנת נתונים באחסון HDD:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP hdd_only OPTIONS (storage='hdd')"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP hdd_only STORAGE 'hdd'"

יצירת מדיניות מבוססת-גיל לקבוצת מיקומים

בקבוצת מיקומים עם מדיניות שמבוססת על גיל, הנתונים החדשים יותר נשמרים באחסון SSD למשך זמן מסוים. הזמן הזה הוא יחסי לחותמת הזמן של השמירה של הנתונים. אחרי שחולף הזמן שצוין, Spanner מעביר את הנתונים לאחסון ב-HDD במהלך מחזור הדחיסה הרגיל שלו, שבדרך כלל מתרחש במהלך שבעה ימים מהזמן שצוין. כשמשתמשים במדיניות אחסון מדורגת שמבוססת על גיל, משך הזמן המינימלי שבו הנתונים צריכים להיות מאוחסנים ב-SSD לפני שהם מועברים לאחסון ב-HDD הוא שעה אחת.

כדי ליצור קבוצת מיקומים מבוססת-גיל, משתמשים בהצהרת ה-DDL‏ CREATE LOCALITY GROUP.

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של CREATE LOCALITY GROUP באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרת ה-DDL הבאה יוצרת קבוצת מיקום, spill_to_hdd, שמאחסנת נתונים באחסון SSD ב-10 הימים הראשונים, ואז מעבירה נתונים ישנים יותר לאחסון HDD במהלך מחזור הדחיסה הרגיל:

    GoogleSQL 

    CREATE LOCALITY GROUP spill_to_hdd
OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');

    PostgreSQL 

    CREATE LOCALITY GROUP spill_to_hdd
STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';

  3. לוחצים על Run.

gcloud

כדי ליצור קבוצת מיקום לפי גיל באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרת ה-DDL הבאה יוצרת קבוצת מיקום spill_to_hdd שמאחסנת נתונים ב-SSD במשך 10 הימים הראשונים, ואז מעבירה נתונים ישנים יותר ל-HDD במהלך מחזור הדחיסה הרגיל.

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP spill_to_hdd OPTIONS (storage='ssd', ssd_to_hdd_spill_timespan='10d')"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP spill_to_hdd STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d'"

הגדרת מדיניות אחסון מדורגת לנתונים

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

אם יוצרים קבוצת מיקום בלי מדיניות אחסון מדורג, קבוצת המיקום מקבלת בירושה את מדיניות האחסון המדורג של קבוצת המיקום default. אם לא הגדרתם ידנית את מדיניות האחסון של קבוצת המיקום default, מדיניות האחסון מוגדרת ל-SSD בלבד.

הגדרת קבוצת מיקום ברמת מסד הנתונים

מדיניות ברירת המחדל של אחסון בשכבות היא שכל הנתונים מאוחסנים ב-SSD. כדי לשנות את מדיניות האחסון השכבתי ברמת מסד הנתונים, משנים את קבוצת המיקום default. במסדי נתונים עם ניב GoogleSQL, הצהרת ה-DDL של ALTER LOCALITY GROUP צריכה לכלול את default בתוך מירכאות אחוריות (`default`). צריך לכלול את המירכאות האחוריות רק לקבוצת המיקום default.

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של ALTER LOCALITY GROUP באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות משנות את קבוצת המיקום default כדי להשתמש במדיניות אחסון מדורגת שמבוססת על גיל. כל הנתונים במסד הנתונים מועברים לאחסון HDD אחרי 10 ימים.

    GoogleSQL 

    ALTER LOCALITY GROUP `default` SET OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');

    PostgreSQL 

    ALTER LOCALITY GROUP "default" STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';

  3. לוחצים על Run.

gcloud

כדי לשנות את מדיניות האחסון השכבתי של קבוצת המיקום default באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות משנות את קבוצת המיקום default כדי להשתמש במדיניות אחסון מדורגת שמבוססת על גיל. כל הנתונים במסד הנתונים מועברים לאחסון HDD אחרי 10 ימים.

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP \`default\` SET OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP \"default\" STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';"

הגדרת קבוצת מיקומים ברמת הטבלה

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של CREATE TABLE באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלה, Singers, שמשתמשת בקבוצת המיקום ssd_only:

    GoogleSQL 

    CREATE TABLE Singers (
  SingerId   INT64 NOT NULL,
  FirstName  STRING(1024),
  LastName   STRING(1024),
  SingerInfo BYTES(MAX)
) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');

    PostgreSQL 

    CREATE TABLE Singers (
  SingerId   bigint PRIMARY KEY,
  FirstName  varchar(1024),
  LastName   varchar(1024),
  SingerInfo bytea
) LOCALITY GROUP ssd_only;

  3. לוחצים על Run.

gcloud

כדי להגדיר מדיניות אחסון מדורג ברמת הטבלה באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלה, Singers, שמשתמשת בקבוצת המיקום ssd_only.

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( SingerId   INT64 NOT NULL, \
        FirstName  STRING(1024), \
        LastName   STRING(1024), \
        SingerInfo BYTES(MAX) \
        ) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( \
        SingerId bigint PRIMARY KEY, \
        FirstName  varchar(1024), \
        LastName   varchar(1024), \
        SingerInfo bytea \
        ) LOCALITY GROUP ssd_only;"

הגדרת מדיניות אחסון מדורגת לשינוי ברמת העמודה

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של CREATE TABLE עם מדיניות אחסון מדורגת ברמת העמודה, באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלת Singers שמשתמשת בקבוצת המיקום ssd_only. עם זאת, העמודה Awards מבטלת את קבוצת המיקום ברמת הטבלה ומשתמשת בקבוצת המיקום spill_to_hdd כמדיניות האחסון שלה:

    GoogleSQL 

    CREATE TABLE Singers (
  SingerId   INT64 NOT NULL,
  FirstName  STRING(1024),
  LastName   STRING(1024),
  Awards     ARRAY<STRING(MAX)> OPTIONS (locality_group = 'spill_to_hdd')
) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');

    PostgreSQL 

    CREATE TABLE Singers (
  SingerId   bigint PRIMARY KEY,
  FirstName  varchar(1024),
  LastName   varchar(1024),
  Awards     varchar[] LOCALITY GROUP spill_to_hdd
) LOCALITY GROUP ssd_only;

  3. לוחצים על Run.

gcloud

כדי להגדיר מדיניות אחסון מדורגת ברמת העמודה באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלת Singers שמשתמשת בקבוצת המיקום ssd_only. עם זאת, העמודה Awards מבטלת את מדיניות האחסון ברמות השונות ברמת הטבלה, ומשתמשת בקבוצת המיקום spill_to_hdd כמדיניות האחסון ברמות השונות:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( \
      SingerId   INT64 NOT NULL, \
      FirstName  STRING(1024), \
      LastName   STRING(1024), \
      Awards     ARRAY<STRING(MAX)> OPTIONS (locality_group = 'spill_to_hdd') \
    ) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');" \

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( \
      SingerId   bigint PRIMARY KEY, \
      FirstName  varchar(1024), \
      LastName   varchar(1024), \
      Awards     varchar[] LOCALITY GROUP spill_to_hdd \
    ) LOCALITY GROUP ssd_only;"

הגדרת מדיניות אחסון מדורגת ברמת האינדקס המשני

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של CREATE INDEX עם מדיניות אחסון מדורגת ברמת אינדקס משני, באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלת Singers שמשתמשת בקבוצת המיקום ssd_only. במסד הנתונים יש גם אינדקס משני של כל Singers במסד הנתונים לפי השם הפרטי ושם המשפחה שלהם. האינדקס SingersByFirstLastName מבטל את מדיניות האחסון לפי רמות ברמת הטבלה, ומשתמש בקבוצת המיקום spill_to_hdd כמדיניות האחסון לפי רמות:

    GoogleSQL 

    CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName)
OPTIONS (locality_group = 'spill_to_hdd');

    PostgreSQL 

    CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName)
LOCALITY GROUP spill_to_hdd;

  3. לוחצים על Run.

gcloud

כדי להגדיר מדיניות משנית של אחסון מדורג ברמת האינדקס באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלת Singers שמשתמשת בקבוצת המיקום ssd_only. במסד הנתונים נוצר גם אינדקס משני לכל Singers במסד הנתונים לפי השם הפרטי ושם המשפחה. האינדקס SingersByFirstLastName מבטל את מדיניות האחסון לפי רמות ברמת הטבלה, ומשתמש בקבוצת המיקום spill_to_hdd כמדיניות האחסון לפי רמות:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName) \
    OPTIONS (locality_group = 'spill_to_hdd');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName) \
    LOCALITY GROUP spill_to_hdd;"

הגדרת קבוצת מיקומים ברמת העמודה

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של CREATE TABLE שמקצה את העמודה לקבוצת מיקום באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלת Songs עם עמודת LyricsCompressed שמאוחסנת בנפרד בקבוצת המיקום hdd_only:

    GoogleSQL 

    CREATE TABLE Songs (
  SingerId INT64 NOT NULL,
  SongId INT64 NOT NULL,
  Title STRING(MAX),
  Description STRING(MAX),
  LyricsCompressed BYTES(MAX) OPTIONS (locality_group = 'hdd_only')
) PRIMARY KEY (SingerId, SongId),
  INTERLEAVE IN PARENT Singers ON DELETE CASCADE,
  OPTIONS (locality_group = 'ssd_only');

    PostgreSQL 

    CREATE TABLE Songs (
  SingerId BIGINT NOT NULL,
  SongId BIGINT NOT NULL,
  Title VARCHAR,
  Description TEXT,
  LyricsCompressed BYTEA LOCALITY GROUP hdd_only,
  PRIMARY KEY (SingerId, SongId)
) LOCALITY GROUP ssd_only INTERLEAVE IN PARENT Singers ON DELETE CASCADE;

  3. לוחצים על Run.

gcloud

כדי להגדיר קבוצת מיקום ברמת העמודה לנתונים באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות יוצרות טבלת Songs עם עמודת LyricsCompressed שמאוחסנת בנפרד בקבוצת המיקומים hdd_only:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Songs ( \
      SingerId INT64 NOT NULL, \
      SongId INT64 NOT NULL, \
      Title STRING(MAX), \
      Description STRING(MAX),
      LyricsCompressed BYTES(MAX) OPTIONS (locality_group = 'hdd_only') \
    ) PRIMARY KEY (SingerId, SongId), \
      INTERLEAVE IN PARENT Singers ON DELETE CASCADE, \
      OPTIONS (locality_group = 'ssd_only');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Songs ( \
      SingerId BIGINT NOT NULL, \
      SongId BIGINT NOT NULL, \
      Title VARCHAR, \
      Description TEXT, \
      LyricsCompressed BYTEA LOCALITY GROUP hdd_only, \
      PRIMARY KEY (SingerId, SongId) \
    ) LOCALITY GROUP ssd_only INTERLEAVE IN PARENT Singers ON DELETE CASCADE;

העברת נתונים בין אפשרויות אחסון

אפשר להעביר נתונים בין אחסון SSD לאחסון HDD. העברת הנתונים יכולה להימשך עד שבעה ימים. כדי להעביר נתונים בין SSD ל-HDD מהר יותר, אפשר להפעיל דחיסה משמעותית באופן ידני. כדי לעקוב אחרי התקדמות ההעברה, אתם יכולים לשלוח שאילתה לטבלה המובנית SPANNER_SYS.TABLE_SIZES_STATS_1HOUR ולבדוק את נפח האחסון הנדרש של HDD ו-SSD בכל טבלה במסד הנתונים. אתם יכולים גם לעקוב אחרי נפח אחסון נדרש באמצעות המדד spanner.googleapis.com/instance/storage/used_bytes של Cloud Monitoring, כדי להציג את הפירוט של SSD ו-HDD במסד הנתונים או במכונה. מידע נוסף זמין במאמר ניטור של אחסון מדורג.

העברת נתונים מאחסון SSD לאחסון HDD

כדי להעביר נתונים מאחסון SSD לאחסון HDD, אתם יכולים ליצור קבוצת מיקום חדשה עם מדיניות אחסון מדורג לפי גיל, או לשנות את מדיניות האחסון המדורג של קבוצת מיקום קיימת. ‫Spanner מעביר נתונים במהלך מחזור הדחיסה הרגיל שלו, שבדרך כלל מתרחש במשך שבעה ימים. אם אתם טוענים נתונים ומעדכנים את קבוצת המיקומים באמצעות אחת מהצהרות ה-DDL הבאות של ALTER, אתם צריכים להמתין עד שבעה ימים עד שהשינוי בקבוצת המיקומים יושלם:

GoogleSQL

  • ALTER TABLE ... SET OPTIONS (locality_group = '')
  • ALTER TABLE ... ALTER COLUMN ... SET OPTIONS (locality_group = '')
  • ALTER INDEX ... SET OPTIONS (locality_group = '')

PostgreSQL

  • ALTER TABLE ... SET LOCALITY GROUP ...
  • ALTER TABLE ... ALTER COLUMN ... SET LOCALITY GROUP ...
  • ALTER INDEX ... SET LOCALITY GROUP ...

תקופת ההמתנה לא רלוונטית אם יוצרים טבלה, עמודה או אינדקס חדשים, ומוסיפים את קבוצת המיקום כחלק מהתחביר של CREATE או ADD COLUMN.

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

העברת נתונים מאחסון HDD לאחסון SSD

כדי להעביר נתונים מאחסון HDD לאחסון SSD, אתם יכולים לשנות את אפשרות האחסון של קבוצת מיקום קיימת או לשנות את קבוצת המיקום שבה הטבלה משתמשת. ‫Spanner מעביר נתונים במהלך מחזור הדחיסה הרגיל שלו, שבדרך כלל מתרחש במשך שבעה ימים. אם אתם טוענים נתונים ומעדכנים את קבוצת המיקומים באמצעות אחת מהצהרות ה-DDL הבאות של ALTER, אתם צריכים להמתין עד שבעה ימים עד שהשינוי בקבוצת המיקומים יושלם:

GoogleSQL

  • ALTER TABLE ... SET OPTIONS (locality_group = '')
  • ALTER TABLE ... ALTER COLUMN ... SET OPTIONS (locality_group = '')
  • ALTER INDEX ... SET OPTIONS (locality_group = '')

PostgreSQL

  • ALTER TABLE ... SET LOCALITY GROUP ...
  • ALTER TABLE ... ALTER COLUMN ... SET LOCALITY GROUP ...
  • ALTER INDEX ... SET LOCALITY GROUP ...

תקופת ההמתנה לא רלוונטית אם יוצרים טבלה, עמודה או אינדקס חדשים, ומוסיפים את קבוצת המיקום כחלק מהתחביר של CREATE או ADD COLUMN.

שינוי קבוצת המיקומים שמשמשת טבלה

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של ALTER TABLE שמשנה את קבוצת המיקום שמשמשת את הטבלה באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות משנות את קבוצת המיקום שמשמשת את הטבלה Singers ל-spill_to_hdd:

    GoogleSQL 

    ALTER TABLE Singers SET OPTIONS (locality_group = 'spill_to_hdd');

    PostgreSQL 

    ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;

  3. לוחצים על Run.

gcloud

כדי לשנות את קבוצת המיקום שמשמשת טבלה באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות משנות את קבוצת המיקום שמשמשת את הטבלה, Singers, ל-spill_to_hdd:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers SET OPTIONS(locality_group = 'spill_to_hdd');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;"

שינוי קבוצת המיקום שמשמשת עמודה בטבלה

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של ALTER TABLE שמשנה את קבוצת המיקום שמשמשת את הטבלה באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות משנות את קבוצת הלוקליות שמשמשת את העמודה LastName בטבלה ל-spill_to_hdd:

    GoogleSQL 

    ALTER TABLE Singers
ALTER COLUMN LastName SET OPTIONS(locality_group = 'spill_to_hdd');

    PostgreSQL 

    ALTER TABLE Singers
ALTER COLUMN LastName SET LOCALITY GROUP spill_to_hdd;

  3. לוחצים על Run.

gcloud

כדי לשנות את קבוצת המיקום שמשמשת טבלה באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות משנות את קבוצת הלוקליות שמשמשת את העמודה LastName בטבלה ל-spill_to_hdd:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers ALTER COLUMN LastName SET OPTIONS(locality_group = 'spill_to_hdd');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers ALTER COLUMN SET LOCALITY GROUP spill_to_hdd;"

שינוי קבוצת יישובים

כדי לשנות קבוצת מיקום, אפשר לשנות את אפשרות האחסון שלה או לשנות את המדיניות שלה שמבוססת על גיל. ‫Spanner מעביר נתונים במהלך מחזור הדחיסה הרגיל שלו, שבדרך כלל מתרחש במשך שבעה ימים. אם אתם טוענים נתונים ומעדכנים את קבוצת המיקומים הגיאוגרפיים באמצעות ALTER LOCALITY GROUP, אתם צריכים להמתין עד שבעה ימים להעברת הנתונים הקיימים. ההגדרה המעודכנת חלה באופן מיידי על כל הנתונים החדשים שנכתבים בקבוצת המיקומים הזו.

שינוי אפשרות האחסון

אתם יכולים לשנות את אפשרות האחסון של קבוצת מיקומים מ-SSD ל-HDD או מ-HDD ל-SSD.

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של ALTER LOCALITY GROUP באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות משנות את אפשרות האחסון של קבוצת המיקום separate_storage ל-HDD:

    GoogleSQL 

    ALTER LOCALITY GROUP separate_storage SET OPTIONS (storage='hdd');

    PostgreSQL 

    ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';

  3. לוחצים על Run.

gcloud

כדי לשנות את אפשרות האחסון של קבוצת מיקומים באמצעות פקודת ה-CLI של gcloud, משתמשים בפקודה gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות משנות את אפשרות האחסון של קבוצת המיקום separate_storage ל-HDD:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP separate_storage SET OPTIONS (storage = 'hdd');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';"

שינוי המדיניות מבוססת הגיל

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של ALTER LOCALITY GROUP באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, הצהרות ה-DDL הבאות משנות את המדיניות מבוססת הגיל של קבוצת המיקום spill_to_hdd, על ידי הארכת משך הזמן שבו הנתונים מאוחסנים ב-SSD ל-20 ימים:

    GoogleSQL 

    ALTER LOCALITY GROUP spill_to_hdd SET OPTIONS (ssd_to_hdd_spill_timespan = '20d');

    PostgreSQL 

    ALTER LOCALITY GROUP spill_to_hdd SSD_TO_HDD_SPILL_TIMESPAN '20d';

  3. לוחצים על Run.

gcloud

כדי לשנות את המדיניות מבוססת-הגיל של קבוצת מיקומים באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

לדוגמה, הצהרות ה-DDL הבאות משנות את המדיניות מבוססת הגיל של קבוצת המיקום spill_to_hdd, על ידי הארכת משך הזמן שבו הנתונים מאוחסנים ב-SSD ל-20 ימים:

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP spill_to_hdd SET OPTIONS (ssd_to_hdd_spill_timespan = '20d');"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP spill_to_hdd SSD_TO_HDD_SPILL_TIMESPAN '20d';"

מחיקת קבוצת יישובים

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

המסוף

  1. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.

  2. מזינים את הצהרת ה-DDL של DROP LOCALITY GROUP באמצעות GoogleSQL או PostgreSQL.

    לדוגמה, אפשר להריץ את הפקודה הבאה כדי להסיר קבוצת מיקום ssd_only:

    GoogleSQL 

    DROP LOCALITY GROUP ssd_only;

    PostgreSQL 

    DROP LOCALITY GROUP ssd_only;

  3. לוחצים על Run.

gcloud

כדי להסיר קבוצת מיקומים באמצעות פקודת ה-CLI של gcloud, משתמשים ב-gcloud spanner databases ddl update.

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

GoogleSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="DROP LOCALITY GROUP ssd_only"

PostgreSQL 

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="DROP LOCALITY GROUP ssd_only"

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