Supporting time travel parsing

[dmelchor-stripe]

Is your feature request related to a problem? Please describe.
Hi folks, we would love to be able to parse SQL statements that use time travel queries. Currently, trying to parse these results in an error.

Describe the solution you'd like
It would be great if exp.Table had a version/timestamp arg key. For example, for the query:

SELECT *
FROM example.testdb.customer_orders FOR VERSION AS OF 8954597067493422955

A syntax similar to:

(FROM this:
    (TABLE this:
      (IDENTIFIER this: customer_orders, quoted: False), db:
      (IDENTIFIER this: testdb, quoted: False), catalog:
      (IDENTIFIER this: example, quoted: False), version:
      (LITERAL this: 8954597067493422955, is_string: False)
))

And for the query:

SELECT *
FROM example.testdb.customer_orders FOR TIMESTAMP AS OF TIMESTAMP '2022-03-23 09:59:29.803 Europe/Vienna'

A syntax similar to:

(FROM this:
    (TABLE this:
      (IDENTIFIER this: customer_orders, quoted: False), db:
      (IDENTIFIER this: testdb, quoted: False), catalog:
      (IDENTIFIER this: example, quoted: False), timestamp:
      (CAST this:
          (LITERAL this: 2022-03-23 09:59:29.803 Europe/Vienna, is_string: True), to:
          (DATATYPE this: Type.TIMESTAMP, nested: False, prefix: False))
))

Describe alternatives you've considered
Currently, we are using regular expressions to find text matching time travel syntax and appending the version to the table name so that it can be parsed:

SELECT *
FROM example.testdb."customer_orders@8954597067493422955"

Additional context

• Trino docs for time travel queries: https://trino.io/docs/current/connector/iceberg.html?highlight=snapshot#using-snapshots.
• Spark (databricks) docs: https://www.databricks.com/blog/2019/02/04/introducing-delta-time-travel-for-large-scale-data-lakes.html

[z3z1ma]

BQ docs: https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#for_system_time_as_of