התקנה של AlloyDB Omni עם AlloyDB AI

בוחרים גרסה של התיעוד:

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

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

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

בהתאם למיקום שבו רוצים להתקין את AlloyDB Omni עם AlloyDB AI, בוחרים באחת מהאפשרויות הבאות:

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

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

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

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

  3. מאחסנים את המפתח במיקום קבוע במערכת הקבצים. הוא נמצא במיקום הזה למשך כל חיי השרת שלכם ב-AlloyDB Omni.

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

  4. מוסיפים הרשאות ניהול זהויות והרשאות גישה (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, למשל my-service@my-project.iam.gserviceaccount.com.

התקנה של AlloyDB Omni עם AlloyDB AI

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

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

  2. יוצרים עותק מקומי של קובץ התצורה שמוגדר כברירת מחדל ב-AlloyDB Omni:

    Docker 

       docker run -i --rm google/alloydbomni:15.5.5 cat /usr/share/postgresql/postgresql.conf.sample > my-postgres.conf

    Podman 

       podman run -i --rm google/alloydbomni:15.5.5 cat /usr/share/postgresql/postgresql.conf.sample > my-postgres.conf

  3. עורכים את העותק של קובץ התצורה כדי להוסיף הנחיות לשילוב של AlloyDB AI:

       echo "omni_enable_ml_agent_process = 'on'" >> my-postgres.conf
   echo "omni_google_cloud_private_key_file_path = '/etc/postgresql/private-key.json'" >> my-postgres.conf

  4. משנים את הרשאות מערכת הקבצים של קובצי המפתח וההגדרות:

       sudo chmod +r my-postgres.conf
   sudo chmod +r KEY_PATH

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

  5. מתקינים את קובצי המפתח וההגדרות שמועברים למאגר:

    Docker 

      docker run --name CONTAINER_NAME -e POSTGRES_PASSWORD=NEW_PASSWORD -p HOST_PORT:5432 -v "$PWD/my-postgres.conf":/etc/postgresql/postgresql.conf -v "FULL_KEY_PATH":/etc/postgresql/private-key.json -d google/alloydbomni:15.5.5 -c 'config_file=/etc/postgresql/postgresql.conf'

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

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

    • ‫NEW_PASSWORD: הסיסמה שמוקצית למשתמש postgres של מאגר התגים החדש אחרי שהוא נוצר.

    • ‫HOST_PORT: * HOST_PORT: יציאת ה-TCP במחשב המארח שאליה הקונטיינר מפרסם את יציאה 5432. כדי להשתמש ביציאת ברירת המחדל של PostgreSQL גם במחשב המארח, מציינים 5432.

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

    Podman 

      podman run --name CONTAINER_NAME -e POSTGRES_PASSWORD=NEW_PASSWORD -p HOST_PORT:5432 -v "$PWD/my-postgres.conf":/etc/postgresql/postgresql.conf -v "FULL_KEY_PATH":/etc/postgresql/private-key.json -d google/alloydbomni:15.5.5 -c 'config_file=/etc/postgresql/postgresql.conf'

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

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

    • ‫NEW_PASSWORD: הסיסמה שמוקצית למשתמש postgres של מאגר התגים החדש אחרי שהוא נוצר.

    • ‫HOST_PORT: יציאת ה-TCP במחשב המארח שאליה הקונטיינר צריך לפרסם את היציאה שלו 5432. כדי להשתמש ביציאת ברירת המחדל של PostgreSQL במחשב המארח, מציינים 5432.

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

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

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

   CREATE EXTENSION google_ml_integration CASCADE;

   SELECT array_dims(embedding( 'textembedding-gecko@001', 'AlloyDB AI')::real[]);
   array_dims

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

    [1:768]
    (1 row)

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

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