ClickHouse

אתם יכולים לקשר את Looker למסד הנתונים של ClickHouse כדי לנתח את הנתונים וליצור לוחות בקרה אינטראקטיביים. החיבור הזה מאפשר לכם להשתמש בנתוני ClickHouse לדיווח ולניתוח ב-Looker, וכך לקבל החלטות מושכלות שמבוססות על נתונים.

בדף הזה מוסבר איך להגדיר את מופע ClickHouse ואת הגדרות החיבור ל-Looker, כולל איך להצפין את התנועה ברשת, להגדיר הרשאות משתמשים ולבדוק אילו תכונות נתמכות. ‫Looker תומך ב-ClickHouse בגרסה 0.2 ואילך, וב-ClickHouse 26 ומעלה באמצעות דרייברים מודרניים של JDBC ותמיכה בצבירה סימטרית.

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

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

כדי להפעיל הצפנת SSL בצד השרת, אפשר לעיין במסמכי התיעוד של הגדרות השרת הגלובליות של ClickHouse.

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

קודם צריך להגדיר את משתמש Looker בשרת ClickHouse. אפשר להגדיר משתמשים במסד נתונים של ClickHouse באמצעות SQL ‏ (CREATE USER) או דרך הקטע users בקובץ users.xml. כדי להגדיר גישת משתמשים, פועלים לפי התיעוד בנושא הרשאות גישה ב-ClickHouse. בדוגמה הבסיסית הבאה נעשה שימוש ב-users.xml:

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

בנוסף, צריך להגדיר בקובץ הזה את הגישה המתאימה למסד הנתונים:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

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

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

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

• ניב: בוחרים באפשרות ClickHouse 26+‎ או ClickHouse.
• מארח: שם המארח או כתובת ה-IP של שרת ClickHouse שאפשר להגיע אליו.
• Port: היציאה שדרכה אפשר להגיע לשירות ClickHouse דרך HTTP(S).
  • כברירת מחדל, חיבורי HTTP משתמשים ב-8123, וחיבורי HTTPS משתמשים ב-8443.
  • יציאות 9000 ו-9440 משמשות כברירת מחדל את לקוח שורת הפקודה המקומי של ClickHouse TCP, אבל Looker צריך להשתמש ביציאות HTTP(S) כדי להתחבר ל-ClickHouse.
  • יכול להיות שהאדמין שלכם ב-ClickHouse בחר יציאות חלופיות באמצעות ההגדרות http_port או https_port בהגדרות של ClickHouse. צריך לבקש מהאדמין של ClickHouse את ההגדרות שמתאימות להגדרה שלכם.
• מסד נתונים: שם מסד הנתונים (צריך להיות אחד ממסדי הנתונים שמותרים בהרשאות שלכם ב-ClickHouse).
• שם משתמש: שם המשתמש במסד הנתונים.
• סיסמה: סיסמת מסד הנתונים.
• ‫SSL: מסמנים את התיבה כדי להתחבר ל-ClickHouse באמצעות SSL/TLS.
• אימות SSL: (אופציונלי) מסמנים את התיבה כדי לאכוף אימות קפדני של אישור SSL ושם מארח בשרת ClickHouse. בוחרים באפשרות Verify SSL רק אם משתמשים באישור SSL שנחתם על ידי רשות אישורים מהימנה באופן כללי. אם אתם משתמשים באישור SSL בחתימה עצמית, אל תסמנו את ההגדרה הזו.
• פרמטרים נוספים של JDBC: (אופציונלי) פרמטרים נוספים של מחרוזת JDBC. רשימת הפרמטרים ש-Looker תומך בהם מופיעה בקטע פרמטרים נתמכים של JDBC בדף הזה.

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

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

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

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

ב-ClickHouse, ‏ Looker תומך בפרמטרים הבאים של JDBC בשדה Additional JDBC parameters (פרמטרים נוספים של JDBC) לחיבור. מידע על הפרמטרים האלה מופיע במאמרי העזרה של מסד הנתונים.

פרמטרים של ClickHouse 26+

• async_insert
• autoCommit
• compress
• compress_algorithm
• compress_level
• connect_timeout
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_settings
• database
• databaseTerm
• externalDatabase
• fetchSize
• format
• jdbcCompliant
• keep_alive_timeout
• max_buffer_size
• max_execution_time
• max_result_bytes
• max_result_rows
• max_threads
• namedParameter
• query_timeout
• receive_timeout
• result_overflow_mode
• retry
• session_check
• session_id
• session_timeout
• session_timezone
• socket_timeout
• ssl
• sslmode
• transactionSupport
• use_server_time_zone
• use_time_zone
• wait_for_async_insert
• wrapperObject

פרמטרים של ClickHouse (גרסה קודמת)

• beta.row_binary_for_simple_insert
• compress
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_http_headers
• custom_http_params
• default_query_settings
• disable_frameworks_detection
• jdbc_ignore_unsupported_values
• jdbc_resultset_auto_close
• jdbc_sql_parser
• jdbc_use_max_result_rows
• jdbcCompliance
• max_execution_time
• password
• session_timezone
• socket_timeout
• typeMappings
• use_server_time_zone
• use_time_zone
• user
• wrapperObject

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

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

תמיכה בתכונות של ClickHouse 26 ואילך

‫ClickHouse 26 ואילך תומך בתכונות הבאות החל מ-Looker 26.18:

התכונה	נתמך?
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
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
סקיצות HLL
מודעות מצטברת
PDT מצטברות
אלפיות השנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים אנליטיים במסד הנתונים
יומנים בהתאמה אישית

תמיכה בתכונות של ClickHouse

התכונות הבאות נתמכות ב-ClickHouse החל מ-Looker 26.18:

התכונה	נתמך?
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
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
סקיצות HLL
מודעות מצטברת
PDT מצטברות
אלפיות השנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים אנליטיים במסד הנתונים
יומנים בהתאמה אישית

השלבים הבאים

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