feat: Add tables to the SDK

[sfc-gh-pbosak]

This change was waiting really long to be finally merged. There were plenty of changes in the repository during this time. There were also some changes in the documentation. This is the first PR that aims to merge this functionality and correct/update it later in the following PR(s).

Changes

• Added the table to the SDK:
  • Merged main to this stale PR.
  • Added implementation based on references.
  • Both tables and external tables used the same objects (now extracted to common_table_types.go).
  • Implementation of the table from 2-3 months before could not use stages which we have now; now they can be used.

Follow-up plan

• add missing describe operations
• use predefined errors instead of defining a bunch of the new ones
• use assertion helpers in unit tests
• use a common database and schema in integration tests
• validate if all needed integration tests are present
• fix cleanup methods in integration tests
• add better assertions in integration tests (assert the whole objects/columns)
• replace the createTable function in helper with implementation using the newly created table client
• validate if ShowByID can be rewritten to use in database/in schema syntax
• validations: check if all added ones have unit tests
• validations: check if all validations are present
• add missing documentation links to common types
• move implementation between files to conform with our current conventions
• validate if all methods were implemented and whether they were implemented correctly

Operations NOT supported in this PR

• show columns
• show primary keys
• describe search optimization
• truncate table
• undrop table
• check constraints in tests: https://docs.snowflake.com/en/sql-reference/info-schema/table_constraints is needed
• create table using a template - still needs some work (it behaves strangely in test)
• fix tests regarding ALTER TABLE <name> ALTER CONSTRAINT <constraint_name> ( <col_name> ) - it conforms with the documentation: https://docs.snowflake.com/en/sql-reference/sql/alter-table#syntax but fails with Syntax error: unexpected '('. (line 7)

Test Plan

• unit tests (SQL generation and validations)
• integration tests (SQL invocation)
• acceptance tests (nothing should break yet)

References

• CREATE
• ALTER
• DROP
• SHOW
• DESCRIBE
• CREATE TABLE CONSTRAINT

[github-actions]

Integration tests failure for e2523df6aeeb930c3e013a14253196ab80018501

[github-actions]

Integration tests failure for bba3a83985f35e3556a4d4deb10a00f2ace4285a

[github-actions]

Integration tests failure for e4642af69f35964593715d1235c5d14cc06b3ca2

[github-actions]

Integration tests failure for 0a659ffa278af752b6c176f5791f8942e8911a0d

[github-actions]

Integration tests failure for 06ae64cae35bbe07de16d1748d6a030071accd58

[github-actions]

Integration tests failure for cb1ea66f4694b11d2abb1ae83c2d2c8eaec3cd66

[github-actions]

Integration tests failure for 56ed0c8ad06dc546b7542b3f400b73267b2dca02

[github-actions]

Integration tests failure for d0aed52e03168bffcf2b8b5f87ed46b55ce7ec9b

[github-actions]

Integration tests failure for ea2e35ac72fcbeebb7f378a2bdfd8b97e093b4a8

[github-actions]

Integration tests failure for 6f924bdc0f015d96cc5abf33886b27f01b1769c9