אפשר לעדכן את הנתונים המובְנים של הסכימה ואת הנתונים הלא מובְנים עם מטא-נתונים שתומכים בסכימה.
אפשר לעדכן את הסכימה במסוף Google Cloud או באמצעות ה-method schemas.patch ב-API.
כדי לעדכן את הסכימה, אתם יכולים להוסיף שדות חדשים, לשנות את ההערות של שדה שניתן להוסיף לאינדקס, לחפש ולאחזר, או לסמן שדה כמאפיין מפתח, כמו title, uri ו-description.
עדכון הסכימה
אפשר לעדכן את הסכימה במסוף Google Cloud או באמצעות ה-API.
המסוף
כדי לעדכן סכימה במסוף Google Cloud :
כדי לוודא שעדכון הסכימה תקין, עיינו בקטע דרישות ומגבלות.
אם אתם מעדכנים הערות של שדות (הגדרת שדות כניתנים להוספה לאינדקס, לאחזור, לסינון דינמי, לחיפוש או להשלמה), כדאי לעיין בקטע קביעת הגדרות של שדות כדי להבין את המגבלות והדרישות של כל סוג הערה.
מוודאים שהשלמתם את הטמעת הנתונים. אחרת, יכול להיות שהסכימה עדיין לא זמינה לעריכה.
נכנסים לדף Gemini Enterprise במסוף Google Cloud .
בתפריט הניווט, לוחצים על מאגרי נתונים.
בעמודה Name, לוחצים על מאגר הנתונים עם הסכימה שרוצים לעדכן.
לוחצים על הכרטיסייה Schema כדי לראות את הסכימה של הנתונים.
אם זו הפעם הראשונה שאתם עורכים את השדות, יכול להיות שהכרטיסייה הזו תהיה ריקה.
לוחצים על הכפתור עריכה.
עדכון הסכימה:
מיפוי מאפייני מפתח: בעמודה מאפייני מפתח של הסכימה, בוחרים מאפיין מפתח כדי למפות אליו שדה. לדוגמה, אם שדה בשם
detailsתמיד מכיל את התיאור של מסמך, ממפים את השדה הזה למאפיין המפתח Description.עדכון מספר המאפיינים (מתקדם): אתם יכולים לעדכן את ההגדרה הזו אם אתם משתמשים בהטמעות וקטורים בהתאמה אישית עם Gemini Enterprise. שימוש בהטמעות בהתאמה אישית במאמרי העזרה של Agent Search.
עדכון הערות בשדות: כדי לעדכן הערות בשדה, בוחרים או מבטלים את הבחירה בהגדרת ההערות של השדה. ההערות הזמינות הן Retrievable, Indexable, Dynamic Facetable, Searchable ו-Completable. בחלק מהגדרות השדות יש מגבלות. במאמר קביעת הגדרות של שדות מפורטים התיאורים והדרישות של כל סוג הערה.
הוספת שדה חדש: הוספת שדות חדשים לסכימה לפני ייבוא מסמכים חדשים עם השדות האלה יכולה לקצר את הזמן שנדרש ל-Gemini Enterprise להוסיף את הנתונים לאינדקס מחדש אחרי הייבוא.
לוחצים על הוספת שדות חדשים כדי להרחיב את הקטע הזה.
לוחצים על add_box Add node ומגדירים את השדה החדש.
כדי לציין מערך, מגדירים את מערך לערך כן. לדוגמה, כדי להוסיף מערך של מחרוזות, מגדירים את type לערך
stringואת Array לערךYes.
לוחצים על Save כדי להחיל את השינויים בסכימה.
שינוי הסכימה מפעיל הוספה מחדש לאינדקס. במאגרי נתונים גדולים, תהליך ההוספה מחדש לאינדקס יכול להימשך כמה שעות.
REST
כדי לעדכן את הסכימה באמצעות ה-API, פועלים לפי השלבים הבאים:
כדי לוודא שהשינויים בסכימה תקינים, עיינו בקטעים דרישות ומגבלות ודוגמאות למגבלות (REST בלבד).
כדי לעדכן את הסכימה של מאגרי נתונים לא מובְנים עם מטא-נתונים, דלגו לשלב 5 והפעילו את ה-method
schema.patch.אם אתם מעדכנים הערות של שדות (הגדרת שדות כניתנים להוספה לאינדקס, לאחזור, לסינון דינמי או לחיפוש), כדאי לעיין במאמר קביעת הגדרות של שדות כדי להבין את המגבלות והדרישות של כל סוג הערה.
אם אתם עורכים סכימה שזוהתה באופן אוטומטי, ודאו שהשלמתם את הטמעת הנתונים. אחרת, יכול להיות שהסכימה עדיין לא תהיה זמינה לעריכה.
מאתרים את מזהה מאגר הנתונים. אם כבר יש לכם את מזהה מאגר הנתונים, דלגו לשלב הבא.
במסוף Google Cloud , נכנסים לדף Gemini Enterprise ובתפריט הניווט לוחצים על מאגרי נתונים.
לוחצים על השם של מאגר הנתונים.
בדף Data של מאגר הנתונים, מאתרים את מזהה מאגר הנתונים.
משתמשים ב-method של ה-API schemas.patch כדי לספק את סכימת ה-JSON החדשה כאובייקט JSON.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/schemas/default_schema" \ -d '{ "structSchema": JSON_SCHEMA_OBJECT }'מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט. -
DATA_STORE_ID: המזהה של מאגר הנתונים.
JSON_SCHEMA_OBJECT: סכימת ה-JSON החדשה כאובייקט JSON. לדוגמה:{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "keyPropertyMapping": "title" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } }, "uri": { "type": "string", "keyPropertyMapping": "uri" } } }
-
אופציונלי: בודקים את הסכימה לפי ההליך הצגת הגדרת סכימה.
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C# הוראות ההגדרה במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise C# API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Go הוראות ההגדרה במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Go API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Java הוראות ההגדרה במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Java API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Python הוראות ההגדרה במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Python API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Ruby הוראות ההגדרה במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Ruby API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
דרישות ומגבלות
כשמעדכנים סכימה, חשוב לוודא שהסכימה החדשה תואמת לדורות קודמים של הסכימה שמעדכנים. כדי לעדכן סכימה עם סכימה חדשה שלא תואמת לדורות קודמים, צריך למחוק את כל המסמכים במאגר הנתונים, למחוק את הסכימה וליצור סכימה חדשה.
עדכון של סכימה מפעיל הוספה מחדש לאינדקס של כל המסמכים. הוספה מחדש של מאגר נתונים גדול לאינדקס יכולה להימשך כמה שעות או ימים.
עדכוני סכימה לא תומכים בפעולות הבאות:
- שינוי סוג השדה. אי אפשר לשנות את סוג השדה בעדכון סכימה, למעט חריג אחד: אפשר לשנות שדה מסוג
integerל-number. כל שינוי אחר, כמוintegerל-string, שדה יחיד למערך או עומק קינון שונה למערך קיים, נכשל עם השגיאהSchema update cannot alter the field type. Field type mismatch for field "FIELD_NAME". - הסרת שדה אחרי שמגדירים שדה, אי אפשר להסיר אותו. אתם יכולים להמשיך להוסיף שדות חדשים, אבל לא להסיר שדות קיימים. בקשה שמשמיטה שדה קיים נכשלת ומתקבלת השגיאה
Schema update doesn't support removing fields. Fields "FIELD_NAME" cannot be removed. - שינוי מיפויים אחרים של מאפייני מפתחות. אפשר להוסיף או להסיר את מיפויי המאפיינים של המקשים
title,description,uri,create_timeו-update_time. אי אפשר להעביר מיפוי של מאפיין מפתח משדה אחד לשדה אחר, ואי אפשר להוסיף מיפוי של מאפיין מפתח אחר לסכימה כל עוד מאגר הנתונים מכיל מסמכים.
דוגמאות למגבלות (REST בלבד)
בקטע הזה מוצגות דוגמאות לסוגים תקינים ולא תקינים של עדכוני סכימה. בדוגמאות האלה נעשה שימוש בסכימת ה-JSON הבאה:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"title": {
"type": "string"
},
"description": {
"type": "string",
"keyPropertyMapping": "description"
},
"categories": {
"type": "array",
"items": {
"type": "string",
"keyPropertyMapping": "category"
}
}
}
}
דוגמאות לעדכונים נתמכים
אפשר לבצע את העדכונים הבאים בסכימה לדוגמה.
הוספת שדה. בדוגמה הזו, השדה
properties.uriנוסף לסכימה.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string", "keyPropertyMapping": "description" }, "uri": { // Added field. This is supported. "type": "string", "keyPropertyMapping": "uri" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }הוספה או הסרה של הערות למאפייני מפתח של
title, descriptionאוuri. בדוגמה הזו, הערךkeyPropertyMappingנוסף לשדהtitle.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "keyPropertyMapping": "title" // Added "keyPropertyMapping". This is supported. }, "description": { "type": "string", "keyPropertyMapping": "description" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }
דוגמאות לעדכוני סכימה לא תקינים
העדכונים הבאים לסכימה לדוגמה לא נתמכים.
שינוי סוג השדה. בדוגמה הזו, סוג השדה
titleהשתנה ממחרוזת למספר. האפשרות הזו לא נתמכת.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "number" // Changed from string. Not allowed. }, "description": { "type": "string", "keyPropertyMapping": "description" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }הסרת שדה בדוגמה הזו, השדה
titleהוסר. האפשרות הזו לא נתמכת.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { // "title" is removed. Not allowed. "description": { "type": "string", "keyPropertyMapping": "description" }, "uri": { "type": "string", "keyPropertyMapping": "uri" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }