# Подключение Vertica к dbt v1

Локальная разработка

ПЛАГИН С ПОДДЕРЖКОЙ ОТ ПОСТАВЩИКА

Если вы заинтересованы в участии, ознакомьтесь с исходным кодом для каждого из перечисленных ниже репозиториев.

* **Поддерживается**: Vertica
* **Авторы**: Vertica (Бывшие авторы: Matthew Carter, Andy Regan, Andrew Hedengren)
* **Репозиторий GitHub**: [vertica/dbt-vertica](https://github.com/vertica/dbt-vertica) [![](https://img.shields.io/github/stars/vertica/dbt-vertica?style=for-the-badge)](https://github.com/vertica/dbt-vertica)
* **Пакет PyPI**: `dbt-vertica` [![](https://badge.fury.io/py/dbt-vertica.svg)](https://badge.fury.io/py/dbt-vertica)
* **Канал Slack**: [n/a](https://www.getdbt.com/community/)
* **Поддерживаемая версия dbt**: v1.8.5 и новее
* **Поддержка dbt**: Не поддерживается
* **Минимальная версия платформы данных**: Vertica 24.3.0

## Установка dbt-vertica

Установите адаптер с помощью \`pip\`: `python -m pip install dbt-vertica`

## Настройка dbt-vertica

Конфигурацию, специфичную для Vertica, см. на странице [настроек Vertica.](https://docs.getdbt.tech/reference/resource-configs/vertica-configs.md)

### Подключение к Vertica с помощью dbt-vertica

#### Аутентификация с использованием имени пользователя и пароля

Настройте ваш dbt профиль для использования Vertica:

##### Информация о подключении к Vertica

profiles.yml

```yaml
your-profile:
  outputs:
    dev:
      type: vertica # Не изменяйте это!
      host: [hostname]
      port: [port] # или ваш пользовательский порт (опционально)
      username: [your username]
      password: [your password]
      database: [database name]
      oauth_access_token: [access token]
      schema: [dbt schema]
      connection_load_balance: True
      backup_server_node: [list of backup hostnames or IPs]
      retries: [1 or more]
      autocommit: False
      
      threads: [1 or more]
  target: dev
```

##### Описание полей профиля:

| Свойство                  | Описание                                                                                                                                                                                                                                                               | Обязательно? | Значение по умолчанию                                        | Пример                                                                                                        |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| type                      | Конкретный адаптер для использования.                                                                                                                                                                                                                                  | Да           | Нет                                                          | vertica                                                                                                       |
| host                      | Имя хоста или IP-адрес любого активного узла в сервере Vertica.                                                                                                                                                                                                        | Да           | Нет                                                          | 127.0.0.1                                                                                                     |
| port                      | Порт для использования, стандартный или пользовательский.                                                                                                                                                                                                              | Да           | 5433                                                         | 5433                                                                                                          |
| username                  | Имя пользователя для подключения к серверу.                                                                                                                                                                                                                            | Да           | Нет                                                          | dbadmin                                                                                                       |
| password                  | Пароль для аутентификации на сервере.                                                                                                                                                                                                                                  | Да           | Нет                                                          | my\_password                                                                                                  |
| database                  | Имя базы данных, работающей на сервере.                                                                                                                                                                                                                                | Да           | Нет                                                          | my\_db                                                                                                        |
| oauth\_access\_token      | Для аутентификации через OAuth предоставьте OAuth Access Token, который авторизует пользователя в базе данных.                                                                                                                                                         | Нет          | ""                                                           | По умолчанию: ""                                                                                              |
| schema                    | Схема для построения моделей.                                                                                                                                                                                                                                          | Нет          | Нет                                                          | VMart                                                                                                         |
| connection\_load\_balance | Логическое значение, указывающее, может ли соединение быть перенаправлено на другой хост в базе данных, отличный от host.                                                                                                                                              | Нет          | True                                                         | True                                                                                                          |
| backup\_server\_node      | Список хостов для подключения, если основной хост, указанный в соединении (host, port), недоступен. Каждый элемент в списке должен быть либо строкой хоста (используя стандартный порт 5433), либо кортежем (host, port). Хост может быть именем хоста или IP-адресом. | Нет          | Нет                                                          | \['123.123.123.123','[www.abc.com',('123.123.123.124',5433)](http://www.abc.com',\('123.123.123.124',5433\))] |
| retries                   | Количество попыток после неудачного соединения.                                                                                                                                                                                                                        | Нет          | 2                                                            | 3                                                                                                             |
| threads                   | Количество потоков, на которых будет работать проект dbt.                                                                                                                                                                                                              | Нет          | 1                                                            | 3                                                                                                             |
| label                     | Метка сессии для идентификации соединения.                                                                                                                                                                                                                             | Нет          | Автоматически сгенерированная метка в формате: dbt\_username | dbt\_dbadmin                                                                                                  |
| autocommit                | Логическое значение, указывающее, может ли соединение включать или отключать автофиксацию.                                                                                                                                                                             | Нет          | True                                                         | False                                                                                                         |

Для получения дополнительной информации о свойствах подключения Vertica, пожалуйста, обратитесь к [Vertica-Python](https://github.com/vertica/vertica-python#create-a-connection) Connection Properties.
