Свойства экспозиций

Связанная документация

• Использование экспозиций
• Объявление свойств ресурсов

Обзор

Экспозиции определяются в файлах properties.yml, вложенных под ключом exposures:. Вы можете определять exposures в YAML-файлах, которые также определяют sources или models. Свойства экспозиций являются "особыми свойствами", поскольку их нельзя настроить в файле dbt_project.yml или с помощью блоков config(). Обратитесь к разделу Конфигурации и свойства для получения дополнительной информации.

Вы можете назвать эти файлы как угодно, например, whatever_you_want.yml, и вложить их на любую глубину в подкаталоги внутри директории models/.

Имена экспозиций должны содержать только буквы, цифры и подчеркивания (без пробелов или специальных символов). Для короткого, удобного для чтения имени с заглавными буквами, пробелами и специальными символами используйте свойство label.

models/<filename>.yml

version: 2

exposures:
  - name: <string_with_underscores>
    description: <markdown_string>
    type: {dashboard, notebook, analysis, ml, application}
    url: <string>
    maturity: {high, medium, low}  # Указывает уровень уверенности или стабильности в экспозиции
    tags: [<string>]
    meta: {<dictionary>}
    owner:
      name: <string>
      email: <string>
    
    depends_on:
      - ref('model')
      - ref('seed')
      - source('name', 'table')
      - metric('metric_name')
      
    label: "Человеко-дружественное имя для этой экспозиции!"
    config:
      enabled: true | false

  - name: ... # объявление свойств дополнительных экспозиций

Пример

models/jaffle/exposures.yml

version: 2

exposures:

  - name: weekly_jaffle_metrics
    label: Jaffles by the Week              # необязательно
    type: dashboard                         # обязательно
    maturity: high                          # необязательно
    url: https://bi.tool/dashboards/1       # необязательно
    description: >                          # необязательно
      Кто-то сказал "экспоненциальный рост"?

    depends_on:                             # ожидается
      - ref('fct_orders')
      - ref('dim_customers')
      - source('gsheets', 'goals')
      - metric('count_orders')

    owner:
      name: Callum McData
      email: data@jaffleshop.com


      
  - name: jaffle_recommender
    maturity: medium
    type: ml
    url: https://jupyter.org/mycoolalg
    description: >
      Глубокое обучение для персонализированного "Откройте для себя бутерброды еженедельно"
    
    depends_on:
      - ref('fct_orders')
      
    owner:
      name: Data Science Drew
      email: data@jaffleshop.com

      
  - name: jaffle_wrapped
    type: application
    description: Сообщите пользователям об их любимых jaffles за год
    depends_on: [ ref('fct_orders') ]
    owner: { email: summer-intern@jaffleshop.com }