בדף הזה מוסבר איך לאחזר פרטי משאבים של מאגרי נתונים ב-Gemini Enterprise והישויות הבסיסיות שלהם באמצעות מסוף Google Cloud או Discovery Engine API בארכיטקטורת REST.
כשאתם משתמשים בממשקי API כדי לבצע פעולות במאגרי נתונים – כמו הגדרת בקרות גישה של IAM ברמת המשאב, שליחת שאילתות לנקודות קצה (endpoints) של חיפוש או הגדרת צינורות עיבוד נתונים אוטומטיים להטמעה – אתם צריכים את המזהים הייחודיים של מאגרי הנתונים ושל הישויות שמרכיבות אותם.
מושגים שקשורים למאגרי נתונים
כדי להבין איך משאבי מאגר הנתונים בנויים ב-Discovery Engine API, כדאי להכיר את המושגים הבאים:
| קונספט | תיאור |
|---|---|
| מאגר נתונים |
מאגר לנתונים שנאספו מ-Google או ממקורות נתונים של צד שלישי. מאגרי נתונים עצמאיים שייכים לאוסף ברירת המחדל (default_collection). מידע נוסף זמין במאמרים מושגים ב-Gemini Enterprise ומידע על אפליקציות ומאגרי נתונים.
|
| איסוף נתונים |
משאב קיבוץ לוגי בתוך פרויקט ומיקום (projects/{project}/locations/{location}/collections/{collection}) ב- Google Cloud .
במאגרי נתונים של צד שלישי עם כמה ישויות (כמו Jira, Salesforce או SharePoint Online) נוצר אוסף ייעודי שמייצג את המכונה של מאגר הנתונים. |
| ישות של מאגר נתונים |
כשמחברים מקור נתונים של צד שלישי שמכיל כמה סוגי ישויות (כמו בעיות ב-Jira, פרויקטים ב-Jira או קבצים ב-SharePoint), Gemini Enterprise יוצר באופן אוטומטי מאגר נתונים נפרד לכל סוג ישות.
מאגרי הנתונים של הישויות האלה נמצאים כמשאבי צאצא ב- מידע נוסף זמין במאמרים נתונים מובְנים למאגרי נתונים של צד שלישי ומבוא למחברים ולמאגרי נתונים. |
אחזור פרטים של מאגר נתונים וישויות
בוחרים באחת מהאפשרויות הבאות:
המסוף
כדי לאחזר את הפרטים של מאגר הנתונים והישות במסוף Google Cloud :
במסוף Google Cloud , נכנסים לדף Gemini Enterprise > מאגרי נתונים.
לוחצים על השם של מאגר הנתונים הרצוי.
בדף הפרטים של מאגר הנתונים, בודקים את מזהה מאגר הנתונים שמופיע בכותרת.
אם מאגר הנתונים מכיל ישויות, לוחצים על הכרטיסייה Entities כדי לראות את רשימת הישויות שהוגדרו, השמות המוצגים ומזהי מאגר הנתונים של הישויות (לדוגמה,
DataConnector3_entityAו-DataConnector3_entityB).
REST
כדי לאחזר את המזהים של מאגר הנתונים והישות באמצעות ה-API בארכיטקטורת REST:
הצגת רשימה של מזהי אוספים של מאגרי נתונים (למאגרי נתונים עם כמה ישויות):
במאגרי נתונים של צד שלישי עם כמה ישויות (כמו Jira או Salesforce), Gemini Enterprise יוצר אוסף ייעודי שמייצג את מופע המחבר. שולחים קריאה לנקודת הקצה (endpoint) של הרשימה
collectionsכדי לאחזר את מזהי האוספים בפרויקט:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב-Google Cloud . -
ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
LOCATION: האזור של מאגר הנתונים:global,usאוeu.
התשובה מכילה את רשימת האוספים:
{ "collections": [ { "name": "projects/123456789/locations/global/collections/DataConnector3", "displayName": "Jira Production Data Store" } ] }בדוגמה הזו, מזהה הקולקציה הוא
DataConnector3. משתמשים במזהה הזה כשמגדירים בקרות גישה ברמת האוסף למופע של המחבר.-
מזהים של ישויות ושל מאגרי נתונים עצמאיים ברשימה בקטע
default_collection:ב-Gemini Enterprise, כל המשאבים של מאגרי הנתונים, כולל מאגרי נתונים עצמאיים וישויות צאצא של מחברים עם כמה ישויות, נמצאים ב-
default_collection. למרות שלמאגר נתונים עם כמה ישויות יש מזהה אוסף ייעודי (כמוDataConnector3), מאגרי הנתונים של הישויות הצאצא שלו רשומים ב-default_collectionעם קידומת של מזהה המחבר.קוראים לנקודת הקצה של הרשימה
dataStoresב-default_collectionכדי לאתר את מאגר הנתונים ואת מזהי הישויות:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב-Google Cloud . -
ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
LOCATION: האזור של מאגר הנתונים:global,usאוeu.
התשובה מכילה את רשימת מאגרי הנתונים:
{ "dataStores": [ { "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA", "displayName": "Jira Issues Entity" }, { "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB", "displayName": "Jira Projects Entity" } ] }בדוגמה הזו, המזהים של מאגרי הנתונים של הישויות הם
DataConnector3_entityAו-DataConnector3_entityB. אתם יכולים להשתמש במזהים האלה כשאתם מגדירים בקרות גישה לכל מאגרי הנתונים של הישויות הבסיסיות במאגר נתונים עם כמה ישויות באמצעות ה-API בארכיטקטורת REST.-
המאמרים הבאים
- הגדרת בקרת גישה פרטנית לאפליקציות ולמאגרי נתונים
- מאמרי העזרה של Discovery Engine API בארכיטקטורת REST