Как документировать макросы?

Чтобы документировать макросы, используйте файл схемы и вложите конфигурации под ключом macros:

Пример

macros/schema.yml

version: 2

macros:
  - name: cents_to_dollars
    description: Макрос для преобразования центов в доллары
    arguments:
      - name: column_name
        type: string
        description: Имя столбца, который вы хотите преобразовать
      - name: precision
        type: integer
        description: Количество десятичных знаков. По умолчанию 2.

Документирование пользовательской материализации

Когда вы создаете пользовательскую материализацию, dbt создает связанный макрос с следующим форматом:

materialization_{materialization_name}_{adapter}

Чтобы задокументировать пользовательскую материализацию, используйте ранее упомянутый формат, чтобы определить имя(на) связанного макроса для документирования.

macros/properties.yml

version: 2

macros:
  - name: materialization_my_materialization_name_default
    description: Пользовательская материализация для вставки записей в таблицу только для добавления и отслеживания времени их добавления.
  - name: materialization_my_materialization_name_xyz
    description: Пользовательская материализация для вставки записей в таблицу только для добавления и отслеживания времени их добавления.