מנהלי התקנים של JDBC שלא נארזו

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

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

הגדרת Looker לשימוש במנהלי התקנים של JDBC שאינם ארוזים

עבור חלק מהדיאלקטים הנתמכים על ידי Looker, לא ניתן לארוז את מנהל ההתקן של JDBC בקובץ ה-JAR של Looker מסיבות הקשורות לרישוי. במקרים אלה, עליך להתקין את מנהל ההתקן JDBC בשרת Looker שלך ולאחר מכן להגדיר את Looker לרשום את מנהל ההתקן הלא ארוז כמתואר בדף זה.

כל הניבים עם ערך "לא" תחת "נתמך?" דורשים התקנות של מנהלי התקן JDBC לא ארוזים:

דיאלקט	נתמך?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MongoSQL
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

דרישות מוקדמות

כדי לחבר את Looker למסד נתונים הדורש מנהל התקן JDBC לא ארוגז, תזדקק לפרטים הבאים:

• גישה משורת הפקודה לשרת Looker שלך.
• מנהל התקן JDBC כקובץ JAR. ייתכן שבתיעוד הספציפי של הניב יהיו הוראות כיצד להוריד קובץ זה; אחרת, ההנחה היא שיש לך גישה לקובץ ה-JAR הדרוש.
• סמל הנהג עבור הניב שלך. סמל דרייבר הוא ערך מחרוזת בו Looker משתמש באופן פנימי כדי להתאים את הניב לדרייבר. הדוגמאות בדף זה משתמשות בערך הכללי driver_symbol. עיין בתיעוד של Looker עבור כל ניב עבור הסמלים שבהם Looker משתמש כדי לרשום מנהלי התקנים של JDBC לניבים.
• יש להוסיף את ערך מנהל ההתקן של YAML עבור הניב שלך לקובץ התצורה של custom_jdbc_config.yml. עיין בסעיף ערכי מנהל התקן בקובץ התצורה של YAML בדף זה לקבלת מידע נוסף.

ערכי מנהל התקן בקובץ התצורה של YAML

הנה דוגמה לערך מנהל התקן בקובץ custom_jdbc_config.yml:

  - name: driver_symbol
    dir_name: driver_symbol
    module_path: com.dialect.jdbc.DialectDriver
    override_jdbc_url_subprotocol: driver_subprotocol  # optional

בעת כתיבת ערך הדרייבר עבור הניב שלך:

• הקובץ custom_jdbc_config.yml מבוסס על YAML, מה שאומר שזיחה וריווח חשובים.
• המאפיינים name ו-dir_name חייבים להיות סמל הדרייבר שבו משתמש Looker עבור הניב שלך בעת רישום מנהלי התקנים של JDBC.
• ניתן להשתמש בתכונה file_name במקום dir_name המכילה את הנתיב היחסי מ-custom_jdbc_drivers לקובץ ה-JAR של מנהל ההתקן של JDBC. מומלץ להשתמש ב-dir_name מכיוון שהוא מקדם שמירה על מספר מנהלי התקנים מבודדים לספריות משלהם ומפחית את הסיכוי להתנגשות של מחלקות Java.
• המאפיין module_path יהיה תלוי במנהל התקן JDBC הספציפי. זה צריך להיות הנתיב המלא למחלקת מנהל ההתקן של Java. דוגמה זו משתמשת בערך כללי, אך כדי למצוא את ה-module_path הספציפי בו משתמש מנהל ההתקן, עיין בתיעוד שלו כיצד לרשום את מחלקת מנהל ההתקן.
• ה-override_jdbc_url_subprotocol הוא ארגומנט אופציונלי המשמש לעקיפה של תת-הפרוטוקול המשמש במחרוזת JDBC ש-Looker שולח למסד הנתונים. מחרוזת JDBC טיפוסית תיראה כך:

jdbc:mysql://localhost:3306/database_name[?propertyName1][=propertyValue1]

כאשר mysql הוא תת-פרוטוקול JDBC שבו נעשה שימוש.

אם תציין override_jdbc_url_subprotocol: driver_subprotocol, מחרוזת JDBC זו תהפוך ל:

jdbc:driver_subprotocol://localhost:3306/database_name[?propertyName1][=propertyValue1]

אפשרות זו נדרשת אם עליך להשתמש במנהל התקן JDBC לא ארוגז הדורש תת-פרוטוקול URL שאינו תת-פרוטוקול URL המוגדר כברירת מחדל של Looker. ברוב המקרים, זה לא הכרחי אלא אם כן התיעוד של הניב מציין זאת במפורש. MongoBI הוא דוגמה לניב הדורש אפשרות זו.

התקנת מנהלי התקנים של JDBC שאינם ארוזים

1. עבור לספריית הבסיס של יישום Looker. דוגמה זו משתמשת ב-looker כתיקיית הבסיס.

   cd looker
   

2. יוצרים ספרייה בשם custom_jdbc_drivers. זוהי הספרייה ברמה העליונה עבור כל התקנות מנהלי התקן JDBC שלא ארוזות. הנתיב לספרייה הזו צריך להיות looker/custom_jdbc_drivers

   mkdir custom_jdbc_drivers
   

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

   cd custom_jdbc_drivers
   mkdir driver_symbol
   

4. הנח את קבצי מנהל ההתקן של JDBC עבור הניב שלך בספרייה זו. השיטה לכך תלויה היכן ניתן למצוא את מנהל ההתקן של הניב שלך ולהעלות אותו לשרת, אך ודא שקובצי ה-JAR הרלוונטיים נמצאים בתוך הספרייה driver_symbol: looker/custom_jdbc_drivers/driver_symbol/

   לדוגמה: looker/custom_jdbc_drivers/driver_symbol/DialectDriver.jar

   אופן העברת הקבצים הדרושים לשרת Looker ישתנה בהתאם למקום שבו משיגים את קבצי הדרייבר ולהעדפתך להעברת קבצים. דוגמאות לפקודות להעברת קבצים לספרייה זו כוללות את wget, scp ו-curl.

5. שנה את הספרייה לספריית האפליקציה Looker, וצור קובץ תצורה בשם custom_jdbc_config.yml. הנתיב לקובץ הזה צריך להיות looker/custom_jdbc_config.yml. קובץ זה יכיל את המידע ש-Looker צריך כדי לאתר ולרשום את מנהל ההתקן JDBC המותאם אישית.

   cd looker
   vim custom_jdbc_config.yml
   

6. הוסף ערך חדש עבור הניב שלך לקובץ התצורה של custom_jdbc_config.yml. עיין בסעיף ערכי מנהלי התקנים בקובץ התצורה של YAML בדף זה לקבלת מידע על ערכי מנהלי התקנים.

   - name: driver_symbol
     dir_name: driver_symbol
     module_path: com.dialect.jdbc.DialectDriver
   

7. צור או עדכן את הקובץlookerstart.cfg כך שיישום Looker יופעל עם תצורת מנהל התקן JDBC שלא נפרקה. הנתיב לקובץ הזה צריך להיות looker/lookerstart.cfg. הוסף את האפשרות --use-custom-jdbc-config. אם ישנן אפשרויות נוספות, הוסף זאת לסוף אפשרויות ההפעלה של Looker:

   LOOKERARGS="--use-custom-jdbc-config"
   

   אם הגדרת את LOOKERARGS במקום אחר מלבד lookerstart.cfg, כמו במשתנה סביבה, תוכל להוסיף שם את דגל ההפעלה הזה. לחלופין, ניתן להגדיר LOOKERARGS="${LOOKERARGS} --use-custom-jdbc-config" כך שהערכים הקיימים יורחבו לקובץ זה.

8. הפעל מחדש את אפליקציית Looker. בפקודה זו, השתמש בשם סקריפט ההפעלה של Looker שלך, כגון ./looker או ./looker.sh

   ./looker restart
   

   או none ./looker stop ./looker start

מספר מנהלי התקנים של JDBC שאינם ארוזים

אם עליך להגדיר יותר מדיאלקט אחד לשימוש במנהלי התקנים של JDBC שאינם ארוזים, התהליך המתואר בסעיף התקנת מנהלי התקנים של JDBC שאינם ארוזים עדיין חל. לספרייה custom_jdbc_drivers יהיו מספר ספריות משנה של dialect עם קבצי JAR משלהן, ולקובץ custom_jdbc_config.yml יהיו מספר ערכים:

ls looker/custom_jdbc_drivers

driver_symbol_1 driver_symbol_2

ls looker/custom_jdbc_drivers/driver_symbol_1

Dialect1Driver.jar

- name: driver_symbol_1
  dir_name: driver_symbol_1
  module_path: com.dialect.jdbc.Dialect1Driver

- name: driver_symbol_2
  dir_name: driver_symbol_2
  module_path: com.dialect.jdbc.Dialect2Driver