שימוש ב-AlloyDB ל-PostgreSQL עם MCP,‏ Gemini CLI וסוכנים אחרים

כדי לשלוח שאילתות למסד הנתונים של AlloyDB ל-PostgreSQL, לבדוק סכימות ולנהל משאבים של מסד הנתונים באמצעות שפה טבעית מסביבת הפיתוח המשולבת (IDE) או מהטרמינל, אתם יכולים לחבר את המכונה לכלי AI שתומכים ב-Model Context Protocol‏ (MCP).

מומלץ להשתמש בתוסף הייעודי של AlloyDB ל-Gemini CLI. ‫Gemini CLI משלב את שרת ה-MCP הבסיסי ישירות בתוסף, כך שאין צורך להגדיר שרת נפרד. אתם יכולים להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI, וכך ליהנות מיתרונות דומים של הגדרה בסביבת הפיתוח המשולבת (IDE).

לחלופין, סביבות פיתוח משולבות וסוכנים אחרים שתומכים ב-MCP יכולים להתחבר דרך MCP Toolbox for Databases. ‫Toolbox הוא שרת MCP בקוד פתוח שנועד לחבר סוכני AI לנתונים שלכם. הוא מטפל במשימות כמו אימות ואיחוד חיבורים, ומאפשר לכם לבצע פעולות בנתונים באמצעות שפה טבעית ישירות מסביבת הפיתוח המשולבת (IDE).

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

כדי להתחבר למכונה של AlloyDB ולהשתמש בכלים הזמינים, צריך להיות לכם אחד מהתפקידים הבאים בניהול זהויות והרשאות גישה (IAM), או תפקיד בהתאמה אישית עם הרשאות דומות:

משימה שם התפקיד תפקיד IAM נדרש
שימוש בכלים לקריאה בלבד כדי להציג ולקבל משאבים של AlloyDB צפייה ב-AlloyDB roles/alloydb.viewer
התחברות למכונה והרצת שאילתות לקוח AlloyDB roles/alloydb.client
Service Usage Consumer roles/serviceusage.serviceUsageConsumer
לבצע משימות ניהול (כמו יצירה או ניהול של אשכולות, מכונות ומשתמשים) אדמין ב-AlloyDB roles/alloydb.admin
שימוש בתוסף הניטור צפייה במעקב roles/monitoring.viewer

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

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. מפעילים את ממשקי ה-Cloud API שנדרשים כדי ליצור את AlloyDB ולהתחבר אליו.

    הפעלת ממשקי ה-API

    1. בשלב Confirm project, לוחצים על Next כדי לאשר את שם הפרויקט שבו רוצים לבצע שינויים.

    2. בשלב Enable APIs, לוחצים על Enable כדי להפעיל את ממשקי ה-API הבאים:

      • AlloyDB API
      • Compute Engine API
      • Cloud Resource Manager API
      • Service Networking API

      אם אתם מתכננים להגדיר קישוריות רשת ל-AlloyDB באמצעות רשת VPC שנמצאת באותו פרויקט ב- Google Cloud כמו AlloyDB, אתם צריכים את Service Networking API.

      אם אתם מתכננים להגדיר קישוריות רשת ל-AlloyDB באמצעות רשת VPC שנמצאת בפרויקט אחר ב- Google Cloud , אתם צריכים את Compute Engine API ואת Cloud Resource Manager API.

  7. יוצרים או בוחרים אשכול ואת המכונה הראשית שלו.
  8. מגדירים את Application Default Credentials (ADC) בסביבה שלכם.
  9. יוצרים משתמש במסד הנתונים או משתמשים במשתמש קיים. הכינו את שם המשתמש והסיסמה.

איך משתמשים בתוספים ל-Gemini CLI ב-AlloyDB

‫Gemini CLI הוא סוכן AI בקוד פתוח שעוזר בתהליכי פיתוח, כמו כתיבת קוד, ניפוי באגים, חקירת נתונים ויצירת תוכן. המטרה שלו היא לספק ממשק אינטראקטיבי לאינטראקציה עם שירותי Data Cloud ומסדי נתונים פופולריים בקוד פתוח.

השילוב עם Gemini CLI מתבצע באמצעות תוספים ייעודיים שמציעים יכולות נוספות בהשוואה לחיבור רגיל של MCP Toolbox. בקטעים הבאים מתוארים התוספים alloydb ו-alloydb-observability, שמציעים תהליך התקנה וקבוצת כלים. התוספים בקוד פתוח מכילים מידע מפורט על התקנה, הגדרה ודוגמאות לשימוש. מידע נוסף זמין במאמר תוסף ל-Gemini CLI – ‏AlloyDB ל-PostgreSQL.

תוסף AlloyDB

התוסף alloydb כולל כלים לשליחת שאילתות למסד הנתונים, לניהול משאבי AlloyDB ולמעקב אחרי תקינות מסד הנתונים.

בדוגמאות הבאות נעשה שימוש במסד נתונים לדוגמה של ecommerce עם הטבלאות הבאות:

  • ‫products: מכיל את פרטי המוצר, כולל product_id,‏ product_name,‏ category ו-price.
  • ‫customers: מאחסן נתוני לקוחות, כמו customer_id, first_name, last_name ו-email.
  • ‫orders: מכיל את פרטי ההזמנה, כולל order_id,‏ customer_id ו-order_date.
קטגוריה כלים דוגמה לפרומפט בשפה טבעית
פעולות במסד הנתונים database_overview תן לי סקירה כללית של מסד הנתונים הנוכחי.
list_tables תציג לי את כל הטבלאות במסד הנתונים הנוכחי.
execute_sql תראה לי את 10 המוצרים הכי יקרים בקטגוריה "מחשבים ניידים".
list_active_queries אילו שאילתות פועלות במסד הנתונים?
get_query_plan הסבר את התוכנית לביצוע שאילתה שמוצאת את כל הלקוחות שלא ביצעו הזמנה ב-6 החודשים האחרונים.
list_available_extensions אילו תוספים זמינים להתקנה?
list_installed_extensions מציגים את כל התוספים שמותקנים.
list_indexes הצגת כל האינדקסים בטבלה products.
list_locks הצגת כל הנעילות הפעילות במסד הנתונים.
list_schemas הצגת רשימה של כל הסכימות במסד הנתונים.
list_sequences הצגת כל הרצפים בסכימה הנוכחית.
list_triggers הצגת רשימה של כל הטריגרים בטבלה orders.
list_views תציג לי את כל התצוגות בסכימה sales.
ניהול משאבים
אשכולות, מכונות, משתמשים		 create_cluster יוצרים אשכול AlloyDB בשם sales-quarterly-db באזור us-east1.
get_cluster מציגים את פרטי האשכול sales-quarterly-db.
list_clusters רשימה של כל אשכולות AlloyDB.
create_instance יוצרים מכונה חדשה לקריאה באשכול sales-quarterly-db.
get_instance תציג לי את המידע על המכונה sales-quarterly-db-rp.
list_instances הצגת רשימה של כל המכונות באשכול sales-quarterly-db.
create_user יוצרים משתמש חדש במסד הנתונים בשם reporting_user עם הסיסמה report_password.
יוצרים משתמש חדש במסד הנתונים של IAM בשביל reporting_user@example.com.
get_user קבלת המידע של המשתמש reporting_user.
list_users הצגת רשימה של כל המשתמשים במסד הנתונים.
wait_for_operation מה הסטטוס של הפעולה operation-163562789?
תקינות ותחזוקה של מסד הנתונים list_autovacuum_configurations תראה לי את ההגדרה הנוכחית של autovacuum.
list_memory_configurations מהן הגדרות הזיכרון הנוכחיות של המכונה הראשית?
list_top_bloated_tables הצגת רשימה של חמש הטבלאות הכי מנופחות.
list_replication_slots הצגת כל משבצות הרפליקציה הפעילות.
replication_stats הצגת הנתונים הסטטיסטיים הנוכחיים של הרפליקציה.
list_invalid_indexes צריך לבדוק אם יש אינדקסים לא חוקיים במסד הנתונים של ecommerce.
long_running_transactions האם יש עסקאות שנמשכות זמן רב?

תוסף הניראות של AlloyDB

התוסף alloydb-observability מספק ממשק אחיד לניהול ולמעקב אחרי הביצועים והתקינות של מסד הנתונים ישירות מ-Gemini CLI.

קטגוריה כלים דוגמה לפרומפט בשפה טבעית
ניראות (observability) get_system_metrics מהם מדדי המערכת, כמו השימוש במעבד (CPU), בשעה האחרונה?
get_query_metrics תציג לי את מדדי הביצועים של השאילתות מ-15 הדקות האחרונות.

אתם יכולים להשתמש בתוסף ל-Gemini CLI בשביל AlloyDB בשתי דרכים:

  • כלי עצמאי של שורת הפקודה
  • משולב ב-IDE שלכם עם Gemini Code Assist

Gemini CLI

  1. מתקינים את Gemini CLI.
  2. מתקינים את התוסף של AlloyDB ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה: 
    gemini extensions install https://github.com/gemini-cli-extensions/alloydb
  3. מגדירים משתני סביבה כדי להתחבר למכונה של AlloyDB: 
    export ALLOYDB_POSTGRES_PROJECT="PROJECT_ID"
export ALLOYDB_POSTGRES_REGION="REGION"
export ALLOYDB_POSTGRES_CLUSTER="CLUSTER_NAME"
export ALLOYDB_POSTGRES_INSTANCE="INSTANCE_NAME"
export ALLOYDB_POSTGRES_DATABASE="DATABASE_NAME"

    כברירת מחדל, התוסף ל-Gemini CLI ל-AlloyDB משתמש בApplication Default Credentials ‏ (ADC) לאימות. אם רוצים להתחבר בתור משתמש במסד הנתונים, צריך להגדיר את משתני הסביבה האופציונליים הבאים:

    #Optional: Set for database user authentication
export ALLOYDB_POSTGRES_USER="USERNAME"
export ALLOYDB_POSTGRES_PASSWORD="PASSWORD"

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

    export ALLOYDB_POSTGRES_IP_TYPE="private"
  4. מפעילים את Gemini CLI במצב אינטראקטיבי: 
    gemini
    ‫CLI טוען באופן אוטומטי את התוסף של AlloyDB ל-Gemini CLI ואת הכלים שלו, שבהם אתם יכולים להשתמש כדי לקיים אינטראקציה עם מסד הנתונים.

Gemini Code Assist

מומלץ להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI, כי בגישה הזו אין צורך להגדיר שרת MCP באופן ידני.

  1. מוודאים שהתקנתם והגדרתם את Gemini CLI ואת התוסף alloydb.
  2. מגדירים את Gemini Code Assist לשימוש ב-Gemini CLI.
  3. מתחילים לקיים אינטראקציה עם מכונות AlloyDB באמצעות שפה טבעית ישירות בצ'אט של Gemini Code Assist.

התחברות ל-Antigravity

אפשר לקשר את AlloyDB ל-Antigravity בדרכים הבאות:

  • שימוש ב-MCP Store
  • באמצעות הגדרה מותאמת אישית

הערה: לא צריך להוריד את הקובץ הבינארי של MCP Toolbox כדי להשתמש בשיטות האלה.

חנות MCP

הדרך הכי מומלצת להתחבר ל-AlloyDB ב-Antigravity היא באמצעות חנות ה-MCP המובנית.

  1. פותחים את Antigravity ואז את חלונית הסוכן של העורך.
  2. לוחצים על סמל "..." בחלק העליון של החלונית ובוחרים באפשרות שרתי MCP.
  3. מאתרים את AlloyDB ל-PostgreSQL ברשימת השרתים הזמינים ולוחצים על Install.
  4. פועלים לפי ההנחיות במסך כדי לקשר את החשבונות באופן מאובטח (אם רלוונטי).

אחרי שמתקינים את AlloyDB ב-MCP Store, המשאבים והכלים מהשרת זמינים באופן אוטומטי בכלי העריכה.

הגדרות אישיות

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

  1. פותחים את Antigravity ואז את חלונית הסוכן של העורך.
  2. לוחצים על סמל האפשרויות הנוספות (3 נקודות) בחלק העליון של החלונית ובוחרים באפשרות שרתי MCP.
  3. לוחצים על Manage MCP Servers > View raw config (ניהול שרתי MCP > הצגת ההגדרות הגולמיות) כדי לפתוח את הקובץ mcp_config.json.
  4. מוסיפים את ההגדרות הבאות לקובץ mcp_config.json ושומרים אותו.
{
  "mcpServers": {
    "alloydb-postgres": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}
מחליפים את הערכים הבאים:
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫REGION: שם האזור של AlloyDB.
  • ‫CLUSTER_NAME: השם של אשכול AlloyDB.
  • ‫INSTANCE_NAME: השם של מכונת AlloyDB.
  • ‫DATABASE_NAME: השם של מסד הנתונים ב-AlloyDB.
  • ‫USERNAME: שם המשתמש שלכם ב-AlloyDB למשתנה ALLOYDB_POSTGRES_USER.
  • ‫PASSWORD: הסיסמה שלכם ל-AlloyDB למשתנה ALLOYDB_POSTGRES_PASSWORD.

חיבור לסביבות פיתוח משולבות (IDE) אחרות באמצעות MCP Toolbox for Databases

בקטע הזה מוסבר איך להתחבר למכונה של AlloyDB מסוכנים שונים באמצעות MCP Toolbox for Databases. ‫Toolbox פועל כשרת Model Context Protocol (MCP) בקוד פתוח שנמצא בין ה-IDE למסד הנתונים, ומספק מישור בקרה לכלי ה-AI. בקטע הזה מוסבר איך להתחבר למכונה של AlloyDB באמצעות כתובת IP ציבורית או פרטית. כברירת מחדל, ארגז הכלים משתמש בכתובת IP ציבורית, אבל אפשר להגדיר קישור דרך IP פרטי על ידי הגדרת משתנה הסביבה ALLOYDB_POSTGRES_IP_TYPE, כפי שמוצג בדוגמאות להגדרות.

התקנת MCP Toolbox for Databases

כדי לקשר את ה-IDE ל-AlloyDB, צריך להתקין את MCP Toolbox for Databases – שרת בקוד פתוח שמקשר סוכני AI לנתונים שלכם.

  1. מורידים את הגרסה העדכנית של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה (OS) ולארכיטקטורת המעבד (CPU). צריך להשתמש ב-Toolbox בגרסה v0.15.0 ואילך.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.15.0/linux/amd64/toolbox

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.15.0/darwin/arm64/toolbox

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.15.0/darwin/amd64/toolbox

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.15.0/windows/amd64/toolbox

  2. הופכים את הקובץ הבינארי לקובץ הפעלה.

    chmod +x toolbox

  3. מאמתים את ההתקנה.

    ./toolbox --version

הגדרת הלקוח

בוחרים את כלי הנציג מבין האפשרויות הבאות:

Claude Code

  1. מתקינים את Claude Code.
  2. יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
  3. מוסיפים את ההגדרות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude במחשב

  1. פותחים את Claude Desktop ועוברים אל הגדרות.
  2. בכרטיסייה Developer, לוחצים על Edit Config כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}
  1. מפעילים מחדש את Claude Desktop.
  2. במסך הצ'אט החדש מופיע סמל של פטיש (MCP) עם שרת ה-MCP החדש.

Cline

  1. פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל שרתי MCP.
  2. לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.

{
  "mcpServers": {
    "alloydb": {
     "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

אחרי שהשרת יתחבר בהצלחה, יופיע סטטוס פעיל בצבע ירוק.

סמן

  1. יוצרים את הספרייה .cursor בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
  2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}
  1. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP (הגדרות > הגדרות Cursor ‏> MCP). כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.

‫Visual Studio Code ‏ (Copilot)

  1. פותחים את VS Code ויוצרים ספריית .vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
  2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "servers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
        "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
        "ALLOYDB_POSTGRES_REGION": "REGION",
        "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
        "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
        "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
        "ALLOYDB_POSTGRES_USER": "USERNAME",
        "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

גלישת רוח

  1. פותחים את Windsurf ועוברים אל Cascade Assistant.
  2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

איך מקבלים תובנות מתקדמות לגבי שאילתות באמצעות MCP Toolbox for Databases

אתם יכולים להשתמש ב-MCP Toolbox for Databases כדי לגשת לתכונות של ניטור מצב המערכת ב-AlloyDB ולתובנות מתקדמות לגבי שאילתות ישירות ב-IDE. כך סוכני ה-AI יכולים לנתח נתונים סטטיסטיים של הפעלת שאילתות, לעקוב אחרי אירועי המתנה ולקבל המלצות לאינדקסים כדי לפתור בעיות בביצועים של מסד הנתונים.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לשימוש בהגדרות המוכנות מראש של ניטור AlloyDB ב-MCP Toolbox for Databases, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט שבו אתם רוצים להשתמש בכלים:

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

התפקידים המוגדרים מראש האלה מכילים את ההרשאות שנדרשות כדי להשתמש בהגדרות המוכנות מראש של AlloyDB לתצפית ב-MCP Toolbox for Databases. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי להשתמש בהגדרות המוכנות מראש של AlloyDB לתצפיתיות ב-MCP Toolbox for Databases, נדרשות ההרשאות הבאות:

  • קבלת מדדי שאילתות: queryMetrics.fetch
  • מקבלים את מדדי המערכת: systemMetrics.fetch
  • קבלת נתונים סטטיסטיים מתקדמים של שאילתות נצברות: queryStats.fetch
  • קבלת נתונים סטטיסטיים מתקדמים של שאילתות על סדרות זמן: queryTimeSeries.fetch
  • קבלת נתונים סטטיסטיים מתקדמים של אירועי המתנה נצברים: waitEventStats.fetch
  • קבלת נתונים סטטיסטיים מתקדמים של אירועי המתנה בסדרות עתיות: waitEventTimeSeries.fetch
  • קבלת המלצות לאינדקסים: recommendations.query, resourceRecommendations.query
  • הצגת מדדי מעקב: monitoring.timeseries.list

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

כדי להגדיר את ה-IDE לשימוש בהגדרות המוכנות מראש של alloydb-postgres-observability, מוסיפים את ההגדרות הבאות לקובץ התצורה של MCP בלקוח.

מידע נוסף זמין במאמר MCP Toolbox for Databases: AlloyDB ל-PostgreSQL.

{
  "mcpServers": {
    "alloydb-observability": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-observability", "--stdio"]
    }
  }
}

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

  • ‫get_advanced_aggregated_query_stats: מאחזרת נתונים סטטיסטיים מצטברים של ביצוע שאילתות.
  • ‫get_advanced_aggregated_wait_event_stats: אחזור מדדים מצטברים של צווארי בקבוק באירועי המתנה.
  • ‫get_advanced_time_series_query_stats: מאחזר מדדי ביצועים של סדרות זמנים לשאילתות לאורך זמן.
  • ‫get_advanced_time_series_wait_event_stats: מאחזר מדדים של סדרות זמנים לאירועי המתנה לאורך זמן.
  • get_index_recommendations: אחזור המלצות לאינדקסים כדי לשפר את ביצועי השאילתות.

קישור באמצעות Data Agent Kit

בעזרת Google Cloud Data Agent Kit אתם יכולים להתחבר למסד הנתונים של AlloyDB ולשלוח אליו שאילתות ישירות ב-VS Code, בסביבות פיתוח משולבות (IDE) שמבוססות על VS Code ובממשקי שורת פקודה (CLI) נתמכים.

היתרונות של שימוש ב-Data Agent Kit כוללים:

  • יכולות של גילוי וניתוח נתונים שמאפשרות לשאול שאלות על הנתונים ב-AlloyDB בשפה טבעית
  • ביטול הצורך לעבור בין הכלים של AlloyDB לבין סביבת הפיתוח שלכם
  • פלאגינים שמאפשרים להשתמש בממשקי שורת פקודה (CLI) אינטראקטיביים עם המשאבים של Google Cloud

מידע נוסף זמין במאמר סקירה כללית על Data Agent Kit.