# Свойства источников

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

* [Использование источников](https://docs.getdbt.tech/docs/build/sources.md)
* [Объявление свойств ресурсов](https://docs.getdbt.tech/reference/configs-and-properties.md)

## Обзор

Свойства источников могут быть объявлены в любом файле `properties.yml` в вашем каталоге `models/` (как определено в [конфигурации `model-paths`](https://docs.getdbt.tech/reference/project-configs/model-paths.md)). Свойства источников — это «особые свойства», потому что вы не можете настраивать их в файле `dbt_project.yml` или с помощью блоков `config()`. Подробнее см. [Конфигурация и свойства](https://docs.getdbt.com/reference/define-properties#which-properties-are-not-also-configs).<br />

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

models/\<filename>.yml

```yml
sources:
  - name: <string> # обязательно
    description: <markdown_string>
    database: <database_name>
    schema: <schema_name>
    loader: <string>

config: # требуется v1.1+
      <source_config>: <config_value>
      loaded_at_field: <column_name> # перемещено в config в v1.10
      freshness: # перемещено в config в v1.10
        warn_after:
          count: <positive_integer>
          period: minute | hour | day
        error_after:
count: <positive_integer>
          period: minute | hour | day
        filter: <where-condition>
      meta: {<dictionary>} # перенесено в config в v1.10
      tags: [<string>] # перенесено в config в v1.10

    overrides: <string> # устарело в v1.10

    quoting:
      database: true | false
      schema: true | false
      identifier: true | false

    tables:
      - name: <string> # обязательно
        description: <markdown_string>
        identifier: <table_name>
        data_tests:
          - <test>
          - ... # объявите дополнительные тесты
        config:
          loaded_at_field: <column_name>
          meta: {<dictionary>}
          tags: [<string>]
          freshness:
            warn_after:
              count: <positive_integer>
              period: minute | hour | day
            error_after:
              count: <positive_integer>
              period: minute | hour | day
            filter: <where-condition>

        quoting:
          database: true | false
          schema: true | false
          identifier: true | false
        external: {<dictionary>}
        columns:
          - name: <column_name> # обязательно
            description: <markdown_string>
            quote: true | false
            data_tests:
              - <test>
              - ... # объявите дополнительные тесты
            config:
              meta: {<dictionary>}
              tags: [<string>]
          - name: ... # объявите свойства дополнительных колонок

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

  - name: ... # объявите свойства дополнительных источников
```

## Пример

models/\<filename>.yml

```yaml

sources:
  - name: jaffle_shop
    database: raw
    schema: public
    loader: emr # только для информации (произвольный текст)

    config:
      # перенесено в config в v1.10
      loaded_at_field: _loaded_at # настраивается для всех источников
      # поля meta отображаются в автоматически сгенерированной документации
      meta: # перенесено в config в v1.10
        contains_pii: true
        owner: "@alice"

      # Добавьте теги для этого источника
      tags: # перенесено в config в v1.10
        - ecom
        - pii

    quoting:
      database: false
      schema: false
      identifier: false

    tables:
      - name: orders
        identifier: Orders_
        config:
          # перенесено в config в v1.10
          loaded_at_field: updated_at # переопределяет настройки источника по умолчанию
        columns:
          - name: id
            data_tests:
              - unique

          - name: price_in_usd
            data_tests:
              - not_null

      - name: customers
        quoting:
          identifier: true # переопределяет настройки источника по умолчанию
        columns:
            data_tests:
              - unique
```
