Предположим, мы создали таблицу:
create table site_users ( id INT NOT NULL, username INT );
Для комментарием используется специальная команда COMMENT ON, например:
./yii migrate/create create_name_table
Подробнее о миграциях здесь