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

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

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

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

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

מידע נוסף על תפקידים והרשאות

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

כדי להפעיל תמיכה באחסון הטמעות וקטורים במסד הנתונים ב-Cloud SQL ל-MySQL בגרסה 8.4 וגרסאות קודמות, מפעילים את הדגל לניהול מסד הנתונים cloudsql_vector ב-MySQL.

אם אתם משתמשים ב-Cloud SQL ל-MySQL בגרסה 9.7 ואילך, הפעילו את הדגל לניהול מסד הנתונים cloudsql_vector כדי להוסיף תמיכה ביצירת אינדקסים של וקטורים ובביצוע חיפוש ANN.

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

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

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

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

    • cloudsql_vector: מגדירים את הדגל הזה לערך on כדי להפעיל את פונקציונליות החיפוש הווקטורי של Cloud SQL. הדגל הזה מושבת כברירת מחדל. כשמגדירים את הדגל, הפקודה נראית כך:

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

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

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

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

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

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

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

לדוגמה:

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

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

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