התקנה של AlloyDB AI ב-AlloyDB Omni

בוחרים גרסה של מאמר העזרה: 16.8.0

• הגרסה הנוכחית (17.5.0)
• 17.5.0
• 16.9.0
• 16.8.0
• 16.3.0
• 15.13.0
• 15.12.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

בדף הזה מוסבר איך להתקין את AlloyDB Omni ולשלב את AlloyDB AI.

‫AlloyDB AI היא חבילת תכונות שכלולה ב-AlloyDB Omni ומאפשרת לכם ליצור אפליקציות AI גנרטיביות לארגונים. מידע נוסף על הפונקציונליות של AI/ML ב-AlloyDB זמין במאמר פיתוח אפליקציות AI גנרטיבי.

‫AlloyDB Omni עם AlloyDB AI מאפשר לכם להריץ שאילתות על מודלים מרוחקים של למידת מכונה כדי לעבוד עם חיזויים אונליין ועם הטמעות טקסט שנוצרו ממודלים של למידת מכונה. בנוסף, אפשר להשתמש ב-AlloyDB Omni עם AlloyDB AI כדי לעבד הטמעות של וקטורים מתוכן אחר, כמו תמונה, למשל אם משתמשים בממשק google_ml.predict_row ומבצעים את התרגום בעצמכם בשאילתה.

הגדרת מכונת AlloyDB Omni לביצוע שאילתות במודלים מרוחקים

‫AlloyDB Omni יכול לשלוח שאילתות למודלים של ML מרחוק באמצעות התוסף google_ml_integration.

אם רוצים לשלוח שאילתות למודלים של Vertex AI, צריך להגדיר את חשבון השירות של AlloyDB Omni עם Vertex AI לפני שמתקינים את AlloyDB Omni.

כדי להגדיר את AlloyDB Omni לשליחת שאילתות למודלים מרוחקים, מבצעים את השלבים הבאים:

1. יוצרים חשבון שירות עם Google Cloud.

2. יוצרים מפתח לחשבון שירות בפורמט JSON ומורידים אותו. חשוב לשמור את מפתח חשבון השירות כי תצטרכו להשתמש בו בהמשך התהליך.

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

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

3. מעתיקים את מפתח חשבון השירות שיצרתם אל KEY_PATH. נתיב המפתח צריך להיות נתיב במארח שלכם שאפשר לגשת אליו, והוא בבעלות המשתמש שיפעיל את קונטיינר AlloyDB Omni.

4. מפעילים את Vertex AI API ב Google Cloud פרויקט.

   gcloud services enable aiplatform.googleapis.com
   

5. מוסיפים הרשאות ניהול זהויות והרשאות גישה (IAM) ב-Vertex AI לפרויקט ולחשבון השירות המתאימים.

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member="serviceAccount:SERVICE_ACCOUNT_ID" \
       --role="roles/aiplatform.user"
   

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

   • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

   • ‫SERVICE_ACCOUNT_ID: המזהה של חשבון השירות שיצרתם בשלב הראשון. האיסור הזה כולל את הסיומת המלאה @PROJECT_ID.iam.gserviceaccount.com. לדוגמה: [e-mail].

הגדרת AlloyDB AI ל-AlloyDB Omni

כדי להתקין את AlloyDB Omni ולשלב את AlloyDB AI, צריך לבצע את השלבים הבאים כמשתמש root:

1. צריך להשלים את כל השלבים שמפורטים במאמר בנושא הגדרת AlloyDB Omni לשליחת שאילתות למודלים מבוססי-ענן.

2. אם קיים מאגר תגים בשם זהה, צריך לעצור אותו ולהסיר אותו.

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

   Docker

   docker stop CONTAINER_NAME
   docker rm CONTAINER_NAME

   Docker

   docker stop CONTAINER_NAME
   docker rm CONTAINER_NAME

   Podman

   podman stop CONTAINER_NAME
   podman rm CONTAINER_NAME

   Podman

   podman stop CONTAINER_NAME
   podman rm CONTAINER_NAME

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

   • ‫CONTAINER_NAME: השם שיוקצה למאגר AlloyDB Omni במאגר התמונות של המארח. לדוגמה, my-omni-1.

3. מתחילים קונטיינר חדש של AlloyDB Omni ומצמידים את המפתח לקונטיינר.

   Docker

   docker run -d --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   -v DATA_DIR:/var/lib/postgresql/data \
   -v "KEY_PATH":/etc/postgresql/private-key.json \
   -p HOST_PORT:5432 \
   --restart=always \
   google/alloydbomni:latest
   

   Docker

   docker run -d --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   -v DATA_DIR:/var/lib/postgresql/data \
   -v "KEY_PATH":/etc/postgresql/private-key.json \
   -p HOST_PORT:5432 \
   --restart=always \
   google/alloydbomni:latest
   

   Podman

   podman run -d --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   -v DATA_DIR:/var/lib/postgresql/data \
   -v "KEY_PATH":/etc/postgresql/private-key.json \
   -p HOST_PORT:5432 \
   --restart=always \
   docker.io/google/alloydbomni:latest
   

   Podman

   podman run -d --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   -v DATA_DIR:/var/lib/postgresql/data \
   -v "KEY_PATH":/etc/postgresql/private-key.json \
   -p HOST_PORT:5432 \
   --restart=always \
   docker.io/google/alloydbomni:latest
   

   מחליפים את המשתנים הבאים:

   • ‫CONTAINER_NAME: השם שיוקצה למאגר AlloyDB Omni במאגר התמונות של המארח. לדוגמה, my-omni-1.
   • ‫NEW_PASSWORD: הסיסמה שמוקצית למשתמש postgres של מאגר התגים החדש אחרי שהוא נוצר. שימו לב שNEW_PASSWORD תגדיר סיסמה חדשה רק אם DATA_DIR הוא מיקום חדש.
   • ‫DATA_DIR: הנתיב לספריית המארח שבה הנתונים מאוחסנים.
   • ‫KEY_PATH: הנתיב לקובץ המפתח של חשבון השירות.
   • ‫HOST_PORT: יציאת TCP במחשב המארח שאליה הקונטיינר צריך לפרסם את היציאה שלו 5432. כדי להשתמש ביציאת ברירת המחדל של PostgreSQL במחשב המארח, מציינים 5432.

4. הופכים את קובץ המפתח לקריא על ידי המשתמש postgres בתוך קונטיינר AlloyDB Omni.

   Docker

   docker exec CONTAINER_NAME chown postgres /etc/postgresql/private-key.json
   docker exec CONTAINER_NAME chmod 600 /etc/postgresql/private-key.json

   Docker

   docker exec CONTAINER_NAME chown postgres /etc/postgresql/private-key.json
   docker exec CONTAINER_NAME chmod 600 /etc/postgresql/private-key.json

   Podman

   podman exec CONTAINER_NAME chown postgres /etc/postgresql/private-key.json
   podman exec CONTAINER_NAME chmod 600 /etc/postgresql/private-key.json

   Podman

   podman exec CONTAINER_NAME chown postgres /etc/postgresql/private-key.json
   podman exec CONTAINER_NAME chmod 600 /etc/postgresql/private-key.json

   מחליפים את המשתנים הבאים:

   • ‫CONTAINER_NAME: השם שיוקצה למאגר AlloyDB Omni במאגר התמונות של המארח. לדוגמה, my-omni-1.
   • ‫KEY_PATH: הנתיב למארח של קובץ המפתח של חשבון השירות.

5. מעדכנים את AlloyDB Omni על ידי הוספת אפשרויות ההגדרה הבאות.

   Docker

   docker exec CONTAINER_NAME sh -c "cat << EOF >> /var/lib/postgresql/data/postgresql.conf
   omni_enable_ml_agent_process = 'on'
   omni_google_cloud_private_key_file_path = '/etc/postgresql/private-key.json'
   EOF"
   

   Docker

   docker exec CONTAINER_NAME sh -c "cat << EOF >> /var/lib/postgresql/data/postgresql.conf
   omni_enable_ml_agent_process = 'on'
   omni_google_cloud_private_key_file_path = '/etc/postgresql/private-key.json'
   EOF"
   

   Podman

   podman exec CONTAINER_NAME sh -c "cat << EOF >> /var/lib/postgresql/data/postgresql.conf
   omni_enable_ml_agent_process = 'on'
   omni_google_cloud_private_key_file_path = '/etc/postgresql/private-key.json'
   EOF"
   

   Podman

   podman exec CONTAINER_NAME sh -c "cat << EOF >> /var/lib/postgresql/data/postgresql.conf
   omni_enable_ml_agent_process = 'on'
   omni_google_cloud_private_key_file_path = '/etc/postgresql/private-key.json'
   EOF"
   

   מחליפים את המשתנים הבאים:

   • ‫CONTAINER_NAME: השם שיוקצה למאגר AlloyDB Omni במאגר התמונות של המארח. לדוגמה, my-omni-1.

6. מפעילים מחדש את קונטיינר AlloyDB Omni.

   Docker

   docker restart CONTAINER_NAME
   

   Docker

   docker restart CONTAINER_NAME
   

   Podman

   podman restart CONTAINER_NAME
   

   Podman

   podman restart CONTAINER_NAME
   

   מחליפים את המשתנה הבא:

   • ‫CONTAINER_NAME: השם שיוקצה למאגר AlloyDB Omni במאגר התמונות של המארח. לדוגמה, my-omni-1.

חיבור באמצעות psql בקונטיינרים

כדי להתחבר לשרת מסד הנתונים של AlloyDB Omni באמצעות עותק משלו של psql שמופעל בתוך קונטיינר, מריצים את הפקודה הבאה:

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

מחליפים את המשתנה הבא:

• ‫CONTAINER_NAME: השם שיוקצה למאגר AlloyDB Omni במאגר התמונות של המארח. לדוגמה, my-omni-1.

אימות של AlloyDB Omni באמצעות התקנה של AlloyDB AI

כדי לוודא שההתקנה בוצעה בהצלחה ושהיא משתמשת בחיזוי של המודל, מזינים את הפקודה הבאה:

CREATE EXTENSION IF NOT EXISTS google_ml_integration CASCADE;

SELECT array_dims(embedding('text-embedding-005', 'AlloyDB AI')::real[]);

הפלט אמור להיראות כך:

array_dims
------------
[1:768]
(1 row) 

הערה: התמיכה במודלים של Vertex AI כפופה להנחיות בנושא ניהול גרסאות ומחזור חיים של מודלים ב-Vertex AI. מידע נוסף על גרסאות יציבות זמין במאמר גרסאות של מודלים ומחזור החיים שלהן.

בשילוב עם השאילתה הקודמת, הקריאה embedding() יוצרת הטמעות לטקסט הקלט AlloyDB AI. ‫array_dims מחזירה את המימדים של המערך שמוחזר על ידי embedding(). מכיוון שהמודל text-embedding-005 מחזיר פלט עם 768 מימדים, הפלט הוא [768].

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

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