שימוש בתיעוד מקורות הנתונים עם MCP,‏ Gemini וסוכנים אחרים

שרת מקומי של MCP Toolbox for Databases מאפשר לחבר את שושלת היוחסין של הנתונים ללקוחות Model Context Protocol ‏(MCP), כולל Gemini CLI, סביבות פיתוח משולבות (IDE) וכלים אחרים למפתחים. לאחר מכן תוכלו להשתמש בסוכני AI בסביבת הפיתוח כדי לשלוח שאילתות לתרשימי שושלת, לגלות את מקור הנתונים במעלה הזרם ולנתח את ההשפעה במורד הזרם על הנכסים שלכם. מידע נוסף על MCP זמין במאמר מבוא ל-Model Context Protocol.

לקוחות MCP נתמכים

אפשר לחבר את שושלת היוחסין של הנתונים לסביבות הפיתוח המשולבות (IDE) ולכלים למפתחים הבאים:

• Gemini CLI
• Gemini Code Assist
• Claude Code
• Claude למחשב
• Codex
• ‫Cline (תוסף ל-VS Code)
• Cursor
• ‫Visual Studio Code ‏ (Copilot)
• ‫Windsurf (לשעבר Codeium)

אילו כלי MCP מספקת שושלת היוחסין של הנתונים?

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

בכלי datalineage-search-lineage של שושלת היוחסין של הנתונים, אפשר לאחזר תגובה בסטרימינג של קישורי שושלת היוחסין שמחוברים לנכסים המבוקשים.

למידע נוסף על מקור שושלת הנתונים ועל הכלים הזמינים שלו, קראו את המסמכים של מקור שושלת הנתונים.

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

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

• כדי להפעיל ממשקי API: אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin)
• כדי להשתמש במיומנויות של שושלת נתונים: צפייה בשושלת נתונים (roles/datalineage.viewer)

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

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

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

כדי להתחבר למסלול הנתונים באמצעות MCP Toolbox, נדרשות ההרשאות הבאות:

• כדי להפעיל ממשקי API: serviceusage.services.enable
• כדי להשתמש במיומנויות של שושלת נתונים:
  • datalineage.lineage.searchLinks
  • datalineage.processes.get
  • datalineage.runs.get

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

הפעלת ממשקי ה-API הנדרשים

1. נכנסים לדף לבחירת הפרויקט במסוף Google Cloud .

   כניסה לדף לבחירת הפרויקט

2. בוחרים או יוצרים פרויקט ב- Google Cloud .

   התפקידים שנדרשים כדי לבחור או ליצור פרויקט

   • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
   • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?
   הערה: אם אתם לא מתכננים לשמור את המשאבים שתיצרו בתהליך הזה, תוכלו ליצור פרויקט חדש במקום לבחור באחד מהפרויקטים הקיימים. בסיום התהליך תוכלו למחוק את הפרויקט ולהסיר את כל המשאבים שקשורים אליו.

3. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

4. מפעילים את Data Lineage API, אם הוא עדיין לא מופעל.

   התפקידים שנדרשים כדי להפעיל ממשקי API

   כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

   להפעלת ה-API

5. אם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי בחשבון המשתמש:

   gcloud auth application-default login

   אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.

   אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

התקנת MCP Toolbox

אם אתם מתכננים להשתמש רק ב-Gemini Code Assist, אתם לא צריכים להתקין את MCP Toolbox כי הוא כולל את יכולות השרת הנדרשות. בסביבות פיתוח משולבות ובכלים אחרים, פועלים לפי השלבים שבקטע הזה כדי להתקין את MCP Toolbox.

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

   Linux/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

   מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

   macOS (Darwin)/arm64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox

   מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

   macOS (Darwin)/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox

   מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

   Windows/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox

   מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

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

   chmod +x toolbox
   

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

   ./toolbox --version
   

   אם ההתקנה הצליחה, יוחזר מספר הגרסה, לדוגמה, 0.15.0.

הגדרת לקוחות וחיבורים לשושלת נתונים

בקטע הזה מוסבר איך לחבר את שושלת הנתונים לכלים שלכם.

כדי לחבר את סביבות הפיתוח המשולבות והכלים שתואמים ל-MCP למסלול הנתונים, קודם צריך להתקין את MCP Toolbox וליצור קובץ תצורה בהתאמה אישית למקור ולכלים של מסלול הנתונים.

הערה: אם אתם מתכננים להשתמש רק ב-Gemini Code Assist, אתם לא צריכים להתקין את MCP Toolbox.

1. בתיקיית השורש או בתיקיית ההגדרות של הפרויקט, יוצרים קובץ YAML בשם lineage-config.yaml עם ההגדרות הבאות:

   kind: source
   name: lineage-source
   type: datalineage
   project: ${DATALINEAGE_PROJECT}
   ---
   kind: tool
   name: search_lineage
   type: datalineage-search-lineage
   source: lineage-source
   description: Retrieves a streaming response of lineage links connected to requested assets.
   

2. מגדירים את משתנה הסביבה לפרויקט ב- Google Cloud :

   export DATALINEAGE_PROJECT=PROJECT_ID
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

3. כדי להגדיר את הלקוח הספציפי, משתמשים בדגל --config במקום בהגדרות מובנות מראש, כמו שמוסבר בקטעים הבאים.

Gemini CLI

כדי להשתמש בשושלת נתונים ב-Gemini CLI, אתם יכולים להגדיר אותה כשרת MCP מקומי באמצעות MCP Toolbox וקובץ lineage-config.yaml בהתאמה אישית.

1. בספריית העבודה של הפרויקט, יוצרים תיקייה בשם .gemini (או פותחים את הספרייה הגלובלית ~/.gemini).
2. בספרייה הזו, יוצרים או פותחים את הקובץ settings.json.

3. מוסיפים את ההגדרות הבאות:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

4. שומרים את ההגדרה.

5. מפעילים את Gemini CLI במצב אינטראקטיבי:

   gemini
   

   ב-Gemini CLI, מריצים את הפקודה /mcp כדי לוודא ששרת dataLineage מחובר.

Gemini Code Assist

‫Gemini Code Assist כולל את יכולות שרת ה-MCP הנדרשות, כך שאין צורך להתקין את MCP Toolbox בנפרד.

1. ב-VS Code, מתקינים את התוסף Gemini Code Assist.
2. מפעילים את Agent Mode בצ'אט של Gemini Code Assist.
3. בספריית העבודה, יוצרים תיקייה בשם .gemini. בתוך התיקייה הזו, יוצרים קובץ settings.json.

4. מוסיפים את ההגדרות הבאות:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

5. שומרים את ההגדרה.

Claude Code

הפלאגין הרשמי מספק כלים ל-Knowledge Catalog, אבל אתם יכולים להשתמש בשושלת נתונים ב-Claude Code על ידי הגדרת שרת MCP Toolbox מקומי עם קובץ תצורה בהתאמה אישית.

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

   export DATALINEAGE_PROJECT=PROJECT_ID
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

2. מגדירים את Claude Code כך שישתמש בשרת MCP Toolbox:

   claude mcp add datalineage -- /PATH/TO/toolbox --config=/PATH/TO/lineage-config.yaml --stdio
   

3. מפעילים את הסוכן:

   claude
   

Codex

כדי להשתמש בשושלת נתונים ב-Codex, צריך להגדיר חיבור לשרת MCP בהגדרות של Codex כדי להריץ את MCP Toolbox עם קובץ lineage-config.yaml בהתאמה אישית:

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

   export DATALINEAGE_PROJECT="PROJECT_ID"
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

2. בהגדרות של Codex MCP, מוסיפים את השרת באמצעות MCP Toolbox:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

Claude במחשב

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

3. מוסיפים את ההגדרה:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

4. שומרים את ההגדרה.

5. מפעילים מחדש את Claude במחשב. במסך הצ'אט החדש מופיע סמל MCP שמייצג את שרת ה-MCP החדש.

Cline

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

3. מוסיפים את ההגדרות הבאות:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

4. שומרים את ההגדרה. אחרי שהשרת יתחבר בהצלחה, יופיע סטטוס פעיל בצבע ירוק.

סמן

1. אם הספרייה .cursor לא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה.
2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים ופותחים אותו.

3. מוסיפים את ההגדרות הבאות:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

4. שומרים את ההגדרה.

5. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.

‫VS Code‏ (Copilot)

1. פותחים את VS Code ויוצרים את הספרייה .vscode בתיקיית השורש של הפרויקט, אם היא לא קיימת.
2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.

3. מוסיפים את ההגדרות הבאות:

   {
     "servers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

4. שומרים את ההגדרה.

גלישת רוח

1. פותחים את Windsurf ועוברים אל Cascade Assistant.
2. כדי לפתוח את קובץ התצורה, לוחצים על סמל ה-MCP ואז על Configure (הגדרה).

3. מוסיפים את ההגדרות הבאות:

   {
     "mcpServers": {
       "dataLineage": {
         "command": "./PATH/TO/toolbox",
         "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
         "env": {
           "DATALINEAGE_PROJECT": "PROJECT_ID"
         }
       }
     }
   }
   

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

4. שומרים את ההגדרה.

שימוש במיומנויות

העוזר האישי מבוסס-AI מחובר עכשיו לשושלת הנתונים. נסו לבקש מהעוזר האישי מבוסס-AI להתחקות אחרי שושלת הנתונים במעלה הזרם ובמורד הזרם בין הנכסים שלכם.

לדוגמה, אתם יכולים לבקש מהעוזר האישי מבוסס-AI:

• מעקב אחרי המקור של הנתונים בטבלה ב-BigQuery (שושלת נתונים במעלה הזרם).
• לגלות אילו טבלאות או דוחות במורד הזרם תלויים בנכס נתונים ספציפי (שושלת במורד הזרם).
• בדיקת שושלת היוחסין ברמת העמודה בין שדות ספציפיים בנכסים.

אופציונלי: הוספת הוראות למערכת

הוראות למערכת הן דרך לתת הנחיות ספציפיות למודל ה-LLM, כדי לעזור לו להבין את ההקשר ולענות בצורה מדויקת יותר. מגדירים את הוראות המערכת על סמך ההנחיה המומלצת למערכת של Data Lineage.

לדוגמה, אתם יכולים להוסיף הוראות שינחו את ה-LLM איך להשתמש במיומנויות של שושלת הנתונים:

• כשמבקשים ממך לעקוב אחרי זרימת נתונים במעלה או במורד הזרם בין נכסים או עמודות, צריך להשתמש במיומנות search_lineage או בכלי datalineage-search-lineage.

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

איך משתמשים בהוראות כדי לקבל עריכות מ-AI שמתאימות לסגנון התכנות שלכם

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

• מה ההבדל בין שרתי MCP מקומיים ומרוחקים
• איך משתמשים בשרת MCP Toolbox המקומי ל-Knowledge Catalog
• הפנייה לכלי MCP של שושלת נתונים
• מידע נוסף על שושלת נתונים
• חיפוש משאבים בקטלוג הידע.