ניהול סכימות של מפתחות שורות

המסוף

כדי להגדיר סכימה של מפתח שורה באמצעות מסוף Google Cloud , פועלים לפי השלבים הבאים:

1. במסוף Google Cloud , פותחים את הדף Bigtable instances.

   כניסה לרשימת המקרים

2. בוחרים מופע מהרשימה.

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

   בחלונית Explorer מוצגת רשימה של טבלאות, תצוגות ושאילתות במופע.

4. ברשימה Tables, בשורה של הטבלה שרוצים ליצור עבורה סכימת מפתח שורה, לוחצים על התפריט more_vert View actions ואז על Create row key schema.

   נפתחת הכרטיסייה Row key schema.

5. ברשימה Encoding (קידוד), בוחרים סוג קידוד לסכימת מפתח השורה.

6. אם בחרתם באפשרות DelimitedBytes, בשדה Delimiter מזינים תו מפריד שמפריד בין הפלחים במפתחות השורות הקיימים. ערך ברירת המחדל הוא סולמית (#).

7. בשדה Segment, מזינים שם לפלח, כמו device_type.

8. ברשימה Type (סוג), בוחרים את סוג הנתונים של פלח מפתח השורה.

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

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

11. לוחצים על Save.

gcloud

כדי להגדיר סכימה של מפתח שורה באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud beta bigtable tables update עם קובץ YAML או JSON שמגדיר את הסכימה.

gcloud beta bigtable tables update TABLE_ID \
  --instance=INSTANCE_ID \
  --row-key-schema-definition-file=ROW_KEY_SCHEMA_DEFINITION_FILE \
  --row-key-schema-pre-encoded-bytes

מחליפים את מה שכתוב בשדות הבאים:

• ‫TABLE_ID: המזהה הייחודי של הטבלה שרוצים לעדכן
• ‫INSTANCE_ID: המזהה של המופע שבו נמצא הטבלה
• ‫ROW_KEY_SCHEMA_DEFINITION_FILE: הנתיב לקובץ YAML או JSON שמגדיר את הסכימה של מפתח השורה. דוגמאות לאופן שבו הקבצים האלה צריכים להיראות מופיעות במאמר דוגמאות לקובצי סכימה.

כברירת מחדל, קידוד Base64 מוחל על כל השדות הבינאריים בקובץ YAML או JSON, כמו encoding.delimitedBytes.delimiter עבור התו שמפריד בין מפתחות השורות. הדגל --row-key-schema-pre-encoded-bytes מציין ל-Bigtable ששדות בינאריים מקודדים בקובץ ואין לקודד אותם שוב.

המשך

משתמשים בפונקציה UpdateTableWithRowKeySchema כדי ליצור סכימת מפתח שורה לטבלה.

func (ac *AdminClient) UpdateTableWithRowKeySchema(ctx context.Context, tableID
string, rowKeySchema StructType) error

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

rks := StructType{
Fields: []StructField{
    {FieldName: "key1", FieldType: Int64Type{Encoding: Int64OrderedCodeBytesEncoding{}}},
    {FieldName: "key2", FieldType: StringType{Encoding: StringUtf8BytesEncoding{}}},
  },
  Encoding: StructDelimitedBytesEncoding{Delimiter: []byte{'#'}}}

err := c.UpdateTableWithRowKeySchema(context.Background(), "my-table", rks)

המסוף

כדי למחוק סכימת מפתח שורה של טבלה באמצעות מסוף Google Cloud :

1. במסוף Google Cloud , פותחים את הדף Bigtable instances.

   כניסה לרשימת המקרים

2. בוחרים מופע מהרשימה.

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

   בחלונית Explorer מוצגת רשימה של טבלאות, תצוגות ושאילתות במופע.

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

5. לוחצים על התפריט more_vert View actions (הצגת פעולות) בשורה של סכימת מפתח השורה שרוצים למחוק.

6. לוחצים על Delete.

gcloud

כדי למחוק את סכימת מפתח השורה של טבלה, משתמשים בפקודה gcloud beta bigtable tables update עם הדגל --clear-row-key-schema.

  gcloud beta bigtable tables update TABLE_NAME \
    --instance=INSTANCE_ID \
    --clear-row-key-schema

מחליפים את מה שכתוב בשדות הבאים:

• ‫TABLE_NAME: השם הייחודי של הטבלה שממנה רוצים למחוק את סכימת מפתח השורה
• ‫INSTANCE_ID: המזהה של המופע שבו נמצא הטבלה

המשך

השתמש בפונקציה UpdateTableRemoveRowKeySchema כדי לנקות את סכימת מפתח השורה עבור טבלה:

func (ac *AdminClient) UpdateTableRemoveRowKeySchema(ctx context.Context,
tableID string) error

המסוף

כדי לראות את סכמת מפתח השורה של טבלה באמצעות המסוף Google Cloud , מבצעים את השלבים הבאים:

1. במסוף Google Cloud , פותחים את הדף Bigtable instances.

   כניסה לרשימת המקרים

2. לוחצים על המופע שרוצים להציג את סכימת מפתח השורה של הטבלה שלו.

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

   בחלונית Explorer מוצגת רשימה של טבלאות, תצוגות ושאילתות במופע.

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

5. לוחצים על סכימת מפתח השורה.

   נפתחת הכרטיסייה 'פרטים'.

gcloud

כדי לראות את הסכימה של מפתח שורה, משתמשים בפקודה gcloud beta bigtable tables describe:

  gcloud bigtable tables describe TABLE_NAME \
    --instance=INSTANCE_ID

מחליפים את מה שכתוב בשדות הבאים:

• ‫TABLE_NAME: השם הייחודי של הטבלה שרוצים להציג את סכימת מפתח השורה שלה
• ‫INSTANCE_ID: המזהה של המופע שבו נמצא הטבלה

התגובה במסוף אמורה להיראות כך: אם לטבלה אין סכימת מפתח שורה, התגובה לא כוללת את הקטע rowKeySchema.

columnFamilies:
  cf: {}
createTime: '2025-05-28T17:25:39.433058Z'
granularity: MILLIS
name: projects/<project>/instances/<instance>/tables/<table>
rowKeySchema:
  encoding:
    delimitedBytes:
      delimiter: Iw==
  fields:
  - fieldName: <field_name_1>
    type:
      stringType:
        encoding:
          utf8Bytes: {}
  - fieldName: <field_name_2>
    type:
      intType:
        encoding:
          bigEndianBytes: {}
  - fieldName: <field_name_3>
    type:
      timestampType:
        encoding:
          unixMicrosInt64: {
              encoding: {
                  orderedCodeBytes: {}
              }
          }
updateTime: '2025-05-28T17:25:39.433058Z'

המשך

השדה RowKeySchema זמין כחלק מהאובייקט TableInfo, ואפשר לאחזר אותו באמצעות השיטה .TableInfo().

type TableInfo struct {
  ...
  RowKeySchema          *StructType
}

func (ac *AdminClient) TableInfo(ctx context.Context, table string) (*TableInfo, error)

YAML

fields:
  - fieldName: "user_id"
    type:
      stringType:
        encoding:
          utf8Bytes: {}
  - fieldName: "purchase_date"
    type:
      stringType:
        encoding:
          utf8Bytes: {}
  - fieldName: "order_number"
    type:
      stringType:
        encoding:
          utf8Bytes: {}
encoding:
  delimitedBytes:
    delimiter: "Iw=="

JSON

{
  "fields": [
    {
      "fieldName": "user_id",
      "type": {
        "stringType": {
          "encoding": {
            "utf8Bytes": {}
          }
        }
      }
    },
    {
      "fieldName": "purchase_date",
      "type": {
        "stringType": {
          "encoding": {
            "utf8Bytes": {}
          }
        }
      }
    },
    {
      "fieldName": "order_number",
      "type": {
        "stringType": {
          "encoding": {
            "utf8Bytes": {}
          }
        }
      }
    }
  ],
  "encoding": {
    "delimitedBytes": {
      "delimiter": "Iw=="
    }
  }
}