‫MySQL,‏ MariaDB ו-SingleStore

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

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

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

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

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

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

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

‫MySQL 8.0.X:

הערה: אפשרות הדיאלקט של Looker MySQL 8.0.X מיושמת עם גרסת התיקון 8.0.12+ עקב הוצאה משימוש של MySQL במיון מרומז בפסקת GROUP BY. זה משפיע על סכומי ביניים של Looker עבור MySQL גרסאות 8.0.0 עד 8.0.11, וגורם לשגיאות ביצירת SQL. לוקר מציע לשדרג את כל מסדי הנתונים של MySQL 8.0.X לגרסה 8.0.12 לפחות כדי להשתלב באופן מלא. עם זאת, גרסאות קודמות של MySQL ימשיכו לפעול, למעט סיכומי משנה.

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

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. מריצים את הפקודות הבאות ומחליפים את some_password_here בסיסמה ייחודית ומאובטחת:

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

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

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

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

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

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

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

אפשר לציין את השם של מסד הנתונים הזמני בשדה מסד נתונים זמני כשיוצרים את החיבור למסד הנתונים. אם לא מציינים שם של מסד נתונים זמני, 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, אתם צריכים להשתמש בפרמטר create_process LookML כדי להשתמש ב-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, הגדר את משתנה MySQL max_allowed_packet לערכו המקסימלי, 1073741824, כדי למנוע שגיאות "SQLEException: Packet for query is too large".

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

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

1. בקטע ניהול ב-Looker, בוחרים באפשרות חיבורים ואז לוחצים על הוספת חיבור.

2. מהתפריט הנפתח דיאלקט, בחר את שם הדיאלקט של מסד הנתונים שלך: MySQL, MySQL 8.0.12+, MariaDB, SingleStore או SingleStore 7+.

   הערה: אם אתם משתמשים במופע של Looker ‏ (Google Cloud Core) ואתם לא רואים את הניב שלכם בתפריט הנפתח Dialect, תוכלו לעיין במסמכי התיעוד של Looker ‏ (Google Cloud Core) כדי לוודא שהניב נתמך במופעים של Looker ‏ (Google Cloud Core).

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

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

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

החיבור למסד הנתונים יתווסף לרשימה בדף Connections Admin ב-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 יתמוך בתכונות מסוימות, הדיאלקט של מסד הנתונים צריך לתמוך בהן גם כן.

התכונות הבאות נתמכות ב-MySQL החל מגרסה Looker 26.16:

תכונה	נתמך?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות שמבוססות על SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
ביטול שאילתה
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי רישיות
סוג מיקום
סוג הרשימה
מאון
אחוזון נפרד
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
מספר הפעמים שהופעל SQL Runner
SQL Explain
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
רישומים מסוג HLL
מודעות מצטברת
המרות מצטברות של PDT
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים לניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

הגרסה MySQL 8.0.12 ואילך תומכת בתכונות הבאות החל מ-Looker 26.16:

תכונה	נתמך?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות שמבוססות על SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
ביטול שאילתה
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי רישיות
סוג מיקום
סוג הרשימה
מאון
אחוזון נפרד
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
מספר הפעמים שהופעל SQL Runner
SQL Explain
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
רישומים מסוג HLL
מודעות מצטברת
המרות מצטברות של PDT
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים לניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

נכון ל-Looker 26.16,‏ MariaDB תומך בתכונות הבאות:

תכונה	נתמך?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות שמבוססות על SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
ביטול שאילתה
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי רישיות
סוג מיקום
סוג הרשימה
מאון
אחוזון נפרד
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
מספר הפעמים שהופעל SQL Runner
SQL Explain
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
רישומים מסוג HLL
מודעות מצטברת
המרות מצטברות של PDT
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים לניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

SingleStore תומך בתכונות הבאות החל מ-Looker 26.16:

תכונה	נתמך?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות שמבוססות על SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
ביטול שאילתה
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי רישיות
סוג מיקום
סוג הרשימה
מאון
אחוזון נפרד
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
מספר הפעמים שהופעל SQL Runner
SQL Explain
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
רישומים מסוג HLL
מודעות מצטברת
המרות מצטברות של PDT
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים לניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית

הגרסה SingleStore 7+ תומכת בתכונות הבאות החל מ-Looker 26.16:

תכונה	נתמך?
Looker (Google Cloud core)‎
צבירה סימטרית
טבלאות נגזרות
טבלאות נגזרות מתמידות שמבוססות על SQL
טבלאות נגזרות מתמידות מבוססות LookML
תצוגות יציבות
ביטול שאילתה
טבלאות ציר שמבוססות על SQL
אזורי זמן
SSL
סיכומי ביניים
פרמטרים נוספים של JDBC
תלוי רישיות
סוג מיקום
סוג הרשימה
מאון
אחוזון נפרד
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
מספר הפעמים שהופעל SQL Runner
SQL Explain
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
רישומים מסוג HLL
מודעות מצטברת
המרות מצטברות של PDT
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים לניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית