Inline комментарии в SQL целесообразно применять в следующих ситуациях:
- для объяснения сложной логики кода, чтобы помочь будущим разработчикам или продвинутым бизнес-пользователям понять, что делают конкретные блоки кода; docs.getdbt.com
- для объяснения нишевой, уникальной для бизнеса логики; docs.getdbt.com
- для разделения типов полей (например, идентификаторов, логических значений, строк, дат, чисел и временных меток) в промежуточных моделях для создания более читаемых, организованных и формальных моделей; docs.getdbt.com
- для чёткой маркировки технического долга (например, -- [TODO]: TECH DEBT) в запросах или моделях. docs.getdbt.com
Однако стоит использовать inline комментарии с осторожностью, так как их избыток может сделать строки слишком длинными и трудными для чтения. codevisionz.com