# Конфигурации Cloudera Hive

## Конфигурация таблиц

При материализации модели как `table`, вы можете включить несколько дополнительных конфигураций, которые специфичны для плагина dbt-hive, в дополнение к стандартным [конфигурациям моделей](https://docs.getdbt.tech/reference/model-configs.md).

| Опция           | Описание                                                                                                                   | Обязательно? | Пример                               |
| --------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------ |
| partition\_by   | разбиение по колонке; как правило, для каждого раздела создаётся отдельная директория                                      | No           | partition\_by=\['name']              |
| clustered\_by   | второй уровень разбиения внутри секции, заданной partitioned column                                                        | No           | clustered\_by=\['age']               |
| file\_format    | базовый формат хранения таблицы; поддерживаемые форматы см. <https://cwiki.apache.org/confluence/display/Hive/FileFormats> | No           | file\_format='PARQUET'               |
| location        | место хранения данных, как правило путь в HDFS                                                                             | No           | LOCATION='/user/etl/destination'     |
| comment         | комментарий к таблице                                                                                                      | No           | comment='this is the cleanest model' |
| external        | является ли таблица внешней — true / false                                                                                 | No           | external=true                        |
| tbl\_properties | произвольные метаданные, которые могут быть сохранены в виде пар ключ/значение у таблицы                                   | No           | tbl\_properties="('dbt\_test'='1')"  |
| table\_type     | указывает тип таблицы                                                                                                      | No           | table\_type="iceberg"                |

## Инкрементные модели

Поддерживаемые режимы для инкрементной модели:

* **`append`** (по умолчанию): Вставка новых записей без обновления или перезаписи существующих данных.
* **`insert_overwrite`**: Для новых записей вставка данных. При использовании вместе с разделом partition обновление данных для измененной записи и вставка данных для новых записей.

## Пример: Использование опции конфигурации partition\_by

hive\_partition\_by.sql

```sql
{{
    config(
        materialized='table',
        unique_key='id',
        partition_by=['city'],
    )
}}

with source_data as (
     select 1 as id, "Name 1" as name, "City 1" as city,
     union all
     select 2 as id, "Name 2" as name, "City 2" as city,
     union all
     select 3 as id, "Name 3" as name, "City 2" as city,
     union all
     select 4 as id, "Name 4" as name, "City 1" as city,
)

select * from source_data
```

В приведенном выше примере создается пример таблицы с использованием опции partition\_by и других конфигураций. Одно из важных замечаний при использовании опции partition\_by заключается в том, что в запросе select всегда должен быть указан столбец, используемый в опции partition\_by, последним, как это видно для столбца `city` в приведенном выше запросе. Если раздел partition\_by не совпадает с последним столбцом в операторе select, Hive выдаст ошибку при попытке создать модель.
