Rebase #7223: improve contracts error message

[jtcohen6]

resolves #7209
rebases #7223

Description

@kentkr did the heavy lifting here! I just added a few small touch-ups:

• Only display columns with diffs / mismatches
• Use agate for structured representation, and to print to stdout in a markdown table

09:52:16  Completed with 1 error and 0 warnings:
09:52:16
09:52:16  Compilation Error in model my_important_model (models/.../my_important_model.sql)
09:52:16    This model has an enforced contract that failed.
09:52:16    Please ensure the name, data_type, and number of columns in your contract match the columns in your model's definition.
09:52:16
09:52:16    | column_name                 | definition_type | contract_type | mismatch_reason       |
09:52:16    | --------------------------- | --------------- | ------------- | --------------------- |
09:52:16    | ADDRESS_ZIP                 | TEXT            | FIXED         | data type mismatch    |
09:52:16    | HAS_DOCS                    | FIXED           | BOOLEAN       | data type mismatch    |
09:52:16    | HAS_SUCCESSFUL_SESSION      | FIXED           |               | missing in contract   |
09:52:16    | HAS_VERY_SUCCESSFUL_SESSION |                 | FIXED         | missing in definition |
09:52:16
09:52:16
09:52:16    > in macro assert_columns_equivalent (macros/materializations/models/table/columns_spec_ddl.sql)
09:52:16    > called by macro default__get_assert_columns_equivalent (macros/materializations/models/table/columns_spec_ddl.sql)
09:52:16    > called by macro get_assert_columns_equivalent (macros/materializations/models/table/columns_spec_ddl.sql)
09:52:16    > called by macro snowflake__create_table_as (macros/adapters.sql)
09:52:16    > called by macro create_table_as (macros/materializations/models/table/create_table_as.sql)
09:52:16    > called by macro statement (macros/etc/statement.sql)
09:52:16    > called by macro materialization_table_snowflake (macros/materializations/table.sql)
09:52:16    > called by model my_important_model (models/.../my_important_model.sql)

Checklist

• I have read the contributing guide and understand what's expected of me
• I have signed the CLA
• I have run this code in development and it appears to resolve the stated issue
• This PR includes tests, or tests are not required/relevant for this PR
• I have opened an issue to add/update docs, or docs changes are not required/relevant for this PR
• I have run changie new to create a changelog entry

[cla-bot]

Thank you for your pull request and welcome to our community. We could not parse the GitHub identity of the following contributors: Kyle Kent.
This is most likely caused by a git client misconfiguration; please make sure to:

1. check if your git client is configured with an email to sign commits git config --list | grep email
2. If not, set it up using git config --global user.email email@example.com
3. Make sure that the git commit email is configured in your GitHub account settings, see https://github.com/settings/emails

[MichelleArk]

💯✨

[MichelleArk]

for my own understanding - any reason not to do the comparison on data_type at this point?

[jtcohen6]

@MichelleArk Good point! Since we're already comparing columns with the same name, might as well compare just the data_type instead of the formatted value.

This was just how Kyle had it, and it does match the logic here performing the functional comparison.

[kentkr]

Thanks @jtcohen6 !

[dbeatty10]

Nice work @kentkr ! 🏆