Конектор джерела для Hive¶

У цьому посібнику описано, як налаштувати digna для підключення до Apache Hive через ODBC за допомогою рядка підключення без DSN.

Налаштування на боці digna однакове для всіх технологій — де створюються підключення, як шифруються значення властивостей, як тестується підключення та що означають режими профілювання. Це описано в розділі Огляд підключень до баз даних. Ця сторінка охоплює те, що специфічне для Hive.

1. Встановлення драйвера ODBC¶

Встановіть Cloudera ODBC Driver for Apache Hive на машині, де працює бекенд digna, відповідно до офіційного посібника зі встановлення від постачальника.

Прочитайте точну зареєстровану назву драйвера на своєму хості, як описано в розділі Встановлення драйвера ODBC на хості digna.

2. Властивості ODBC¶

Приклад, а не специфікація

Наведений нижче набір — одна комбінація, яка гарантовано працює. Властивості належать драйверу Cloudera Hive, тому їхні назви, значення за замовчуванням і допустимі значення відрізняються між версіями драйвера та платформами, а те, що приймає HiveServer2, повністю залежить від захисту кластера — механізму автентифікації, режиму транспорту, TLS, шлюзу. Використовуйте це як відправну точку та звіряйтеся з документацією встановленої версії драйвера.

Додайте такі властивості на екрані Add DB Connection:

Ключ	Приклад значення	Примітки
`DRIVER`	`Cloudera ODBC Driver for Apache Hive`	Має збігатися з назвою драйвера, зареєстрованою на хості digna
`HOST`	`hive.example.com`	Ім'я хоста або IP-адреса HiveServer2
`PORT`	`10000`	Порт HiveServer2; `10001` для транспорту HTTP

Отриманий рядок підключення виглядає так:

DRIVER=Cloudera ODBC Driver for Apache Hive;HOST=hive.example.com;PORT=10000

Автентифікація¶

Незахищений HiveServer2 приймає три наведені вище властивості без змін. Якщо автентифікацію ввімкнено, додайте:

Ключ	Приклад значення	Примітки
`AuthMech`	`3`	`0` без автентифікації, `2` лише ім'я користувача, `3` ім'я користувача та пароль, `1` Kerberos
`UID`	`digna_source_user`	Потрібне для `AuthMech` `2` і `3`
`PWD`	`<password>`	Потрібне для `AuthMech` `3`. Позначте Encrypted

Для Kerberos (AuthMech=1) хосту digna додатково потрібні дійсний квиток або keytab, а також властивості KrbHostFQDN, KrbServiceName і KrbRealm, описані в документації драйвера.

Транспорт і TLS¶

Ключ	Приклад значення	Примітки
`ThriftTransport`	`2`	`0` бінарний (за замовчуванням, порт 10000), `1` SASL, `2` HTTP (порт 10001, його очікує шлюз Knox)
`HTTPPath`	`cliservice`	З `ThriftTransport=2`
`SSL`	`1`	Якщо HiveServer2 захищено TLS
`Schema`	`dignadata`	База даних Hive, з якої починається сесія. Необов'язково — digna уточнює свої запити повними іменами

3. Налаштування digna¶

На екрані Add DB Connection вкажіть таке:

Name:               Name of the connection. This is used for referencing the connection in other screens.
Technology:         Hive
Profiling Mode:     Standard, Permanent or Session
Work Schema:        Hive database for the work tables of "Permanent" profiling, e.g. "digna_work"

4. Примітки щодо Hive¶

Каталоги надходять від драйвера. Hive не має власного каталогу, тому digna бере те, що повідомляє драйвер — зазвичай один запис із назвою HIVE — і показує бази даних Hive як схеми під ним.
Work Schema — це база даних Hive. Для профілювання Permanent користувачеві потрібне право створювати й видаляти в ній таблиці, а базове місце зберігання має бути доступним для запису.
Режими профілювання. Permanent створює робочі таблиці в Work Schema. Session використовує CREATE TEMPORARY TABLE, для чого потрібен HiveServer2 із підтримкою тимчасових таблиць, і не зачіпає Work Schema. Standard потребує лише доступу для читання і є режимом для кластера, де digna взагалі не має доступу на запис.
Профілювання — це набір запитів, а не сканування. Кожну статистику обчислює HiveServer2, тому черга, до якої надсилає запити користувач digna, повинна мати достатньо ресурсів на час вікна інспекції.

5. Перевірка драйвера (необов'язково)¶

Для підключення без DSN налаштовувати джерело даних ODBC не потрібно, але власний діалог драйвера — зручний спосіб переконатися, що драйвер, режим транспорту та ваші облікові дані працюють, перш ніж вводити їх у digna.

Крок 1¶

Step 1

Поля Host, Port, Database, Mechanism і Thrift Transport тут відповідають властивостям HOST, PORT, Schema, AuthMech і ThriftTransport з розділу 2.

Крок 2 – Тестування підключення¶

Введіть пароль і натисніть кнопку Test.

Step 2

Після успішного тесту натисніть кнопку OK.