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

בקטע הזה מוסבר איך להגדיר את מכונת Cloud SQL כך שתתמוך באחסון, באינדוקס ובשאילתות של הטמעות וקטוריות.

מכונות של מהדורת Cloud SQL Enterprise ומהדורת Cloud SQL Enterprise Plus תומכות בהטמעות וקטוריות. כל הגרסאות של MySQL 8.0.36 ואילך נתמכות.

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

מוודאים שיש לכם את התפקידים Cloud SQL Admin ו-Compute Viewer בחשבון המשתמש.

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

הפעלת הדגל של מסד הנתונים להטמעות וקטוריות

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

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=FLAGS

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

  • ‫INSTANCE_NAME: השם של המכונה שרוצים להפעיל בה תמיכה בהטמעת וקטורים.

  • ‫FLAGS: מגדירים את הדגל הבא של MySQL במכונה:

    • ‫cloudsql_vector: מגדירים את הדגל הזה לערך on כדי להפעיל אחסון של הטמעת וקטורים ותמיכה בחיפוש דמיון וקטורי. ההגדרה של הדגל הזה מושבתת כברירת מחדל. כשמגדירים את הדגל, הפקודה אמורה להיראות כך:

      gcloud sql instances patch my-instance \
--database-flags=cloudsql_vector=on

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

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

השבתת הטמעות וקטורים

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

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

כדי להשבית את התמיכה בהטמעות וקטוריות, מגדירים את הדגל cloudsql_vector לערך off.

לדוגמה:

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=cloudsql_vector=off

מחליפים את INSTANCE_NAME בשם המכונה שבה רוצים להשבית את התמיכה בהטמעת וקטורים.

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