‫MySQL,‏ MariaDB ו-SingleStore

ניבים שבהם משתמשים בהוראות האלה

ל-MySQL, ל-MariaDB ול-SingleStore (לשעבר MemSQL) יש דרישות זהות להגדרת מסד הנתונים כדי לחבר את Looker למסד הנתונים של ניתוח הנתונים. הדרישות האלה מתוארות בדף הזה. כדי להגדיר את MySQL כמסד הנתונים הפנימי לקצה העורפי של מכונה של Looker באירוח בצד הלקוח, קראו את המאמר העברת מסד הנתונים לקצה העורפי של Looker ל-MySQL.

הצפנת התנועה ברשת

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

אם אתם רוצים להשתמש בהצפנת SSL, עיינו בדף התיעוד הזה של MySQL.

משתמשים ואבטחה

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

‫MySQL 8.4.X

ב-MySQL 8.4.X, פלאגין האימות שמוגדר כברירת מחדל הוא caching_sha2_password, והפלאגין mysql_native_password מושבת כברירת מחדל. בוחרים באחת משיטות האימות הבאות, בהתאם להגדרת ה-SSL בחיבור ל-Looker:

  • כשמתחברים עם SSL מופעל (מומלץ): מנהל ההתקן Looker JDBC תומך ב-caching_sha2_password בחיבורי SSL בלי להפעיל את mysql_native_password. בוחרים באפשרות SSL כשיוצרים את החיבור ל-Looker, ומריצים את הפקודות הבאות כדי ליצור את המשתמש ולהעניק הרשאות SELECT:

    CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD';
    GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
    
  • כשמתחברים בלי להפעיל SSL: Looker לא מפעיל אחזור אוטומטי של מפתח ציבורי של RSA‏ (allowPublicKeyRetrieval) בחיבורים לא מוצפנים של מסדי נתונים של לקוחות, לכן צריך לבצע אימות באמצעות mysql_native_password:

    1. מגדירים את שרת MySQL 8.4.X כדי להפעיל את הפלאגין mysql_native_password באחת מהשיטות הבאות, בהתאם לפריסה:

      • מפעילים את שרת MySQL עם הדגל --mysql-native-password=ON.
      • מגדירים את המאפיין בקובץ התצורה my.cnf:

        [mysqld]
        mysql_native_password=ON
        
      • במכונות MySQL 8.4.X שמתארחות בענן ב- Google Cloud, ב-AWS או ב-Azure, מפעילים את הדגל או הפרמטר mysql_native_password לניהול מסד הנתונים בהגדרות המכונה או בקבוצת הפרמטרים, אם הוא לא מופעל כברירת מחדל, ומפעילים מחדש את מכונת מסד הנתונים במקרה הצורך. פרטים על ההגדרה מופיעים במסמכי התיעוד של ספק שירותי הענן.

    2. יוצרים את המשתמש במסד הנתונים באמצעות mysql_native_password ומעניקים הרשאות SELECT:

      CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD';
      GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
      

מחליפים את הפלייסהולדרים הבאים בפקודות שלמעלה:

  • ‫DB_USERNAME: שם המשתמש של משתמש מסד הנתונים של Looker, למשל looker
  • ‫PASSWORD: סיסמה ייחודית ומאובטחת
  • ‫DATABASE_NAME: השם של מסד הנתונים

‫MySQL 8.0.X

ב-MySQL 8.0.X, פלאגין האימות שמוגדר כברירת מחדל הוא caching_sha2_password. ‫Looker משתמש בפלאגין mysql_native_password כדי לאמת את מסדי הנתונים של MySQL 8.0.X באמצעות מנהל ההתקן של JDBC. כדי ש-MySQL 8.0.X יפעל כמו שצריך, מבצעים את הפעולות הבאות:

  1. מגדירים את מסד הנתונים של MySQL כך שישתמש בפלאגין mysql_native_password. אפשר לעשות את זה בכמה דרכים, בהתאם לאופן שבו מסד הנתונים של MySQL 8 נפרס ולסוג הגישה שיש לכם להגדרות:

    • מתחילים את התהליך עם הדגל --default-auth=mysql_native_password

    • מגדירים את המאפיין בקובץ התצורה my.cnf:

    [mysqld]
    default-authentication-plugin=mysql_native_password
    
    • אם המכונה של מסד הנתונים מתארחת דרך AWS RDS, צריך להגדיר את הפרמטר default_authentication_plugin דרך קבוצת פרמטרים של RDS שחלה על המכונה הזו של מסד הנתונים.
  2. מריצים את הפקודות הבאות, ומחליפים את PASSWORD בסיסמה ייחודית ומאובטחת:

    CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD';
    GRANT SELECT ON database_name.* TO 'looker'@'%';
    

‫MySQL 5.7.X וגרסאות קודמות, MariaDB ו-SingleStore:

מריצים את הפקודות הבאות, ומחליפים את PASSWORD בסיסמה ייחודית ומאובטחת:

CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';

הגדרת סכימה זמנית לטבלאות נגזרות מתמידות (PDT)

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

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

אפשר לציין את השם של מסד הנתונים הזמני בשדה Temp Database כשיוצרים את החיבור למסד הנתונים. אם לא מציינים שם למסד נתונים זמני, Looker יוצר מסד נתונים זמני בשם looker_tmp. בפקודות הבאות נעשה שימוש ב-looker_tmp, אבל אם ציינתם שם אחר למסד הנתונים הזמני, השתמשו בשם הזה במקום ב-looker_tmp.

CREATE SCHEMA looker_tmp;
GRANT
  SELECT,
  INDEX,
  INSERT,
  UPDATE,
  DELETE,
  CREATE,
  DROP,
  ALTER,
  CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';

ב-SingleStore, או אם מסד הנתונים שלכם משתמש ברפליקציה שמבוססת על GTID, אתם צריכים להשתמש בפרמטר LookML‏ create_process כדי להשתמש ב-PDT, כי GTID לא תומך בהצהרות CREATE TABLE AS SELECT.

הגדרה חלופית לטבלאות נגזרות רגילות

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

GRANT
  SELECT,
  INDEX,
  INSERT,
  DROP,
  CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
-- Note that the looker_tmp schema does not need to actually exist,
-- even though these permission grants are still needed

הגדרת המשתנה max_allowed_packet

ב-MySQL, מגדירים את המשתנה max_allowed_packet של MySQL לערך המקסימלי שלו, 1073741824, כדי למנוע שגיאות מסוג "SQLException: Packet for query is too large".

יצירת החיבור של Looker למסד הנתונים

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

  1. בקטע Admin ב-Looker, בוחרים באפשרות Connections ולוחצים על Add Connection.
  2. בתפריט הנפתח Dialect, בוחרים את שם הניב של מסד הנתונים: MySQL,‏ MySQL 8.0.12+‎ (לגרסאות MySQL 8.0.12 וגרסאות 8.X מאוחרות יותר, כולל MySQL 8.4.X),‏ MariaDB,‏ SingleStore או SingleStore 7+‎.

  3. ממלאים את פרטי החיבור. רוב ההגדרות משותפות לרוב הניבים של מסדי הנתונים. מידע נוסף זמין בדף התיעוד קישור Looker למסד הנתונים.

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

  5. אם ב-Looker מוצגת ההודעה Can Connect, לוחצים על Connect כדי ליצור את החיבור.

החיבור למסד הנתונים יתווסף לרשימה בדף Admin (ניהול) בקטע Connections (חיבורים) ב-Looker.

פרמטרים נתמכים של JDBC

ב-MySQL, ב-MariaDB וב-SingleStore, ‏Looker תומך בפרמטרים הבאים של JDBC בשדה Additional JDBC parameters של החיבור. מידע על הפרמטרים האלה מופיע במסמכי התיעוד של מסד הנתונים.

  • allowMultiQueries
  • autocommit
  • characterSetResults
  • clientCertificateKeyStorePassword
  • clientCertificateKeyStoreUrl
  • connectionAttributes
  • connectionCollation
  • connectionTimeZone
  • connectTimeout
  • defaultAuthenticationPlugin
  • disableSslHostnameVerification
  • disconnectOnExpiredPasswords
  • enabledSslCipherSuites
  • failOverReadOnly
  • fallbackToSystemTrustStore
  • forceConnectionTimeZoneToSession
  • interactiveClient
  • lookerFailover
  • maxIdleTime
  • maxQuerySizeToLog
  • oldModeNoPrecisionTimestamp
  • password
  • passwordCharacterEncoding
  • permitMysqlScheme
  • pinGlobalTxToPhysicalConnection
  • preserveInstants
  • queryInterceptors
  • restrictedAuth
  • rewriteBatchedStatements
  • socketTimeout
  • sslMode
  • tcpKeepAlive
  • trustCertificateKeyStorePassword
  • trustCertificateKeyStoreUrl
  • useCompression
  • usePipelineAuth
  • user
  • useServerPrepStmts
  • verifyServerCertificate
  • yearIsDateType

תמיכה בתכונות

כדי ש-Looker יתמוך בתכונות מסוימות, גם הניב של מסד הנתונים צריך לתמוך בהן.

החל מגרסה 26.22 של Looker, ‏MySQL תומך בתכונות הבאות:

תכונה יש תמיכה?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות של SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
סגירת שאילתות
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי אותיות רישיות (case-sensitive)
סוג מיקום
סוג הרשימה
מאון
מאון ייחודי
הצגת תהליכים ב-SQL Runner
תיאור טבלה ב-SQL Runner
הצגת אינדקסים ב-SQL Runner
‫SQL Runner Select 10
ספירת SQL Runner
הסבר על קוד SQL
פרטי כניסה של OAuth 2.0
הערות להוספת הקשר
מאגר חיבורים (connection pooling)
שרטוטי HLL
מוּדעוּת מצטברת
טבלאות PDT מצטברות
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים להשוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים של ניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

החל מגרסה 26.22 של Looker, גרסה 8.0.12 ומעלה של MySQL תומכת בתכונות הבאות:

תכונה יש תמיכה?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות של SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
סגירת שאילתות
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי אותיות רישיות (case-sensitive)
סוג מיקום
סוג הרשימה
מאון
מאון ייחודי
הצגת תהליכים ב-SQL Runner
תיאור טבלה ב-SQL Runner
הצגת אינדקסים ב-SQL Runner
‫SQL Runner Select 10
ספירת SQL Runner
הסבר על קוד SQL
פרטי כניסה של OAuth 2.0
הערות להוספת הקשר
מאגר חיבורים (connection pooling)
שרטוטי HLL
מוּדעוּת מצטברת
טבלאות PDT מצטברות
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים להשוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים של ניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

החל מגרסה 26.22 של Looker, ‏MariaDB תומך בתכונות הבאות:

תכונה יש תמיכה?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות של SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
סגירת שאילתות
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי אותיות רישיות (case-sensitive)
סוג מיקום
סוג הרשימה
מאון
מאון ייחודי
הצגת תהליכים ב-SQL Runner
תיאור טבלה ב-SQL Runner
הצגת אינדקסים ב-SQL Runner
‫SQL Runner Select 10
ספירת SQL Runner
הסבר על קוד SQL
פרטי כניסה של OAuth 2.0
הערות להוספת הקשר
מאגר חיבורים (connection pooling)
שרטוטי HLL
מוּדעוּת מצטברת
טבלאות PDT מצטברות
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים להשוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים של ניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

החל מגרסה 26.22 של Looker,‏ SingleStore תומך בתכונות הבאות:

תכונה יש תמיכה?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות של SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
סגירת שאילתות
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי אותיות רישיות (case-sensitive)
סוג מיקום
סוג הרשימה
מאון
מאון ייחודי
הצגת תהליכים ב-SQL Runner
תיאור טבלה ב-SQL Runner
הצגת אינדקסים ב-SQL Runner
‫SQL Runner Select 10
ספירת SQL Runner
הסבר על קוד SQL
פרטי כניסה של OAuth 2.0
הערות להוספת הקשר
מאגר חיבורים (connection pooling)
שרטוטי HLL
מוּדעוּת מצטברת
טבלאות PDT מצטברות
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים להשוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים של ניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

החל מגרסה 26.22 של Looker, גרסה 7 ומעלה של SingleStore תומכת בתכונות הבאות:

תכונה יש תמיכה?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות של SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
סגירת שאילתות
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי אותיות רישיות (case-sensitive)
סוג מיקום
סוג הרשימה
מאון
מאון ייחודי
הצגת תהליכים ב-SQL Runner
תיאור טבלה ב-SQL Runner
הצגת אינדקסים ב-SQL Runner
‫SQL Runner Select 10
ספירת SQL Runner
הסבר על קוד SQL
פרטי כניסה של OAuth 2.0
הערות להוספת הקשר
מאגר חיבורים (connection pooling)
שרטוטי HLL
מוּדעוּת מצטברת
טבלאות PDT מצטברות
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים להשוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים של ניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית