התחברות ל-Google Cloud SQL ל-MySQL

‫Cloud SQL ל-MySQL הוא שירות מנוהל של מסד נתונים, שבעזרתו אפשר ליצור, לתחזק ולנהל מסדי נתונים רלציוניים של MySQL ב- Google Cloud. המחבר Cloud SQL ל-MySQL מאפשר לכם לגשת לנתונים ממסדי נתונים של Cloud SQL ל-MySQL בתוך Data Studio.

גרסאות נתמכות

המחבר של Cloud SQL ל-MySQL נבדק בגרסאות הבאות של MySQL:

  • 5.6
  • ‫5.7
  • 8.0

אם נתקלתם בבעיות בשימוש בגרסה נתמכת, אתם יכולים לספר לנו על כך בקהילת Data Studio. אפשר גם להוסיף בקשות לתכונות ולהצביע עליהן בכלי למעקב אחר בעיות.

איך מתחברים ל-Cloud SQL ל-MySQL

מקור נתונים ב-Data Studio יכול להתחבר לטבלה אחת במסד נתונים של Cloud SQL ל-MySQL, או לשאילתה מותאמת אישית שאתם מספקים.

כדי להתחבר

  1. נכנסים ל-Data Studio.
  2. בדף הבית של Data Studio, בפינה הימנית העליונה, לוחצים על סמל היצירה. יצירה ואז על מקור נתונים.
  3. בוחרים את מחבר Cloud SQL ל-MySQL.
  4. אם מוצגת בקשה, צריך לתת ל-Data Studio הרשאת גישה לנתונים.

  5. מגדירים את החיבור למסד הנתונים:

    • כדי להתחבר באמצעות שם מארח או כתובת IP
      1. בצד ימין, לוחצים על BASIC .
      2. מזינים את פרטי החיבור:
        1. שם החיבור של המכונה
        2. מסד נתונים
        3. שם משתמש
        4. סיסמה
    • כדי להתחבר באמצעות כתובת אתר של JDBC
      1. בצד ימין, לוחצים על כתובת URL של JDBC .
      2. מזינים את פרטי החיבור:
        1. כתובת אתר של JDBC

          דוגמה jdbc:google:mysql: //<instance connection name>/

        2. שם משתמש
        3. סיסמה
      > אם משתמשים באפשרות של שם המארח JDBC, אפשר לוודא שהיא נגישה באמצעות כלי חיפוש DNS ציבוריים כמו Whois.
    כדי להתחבר באמצעות כתובת IPv6 מילולית, צריך להקיף את הכתובת בסוגריים מרובעים. לדוגמה: jdbc:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db
    • הערה : אי אפשר לקשר את Data Studio אל localhost. חובה להשתמש בשם מארח ציבורי או בכתובת IP ציבורית.

  6. לוחצים על אימות.

  7. בוחרים טבלה מהרשימה או מזינים שאילתה בהתאמה אישית.

בוחרים באפשרות CUSTOM QUERY (שאילתה בהתאמה אישית) כדי לספק שאילתת SQL במקום להתחבר לטבלה אחת. מערכת Data Studio משתמשת ב-SQL המותאם אישית הזה כהצהרת בחירה פנימית לכל שאילתה שנוצרת במסד הנתונים.

לדוגמה, הפקודה הבאה לא תפעל כי יש בה כמה הצהרות SQL:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

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

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

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

הערות

איך מוצאים את שם החיבור של המופע

שם החיבור של המכונה מזהה את המכונה ב- Google Cloud. אפשר למצוא אותו במסוף Google Cloud או באמצעות שורת הפקודה.

שימוש במסוף

  1. עוברים אל https://console.cloud.google.com/sql/instances.
  2. לוחצים על מספר המכונה שאליה רוצים להתחבר.
  3. בצד ימין, השם של החיבור מופיע בקטע 'התחברות למופע הזה'.

שימוש בשורת הפקודה

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


gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

הרשאות

כדי ליצור את החיבור, אתם צריכים לפחות הרשאת cloudsql.client בפרויקט Cloud SQL ל-MySQL. אם אין לכם גישה כזו (או שאין לכם אפשרות לקבל גישה כזו), אתם יכולים להשתמש במקום זאת במחבר MySQL.

קישוריות רשת

המחבר Cloud SQL ל-MySQL תומך בחיבורים למכונות Cloud SQL ל-MySQL עם קישוריות לכתובת IP ציבורית וקישוריות לכתובת IP פרטית.

לפני שמשתמשים במחבר Cloud SQL ל-MySQL, צריך להגדיר קישוריות לכתובת IP ציבורית או קישוריות לכתובת IP פרטית עבור מכונת Cloud SQL ל-MySQL.

כדי לאפשר ל-Data Studio לגשת לנתונים ב-Cloud SQL ולבצע שאילתות על הנתונים האלה דרך חיבור פרטי, צריך לבחור באפשרות נתיב פרטי לשירותי Google Cloud בהגדרות של מופע Cloud SQL ל-MySQL.

סוגי הנתונים

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

הערה : ‏ Data Studio לא תומך בתוספים של נתונים מרחביים ב-MySQL.

מגבלות של Cloud SQL ל-MySQL Connector

  • אפשר להריץ שאילתות על עד 150,000 שורות בכל שאילתה באמצעות המחבר הזה. אם תחרגו מהמגבלה הזו, הנתונים ייחתכו.
  • כותרות העמודות (שמות השדות) צריכות להכיל רק תווי ASCII. אין תמיכה בתווים שאינם ASCII.

פתרון בעיות

במדריך לפתרון בעיות ב-Data Studio מופיעה רשימה של הודעות שגיאה נפוצות ושלבים לפתרון שלהן.