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 למסד הנתונים

בקטע Admin ב-Looker, בוחרים באפשרות Connections ולוחצים על Add Connection.

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

• Dialect: בוחרים באפשרות 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).
• ‫Username: שם המשתמש של מסד הנתונים.
• ‫Password: סיסמת מסד הנתונים.
• ‫SSL: מסמנים את האפשרות הזו כדי להתחבר ל-ClickHouse באמצעות SSL/TLS.
• ‫Verify SSL: (אופציונלי) מסמנים את התיבה כדי לאכוף אימות קפדני של אישור ה-SSL ושם המארח בשרת ClickHouse. בוחרים באפשרות אימות SSL רק אם משתמשים באישור SSL שנחתם על ידי רשות אישורים מהימנה באופן כללי. אם אתם משתמשים באישור SSL בחתימה עצמית, אל תסמנו את ההגדרה הזו.
• ‫Additional JDBC parameters: (אופציונלי) פרמטרים נוספים של מחרוזת JDBC. בקטע פרמטרים נתמכים של JDBC שבדף הזה מפורטים הפרמטרים שנתמכים ב-Looker.

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

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

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

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

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

פרמטרים של 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
• ssl_mode
• 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 ואילך

החל מגרסה 26.20 של Looker, גרסה 26 ומעלה של ClickHouse תומכת בתכונות הבאות:

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

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

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

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

השלבים הבאים

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