sqlglot.dialects.bigquery API documentation

Edit on GitHub

# sqlglot.dialects.bigquery

View Source

       1from __future__ import annotations
       2
       3import logging
       4import re
       5import typing as t
       6
       7from sqlglot import exp, generator, parser, tokens, transforms
       8from sqlglot.dialects.dialect import (
       9    Dialect,
      10    NormalizationStrategy,
      11    arg_max_or_min_no_count,
      12    binary_from_function,
      13    date_add_interval_sql,
      14    datestrtodate_sql,
      15    build_formatted_time,
      16    filter_array_using_unnest,
      17    if_sql,
      18    inline_array_unless_query,
      19    max_or_greatest,
      20    min_or_least,
      21    no_ilike_sql,
      22    build_date_delta_with_interval,
      23    regexp_replace_sql,
      24    rename_func,
      25    sha256_sql,
      26    timestrtotime_sql,
      27    ts_or_ds_add_cast,
      28    unit_to_var,
      29    strposition_sql,
      30)
      31from sqlglot.helper import seq_get, split_num_words
      32from sqlglot.tokens import TokenType
      33from sqlglot.generator import unsupported_args
      34
      35if t.TYPE_CHECKING:
      36    from sqlglot._typing import E, Lit
      37
      38    from sqlglot.optimizer.annotate_types import TypeAnnotator
      39
      40logger = logging.getLogger("sqlglot")
      41
      42
      43JSON_EXTRACT_TYPE = t.Union[exp.JSONExtract, exp.JSONExtractScalar, exp.JSONExtractArray]
      44
      45DQUOTES_ESCAPING_JSON_FUNCTIONS = ("JSON_QUERY", "JSON_VALUE", "JSON_QUERY_ARRAY")
      46
      47
      48def _derived_table_values_to_unnest(self: BigQuery.Generator, expression: exp.Values) -> str:
      49    if not expression.find_ancestor(exp.From, exp.Join):
      50        return self.values_sql(expression)
      51
      52    structs = []
      53    alias = expression.args.get("alias")
      54    for tup in expression.find_all(exp.Tuple):
      55        field_aliases = (
      56            alias.columns
      57            if alias and alias.columns
      58            else (f"_c{i}" for i in range(len(tup.expressions)))
      59        )
      60        expressions = [
      61            exp.PropertyEQ(this=exp.to_identifier(name), expression=fld)
      62            for name, fld in zip(field_aliases, tup.expressions)
      63        ]
      64        structs.append(exp.Struct(expressions=expressions))
      65
      66    # Due to `UNNEST_COLUMN_ONLY`, it is expected that the table alias be contained in the columns expression
      67    alias_name_only = exp.TableAlias(columns=[alias.this]) if alias else None
      68    return self.unnest_sql(
      69        exp.Unnest(expressions=[exp.array(*structs, copy=False)], alias=alias_name_only)
      70    )
      71
      72
      73def _returnsproperty_sql(self: BigQuery.Generator, expression: exp.ReturnsProperty) -> str:
      74    this = expression.this
      75    if isinstance(this, exp.Schema):
      76        this = f"{self.sql(this, 'this')} <{self.expressions(this)}>"
      77    else:
      78        this = self.sql(this)
      79    return f"RETURNS {this}"
      80
      81
      82def _create_sql(self: BigQuery.Generator, expression: exp.Create) -> str:
      83    returns = expression.find(exp.ReturnsProperty)
      84    if expression.kind == "FUNCTION" and returns and returns.args.get("is_table"):
      85        expression.set("kind", "TABLE FUNCTION")
      86
      87        if isinstance(expression.expression, (exp.Subquery, exp.Literal)):
      88            expression.set("expression", expression.expression.this)
      89
      90    return self.create_sql(expression)
      91
      92
      93# https://issuetracker.google.com/issues/162294746
      94# workaround for bigquery bug when grouping by an expression and then ordering
      95# WITH x AS (SELECT 1 y)
      96# SELECT y + 1 z
      97# FROM x
      98# GROUP BY x + 1
      99# ORDER by z
     100def _alias_ordered_group(expression: exp.Expression) -> exp.Expression:
     101    if isinstance(expression, exp.Select):
     102        group = expression.args.get("group")
     103        order = expression.args.get("order")
     104
     105        if group and order:
     106            aliases = {
     107                select.this: select.args["alias"]
     108                for select in expression.selects
     109                if isinstance(select, exp.Alias)
     110            }
     111
     112            for grouped in group.expressions:
     113                if grouped.is_int:
     114                    continue
     115                alias = aliases.get(grouped)
     116                if alias:
     117                    grouped.replace(exp.column(alias))
     118
     119    return expression
     120
     121
     122def _pushdown_cte_column_names(expression: exp.Expression) -> exp.Expression:
     123    """BigQuery doesn't allow column names when defining a CTE, so we try to push them down."""
     124    if isinstance(expression, exp.CTE) and expression.alias_column_names:
     125        cte_query = expression.this
     126
     127        if cte_query.is_star:
     128            logger.warning(
     129                "Can't push down CTE column names for star queries. Run the query through"
     130                " the optimizer or use 'qualify' to expand the star projections first."
     131            )
     132            return expression
     133
     134        column_names = expression.alias_column_names
     135        expression.args["alias"].set("columns", None)
     136
     137        for name, select in zip(column_names, cte_query.selects):
     138            to_replace = select
     139
     140            if isinstance(select, exp.Alias):
     141                select = select.this
     142
     143            # Inner aliases are shadowed by the CTE column names
     144            to_replace.replace(exp.alias_(select, name))
     145
     146    return expression
     147
     148
     149def _build_parse_timestamp(args: t.List) -> exp.StrToTime:
     150    this = build_formatted_time(exp.StrToTime, "bigquery")([seq_get(args, 1), seq_get(args, 0)])
     151    this.set("zone", seq_get(args, 2))
     152    return this
     153
     154
     155def _build_timestamp(args: t.List) -> exp.Timestamp:
     156    timestamp = exp.Timestamp.from_arg_list(args)
     157    timestamp.set("with_tz", True)
     158    return timestamp
     159
     160
     161def _build_date(args: t.List) -> exp.Date | exp.DateFromParts:
     162    expr_type = exp.DateFromParts if len(args) == 3 else exp.Date
     163    return expr_type.from_arg_list(args)
     164
     165
     166def _build_to_hex(args: t.List) -> exp.Hex | exp.MD5:
     167    # TO_HEX(MD5(..)) is common in BigQuery, so it's parsed into MD5 to simplify its transpilation
     168    arg = seq_get(args, 0)
     169    return exp.MD5(this=arg.this) if isinstance(arg, exp.MD5Digest) else exp.LowerHex(this=arg)
     170
     171
     172def _array_contains_sql(self: BigQuery.Generator, expression: exp.ArrayContains) -> str:
     173    return self.sql(
     174        exp.Exists(
     175            this=exp.select("1")
     176            .from_(exp.Unnest(expressions=[expression.left]).as_("_unnest", table=["_col"]))
     177            .where(exp.column("_col").eq(expression.right))
     178        )
     179    )
     180
     181
     182def _ts_or_ds_add_sql(self: BigQuery.Generator, expression: exp.TsOrDsAdd) -> str:
     183    return date_add_interval_sql("DATE", "ADD")(self, ts_or_ds_add_cast(expression))
     184
     185
     186def _ts_or_ds_diff_sql(self: BigQuery.Generator, expression: exp.TsOrDsDiff) -> str:
     187    expression.this.replace(exp.cast(expression.this, exp.DataType.Type.TIMESTAMP))
     188    expression.expression.replace(exp.cast(expression.expression, exp.DataType.Type.TIMESTAMP))
     189    unit = unit_to_var(expression)
     190    return self.func("DATE_DIFF", expression.this, expression.expression, unit)
     191
     192
     193def _unix_to_time_sql(self: BigQuery.Generator, expression: exp.UnixToTime) -> str:
     194    scale = expression.args.get("scale")
     195    timestamp = expression.this
     196
     197    if scale in (None, exp.UnixToTime.SECONDS):
     198        return self.func("TIMESTAMP_SECONDS", timestamp)
     199    if scale == exp.UnixToTime.MILLIS:
     200        return self.func("TIMESTAMP_MILLIS", timestamp)
     201    if scale == exp.UnixToTime.MICROS:
     202        return self.func("TIMESTAMP_MICROS", timestamp)
     203
     204    unix_seconds = exp.cast(
     205        exp.Div(this=timestamp, expression=exp.func("POW", 10, scale)), exp.DataType.Type.BIGINT
     206    )
     207    return self.func("TIMESTAMP_SECONDS", unix_seconds)
     208
     209
     210def _build_time(args: t.List) -> exp.Func:
     211    if len(args) == 1:
     212        return exp.TsOrDsToTime(this=args[0])
     213    if len(args) == 2:
     214        return exp.Time.from_arg_list(args)
     215    return exp.TimeFromParts.from_arg_list(args)
     216
     217
     218def _build_datetime(args: t.List) -> exp.Func:
     219    if len(args) == 1:
     220        return exp.TsOrDsToDatetime.from_arg_list(args)
     221    if len(args) == 2:
     222        return exp.Datetime.from_arg_list(args)
     223    return exp.TimestampFromParts.from_arg_list(args)
     224
     225
     226def _build_regexp_extract(
     227    expr_type: t.Type[E], default_group: t.Optional[exp.Expression] = None
     228) -> t.Callable[[t.List], E]:
     229    def _builder(args: t.List) -> E:
     230        try:
     231            group = re.compile(args[1].name).groups == 1
     232        except re.error:
     233            group = False
     234
     235        # Default group is used for the transpilation of REGEXP_EXTRACT_ALL
     236        return expr_type(
     237            this=seq_get(args, 0),
     238            expression=seq_get(args, 1),
     239            position=seq_get(args, 2),
     240            occurrence=seq_get(args, 3),
     241            group=exp.Literal.number(1) if group else default_group,
     242        )
     243
     244    return _builder
     245
     246
     247def _build_extract_json_with_default_path(expr_type: t.Type[E]) -> t.Callable[[t.List, Dialect], E]:
     248    def _builder(args: t.List, dialect: Dialect) -> E:
     249        if len(args) == 1:
     250            # The default value for the JSONPath is '$' i.e all of the data
     251            args.append(exp.Literal.string("$"))
     252        return parser.build_extract_json_with_path(expr_type)(args, dialect)
     253
     254    return _builder
     255
     256
     257def _str_to_datetime_sql(
     258    self: BigQuery.Generator, expression: exp.StrToDate | exp.StrToTime
     259) -> str:
     260    this = self.sql(expression, "this")
     261    dtype = "DATE" if isinstance(expression, exp.StrToDate) else "TIMESTAMP"
     262
     263    if expression.args.get("safe"):
     264        fmt = self.format_time(
     265            expression,
     266            self.dialect.INVERSE_FORMAT_MAPPING,
     267            self.dialect.INVERSE_FORMAT_TRIE,
     268        )
     269        return f"SAFE_CAST({this} AS {dtype} FORMAT {fmt})"
     270
     271    fmt = self.format_time(expression)
     272    return self.func(f"PARSE_{dtype}", fmt, this, expression.args.get("zone"))
     273
     274
     275def _annotate_math_functions(self: TypeAnnotator, expression: E) -> E:
     276    """
     277    Many BigQuery math functions such as CEIL, FLOOR etc follow this return type convention:
     278    +---------+---------+---------+------------+---------+
     279    |  INPUT  | INT64   | NUMERIC | BIGNUMERIC | FLOAT64 |
     280    +---------+---------+---------+------------+---------+
     281    |  OUTPUT | FLOAT64 | NUMERIC | BIGNUMERIC | FLOAT64 |
     282    +---------+---------+---------+------------+---------+
     283    """
     284    self._annotate_args(expression)
     285
     286    this: exp.Expression = expression.this
     287
     288    self._set_type(
     289        expression,
     290        exp.DataType.Type.DOUBLE if this.is_type(*exp.DataType.INTEGER_TYPES) else this.type,
     291    )
     292    return expression
     293
     294
     295@unsupported_args("ins_cost", "del_cost", "sub_cost")
     296def _levenshtein_sql(self: BigQuery.Generator, expression: exp.Levenshtein) -> str:
     297    max_dist = expression.args.get("max_dist")
     298    if max_dist:
     299        max_dist = exp.Kwarg(this=exp.var("max_distance"), expression=max_dist)
     300
     301    return self.func("EDIT_DISTANCE", expression.this, expression.expression, max_dist)
     302
     303
     304def _build_levenshtein(args: t.List) -> exp.Levenshtein:
     305    max_dist = seq_get(args, 2)
     306    return exp.Levenshtein(
     307        this=seq_get(args, 0),
     308        expression=seq_get(args, 1),
     309        max_dist=max_dist.expression if max_dist else None,
     310    )
     311
     312
     313def _build_format_time(expr_type: t.Type[exp.Expression]) -> t.Callable[[t.List], exp.TimeToStr]:
     314    def _builder(args: t.List) -> exp.TimeToStr:
     315        return exp.TimeToStr(this=expr_type(this=seq_get(args, 1)), format=seq_get(args, 0))
     316
     317    return _builder
     318
     319
     320def _build_contains_substring(args: t.List) -> exp.Contains | exp.Anonymous:
     321    if len(args) == 3:
     322        return exp.Anonymous(this="CONTAINS_SUBSTR", expressions=args)
     323
     324    # Lowercase the operands in case of transpilation, as exp.Contains
     325    # is case-sensitive on other dialects
     326    this = exp.Lower(this=seq_get(args, 0))
     327    expr = exp.Lower(this=seq_get(args, 1))
     328
     329    return exp.Contains(this=this, expression=expr)
     330
     331
     332def _json_extract_sql(self: BigQuery.Generator, expression: JSON_EXTRACT_TYPE) -> str:
     333    name = (expression._meta and expression.meta.get("name")) or expression.sql_name()
     334    upper = name.upper()
     335
     336    dquote_escaping = upper in DQUOTES_ESCAPING_JSON_FUNCTIONS
     337
     338    if dquote_escaping:
     339        self._quote_json_path_key_using_brackets = False
     340
     341    sql = rename_func(upper)(self, expression)
     342
     343    if dquote_escaping:
     344        self._quote_json_path_key_using_brackets = True
     345
     346    return sql
     347
     348
     349class BigQuery(Dialect):
     350    WEEK_OFFSET = -1
     351    UNNEST_COLUMN_ONLY = True
     352    SUPPORTS_USER_DEFINED_TYPES = False
     353    SUPPORTS_SEMI_ANTI_JOIN = False
     354    LOG_BASE_FIRST = False
     355    HEX_LOWERCASE = True
     356    FORCE_EARLY_ALIAS_REF_EXPANSION = True
     357    EXPAND_ALIAS_REFS_EARLY_ONLY_IN_GROUP_BY = True
     358    PRESERVE_ORIGINAL_NAMES = True
     359
     360    # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#case_sensitivity
     361    NORMALIZATION_STRATEGY = NormalizationStrategy.CASE_INSENSITIVE
     362
     363    # bigquery udfs are case sensitive
     364    NORMALIZE_FUNCTIONS = False
     365
     366    # https://cloud.google.com/bigquery/docs/reference/standard-sql/format-elements#format_elements_date_time
     367    TIME_MAPPING = {
     368        "%D": "%m/%d/%y",
     369        "%E6S": "%S.%f",
     370        "%e": "%-d",
     371    }
     372
     373    FORMAT_MAPPING = {
     374        "DD": "%d",
     375        "MM": "%m",
     376        "MON": "%b",
     377        "MONTH": "%B",
     378        "YYYY": "%Y",
     379        "YY": "%y",
     380        "HH": "%I",
     381        "HH12": "%I",
     382        "HH24": "%H",
     383        "MI": "%M",
     384        "SS": "%S",
     385        "SSSSS": "%f",
     386        "TZH": "%z",
     387    }
     388
     389    # The _PARTITIONTIME and _PARTITIONDATE pseudo-columns are not returned by a SELECT * statement
     390    # https://cloud.google.com/bigquery/docs/querying-partitioned-tables#query_an_ingestion-time_partitioned_table
     391    PSEUDOCOLUMNS = {"_PARTITIONTIME", "_PARTITIONDATE"}
     392
     393    # All set operations require either a DISTINCT or ALL specifier
     394    SET_OP_DISTINCT_BY_DEFAULT = dict.fromkeys((exp.Except, exp.Intersect, exp.Union), None)
     395
     396    ANNOTATORS = {
     397        **Dialect.ANNOTATORS,
     398        **{
     399            expr_type: lambda self, e: _annotate_math_functions(self, e)
     400            for expr_type in (exp.Floor, exp.Ceil, exp.Log, exp.Ln, exp.Sqrt, exp.Exp, exp.Round)
     401        },
     402        **{
     403            expr_type: lambda self, e: self._annotate_by_args(e, "this")
     404            for expr_type in (
     405                exp.Left,
     406                exp.Right,
     407                exp.Lower,
     408                exp.Upper,
     409                exp.Pad,
     410                exp.Trim,
     411                exp.RegexpExtract,
     412                exp.RegexpReplace,
     413                exp.Repeat,
     414                exp.Substring,
     415            )
     416        },
     417        exp.Concat: lambda self, e: self._annotate_by_args(e, "expressions"),
     418        exp.Sign: lambda self, e: self._annotate_by_args(e, "this"),
     419        exp.Split: lambda self, e: self._annotate_by_args(e, "this", array=True),
     420    }
     421
     422    def normalize_identifier(self, expression: E) -> E:
     423        if (
     424            isinstance(expression, exp.Identifier)
     425            and self.normalization_strategy is not NormalizationStrategy.CASE_SENSITIVE
     426        ):
     427            parent = expression.parent
     428            while isinstance(parent, exp.Dot):
     429                parent = parent.parent
     430
     431            # In BigQuery, CTEs are case-insensitive, but UDF and table names are case-sensitive
     432            # by default. The following check uses a heuristic to detect tables based on whether
     433            # they are qualified. This should generally be correct, because tables in BigQuery
     434            # must be qualified with at least a dataset, unless @@dataset_id is set.
     435            case_sensitive = (
     436                isinstance(parent, exp.UserDefinedFunction)
     437                or (
     438                    isinstance(parent, exp.Table)
     439                    and parent.db
     440                    and (parent.meta.get("quoted_table") or not parent.meta.get("maybe_column"))
     441                )
     442                or expression.meta.get("is_table")
     443            )
     444            if not case_sensitive:
     445                expression.set("this", expression.this.lower())
     446
     447        return expression
     448
     449    class Tokenizer(tokens.Tokenizer):
     450        QUOTES = ["'", '"', '"""', "'''"]
     451        COMMENTS = ["--", "#", ("/*", "*/")]
     452        IDENTIFIERS = ["`"]
     453        STRING_ESCAPES = ["\\"]
     454
     455        HEX_STRINGS = [("0x", ""), ("0X", "")]
     456
     457        BYTE_STRINGS = [
     458            (prefix + q, q) for q in t.cast(t.List[str], QUOTES) for prefix in ("b", "B")
     459        ]
     460
     461        RAW_STRINGS = [
     462            (prefix + q, q) for q in t.cast(t.List[str], QUOTES) for prefix in ("r", "R")
     463        ]
     464
     465        KEYWORDS = {
     466            **tokens.Tokenizer.KEYWORDS,
     467            "ANY TYPE": TokenType.VARIANT,
     468            "BEGIN": TokenType.COMMAND,
     469            "BEGIN TRANSACTION": TokenType.BEGIN,
     470            "BYTEINT": TokenType.INT,
     471            "BYTES": TokenType.BINARY,
     472            "CURRENT_DATETIME": TokenType.CURRENT_DATETIME,
     473            "DATETIME": TokenType.TIMESTAMP,
     474            "DECLARE": TokenType.COMMAND,
     475            "ELSEIF": TokenType.COMMAND,
     476            "EXCEPTION": TokenType.COMMAND,
     477            "FLOAT64": TokenType.DOUBLE,
     478            "FOR SYSTEM_TIME": TokenType.TIMESTAMP_SNAPSHOT,
     479            "MODEL": TokenType.MODEL,
     480            "NOT DETERMINISTIC": TokenType.VOLATILE,
     481            "RECORD": TokenType.STRUCT,
     482            "TIMESTAMP": TokenType.TIMESTAMPTZ,
     483        }
     484        KEYWORDS.pop("DIV")
     485        KEYWORDS.pop("VALUES")
     486        KEYWORDS.pop("/*+")
     487
     488    class Parser(parser.Parser):
     489        PREFIXED_PIVOT_COLUMNS = True
     490        LOG_DEFAULTS_TO_LN = True
     491        SUPPORTS_IMPLICIT_UNNEST = True
     492
     493        FUNCTIONS = {
     494            **parser.Parser.FUNCTIONS,
     495            "CONTAINS_SUBSTR": _build_contains_substring,
     496            "DATE": _build_date,
     497            "DATE_ADD": build_date_delta_with_interval(exp.DateAdd),
     498            "DATE_SUB": build_date_delta_with_interval(exp.DateSub),
     499            "DATE_TRUNC": lambda args: exp.DateTrunc(
     500                unit=exp.Literal.string(str(seq_get(args, 1))),
     501                this=seq_get(args, 0),
     502                zone=seq_get(args, 2),
     503            ),
     504            "DATETIME": _build_datetime,
     505            "DATETIME_ADD": build_date_delta_with_interval(exp.DatetimeAdd),
     506            "DATETIME_SUB": build_date_delta_with_interval(exp.DatetimeSub),
     507            "DIV": binary_from_function(exp.IntDiv),
     508            "EDIT_DISTANCE": _build_levenshtein,
     509            "FORMAT_DATE": _build_format_time(exp.TsOrDsToDate),
     510            "GENERATE_ARRAY": exp.GenerateSeries.from_arg_list,
     511            "JSON_EXTRACT_SCALAR": _build_extract_json_with_default_path(exp.JSONExtractScalar),
     512            "JSON_EXTRACT_ARRAY": _build_extract_json_with_default_path(exp.JSONExtractArray),
     513            "JSON_QUERY": parser.build_extract_json_with_path(exp.JSONExtract),
     514            "JSON_QUERY_ARRAY": _build_extract_json_with_default_path(exp.JSONExtractArray),
     515            "JSON_VALUE": _build_extract_json_with_default_path(exp.JSONExtractScalar),
     516            "JSON_VALUE_ARRAY": _build_extract_json_with_default_path(exp.JSONValueArray),
     517            "LENGTH": lambda args: exp.Length(this=seq_get(args, 0), binary=True),
     518            "MD5": exp.MD5Digest.from_arg_list,
     519            "TO_HEX": _build_to_hex,
     520            "PARSE_DATE": lambda args: build_formatted_time(exp.StrToDate, "bigquery")(
     521                [seq_get(args, 1), seq_get(args, 0)]
     522            ),
     523            "PARSE_TIMESTAMP": _build_parse_timestamp,
     524            "REGEXP_CONTAINS": exp.RegexpLike.from_arg_list,
     525            "REGEXP_EXTRACT": _build_regexp_extract(exp.RegexpExtract),
     526            "REGEXP_SUBSTR": _build_regexp_extract(exp.RegexpExtract),
     527            "REGEXP_EXTRACT_ALL": _build_regexp_extract(
     528                exp.RegexpExtractAll, default_group=exp.Literal.number(0)
     529            ),
     530            "SHA256": lambda args: exp.SHA2(this=seq_get(args, 0), length=exp.Literal.number(256)),
     531            "SHA512": lambda args: exp.SHA2(this=seq_get(args, 0), length=exp.Literal.number(512)),
     532            "SPLIT": lambda args: exp.Split(
     533                # https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#split
     534                this=seq_get(args, 0),
     535                expression=seq_get(args, 1) or exp.Literal.string(","),
     536            ),
     537            "STRPOS": exp.StrPosition.from_arg_list,
     538            "TIME": _build_time,
     539            "TIME_ADD": build_date_delta_with_interval(exp.TimeAdd),
     540            "TIME_SUB": build_date_delta_with_interval(exp.TimeSub),
     541            "TIMESTAMP": _build_timestamp,
     542            "TIMESTAMP_ADD": build_date_delta_with_interval(exp.TimestampAdd),
     543            "TIMESTAMP_SUB": build_date_delta_with_interval(exp.TimestampSub),
     544            "TIMESTAMP_MICROS": lambda args: exp.UnixToTime(
     545                this=seq_get(args, 0), scale=exp.UnixToTime.MICROS
     546            ),
     547            "TIMESTAMP_MILLIS": lambda args: exp.UnixToTime(
     548                this=seq_get(args, 0), scale=exp.UnixToTime.MILLIS
     549            ),
     550            "TIMESTAMP_SECONDS": lambda args: exp.UnixToTime(this=seq_get(args, 0)),
     551            "TO_JSON_STRING": exp.JSONFormat.from_arg_list,
     552            "FORMAT_DATETIME": _build_format_time(exp.TsOrDsToDatetime),
     553            "FORMAT_TIMESTAMP": _build_format_time(exp.TsOrDsToTimestamp),
     554        }
     555
     556        FUNCTION_PARSERS = {
     557            **parser.Parser.FUNCTION_PARSERS,
     558            "ARRAY": lambda self: self.expression(exp.Array, expressions=[self._parse_statement()]),
     559            "MAKE_INTERVAL": lambda self: self._parse_make_interval(),
     560            "FEATURES_AT_TIME": lambda self: self._parse_features_at_time(),
     561        }
     562        FUNCTION_PARSERS.pop("TRIM")
     563
     564        NO_PAREN_FUNCTIONS = {
     565            **parser.Parser.NO_PAREN_FUNCTIONS,
     566            TokenType.CURRENT_DATETIME: exp.CurrentDatetime,
     567        }
     568
     569        NESTED_TYPE_TOKENS = {
     570            *parser.Parser.NESTED_TYPE_TOKENS,
     571            TokenType.TABLE,
     572        }
     573
     574        PROPERTY_PARSERS = {
     575            **parser.Parser.PROPERTY_PARSERS,
     576            "NOT DETERMINISTIC": lambda self: self.expression(
     577                exp.StabilityProperty, this=exp.Literal.string("VOLATILE")
     578            ),
     579            "OPTIONS": lambda self: self._parse_with_property(),
     580        }
     581
     582        CONSTRAINT_PARSERS = {
     583            **parser.Parser.CONSTRAINT_PARSERS,
     584            "OPTIONS": lambda self: exp.Properties(expressions=self._parse_with_property()),
     585        }
     586
     587        RANGE_PARSERS = parser.Parser.RANGE_PARSERS.copy()
     588        RANGE_PARSERS.pop(TokenType.OVERLAPS)
     589
     590        NULL_TOKENS = {TokenType.NULL, TokenType.UNKNOWN}
     591
     592        DASHED_TABLE_PART_FOLLOW_TOKENS = {TokenType.DOT, TokenType.L_PAREN, TokenType.R_PAREN}
     593
     594        STATEMENT_PARSERS = {
     595            **parser.Parser.STATEMENT_PARSERS,
     596            TokenType.ELSE: lambda self: self._parse_as_command(self._prev),
     597            TokenType.END: lambda self: self._parse_as_command(self._prev),
     598            TokenType.FOR: lambda self: self._parse_for_in(),
     599        }
     600
     601        BRACKET_OFFSETS = {
     602            "OFFSET": (0, False),
     603            "ORDINAL": (1, False),
     604            "SAFE_OFFSET": (0, True),
     605            "SAFE_ORDINAL": (1, True),
     606        }
     607
     608        def _parse_for_in(self) -> exp.ForIn:
     609            this = self._parse_range()
     610            self._match_text_seq("DO")
     611            return self.expression(exp.ForIn, this=this, expression=self._parse_statement())
     612
     613        def _parse_table_part(self, schema: bool = False) -> t.Optional[exp.Expression]:
     614            this = super()._parse_table_part(schema=schema) or self._parse_number()
     615
     616            # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#table_names
     617            if isinstance(this, exp.Identifier):
     618                table_name = this.name
     619                while self._match(TokenType.DASH, advance=False) and self._next:
     620                    start = self._curr
     621                    while self._is_connected() and not self._match_set(
     622                        self.DASHED_TABLE_PART_FOLLOW_TOKENS, advance=False
     623                    ):
     624                        self._advance()
     625
     626                    table_name += self._find_sql(start, self._prev)
     627
     628                this = exp.Identifier(this=table_name, quoted=this.args.get("quoted"))
     629            elif isinstance(this, exp.Literal):
     630                table_name = this.name
     631
     632                if self._is_connected() and self._parse_var(any_token=True):
     633                    table_name += self._prev.text
     634
     635                this = exp.Identifier(this=table_name, quoted=True)
     636
     637            return this
     638
     639        def _parse_table_parts(
     640            self, schema: bool = False, is_db_reference: bool = False, wildcard: bool = False
     641        ) -> exp.Table:
     642            table = super()._parse_table_parts(
     643                schema=schema, is_db_reference=is_db_reference, wildcard=True
     644            )
     645
     646            # proj-1.db.tbl -- `1.` is tokenized as a float so we need to unravel it here
     647            if not table.catalog:
     648                if table.db:
     649                    parts = table.db.split(".")
     650                    if len(parts) == 2 and not table.args["db"].quoted:
     651                        table.set("catalog", exp.Identifier(this=parts[0]))
     652                        table.set("db", exp.Identifier(this=parts[1]))
     653                else:
     654                    parts = table.name.split(".")
     655                    if len(parts) == 2 and not table.this.quoted:
     656                        table.set("db", exp.Identifier(this=parts[0]))
     657                        table.set("this", exp.Identifier(this=parts[1]))
     658
     659            if isinstance(table.this, exp.Identifier) and any("." in p.name for p in table.parts):
     660                alias = table.this
     661                catalog, db, this, *rest = (
     662                    exp.to_identifier(p, quoted=True)
     663                    for p in split_num_words(".".join(p.name for p in table.parts), ".", 3)
     664                )
     665
     666                if rest and this:
     667                    this = exp.Dot.build([this, *rest])  # type: ignore
     668
     669                table = exp.Table(
     670                    this=this, db=db, catalog=catalog, pivots=table.args.get("pivots")
     671                )
     672                table.meta["quoted_table"] = True
     673            else:
     674                alias = None
     675
     676            # The `INFORMATION_SCHEMA` views in BigQuery need to be qualified by a region or
     677            # dataset, so if the project identifier is omitted we need to fix the ast so that
     678            # the `INFORMATION_SCHEMA.X` bit is represented as a single (quoted) Identifier.
     679            # Otherwise, we wouldn't correctly qualify a `Table` node that references these
     680            # views, because it would seem like the "catalog" part is set, when it'd actually
     681            # be the region/dataset. Merging the two identifiers into a single one is done to
     682            # avoid producing a 4-part Table reference, which would cause issues in the schema
     683            # module, when there are 3-part table names mixed with information schema views.
     684            #
     685            # See: https://cloud.google.com/bigquery/docs/information-schema-intro#syntax
     686            table_parts = table.parts
     687            if len(table_parts) > 1 and table_parts[-2].name.upper() == "INFORMATION_SCHEMA":
     688                # We need to alias the table here to avoid breaking existing qualified columns.
     689                # This is expected to be safe, because if there's an actual alias coming up in
     690                # the token stream, it will overwrite this one. If there isn't one, we are only
     691                # exposing the name that can be used to reference the view explicitly (a no-op).
     692                exp.alias_(
     693                    table,
     694                    t.cast(exp.Identifier, alias or table_parts[-1]),
     695                    table=True,
     696                    copy=False,
     697                )
     698
     699                info_schema_view = f"{table_parts[-2].name}.{table_parts[-1].name}"
     700                table.set("this", exp.Identifier(this=info_schema_view, quoted=True))
     701                table.set("db", seq_get(table_parts, -3))
     702                table.set("catalog", seq_get(table_parts, -4))
     703
     704            return table
     705
     706        def _parse_column(self) -> t.Optional[exp.Expression]:
     707            column = super()._parse_column()
     708            if isinstance(column, exp.Column):
     709                parts = column.parts
     710                if any("." in p.name for p in parts):
     711                    catalog, db, table, this, *rest = (
     712                        exp.to_identifier(p, quoted=True)
     713                        for p in split_num_words(".".join(p.name for p in parts), ".", 4)
     714                    )
     715
     716                    if rest and this:
     717                        this = exp.Dot.build([this, *rest])  # type: ignore
     718
     719                    column = exp.Column(this=this, table=table, db=db, catalog=catalog)
     720                    column.meta["quoted_column"] = True
     721
     722            return column
     723
     724        @t.overload
     725        def _parse_json_object(self, agg: Lit[False]) -> exp.JSONObject: ...
     726
     727        @t.overload
     728        def _parse_json_object(self, agg: Lit[True]) -> exp.JSONObjectAgg: ...
     729
     730        def _parse_json_object(self, agg=False):
     731            json_object = super()._parse_json_object()
     732            array_kv_pair = seq_get(json_object.expressions, 0)
     733
     734            # Converts BQ's "signature 2" of JSON_OBJECT into SQLGlot's canonical representation
     735            # https://cloud.google.com/bigquery/docs/reference/standard-sql/json_functions#json_object_signature2
     736            if (
     737                array_kv_pair
     738                and isinstance(array_kv_pair.this, exp.Array)
     739                and isinstance(array_kv_pair.expression, exp.Array)
     740            ):
     741                keys = array_kv_pair.this.expressions
     742                values = array_kv_pair.expression.expressions
     743
     744                json_object.set(
     745                    "expressions",
     746                    [exp.JSONKeyValue(this=k, expression=v) for k, v in zip(keys, values)],
     747                )
     748
     749            return json_object
     750
     751        def _parse_bracket(
     752            self, this: t.Optional[exp.Expression] = None
     753        ) -> t.Optional[exp.Expression]:
     754            bracket = super()._parse_bracket(this)
     755
     756            if this is bracket:
     757                return bracket
     758
     759            if isinstance(bracket, exp.Bracket):
     760                for expression in bracket.expressions:
     761                    name = expression.name.upper()
     762
     763                    if name not in self.BRACKET_OFFSETS:
     764                        break
     765
     766                    offset, safe = self.BRACKET_OFFSETS[name]
     767                    bracket.set("offset", offset)
     768                    bracket.set("safe", safe)
     769                    expression.replace(expression.expressions[0])
     770
     771            return bracket
     772
     773        def _parse_unnest(self, with_alias: bool = True) -> t.Optional[exp.Unnest]:
     774            unnest = super()._parse_unnest(with_alias=with_alias)
     775
     776            if not unnest:
     777                return None
     778
     779            unnest_expr = seq_get(unnest.expressions, 0)
     780            if unnest_expr:
     781                from sqlglot.optimizer.annotate_types import annotate_types
     782
     783                unnest_expr = annotate_types(unnest_expr)
     784
     785                # Unnesting a nested array (i.e array of structs) explodes the top-level struct fields,
     786                # in contrast to other dialects such as DuckDB which flattens only the array by default
     787                if unnest_expr.is_type(exp.DataType.Type.ARRAY) and any(
     788                    array_elem.is_type(exp.DataType.Type.STRUCT)
     789                    for array_elem in unnest_expr._type.expressions
     790                ):
     791                    unnest.set("explode_array", True)
     792
     793            return unnest
     794
     795        def _parse_make_interval(self) -> exp.MakeInterval:
     796            expr = exp.MakeInterval()
     797
     798            for arg_key in expr.arg_types:
     799                value = self._parse_lambda()
     800
     801                if not value:
     802                    break
     803
     804                # Non-named arguments are filled sequentially, (optionally) followed by named arguments
     805                # that can appear in any order e.g MAKE_INTERVAL(1, minute => 5, day => 2)
     806                if isinstance(value, exp.Kwarg):
     807                    arg_key = value.this.name
     808
     809                expr.set(arg_key, value)
     810
     811                self._match(TokenType.COMMA)
     812
     813            return expr
     814
     815        def _parse_features_at_time(self) -> exp.FeaturesAtTime:
     816            expr = self.expression(
     817                exp.FeaturesAtTime,
     818                this=(self._match(TokenType.TABLE) and self._parse_table())
     819                or self._parse_select(nested=True),
     820            )
     821
     822            while self._match(TokenType.COMMA):
     823                arg = self._parse_lambda()
     824
     825                # Get the LHS of the Kwarg and set the arg to that value, e.g
     826                # "num_rows => 1" sets the expr's `num_rows` arg
     827                if arg:
     828                    expr.set(arg.this.name, arg)
     829
     830            return expr
     831
     832    class Generator(generator.Generator):
     833        INTERVAL_ALLOWS_PLURAL_FORM = False
     834        JOIN_HINTS = False
     835        QUERY_HINTS = False
     836        TABLE_HINTS = False
     837        LIMIT_FETCH = "LIMIT"
     838        RENAME_TABLE_WITH_DB = False
     839        NVL2_SUPPORTED = False
     840        UNNEST_WITH_ORDINALITY = False
     841        COLLATE_IS_FUNC = True
     842        LIMIT_ONLY_LITERALS = True
     843        SUPPORTS_TABLE_ALIAS_COLUMNS = False
     844        UNPIVOT_ALIASES_ARE_IDENTIFIERS = False
     845        JSON_KEY_VALUE_PAIR_SEP = ","
     846        NULL_ORDERING_SUPPORTED = False
     847        IGNORE_NULLS_IN_FUNC = True
     848        JSON_PATH_SINGLE_QUOTE_ESCAPE = True
     849        CAN_IMPLEMENT_ARRAY_ANY = True
     850        SUPPORTS_TO_NUMBER = False
     851        NAMED_PLACEHOLDER_TOKEN = "@"
     852        HEX_FUNC = "TO_HEX"
     853        WITH_PROPERTIES_PREFIX = "OPTIONS"
     854        SUPPORTS_EXPLODING_PROJECTIONS = False
     855        EXCEPT_INTERSECT_SUPPORT_ALL_CLAUSE = False
     856        SUPPORTS_UNIX_SECONDS = True
     857
     858        TRANSFORMS = {
     859            **generator.Generator.TRANSFORMS,
     860            exp.ApproxDistinct: rename_func("APPROX_COUNT_DISTINCT"),
     861            exp.ArgMax: arg_max_or_min_no_count("MAX_BY"),
     862            exp.ArgMin: arg_max_or_min_no_count("MIN_BY"),
     863            exp.Array: inline_array_unless_query,
     864            exp.ArrayContains: _array_contains_sql,
     865            exp.ArrayFilter: filter_array_using_unnest,
     866            exp.Cast: transforms.preprocess([transforms.remove_precision_parameterized_types]),
     867            exp.CollateProperty: lambda self, e: (
     868                f"DEFAULT COLLATE {self.sql(e, 'this')}"
     869                if e.args.get("default")
     870                else f"COLLATE {self.sql(e, 'this')}"
     871            ),
     872            exp.Commit: lambda *_: "COMMIT TRANSACTION",
     873            exp.CountIf: rename_func("COUNTIF"),
     874            exp.Create: _create_sql,
     875            exp.CTE: transforms.preprocess([_pushdown_cte_column_names]),
     876            exp.DateAdd: date_add_interval_sql("DATE", "ADD"),
     877            exp.DateDiff: lambda self, e: self.func(
     878                "DATE_DIFF", e.this, e.expression, unit_to_var(e)
     879            ),
     880            exp.DateFromParts: rename_func("DATE"),
     881            exp.DateStrToDate: datestrtodate_sql,
     882            exp.DateSub: date_add_interval_sql("DATE", "SUB"),
     883            exp.DatetimeAdd: date_add_interval_sql("DATETIME", "ADD"),
     884            exp.DatetimeSub: date_add_interval_sql("DATETIME", "SUB"),
     885            exp.DateTrunc: lambda self, e: self.func(
     886                "DATE_TRUNC", e.this, e.text("unit"), e.args.get("zone")
     887            ),
     888            exp.FromTimeZone: lambda self, e: self.func(
     889                "DATETIME", self.func("TIMESTAMP", e.this, e.args.get("zone")), "'UTC'"
     890            ),
     891            exp.GenerateSeries: rename_func("GENERATE_ARRAY"),
     892            exp.GroupConcat: rename_func("STRING_AGG"),
     893            exp.Hex: lambda self, e: self.func("UPPER", self.func("TO_HEX", self.sql(e, "this"))),
     894            exp.If: if_sql(false_value="NULL"),
     895            exp.ILike: no_ilike_sql,
     896            exp.IntDiv: rename_func("DIV"),
     897            exp.Int64: rename_func("INT64"),
     898            exp.JSONExtract: _json_extract_sql,
     899            exp.JSONExtractArray: _json_extract_sql,
     900            exp.JSONExtractScalar: _json_extract_sql,
     901            exp.JSONFormat: rename_func("TO_JSON_STRING"),
     902            exp.Levenshtein: _levenshtein_sql,
     903            exp.Max: max_or_greatest,
     904            exp.MD5: lambda self, e: self.func("TO_HEX", self.func("MD5", e.this)),
     905            exp.MD5Digest: rename_func("MD5"),
     906            exp.Min: min_or_least,
     907            exp.PartitionedByProperty: lambda self, e: f"PARTITION BY {self.sql(e, 'this')}",
     908            exp.RegexpExtract: lambda self, e: self.func(
     909                "REGEXP_EXTRACT",
     910                e.this,
     911                e.expression,
     912                e.args.get("position"),
     913                e.args.get("occurrence"),
     914            ),
     915            exp.RegexpExtractAll: lambda self, e: self.func(
     916                "REGEXP_EXTRACT_ALL", e.this, e.expression
     917            ),
     918            exp.RegexpReplace: regexp_replace_sql,
     919            exp.RegexpLike: rename_func("REGEXP_CONTAINS"),
     920            exp.ReturnsProperty: _returnsproperty_sql,
     921            exp.Rollback: lambda *_: "ROLLBACK TRANSACTION",
     922            exp.Select: transforms.preprocess(
     923                [
     924                    transforms.explode_to_unnest(),
     925                    transforms.unqualify_unnest,
     926                    transforms.eliminate_distinct_on,
     927                    _alias_ordered_group,
     928                    transforms.eliminate_semi_and_anti_joins,
     929                ]
     930            ),
     931            exp.SHA: rename_func("SHA1"),
     932            exp.SHA2: sha256_sql,
     933            exp.StabilityProperty: lambda self, e: (
     934                "DETERMINISTIC" if e.name == "IMMUTABLE" else "NOT DETERMINISTIC"
     935            ),
     936            exp.String: rename_func("STRING"),
     937            exp.StrPosition: lambda self, e: (
     938                strposition_sql(
     939                    self, e, func_name="INSTR", supports_position=True, supports_occurrence=True
     940                )
     941            ),
     942            exp.StrToDate: _str_to_datetime_sql,
     943            exp.StrToTime: _str_to_datetime_sql,
     944            exp.TimeAdd: date_add_interval_sql("TIME", "ADD"),
     945            exp.TimeFromParts: rename_func("TIME"),
     946            exp.TimestampFromParts: rename_func("DATETIME"),
     947            exp.TimeSub: date_add_interval_sql("TIME", "SUB"),
     948            exp.TimestampAdd: date_add_interval_sql("TIMESTAMP", "ADD"),
     949            exp.TimestampDiff: rename_func("TIMESTAMP_DIFF"),
     950            exp.TimestampSub: date_add_interval_sql("TIMESTAMP", "SUB"),
     951            exp.TimeStrToTime: timestrtotime_sql,
     952            exp.Transaction: lambda *_: "BEGIN TRANSACTION",
     953            exp.TsOrDsAdd: _ts_or_ds_add_sql,
     954            exp.TsOrDsDiff: _ts_or_ds_diff_sql,
     955            exp.TsOrDsToTime: rename_func("TIME"),
     956            exp.TsOrDsToDatetime: rename_func("DATETIME"),
     957            exp.TsOrDsToTimestamp: rename_func("TIMESTAMP"),
     958            exp.Unhex: rename_func("FROM_HEX"),
     959            exp.UnixDate: rename_func("UNIX_DATE"),
     960            exp.UnixToTime: _unix_to_time_sql,
     961            exp.Uuid: lambda *_: "GENERATE_UUID()",
     962            exp.Values: _derived_table_values_to_unnest,
     963            exp.VariancePop: rename_func("VAR_POP"),
     964            exp.SafeDivide: rename_func("SAFE_DIVIDE"),
     965        }
     966
     967        SUPPORTED_JSON_PATH_PARTS = {
     968            exp.JSONPathKey,
     969            exp.JSONPathRoot,
     970            exp.JSONPathSubscript,
     971        }
     972
     973        TYPE_MAPPING = {
     974            **generator.Generator.TYPE_MAPPING,
     975            exp.DataType.Type.BIGDECIMAL: "BIGNUMERIC",
     976            exp.DataType.Type.BIGINT: "INT64",
     977            exp.DataType.Type.BINARY: "BYTES",
     978            exp.DataType.Type.BOOLEAN: "BOOL",
     979            exp.DataType.Type.CHAR: "STRING",
     980            exp.DataType.Type.DECIMAL: "NUMERIC",
     981            exp.DataType.Type.DOUBLE: "FLOAT64",
     982            exp.DataType.Type.FLOAT: "FLOAT64",
     983            exp.DataType.Type.INT: "INT64",
     984            exp.DataType.Type.NCHAR: "STRING",
     985            exp.DataType.Type.NVARCHAR: "STRING",
     986            exp.DataType.Type.SMALLINT: "INT64",
     987            exp.DataType.Type.TEXT: "STRING",
     988            exp.DataType.Type.TIMESTAMP: "DATETIME",
     989            exp.DataType.Type.TIMESTAMPTZ: "TIMESTAMP",
     990            exp.DataType.Type.TIMESTAMPLTZ: "TIMESTAMP",
     991            exp.DataType.Type.TINYINT: "INT64",
     992            exp.DataType.Type.ROWVERSION: "BYTES",
     993            exp.DataType.Type.UUID: "STRING",
     994            exp.DataType.Type.VARBINARY: "BYTES",
     995            exp.DataType.Type.VARCHAR: "STRING",
     996            exp.DataType.Type.VARIANT: "ANY TYPE",
     997        }
     998
     999        PROPERTIES_LOCATION = {
    1000            **generator.Generator.PROPERTIES_LOCATION,
    1001            exp.PartitionedByProperty: exp.Properties.Location.POST_SCHEMA,
    1002            exp.VolatileProperty: exp.Properties.Location.UNSUPPORTED,
    1003        }
    1004
    1005        # WINDOW comes after QUALIFY
    1006        # https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#window_clause
    1007        AFTER_HAVING_MODIFIER_TRANSFORMS = {
    1008            "qualify": generator.Generator.AFTER_HAVING_MODIFIER_TRANSFORMS["qualify"],
    1009            "windows": generator.Generator.AFTER_HAVING_MODIFIER_TRANSFORMS["windows"],
    1010        }
    1011
    1012        # from: https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#reserved_keywords
    1013        RESERVED_KEYWORDS = {
    1014            "all",
    1015            "and",
    1016            "any",
    1017            "array",
    1018            "as",
    1019            "asc",
    1020            "assert_rows_modified",
    1021            "at",
    1022            "between",
    1023            "by",
    1024            "case",
    1025            "cast",
    1026            "collate",
    1027            "contains",
    1028            "create",
    1029            "cross",
    1030            "cube",
    1031            "current",
    1032            "default",
    1033            "define",
    1034            "desc",
    1035            "distinct",
    1036            "else",
    1037            "end",
    1038            "enum",
    1039            "escape",
    1040            "except",
    1041            "exclude",
    1042            "exists",
    1043            "extract",
    1044            "false",
    1045            "fetch",
    1046            "following",
    1047            "for",
    1048            "from",
    1049            "full",
    1050            "group",
    1051            "grouping",
    1052            "groups",
    1053            "hash",
    1054            "having",
    1055            "if",
    1056            "ignore",
    1057            "in",
    1058            "inner",
    1059            "intersect",
    1060            "interval",
    1061            "into",
    1062            "is",
    1063            "join",
    1064            "lateral",
    1065            "left",
    1066            "like",
    1067            "limit",
    1068            "lookup",
    1069            "merge",
    1070            "natural",
    1071            "new",
    1072            "no",
    1073            "not",
    1074            "null",
    1075            "nulls",
    1076            "of",
    1077            "on",
    1078            "or",
    1079            "order",
    1080            "outer",
    1081            "over",
    1082            "partition",
    1083            "preceding",
    1084            "proto",
    1085            "qualify",
    1086            "range",
    1087            "recursive",
    1088            "respect",
    1089            "right",
    1090            "rollup",
    1091            "rows",
    1092            "select",
    1093            "set",
    1094            "some",
    1095            "struct",
    1096            "tablesample",
    1097            "then",
    1098            "to",
    1099            "treat",
    1100            "true",
    1101            "unbounded",
    1102            "union",
    1103            "unnest",
    1104            "using",
    1105            "when",
    1106            "where",
    1107            "window",
    1108            "with",
    1109            "within",
    1110        }
    1111
    1112        def mod_sql(self, expression: exp.Mod) -> str:
    1113            this = expression.this
    1114            expr = expression.expression
    1115            return self.func(
    1116                "MOD",
    1117                this.unnest() if isinstance(this, exp.Paren) else this,
    1118                expr.unnest() if isinstance(expr, exp.Paren) else expr,
    1119            )
    1120
    1121        def column_parts(self, expression: exp.Column) -> str:
    1122            if expression.meta.get("quoted_column"):
    1123                # If a column reference is of the form `dataset.table`.name, we need
    1124                # to preserve the quoted table path, otherwise the reference breaks
    1125                table_parts = ".".join(p.name for p in expression.parts[:-1])
    1126                table_path = self.sql(exp.Identifier(this=table_parts, quoted=True))
    1127                return f"{table_path}.{self.sql(expression, 'this')}"
    1128
    1129            return super().column_parts(expression)
    1130
    1131        def table_parts(self, expression: exp.Table) -> str:
    1132            # Depending on the context, `x.y` may not resolve to the same data source as `x`.`y`, so
    1133            # we need to make sure the correct quoting is used in each case.
    1134            #
    1135            # For example, if there is a CTE x that clashes with a schema name, then the former will
    1136            # return the table y in that schema, whereas the latter will return the CTE's y column:
    1137            #
    1138            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x.y`   -> cross join
    1139            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x`.`y` -> implicit unnest
    1140            if expression.meta.get("quoted_table"):
    1141                table_parts = ".".join(p.name for p in expression.parts)
    1142                return self.sql(exp.Identifier(this=table_parts, quoted=True))
    1143
    1144            return super().table_parts(expression)
    1145
    1146        def timetostr_sql(self, expression: exp.TimeToStr) -> str:
    1147            this = expression.this
    1148            if isinstance(this, exp.TsOrDsToDatetime):
    1149                func_name = "FORMAT_DATETIME"
    1150            elif isinstance(this, exp.TsOrDsToTimestamp):
    1151                func_name = "FORMAT_TIMESTAMP"
    1152            else:
    1153                func_name = "FORMAT_DATE"
    1154
    1155            time_expr = (
    1156                this
    1157                if isinstance(this, (exp.TsOrDsToDatetime, exp.TsOrDsToTimestamp, exp.TsOrDsToDate))
    1158                else expression
    1159            )
    1160            return self.func(func_name, self.format_time(expression), time_expr.this)
    1161
    1162        def eq_sql(self, expression: exp.EQ) -> str:
    1163            # Operands of = cannot be NULL in BigQuery
    1164            if isinstance(expression.left, exp.Null) or isinstance(expression.right, exp.Null):
    1165                if not isinstance(expression.parent, exp.Update):
    1166                    return "NULL"
    1167
    1168            return self.binary(expression, "=")
    1169
    1170        def attimezone_sql(self, expression: exp.AtTimeZone) -> str:
    1171            parent = expression.parent
    1172
    1173            # BigQuery allows CAST(.. AS {STRING|TIMESTAMP} [FORMAT <fmt> [AT TIME ZONE <tz>]]).
    1174            # Only the TIMESTAMP one should use the below conversion, when AT TIME ZONE is included.
    1175            if not isinstance(parent, exp.Cast) or not parent.to.is_type("text"):
    1176                return self.func(
    1177                    "TIMESTAMP", self.func("DATETIME", expression.this, expression.args.get("zone"))
    1178                )
    1179
    1180            return super().attimezone_sql(expression)
    1181
    1182        def trycast_sql(self, expression: exp.TryCast) -> str:
    1183            return self.cast_sql(expression, safe_prefix="SAFE_")
    1184
    1185        def bracket_sql(self, expression: exp.Bracket) -> str:
    1186            this = expression.this
    1187            expressions = expression.expressions
    1188
    1189            if len(expressions) == 1 and this and this.is_type(exp.DataType.Type.STRUCT):
    1190                arg = expressions[0]
    1191                if arg.type is None:
    1192                    from sqlglot.optimizer.annotate_types import annotate_types
    1193
    1194                    arg = annotate_types(arg)
    1195
    1196                if arg.type and arg.type.this in exp.DataType.TEXT_TYPES:
    1197                    # BQ doesn't support bracket syntax with string values for structs
    1198                    return f"{self.sql(this)}.{arg.name}"
    1199
    1200            expressions_sql = self.expressions(expression, flat=True)
    1201            offset = expression.args.get("offset")
    1202
    1203            if offset == 0:
    1204                expressions_sql = f"OFFSET({expressions_sql})"
    1205            elif offset == 1:
    1206                expressions_sql = f"ORDINAL({expressions_sql})"
    1207            elif offset is not None:
    1208                self.unsupported(f"Unsupported array offset: {offset}")
    1209
    1210            if expression.args.get("safe"):
    1211                expressions_sql = f"SAFE_{expressions_sql}"
    1212
    1213            return f"{self.sql(this)}[{expressions_sql}]"
    1214
    1215        def in_unnest_op(self, expression: exp.Unnest) -> str:
    1216            return self.sql(expression)
    1217
    1218        def version_sql(self, expression: exp.Version) -> str:
    1219            if expression.name == "TIMESTAMP":
    1220                expression.set("this", "SYSTEM_TIME")
    1221            return super().version_sql(expression)
    1222
    1223        def contains_sql(self, expression: exp.Contains) -> str:
    1224            this = expression.this
    1225            expr = expression.expression
    1226
    1227            if isinstance(this, exp.Lower) and isinstance(expr, exp.Lower):
    1228                this = this.this
    1229                expr = expr.this
    1230
    1231            return self.func("CONTAINS_SUBSTR", this, expr)

logger = <Logger sqlglot (WARNING)>
JSON_EXTRACT_TYPE = typing.Union[sqlglot.expressions.JSONExtract, sqlglot.expressions.JSONExtractScalar, sqlglot.expressions.JSONExtractArray]
DQUOTES_ESCAPING_JSON_FUNCTIONS = ('JSON_QUERY', 'JSON_VALUE', 'JSON_QUERY_ARRAY')
class BigQuery(sqlglot.dialects.dialect.Dialect): View Source

     350class BigQuery(Dialect):
     351    WEEK_OFFSET = -1
     352    UNNEST_COLUMN_ONLY = True
     353    SUPPORTS_USER_DEFINED_TYPES = False
     354    SUPPORTS_SEMI_ANTI_JOIN = False
     355    LOG_BASE_FIRST = False
     356    HEX_LOWERCASE = True
     357    FORCE_EARLY_ALIAS_REF_EXPANSION = True
     358    EXPAND_ALIAS_REFS_EARLY_ONLY_IN_GROUP_BY = True
     359    PRESERVE_ORIGINAL_NAMES = True
     360
     361    # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#case_sensitivity
     362    NORMALIZATION_STRATEGY = NormalizationStrategy.CASE_INSENSITIVE
     363
     364    # bigquery udfs are case sensitive
     365    NORMALIZE_FUNCTIONS = False
     366
     367    # https://cloud.google.com/bigquery/docs/reference/standard-sql/format-elements#format_elements_date_time
     368    TIME_MAPPING = {
     369        "%D": "%m/%d/%y",
     370        "%E6S": "%S.%f",
     371        "%e": "%-d",
     372    }
     373
     374    FORMAT_MAPPING = {
     375        "DD": "%d",
     376        "MM": "%m",
     377        "MON": "%b",
     378        "MONTH": "%B",
     379        "YYYY": "%Y",
     380        "YY": "%y",
     381        "HH": "%I",
     382        "HH12": "%I",
     383        "HH24": "%H",
     384        "MI": "%M",
     385        "SS": "%S",
     386        "SSSSS": "%f",
     387        "TZH": "%z",
     388    }
     389
     390    # The _PARTITIONTIME and _PARTITIONDATE pseudo-columns are not returned by a SELECT * statement
     391    # https://cloud.google.com/bigquery/docs/querying-partitioned-tables#query_an_ingestion-time_partitioned_table
     392    PSEUDOCOLUMNS = {"_PARTITIONTIME", "_PARTITIONDATE"}
     393
     394    # All set operations require either a DISTINCT or ALL specifier
     395    SET_OP_DISTINCT_BY_DEFAULT = dict.fromkeys((exp.Except, exp.Intersect, exp.Union), None)
     396
     397    ANNOTATORS = {
     398        **Dialect.ANNOTATORS,
     399        **{
     400            expr_type: lambda self, e: _annotate_math_functions(self, e)
     401            for expr_type in (exp.Floor, exp.Ceil, exp.Log, exp.Ln, exp.Sqrt, exp.Exp, exp.Round)
     402        },
     403        **{
     404            expr_type: lambda self, e: self._annotate_by_args(e, "this")
     405            for expr_type in (
     406                exp.Left,
     407                exp.Right,
     408                exp.Lower,
     409                exp.Upper,
     410                exp.Pad,
     411                exp.Trim,
     412                exp.RegexpExtract,
     413                exp.RegexpReplace,
     414                exp.Repeat,
     415                exp.Substring,
     416            )
     417        },
     418        exp.Concat: lambda self, e: self._annotate_by_args(e, "expressions"),
     419        exp.Sign: lambda self, e: self._annotate_by_args(e, "this"),
     420        exp.Split: lambda self, e: self._annotate_by_args(e, "this", array=True),
     421    }
     422
     423    def normalize_identifier(self, expression: E) -> E:
     424        if (
     425            isinstance(expression, exp.Identifier)
     426            and self.normalization_strategy is not NormalizationStrategy.CASE_SENSITIVE
     427        ):
     428            parent = expression.parent
     429            while isinstance(parent, exp.Dot):
     430                parent = parent.parent
     431
     432            # In BigQuery, CTEs are case-insensitive, but UDF and table names are case-sensitive
     433            # by default. The following check uses a heuristic to detect tables based on whether
     434            # they are qualified. This should generally be correct, because tables in BigQuery
     435            # must be qualified with at least a dataset, unless @@dataset_id is set.
     436            case_sensitive = (
     437                isinstance(parent, exp.UserDefinedFunction)
     438                or (
     439                    isinstance(parent, exp.Table)
     440                    and parent.db
     441                    and (parent.meta.get("quoted_table") or not parent.meta.get("maybe_column"))
     442                )
     443                or expression.meta.get("is_table")
     444            )
     445            if not case_sensitive:
     446                expression.set("this", expression.this.lower())
     447
     448        return expression
     449
     450    class Tokenizer(tokens.Tokenizer):
     451        QUOTES = ["'", '"', '"""', "'''"]
     452        COMMENTS = ["--", "#", ("/*", "*/")]
     453        IDENTIFIERS = ["`"]
     454        STRING_ESCAPES = ["\\"]
     455
     456        HEX_STRINGS = [("0x", ""), ("0X", "")]
     457
     458        BYTE_STRINGS = [
     459            (prefix + q, q) for q in t.cast(t.List[str], QUOTES) for prefix in ("b", "B")
     460        ]
     461
     462        RAW_STRINGS = [
     463            (prefix + q, q) for q in t.cast(t.List[str], QUOTES) for prefix in ("r", "R")
     464        ]
     465
     466        KEYWORDS = {
     467            **tokens.Tokenizer.KEYWORDS,
     468            "ANY TYPE": TokenType.VARIANT,
     469            "BEGIN": TokenType.COMMAND,
     470            "BEGIN TRANSACTION": TokenType.BEGIN,
     471            "BYTEINT": TokenType.INT,
     472            "BYTES": TokenType.BINARY,
     473            "CURRENT_DATETIME": TokenType.CURRENT_DATETIME,
     474            "DATETIME": TokenType.TIMESTAMP,
     475            "DECLARE": TokenType.COMMAND,
     476            "ELSEIF": TokenType.COMMAND,
     477            "EXCEPTION": TokenType.COMMAND,
     478            "FLOAT64": TokenType.DOUBLE,
     479            "FOR SYSTEM_TIME": TokenType.TIMESTAMP_SNAPSHOT,
     480            "MODEL": TokenType.MODEL,
     481            "NOT DETERMINISTIC": TokenType.VOLATILE,
     482            "RECORD": TokenType.STRUCT,
     483            "TIMESTAMP": TokenType.TIMESTAMPTZ,
     484        }
     485        KEYWORDS.pop("DIV")
     486        KEYWORDS.pop("VALUES")
     487        KEYWORDS.pop("/*+")
     488
     489    class Parser(parser.Parser):
     490        PREFIXED_PIVOT_COLUMNS = True
     491        LOG_DEFAULTS_TO_LN = True
     492        SUPPORTS_IMPLICIT_UNNEST = True
     493
     494        FUNCTIONS = {
     495            **parser.Parser.FUNCTIONS,
     496            "CONTAINS_SUBSTR": _build_contains_substring,
     497            "DATE": _build_date,
     498            "DATE_ADD": build_date_delta_with_interval(exp.DateAdd),
     499            "DATE_SUB": build_date_delta_with_interval(exp.DateSub),
     500            "DATE_TRUNC": lambda args: exp.DateTrunc(
     501                unit=exp.Literal.string(str(seq_get(args, 1))),
     502                this=seq_get(args, 0),
     503                zone=seq_get(args, 2),
     504            ),
     505            "DATETIME": _build_datetime,
     506            "DATETIME_ADD": build_date_delta_with_interval(exp.DatetimeAdd),
     507            "DATETIME_SUB": build_date_delta_with_interval(exp.DatetimeSub),
     508            "DIV": binary_from_function(exp.IntDiv),
     509            "EDIT_DISTANCE": _build_levenshtein,
     510            "FORMAT_DATE": _build_format_time(exp.TsOrDsToDate),
     511            "GENERATE_ARRAY": exp.GenerateSeries.from_arg_list,
     512            "JSON_EXTRACT_SCALAR": _build_extract_json_with_default_path(exp.JSONExtractScalar),
     513            "JSON_EXTRACT_ARRAY": _build_extract_json_with_default_path(exp.JSONExtractArray),
     514            "JSON_QUERY": parser.build_extract_json_with_path(exp.JSONExtract),
     515            "JSON_QUERY_ARRAY": _build_extract_json_with_default_path(exp.JSONExtractArray),
     516            "JSON_VALUE": _build_extract_json_with_default_path(exp.JSONExtractScalar),
     517            "JSON_VALUE_ARRAY": _build_extract_json_with_default_path(exp.JSONValueArray),
     518            "LENGTH": lambda args: exp.Length(this=seq_get(args, 0), binary=True),
     519            "MD5": exp.MD5Digest.from_arg_list,
     520            "TO_HEX": _build_to_hex,
     521            "PARSE_DATE": lambda args: build_formatted_time(exp.StrToDate, "bigquery")(
     522                [seq_get(args, 1), seq_get(args, 0)]
     523            ),
     524            "PARSE_TIMESTAMP": _build_parse_timestamp,
     525            "REGEXP_CONTAINS": exp.RegexpLike.from_arg_list,
     526            "REGEXP_EXTRACT": _build_regexp_extract(exp.RegexpExtract),
     527            "REGEXP_SUBSTR": _build_regexp_extract(exp.RegexpExtract),
     528            "REGEXP_EXTRACT_ALL": _build_regexp_extract(
     529                exp.RegexpExtractAll, default_group=exp.Literal.number(0)
     530            ),
     531            "SHA256": lambda args: exp.SHA2(this=seq_get(args, 0), length=exp.Literal.number(256)),
     532            "SHA512": lambda args: exp.SHA2(this=seq_get(args, 0), length=exp.Literal.number(512)),
     533            "SPLIT": lambda args: exp.Split(
     534                # https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#split
     535                this=seq_get(args, 0),
     536                expression=seq_get(args, 1) or exp.Literal.string(","),
     537            ),
     538            "STRPOS": exp.StrPosition.from_arg_list,
     539            "TIME": _build_time,
     540            "TIME_ADD": build_date_delta_with_interval(exp.TimeAdd),
     541            "TIME_SUB": build_date_delta_with_interval(exp.TimeSub),
     542            "TIMESTAMP": _build_timestamp,
     543            "TIMESTAMP_ADD": build_date_delta_with_interval(exp.TimestampAdd),
     544            "TIMESTAMP_SUB": build_date_delta_with_interval(exp.TimestampSub),
     545            "TIMESTAMP_MICROS": lambda args: exp.UnixToTime(
     546                this=seq_get(args, 0), scale=exp.UnixToTime.MICROS
     547            ),
     548            "TIMESTAMP_MILLIS": lambda args: exp.UnixToTime(
     549                this=seq_get(args, 0), scale=exp.UnixToTime.MILLIS
     550            ),
     551            "TIMESTAMP_SECONDS": lambda args: exp.UnixToTime(this=seq_get(args, 0)),
     552            "TO_JSON_STRING": exp.JSONFormat.from_arg_list,
     553            "FORMAT_DATETIME": _build_format_time(exp.TsOrDsToDatetime),
     554            "FORMAT_TIMESTAMP": _build_format_time(exp.TsOrDsToTimestamp),
     555        }
     556
     557        FUNCTION_PARSERS = {
     558            **parser.Parser.FUNCTION_PARSERS,
     559            "ARRAY": lambda self: self.expression(exp.Array, expressions=[self._parse_statement()]),
     560            "MAKE_INTERVAL": lambda self: self._parse_make_interval(),
     561            "FEATURES_AT_TIME": lambda self: self._parse_features_at_time(),
     562        }
     563        FUNCTION_PARSERS.pop("TRIM")
     564
     565        NO_PAREN_FUNCTIONS = {
     566            **parser.Parser.NO_PAREN_FUNCTIONS,
     567            TokenType.CURRENT_DATETIME: exp.CurrentDatetime,
     568        }
     569
     570        NESTED_TYPE_TOKENS = {
     571            *parser.Parser.NESTED_TYPE_TOKENS,
     572            TokenType.TABLE,
     573        }
     574
     575        PROPERTY_PARSERS = {
     576            **parser.Parser.PROPERTY_PARSERS,
     577            "NOT DETERMINISTIC": lambda self: self.expression(
     578                exp.StabilityProperty, this=exp.Literal.string("VOLATILE")
     579            ),
     580            "OPTIONS": lambda self: self._parse_with_property(),
     581        }
     582
     583        CONSTRAINT_PARSERS = {
     584            **parser.Parser.CONSTRAINT_PARSERS,
     585            "OPTIONS": lambda self: exp.Properties(expressions=self._parse_with_property()),
     586        }
     587
     588        RANGE_PARSERS = parser.Parser.RANGE_PARSERS.copy()
     589        RANGE_PARSERS.pop(TokenType.OVERLAPS)
     590
     591        NULL_TOKENS = {TokenType.NULL, TokenType.UNKNOWN}
     592
     593        DASHED_TABLE_PART_FOLLOW_TOKENS = {TokenType.DOT, TokenType.L_PAREN, TokenType.R_PAREN}
     594
     595        STATEMENT_PARSERS = {
     596            **parser.Parser.STATEMENT_PARSERS,
     597            TokenType.ELSE: lambda self: self._parse_as_command(self._prev),
     598            TokenType.END: lambda self: self._parse_as_command(self._prev),
     599            TokenType.FOR: lambda self: self._parse_for_in(),
     600        }
     601
     602        BRACKET_OFFSETS = {
     603            "OFFSET": (0, False),
     604            "ORDINAL": (1, False),
     605            "SAFE_OFFSET": (0, True),
     606            "SAFE_ORDINAL": (1, True),
     607        }
     608
     609        def _parse_for_in(self) -> exp.ForIn:
     610            this = self._parse_range()
     611            self._match_text_seq("DO")
     612            return self.expression(exp.ForIn, this=this, expression=self._parse_statement())
     613
     614        def _parse_table_part(self, schema: bool = False) -> t.Optional[exp.Expression]:
     615            this = super()._parse_table_part(schema=schema) or self._parse_number()
     616
     617            # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#table_names
     618            if isinstance(this, exp.Identifier):
     619                table_name = this.name
     620                while self._match(TokenType.DASH, advance=False) and self._next:
     621                    start = self._curr
     622                    while self._is_connected() and not self._match_set(
     623                        self.DASHED_TABLE_PART_FOLLOW_TOKENS, advance=False
     624                    ):
     625                        self._advance()
     626
     627                    table_name += self._find_sql(start, self._prev)
     628
     629                this = exp.Identifier(this=table_name, quoted=this.args.get("quoted"))
     630            elif isinstance(this, exp.Literal):
     631                table_name = this.name
     632
     633                if self._is_connected() and self._parse_var(any_token=True):
     634                    table_name += self._prev.text
     635
     636                this = exp.Identifier(this=table_name, quoted=True)
     637
     638            return this
     639
     640        def _parse_table_parts(
     641            self, schema: bool = False, is_db_reference: bool = False, wildcard: bool = False
     642        ) -> exp.Table:
     643            table = super()._parse_table_parts(
     644                schema=schema, is_db_reference=is_db_reference, wildcard=True
     645            )
     646
     647            # proj-1.db.tbl -- `1.` is tokenized as a float so we need to unravel it here
     648            if not table.catalog:
     649                if table.db:
     650                    parts = table.db.split(".")
     651                    if len(parts) == 2 and not table.args["db"].quoted:
     652                        table.set("catalog", exp.Identifier(this=parts[0]))
     653                        table.set("db", exp.Identifier(this=parts[1]))
     654                else:
     655                    parts = table.name.split(".")
     656                    if len(parts) == 2 and not table.this.quoted:
     657                        table.set("db", exp.Identifier(this=parts[0]))
     658                        table.set("this", exp.Identifier(this=parts[1]))
     659
     660            if isinstance(table.this, exp.Identifier) and any("." in p.name for p in table.parts):
     661                alias = table.this
     662                catalog, db, this, *rest = (
     663                    exp.to_identifier(p, quoted=True)
     664                    for p in split_num_words(".".join(p.name for p in table.parts), ".", 3)
     665                )
     666
     667                if rest and this:
     668                    this = exp.Dot.build([this, *rest])  # type: ignore
     669
     670                table = exp.Table(
     671                    this=this, db=db, catalog=catalog, pivots=table.args.get("pivots")
     672                )
     673                table.meta["quoted_table"] = True
     674            else:
     675                alias = None
     676
     677            # The `INFORMATION_SCHEMA` views in BigQuery need to be qualified by a region or
     678            # dataset, so if the project identifier is omitted we need to fix the ast so that
     679            # the `INFORMATION_SCHEMA.X` bit is represented as a single (quoted) Identifier.
     680            # Otherwise, we wouldn't correctly qualify a `Table` node that references these
     681            # views, because it would seem like the "catalog" part is set, when it'd actually
     682            # be the region/dataset. Merging the two identifiers into a single one is done to
     683            # avoid producing a 4-part Table reference, which would cause issues in the schema
     684            # module, when there are 3-part table names mixed with information schema views.
     685            #
     686            # See: https://cloud.google.com/bigquery/docs/information-schema-intro#syntax
     687            table_parts = table.parts
     688            if len(table_parts) > 1 and table_parts[-2].name.upper() == "INFORMATION_SCHEMA":
     689                # We need to alias the table here to avoid breaking existing qualified columns.
     690                # This is expected to be safe, because if there's an actual alias coming up in
     691                # the token stream, it will overwrite this one. If there isn't one, we are only
     692                # exposing the name that can be used to reference the view explicitly (a no-op).
     693                exp.alias_(
     694                    table,
     695                    t.cast(exp.Identifier, alias or table_parts[-1]),
     696                    table=True,
     697                    copy=False,
     698                )
     699
     700                info_schema_view = f"{table_parts[-2].name}.{table_parts[-1].name}"
     701                table.set("this", exp.Identifier(this=info_schema_view, quoted=True))
     702                table.set("db", seq_get(table_parts, -3))
     703                table.set("catalog", seq_get(table_parts, -4))
     704
     705            return table
     706
     707        def _parse_column(self) -> t.Optional[exp.Expression]:
     708            column = super()._parse_column()
     709            if isinstance(column, exp.Column):
     710                parts = column.parts
     711                if any("." in p.name for p in parts):
     712                    catalog, db, table, this, *rest = (
     713                        exp.to_identifier(p, quoted=True)
     714                        for p in split_num_words(".".join(p.name for p in parts), ".", 4)
     715                    )
     716
     717                    if rest and this:
     718                        this = exp.Dot.build([this, *rest])  # type: ignore
     719
     720                    column = exp.Column(this=this, table=table, db=db, catalog=catalog)
     721                    column.meta["quoted_column"] = True
     722
     723            return column
     724
     725        @t.overload
     726        def _parse_json_object(self, agg: Lit[False]) -> exp.JSONObject: ...
     727
     728        @t.overload
     729        def _parse_json_object(self, agg: Lit[True]) -> exp.JSONObjectAgg: ...
     730
     731        def _parse_json_object(self, agg=False):
     732            json_object = super()._parse_json_object()
     733            array_kv_pair = seq_get(json_object.expressions, 0)
     734
     735            # Converts BQ's "signature 2" of JSON_OBJECT into SQLGlot's canonical representation
     736            # https://cloud.google.com/bigquery/docs/reference/standard-sql/json_functions#json_object_signature2
     737            if (
     738                array_kv_pair
     739                and isinstance(array_kv_pair.this, exp.Array)
     740                and isinstance(array_kv_pair.expression, exp.Array)
     741            ):
     742                keys = array_kv_pair.this.expressions
     743                values = array_kv_pair.expression.expressions
     744
     745                json_object.set(
     746                    "expressions",
     747                    [exp.JSONKeyValue(this=k, expression=v) for k, v in zip(keys, values)],
     748                )
     749
     750            return json_object
     751
     752        def _parse_bracket(
     753            self, this: t.Optional[exp.Expression] = None
     754        ) -> t.Optional[exp.Expression]:
     755            bracket = super()._parse_bracket(this)
     756
     757            if this is bracket:
     758                return bracket
     759
     760            if isinstance(bracket, exp.Bracket):
     761                for expression in bracket.expressions:
     762                    name = expression.name.upper()
     763
     764                    if name not in self.BRACKET_OFFSETS:
     765                        break
     766
     767                    offset, safe = self.BRACKET_OFFSETS[name]
     768                    bracket.set("offset", offset)
     769                    bracket.set("safe", safe)
     770                    expression.replace(expression.expressions[0])
     771
     772            return bracket
     773
     774        def _parse_unnest(self, with_alias: bool = True) -> t.Optional[exp.Unnest]:
     775            unnest = super()._parse_unnest(with_alias=with_alias)
     776
     777            if not unnest:
     778                return None
     779
     780            unnest_expr = seq_get(unnest.expressions, 0)
     781            if unnest_expr:
     782                from sqlglot.optimizer.annotate_types import annotate_types
     783
     784                unnest_expr = annotate_types(unnest_expr)
     785
     786                # Unnesting a nested array (i.e array of structs) explodes the top-level struct fields,
     787                # in contrast to other dialects such as DuckDB which flattens only the array by default
     788                if unnest_expr.is_type(exp.DataType.Type.ARRAY) and any(
     789                    array_elem.is_type(exp.DataType.Type.STRUCT)
     790                    for array_elem in unnest_expr._type.expressions
     791                ):
     792                    unnest.set("explode_array", True)
     793
     794            return unnest
     795
     796        def _parse_make_interval(self) -> exp.MakeInterval:
     797            expr = exp.MakeInterval()
     798
     799            for arg_key in expr.arg_types:
     800                value = self._parse_lambda()
     801
     802                if not value:
     803                    break
     804
     805                # Non-named arguments are filled sequentially, (optionally) followed by named arguments
     806                # that can appear in any order e.g MAKE_INTERVAL(1, minute => 5, day => 2)
     807                if isinstance(value, exp.Kwarg):
     808                    arg_key = value.this.name
     809
     810                expr.set(arg_key, value)
     811
     812                self._match(TokenType.COMMA)
     813
     814            return expr
     815
     816        def _parse_features_at_time(self) -> exp.FeaturesAtTime:
     817            expr = self.expression(
     818                exp.FeaturesAtTime,
     819                this=(self._match(TokenType.TABLE) and self._parse_table())
     820                or self._parse_select(nested=True),
     821            )
     822
     823            while self._match(TokenType.COMMA):
     824                arg = self._parse_lambda()
     825
     826                # Get the LHS of the Kwarg and set the arg to that value, e.g
     827                # "num_rows => 1" sets the expr's `num_rows` arg
     828                if arg:
     829                    expr.set(arg.this.name, arg)
     830
     831            return expr
     832
     833    class Generator(generator.Generator):
     834        INTERVAL_ALLOWS_PLURAL_FORM = False
     835        JOIN_HINTS = False
     836        QUERY_HINTS = False
     837        TABLE_HINTS = False
     838        LIMIT_FETCH = "LIMIT"
     839        RENAME_TABLE_WITH_DB = False
     840        NVL2_SUPPORTED = False
     841        UNNEST_WITH_ORDINALITY = False
     842        COLLATE_IS_FUNC = True
     843        LIMIT_ONLY_LITERALS = True
     844        SUPPORTS_TABLE_ALIAS_COLUMNS = False
     845        UNPIVOT_ALIASES_ARE_IDENTIFIERS = False
     846        JSON_KEY_VALUE_PAIR_SEP = ","
     847        NULL_ORDERING_SUPPORTED = False
     848        IGNORE_NULLS_IN_FUNC = True
     849        JSON_PATH_SINGLE_QUOTE_ESCAPE = True
     850        CAN_IMPLEMENT_ARRAY_ANY = True
     851        SUPPORTS_TO_NUMBER = False
     852        NAMED_PLACEHOLDER_TOKEN = "@"
     853        HEX_FUNC = "TO_HEX"
     854        WITH_PROPERTIES_PREFIX = "OPTIONS"
     855        SUPPORTS_EXPLODING_PROJECTIONS = False
     856        EXCEPT_INTERSECT_SUPPORT_ALL_CLAUSE = False
     857        SUPPORTS_UNIX_SECONDS = True
     858
     859        TRANSFORMS = {
     860            **generator.Generator.TRANSFORMS,
     861            exp.ApproxDistinct: rename_func("APPROX_COUNT_DISTINCT"),
     862            exp.ArgMax: arg_max_or_min_no_count("MAX_BY"),
     863            exp.ArgMin: arg_max_or_min_no_count("MIN_BY"),
     864            exp.Array: inline_array_unless_query,
     865            exp.ArrayContains: _array_contains_sql,
     866            exp.ArrayFilter: filter_array_using_unnest,
     867            exp.Cast: transforms.preprocess([transforms.remove_precision_parameterized_types]),
     868            exp.CollateProperty: lambda self, e: (
     869                f"DEFAULT COLLATE {self.sql(e, 'this')}"
     870                if e.args.get("default")
     871                else f"COLLATE {self.sql(e, 'this')}"
     872            ),
     873            exp.Commit: lambda *_: "COMMIT TRANSACTION",
     874            exp.CountIf: rename_func("COUNTIF"),
     875            exp.Create: _create_sql,
     876            exp.CTE: transforms.preprocess([_pushdown_cte_column_names]),
     877            exp.DateAdd: date_add_interval_sql("DATE", "ADD"),
     878            exp.DateDiff: lambda self, e: self.func(
     879                "DATE_DIFF", e.this, e.expression, unit_to_var(e)
     880            ),
     881            exp.DateFromParts: rename_func("DATE"),
     882            exp.DateStrToDate: datestrtodate_sql,
     883            exp.DateSub: date_add_interval_sql("DATE", "SUB"),
     884            exp.DatetimeAdd: date_add_interval_sql("DATETIME", "ADD"),
     885            exp.DatetimeSub: date_add_interval_sql("DATETIME", "SUB"),
     886            exp.DateTrunc: lambda self, e: self.func(
     887                "DATE_TRUNC", e.this, e.text("unit"), e.args.get("zone")
     888            ),
     889            exp.FromTimeZone: lambda self, e: self.func(
     890                "DATETIME", self.func("TIMESTAMP", e.this, e.args.get("zone")), "'UTC'"
     891            ),
     892            exp.GenerateSeries: rename_func("GENERATE_ARRAY"),
     893            exp.GroupConcat: rename_func("STRING_AGG"),
     894            exp.Hex: lambda self, e: self.func("UPPER", self.func("TO_HEX", self.sql(e, "this"))),
     895            exp.If: if_sql(false_value="NULL"),
     896            exp.ILike: no_ilike_sql,
     897            exp.IntDiv: rename_func("DIV"),
     898            exp.Int64: rename_func("INT64"),
     899            exp.JSONExtract: _json_extract_sql,
     900            exp.JSONExtractArray: _json_extract_sql,
     901            exp.JSONExtractScalar: _json_extract_sql,
     902            exp.JSONFormat: rename_func("TO_JSON_STRING"),
     903            exp.Levenshtein: _levenshtein_sql,
     904            exp.Max: max_or_greatest,
     905            exp.MD5: lambda self, e: self.func("TO_HEX", self.func("MD5", e.this)),
     906            exp.MD5Digest: rename_func("MD5"),
     907            exp.Min: min_or_least,
     908            exp.PartitionedByProperty: lambda self, e: f"PARTITION BY {self.sql(e, 'this')}",
     909            exp.RegexpExtract: lambda self, e: self.func(
     910                "REGEXP_EXTRACT",
     911                e.this,
     912                e.expression,
     913                e.args.get("position"),
     914                e.args.get("occurrence"),
     915            ),
     916            exp.RegexpExtractAll: lambda self, e: self.func(
     917                "REGEXP_EXTRACT_ALL", e.this, e.expression
     918            ),
     919            exp.RegexpReplace: regexp_replace_sql,
     920            exp.RegexpLike: rename_func("REGEXP_CONTAINS"),
     921            exp.ReturnsProperty: _returnsproperty_sql,
     922            exp.Rollback: lambda *_: "ROLLBACK TRANSACTION",
     923            exp.Select: transforms.preprocess(
     924                [
     925                    transforms.explode_to_unnest(),
     926                    transforms.unqualify_unnest,
     927                    transforms.eliminate_distinct_on,
     928                    _alias_ordered_group,
     929                    transforms.eliminate_semi_and_anti_joins,
     930                ]
     931            ),
     932            exp.SHA: rename_func("SHA1"),
     933            exp.SHA2: sha256_sql,
     934            exp.StabilityProperty: lambda self, e: (
     935                "DETERMINISTIC" if e.name == "IMMUTABLE" else "NOT DETERMINISTIC"
     936            ),
     937            exp.String: rename_func("STRING"),
     938            exp.StrPosition: lambda self, e: (
     939                strposition_sql(
     940                    self, e, func_name="INSTR", supports_position=True, supports_occurrence=True
     941                )
     942            ),
     943            exp.StrToDate: _str_to_datetime_sql,
     944            exp.StrToTime: _str_to_datetime_sql,
     945            exp.TimeAdd: date_add_interval_sql("TIME", "ADD"),
     946            exp.TimeFromParts: rename_func("TIME"),
     947            exp.TimestampFromParts: rename_func("DATETIME"),
     948            exp.TimeSub: date_add_interval_sql("TIME", "SUB"),
     949            exp.TimestampAdd: date_add_interval_sql("TIMESTAMP", "ADD"),
     950            exp.TimestampDiff: rename_func("TIMESTAMP_DIFF"),
     951            exp.TimestampSub: date_add_interval_sql("TIMESTAMP", "SUB"),
     952            exp.TimeStrToTime: timestrtotime_sql,
     953            exp.Transaction: lambda *_: "BEGIN TRANSACTION",
     954            exp.TsOrDsAdd: _ts_or_ds_add_sql,
     955            exp.TsOrDsDiff: _ts_or_ds_diff_sql,
     956            exp.TsOrDsToTime: rename_func("TIME"),
     957            exp.TsOrDsToDatetime: rename_func("DATETIME"),
     958            exp.TsOrDsToTimestamp: rename_func("TIMESTAMP"),
     959            exp.Unhex: rename_func("FROM_HEX"),
     960            exp.UnixDate: rename_func("UNIX_DATE"),
     961            exp.UnixToTime: _unix_to_time_sql,
     962            exp.Uuid: lambda *_: "GENERATE_UUID()",
     963            exp.Values: _derived_table_values_to_unnest,
     964            exp.VariancePop: rename_func("VAR_POP"),
     965            exp.SafeDivide: rename_func("SAFE_DIVIDE"),
     966        }
     967
     968        SUPPORTED_JSON_PATH_PARTS = {
     969            exp.JSONPathKey,
     970            exp.JSONPathRoot,
     971            exp.JSONPathSubscript,
     972        }
     973
     974        TYPE_MAPPING = {
     975            **generator.Generator.TYPE_MAPPING,
     976            exp.DataType.Type.BIGDECIMAL: "BIGNUMERIC",
     977            exp.DataType.Type.BIGINT: "INT64",
     978            exp.DataType.Type.BINARY: "BYTES",
     979            exp.DataType.Type.BOOLEAN: "BOOL",
     980            exp.DataType.Type.CHAR: "STRING",
     981            exp.DataType.Type.DECIMAL: "NUMERIC",
     982            exp.DataType.Type.DOUBLE: "FLOAT64",
     983            exp.DataType.Type.FLOAT: "FLOAT64",
     984            exp.DataType.Type.INT: "INT64",
     985            exp.DataType.Type.NCHAR: "STRING",
     986            exp.DataType.Type.NVARCHAR: "STRING",
     987            exp.DataType.Type.SMALLINT: "INT64",
     988            exp.DataType.Type.TEXT: "STRING",
     989            exp.DataType.Type.TIMESTAMP: "DATETIME",
     990            exp.DataType.Type.TIMESTAMPTZ: "TIMESTAMP",
     991            exp.DataType.Type.TIMESTAMPLTZ: "TIMESTAMP",
     992            exp.DataType.Type.TINYINT: "INT64",
     993            exp.DataType.Type.ROWVERSION: "BYTES",
     994            exp.DataType.Type.UUID: "STRING",
     995            exp.DataType.Type.VARBINARY: "BYTES",
     996            exp.DataType.Type.VARCHAR: "STRING",
     997            exp.DataType.Type.VARIANT: "ANY TYPE",
     998        }
     999
    1000        PROPERTIES_LOCATION = {
    1001            **generator.Generator.PROPERTIES_LOCATION,
    1002            exp.PartitionedByProperty: exp.Properties.Location.POST_SCHEMA,
    1003            exp.VolatileProperty: exp.Properties.Location.UNSUPPORTED,
    1004        }
    1005
    1006        # WINDOW comes after QUALIFY
    1007        # https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#window_clause
    1008        AFTER_HAVING_MODIFIER_TRANSFORMS = {
    1009            "qualify": generator.Generator.AFTER_HAVING_MODIFIER_TRANSFORMS["qualify"],
    1010            "windows": generator.Generator.AFTER_HAVING_MODIFIER_TRANSFORMS["windows"],
    1011        }
    1012
    1013        # from: https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#reserved_keywords
    1014        RESERVED_KEYWORDS = {
    1015            "all",
    1016            "and",
    1017            "any",
    1018            "array",
    1019            "as",
    1020            "asc",
    1021            "assert_rows_modified",
    1022            "at",
    1023            "between",
    1024            "by",
    1025            "case",
    1026            "cast",
    1027            "collate",
    1028            "contains",
    1029            "create",
    1030            "cross",
    1031            "cube",
    1032            "current",
    1033            "default",
    1034            "define",
    1035            "desc",
    1036            "distinct",
    1037            "else",
    1038            "end",
    1039            "enum",
    1040            "escape",
    1041            "except",
    1042            "exclude",
    1043            "exists",
    1044            "extract",
    1045            "false",
    1046            "fetch",
    1047            "following",
    1048            "for",
    1049            "from",
    1050            "full",
    1051            "group",
    1052            "grouping",
    1053            "groups",
    1054            "hash",
    1055            "having",
    1056            "if",
    1057            "ignore",
    1058            "in",
    1059            "inner",
    1060            "intersect",
    1061            "interval",
    1062            "into",
    1063            "is",
    1064            "join",
    1065            "lateral",
    1066            "left",
    1067            "like",
    1068            "limit",
    1069            "lookup",
    1070            "merge",
    1071            "natural",
    1072            "new",
    1073            "no",
    1074            "not",
    1075            "null",
    1076            "nulls",
    1077            "of",
    1078            "on",
    1079            "or",
    1080            "order",
    1081            "outer",
    1082            "over",
    1083            "partition",
    1084            "preceding",
    1085            "proto",
    1086            "qualify",
    1087            "range",
    1088            "recursive",
    1089            "respect",
    1090            "right",
    1091            "rollup",
    1092            "rows",
    1093            "select",
    1094            "set",
    1095            "some",
    1096            "struct",
    1097            "tablesample",
    1098            "then",
    1099            "to",
    1100            "treat",
    1101            "true",
    1102            "unbounded",
    1103            "union",
    1104            "unnest",
    1105            "using",
    1106            "when",
    1107            "where",
    1108            "window",
    1109            "with",
    1110            "within",
    1111        }
    1112
    1113        def mod_sql(self, expression: exp.Mod) -> str:
    1114            this = expression.this
    1115            expr = expression.expression
    1116            return self.func(
    1117                "MOD",
    1118                this.unnest() if isinstance(this, exp.Paren) else this,
    1119                expr.unnest() if isinstance(expr, exp.Paren) else expr,
    1120            )
    1121
    1122        def column_parts(self, expression: exp.Column) -> str:
    1123            if expression.meta.get("quoted_column"):
    1124                # If a column reference is of the form `dataset.table`.name, we need
    1125                # to preserve the quoted table path, otherwise the reference breaks
    1126                table_parts = ".".join(p.name for p in expression.parts[:-1])
    1127                table_path = self.sql(exp.Identifier(this=table_parts, quoted=True))
    1128                return f"{table_path}.{self.sql(expression, 'this')}"
    1129
    1130            return super().column_parts(expression)
    1131
    1132        def table_parts(self, expression: exp.Table) -> str:
    1133            # Depending on the context, `x.y` may not resolve to the same data source as `x`.`y`, so
    1134            # we need to make sure the correct quoting is used in each case.
    1135            #
    1136            # For example, if there is a CTE x that clashes with a schema name, then the former will
    1137            # return the table y in that schema, whereas the latter will return the CTE's y column:
    1138            #
    1139            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x.y`   -> cross join
    1140            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x`.`y` -> implicit unnest
    1141            if expression.meta.get("quoted_table"):
    1142                table_parts = ".".join(p.name for p in expression.parts)
    1143                return self.sql(exp.Identifier(this=table_parts, quoted=True))
    1144
    1145            return super().table_parts(expression)
    1146
    1147        def timetostr_sql(self, expression: exp.TimeToStr) -> str:
    1148            this = expression.this
    1149            if isinstance(this, exp.TsOrDsToDatetime):
    1150                func_name = "FORMAT_DATETIME"
    1151            elif isinstance(this, exp.TsOrDsToTimestamp):
    1152                func_name = "FORMAT_TIMESTAMP"
    1153            else:
    1154                func_name = "FORMAT_DATE"
    1155
    1156            time_expr = (
    1157                this
    1158                if isinstance(this, (exp.TsOrDsToDatetime, exp.TsOrDsToTimestamp, exp.TsOrDsToDate))
    1159                else expression
    1160            )
    1161            return self.func(func_name, self.format_time(expression), time_expr.this)
    1162
    1163        def eq_sql(self, expression: exp.EQ) -> str:
    1164            # Operands of = cannot be NULL in BigQuery
    1165            if isinstance(expression.left, exp.Null) or isinstance(expression.right, exp.Null):
    1166                if not isinstance(expression.parent, exp.Update):
    1167                    return "NULL"
    1168
    1169            return self.binary(expression, "=")
    1170
    1171        def attimezone_sql(self, expression: exp.AtTimeZone) -> str:
    1172            parent = expression.parent
    1173
    1174            # BigQuery allows CAST(.. AS {STRING|TIMESTAMP} [FORMAT <fmt> [AT TIME ZONE <tz>]]).
    1175            # Only the TIMESTAMP one should use the below conversion, when AT TIME ZONE is included.
    1176            if not isinstance(parent, exp.Cast) or not parent.to.is_type("text"):
    1177                return self.func(
    1178                    "TIMESTAMP", self.func("DATETIME", expression.this, expression.args.get("zone"))
    1179                )
    1180
    1181            return super().attimezone_sql(expression)
    1182
    1183        def trycast_sql(self, expression: exp.TryCast) -> str:
    1184            return self.cast_sql(expression, safe_prefix="SAFE_")
    1185
    1186        def bracket_sql(self, expression: exp.Bracket) -> str:
    1187            this = expression.this
    1188            expressions = expression.expressions
    1189
    1190            if len(expressions) == 1 and this and this.is_type(exp.DataType.Type.STRUCT):
    1191                arg = expressions[0]
    1192                if arg.type is None:
    1193                    from sqlglot.optimizer.annotate_types import annotate_types
    1194
    1195                    arg = annotate_types(arg)
    1196
    1197                if arg.type and arg.type.this in exp.DataType.TEXT_TYPES:
    1198                    # BQ doesn't support bracket syntax with string values for structs
    1199                    return f"{self.sql(this)}.{arg.name}"
    1200
    1201            expressions_sql = self.expressions(expression, flat=True)
    1202            offset = expression.args.get("offset")
    1203
    1204            if offset == 0:
    1205                expressions_sql = f"OFFSET({expressions_sql})"
    1206            elif offset == 1:
    1207                expressions_sql = f"ORDINAL({expressions_sql})"
    1208            elif offset is not None:
    1209                self.unsupported(f"Unsupported array offset: {offset}")
    1210
    1211            if expression.args.get("safe"):
    1212                expressions_sql = f"SAFE_{expressions_sql}"
    1213
    1214            return f"{self.sql(this)}[{expressions_sql}]"
    1215
    1216        def in_unnest_op(self, expression: exp.Unnest) -> str:
    1217            return self.sql(expression)
    1218
    1219        def version_sql(self, expression: exp.Version) -> str:
    1220            if expression.name == "TIMESTAMP":
    1221                expression.set("this", "SYSTEM_TIME")
    1222            return super().version_sql(expression)
    1223
    1224        def contains_sql(self, expression: exp.Contains) -> str:
    1225            this = expression.this
    1226            expr = expression.expression
    1227
    1228            if isinstance(this, exp.Lower) and isinstance(expr, exp.Lower):
    1229                this = this.this
    1230                expr = expr.this
    1231
    1232            return self.func("CONTAINS_SUBSTR", this, expr)

WEEK_OFFSET = -1

First day of the week in DATE_TRUNC(week). Defaults to 0 (Monday). -1 would be Sunday.

UNNEST_COLUMN_ONLY = True

Whether `UNNEST` table aliases are treated as column aliases.

SUPPORTS_USER_DEFINED_TYPES = False

Whether user-defined data types are supported.

SUPPORTS_SEMI_ANTI_JOIN = False

Whether `SEMI` or `ANTI` joins are supported.

LOG_BASE_FIRST: Optional[bool] = False

Whether the base comes first in the `LOG` function. Possible values: `True`, `False`, `None` (two arguments are not supported by `LOG`)

HEX_LOWERCASE = True

Whether the `HEX` function returns a lowercase hexadecimal string.

FORCE_EARLY_ALIAS_REF_EXPANSION = True

Whether alias reference expansion (_expand_alias_refs()) should run before column qualification (_qualify_columns()).

###### For example:

> WITH data AS ( SELECT 1 AS id, 2 AS my_id ) SELECT id AS my_id FROM data WHERE my_id = 1 GROUP BY my_id, HAVING my_id = 1

In most dialects, "my_id" would refer to "data.my_id" across the query, except: - BigQuery, which will forward the alias to GROUP BY + HAVING clauses i.e it resolves to "WHERE my_id = 1 GROUP BY id HAVING id = 1" - Clickhouse, which will forward the alias across the query i.e it resolves to "WHERE id = 1 GROUP BY id HAVING id = 1"

EXPAND_ALIAS_REFS_EARLY_ONLY_IN_GROUP_BY = True

Whether alias reference expansion before qualification should only happen for the GROUP BY clause.

PRESERVE_ORIGINAL_NAMES: bool = True

Whether the name of the function should be preserved inside the node's metadata, can be useful for roundtripping deprecated vs new functions that share an AST node e.g JSON_VALUE vs JSON_EXTRACT_SCALAR in BigQuery

NORMALIZATION_STRATEGY = <NormalizationStrategy.CASE_INSENSITIVE: 'CASE_INSENSITIVE'>

Specifies the strategy according to which identifiers should be normalized.

NORMALIZE_FUNCTIONS: bool | str = False

Determines how function names are going to be normalized.

###### Possible values:

> "upper" or True: Convert names to uppercase. "lower": Convert names to lowercase. False: Disables function name normalization.

TIME_MAPPING: Dict[str, str] = {'%D': '%m/%d/%y', '%E6S': '%S.%f', '%e': '%-d'}

Associates this dialect's time formats with their equivalent Python `strftime` formats.

FORMAT_MAPPING: Dict[str, str] = {'DD': '%d', 'MM': '%m', 'MON': '%b', 'MONTH': '%B', 'YYYY': '%Y', 'YY': '%y', 'HH': '%I', 'HH12': '%I', 'HH24': '%H', 'MI': '%M', 'SS': '%S', 'SSSSS': '%f', 'TZH': '%z'}

Helper which is used for parsing the special syntax `CAST(x AS DATE FORMAT 'yyyy')`. If empty, the corresponding trie will be constructed off of `TIME_MAPPING`.

PSEUDOCOLUMNS: Set[str] = {'_PARTITIONTIME', '_PARTITIONDATE'}

Columns that are auto-generated by the engine corresponding to this dialect. For example, such columns may be excluded from `SELECT *` queries.

SET_OP_DISTINCT_BY_DEFAULT: Dict[Type[sqlglot.expressions.Expression], Optional[bool]] = {<class 'sqlglot.expressions.Except'>: None, <class 'sqlglot.expressions.Intersect'>: None, <class 'sqlglot.expressions.Union'>: None}

Whether a set operation uses DISTINCT by default. This is `None` when either `DISTINCT` or `ALL` must be explicitly specified.

ANNOTATORS: Dict[Type[~E], Callable[[sqlglot.optimizer.annotate_types.TypeAnnotator, ~E], ~E]] = {<class 'sqlglot.expressions.Alias'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.BitwiseNot'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Neg'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Not'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Paren'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.PivotAlias'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Unary'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Add'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.And'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ArrayContains'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ArrayContainsAll'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ArrayOverlaps'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Binary'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.BitwiseAnd'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.BitwiseLeftShift'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.BitwiseOr'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.BitwiseRightShift'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.BitwiseXor'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Collate'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Connector'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Corr'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.CovarPop'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.CovarSamp'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.DPipe'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Distance'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Div'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Dot'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.EQ'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Escape'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.GT'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.GTE'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Glob'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ILike'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ILikeAny'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.IntDiv'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Is'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.JSONArrayContains'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.JSONBContains'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.JSONBExtract'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.JSONBExtractScalar'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.JSONExtract'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.JSONExtractScalar'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Kwarg'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.LT'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.LTE'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Like'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.LikeAny'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Mod'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Mul'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.NEQ'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.NullSafeEQ'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.NullSafeNEQ'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Operator'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Or'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Overlaps'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Pow'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.PropertyEQ'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.RegexpILike'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.RegexpLike'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.SimilarTo'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Slice'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Sub'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Xor'>: <function Dialect.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Length'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.ApproxDistinct'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.ArraySize'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.In'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Boolean'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Between'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeStrToDate'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TsOrDsToDate'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Date'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DateFromParts'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.StrToDate'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DateStrToDate'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.CurrentDate'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DiToDate'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DatetimeAdd'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DatetimeSub'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.CurrentDatetime'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Datetime'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Stddev'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Sqrt'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ApproxQuantile'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.SafeDivide'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.VariancePop'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Quantile'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Variance'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.ToDouble'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Log'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Exp'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Round'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Ln'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Avg'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.StddevSamp'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.StddevPop'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DateDiff'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeDiff'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Sign'>: <function BigQuery.<lambda>>, <class 'sqlglot.expressions.DateToDi'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DatetimeDiff'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimestampDiff'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.StrPosition'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Levenshtein'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TsOrDiToDi'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Ceil'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.ParseJSON'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Time'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeStrToTime'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimestampAdd'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.UnixToTime'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeAdd'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.StrToTime'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeSub'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.CurrentTimestamp'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimestampSub'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.CurrentTime'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Quarter'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Day'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Year'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Week'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Month'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Lower'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.UnixToTimeStr'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.ArrayConcat'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Trim'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Initcap'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.UnixToStr'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.ConcatWs'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Substring'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.TimeToTimeStr'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Concat'>: <function BigQuery.<lambda>>, <class 'sqlglot.expressions.TsOrDsToDateStr'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeToStr'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.DateToDateStr'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.String'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Upper'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.GroupConcat'>: <function _annotate_with_type_lambda.<locals>.<lambda>>, <class 'sqlglot.expressions.Abs'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Anonymous'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Array'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.ArrayAgg'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Bracket'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Cast'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Case'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Coalesce'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Count'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.DataType'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.DateAdd'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.DateSub'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.DateTrunc'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Distinct'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Explode'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Extract'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Filter'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.GenerateDateArray'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.GenerateTimestampArray'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Greatest'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.If'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Interval'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Least'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Literal'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Map'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Max'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Min'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Null'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Nullif'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Struct'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Sum'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Timestamp'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.ToMap'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.TryCast'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Unnest'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.VarMap'>: <function Dialect.<lambda>>, <class 'sqlglot.expressions.Floor'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Left'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Right'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Pad'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.RegexpExtract'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.RegexpReplace'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Repeat'>: <function BigQuery.<dictcomp>.<lambda>>, <class 'sqlglot.expressions.Split'>: <function BigQuery.<lambda>>}
def normalize_identifier(self, expression: ~E) -> ~E: View Source

    423    def normalize_identifier(self, expression: E) -> E:
    424        if (
    425            isinstance(expression, exp.Identifier)
    426            and self.normalization_strategy is not NormalizationStrategy.CASE_SENSITIVE
    427        ):
    428            parent = expression.parent
    429            while isinstance(parent, exp.Dot):
    430                parent = parent.parent
    431
    432            # In BigQuery, CTEs are case-insensitive, but UDF and table names are case-sensitive
    433            # by default. The following check uses a heuristic to detect tables based on whether
    434            # they are qualified. This should generally be correct, because tables in BigQuery
    435            # must be qualified with at least a dataset, unless @@dataset_id is set.
    436            case_sensitive = (
    437                isinstance(parent, exp.UserDefinedFunction)
    438                or (
    439                    isinstance(parent, exp.Table)
    440                    and parent.db
    441                    and (parent.meta.get("quoted_table") or not parent.meta.get("maybe_column"))
    442                )
    443                or expression.meta.get("is_table")
    444            )
    445            if not case_sensitive:
    446                expression.set("this", expression.this.lower())
    447
    448        return expression

Transforms an identifier in a way that resembles how it'd be resolved by this dialect.

For example, an identifier like `FoO` would be resolved as `foo` in Postgres, because it lowercases all unquoted identifiers. On the other hand, Snowflake uppercases them, so it would resolve it as `FOO`. If it was quoted, it'd need to be treated as case-sensitive, and so any normalization would be prohibited in order to avoid "breaking" the identifier.

There are also dialects like Spark, which are case-insensitive even when quotes are present, and dialects like MySQL, whose resolution rules match those employed by the underlying operating system, for example they may always be case-sensitive in Linux.

Finally, the normalization behavior of some engines can even be controlled through flags, like in Redshift's case, where users can explicitly set enable_case_sensitive_identifier.

SQLGlot aims to understand and handle all of these different behaviors gracefully, so that it can analyze queries in the optimizer and successfully capture their semantics.

SUPPORTS_COLUMN_JOIN_MARKS = False

Whether the old-style outer join (+) syntax is supported.

UNESCAPED_SEQUENCES: Dict[str, str] = {'\\a': '\x07', '\\b': '\x08', '\\f': '\x0c', '\\n': '\n', '\\r': '\r', '\\t': '\t', '\\v': '\x0b', '\\\\': '\\'}

Mapping of an escaped sequence (`\n`) to its unescaped version (`` ).

tokenizer_class = <class 'BigQuery.Tokenizer'>
jsonpath_tokenizer_class = <class 'sqlglot.tokens.JSONPathTokenizer'>
parser_class = <class 'BigQuery.Parser'>
generator_class = <class 'BigQuery.Generator'>
TIME_TRIE: Dict = {'%': {'D': {0: True}, 'E': {'6': {'S': {0: True}}}, 'e': {0: True}}}
FORMAT_TRIE: Dict = {'D': {'D': {0: True}}, 'M': {'M': {0: True}, 'O': {'N': {0: True, 'T': {'H': {0: True}}}}, 'I': {0: True}}, 'Y': {'Y': {'Y': {'Y': {0: True}}, 0: True}}, 'H': {'H': {0: True, '1': {'2': {0: True}}, '2': {'4': {0: True}}}}, 'S': {'S': {0: True, 'S': {'S': {'S': {0: True}}}}}, 'T': {'Z': {'H': {0: True}}}}
INVERSE_TIME_MAPPING: Dict[str, str] = {'%m/%d/%y': '%D', '%S.%f': '%E6S', '%-d': '%e'}
INVERSE_TIME_TRIE: Dict = {'%': {'m': {'/': {'%': {'d': {'/': {'%': {'y': {0: True}}}}}}}, 'S': {'.': {'%': {'f': {0: True}}}}, '-': {'d': {0: True}}}}
INVERSE_FORMAT_MAPPING: Dict[str, str] = {'%d': 'DD', '%m': 'MM', '%b': 'MON', '%B': 'MONTH', '%Y': 'YYYY', '%y': 'YY', '%I': 'HH12', '%H': 'HH24', '%M': 'MI', '%S': 'SS', '%f': 'SSSSS', '%z': 'TZH'}
INVERSE_FORMAT_TRIE: Dict = {'%': {'d': {0: True}, 'm': {0: True}, 'b': {0: True}, 'B': {0: True}, 'Y': {0: True}, 'y': {0: True}, 'I': {0: True}, 'H': {0: True}, 'M': {0: True}, 'S': {0: True}, 'f': {0: True}, 'z': {0: True}}}
INVERSE_CREATABLE_KIND_MAPPING: dict[str, str] = {}
ESCAPED_SEQUENCES: Dict[str, str] = {'\x07': '\\a', '\x08': '\\b', '\x0c': '\\f', '\n': '\\n', '\r': '\\r', '\t': '\\t', '\x0b': '\\v', '\\': '\\\\'}
QUOTE_START = "'"
QUOTE_END = "'"
IDENTIFIER_START = '`'
IDENTIFIER_END = '`'
BIT_START: Optional[str] = None
BIT_END: Optional[str] = None
HEX_START: Optional[str] = '0x'
HEX_END: Optional[str] = ''
BYTE_START: Optional[str] = "b'"
BYTE_END: Optional[str] = "'"
UNICODE_START: Optional[str] = None
UNICODE_END: Optional[str] = None

##### Inherited Members

sqlglot.dialects.dialect.Dialect
  Dialect
  INDEX_OFFSET
  ALIAS_POST_TABLESAMPLE
  TABLESAMPLE_SIZE_IS_PERCENT
  IDENTIFIERS_CAN_START_WITH_DIGIT
  DPIPE_IS_STRING_CONCAT
  STRICT_STRING_CONCAT
  COPY_PARAMS_ARE_CSV
  NULL_ORDERING
  TYPED_DIVISION
  SAFE_DIVISION
  CONCAT_COALESCE
  DATE_FORMAT
  DATEINT_FORMAT
  TIME_FORMAT
  PREFER_CTE_ALIAS_COLUMN
  SUPPORTS_ORDER_BY_ALL
  HAS_DISTINCT_ARRAY_CONSTRUCTORS
  SUPPORTS_FIXED_SIZE_ARRAYS
  STRICT_JSON_PATH_SYNTAX
  ON_CONDITION_EMPTY_BEFORE_ERROR
  ARRAY_AGG_INCLUDES_NULLS
  PROMOTE_TO_INFERRED_DATETIME_TYPE
  SUPPORTS_VALUES_DEFAULT
  NUMBERS_CAN_BE_UNDERSCORE_SEPARATED
  REGEXP_EXTRACT_DEFAULT_GROUP
  CREATABLE_KIND_MAPPING
  DATE_PART_MAPPING
  TYPE_TO_EXPRESSIONS
  get_or_raise
  format_time
  settings
  case_sensitive
  can_identify
  quote_identifier
  to_json_path
  parse
  parse_into
  generate
  transpile
  tokenize
  tokenizer
  jsonpath_tokenizer
  parser
  generator

class BigQuery.Tokenizer(sqlglot.tokens.Tokenizer): View Source

    450    class Tokenizer(tokens.Tokenizer):
    451        QUOTES = ["'", '"', '"""', "'''"]
    452        COMMENTS = ["--", "#", ("/*", "*/")]
    453        IDENTIFIERS = ["`"]
    454        STRING_ESCAPES = ["\\"]
    455
    456        HEX_STRINGS = [("0x", ""), ("0X", "")]
    457
    458        BYTE_STRINGS = [
    459            (prefix + q, q) for q in t.cast(t.List[str], QUOTES) for prefix in ("b", "B")
    460        ]
    461
    462        RAW_STRINGS = [
    463            (prefix + q, q) for q in t.cast(t.List[str], QUOTES) for prefix in ("r", "R")
    464        ]
    465
    466        KEYWORDS = {
    467            **tokens.Tokenizer.KEYWORDS,
    468            "ANY TYPE": TokenType.VARIANT,
    469            "BEGIN": TokenType.COMMAND,
    470            "BEGIN TRANSACTION": TokenType.BEGIN,
    471            "BYTEINT": TokenType.INT,
    472            "BYTES": TokenType.BINARY,
    473            "CURRENT_DATETIME": TokenType.CURRENT_DATETIME,
    474            "DATETIME": TokenType.TIMESTAMP,
    475            "DECLARE": TokenType.COMMAND,
    476            "ELSEIF": TokenType.COMMAND,
    477            "EXCEPTION": TokenType.COMMAND,
    478            "FLOAT64": TokenType.DOUBLE,
    479            "FOR SYSTEM_TIME": TokenType.TIMESTAMP_SNAPSHOT,
    480            "MODEL": TokenType.MODEL,
    481            "NOT DETERMINISTIC": TokenType.VOLATILE,
    482            "RECORD": TokenType.STRUCT,
    483            "TIMESTAMP": TokenType.TIMESTAMPTZ,
    484        }
    485        KEYWORDS.pop("DIV")
    486        KEYWORDS.pop("VALUES")
    487        KEYWORDS.pop("/*+")

QUOTES = ["'", '"', '"""', "'''"]
COMMENTS = ['--', '#', ('/*', '*/')]
IDENTIFIERS = ['`']
STRING_ESCAPES = ['\\']
HEX_STRINGS = [('0x', ''), ('0X', '')]
BYTE_STRINGS = [("b'", "'"), ("B'", "'"), ('b"', '"'), ('B"', '"'), ('b"""', '"""'), ('B"""', '"""'), ("b'''", "'''"), ("B'''", "'''")]
RAW_STRINGS = [("r'", "'"), ("R'", "'"), ('r"', '"'), ('R"', '"'), ('r"""', '"""'), ('R"""', '"""'), ("r'''", "'''"), ("R'''", "'''")]
KEYWORDS = {'{%': <TokenType.BLOCK_START: 'BLOCK_START'>, '{%+': <TokenType.BLOCK_START: 'BLOCK_START'>, '{%-': <TokenType.BLOCK_START: 'BLOCK_START'>, '%}': <TokenType.BLOCK_END: 'BLOCK_END'>, '+%}': <TokenType.BLOCK_END: 'BLOCK_END'>, '-%}': <TokenType.BLOCK_END: 'BLOCK_END'>, '{{+': <TokenType.BLOCK_START: 'BLOCK_START'>, '{{-': <TokenType.BLOCK_START: 'BLOCK_START'>, '+}}': <TokenType.BLOCK_END: 'BLOCK_END'>, '-}}': <TokenType.BLOCK_END: 'BLOCK_END'>, '==': <TokenType.EQ: 'EQ'>, '::': <TokenType.DCOLON: 'DCOLON'>, '||': <TokenType.DPIPE: 'DPIPE'>, '>=': <TokenType.GTE: 'GTE'>, '<=': <TokenType.LTE: 'LTE'>, '<>': <TokenType.NEQ: 'NEQ'>, '!=': <TokenType.NEQ: 'NEQ'>, ':=': <TokenType.COLON_EQ: 'COLON_EQ'>, '<=>': <TokenType.NULLSAFE_EQ: 'NULLSAFE_EQ'>, '->': <TokenType.ARROW: 'ARROW'>, '->>': <TokenType.DARROW: 'DARROW'>, '=>': <TokenType.FARROW: 'FARROW'>, '#>': <TokenType.HASH_ARROW: 'HASH_ARROW'>, '#>>': <TokenType.DHASH_ARROW: 'DHASH_ARROW'>, '<->': <TokenType.LR_ARROW: 'LR_ARROW'>, '&&': <TokenType.DAMP: 'DAMP'>, '??': <TokenType.DQMARK: 'DQMARK'>, '~~~': <TokenType.GLOB: 'GLOB'>, '~~': <TokenType.LIKE: 'LIKE'>, '~~*': <TokenType.ILIKE: 'ILIKE'>, '~*': <TokenType.IRLIKE: 'IRLIKE'>, 'ALL': <TokenType.ALL: 'ALL'>, 'ALWAYS': <TokenType.ALWAYS: 'ALWAYS'>, 'AND': <TokenType.AND: 'AND'>, 'ANTI': <TokenType.ANTI: 'ANTI'>, 'ANY': <TokenType.ANY: 'ANY'>, 'ASC': <TokenType.ASC: 'ASC'>, 'AS': <TokenType.ALIAS: 'ALIAS'>, 'ASOF': <TokenType.ASOF: 'ASOF'>, 'AUTOINCREMENT': <TokenType.AUTO_INCREMENT: 'AUTO_INCREMENT'>, 'AUTO_INCREMENT': <TokenType.AUTO_INCREMENT: 'AUTO_INCREMENT'>, 'BEGIN': <TokenType.COMMAND: 'COMMAND'>, 'BETWEEN': <TokenType.BETWEEN: 'BETWEEN'>, 'CACHE': <TokenType.CACHE: 'CACHE'>, 'UNCACHE': <TokenType.UNCACHE: 'UNCACHE'>, 'CASE': <TokenType.CASE: 'CASE'>, 'CHARACTER SET': <TokenType.CHARACTER_SET: 'CHARACTER_SET'>, 'CLUSTER BY': <TokenType.CLUSTER_BY: 'CLUSTER_BY'>, 'COLLATE': <TokenType.COLLATE: 'COLLATE'>, 'COLUMN': <TokenType.COLUMN: 'COLUMN'>, 'COMMIT': <TokenType.COMMIT: 'COMMIT'>, 'CONNECT BY': <TokenType.CONNECT_BY: 'CONNECT_BY'>, 'CONSTRAINT': <TokenType.CONSTRAINT: 'CONSTRAINT'>, 'COPY': <TokenType.COPY: 'COPY'>, 'CREATE': <TokenType.CREATE: 'CREATE'>, 'CROSS': <TokenType.CROSS: 'CROSS'>, 'CUBE': <TokenType.CUBE: 'CUBE'>, 'CURRENT_DATE': <TokenType.CURRENT_DATE: 'CURRENT_DATE'>, 'CURRENT_TIME': <TokenType.CURRENT_TIME: 'CURRENT_TIME'>, 'CURRENT_TIMESTAMP': <TokenType.CURRENT_TIMESTAMP: 'CURRENT_TIMESTAMP'>, 'CURRENT_USER': <TokenType.CURRENT_USER: 'CURRENT_USER'>, 'DATABASE': <TokenType.DATABASE: 'DATABASE'>, 'DEFAULT': <TokenType.DEFAULT: 'DEFAULT'>, 'DELETE': <TokenType.DELETE: 'DELETE'>, 'DESC': <TokenType.DESC: 'DESC'>, 'DESCRIBE': <TokenType.DESCRIBE: 'DESCRIBE'>, 'DISTINCT': <TokenType.DISTINCT: 'DISTINCT'>, 'DISTRIBUTE BY': <TokenType.DISTRIBUTE_BY: 'DISTRIBUTE_BY'>, 'DROP': <TokenType.DROP: 'DROP'>, 'ELSE': <TokenType.ELSE: 'ELSE'>, 'END': <TokenType.END: 'END'>, 'ENUM': <TokenType.ENUM: 'ENUM'>, 'ESCAPE': <TokenType.ESCAPE: 'ESCAPE'>, 'EXCEPT': <TokenType.EXCEPT: 'EXCEPT'>, 'EXECUTE': <TokenType.EXECUTE: 'EXECUTE'>, 'EXISTS': <TokenType.EXISTS: 'EXISTS'>, 'FALSE': <TokenType.FALSE: 'FALSE'>, 'FETCH': <TokenType.FETCH: 'FETCH'>, 'FILTER': <TokenType.FILTER: 'FILTER'>, 'FIRST': <TokenType.FIRST: 'FIRST'>, 'FULL': <TokenType.FULL: 'FULL'>, 'FUNCTION': <TokenType.FUNCTION: 'FUNCTION'>, 'FOR': <TokenType.FOR: 'FOR'>, 'FOREIGN KEY': <TokenType.FOREIGN_KEY: 'FOREIGN_KEY'>, 'FORMAT': <TokenType.FORMAT: 'FORMAT'>, 'FROM': <TokenType.FROM: 'FROM'>, 'GEOGRAPHY': <TokenType.GEOGRAPHY: 'GEOGRAPHY'>, 'GEOMETRY': <TokenType.GEOMETRY: 'GEOMETRY'>, 'GLOB': <TokenType.GLOB: 'GLOB'>, 'GROUP BY': <TokenType.GROUP_BY: 'GROUP_BY'>, 'GROUPING SETS': <TokenType.GROUPING_SETS: 'GROUPING_SETS'>, 'HAVING': <TokenType.HAVING: 'HAVING'>, 'ILIKE': <TokenType.ILIKE: 'ILIKE'>, 'IN': <TokenType.IN: 'IN'>, 'INDEX': <TokenType.INDEX: 'INDEX'>, 'INET': <TokenType.INET: 'INET'>, 'INNER': <TokenType.INNER: 'INNER'>, 'INSERT': <TokenType.INSERT: 'INSERT'>, 'INTERVAL': <TokenType.INTERVAL: 'INTERVAL'>, 'INTERSECT': <TokenType.INTERSECT: 'INTERSECT'>, 'INTO': <TokenType.INTO: 'INTO'>, 'IS': <TokenType.IS: 'IS'>, 'ISNULL': <TokenType.ISNULL: 'ISNULL'>, 'JOIN': <TokenType.JOIN: 'JOIN'>, 'KEEP': <TokenType.KEEP: 'KEEP'>, 'KILL': <TokenType.KILL: 'KILL'>, 'LATERAL': <TokenType.LATERAL: 'LATERAL'>, 'LEFT': <TokenType.LEFT: 'LEFT'>, 'LIKE': <TokenType.LIKE: 'LIKE'>, 'LIMIT': <TokenType.LIMIT: 'LIMIT'>, 'LOAD': <TokenType.LOAD: 'LOAD'>, 'LOCK': <TokenType.LOCK: 'LOCK'>, 'MERGE': <TokenType.MERGE: 'MERGE'>, 'NAMESPACE': <TokenType.NAMESPACE: 'NAMESPACE'>, 'NATURAL': <TokenType.NATURAL: 'NATURAL'>, 'NEXT': <TokenType.NEXT: 'NEXT'>, 'NOT': <TokenType.NOT: 'NOT'>, 'NOTNULL': <TokenType.NOTNULL: 'NOTNULL'>, 'NULL': <TokenType.NULL: 'NULL'>, 'OBJECT': <TokenType.OBJECT: 'OBJECT'>, 'OFFSET': <TokenType.OFFSET: 'OFFSET'>, 'ON': <TokenType.ON: 'ON'>, 'OR': <TokenType.OR: 'OR'>, 'XOR': <TokenType.XOR: 'XOR'>, 'ORDER BY': <TokenType.ORDER_BY: 'ORDER_BY'>, 'ORDINALITY': <TokenType.ORDINALITY: 'ORDINALITY'>, 'OUTER': <TokenType.OUTER: 'OUTER'>, 'OVER': <TokenType.OVER: 'OVER'>, 'OVERLAPS': <TokenType.OVERLAPS: 'OVERLAPS'>, 'OVERWRITE': <TokenType.OVERWRITE: 'OVERWRITE'>, 'PARTITION': <TokenType.PARTITION: 'PARTITION'>, 'PARTITION BY': <TokenType.PARTITION_BY: 'PARTITION_BY'>, 'PARTITIONED BY': <TokenType.PARTITION_BY: 'PARTITION_BY'>, 'PARTITIONED_BY': <TokenType.PARTITION_BY: 'PARTITION_BY'>, 'PERCENT': <TokenType.PERCENT: 'PERCENT'>, 'PIVOT': <TokenType.PIVOT: 'PIVOT'>, 'PRAGMA': <TokenType.PRAGMA: 'PRAGMA'>, 'PRIMARY KEY': <TokenType.PRIMARY_KEY: 'PRIMARY_KEY'>, 'PROCEDURE': <TokenType.PROCEDURE: 'PROCEDURE'>, 'QUALIFY': <TokenType.QUALIFY: 'QUALIFY'>, 'RANGE': <TokenType.RANGE: 'RANGE'>, 'RECURSIVE': <TokenType.RECURSIVE: 'RECURSIVE'>, 'REGEXP': <TokenType.RLIKE: 'RLIKE'>, 'RENAME': <TokenType.RENAME: 'RENAME'>, 'REPLACE': <TokenType.REPLACE: 'REPLACE'>, 'RETURNING': <TokenType.RETURNING: 'RETURNING'>, 'REFERENCES': <TokenType.REFERENCES: 'REFERENCES'>, 'RIGHT': <TokenType.RIGHT: 'RIGHT'>, 'RLIKE': <TokenType.RLIKE: 'RLIKE'>, 'ROLLBACK': <TokenType.ROLLBACK: 'ROLLBACK'>, 'ROLLUP': <TokenType.ROLLUP: 'ROLLUP'>, 'ROW': <TokenType.ROW: 'ROW'>, 'ROWS': <TokenType.ROWS: 'ROWS'>, 'SCHEMA': <TokenType.SCHEMA: 'SCHEMA'>, 'SELECT': <TokenType.SELECT: 'SELECT'>, 'SEMI': <TokenType.SEMI: 'SEMI'>, 'SET': <TokenType.SET: 'SET'>, 'SETTINGS': <TokenType.SETTINGS: 'SETTINGS'>, 'SHOW': <TokenType.SHOW: 'SHOW'>, 'SIMILAR TO': <TokenType.SIMILAR_TO: 'SIMILAR_TO'>, 'SOME': <TokenType.SOME: 'SOME'>, 'SORT BY': <TokenType.SORT_BY: 'SORT_BY'>, 'START WITH': <TokenType.START_WITH: 'START_WITH'>, 'STRAIGHT_JOIN': <TokenType.STRAIGHT_JOIN: 'STRAIGHT_JOIN'>, 'TABLE': <TokenType.TABLE: 'TABLE'>, 'TABLESAMPLE': <TokenType.TABLE_SAMPLE: 'TABLE_SAMPLE'>, 'TEMP': <TokenType.TEMPORARY: 'TEMPORARY'>, 'TEMPORARY': <TokenType.TEMPORARY: 'TEMPORARY'>, 'THEN': <TokenType.THEN: 'THEN'>, 'TRUE': <TokenType.TRUE: 'TRUE'>, 'TRUNCATE': <TokenType.TRUNCATE: 'TRUNCATE'>, 'UNION': <TokenType.UNION: 'UNION'>, 'UNKNOWN': <TokenType.UNKNOWN: 'UNKNOWN'>, 'UNNEST': <TokenType.UNNEST: 'UNNEST'>, 'UNPIVOT': <TokenType.UNPIVOT: 'UNPIVOT'>, 'UPDATE': <TokenType.UPDATE: 'UPDATE'>, 'USE': <TokenType.USE: 'USE'>, 'USING': <TokenType.USING: 'USING'>, 'UUID': <TokenType.UUID: 'UUID'>, 'VIEW': <TokenType.VIEW: 'VIEW'>, 'VOLATILE': <TokenType.VOLATILE: 'VOLATILE'>, 'WHEN': <TokenType.WHEN: 'WHEN'>, 'WHERE': <TokenType.WHERE: 'WHERE'>, 'WINDOW': <TokenType.WINDOW: 'WINDOW'>, 'WITH': <TokenType.WITH: 'WITH'>, 'APPLY': <TokenType.APPLY: 'APPLY'>, 'ARRAY': <TokenType.ARRAY: 'ARRAY'>, 'BIT': <TokenType.BIT: 'BIT'>, 'BOOL': <TokenType.BOOLEAN: 'BOOLEAN'>, 'BOOLEAN': <TokenType.BOOLEAN: 'BOOLEAN'>, 'BYTE': <TokenType.TINYINT: 'TINYINT'>, 'MEDIUMINT': <TokenType.MEDIUMINT: 'MEDIUMINT'>, 'INT1': <TokenType.TINYINT: 'TINYINT'>, 'TINYINT': <TokenType.TINYINT: 'TINYINT'>, 'INT16': <TokenType.SMALLINT: 'SMALLINT'>, 'SHORT': <TokenType.SMALLINT: 'SMALLINT'>, 'SMALLINT': <TokenType.SMALLINT: 'SMALLINT'>, 'INT128': <TokenType.INT128: 'INT128'>, 'HUGEINT': <TokenType.INT128: 'INT128'>, 'UHUGEINT': <TokenType.UINT128: 'UINT128'>, 'INT2': <TokenType.SMALLINT: 'SMALLINT'>, 'INTEGER': <TokenType.INT: 'INT'>, 'INT': <TokenType.INT: 'INT'>, 'INT4': <TokenType.INT: 'INT'>, 'INT32': <TokenType.INT: 'INT'>, 'INT64': <TokenType.BIGINT: 'BIGINT'>, 'LONG': <TokenType.BIGINT: 'BIGINT'>, 'BIGINT': <TokenType.BIGINT: 'BIGINT'>, 'INT8': <TokenType.TINYINT: 'TINYINT'>, 'UINT': <TokenType.UINT: 'UINT'>, 'DEC': <TokenType.DECIMAL: 'DECIMAL'>, 'DECIMAL': <TokenType.DECIMAL: 'DECIMAL'>, 'DECIMAL32': <TokenType.DECIMAL32: 'DECIMAL32'>, 'DECIMAL64': <TokenType.DECIMAL64: 'DECIMAL64'>, 'DECIMAL128': <TokenType.DECIMAL128: 'DECIMAL128'>, 'DECIMAL256': <TokenType.DECIMAL256: 'DECIMAL256'>, 'BIGDECIMAL': <TokenType.BIGDECIMAL: 'BIGDECIMAL'>, 'BIGNUMERIC': <TokenType.BIGDECIMAL: 'BIGDECIMAL'>, 'LIST': <TokenType.LIST: 'LIST'>, 'MAP': <TokenType.MAP: 'MAP'>, 'NULLABLE': <TokenType.NULLABLE: 'NULLABLE'>, 'NUMBER': <TokenType.DECIMAL: 'DECIMAL'>, 'NUMERIC': <TokenType.DECIMAL: 'DECIMAL'>, 'FIXED': <TokenType.DECIMAL: 'DECIMAL'>, 'REAL': <TokenType.FLOAT: 'FLOAT'>, 'FLOAT': <TokenType.FLOAT: 'FLOAT'>, 'FLOAT4': <TokenType.FLOAT: 'FLOAT'>, 'FLOAT8': <TokenType.DOUBLE: 'DOUBLE'>, 'DOUBLE': <TokenType.DOUBLE: 'DOUBLE'>, 'DOUBLE PRECISION': <TokenType.DOUBLE: 'DOUBLE'>, 'JSON': <TokenType.JSON: 'JSON'>, 'JSONB': <TokenType.JSONB: 'JSONB'>, 'CHAR': <TokenType.CHAR: 'CHAR'>, 'CHARACTER': <TokenType.CHAR: 'CHAR'>, 'NCHAR': <TokenType.NCHAR: 'NCHAR'>, 'VARCHAR': <TokenType.VARCHAR: 'VARCHAR'>, 'VARCHAR2': <TokenType.VARCHAR: 'VARCHAR'>, 'NVARCHAR': <TokenType.NVARCHAR: 'NVARCHAR'>, 'NVARCHAR2': <TokenType.NVARCHAR: 'NVARCHAR'>, 'BPCHAR': <TokenType.BPCHAR: 'BPCHAR'>, 'STR': <TokenType.TEXT: 'TEXT'>, 'STRING': <TokenType.TEXT: 'TEXT'>, 'TEXT': <TokenType.TEXT: 'TEXT'>, 'LONGTEXT': <TokenType.LONGTEXT: 'LONGTEXT'>, 'MEDIUMTEXT': <TokenType.MEDIUMTEXT: 'MEDIUMTEXT'>, 'TINYTEXT': <TokenType.TINYTEXT: 'TINYTEXT'>, 'CLOB': <TokenType.TEXT: 'TEXT'>, 'LONGVARCHAR': <TokenType.TEXT: 'TEXT'>, 'BINARY': <TokenType.BINARY: 'BINARY'>, 'BLOB': <TokenType.VARBINARY: 'VARBINARY'>, 'LONGBLOB': <TokenType.LONGBLOB: 'LONGBLOB'>, 'MEDIUMBLOB': <TokenType.MEDIUMBLOB: 'MEDIUMBLOB'>, 'TINYBLOB': <TokenType.TINYBLOB: 'TINYBLOB'>, 'BYTEA': <TokenType.VARBINARY: 'VARBINARY'>, 'VARBINARY': <TokenType.VARBINARY: 'VARBINARY'>, 'TIME': <TokenType.TIME: 'TIME'>, 'TIMETZ': <TokenType.TIMETZ: 'TIMETZ'>, 'TIMESTAMP': <TokenType.TIMESTAMPTZ: 'TIMESTAMPTZ'>, 'TIMESTAMPTZ': <TokenType.TIMESTAMPTZ: 'TIMESTAMPTZ'>, 'TIMESTAMPLTZ': <TokenType.TIMESTAMPLTZ: 'TIMESTAMPLTZ'>, 'TIMESTAMP_LTZ': <TokenType.TIMESTAMPLTZ: 'TIMESTAMPLTZ'>, 'TIMESTAMPNTZ': <TokenType.TIMESTAMPNTZ: 'TIMESTAMPNTZ'>, 'TIMESTAMP_NTZ': <TokenType.TIMESTAMPNTZ: 'TIMESTAMPNTZ'>, 'DATE': <TokenType.DATE: 'DATE'>, 'DATETIME': <TokenType.TIMESTAMP: 'TIMESTAMP'>, 'INT4RANGE': <TokenType.INT4RANGE: 'INT4RANGE'>, 'INT4MULTIRANGE': <TokenType.INT4MULTIRANGE: 'INT4MULTIRANGE'>, 'INT8RANGE': <TokenType.INT8RANGE: 'INT8RANGE'>, 'INT8MULTIRANGE': <TokenType.INT8MULTIRANGE: 'INT8MULTIRANGE'>, 'NUMRANGE': <TokenType.NUMRANGE: 'NUMRANGE'>, 'NUMMULTIRANGE': <TokenType.NUMMULTIRANGE: 'NUMMULTIRANGE'>, 'TSRANGE': <TokenType.TSRANGE: 'TSRANGE'>, 'TSMULTIRANGE': <TokenType.TSMULTIRANGE: 'TSMULTIRANGE'>, 'TSTZRANGE': <TokenType.TSTZRANGE: 'TSTZRANGE'>, 'TSTZMULTIRANGE': <TokenType.TSTZMULTIRANGE: 'TSTZMULTIRANGE'>, 'DATERANGE': <TokenType.DATERANGE: 'DATERANGE'>, 'DATEMULTIRANGE': <TokenType.DATEMULTIRANGE: 'DATEMULTIRANGE'>, 'UNIQUE': <TokenType.UNIQUE: 'UNIQUE'>, 'VECTOR': <TokenType.VECTOR: 'VECTOR'>, 'STRUCT': <TokenType.STRUCT: 'STRUCT'>, 'SEQUENCE': <TokenType.SEQUENCE: 'SEQUENCE'>, 'VARIANT': <TokenType.VARIANT: 'VARIANT'>, 'ALTER': <TokenType.ALTER: 'ALTER'>, 'ANALYZE': <TokenType.ANALYZE: 'ANALYZE'>, 'CALL': <TokenType.COMMAND: 'COMMAND'>, 'COMMENT': <TokenType.COMMENT: 'COMMENT'>, 'EXPLAIN': <TokenType.COMMAND: 'COMMAND'>, 'GRANT': <TokenType.GRANT: 'GRANT'>, 'OPTIMIZE': <TokenType.COMMAND: 'COMMAND'>, 'PREPARE': <TokenType.COMMAND: 'COMMAND'>, 'VACUUM': <TokenType.COMMAND: 'COMMAND'>, 'USER-DEFINED': <TokenType.USERDEFINED: 'USERDEFINED'>, 'FOR VERSION': <TokenType.VERSION_SNAPSHOT: 'VERSION_SNAPSHOT'>, 'FOR TIMESTAMP': <TokenType.TIMESTAMP_SNAPSHOT: 'TIMESTAMP_SNAPSHOT'>, 'ANY TYPE': <TokenType.VARIANT: 'VARIANT'>, 'BEGIN TRANSACTION': <TokenType.BEGIN: 'BEGIN'>, 'BYTEINT': <TokenType.INT: 'INT'>, 'BYTES': <TokenType.BINARY: 'BINARY'>, 'CURRENT_DATETIME': <TokenType.CURRENT_DATETIME: 'CURRENT_DATETIME'>, 'DECLARE': <TokenType.COMMAND: 'COMMAND'>, 'ELSEIF': <TokenType.COMMAND: 'COMMAND'>, 'EXCEPTION': <TokenType.COMMAND: 'COMMAND'>, 'FLOAT64': <TokenType.DOUBLE: 'DOUBLE'>, 'FOR SYSTEM_TIME': <TokenType.TIMESTAMP_SNAPSHOT: 'TIMESTAMP_SNAPSHOT'>, 'MODEL': <TokenType.MODEL: 'MODEL'>, 'NOT DETERMINISTIC': <TokenType.VOLATILE: 'VOLATILE'>, 'RECORD': <TokenType.STRUCT: 'STRUCT'>}

##### Inherited Members

sqlglot.tokens.Tokenizer
  Tokenizer
  SINGLE_TOKENS
  BIT_STRINGS
  HEREDOC_STRINGS
  UNICODE_STRINGS
  VAR_SINGLE_TOKENS
  IDENTIFIER_ESCAPES
  HEREDOC_TAG_IS_IDENTIFIER
  HEREDOC_STRING_ALTERNATIVE
  STRING_ESCAPES_ALLOWED_IN_RAW_STRINGS
  NESTED_COMMENTS
  HINT_START
  TOKENS_PRECEDING_HINT
  WHITE_SPACE
  COMMANDS
  COMMAND_PREFIX_TOKENS
  NUMERIC_LITERALS
  dialect
  use_rs_tokenizer
  reset
  tokenize
  tokenize_rs
  size
  sql
  tokens

class BigQuery.Parser(sqlglot.parser.Parser): View Source

    489    class Parser(parser.Parser):
    490        PREFIXED_PIVOT_COLUMNS = True
    491        LOG_DEFAULTS_TO_LN = True
    492        SUPPORTS_IMPLICIT_UNNEST = True
    493
    494        FUNCTIONS = {
    495            **parser.Parser.FUNCTIONS,
    496            "CONTAINS_SUBSTR": _build_contains_substring,
    497            "DATE": _build_date,
    498            "DATE_ADD": build_date_delta_with_interval(exp.DateAdd),
    499            "DATE_SUB": build_date_delta_with_interval(exp.DateSub),
    500            "DATE_TRUNC": lambda args: exp.DateTrunc(
    501                unit=exp.Literal.string(str(seq_get(args, 1))),
    502                this=seq_get(args, 0),
    503                zone=seq_get(args, 2),
    504            ),
    505            "DATETIME": _build_datetime,
    506            "DATETIME_ADD": build_date_delta_with_interval(exp.DatetimeAdd),
    507            "DATETIME_SUB": build_date_delta_with_interval(exp.DatetimeSub),
    508            "DIV": binary_from_function(exp.IntDiv),
    509            "EDIT_DISTANCE": _build_levenshtein,
    510            "FORMAT_DATE": _build_format_time(exp.TsOrDsToDate),
    511            "GENERATE_ARRAY": exp.GenerateSeries.from_arg_list,
    512            "JSON_EXTRACT_SCALAR": _build_extract_json_with_default_path(exp.JSONExtractScalar),
    513            "JSON_EXTRACT_ARRAY": _build_extract_json_with_default_path(exp.JSONExtractArray),
    514            "JSON_QUERY": parser.build_extract_json_with_path(exp.JSONExtract),
    515            "JSON_QUERY_ARRAY": _build_extract_json_with_default_path(exp.JSONExtractArray),
    516            "JSON_VALUE": _build_extract_json_with_default_path(exp.JSONExtractScalar),
    517            "JSON_VALUE_ARRAY": _build_extract_json_with_default_path(exp.JSONValueArray),
    518            "LENGTH": lambda args: exp.Length(this=seq_get(args, 0), binary=True),
    519            "MD5": exp.MD5Digest.from_arg_list,
    520            "TO_HEX": _build_to_hex,
    521            "PARSE_DATE": lambda args: build_formatted_time(exp.StrToDate, "bigquery")(
    522                [seq_get(args, 1), seq_get(args, 0)]
    523            ),
    524            "PARSE_TIMESTAMP": _build_parse_timestamp,
    525            "REGEXP_CONTAINS": exp.RegexpLike.from_arg_list,
    526            "REGEXP_EXTRACT": _build_regexp_extract(exp.RegexpExtract),
    527            "REGEXP_SUBSTR": _build_regexp_extract(exp.RegexpExtract),
    528            "REGEXP_EXTRACT_ALL": _build_regexp_extract(
    529                exp.RegexpExtractAll, default_group=exp.Literal.number(0)
    530            ),
    531            "SHA256": lambda args: exp.SHA2(this=seq_get(args, 0), length=exp.Literal.number(256)),
    532            "SHA512": lambda args: exp.SHA2(this=seq_get(args, 0), length=exp.Literal.number(512)),
    533            "SPLIT": lambda args: exp.Split(
    534                # https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#split
    535                this=seq_get(args, 0),
    536                expression=seq_get(args, 1) or exp.Literal.string(","),
    537            ),
    538            "STRPOS": exp.StrPosition.from_arg_list,
    539            "TIME": _build_time,
    540            "TIME_ADD": build_date_delta_with_interval(exp.TimeAdd),
    541            "TIME_SUB": build_date_delta_with_interval(exp.TimeSub),
    542            "TIMESTAMP": _build_timestamp,
    543            "TIMESTAMP_ADD": build_date_delta_with_interval(exp.TimestampAdd),
    544            "TIMESTAMP_SUB": build_date_delta_with_interval(exp.TimestampSub),
    545            "TIMESTAMP_MICROS": lambda args: exp.UnixToTime(
    546                this=seq_get(args, 0), scale=exp.UnixToTime.MICROS
    547            ),
    548            "TIMESTAMP_MILLIS": lambda args: exp.UnixToTime(
    549                this=seq_get(args, 0), scale=exp.UnixToTime.MILLIS
    550            ),
    551            "TIMESTAMP_SECONDS": lambda args: exp.UnixToTime(this=seq_get(args, 0)),
    552            "TO_JSON_STRING": exp.JSONFormat.from_arg_list,
    553            "FORMAT_DATETIME": _build_format_time(exp.TsOrDsToDatetime),
    554            "FORMAT_TIMESTAMP": _build_format_time(exp.TsOrDsToTimestamp),
    555        }
    556
    557        FUNCTION_PARSERS = {
    558            **parser.Parser.FUNCTION_PARSERS,
    559            "ARRAY": lambda self: self.expression(exp.Array, expressions=[self._parse_statement()]),
    560            "MAKE_INTERVAL": lambda self: self._parse_make_interval(),
    561            "FEATURES_AT_TIME": lambda self: self._parse_features_at_time(),
    562        }
    563        FUNCTION_PARSERS.pop("TRIM")
    564
    565        NO_PAREN_FUNCTIONS = {
    566            **parser.Parser.NO_PAREN_FUNCTIONS,
    567            TokenType.CURRENT_DATETIME: exp.CurrentDatetime,
    568        }
    569
    570        NESTED_TYPE_TOKENS = {
    571            *parser.Parser.NESTED_TYPE_TOKENS,
    572            TokenType.TABLE,
    573        }
    574
    575        PROPERTY_PARSERS = {
    576            **parser.Parser.PROPERTY_PARSERS,
    577            "NOT DETERMINISTIC": lambda self: self.expression(
    578                exp.StabilityProperty, this=exp.Literal.string("VOLATILE")
    579            ),
    580            "OPTIONS": lambda self: self._parse_with_property(),
    581        }
    582
    583        CONSTRAINT_PARSERS = {
    584            **parser.Parser.CONSTRAINT_PARSERS,
    585            "OPTIONS": lambda self: exp.Properties(expressions=self._parse_with_property()),
    586        }
    587
    588        RANGE_PARSERS = parser.Parser.RANGE_PARSERS.copy()
    589        RANGE_PARSERS.pop(TokenType.OVERLAPS)
    590
    591        NULL_TOKENS = {TokenType.NULL, TokenType.UNKNOWN}
    592
    593        DASHED_TABLE_PART_FOLLOW_TOKENS = {TokenType.DOT, TokenType.L_PAREN, TokenType.R_PAREN}
    594
    595        STATEMENT_PARSERS = {
    596            **parser.Parser.STATEMENT_PARSERS,
    597            TokenType.ELSE: lambda self: self._parse_as_command(self._prev),
    598            TokenType.END: lambda self: self._parse_as_command(self._prev),
    599            TokenType.FOR: lambda self: self._parse_for_in(),
    600        }
    601
    602        BRACKET_OFFSETS = {
    603            "OFFSET": (0, False),
    604            "ORDINAL": (1, False),
    605            "SAFE_OFFSET": (0, True),
    606            "SAFE_ORDINAL": (1, True),
    607        }
    608
    609        def _parse_for_in(self) -> exp.ForIn:
    610            this = self._parse_range()
    611            self._match_text_seq("DO")
    612            return self.expression(exp.ForIn, this=this, expression=self._parse_statement())
    613
    614        def _parse_table_part(self, schema: bool = False) -> t.Optional[exp.Expression]:
    615            this = super()._parse_table_part(schema=schema) or self._parse_number()
    616
    617            # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#table_names
    618            if isinstance(this, exp.Identifier):
    619                table_name = this.name
    620                while self._match(TokenType.DASH, advance=False) and self._next:
    621                    start = self._curr
    622                    while self._is_connected() and not self._match_set(
    623                        self.DASHED_TABLE_PART_FOLLOW_TOKENS, advance=False
    624                    ):
    625                        self._advance()
    626
    627                    table_name += self._find_sql(start, self._prev)
    628
    629                this = exp.Identifier(this=table_name, quoted=this.args.get("quoted"))
    630            elif isinstance(this, exp.Literal):
    631                table_name = this.name
    632
    633                if self._is_connected() and self._parse_var(any_token=True):
    634                    table_name += self._prev.text
    635
    636                this = exp.Identifier(this=table_name, quoted=True)
    637
    638            return this
    639
    640        def _parse_table_parts(
    641            self, schema: bool = False, is_db_reference: bool = False, wildcard: bool = False
    642        ) -> exp.Table:
    643            table = super()._parse_table_parts(
    644                schema=schema, is_db_reference=is_db_reference, wildcard=True
    645            )
    646
    647            # proj-1.db.tbl -- `1.` is tokenized as a float so we need to unravel it here
    648            if not table.catalog:
    649                if table.db:
    650                    parts = table.db.split(".")
    651                    if len(parts) == 2 and not table.args["db"].quoted:
    652                        table.set("catalog", exp.Identifier(this=parts[0]))
    653                        table.set("db", exp.Identifier(this=parts[1]))
    654                else:
    655                    parts = table.name.split(".")
    656                    if len(parts) == 2 and not table.this.quoted:
    657                        table.set("db", exp.Identifier(this=parts[0]))
    658                        table.set("this", exp.Identifier(this=parts[1]))
    659
    660            if isinstance(table.this, exp.Identifier) and any("." in p.name for p in table.parts):
    661                alias = table.this
    662                catalog, db, this, *rest = (
    663                    exp.to_identifier(p, quoted=True)
    664                    for p in split_num_words(".".join(p.name for p in table.parts), ".", 3)
    665                )
    666
    667                if rest and this:
    668                    this = exp.Dot.build([this, *rest])  # type: ignore
    669
    670                table = exp.Table(
    671                    this=this, db=db, catalog=catalog, pivots=table.args.get("pivots")
    672                )
    673                table.meta["quoted_table"] = True
    674            else:
    675                alias = None
    676
    677            # The `INFORMATION_SCHEMA` views in BigQuery need to be qualified by a region or
    678            # dataset, so if the project identifier is omitted we need to fix the ast so that
    679            # the `INFORMATION_SCHEMA.X` bit is represented as a single (quoted) Identifier.
    680            # Otherwise, we wouldn't correctly qualify a `Table` node that references these
    681            # views, because it would seem like the "catalog" part is set, when it'd actually
    682            # be the region/dataset. Merging the two identifiers into a single one is done to
    683            # avoid producing a 4-part Table reference, which would cause issues in the schema
    684            # module, when there are 3-part table names mixed with information schema views.
    685            #
    686            # See: https://cloud.google.com/bigquery/docs/information-schema-intro#syntax
    687            table_parts = table.parts
    688            if len(table_parts) > 1 and table_parts[-2].name.upper() == "INFORMATION_SCHEMA":
    689                # We need to alias the table here to avoid breaking existing qualified columns.
    690                # This is expected to be safe, because if there's an actual alias coming up in
    691                # the token stream, it will overwrite this one. If there isn't one, we are only
    692                # exposing the name that can be used to reference the view explicitly (a no-op).
    693                exp.alias_(
    694                    table,
    695                    t.cast(exp.Identifier, alias or table_parts[-1]),
    696                    table=True,
    697                    copy=False,
    698                )
    699
    700                info_schema_view = f"{table_parts[-2].name}.{table_parts[-1].name}"
    701                table.set("this", exp.Identifier(this=info_schema_view, quoted=True))
    702                table.set("db", seq_get(table_parts, -3))
    703                table.set("catalog", seq_get(table_parts, -4))
    704
    705            return table
    706
    707        def _parse_column(self) -> t.Optional[exp.Expression]:
    708            column = super()._parse_column()
    709            if isinstance(column, exp.Column):
    710                parts = column.parts
    711                if any("." in p.name for p in parts):
    712                    catalog, db, table, this, *rest = (
    713                        exp.to_identifier(p, quoted=True)
    714                        for p in split_num_words(".".join(p.name for p in parts), ".", 4)
    715                    )
    716
    717                    if rest and this:
    718                        this = exp.Dot.build([this, *rest])  # type: ignore
    719
    720                    column = exp.Column(this=this, table=table, db=db, catalog=catalog)
    721                    column.meta["quoted_column"] = True
    722
    723            return column
    724
    725        @t.overload
    726        def _parse_json_object(self, agg: Lit[False]) -> exp.JSONObject: ...
    727
    728        @t.overload
    729        def _parse_json_object(self, agg: Lit[True]) -> exp.JSONObjectAgg: ...
    730
    731        def _parse_json_object(self, agg=False):
    732            json_object = super()._parse_json_object()
    733            array_kv_pair = seq_get(json_object.expressions, 0)
    734
    735            # Converts BQ's "signature 2" of JSON_OBJECT into SQLGlot's canonical representation
    736            # https://cloud.google.com/bigquery/docs/reference/standard-sql/json_functions#json_object_signature2
    737            if (
    738                array_kv_pair
    739                and isinstance(array_kv_pair.this, exp.Array)
    740                and isinstance(array_kv_pair.expression, exp.Array)
    741            ):
    742                keys = array_kv_pair.this.expressions
    743                values = array_kv_pair.expression.expressions
    744
    745                json_object.set(
    746                    "expressions",
    747                    [exp.JSONKeyValue(this=k, expression=v) for k, v in zip(keys, values)],
    748                )
    749
    750            return json_object
    751
    752        def _parse_bracket(
    753            self, this: t.Optional[exp.Expression] = None
    754        ) -> t.Optional[exp.Expression]:
    755            bracket = super()._parse_bracket(this)
    756
    757            if this is bracket:
    758                return bracket
    759
    760            if isinstance(bracket, exp.Bracket):
    761                for expression in bracket.expressions:
    762                    name = expression.name.upper()
    763
    764                    if name not in self.BRACKET_OFFSETS:
    765                        break
    766
    767                    offset, safe = self.BRACKET_OFFSETS[name]
    768                    bracket.set("offset", offset)
    769                    bracket.set("safe", safe)
    770                    expression.replace(expression.expressions[0])
    771
    772            return bracket
    773
    774        def _parse_unnest(self, with_alias: bool = True) -> t.Optional[exp.Unnest]:
    775            unnest = super()._parse_unnest(with_alias=with_alias)
    776
    777            if not unnest:
    778                return None
    779
    780            unnest_expr = seq_get(unnest.expressions, 0)
    781            if unnest_expr:
    782                from sqlglot.optimizer.annotate_types import annotate_types
    783
    784                unnest_expr = annotate_types(unnest_expr)
    785
    786                # Unnesting a nested array (i.e array of structs) explodes the top-level struct fields,
    787                # in contrast to other dialects such as DuckDB which flattens only the array by default
    788                if unnest_expr.is_type(exp.DataType.Type.ARRAY) and any(
    789                    array_elem.is_type(exp.DataType.Type.STRUCT)
    790                    for array_elem in unnest_expr._type.expressions
    791                ):
    792                    unnest.set("explode_array", True)
    793
    794            return unnest
    795
    796        def _parse_make_interval(self) -> exp.MakeInterval:
    797            expr = exp.MakeInterval()
    798
    799            for arg_key in expr.arg_types:
    800                value = self._parse_lambda()
    801
    802                if not value:
    803                    break
    804
    805                # Non-named arguments are filled sequentially, (optionally) followed by named arguments
    806                # that can appear in any order e.g MAKE_INTERVAL(1, minute => 5, day => 2)
    807                if isinstance(value, exp.Kwarg):
    808                    arg_key = value.this.name
    809
    810                expr.set(arg_key, value)
    811
    812                self._match(TokenType.COMMA)
    813
    814            return expr
    815
    816        def _parse_features_at_time(self) -> exp.FeaturesAtTime:
    817            expr = self.expression(
    818                exp.FeaturesAtTime,
    819                this=(self._match(TokenType.TABLE) and self._parse_table())
    820                or self._parse_select(nested=True),
    821            )
    822
    823            while self._match(TokenType.COMMA):
    824                arg = self._parse_lambda()
    825
    826                # Get the LHS of the Kwarg and set the arg to that value, e.g
    827                # "num_rows => 1" sets the expr's `num_rows` arg
    828                if arg:
    829                    expr.set(arg.this.name, arg)
    830
    831            return expr

Parser consumes a list of tokens produced by the Tokenizer and produces a parsed syntax tree.

###### Arguments:

- error_level: The desired error level. Default: ErrorLevel.IMMEDIATE
- error_message_context: The amount of context to capture from a query string when displaying the error message (in number of characters). Default: 100
- max_errors: Maximum number of error messages to include in a raised ParseError. This is only relevant if error_level is ErrorLevel.RAISE. Default: 3

PREFIXED_PIVOT_COLUMNS = True
LOG_DEFAULTS_TO_LN = True
SUPPORTS_IMPLICIT_UNNEST = True
FUNCTIONS = {'ABS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Abs'>>, 'ADD_MONTHS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.AddMonths'>>, 'ANONYMOUS_AGG_FUNC': <bound method Func.from_arg_list of <class 'sqlglot.expressions.AnonymousAggFunc'>>, 'ANY_VALUE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.AnyValue'>>, 'APPLY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Apply'>>, 'APPROX_DISTINCT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ApproxDistinct'>>, 'APPROX_COUNT_DISTINCT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ApproxDistinct'>>, 'APPROX_QUANTILE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ApproxQuantile'>>, 'APPROX_TOP_K': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ApproxTopK'>>, 'ARG_MAX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArgMax'>>, 'ARGMAX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArgMax'>>, 'MAX_BY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArgMax'>>, 'ARG_MIN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArgMin'>>, 'ARGMIN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArgMin'>>, 'MIN_BY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArgMin'>>, 'ARRAY': <function Parser.<lambda>>, 'ARRAY_AGG': <function Parser.<lambda>>, 'ARRAY_ALL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayAll'>>, 'ARRAY_ANY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayAny'>>, 'ARRAY_CONCAT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayConcat'>>, 'ARRAY_CAT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayConcat'>>, 'ARRAY_CONSTRUCT_COMPACT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayConstructCompact'>>, 'ARRAY_CONTAINS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayContains'>>, 'ARRAY_HAS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayContains'>>, 'ARRAY_CONTAINS_ALL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayContainsAll'>>, 'ARRAY_HAS_ALL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayContainsAll'>>, 'FILTER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayFilter'>>, 'ARRAY_FILTER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayFilter'>>, 'ARRAY_OVERLAPS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayOverlaps'>>, 'ARRAY_SIZE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArraySize'>>, 'ARRAY_LENGTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArraySize'>>, 'ARRAY_SORT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArraySort'>>, 'ARRAY_SUM': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArraySum'>>, 'ARRAY_TO_STRING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayToString'>>, 'ARRAY_JOIN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayToString'>>, 'ARRAY_UNION_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayUnionAgg'>>, 'ARRAY_UNIQUE_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ArrayUniqueAgg'>>, 'AVG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Avg'>>, 'CASE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Case'>>, 'CAST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Cast'>>, 'CAST_TO_STR_TYPE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CastToStrType'>>, 'CBRT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Cbrt'>>, 'CEIL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Ceil'>>, 'CEILING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Ceil'>>, 'CHR': <function Parser.<lambda>>, 'CHAR': <function Parser.<lambda>>, 'COALESCE': <function build_coalesce>, 'IFNULL': <function build_coalesce>, 'NVL': <function build_coalesce>, 'COLLATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Collate'>>, 'COLUMNS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Columns'>>, 'COMBINED_AGG_FUNC': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CombinedAggFunc'>>, 'COMBINED_PARAMETERIZED_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CombinedParameterizedAgg'>>, 'CONCAT': <function Parser.<lambda>>, 'CONCAT_WS': <function Parser.<lambda>>, 'CONNECT_BY_ROOT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ConnectByRoot'>>, 'CONTAINS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Contains'>>, 'CONVERT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Convert'>>, 'CONVERT_TIMEZONE': <function build_convert_timezone>, 'CORR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Corr'>>, 'COUNT': <function Parser.<lambda>>, 'COUNT_IF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CountIf'>>, 'COUNTIF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CountIf'>>, 'COVAR_POP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CovarPop'>>, 'COVAR_SAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CovarSamp'>>, 'CURRENT_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CurrentDate'>>, 'CURRENT_DATETIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CurrentDatetime'>>, 'CURRENT_TIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CurrentTime'>>, 'CURRENT_TIMESTAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CurrentTimestamp'>>, 'CURRENT_USER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.CurrentUser'>>, 'DATE': <function _build_date>, 'DATE_ADD': <function build_date_delta_with_interval.<locals>._builder>, 'DATEDIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DateDiff'>>, 'DATE_DIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DateDiff'>>, 'DATE_FROM_PARTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DateFromParts'>>, 'DATEFROMPARTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DateFromParts'>>, 'DATE_STR_TO_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DateStrToDate'>>, 'DATE_SUB': <function build_date_delta_with_interval.<locals>._builder>, 'DATE_TO_DATE_STR': <function Parser.<lambda>>, 'DATE_TO_DI': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DateToDi'>>, 'DATE_TRUNC': <function BigQuery.Parser.<lambda>>, 'DATETIME': <function _build_datetime>, 'DATETIME_ADD': <function build_date_delta_with_interval.<locals>._builder>, 'DATETIME_DIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DatetimeDiff'>>, 'DATETIME_SUB': <function build_date_delta_with_interval.<locals>._builder>, 'DATETIME_TRUNC': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DatetimeTrunc'>>, 'DAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Day'>>, 'DAY_OF_MONTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfMonth'>>, 'DAYOFMONTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfMonth'>>, 'DAY_OF_WEEK': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfWeek'>>, 'DAYOFWEEK': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfWeek'>>, 'DAYOFWEEK_ISO': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfWeekIso'>>, 'ISODOW': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfWeekIso'>>, 'DAY_OF_YEAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfYear'>>, 'DAYOFYEAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DayOfYear'>>, 'DECODE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Decode'>>, 'DI_TO_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.DiToDate'>>, 'ENCODE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Encode'>>, 'EXISTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Exists'>>, 'EXP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Exp'>>, 'EXPLODE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Explode'>>, 'EXPLODE_OUTER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ExplodeOuter'>>, 'EXPLODING_GENERATE_SERIES': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ExplodingGenerateSeries'>>, 'EXTRACT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Extract'>>, 'FEATURES_AT_TIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.FeaturesAtTime'>>, 'FIRST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.First'>>, 'FIRST_VALUE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.FirstValue'>>, 'FLATTEN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Flatten'>>, 'FLOOR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Floor'>>, 'FROM_BASE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.FromBase'>>, 'FROM_BASE64': <bound method Func.from_arg_list of <class 'sqlglot.expressions.FromBase64'>>, 'FROM_ISO8601_TIMESTAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.FromISO8601Timestamp'>>, 'GAP_FILL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.GapFill'>>, 'GENERATE_DATE_ARRAY': <function Parser.<lambda>>, 'GENERATE_SERIES': <bound method Func.from_arg_list of <class 'sqlglot.expressions.GenerateSeries'>>, 'GENERATE_TIMESTAMP_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.GenerateTimestampArray'>>, 'GREATEST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Greatest'>>, 'GROUP_CONCAT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.GroupConcat'>>, 'HEX': <function build_hex>, 'HLL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Hll'>>, 'IF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.If'>>, 'IIF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.If'>>, 'INITCAP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Initcap'>>, 'INLINE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Inline'>>, 'INT64': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Int64'>>, 'IS_ASCII': <bound method Func.from_arg_list of <class 'sqlglot.expressions.IsAscii'>>, 'IS_INF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.IsInf'>>, 'ISINF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.IsInf'>>, 'IS_NAN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.IsNan'>>, 'ISNAN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.IsNan'>>, 'J_S_O_N_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONArray'>>, 'J_S_O_N_ARRAY_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONArrayAgg'>>, 'JSON_ARRAY_CONTAINS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONArrayContains'>>, 'JSONB_CONTAINS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONBContains'>>, 'JSONB_EXISTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONBExists'>>, 'JSONB_EXTRACT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONBExtract'>>, 'JSONB_EXTRACT_SCALAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONBExtractScalar'>>, 'J_S_O_N_EXISTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONExists'>>, 'JSON_EXTRACT': <function build_extract_json_with_path.<locals>._builder>, 'JSON_EXTRACT_ARRAY': <function _build_extract_json_with_default_path.<locals>._builder>, 'JSON_EXTRACT_SCALAR': <function _build_extract_json_with_default_path.<locals>._builder>, 'JSON_FORMAT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONFormat'>>, 'J_S_O_N_OBJECT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONObject'>>, 'J_S_O_N_OBJECT_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONObjectAgg'>>, 'J_S_O_N_TABLE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONTable'>>, 'J_S_O_N_VALUE_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONValueArray'>>, 'LAG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Lag'>>, 'LAST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Last'>>, 'LAST_DAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LastDay'>>, 'LAST_DAY_OF_MONTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LastDay'>>, 'LAST_VALUE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LastValue'>>, 'LEAD': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Lead'>>, 'LEAST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Least'>>, 'LEFT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Left'>>, 'LENGTH': <function BigQuery.Parser.<lambda>>, 'LEN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Length'>>, 'CHAR_LENGTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Length'>>, 'CHARACTER_LENGTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Length'>>, 'LEVENSHTEIN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Levenshtein'>>, 'LIST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.List'>>, 'LN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Ln'>>, 'LOG': <function build_logarithm>, 'LOGICAL_AND': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LogicalAnd'>>, 'BOOL_AND': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LogicalAnd'>>, 'BOOLAND_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LogicalAnd'>>, 'LOGICAL_OR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LogicalOr'>>, 'BOOL_OR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LogicalOr'>>, 'BOOLOR_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LogicalOr'>>, 'LOWER': <function build_lower>, 'LCASE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Lower'>>, 'LOWER_HEX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.LowerHex'>>, 'MD5': <bound method Func.from_arg_list of <class 'sqlglot.expressions.MD5Digest'>>, 'MD5_DIGEST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.MD5Digest'>>, 'MAKE_INTERVAL': <bound method Func.from_arg_list of <class 'sqlglot.expressions.MakeInterval'>>, 'MAP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Map'>>, 'MAP_FROM_ENTRIES': <bound method Func.from_arg_list of <class 'sqlglot.expressions.MapFromEntries'>>, 'MATCH_AGAINST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.MatchAgainst'>>, 'MAX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Max'>>, 'MEDIAN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Median'>>, 'MIN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Min'>>, 'MONTH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Month'>>, 'MONTHS_BETWEEN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.MonthsBetween'>>, 'NEXT_VALUE_FOR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.NextValueFor'>>, 'NORMALIZE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Normalize'>>, 'NTH_VALUE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.NthValue'>>, 'NULLIF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Nullif'>>, 'NUMBER_TO_STR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.NumberToStr'>>, 'NVL2': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Nvl2'>>, 'OBJECT_INSERT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ObjectInsert'>>, 'OPEN_J_S_O_N': <bound method Func.from_arg_list of <class 'sqlglot.expressions.OpenJSON'>>, 'OVERLAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Overlay'>>, 'PAD': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Pad'>>, 'PARAMETERIZED_AGG': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ParameterizedAgg'>>, 'PARSE_JSON': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ParseJSON'>>, 'JSON_PARSE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ParseJSON'>>, 'PERCENTILE_CONT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.PercentileCont'>>, 'PERCENTILE_DISC': <bound method Func.from_arg_list of <class 'sqlglot.expressions.PercentileDisc'>>, 'POSEXPLODE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Posexplode'>>, 'POSEXPLODE_OUTER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.PosexplodeOuter'>>, 'POWER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Pow'>>, 'POW': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Pow'>>, 'PREDICT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Predict'>>, 'QUANTILE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Quantile'>>, 'QUARTER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Quarter'>>, 'RAND': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Rand'>>, 'RANDOM': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Rand'>>, 'RANDN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Randn'>>, 'RANGE_N': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RangeN'>>, 'READ_CSV': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ReadCSV'>>, 'REDUCE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Reduce'>>, 'REGEXP_EXTRACT': <function _build_regexp_extract.<locals>._builder>, 'REGEXP_EXTRACT_ALL': <function _build_regexp_extract.<locals>._builder>, 'REGEXP_I_LIKE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RegexpILike'>>, 'REGEXP_LIKE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RegexpLike'>>, 'REGEXP_REPLACE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RegexpReplace'>>, 'REGEXP_SPLIT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RegexpSplit'>>, 'REPEAT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Repeat'>>, 'RIGHT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Right'>>, 'ROUND': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Round'>>, 'ROW_NUMBER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RowNumber'>>, 'SHA': <bound method Func.from_arg_list of <class 'sqlglot.expressions.SHA'>>, 'SHA1': <bound method Func.from_arg_list of <class 'sqlglot.expressions.SHA'>>, 'SHA2': <bound method Func.from_arg_list of <class 'sqlglot.expressions.SHA2'>>, 'SAFE_DIVIDE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.SafeDivide'>>, 'SIGN': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Sign'>>, 'SIGNUM': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Sign'>>, 'SORT_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.SortArray'>>, 'SPLIT': <function BigQuery.Parser.<lambda>>, 'SPLIT_PART': <bound method Func.from_arg_list of <class 'sqlglot.expressions.SplitPart'>>, 'SQRT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Sqrt'>>, 'STANDARD_HASH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StandardHash'>>, 'STAR_MAP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StarMap'>>, 'STARTS_WITH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StartsWith'>>, 'STARTSWITH': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StartsWith'>>, 'STDDEV': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Stddev'>>, 'STDEV': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Stddev'>>, 'STDDEV_POP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StddevPop'>>, 'STDDEV_SAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StddevSamp'>>, 'STR_POSITION': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrPosition'>>, 'STR_TO_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrToDate'>>, 'STR_TO_MAP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrToMap'>>, 'STR_TO_TIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrToTime'>>, 'STR_TO_UNIX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrToUnix'>>, 'STRING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.String'>>, 'STRING_TO_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StringToArray'>>, 'SPLIT_BY_STRING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StringToArray'>>, 'STRUCT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Struct'>>, 'STRUCT_EXTRACT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StructExtract'>>, 'STUFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Stuff'>>, 'INSERT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Stuff'>>, 'SUBSTRING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Substring'>>, 'SUBSTR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Substring'>>, 'SUM': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Sum'>>, 'TIME': <function _build_time>, 'TIME_ADD': <function build_date_delta_with_interval.<locals>._builder>, 'TIME_DIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeDiff'>>, 'TIME_FROM_PARTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeFromParts'>>, 'TIMEFROMPARTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeFromParts'>>, 'TIME_STR_TO_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeStrToDate'>>, 'TIME_STR_TO_TIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeStrToTime'>>, 'TIME_STR_TO_UNIX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeStrToUnix'>>, 'TIME_SUB': <function build_date_delta_with_interval.<locals>._builder>, 'TIME_TO_STR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeToStr'>>, 'TIME_TO_TIME_STR': <function Parser.<lambda>>, 'TIME_TO_UNIX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeToUnix'>>, 'TIME_TRUNC': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimeTrunc'>>, 'TIMESTAMP': <function _build_timestamp>, 'TIMESTAMP_ADD': <function build_date_delta_with_interval.<locals>._builder>, 'TIMESTAMPDIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimestampDiff'>>, 'TIMESTAMP_DIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimestampDiff'>>, 'TIMESTAMP_FROM_PARTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimestampFromParts'>>, 'TIMESTAMPFROMPARTS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimestampFromParts'>>, 'TIMESTAMP_SUB': <function build_date_delta_with_interval.<locals>._builder>, 'TIMESTAMP_TRUNC': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TimestampTrunc'>>, 'TO_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToArray'>>, 'TO_BASE64': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToBase64'>>, 'TO_CHAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToChar'>>, 'TO_DAYS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToDays'>>, 'TO_DOUBLE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToDouble'>>, 'TO_MAP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToMap'>>, 'TO_NUMBER': <bound method Func.from_arg_list of <class 'sqlglot.expressions.ToNumber'>>, 'TRANSFORM': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Transform'>>, 'TRIM': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Trim'>>, 'TRY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Try'>>, 'TRY_CAST': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TryCast'>>, 'TS_OR_DI_TO_DI': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDiToDi'>>, 'TS_OR_DS_ADD': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDsAdd'>>, 'TS_OR_DS_DIFF': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDsDiff'>>, 'TS_OR_DS_TO_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDsToDate'>>, 'TS_OR_DS_TO_DATE_STR': <function Parser.<lambda>>, 'TS_OR_DS_TO_DATETIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDsToDatetime'>>, 'TS_OR_DS_TO_TIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDsToTime'>>, 'TS_OR_DS_TO_TIMESTAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.TsOrDsToTimestamp'>>, 'UNHEX': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Unhex'>>, 'UNICODE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Unicode'>>, 'UNIX_DATE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.UnixDate'>>, 'UNIX_SECONDS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.UnixSeconds'>>, 'UNIX_TO_STR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.UnixToStr'>>, 'UNIX_TO_TIME': <bound method Func.from_arg_list of <class 'sqlglot.expressions.UnixToTime'>>, 'UNIX_TO_TIME_STR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.UnixToTimeStr'>>, 'UNNEST': <function Parser.<lambda>>, 'UPPER': <function build_upper>, 'UCASE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Upper'>>, 'UUID': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Uuid'>>, 'GEN_RANDOM_UUID': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Uuid'>>, 'GENERATE_UUID': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Uuid'>>, 'UUID_STRING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Uuid'>>, 'VAR_MAP': <function build_var_map>, 'VARIANCE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Variance'>>, 'VARIANCE_SAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Variance'>>, 'VAR_SAMP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Variance'>>, 'VARIANCE_POP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.VariancePop'>>, 'VAR_POP': <bound method Func.from_arg_list of <class 'sqlglot.expressions.VariancePop'>>, 'WEEK': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Week'>>, 'WEEK_OF_YEAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.WeekOfYear'>>, 'WEEKOFYEAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.WeekOfYear'>>, 'XMLELEMENT': <bound method Func.from_arg_list of <class 'sqlglot.expressions.XMLElement'>>, 'X_M_L_TABLE': <bound method Func.from_arg_list of <class 'sqlglot.expressions.XMLTable'>>, 'XOR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Xor'>>, 'YEAR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.Year'>>, 'ARRAYAGG': <function Parser.<lambda>>, 'GLOB': <function Parser.<lambda>>, 'JSON_EXTRACT_PATH_TEXT': <function build_extract_json_with_path.<locals>._builder>, 'LIKE': <function build_like>, 'LOG2': <function Parser.<lambda>>, 'LOG10': <function Parser.<lambda>>, 'LPAD': <function Parser.<lambda>>, 'LEFTPAD': <function Parser.<lambda>>, 'LTRIM': <function Parser.<lambda>>, 'MOD': <function build_mod>, 'RIGHTPAD': <function Parser.<lambda>>, 'RPAD': <function Parser.<lambda>>, 'RTRIM': <function Parser.<lambda>>, 'SCOPE_RESOLUTION': <function Parser.<lambda>>, 'STRPOS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrPosition'>>, 'CHARINDEX': <function Parser.<lambda>>, 'INSTR': <bound method Func.from_arg_list of <class 'sqlglot.expressions.StrPosition'>>, 'LOCATE': <function Parser.<lambda>>, 'TO_HEX': <function _build_to_hex>, 'CONTAINS_SUBSTR': <function _build_contains_substring>, 'DIV': <function binary_from_function.<locals>.<lambda>>, 'EDIT_DISTANCE': <function _build_levenshtein>, 'FORMAT_DATE': <function _build_format_time.<locals>._builder>, 'GENERATE_ARRAY': <bound method Func.from_arg_list of <class 'sqlglot.expressions.GenerateSeries'>>, 'JSON_QUERY': <function build_extract_json_with_path.<locals>._builder>, 'JSON_QUERY_ARRAY': <function _build_extract_json_with_default_path.<locals>._builder>, 'JSON_VALUE': <function _build_extract_json_with_default_path.<locals>._builder>, 'JSON_VALUE_ARRAY': <function _build_extract_json_with_default_path.<locals>._builder>, 'PARSE_DATE': <function BigQuery.Parser.<lambda>>, 'PARSE_TIMESTAMP': <function _build_parse_timestamp>, 'REGEXP_CONTAINS': <bound method Func.from_arg_list of <class 'sqlglot.expressions.RegexpLike'>>, 'REGEXP_SUBSTR': <function _build_regexp_extract.<locals>._builder>, 'SHA256': <function BigQuery.Parser.<lambda>>, 'SHA512': <function BigQuery.Parser.<lambda>>, 'TIMESTAMP_MICROS': <function BigQuery.Parser.<lambda>>, 'TIMESTAMP_MILLIS': <function BigQuery.Parser.<lambda>>, 'TIMESTAMP_SECONDS': <function BigQuery.Parser.<lambda>>, 'TO_JSON_STRING': <bound method Func.from_arg_list of <class 'sqlglot.expressions.JSONFormat'>>, 'FORMAT_DATETIME': <function _build_format_time.<locals>._builder>, 'FORMAT_TIMESTAMP': <function _build_format_time.<locals>._builder>}
FUNCTION_PARSERS = {'CAST': <function Parser.<lambda>>, 'CEIL': <function Parser.<lambda>>, 'CONVERT': <function Parser.<lambda>>, 'DECODE': <function Parser.<lambda>>, 'EXTRACT': <function Parser.<lambda>>, 'FLOOR': <function Parser.<lambda>>, 'GAP_FILL': <function Parser.<lambda>>, 'JSON_OBJECT': <function Parser.<lambda>>, 'JSON_OBJECTAGG': <function Parser.<lambda>>, 'JSON_TABLE': <function Parser.<lambda>>, 'MATCH': <function Parser.<lambda>>, 'NORMALIZE': <function Parser.<lambda>>, 'OPENJSON': <function Parser.<lambda>>, 'OVERLAY': <function Parser.<lambda>>, 'POSITION': <function Parser.<lambda>>, 'PREDICT': <function Parser.<lambda>>, 'SAFE_CAST': <function Parser.<lambda>>, 'STRING_AGG': <function Parser.<lambda>>, 'SUBSTRING': <function Parser.<lambda>>, 'TRY_CAST': <function Parser.<lambda>>, 'TRY_CONVERT': <function Parser.<lambda>>, 'XMLELEMENT': <function Parser.<lambda>>, 'XMLTABLE': <function Parser.<lambda>>, 'ARRAY': <function BigQuery.Parser.<lambda>>, 'MAKE_INTERVAL': <function BigQuery.Parser.<lambda>>, 'FEATURES_AT_TIME': <function BigQuery.Parser.<lambda>>}
NO_PAREN_FUNCTIONS = {<TokenType.CURRENT_DATE: 'CURRENT_DATE'>: <class 'sqlglot.expressions.CurrentDate'>, <TokenType.CURRENT_DATETIME: 'CURRENT_DATETIME'>: <class 'sqlglot.expressions.CurrentDatetime'>, <TokenType.CURRENT_TIME: 'CURRENT_TIME'>: <class 'sqlglot.expressions.CurrentTime'>, <TokenType.CURRENT_TIMESTAMP: 'CURRENT_TIMESTAMP'>: <class 'sqlglot.expressions.CurrentTimestamp'>, <TokenType.CURRENT_USER: 'CURRENT_USER'>: <class 'sqlglot.expressions.CurrentUser'>}
NESTED_TYPE_TOKENS = {<TokenType.NULLABLE: 'NULLABLE'>, <TokenType.RANGE: 'RANGE'>, <TokenType.UNION: 'UNION'>, <TokenType.OBJECT: 'OBJECT'>, <TokenType.ARRAY: 'ARRAY'>, <TokenType.LOWCARDINALITY: 'LOWCARDINALITY'>, <TokenType.LIST: 'LIST'>, <TokenType.TABLE: 'TABLE'>, <TokenType.STRUCT: 'STRUCT'>, <TokenType.NESTED: 'NESTED'>, <TokenType.MAP: 'MAP'>}
PROPERTY_PARSERS = {'ALLOWED_VALUES': <function Parser.<lambda>>, 'ALGORITHM': <function Parser.<lambda>>, 'AUTO': <function Parser.<lambda>>, 'AUTO_INCREMENT': <function Parser.<lambda>>, 'BACKUP': <function Parser.<lambda>>, 'BLOCKCOMPRESSION': <function Parser.<lambda>>, 'CHARSET': <function Parser.<lambda>>, 'CHARACTER SET': <function Parser.<lambda>>, 'CHECKSUM': <function Parser.<lambda>>, 'CLUSTER BY': <function Parser.<lambda>>, 'CLUSTERED': <function Parser.<lambda>>, 'COLLATE': <function Parser.<lambda>>, 'COMMENT': <function Parser.<lambda>>, 'CONTAINS': <function Parser.<lambda>>, 'COPY': <function Parser.<lambda>>, 'DATABLOCKSIZE': <function Parser.<lambda>>, 'DATA_DELETION': <function Parser.<lambda>>, 'DEFINER': <function Parser.<lambda>>, 'DETERMINISTIC': <function Parser.<lambda>>, 'DISTRIBUTED': <function Parser.<lambda>>, 'DUPLICATE': <function Parser.<lambda>>, 'DYNAMIC': <function Parser.<lambda>>, 'DISTKEY': <function Parser.<lambda>>, 'DISTSTYLE': <function Parser.<lambda>>, 'EMPTY': <function Parser.<lambda>>, 'ENGINE': <function Parser.<lambda>>, 'EXECUTE': <function Parser.<lambda>>, 'EXTERNAL': <function Parser.<lambda>>, 'FALLBACK': <function Parser.<lambda>>, 'FORMAT': <function Parser.<lambda>>, 'FREESPACE': <function Parser.<lambda>>, 'GLOBAL': <function Parser.<lambda>>, 'HEAP': <function Parser.<lambda>>, 'ICEBERG': <function Parser.<lambda>>, 'IMMUTABLE': <function Parser.<lambda>>, 'INHERITS': <function Parser.<lambda>>, 'INPUT': <function Parser.<lambda>>, 'JOURNAL': <function Parser.<lambda>>, 'LANGUAGE': <function Parser.<lambda>>, 'LAYOUT': <function Parser.<lambda>>, 'LIFETIME': <function Parser.<lambda>>, 'LIKE': <function Parser.<lambda>>, 'LOCATION': <function Parser.<lambda>>, 'LOCK': <function Parser.<lambda>>, 'LOCKING': <function Parser.<lambda>>, 'LOG': <function Parser.<lambda>>, 'MATERIALIZED': <function Parser.<lambda>>, 'MERGEBLOCKRATIO': <function Parser.<lambda>>, 'MODIFIES': <function Parser.<lambda>>, 'MULTISET': <function Parser.<lambda>>, 'NO': <function Parser.<lambda>>, 'ON': <function Parser.<lambda>>, 'ORDER BY': <function Parser.<lambda>>, 'OUTPUT': <function Parser.<lambda>>, 'PARTITION': <function Parser.<lambda>>, 'PARTITION BY': <function Parser.<lambda>>, 'PARTITIONED BY': <function Parser.<lambda>>, 'PARTITIONED_BY': <function Parser.<lambda>>, 'PRIMARY KEY': <function Parser.<lambda>>, 'RANGE': <function Parser.<lambda>>, 'READS': <function Parser.<lambda>>, 'REMOTE': <function Parser.<lambda>>, 'RETURNS': <function Parser.<lambda>>, 'STRICT': <function Parser.<lambda>>, 'STREAMING': <function Parser.<lambda>>, 'ROW': <function Parser.<lambda>>, 'ROW_FORMAT': <function Parser.<lambda>>, 'SAMPLE': <function Parser.<lambda>>, 'SECURE': <function Parser.<lambda>>, 'SECURITY': <function Parser.<lambda>>, 'SET': <function Parser.<lambda>>, 'SETTINGS': <function Parser.<lambda>>, 'SHARING': <function Parser.<lambda>>, 'SORTKEY': <function Parser.<lambda>>, 'SOURCE': <function Parser.<lambda>>, 'STABLE': <function Parser.<lambda>>, 'STORED': <function Parser.<lambda>>, 'SYSTEM_VERSIONING': <function Parser.<lambda>>, 'TBLPROPERTIES': <function Parser.<lambda>>, 'TEMP': <function Parser.<lambda>>, 'TEMPORARY': <function Parser.<lambda>>, 'TO': <function Parser.<lambda>>, 'TRANSIENT': <function Parser.<lambda>>, 'TRANSFORM': <function Parser.<lambda>>, 'TTL': <function Parser.<lambda>>, 'USING': <function Parser.<lambda>>, 'UNLOGGED': <function Parser.<lambda>>, 'VOLATILE': <function Parser.<lambda>>, 'WITH': <function Parser.<lambda>>, 'NOT DETERMINISTIC': <function BigQuery.Parser.<lambda>>, 'OPTIONS': <function BigQuery.Parser.<lambda>>}
CONSTRAINT_PARSERS = {'AUTOINCREMENT': <function Parser.<lambda>>, 'AUTO_INCREMENT': <function Parser.<lambda>>, 'CASESPECIFIC': <function Parser.<lambda>>, 'CHARACTER SET': <function Parser.<lambda>>, 'CHECK': <function Parser.<lambda>>, 'COLLATE': <function Parser.<lambda>>, 'COMMENT': <function Parser.<lambda>>, 'COMPRESS': <function Parser.<lambda>>, 'CLUSTERED': <function Parser.<lambda>>, 'NONCLUSTERED': <function Parser.<lambda>>, 'DEFAULT': <function Parser.<lambda>>, 'ENCODE': <function Parser.<lambda>>, 'EPHEMERAL': <function Parser.<lambda>>, 'EXCLUDE': <function Parser.<lambda>>, 'FOREIGN KEY': <function Parser.<lambda>>, 'FORMAT': <function Parser.<lambda>>, 'GENERATED': <function Parser.<lambda>>, 'IDENTITY': <function Parser.<lambda>>, 'INLINE': <function Parser.<lambda>>, 'LIKE': <function Parser.<lambda>>, 'NOT': <function Parser.<lambda>>, 'NULL': <function Parser.<lambda>>, 'ON': <function Parser.<lambda>>, 'PATH': <function Parser.<lambda>>, 'PERIOD': <function Parser.<lambda>>, 'PRIMARY KEY': <function Parser.<lambda>>, 'REFERENCES': <function Parser.<lambda>>, 'TITLE': <function Parser.<lambda>>, 'TTL': <function Parser.<lambda>>, 'UNIQUE': <function Parser.<lambda>>, 'UPPERCASE': <function Parser.<lambda>>, 'WATERMARK': <function Parser.<lambda>>, 'WITH': <function Parser.<lambda>>, 'OPTIONS': <function BigQuery.Parser.<lambda>>}
RANGE_PARSERS = {<TokenType.AT_GT: 'AT_GT'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.BETWEEN: 'BETWEEN'>: <function Parser.<lambda>>, <TokenType.GLOB: 'GLOB'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.ILIKE: 'ILIKE'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.IN: 'IN'>: <function Parser.<lambda>>, <TokenType.IRLIKE: 'IRLIKE'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.IS: 'IS'>: <function Parser.<lambda>>, <TokenType.LIKE: 'LIKE'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.LT_AT: 'LT_AT'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.RLIKE: 'RLIKE'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.SIMILAR_TO: 'SIMILAR_TO'>: <function binary_range_parser.<locals>._parse_binary_range>, <TokenType.FOR: 'FOR'>: <function Parser.<lambda>>}
NULL_TOKENS = {<TokenType.UNKNOWN: 'UNKNOWN'>, <TokenType.NULL: 'NULL'>}
DASHED_TABLE_PART_FOLLOW_TOKENS = {<TokenType.L_PAREN: 'L_PAREN'>, <TokenType.DOT: 'DOT'>, <TokenType.R_PAREN: 'R_PAREN'>}
STATEMENT_PARSERS = {<TokenType.ALTER: 'ALTER'>: <function Parser.<lambda>>, <TokenType.ANALYZE: 'ANALYZE'>: <function Parser.<lambda>>, <TokenType.BEGIN: 'BEGIN'>: <function Parser.<lambda>>, <TokenType.CACHE: 'CACHE'>: <function Parser.<lambda>>, <TokenType.COMMENT: 'COMMENT'>: <function Parser.<lambda>>, <TokenType.COMMIT: 'COMMIT'>: <function Parser.<lambda>>, <TokenType.COPY: 'COPY'>: <function Parser.<lambda>>, <TokenType.CREATE: 'CREATE'>: <function Parser.<lambda>>, <TokenType.DELETE: 'DELETE'>: <function Parser.<lambda>>, <TokenType.DESC: 'DESC'>: <function Parser.<lambda>>, <TokenType.DESCRIBE: 'DESCRIBE'>: <function Parser.<lambda>>, <TokenType.DROP: 'DROP'>: <function Parser.<lambda>>, <TokenType.GRANT: 'GRANT'>: <function Parser.<lambda>>, <TokenType.INSERT: 'INSERT'>: <function Parser.<lambda>>, <TokenType.KILL: 'KILL'>: <function Parser.<lambda>>, <TokenType.LOAD: 'LOAD'>: <function Parser.<lambda>>, <TokenType.MERGE: 'MERGE'>: <function Parser.<lambda>>, <TokenType.PIVOT: 'PIVOT'>: <function Parser.<lambda>>, <TokenType.PRAGMA: 'PRAGMA'>: <function Parser.<lambda>>, <TokenType.REFRESH: 'REFRESH'>: <function Parser.<lambda>>, <TokenType.ROLLBACK: 'ROLLBACK'>: <function Parser.<lambda>>, <TokenType.SET: 'SET'>: <function Parser.<lambda>>, <TokenType.TRUNCATE: 'TRUNCATE'>: <function Parser.<lambda>>, <TokenType.UNCACHE: 'UNCACHE'>: <function Parser.<lambda>>, <TokenType.UNPIVOT: 'UNPIVOT'>: <function Parser.<lambda>>, <TokenType.UPDATE: 'UPDATE'>: <function Parser.<lambda>>, <TokenType.USE: 'USE'>: <function Parser.<lambda>>, <TokenType.SEMICOLON: 'SEMICOLON'>: <function Parser.<lambda>>, <TokenType.ELSE: 'ELSE'>: <function BigQuery.Parser.<lambda>>, <TokenType.END: 'END'>: <function BigQuery.Parser.<lambda>>, <TokenType.FOR: 'FOR'>: <function BigQuery.Parser.<lambda>>}
BRACKET_OFFSETS = {'OFFSET': (0, False), 'ORDINAL': (1, False), 'SAFE_OFFSET': (0, True), 'SAFE_ORDINAL': (1, True)}
ID_VAR_TOKENS = {<TokenType.NEXT: 'NEXT'>, <TokenType.UNNEST: 'UNNEST'>, <TokenType.STORAGE_INTEGRATION: 'STORAGE_INTEGRATION'>, <TokenType.NVARCHAR: 'NVARCHAR'>, <TokenType.REFERENCES: 'REFERENCES'>, <TokenType.ROW: 'ROW'>, <TokenType.TSTZMULTIRANGE: 'TSTZMULTIRANGE'>, <TokenType.POINT: 'POINT'>, <TokenType.ENUM8: 'ENUM8'>, <TokenType.BIGDECIMAL: 'BIGDECIMAL'>, <TokenType.CASE: 'CASE'>, <TokenType.TIME: 'TIME'>, <TokenType.LOAD: 'LOAD'>, <TokenType.OFFSET: 'OFFSET'>, <TokenType.TIMESTAMP: 'TIMESTAMP'>, <TokenType.DOUBLE: 'DOUBLE'>, <TokenType.JSONB: 'JSONB'>, <TokenType.PIVOT: 'PIVOT'>, <TokenType.UMEDIUMINT: 'UMEDIUMINT'>, <TokenType.SEQUENCE: 'SEQUENCE'>, <TokenType.MERGE: 'MERGE'>, <TokenType.SOURCE: 'SOURCE'>, <TokenType.GEOGRAPHY: 'GEOGRAPHY'>, <TokenType.ASC: 'ASC'>, <TokenType.CONSTRAINT: 'CONSTRAINT'>, <TokenType.MODEL: 'MODEL'>, <TokenType.TIMESTAMP_NS: 'TIMESTAMP_NS'>, <TokenType.PRAGMA: 'PRAGMA'>, <TokenType.SMALLMONEY: 'SMALLMONEY'>, <TokenType.VOLATILE: 'VOLATILE'>, <TokenType.NULLABLE: 'NULLABLE'>, <TokenType.OVERLAPS: 'OVERLAPS'>, <TokenType.INTERVAL: 'INTERVAL'>, <TokenType.DATEMULTIRANGE: 'DATEMULTIRANGE'>, <TokenType.FOREIGN_KEY: 'FOREIGN_KEY'>, <TokenType.SET: 'SET'>, <TokenType.VIEW: 'VIEW'>, <TokenType.INT: 'INT'>, <TokenType.ENUM16: 'ENUM16'>, <TokenType.FULL: 'FULL'>, <TokenType.JSON: 'JSON'>, <TokenType.SMALLINT: 'SMALLINT'>, <TokenType.EXECUTE: 'EXECUTE'>, <TokenType.NUMRANGE: 'NUMRANGE'>, <TokenType.DATETIME: 'DATETIME'>, <TokenType.COPY: 'COPY'>, <TokenType.BINARY: 'BINARY'>, <TokenType.SCHEMA: 'SCHEMA'>, <TokenType.TINYINT: 'TINYINT'>, <TokenType.COMMENT: 'COMMENT'>, <TokenType.INT128: 'INT128'>, <TokenType.UDECIMAL: 'UDECIMAL'>, <TokenType.TOP: 'TOP'>, <TokenType.ESCAPE: 'ESCAPE'>, <TokenType.TIMESTAMPNTZ: 'TIMESTAMPNTZ'>, <TokenType.DELETE: 'DELETE'>, <TokenType.DICTIONARY: 'DICTIONARY'>, <TokenType.COLUMN: 'COLUMN'>, <TokenType.LINESTRING: 'LINESTRING'>, <TokenType.UINT256: 'UINT256'>, <TokenType.ROWVERSION: 'ROWVERSION'>, <TokenType.CURRENT_USER: 'CURRENT_USER'>, <TokenType.EXISTS: 'EXISTS'>, <TokenType.PSEUDO_TYPE: 'PSEUDO_TYPE'>, <TokenType.UNPIVOT: 'UNPIVOT'>, <TokenType.RENAME: 'RENAME'>, <TokenType.REFRESH: 'REFRESH'>, <TokenType.NAME: 'NAME'>, <TokenType.LONGBLOB: 'LONGBLOB'>, <TokenType.MONEY: 'MONEY'>, <TokenType.DATE32: 'DATE32'>, <TokenType.TIMESTAMP_S: 'TIMESTAMP_S'>, <TokenType.HSTORE: 'HSTORE'>, <TokenType.ANY: 'ANY'>, <TokenType.RING: 'RING'>, <TokenType.PERCENT: 'PERCENT'>, <TokenType.NATURAL: 'NATURAL'>, <TokenType.DATE: 'DATE'>, <TokenType.NULL: 'NULL'>, <TokenType.LEFT: 'LEFT'>, <TokenType.FIRST: 'FIRST'>, <TokenType.KILL: 'KILL'>, <TokenType.TEMPORARY: 'TEMPORARY'>, <TokenType.UNIQUEIDENTIFIER: 'UNIQUEIDENTIFIER'>, <TokenType.LIMIT: 'LIMIT'>, <TokenType.TIMETZ: 'TIMETZ'>, <TokenType.DIV: 'DIV'>, <TokenType.OBJECT: 'OBJECT'>, <TokenType.CUBE: 'CUBE'>, <TokenType.DEFAULT: 'DEFAULT'>, <TokenType.DECIMAL128: 'DECIMAL128'>, <TokenType.UINT: 'UINT'>, <TokenType.TSMULTIRANGE: 'TSMULTIRANGE'>, <TokenType.ROWS: 'ROWS'>, <TokenType.VAR: 'VAR'>, <TokenType.OVERWRITE: 'OVERWRITE'>, <TokenType.UTINYINT: 'UTINYINT'>, <TokenType.SOME: 'SOME'>, <TokenType.ANTI: 'ANTI'>, <TokenType.DESCRIBE: 'DESCRIBE'>, <TokenType.TIMESTAMP_MS: 'TIMESTAMP_MS'>, <TokenType.IPV4: 'IPV4'>, <TokenType.TIMESTAMPLTZ: 'TIMESTAMPLTZ'>, <TokenType.INET: 'INET'>, <TokenType.TDIGEST: 'TDIGEST'>, <TokenType.DATETIME2: 'DATETIME2'>, <TokenType.FALSE: 'FALSE'>, <TokenType.OBJECT_IDENTIFIER: 'OBJECT_IDENTIFIER'>, <TokenType.DETACH: 'DETACH'>, <TokenType.YEAR: 'YEAR'>, <TokenType.IMAGE: 'IMAGE'>, <TokenType.FLOAT: 'FLOAT'>, <TokenType.TSTZRANGE: 'TSTZRANGE'>, <TokenType.VARCHAR: 'VARCHAR'>, <TokenType.MEDIUMBLOB: 'MEDIUMBLOB'>, <TokenType.CURRENT_TIMESTAMP: 'CURRENT_TIMESTAMP'>, <TokenType.DATABASE: 'DATABASE'>, <TokenType.WINDOW: 'WINDOW'>, <TokenType.LOWCARDINALITY: 'LOWCARDINALITY'>, <TokenType.RECURSIVE: 'RECURSIVE'>, <TokenType.TABLE: 'TABLE'>, <TokenType.CURRENT_DATE: 'CURRENT_DATE'>, <TokenType.STRUCT: 'STRUCT'>, <TokenType.COLLATE: 'COLLATE'>, <TokenType.DATETIME64: 'DATETIME64'>, <TokenType.ROLLUP: 'ROLLUP'>, <TokenType.INT4RANGE: 'INT4RANGE'>, <TokenType.COMMAND: 'COMMAND'>, <TokenType.IDENTIFIER: 'IDENTIFIER'>, <TokenType.UINT128: 'UINT128'>, <TokenType.TEXT: 'TEXT'>, <TokenType.KEEP: 'KEEP'>, <TokenType.VARBINARY: 'VARBINARY'>, <TokenType.ARRAY: 'ARRAY'>, <TokenType.FORMAT: 'FORMAT'>, <TokenType.UNKNOWN: 'UNKNOWN'>, <TokenType.DATERANGE: 'DATERANGE'>, <TokenType.COMMIT: 'COMMIT'>, <TokenType.ATTACH: 'ATTACH'>, <TokenType.SERIAL: 'SERIAL'>, <TokenType.INT8RANGE: 'INT8RANGE'>, <TokenType.TRUE: 'TRUE'>, <TokenType.ENUM: 'ENUM'>, <TokenType.PARTITION: 'PARTITION'>, <TokenType.ASOF: 'ASOF'>, <TokenType.WAREHOUSE: 'WAREHOUSE'>, <TokenType.CHAR: 'CHAR'>, <TokenType.UPDATE: 'UPDATE'>, <TokenType.IPADDRESS: 'IPADDRESS'>, <TokenType.INDEX: 'INDEX'>, <TokenType.AUTO_INCREMENT: 'AUTO_INCREMENT'>, <TokenType.PROCEDURE: 'PROCEDURE'>, <TokenType.REPLACE: 'REPLACE'>, <TokenType.USE: 'USE'>, <TokenType.TAG: 'TAG'>, <TokenType.CACHE: 'CACHE'>, <TokenType.FUNCTION: 'FUNCTION'>, <TokenType.BIGSERIAL: 'BIGSERIAL'>, <TokenType.MULTIPOLYGON: 'MULTIPOLYGON'>, <TokenType.INT8MULTIRANGE: 'INT8MULTIRANGE'>, <TokenType.HLLSKETCH: 'HLLSKETCH'>, <TokenType.MULTILINESTRING: 'MULTILINESTRING'>, <TokenType.OPERATOR: 'OPERATOR'>, <TokenType.DECIMAL: 'DECIMAL'>, <TokenType.TINYTEXT: 'TINYTEXT'>, <TokenType.VARIANT: 'VARIANT'>, <TokenType.UNIQUE: 'UNIQUE'>, <TokenType.USERDEFINED: 'USERDEFINED'>, <TokenType.MEDIUMTEXT: 'MEDIUMTEXT'>, <TokenType.SHOW: 'SHOW'>, <TokenType.TIMESTAMPTZ: 'TIMESTAMPTZ'>, <TokenType.STREAMLIT: 'STREAMLIT'>, <TokenType.SMALLDATETIME: 'SMALLDATETIME'>, <TokenType.DECIMAL256: 'DECIMAL256'>, <TokenType.LIST: 'LIST'>, <TokenType.TSRANGE: 'TSRANGE'>, <TokenType.DECIMAL64: 'DECIMAL64'>, <TokenType.NCHAR: 'NCHAR'>, <TokenType.APPLY: 'APPLY'>, <TokenType.TINYBLOB: 'TINYBLOB'>, <TokenType.BIGINT: 'BIGINT'>, <TokenType.ORDINALITY: 'ORDINALITY'>, <TokenType.NAMESPACE: 'NAMESPACE'>, <TokenType.IPV6: 'IPV6'>, <TokenType.IPPREFIX: 'IPPREFIX'>, <TokenType.BPCHAR: 'BPCHAR'>, <TokenType.SMALLSERIAL: 'SMALLSERIAL'>, <TokenType.SIMPLEAGGREGATEFUNCTION: 'SIMPLEAGGREGATEFUNCTION'>, <TokenType.DESC: 'DESC'>, <TokenType.GEOMETRY: 'GEOMETRY'>, <TokenType.STRAIGHT_JOIN: 'STRAIGHT_JOIN'>, <TokenType.END: 'END'>, <TokenType.XML: 'XML'>, <TokenType.ISNULL: 'ISNULL'>, <TokenType.FILTER: 'FILTER'>, <TokenType.SEMI: 'SEMI'>, <TokenType.IS: 'IS'>, <TokenType.USMALLINT: 'USMALLINT'>, <TokenType.DECIMAL32: 'DECIMAL32'>, <TokenType.FIXEDSTRING: 'FIXEDSTRING'>, <TokenType.BOOLEAN: 'BOOLEAN'>, <TokenType.DYNAMIC: 'DYNAMIC'>, <TokenType.POLYGON: 'POLYGON'>, <TokenType.NESTED: 'NESTED'>, <TokenType.SETTINGS: 'SETTINGS'>, <TokenType.BIT: 'BIT'>, <TokenType.INT256: 'INT256'>, <TokenType.MEDIUMINT: 'MEDIUMINT'>, <TokenType.BEGIN: 'BEGIN'>, <TokenType.LONGTEXT: 'LONGTEXT'>, <TokenType.FINAL: 'FINAL'>, <TokenType.UBIGINT: 'UBIGINT'>, <TokenType.CURRENT_DATETIME: 'CURRENT_DATETIME'>, <TokenType.SUPER: 'SUPER'>, <TokenType.SINK: 'SINK'>, <TokenType.CURRENT_TIME: 'CURRENT_TIME'>, <TokenType.RANGE: 'RANGE'>, <TokenType.ALL: 'ALL'>, <TokenType.VECTOR: 'VECTOR'>, <TokenType.TRUNCATE: 'TRUNCATE'>, <TokenType.NUMMULTIRANGE: 'NUMMULTIRANGE'>, <TokenType.AGGREGATEFUNCTION: 'AGGREGATEFUNCTION'>, <TokenType.INT4MULTIRANGE: 'INT4MULTIRANGE'>, <TokenType.UUID: 'UUID'>, <TokenType.RIGHT: 'RIGHT'>, <TokenType.MAP: 'MAP'>}
TABLE_ALIAS_TOKENS = {<TokenType.NEXT: 'NEXT'>, <TokenType.UNNEST: 'UNNEST'>, <TokenType.STORAGE_INTEGRATION: 'STORAGE_INTEGRATION'>, <TokenType.NVARCHAR: 'NVARCHAR'>, <TokenType.REFERENCES: 'REFERENCES'>, <TokenType.ROW: 'ROW'>, <TokenType.TSTZMULTIRANGE: 'TSTZMULTIRANGE'>, <TokenType.POINT: 'POINT'>, <TokenType.ENUM8: 'ENUM8'>, <TokenType.BIGDECIMAL: 'BIGDECIMAL'>, <TokenType.CASE: 'CASE'>, <TokenType.TIME: 'TIME'>, <TokenType.LOAD: 'LOAD'>, <TokenType.OFFSET: 'OFFSET'>, <TokenType.TIMESTAMP: 'TIMESTAMP'>, <TokenType.DOUBLE: 'DOUBLE'>, <TokenType.JSONB: 'JSONB'>, <TokenType.PIVOT: 'PIVOT'>, <TokenType.UMEDIUMINT: 'UMEDIUMINT'>, <TokenType.SEQUENCE: 'SEQUENCE'>, <TokenType.MERGE: 'MERGE'>, <TokenType.SOURCE: 'SOURCE'>, <TokenType.GEOGRAPHY: 'GEOGRAPHY'>, <TokenType.ASC: 'ASC'>, <TokenType.CONSTRAINT: 'CONSTRAINT'>, <TokenType.MODEL: 'MODEL'>, <TokenType.TIMESTAMP_NS: 'TIMESTAMP_NS'>, <TokenType.PRAGMA: 'PRAGMA'>, <TokenType.SMALLMONEY: 'SMALLMONEY'>, <TokenType.VOLATILE: 'VOLATILE'>, <TokenType.NULLABLE: 'NULLABLE'>, <TokenType.OVERLAPS: 'OVERLAPS'>, <TokenType.INTERVAL: 'INTERVAL'>, <TokenType.DATEMULTIRANGE: 'DATEMULTIRANGE'>, <TokenType.FOREIGN_KEY: 'FOREIGN_KEY'>, <TokenType.SET: 'SET'>, <TokenType.VIEW: 'VIEW'>, <TokenType.INT: 'INT'>, <TokenType.ENUM16: 'ENUM16'>, <TokenType.JSON: 'JSON'>, <TokenType.SMALLINT: 'SMALLINT'>, <TokenType.EXECUTE: 'EXECUTE'>, <TokenType.NUMRANGE: 'NUMRANGE'>, <TokenType.DATETIME: 'DATETIME'>, <TokenType.COPY: 'COPY'>, <TokenType.BINARY: 'BINARY'>, <TokenType.SCHEMA: 'SCHEMA'>, <TokenType.TINYINT: 'TINYINT'>, <TokenType.COMMENT: 'COMMENT'>, <TokenType.INT128: 'INT128'>, <TokenType.UDECIMAL: 'UDECIMAL'>, <TokenType.TOP: 'TOP'>, <TokenType.ESCAPE: 'ESCAPE'>, <TokenType.TIMESTAMPNTZ: 'TIMESTAMPNTZ'>, <TokenType.DELETE: 'DELETE'>, <TokenType.DICTIONARY: 'DICTIONARY'>, <TokenType.COLUMN: 'COLUMN'>, <TokenType.LINESTRING: 'LINESTRING'>, <TokenType.UINT256: 'UINT256'>, <TokenType.ROWVERSION: 'ROWVERSION'>, <TokenType.CURRENT_USER: 'CURRENT_USER'>, <TokenType.EXISTS: 'EXISTS'>, <TokenType.PSEUDO_TYPE: 'PSEUDO_TYPE'>, <TokenType.UNPIVOT: 'UNPIVOT'>, <TokenType.RENAME: 'RENAME'>, <TokenType.REFRESH: 'REFRESH'>, <TokenType.NAME: 'NAME'>, <TokenType.LONGBLOB: 'LONGBLOB'>, <TokenType.MONEY: 'MONEY'>, <TokenType.DATE32: 'DATE32'>, <TokenType.TIMESTAMP_S: 'TIMESTAMP_S'>, <TokenType.HSTORE: 'HSTORE'>, <TokenType.ANY: 'ANY'>, <TokenType.RING: 'RING'>, <TokenType.PERCENT: 'PERCENT'>, <TokenType.DATE: 'DATE'>, <TokenType.NULL: 'NULL'>, <TokenType.FIRST: 'FIRST'>, <TokenType.KILL: 'KILL'>, <TokenType.TEMPORARY: 'TEMPORARY'>, <TokenType.UNIQUEIDENTIFIER: 'UNIQUEIDENTIFIER'>, <TokenType.LIMIT: 'LIMIT'>, <TokenType.TIMETZ: 'TIMETZ'>, <TokenType.DIV: 'DIV'>, <TokenType.OBJECT: 'OBJECT'>, <TokenType.CUBE: 'CUBE'>, <TokenType.DEFAULT: 'DEFAULT'>, <TokenType.DECIMAL128: 'DECIMAL128'>, <TokenType.UINT: 'UINT'>, <TokenType.TSMULTIRANGE: 'TSMULTIRANGE'>, <TokenType.VAR: 'VAR'>, <TokenType.OVERWRITE: 'OVERWRITE'>, <TokenType.UTINYINT: 'UTINYINT'>, <TokenType.SOME: 'SOME'>, <TokenType.DESCRIBE: 'DESCRIBE'>, <TokenType.TIMESTAMP_MS: 'TIMESTAMP_MS'>, <TokenType.ANTI: 'ANTI'>, <TokenType.IPV4: 'IPV4'>, <TokenType.TIMESTAMPLTZ: 'TIMESTAMPLTZ'>, <TokenType.INET: 'INET'>, <TokenType.TDIGEST: 'TDIGEST'>, <TokenType.DATETIME2: 'DATETIME2'>, <TokenType.FALSE: 'FALSE'>, <TokenType.OBJECT_IDENTIFIER: 'OBJECT_IDENTIFIER'>, <TokenType.DETACH: 'DETACH'>, <TokenType.YEAR: 'YEAR'>, <TokenType.IMAGE: 'IMAGE'>, <TokenType.FLOAT: 'FLOAT'>, <TokenType.TSTZRANGE: 'TSTZRANGE'>, <TokenType.VARCHAR: 'VARCHAR'>, <TokenType.MEDIUMBLOB: 'MEDIUMBLOB'>, <TokenType.CURRENT_TIMESTAMP: 'CURRENT_TIMESTAMP'>, <TokenType.DATABASE: 'DATABASE'>, <TokenType.LOWCARDINALITY: 'LOWCARDINALITY'>, <TokenType.RECURSIVE: 'RECURSIVE'>, <TokenType.TABLE: 'TABLE'>, <TokenType.CURRENT_DATE: 'CURRENT_DATE'>, <TokenType.STRUCT: 'STRUCT'>, <TokenType.COLLATE: 'COLLATE'>, <TokenType.DATETIME64: 'DATETIME64'>, <TokenType.ROLLUP: 'ROLLUP'>, <TokenType.INT4RANGE: 'INT4RANGE'>, <TokenType.COMMAND: 'COMMAND'>, <TokenType.IDENTIFIER: 'IDENTIFIER'>, <TokenType.UINT128: 'UINT128'>, <TokenType.TEXT: 'TEXT'>, <TokenType.KEEP: 'KEEP'>, <TokenType.VARBINARY: 'VARBINARY'>, <TokenType.ARRAY: 'ARRAY'>, <TokenType.FORMAT: 'FORMAT'>, <TokenType.UNKNOWN: 'UNKNOWN'>, <TokenType.DATERANGE: 'DATERANGE'>, <TokenType.COMMIT: 'COMMIT'>, <TokenType.ATTACH: 'ATTACH'>, <TokenType.SERIAL: 'SERIAL'>, <TokenType.INT8RANGE: 'INT8RANGE'>, <TokenType.TRUE: 'TRUE'>, <TokenType.ENUM: 'ENUM'>, <TokenType.PARTITION: 'PARTITION'>, <TokenType.WAREHOUSE: 'WAREHOUSE'>, <TokenType.CHAR: 'CHAR'>, <TokenType.UPDATE: 'UPDATE'>, <TokenType.IPADDRESS: 'IPADDRESS'>, <TokenType.INDEX: 'INDEX'>, <TokenType.AUTO_INCREMENT: 'AUTO_INCREMENT'>, <TokenType.PROCEDURE: 'PROCEDURE'>, <TokenType.REPLACE: 'REPLACE'>, <TokenType.USE: 'USE'>, <TokenType.TAG: 'TAG'>, <TokenType.CACHE: 'CACHE'>, <TokenType.FUNCTION: 'FUNCTION'>, <TokenType.BIGSERIAL: 'BIGSERIAL'>, <TokenType.MULTIPOLYGON: 'MULTIPOLYGON'>, <TokenType.INT8MULTIRANGE: 'INT8MULTIRANGE'>, <TokenType.HLLSKETCH: 'HLLSKETCH'>, <TokenType.MULTILINESTRING: 'MULTILINESTRING'>, <TokenType.OPERATOR: 'OPERATOR'>, <TokenType.DECIMAL: 'DECIMAL'>, <TokenType.TINYTEXT: 'TINYTEXT'>, <TokenType.VARIANT: 'VARIANT'>, <TokenType.UNIQUE: 'UNIQUE'>, <TokenType.USERDEFINED: 'USERDEFINED'>, <TokenType.MEDIUMTEXT: 'MEDIUMTEXT'>, <TokenType.SHOW: 'SHOW'>, <TokenType.TIMESTAMPTZ: 'TIMESTAMPTZ'>, <TokenType.STREAMLIT: 'STREAMLIT'>, <TokenType.SMALLDATETIME: 'SMALLDATETIME'>, <TokenType.DECIMAL256: 'DECIMAL256'>, <TokenType.LIST: 'LIST'>, <TokenType.TSRANGE: 'TSRANGE'>, <TokenType.DECIMAL64: 'DECIMAL64'>, <TokenType.NCHAR: 'NCHAR'>, <TokenType.TINYBLOB: 'TINYBLOB'>, <TokenType.BIGINT: 'BIGINT'>, <TokenType.ORDINALITY: 'ORDINALITY'>, <TokenType.NAMESPACE: 'NAMESPACE'>, <TokenType.IPV6: 'IPV6'>, <TokenType.IPPREFIX: 'IPPREFIX'>, <TokenType.BPCHAR: 'BPCHAR'>, <TokenType.SMALLSERIAL: 'SMALLSERIAL'>, <TokenType.SIMPLEAGGREGATEFUNCTION: 'SIMPLEAGGREGATEFUNCTION'>, <TokenType.DESC: 'DESC'>, <TokenType.GEOMETRY: 'GEOMETRY'>, <TokenType.STRAIGHT_JOIN: 'STRAIGHT_JOIN'>, <TokenType.END: 'END'>, <TokenType.XML: 'XML'>, <TokenType.ISNULL: 'ISNULL'>, <TokenType.FILTER: 'FILTER'>, <TokenType.USMALLINT: 'USMALLINT'>, <TokenType.IS: 'IS'>, <TokenType.DECIMAL32: 'DECIMAL32'>, <TokenType.FIXEDSTRING: 'FIXEDSTRING'>, <TokenType.SEMI: 'SEMI'>, <TokenType.BOOLEAN: 'BOOLEAN'>, <TokenType.DYNAMIC: 'DYNAMIC'>, <TokenType.POLYGON: 'POLYGON'>, <TokenType.NESTED: 'NESTED'>, <TokenType.SETTINGS: 'SETTINGS'>, <TokenType.BIT: 'BIT'>, <TokenType.INT256: 'INT256'>, <TokenType.MEDIUMINT: 'MEDIUMINT'>, <TokenType.BEGIN: 'BEGIN'>, <TokenType.LONGTEXT: 'LONGTEXT'>, <TokenType.FINAL: 'FINAL'>, <TokenType.UBIGINT: 'UBIGINT'>, <TokenType.CURRENT_DATETIME: 'CURRENT_DATETIME'>, <TokenType.SUPER: 'SUPER'>, <TokenType.SINK: 'SINK'>, <TokenType.CURRENT_TIME: 'CURRENT_TIME'>, <TokenType.RANGE: 'RANGE'>, <TokenType.ALL: 'ALL'>, <TokenType.VECTOR: 'VECTOR'>, <TokenType.TRUNCATE: 'TRUNCATE'>, <TokenType.NUMMULTIRANGE: 'NUMMULTIRANGE'>, <TokenType.AGGREGATEFUNCTION: 'AGGREGATEFUNCTION'>, <TokenType.INT4MULTIRANGE: 'INT4MULTIRANGE'>, <TokenType.UUID: 'UUID'>, <TokenType.ROWS: 'ROWS'>, <TokenType.MAP: 'MAP'>}
SHOW_TRIE: Dict = {}
SET_TRIE: Dict = {'GLOBAL': {0: True}, 'LOCAL': {0: True}, 'SESSION': {0: True}, 'TRANSACTION': {0: True}}

##### Inherited Members

sqlglot.parser.Parser
  Parser
  STRUCT_TYPE_TOKENS
  ENUM_TYPE_TOKENS
  AGGREGATE_TYPE_TOKENS
  TYPE_TOKENS
  SIGNED_TO_UNSIGNED_TYPE_TOKEN
  SUBQUERY_PREDICATES
  RESERVED_TOKENS
  DB_CREATABLES
  CREATABLES
  ALTERABLES
  INTERVAL_VARS
  ALIAS_TOKENS
  ARRAY_CONSTRUCTORS
  COMMENT_TABLE_ALIAS_TOKENS
  UPDATE_ALIAS_TOKENS
  TRIM_TYPES
  FUNC_TOKENS
  CONJUNCTION
  ASSIGNMENT
  DISJUNCTION
  EQUALITY
  COMPARISON
  BITWISE
  TERM
  FACTOR
  EXPONENT
  TIMES
  TIMESTAMPS
  SET_OPERATIONS
  JOIN_METHODS
  JOIN_SIDES
  JOIN_KINDS
  JOIN_HINTS
  LAMBDAS
  COLUMN_OPERATORS
  EXPRESSION_PARSERS
  UNARY_PARSERS
  STRING_PARSERS
  NUMERIC_PARSERS
  PRIMARY_PARSERS
  PLACEHOLDER_PARSERS
  ALTER_PARSERS
  ALTER_ALTER_PARSERS
  SCHEMA_UNNAMED_CONSTRAINTS
  NO_PAREN_FUNCTION_PARSERS
  INVALID_FUNC_NAME_TOKENS
  FUNCTIONS_WITH_ALIASED_ARGS
  KEY_VALUE_DEFINITIONS
  QUERY_MODIFIER_PARSERS
  SET_PARSERS
  SHOW_PARSERS
  TYPE_LITERAL_PARSERS
  TYPE_CONVERTERS
  DDL_SELECT_TOKENS
  PRE_VOLATILE_TOKENS
  TRANSACTION_KIND
  TRANSACTION_CHARACTERISTICS
  CONFLICT_ACTIONS
  CREATE_SEQUENCE
  ISOLATED_LOADING_OPTIONS
  USABLES
  CAST_ACTIONS
  SCHEMA_BINDING_OPTIONS
  PROCEDURE_OPTIONS
  EXECUTE_AS_OPTIONS
  KEY_CONSTRAINT_OPTIONS
  INSERT_ALTERNATIVES
  CLONE_KEYWORDS
  HISTORICAL_DATA_PREFIX
  HISTORICAL_DATA_KIND
  OPCLASS_FOLLOW_KEYWORDS
  OPTYPE_FOLLOW_TOKENS
  TABLE_INDEX_HINT_TOKENS
  VIEW_ATTRIBUTES
  WINDOW_ALIAS_TOKENS
  WINDOW_BEFORE_PAREN_TOKENS
  WINDOW_SIDES
  JSON_KEY_VALUE_SEPARATOR_TOKENS
  FETCH_TOKENS
  ADD_CONSTRAINT_TOKENS
  DISTINCT_TOKENS
  UNNEST_OFFSET_ALIAS_TOKENS
  SELECT_START_TOKENS
  COPY_INTO_VARLEN_OPTIONS
  IS_JSON_PREDICATE_KIND
  ODBC_DATETIME_LITERALS
  ON_CONDITION_TOKENS
  PRIVILEGE_FOLLOW_TOKENS
  DESCRIBE_STYLES
  ANALYZE_STYLES
  ANALYZE_EXPRESSION_PARSERS
  PARTITION_KEYWORDS
  AMBIGUOUS_ALIAS_TOKENS
  OPERATION_MODIFIERS
  STRICT_CAST
  IDENTIFY_PIVOT_STRINGS
  ALTER_TABLE_ADD_REQUIRED_FOR_EACH_COLUMN
  TABLESAMPLE_CSV
  DEFAULT_SAMPLING_METHOD
  SET_REQUIRES_ASSIGNMENT_DELIMITER
  TRIM_PATTERN_FIRST
  STRING_ALIASES
  MODIFIERS_ATTACHED_TO_SET_OP
  SET_OP_MODIFIERS
  NO_PAREN_IF_COMMANDS
  JSON_ARROWS_REQUIRE_JSON_TYPE
  COLON_IS_VARIANT_EXTRACT
  VALUES_FOLLOWED_BY_PAREN
  INTERVAL_SPANS
  SUPPORTS_PARTITION_SELECTION
  WRAPPED_TRANSFORM_COLUMN_CONSTRAINT
  OPTIONAL_ALIAS_TOKEN_CTE
  error_level
  error_message_context
  max_errors
  dialect
  reset
  parse
  parse_into
  check_errors
  raise_error
  expression
  validate_expression
  errors
  sql

class BigQuery.Generator(sqlglot.generator.Generator): View Source

     833    class Generator(generator.Generator):
     834        INTERVAL_ALLOWS_PLURAL_FORM = False
     835        JOIN_HINTS = False
     836        QUERY_HINTS = False
     837        TABLE_HINTS = False
     838        LIMIT_FETCH = "LIMIT"
     839        RENAME_TABLE_WITH_DB = False
     840        NVL2_SUPPORTED = False
     841        UNNEST_WITH_ORDINALITY = False
     842        COLLATE_IS_FUNC = True
     843        LIMIT_ONLY_LITERALS = True
     844        SUPPORTS_TABLE_ALIAS_COLUMNS = False
     845        UNPIVOT_ALIASES_ARE_IDENTIFIERS = False
     846        JSON_KEY_VALUE_PAIR_SEP = ","
     847        NULL_ORDERING_SUPPORTED = False
     848        IGNORE_NULLS_IN_FUNC = True
     849        JSON_PATH_SINGLE_QUOTE_ESCAPE = True
     850        CAN_IMPLEMENT_ARRAY_ANY = True
     851        SUPPORTS_TO_NUMBER = False
     852        NAMED_PLACEHOLDER_TOKEN = "@"
     853        HEX_FUNC = "TO_HEX"
     854        WITH_PROPERTIES_PREFIX = "OPTIONS"
     855        SUPPORTS_EXPLODING_PROJECTIONS = False
     856        EXCEPT_INTERSECT_SUPPORT_ALL_CLAUSE = False
     857        SUPPORTS_UNIX_SECONDS = True
     858
     859        TRANSFORMS = {
     860            **generator.Generator.TRANSFORMS,
     861            exp.ApproxDistinct: rename_func("APPROX_COUNT_DISTINCT"),
     862            exp.ArgMax: arg_max_or_min_no_count("MAX_BY"),
     863            exp.ArgMin: arg_max_or_min_no_count("MIN_BY"),
     864            exp.Array: inline_array_unless_query,
     865            exp.ArrayContains: _array_contains_sql,
     866            exp.ArrayFilter: filter_array_using_unnest,
     867            exp.Cast: transforms.preprocess([transforms.remove_precision_parameterized_types]),
     868            exp.CollateProperty: lambda self, e: (
     869                f"DEFAULT COLLATE {self.sql(e, 'this')}"
     870                if e.args.get("default")
     871                else f"COLLATE {self.sql(e, 'this')}"
     872            ),
     873            exp.Commit: lambda *_: "COMMIT TRANSACTION",
     874            exp.CountIf: rename_func("COUNTIF"),
     875            exp.Create: _create_sql,
     876            exp.CTE: transforms.preprocess([_pushdown_cte_column_names]),
     877            exp.DateAdd: date_add_interval_sql("DATE", "ADD"),
     878            exp.DateDiff: lambda self, e: self.func(
     879                "DATE_DIFF", e.this, e.expression, unit_to_var(e)
     880            ),
     881            exp.DateFromParts: rename_func("DATE"),
     882            exp.DateStrToDate: datestrtodate_sql,
     883            exp.DateSub: date_add_interval_sql("DATE", "SUB"),
     884            exp.DatetimeAdd: date_add_interval_sql("DATETIME", "ADD"),
     885            exp.DatetimeSub: date_add_interval_sql("DATETIME", "SUB"),
     886            exp.DateTrunc: lambda self, e: self.func(
     887                "DATE_TRUNC", e.this, e.text("unit"), e.args.get("zone")
     888            ),
     889            exp.FromTimeZone: lambda self, e: self.func(
     890                "DATETIME", self.func("TIMESTAMP", e.this, e.args.get("zone")), "'UTC'"
     891            ),
     892            exp.GenerateSeries: rename_func("GENERATE_ARRAY"),
     893            exp.GroupConcat: rename_func("STRING_AGG"),
     894            exp.Hex: lambda self, e: self.func("UPPER", self.func("TO_HEX", self.sql(e, "this"))),
     895            exp.If: if_sql(false_value="NULL"),
     896            exp.ILike: no_ilike_sql,
     897            exp.IntDiv: rename_func("DIV"),
     898            exp.Int64: rename_func("INT64"),
     899            exp.JSONExtract: _json_extract_sql,
     900            exp.JSONExtractArray: _json_extract_sql,
     901            exp.JSONExtractScalar: _json_extract_sql,
     902            exp.JSONFormat: rename_func("TO_JSON_STRING"),
     903            exp.Levenshtein: _levenshtein_sql,
     904            exp.Max: max_or_greatest,
     905            exp.MD5: lambda self, e: self.func("TO_HEX", self.func("MD5", e.this)),
     906            exp.MD5Digest: rename_func("MD5"),
     907            exp.Min: min_or_least,
     908            exp.PartitionedByProperty: lambda self, e: f"PARTITION BY {self.sql(e, 'this')}",
     909            exp.RegexpExtract: lambda self, e: self.func(
     910                "REGEXP_EXTRACT",
     911                e.this,
     912                e.expression,
     913                e.args.get("position"),
     914                e.args.get("occurrence"),
     915            ),
     916            exp.RegexpExtractAll: lambda self, e: self.func(
     917                "REGEXP_EXTRACT_ALL", e.this, e.expression
     918            ),
     919            exp.RegexpReplace: regexp_replace_sql,
     920            exp.RegexpLike: rename_func("REGEXP_CONTAINS"),
     921            exp.ReturnsProperty: _returnsproperty_sql,
     922            exp.Rollback: lambda *_: "ROLLBACK TRANSACTION",
     923            exp.Select: transforms.preprocess(
     924                [
     925                    transforms.explode_to_unnest(),
     926                    transforms.unqualify_unnest,
     927                    transforms.eliminate_distinct_on,
     928                    _alias_ordered_group,
     929                    transforms.eliminate_semi_and_anti_joins,
     930                ]
     931            ),
     932            exp.SHA: rename_func("SHA1"),
     933            exp.SHA2: sha256_sql,
     934            exp.StabilityProperty: lambda self, e: (
     935                "DETERMINISTIC" if e.name == "IMMUTABLE" else "NOT DETERMINISTIC"
     936            ),
     937            exp.String: rename_func("STRING"),
     938            exp.StrPosition: lambda self, e: (
     939                strposition_sql(
     940                    self, e, func_name="INSTR", supports_position=True, supports_occurrence=True
     941                )
     942            ),
     943            exp.StrToDate: _str_to_datetime_sql,
     944            exp.StrToTime: _str_to_datetime_sql,
     945            exp.TimeAdd: date_add_interval_sql("TIME", "ADD"),
     946            exp.TimeFromParts: rename_func("TIME"),
     947            exp.TimestampFromParts: rename_func("DATETIME"),
     948            exp.TimeSub: date_add_interval_sql("TIME", "SUB"),
     949            exp.TimestampAdd: date_add_interval_sql("TIMESTAMP", "ADD"),
     950            exp.TimestampDiff: rename_func("TIMESTAMP_DIFF"),
     951            exp.TimestampSub: date_add_interval_sql("TIMESTAMP", "SUB"),
     952            exp.TimeStrToTime: timestrtotime_sql,
     953            exp.Transaction: lambda *_: "BEGIN TRANSACTION",
     954            exp.TsOrDsAdd: _ts_or_ds_add_sql,
     955            exp.TsOrDsDiff: _ts_or_ds_diff_sql,
     956            exp.TsOrDsToTime: rename_func("TIME"),
     957            exp.TsOrDsToDatetime: rename_func("DATETIME"),
     958            exp.TsOrDsToTimestamp: rename_func("TIMESTAMP"),
     959            exp.Unhex: rename_func("FROM_HEX"),
     960            exp.UnixDate: rename_func("UNIX_DATE"),
     961            exp.UnixToTime: _unix_to_time_sql,
     962            exp.Uuid: lambda *_: "GENERATE_UUID()",
     963            exp.Values: _derived_table_values_to_unnest,
     964            exp.VariancePop: rename_func("VAR_POP"),
     965            exp.SafeDivide: rename_func("SAFE_DIVIDE"),
     966        }
     967
     968        SUPPORTED_JSON_PATH_PARTS = {
     969            exp.JSONPathKey,
     970            exp.JSONPathRoot,
     971            exp.JSONPathSubscript,
     972        }
     973
     974        TYPE_MAPPING = {
     975            **generator.Generator.TYPE_MAPPING,
     976            exp.DataType.Type.BIGDECIMAL: "BIGNUMERIC",
     977            exp.DataType.Type.BIGINT: "INT64",
     978            exp.DataType.Type.BINARY: "BYTES",
     979            exp.DataType.Type.BOOLEAN: "BOOL",
     980            exp.DataType.Type.CHAR: "STRING",
     981            exp.DataType.Type.DECIMAL: "NUMERIC",
     982            exp.DataType.Type.DOUBLE: "FLOAT64",
     983            exp.DataType.Type.FLOAT: "FLOAT64",
     984            exp.DataType.Type.INT: "INT64",
     985            exp.DataType.Type.NCHAR: "STRING",
     986            exp.DataType.Type.NVARCHAR: "STRING",
     987            exp.DataType.Type.SMALLINT: "INT64",
     988            exp.DataType.Type.TEXT: "STRING",
     989            exp.DataType.Type.TIMESTAMP: "DATETIME",
     990            exp.DataType.Type.TIMESTAMPTZ: "TIMESTAMP",
     991            exp.DataType.Type.TIMESTAMPLTZ: "TIMESTAMP",
     992            exp.DataType.Type.TINYINT: "INT64",
     993            exp.DataType.Type.ROWVERSION: "BYTES",
     994            exp.DataType.Type.UUID: "STRING",
     995            exp.DataType.Type.VARBINARY: "BYTES",
     996            exp.DataType.Type.VARCHAR: "STRING",
     997            exp.DataType.Type.VARIANT: "ANY TYPE",
     998        }
     999
    1000        PROPERTIES_LOCATION = {
    1001            **generator.Generator.PROPERTIES_LOCATION,
    1002            exp.PartitionedByProperty: exp.Properties.Location.POST_SCHEMA,
    1003            exp.VolatileProperty: exp.Properties.Location.UNSUPPORTED,
    1004        }
    1005
    1006        # WINDOW comes after QUALIFY
    1007        # https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#window_clause
    1008        AFTER_HAVING_MODIFIER_TRANSFORMS = {
    1009            "qualify": generator.Generator.AFTER_HAVING_MODIFIER_TRANSFORMS["qualify"],
    1010            "windows": generator.Generator.AFTER_HAVING_MODIFIER_TRANSFORMS["windows"],
    1011        }
    1012
    1013        # from: https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#reserved_keywords
    1014        RESERVED_KEYWORDS = {
    1015            "all",
    1016            "and",
    1017            "any",
    1018            "array",
    1019            "as",
    1020            "asc",
    1021            "assert_rows_modified",
    1022            "at",
    1023            "between",
    1024            "by",
    1025            "case",
    1026            "cast",
    1027            "collate",
    1028            "contains",
    1029            "create",
    1030            "cross",
    1031            "cube",
    1032            "current",
    1033            "default",
    1034            "define",
    1035            "desc",
    1036            "distinct",
    1037            "else",
    1038            "end",
    1039            "enum",
    1040            "escape",
    1041            "except",
    1042            "exclude",
    1043            "exists",
    1044            "extract",
    1045            "false",
    1046            "fetch",
    1047            "following",
    1048            "for",
    1049            "from",
    1050            "full",
    1051            "group",
    1052            "grouping",
    1053            "groups",
    1054            "hash",
    1055            "having",
    1056            "if",
    1057            "ignore",
    1058            "in",
    1059            "inner",
    1060            "intersect",
    1061            "interval",
    1062            "into",
    1063            "is",
    1064            "join",
    1065            "lateral",
    1066            "left",
    1067            "like",
    1068            "limit",
    1069            "lookup",
    1070            "merge",
    1071            "natural",
    1072            "new",
    1073            "no",
    1074            "not",
    1075            "null",
    1076            "nulls",
    1077            "of",
    1078            "on",
    1079            "or",
    1080            "order",
    1081            "outer",
    1082            "over",
    1083            "partition",
    1084            "preceding",
    1085            "proto",
    1086            "qualify",
    1087            "range",
    1088            "recursive",
    1089            "respect",
    1090            "right",
    1091            "rollup",
    1092            "rows",
    1093            "select",
    1094            "set",
    1095            "some",
    1096            "struct",
    1097            "tablesample",
    1098            "then",
    1099            "to",
    1100            "treat",
    1101            "true",
    1102            "unbounded",
    1103            "union",
    1104            "unnest",
    1105            "using",
    1106            "when",
    1107            "where",
    1108            "window",
    1109            "with",
    1110            "within",
    1111        }
    1112
    1113        def mod_sql(self, expression: exp.Mod) -> str:
    1114            this = expression.this
    1115            expr = expression.expression
    1116            return self.func(
    1117                "MOD",
    1118                this.unnest() if isinstance(this, exp.Paren) else this,
    1119                expr.unnest() if isinstance(expr, exp.Paren) else expr,
    1120            )
    1121
    1122        def column_parts(self, expression: exp.Column) -> str:
    1123            if expression.meta.get("quoted_column"):
    1124                # If a column reference is of the form `dataset.table`.name, we need
    1125                # to preserve the quoted table path, otherwise the reference breaks
    1126                table_parts = ".".join(p.name for p in expression.parts[:-1])
    1127                table_path = self.sql(exp.Identifier(this=table_parts, quoted=True))
    1128                return f"{table_path}.{self.sql(expression, 'this')}"
    1129
    1130            return super().column_parts(expression)
    1131
    1132        def table_parts(self, expression: exp.Table) -> str:
    1133            # Depending on the context, `x.y` may not resolve to the same data source as `x`.`y`, so
    1134            # we need to make sure the correct quoting is used in each case.
    1135            #
    1136            # For example, if there is a CTE x that clashes with a schema name, then the former will
    1137            # return the table y in that schema, whereas the latter will return the CTE's y column:
    1138            #
    1139            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x.y`   -> cross join
    1140            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x`.`y` -> implicit unnest
    1141            if expression.meta.get("quoted_table"):
    1142                table_parts = ".".join(p.name for p in expression.parts)
    1143                return self.sql(exp.Identifier(this=table_parts, quoted=True))
    1144
    1145            return super().table_parts(expression)
    1146
    1147        def timetostr_sql(self, expression: exp.TimeToStr) -> str:
    1148            this = expression.this
    1149            if isinstance(this, exp.TsOrDsToDatetime):
    1150                func_name = "FORMAT_DATETIME"
    1151            elif isinstance(this, exp.TsOrDsToTimestamp):
    1152                func_name = "FORMAT_TIMESTAMP"
    1153            else:
    1154                func_name = "FORMAT_DATE"
    1155
    1156            time_expr = (
    1157                this
    1158                if isinstance(this, (exp.TsOrDsToDatetime, exp.TsOrDsToTimestamp, exp.TsOrDsToDate))
    1159                else expression
    1160            )
    1161            return self.func(func_name, self.format_time(expression), time_expr.this)
    1162
    1163        def eq_sql(self, expression: exp.EQ) -> str:
    1164            # Operands of = cannot be NULL in BigQuery
    1165            if isinstance(expression.left, exp.Null) or isinstance(expression.right, exp.Null):
    1166                if not isinstance(expression.parent, exp.Update):
    1167                    return "NULL"
    1168
    1169            return self.binary(expression, "=")
    1170
    1171        def attimezone_sql(self, expression: exp.AtTimeZone) -> str:
    1172            parent = expression.parent
    1173
    1174            # BigQuery allows CAST(.. AS {STRING|TIMESTAMP} [FORMAT <fmt> [AT TIME ZONE <tz>]]).
    1175            # Only the TIMESTAMP one should use the below conversion, when AT TIME ZONE is included.
    1176            if not isinstance(parent, exp.Cast) or not parent.to.is_type("text"):
    1177                return self.func(
    1178                    "TIMESTAMP", self.func("DATETIME", expression.this, expression.args.get("zone"))
    1179                )
    1180
    1181            return super().attimezone_sql(expression)
    1182
    1183        def trycast_sql(self, expression: exp.TryCast) -> str:
    1184            return self.cast_sql(expression, safe_prefix="SAFE_")
    1185
    1186        def bracket_sql(self, expression: exp.Bracket) -> str:
    1187            this = expression.this
    1188            expressions = expression.expressions
    1189
    1190            if len(expressions) == 1 and this and this.is_type(exp.DataType.Type.STRUCT):
    1191                arg = expressions[0]
    1192                if arg.type is None:
    1193                    from sqlglot.optimizer.annotate_types import annotate_types
    1194
    1195                    arg = annotate_types(arg)
    1196
    1197                if arg.type and arg.type.this in exp.DataType.TEXT_TYPES:
    1198                    # BQ doesn't support bracket syntax with string values for structs
    1199                    return f"{self.sql(this)}.{arg.name}"
    1200
    1201            expressions_sql = self.expressions(expression, flat=True)
    1202            offset = expression.args.get("offset")
    1203
    1204            if offset == 0:
    1205                expressions_sql = f"OFFSET({expressions_sql})"
    1206            elif offset == 1:
    1207                expressions_sql = f"ORDINAL({expressions_sql})"
    1208            elif offset is not None:
    1209                self.unsupported(f"Unsupported array offset: {offset}")
    1210
    1211            if expression.args.get("safe"):
    1212                expressions_sql = f"SAFE_{expressions_sql}"
    1213
    1214            return f"{self.sql(this)}[{expressions_sql}]"
    1215
    1216        def in_unnest_op(self, expression: exp.Unnest) -> str:
    1217            return self.sql(expression)
    1218
    1219        def version_sql(self, expression: exp.Version) -> str:
    1220            if expression.name == "TIMESTAMP":
    1221                expression.set("this", "SYSTEM_TIME")
    1222            return super().version_sql(expression)
    1223
    1224        def contains_sql(self, expression: exp.Contains) -> str:
    1225            this = expression.this
    1226            expr = expression.expression
    1227
    1228            if isinstance(this, exp.Lower) and isinstance(expr, exp.Lower):
    1229                this = this.this
    1230                expr = expr.this
    1231
    1232            return self.func("CONTAINS_SUBSTR", this, expr)

Generator converts a given syntax tree to the corresponding SQL string.

###### Arguments:

- pretty: Whether to format the produced SQL string. Default: False.
- identify: Determines when an identifier should be quoted. Possible values are: False (default): Never quote, except in cases where it's mandatory by the dialect. True or 'always': Always quote. 'safe': Only quote identifiers that are case insensitive.
- normalize: Whether to normalize identifiers to lowercase. Default: False.
- pad: The pad size in a formatted string. For example, this affects the indentation of a projection in a query, relative to its nesting level. Default: 2.
- indent: The indentation size in a formatted string. For example, this affects the indentation of subqueries and filters under a `WHERE` clause. Default: 2.
- normalize_functions: How to normalize function names. Possible values are: "upper" or True (default): Convert names to uppercase. "lower": Convert names to lowercase. False: Disables function name normalization.
- unsupported_level: Determines the generator's behavior when it encounters unsupported expressions. Default ErrorLevel.WARN.
- max_unsupported: Maximum number of unsupported messages to include in a raised UnsupportedError. This is only relevant if unsupported_level is ErrorLevel.RAISE. Default: 3
- leading_comma: Whether the comma is leading or trailing in select expressions. This is only relevant when generating in pretty mode. Default: False
- max_text_width: The max number of characters in a segment before creating new lines in pretty mode. The default is on the smaller end because the length only represents a segment and not the true line length. Default: 80
- comments: Whether to preserve comments in the output SQL code. Default: True

INTERVAL_ALLOWS_PLURAL_FORM = False
JOIN_HINTS = False
QUERY_HINTS = False
TABLE_HINTS = False
LIMIT_FETCH = 'LIMIT'
RENAME_TABLE_WITH_DB = False
NVL2_SUPPORTED = False
UNNEST_WITH_ORDINALITY = False
COLLATE_IS_FUNC = True
LIMIT_ONLY_LITERALS = True
SUPPORTS_TABLE_ALIAS_COLUMNS = False
UNPIVOT_ALIASES_ARE_IDENTIFIERS = False
JSON_KEY_VALUE_PAIR_SEP = ','
NULL_ORDERING_SUPPORTED = False
IGNORE_NULLS_IN_FUNC = True
JSON_PATH_SINGLE_QUOTE_ESCAPE = True
CAN_IMPLEMENT_ARRAY_ANY = True
SUPPORTS_TO_NUMBER = False
NAMED_PLACEHOLDER_TOKEN = '@'
HEX_FUNC = 'TO_HEX'
WITH_PROPERTIES_PREFIX = 'OPTIONS'
SUPPORTS_EXPLODING_PROJECTIONS = False
EXCEPT_INTERSECT_SUPPORT_ALL_CLAUSE = False
SUPPORTS_UNIX_SECONDS = True
TRANSFORMS = {<class 'sqlglot.expressions.JSONPathKey'>: <function <lambda>>, <class 'sqlglot.expressions.JSONPathRoot'>: <function <lambda>>, <class 'sqlglot.expressions.JSONPathSubscript'>: <function <lambda>>, <class 'sqlglot.expressions.AllowedValuesProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.AnalyzeColumns'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.AnalyzeWith'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ArrayContainsAll'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ArrayOverlaps'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.AutoRefreshProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.BackupProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.CaseSpecificColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Ceil'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.CharacterSetColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.CharacterSetProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ClusteredColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.CollateColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.CommentColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ConnectByRoot'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.CopyGrantsProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.DateFormatColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.DefaultColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.DynamicProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.EmptyProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.EncodeColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.EphemeralColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ExcludeColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ExecuteAsProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Except'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ExternalProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Floor'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.GlobalProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.HeapProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.IcebergProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.InheritsProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.InlineLengthColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.InputModelProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Intersect'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.IntervalSpan'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Int64'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.LanguageProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.LocationProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.LogProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.MaterializedProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.NonClusteredColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.NoPrimaryIndexProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.NotForReplicationColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.OnCommitProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.OnProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.OnUpdateColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Operator'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.OutputModelProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.PathColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.PivotAny'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ProjectionPolicyColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.RemoteWithConnectionModelProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ReturnsProperty'>: <function _returnsproperty_sql>, <class 'sqlglot.expressions.SampleProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SecureProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SecurityProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SetConfigProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SetProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SettingsProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SharingProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SqlReadWriteProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SqlSecurityProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.StabilityProperty'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.Stream'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.StreamingTableProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.StrictProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.SwapTable'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.TemporaryProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Tags'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.TitleColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ToMap'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ToTableProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.TransformModelProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.TransientProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Union'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.UnloggedProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.UsingData'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.Uuid'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.UppercaseColumnConstraint'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.VarMap'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ViewAttributeProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.VolatileProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.WithJournalTableProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.WithProcedureOptions'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.WithSchemaBindingProperty'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.WithOperator'>: <function Generator.<lambda>>, <class 'sqlglot.expressions.ApproxDistinct'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.ArgMax'>: <function arg_max_or_min_no_count.<locals>._arg_max_or_min_sql>, <class 'sqlglot.expressions.ArgMin'>: <function arg_max_or_min_no_count.<locals>._arg_max_or_min_sql>, <class 'sqlglot.expressions.Array'>: <function inline_array_unless_query>, <class 'sqlglot.expressions.ArrayContains'>: <function _array_contains_sql>, <class 'sqlglot.expressions.ArrayFilter'>: <function filter_array_using_unnest>, <class 'sqlglot.expressions.Cast'>: <function preprocess.<locals>._to_sql>, <class 'sqlglot.expressions.CollateProperty'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.Commit'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.CountIf'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.Create'>: <function _create_sql>, <class 'sqlglot.expressions.CTE'>: <function preprocess.<locals>._to_sql>, <class 'sqlglot.expressions.DateAdd'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.DateDiff'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.DateFromParts'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.DateStrToDate'>: <function datestrtodate_sql>, <class 'sqlglot.expressions.DateSub'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.DatetimeAdd'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.DatetimeSub'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.DateTrunc'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.FromTimeZone'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.GenerateSeries'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.GroupConcat'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.Hex'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.If'>: <function if_sql.<locals>._if_sql>, <class 'sqlglot.expressions.ILike'>: <function no_ilike_sql>, <class 'sqlglot.expressions.IntDiv'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.JSONExtract'>: <function _json_extract_sql>, <class 'sqlglot.expressions.JSONExtractArray'>: <function _json_extract_sql>, <class 'sqlglot.expressions.JSONExtractScalar'>: <function _json_extract_sql>, <class 'sqlglot.expressions.JSONFormat'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.Levenshtein'>: <function _levenshtein_sql>, <class 'sqlglot.expressions.Max'>: <function max_or_greatest>, <class 'sqlglot.expressions.MD5'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.MD5Digest'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.Min'>: <function min_or_least>, <class 'sqlglot.expressions.PartitionedByProperty'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.RegexpExtract'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.RegexpExtractAll'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.RegexpReplace'>: <function regexp_replace_sql>, <class 'sqlglot.expressions.RegexpLike'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.Rollback'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.Select'>: <function preprocess.<locals>._to_sql>, <class 'sqlglot.expressions.SHA'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.SHA2'>: <function sha256_sql>, <class 'sqlglot.expressions.String'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.StrPosition'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.StrToDate'>: <function _str_to_datetime_sql>, <class 'sqlglot.expressions.StrToTime'>: <function _str_to_datetime_sql>, <class 'sqlglot.expressions.TimeAdd'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.TimeFromParts'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.TimestampFromParts'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.TimeSub'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.TimestampAdd'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.TimestampDiff'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.TimestampSub'>: <function date_add_interval_sql.<locals>.func>, <class 'sqlglot.expressions.TimeStrToTime'>: <function timestrtotime_sql>, <class 'sqlglot.expressions.Transaction'>: <function BigQuery.Generator.<lambda>>, <class 'sqlglot.expressions.TsOrDsAdd'>: <function _ts_or_ds_add_sql>, <class 'sqlglot.expressions.TsOrDsDiff'>: <function _ts_or_ds_diff_sql>, <class 'sqlglot.expressions.TsOrDsToTime'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.TsOrDsToDatetime'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.TsOrDsToTimestamp'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.Unhex'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.UnixDate'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.UnixToTime'>: <function _unix_to_time_sql>, <class 'sqlglot.expressions.Values'>: <function _derived_table_values_to_unnest>, <class 'sqlglot.expressions.VariancePop'>: <function rename_func.<locals>.<lambda>>, <class 'sqlglot.expressions.SafeDivide'>: <function rename_func.<locals>.<lambda>>}
SUPPORTED_JSON_PATH_PARTS = {<class 'sqlglot.expressions.JSONPathSubscript'>, <class 'sqlglot.expressions.JSONPathKey'>, <class 'sqlglot.expressions.JSONPathRoot'>}
TYPE_MAPPING = {<Type.DATETIME2: 'DATETIME2'>: 'TIMESTAMP', <Type.NCHAR: 'NCHAR'>: 'STRING', <Type.NVARCHAR: 'NVARCHAR'>: 'STRING', <Type.MEDIUMTEXT: 'MEDIUMTEXT'>: 'TEXT', <Type.LONGTEXT: 'LONGTEXT'>: 'TEXT', <Type.TINYTEXT: 'TINYTEXT'>: 'TEXT', <Type.MEDIUMBLOB: 'MEDIUMBLOB'>: 'BLOB', <Type.LONGBLOB: 'LONGBLOB'>: 'BLOB', <Type.TINYBLOB: 'TINYBLOB'>: 'BLOB', <Type.INET: 'INET'>: 'INET', <Type.ROWVERSION: 'ROWVERSION'>: 'BYTES', <Type.SMALLDATETIME: 'SMALLDATETIME'>: 'TIMESTAMP', <Type.BIGDECIMAL: 'BIGDECIMAL'>: 'BIGNUMERIC', <Type.BIGINT: 'BIGINT'>: 'INT64', <Type.BINARY: 'BINARY'>: 'BYTES', <Type.BOOLEAN: 'BOOLEAN'>: 'BOOL', <Type.CHAR: 'CHAR'>: 'STRING', <Type.DECIMAL: 'DECIMAL'>: 'NUMERIC', <Type.DOUBLE: 'DOUBLE'>: 'FLOAT64', <Type.FLOAT: 'FLOAT'>: 'FLOAT64', <Type.INT: 'INT'>: 'INT64', <Type.SMALLINT: 'SMALLINT'>: 'INT64', <Type.TEXT: 'TEXT'>: 'STRING', <Type.TIMESTAMP: 'TIMESTAMP'>: 'DATETIME', <Type.TIMESTAMPTZ: 'TIMESTAMPTZ'>: 'TIMESTAMP', <Type.TIMESTAMPLTZ: 'TIMESTAMPLTZ'>: 'TIMESTAMP', <Type.TINYINT: 'TINYINT'>: 'INT64', <Type.UUID: 'UUID'>: 'STRING', <Type.VARBINARY: 'VARBINARY'>: 'BYTES', <Type.VARCHAR: 'VARCHAR'>: 'STRING', <Type.VARIANT: 'VARIANT'>: 'ANY TYPE'}
PROPERTIES_LOCATION = {<class 'sqlglot.expressions.AllowedValuesProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.AlgorithmProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.AutoIncrementProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.AutoRefreshProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.BackupProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.BlockCompressionProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.CharacterSetProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.ChecksumProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.CollateProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.CopyGrantsProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.Cluster'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.ClusteredByProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DistributedByProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DuplicateKeyProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DataBlocksizeProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.DataDeletionProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DefinerProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.DictRange'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DictProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DynamicProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.DistKeyProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.DistStyleProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.EmptyProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.EncodeProperty'>: <Location.POST_EXPRESSION: 'POST_EXPRESSION'>, <class 'sqlglot.expressions.EngineProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.ExecuteAsProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.ExternalProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.FallbackProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.FileFormatProperty'>: <Location.POST_WITH: 'POST_WITH'>, <class 'sqlglot.expressions.FreespaceProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.GlobalProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.HeapProperty'>: <Location.POST_WITH: 'POST_WITH'>, <class 'sqlglot.expressions.InheritsProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.IcebergProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.IncludeProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.InputModelProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.IsolatedLoadingProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.JournalProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.LanguageProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.LikeProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.LocationProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.LockProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.LockingProperty'>: <Location.POST_ALIAS: 'POST_ALIAS'>, <class 'sqlglot.expressions.LogProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.MaterializedProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.MergeBlockRatioProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.NoPrimaryIndexProperty'>: <Location.POST_EXPRESSION: 'POST_EXPRESSION'>, <class 'sqlglot.expressions.OnProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.OnCommitProperty'>: <Location.POST_EXPRESSION: 'POST_EXPRESSION'>, <class 'sqlglot.expressions.Order'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.OutputModelProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.PartitionedByProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.PartitionedOfProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.PrimaryKey'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.Property'>: <Location.POST_WITH: 'POST_WITH'>, <class 'sqlglot.expressions.RemoteWithConnectionModelProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.ReturnsProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.RowFormatProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.RowFormatDelimitedProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.RowFormatSerdeProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SampleProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SchemaCommentProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SecureProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.SecurityProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SerdeProperties'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.Set'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SettingsProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SetProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.SetConfigProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SharingProperty'>: <Location.POST_EXPRESSION: 'POST_EXPRESSION'>, <class 'sqlglot.expressions.SequenceProperties'>: <Location.POST_EXPRESSION: 'POST_EXPRESSION'>, <class 'sqlglot.expressions.SortKeyProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SqlReadWriteProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.SqlSecurityProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.StabilityProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.StreamingTableProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.StrictProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.Tags'>: <Location.POST_WITH: 'POST_WITH'>, <class 'sqlglot.expressions.TemporaryProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.ToTableProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.TransientProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.TransformModelProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.MergeTreeTTL'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.UnloggedProperty'>: <Location.POST_CREATE: 'POST_CREATE'>, <class 'sqlglot.expressions.ViewAttributeProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.VolatileProperty'>: <Location.UNSUPPORTED: 'UNSUPPORTED'>, <class 'sqlglot.expressions.WithDataProperty'>: <Location.POST_EXPRESSION: 'POST_EXPRESSION'>, <class 'sqlglot.expressions.WithJournalTableProperty'>: <Location.POST_NAME: 'POST_NAME'>, <class 'sqlglot.expressions.WithProcedureOptions'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.WithSchemaBindingProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>, <class 'sqlglot.expressions.WithSystemVersioningProperty'>: <Location.POST_SCHEMA: 'POST_SCHEMA'>}
AFTER_HAVING_MODIFIER_TRANSFORMS = {'qualify': <function Generator.<lambda>>, 'windows': <function Generator.<lambda>>}
RESERVED_KEYWORDS = {'asc', 'with', 'respect', 'intersect', 'hash', 'at', 'as', 'else', 'interval', 'ignore', 'null', 'new', 'unnest', 'into', 'and', 'all', 'select', 'exclude', 'some', 'of', 'using', 'inner', 'tablesample', 'any', 'natural', 'collate', 'from', 'like', 'having', 'then', 'cube', 'array', 'fetch', 'lateral', 'contains', 'limit', 'by', 'within', 'right', 'escape', 'proto', 'default', 'outer', 'between', 'set', 'rollup', 'struct', 'when', 'false', 'in', 'union', 'join', 'distinct', 'nulls', 'where', 'true', 'rows', 'left', 'on', 'merge', 'treat', 'no', 'enum', 'exists', 'or', 'qualify', 'for', 'assert_rows_modified', 'create', 'if', 'group', 'window', 'order', 'is', 'extract', 'full', 'to', 'current', 'except', 'case', 'unbounded', 'define', 'over', 'lookup', 'recursive', 'preceding', 'not', 'range', 'desc', 'groups', 'following', 'cast', 'cross', 'end', 'partition', 'grouping'}
def mod_sql(self, expression: sqlglot.expressions.Mod) -> str: View Source

    1113        def mod_sql(self, expression: exp.Mod) -> str:
    1114            this = expression.this
    1115            expr = expression.expression
    1116            return self.func(
    1117                "MOD",
    1118                this.unnest() if isinstance(this, exp.Paren) else this,
    1119                expr.unnest() if isinstance(expr, exp.Paren) else expr,
    1120            )

def column_parts(self, expression: sqlglot.expressions.Column) -> str: View Source

    1122        def column_parts(self, expression: exp.Column) -> str:
    1123            if expression.meta.get("quoted_column"):
    1124                # If a column reference is of the form `dataset.table`.name, we need
    1125                # to preserve the quoted table path, otherwise the reference breaks
    1126                table_parts = ".".join(p.name for p in expression.parts[:-1])
    1127                table_path = self.sql(exp.Identifier(this=table_parts, quoted=True))
    1128                return f"{table_path}.{self.sql(expression, 'this')}"
    1129
    1130            return super().column_parts(expression)

def table_parts(self, expression: sqlglot.expressions.Table) -> str: View Source

    1132        def table_parts(self, expression: exp.Table) -> str:
    1133            # Depending on the context, `x.y` may not resolve to the same data source as `x`.`y`, so
    1134            # we need to make sure the correct quoting is used in each case.
    1135            #
    1136            # For example, if there is a CTE x that clashes with a schema name, then the former will
    1137            # return the table y in that schema, whereas the latter will return the CTE's y column:
    1138            #
    1139            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x.y`   -> cross join
    1140            # - WITH x AS (SELECT [1, 2] AS y) SELECT * FROM x, `x`.`y` -> implicit unnest
    1141            if expression.meta.get("quoted_table"):
    1142                table_parts = ".".join(p.name for p in expression.parts)
    1143                return self.sql(exp.Identifier(this=table_parts, quoted=True))
    1144
    1145            return super().table_parts(expression)

def timetostr_sql(self, expression: sqlglot.expressions.TimeToStr) -> str: View Source

    1147        def timetostr_sql(self, expression: exp.TimeToStr) -> str:
    1148            this = expression.this
    1149            if isinstance(this, exp.TsOrDsToDatetime):
    1150                func_name = "FORMAT_DATETIME"
    1151            elif isinstance(this, exp.TsOrDsToTimestamp):
    1152                func_name = "FORMAT_TIMESTAMP"
    1153            else:
    1154                func_name = "FORMAT_DATE"
    1155
    1156            time_expr = (
    1157                this
    1158                if isinstance(this, (exp.TsOrDsToDatetime, exp.TsOrDsToTimestamp, exp.TsOrDsToDate))
    1159                else expression
    1160            )
    1161            return self.func(func_name, self.format_time(expression), time_expr.this)

def eq_sql(self, expression: sqlglot.expressions.EQ) -> str: View Source

    1163        def eq_sql(self, expression: exp.EQ) -> str:
    1164            # Operands of = cannot be NULL in BigQuery
    1165            if isinstance(expression.left, exp.Null) or isinstance(expression.right, exp.Null):
    1166                if not isinstance(expression.parent, exp.Update):
    1167                    return "NULL"
    1168
    1169            return self.binary(expression, "=")

def attimezone_sql(self, expression: sqlglot.expressions.AtTimeZone) -> str: View Source

    1171        def attimezone_sql(self, expression: exp.AtTimeZone) -> str:
    1172            parent = expression.parent
    1173
    1174            # BigQuery allows CAST(.. AS {STRING|TIMESTAMP} [FORMAT <fmt> [AT TIME ZONE <tz>]]).
    1175            # Only the TIMESTAMP one should use the below conversion, when AT TIME ZONE is included.
    1176            if not isinstance(parent, exp.Cast) or not parent.to.is_type("text"):
    1177                return self.func(
    1178                    "TIMESTAMP", self.func("DATETIME", expression.this, expression.args.get("zone"))
    1179                )
    1180
    1181            return super().attimezone_sql(expression)

def trycast_sql(self, expression: sqlglot.expressions.TryCast) -> str: View Source

    1183        def trycast_sql(self, expression: exp.TryCast) -> str:
    1184            return self.cast_sql(expression, safe_prefix="SAFE_")

def bracket_sql(self, expression: sqlglot.expressions.Bracket) -> str: View Source

    1186        def bracket_sql(self, expression: exp.Bracket) -> str:
    1187            this = expression.this
    1188            expressions = expression.expressions
    1189
    1190            if len(expressions) == 1 and this and this.is_type(exp.DataType.Type.STRUCT):
    1191                arg = expressions[0]
    1192                if arg.type is None:
    1193                    from sqlglot.optimizer.annotate_types import annotate_types
    1194
    1195                    arg = annotate_types(arg)
    1196
    1197                if arg.type and arg.type.this in exp.DataType.TEXT_TYPES:
    1198                    # BQ doesn't support bracket syntax with string values for structs
    1199                    return f"{self.sql(this)}.{arg.name}"
    1200
    1201            expressions_sql = self.expressions(expression, flat=True)
    1202            offset = expression.args.get("offset")
    1203
    1204            if offset == 0:
    1205                expressions_sql = f"OFFSET({expressions_sql})"
    1206            elif offset == 1:
    1207                expressions_sql = f"ORDINAL({expressions_sql})"
    1208            elif offset is not None:
    1209                self.unsupported(f"Unsupported array offset: {offset}")
    1210
    1211            if expression.args.get("safe"):
    1212                expressions_sql = f"SAFE_{expressions_sql}"
    1213
    1214            return f"{self.sql(this)}[{expressions_sql}]"

def in_unnest_op(self, expression: sqlglot.expressions.Unnest) -> str: View Source

    1216        def in_unnest_op(self, expression: exp.Unnest) -> str:
    1217            return self.sql(expression)

def version_sql(self, expression: sqlglot.expressions.Version) -> str: View Source

    1219        def version_sql(self, expression: exp.Version) -> str:
    1220            if expression.name == "TIMESTAMP":
    1221                expression.set("this", "SYSTEM_TIME")
    1222            return super().version_sql(expression)

def contains_sql(self, expression: sqlglot.expressions.Contains) -> str: View Source

    1224        def contains_sql(self, expression: exp.Contains) -> str:
    1225            this = expression.this
    1226            expr = expression.expression
    1227
    1228            if isinstance(this, exp.Lower) and isinstance(expr, exp.Lower):
    1229                this = this.this
    1230                expr = expr.this
    1231
    1232            return self.func("CONTAINS_SUBSTR", this, expr)

TRY_SUPPORTED = False
SUPPORTS_UESCAPE = False

##### Inherited Members

sqlglot.generator.Generator
  Generator
  LOCKING_READS_SUPPORTED
  WRAP_DERIVED_VALUES
  CREATE_FUNCTION_RETURN_AS
  MATCHED_BY_SOURCE
  SINGLE_STRING_INTERVAL
  GROUPINGS_SEP
  INDEX_ON
  QUERY_HINT_SEP
  IS_BOOL_ALLOWED
  DUPLICATE_KEY_UPDATE_WITH_SET
  LIMIT_IS_TOP
  RETURNING_END
  EXTRACT_ALLOWS_QUOTES
  TZ_TO_WITH_TIME_ZONE
  SELECT_KINDS
  VALUES_AS_TABLE
  ALTER_TABLE_INCLUDE_COLUMN_KEYWORD
  AGGREGATE_FILTER_SUPPORTED
  SEMI_ANTI_JOIN_WITH_SIDE
  COMPUTED_COLUMN_WITH_TYPE
  SUPPORTS_TABLE_COPY
  TABLESAMPLE_REQUIRES_PARENS
  TABLESAMPLE_SIZE_IS_ROWS
  TABLESAMPLE_KEYWORDS
  TABLESAMPLE_WITH_METHOD
  TABLESAMPLE_SEED_KEYWORD
  DATA_TYPE_SPECIFIERS_ALLOWED
  ENSURE_BOOLS
  CTE_RECURSIVE_KEYWORD_REQUIRED
  SUPPORTS_SINGLE_ARG_CONCAT
  LAST_DAY_SUPPORTS_DATE_PART
  INSERT_OVERWRITE
  SUPPORTS_SELECT_INTO
  SUPPORTS_UNLOGGED_TABLES
  SUPPORTS_CREATE_TABLE_LIKE
  LIKE_PROPERTY_INSIDE_SCHEMA
  MULTI_ARG_DISTINCT
  JSON_TYPE_REQUIRED_FOR_EXTRACTION
  JSON_PATH_BRACKETED_KEY_SUPPORTED
  SET_OP_MODIFIERS
  COPY_PARAMS_ARE_WRAPPED
  COPY_PARAMS_EQ_REQUIRED
  COPY_HAS_INTO_KEYWORD
  STAR_EXCEPT
  QUOTE_JSON_PATH
  PAD_FILL_PATTERN_IS_REQUIRED
  ARRAY_CONCAT_IS_VAR_LEN
  SUPPORTS_CONVERT_TIMEZONE
  SUPPORTS_MEDIAN
  PARSE_JSON_NAME
  ARRAY_SIZE_NAME
  ARRAY_SIZE_DIM_REQUIRED
  TIME_PART_SINGULARS
  TOKEN_MAPPING
  STRUCT_DELIMITER
  PARAMETER_TOKEN
  EXPRESSION_PRECEDES_PROPERTIES_CREATABLES
  WITH_SEPARATED_COMMENTS
  EXCLUDE_COMMENTS
  UNWRAPPED_INTERVAL_VALUES
  PARAMETERIZABLE_TEXT_TYPES
  EXPRESSIONS_WITHOUT_NESTED_CTES
  SENTINEL_LINE_BREAK
  pretty
  identify
  normalize
  pad
  unsupported_level
  max_unsupported
  leading_comma
  max_text_width
  comments
  dialect
  normalize_functions
  unsupported_messages
  generate
  preprocess
  unsupported
  sep
  seg
  pad_comment
  maybe_comment
  wrap
  no_identify
  normalize_func
  indent
  sql
  uncache_sql
  cache_sql
  characterset_sql
  column_sql
  columnposition_sql
  columndef_sql
  columnconstraint_sql
  computedcolumnconstraint_sql
  autoincrementcolumnconstraint_sql
  compresscolumnconstraint_sql
  generatedasidentitycolumnconstraint_sql
  generatedasrowcolumnconstraint_sql
  periodforsystemtimeconstraint_sql
  notnullcolumnconstraint_sql
  transformcolumnconstraint_sql
  primarykeycolumnconstraint_sql
  uniquecolumnconstraint_sql
  createable_sql
  create_sql
  sequenceproperties_sql
  clone_sql
  describe_sql
  heredoc_sql
  prepend_ctes
  with_sql
  cte_sql
  tablealias_sql
  bitstring_sql
  hexstring_sql
  bytestring_sql
  unicodestring_sql
  rawstring_sql
  datatypeparam_sql
  datatype_sql
  directory_sql
  delete_sql
  drop_sql
  set_operation
  set_operations
  fetch_sql
  filter_sql
  hint_sql
  indexparameters_sql
  index_sql
  identifier_sql
  hex_sql
  lowerhex_sql
  inputoutputformat_sql
  national_sql
  partition_sql
  properties_sql
  root_properties
  properties
  with_properties
  locate_properties
  property_name
  property_sql
  likeproperty_sql
  fallbackproperty_sql
  journalproperty_sql
  freespaceproperty_sql
  checksumproperty_sql
  mergeblockratioproperty_sql
  datablocksizeproperty_sql
  blockcompressionproperty_sql
  isolatedloadingproperty_sql
  partitionboundspec_sql
  partitionedofproperty_sql
  lockingproperty_sql
  withdataproperty_sql
  withsystemversioningproperty_sql
  insert_sql
  introducer_sql
  kill_sql
  pseudotype_sql
  objectidentifier_sql
  onconflict_sql
  returning_sql
  rowformatdelimitedproperty_sql
  withtablehint_sql
  indextablehint_sql
  historicaldata_sql
  table_sql
  tablesample_sql
  pivot_sql
  tuple_sql
  update_sql
  values_sql
  var_sql
  into_sql
  from_sql
  groupingsets_sql
  rollup_sql
  cube_sql
  group_sql
  having_sql
  connect_sql
  prior_sql
  join_sql
  lambda_sql
  lateral_op
  lateral_sql
  limit_sql
  offset_sql
  setitem_sql
  set_sql
  pragma_sql
  lock_sql
  literal_sql
  escape_str
  loaddata_sql
  null_sql
  boolean_sql
  order_sql
  withfill_sql
  cluster_sql
  distribute_sql
  sort_sql
  ordered_sql
  matchrecognizemeasure_sql
  matchrecognize_sql
  query_modifiers
  options_modifier
  queryoption_sql
  offset_limit_modifiers
  after_limit_modifiers
  select_sql
  schema_sql
  schema_columns_sql
  star_sql
  parameter_sql
  sessionparameter_sql
  placeholder_sql
  subquery_sql
  qualify_sql
  unnest_sql
  prewhere_sql
  where_sql
  window_sql
  partition_by_sql
  windowspec_sql
  withingroup_sql
  between_sql
  bracket_offset_expressions
  all_sql
  any_sql
  exists_sql
  case_sql
  constraint_sql
  nextvaluefor_sql
  extract_sql
  trim_sql
  convert_concat_args
  concat_sql
  concatws_sql
  check_sql
  foreignkey_sql
  primarykey_sql
  if_sql
  matchagainst_sql
  jsonkeyvalue_sql
  jsonpath_sql
  json_path_part
  formatjson_sql
  jsonobject_sql
  jsonobjectagg_sql
  jsonarray_sql
  jsonarrayagg_sql
  jsoncolumndef_sql
  jsonschema_sql
  jsontable_sql
  openjsoncolumndef_sql
  openjson_sql
  in_sql
  interval_sql
  return_sql
  reference_sql
  anonymous_sql
  paren_sql
  neg_sql
  not_sql
  alias_sql
  pivotalias_sql
  aliases_sql
  atindex_sql
  fromtimezone_sql
  add_sql
  and_sql
  or_sql
  xor_sql
  connector_sql
  bitwiseand_sql
  bitwiseleftshift_sql
  bitwisenot_sql
  bitwiseor_sql
  bitwiserightshift_sql
  bitwisexor_sql
  cast_sql
  currentdate_sql
  collate_sql
  command_sql
  comment_sql
  mergetreettlaction_sql
  mergetreettl_sql
  transaction_sql
  commit_sql
  rollback_sql
  altercolumn_sql
  alterdiststyle_sql
  altersortkey_sql
  alterrename_sql
  renamecolumn_sql
  alterset_sql
  alter_sql
  add_column_sql
  droppartition_sql
  addconstraint_sql
  distinct_sql
  ignorenulls_sql
  respectnulls_sql
  havingmax_sql
  intdiv_sql
  dpipe_sql
  div_sql
  safedivide_sql
  overlaps_sql
  distance_sql
  dot_sql
  propertyeq_sql
  escape_sql
  glob_sql
  gt_sql
  gte_sql
  ilike_sql
  ilikeany_sql
  is_sql
  like_sql
  likeany_sql
  similarto_sql
  lt_sql
  lte_sql
  mul_sql
  neq_sql
  nullsafeeq_sql
  nullsafeneq_sql
  slice_sql
  sub_sql
  try_sql
  log_sql
  use_sql
  binary
  ceil_floor
  function_fallback_sql
  func
  format_args
  too_wide
  format_time
  expressions
  op_expressions
  naked_property
  tag_sql
  token_sql
  userdefinedfunction_sql
  joinhint_sql
  kwarg_sql
  when_sql
  whens_sql
  merge_sql
  tochar_sql
  tonumber_sql
  dictproperty_sql
  dictrange_sql
  dictsubproperty_sql
  duplicatekeyproperty_sql
  uniquekeyproperty_sql
  distributedbyproperty_sql
  oncluster_sql
  clusteredbyproperty_sql
  anyvalue_sql
  querytransform_sql
  indexconstraintoption_sql
  checkcolumnconstraint_sql
  indexcolumnconstraint_sql
  nvl2_sql
  comprehension_sql
  columnprefix_sql
  opclass_sql
  predict_sql
  forin_sql
  refresh_sql
  toarray_sql
  tsordstotime_sql
  tsordstotimestamp_sql
  tsordstodatetime_sql
  tsordstodate_sql
  unixdate_sql
  lastday_sql
  dateadd_sql
  arrayany_sql
  struct_sql
  partitionrange_sql
  truncatetable_sql
  convert_sql
  copyparameter_sql
  credentials_sql
  copy_sql
  semicolon_sql
  datadeletionproperty_sql
  maskingpolicycolumnconstraint_sql
  gapfill_sql
  scope_resolution
  scoperesolution_sql
  parsejson_sql
  rand_sql
  changes_sql
  pad_sql
  summarize_sql
  explodinggenerateseries_sql
  arrayconcat_sql
  converttimezone_sql
  json_sql
  jsonvalue_sql
  conditionalinsert_sql
  multitableinserts_sql
  oncondition_sql
  jsonextractquote_sql
  jsonexists_sql
  arrayagg_sql
  apply_sql
  grant_sql
  grantprivilege_sql
  grantprincipal_sql
  columns_sql
  overlay_sql
  todouble_sql
  string_sql
  median_sql
  overflowtruncatebehavior_sql
  unixseconds_sql
  arraysize_sql
  attach_sql
  detach_sql
  attachoption_sql
  featuresattime_sql
  watermarkcolumnconstraint_sql
  encodeproperty_sql
  includeproperty_sql
  xmlelement_sql
  partitionbyrangeproperty_sql
  partitionbyrangepropertydynamic_sql
  unpivotcolumns_sql
  analyzesample_sql
  analyzestatistics_sql
  analyzehistogram_sql
  analyzedelete_sql
  analyzelistchainedrows_sql
  analyzevalidate_sql
  analyze_sql
  xmltable_sql
  xmlnamespace_sql