sql: add grammar for SHOW INSPECT ERRORS command

The command is added to view the results of data consistency validation
jobs.
This new statement requires new SQL grammar.
The grammar is added in this change and the implementations will be
added in future PRs.

Epic: CRDB-30356
Part of: #148272

Release note (sql change): Introduces the `SHOW INSPECT ERRORS`
statement that is unimplemented.

Author: bghal

docs/generated/sql/bnf/BUILD.bazel

@@ -264,6 +264,7 @@ FILES = [
     "show_keys",
     "show_locality",
     "show_locality_stmt",
+    "show_inspect_errors_stmt",
     "show_partitions_stmt",
     "show_range_for_row_stmt",
     "show_ranges_stmt",

docs/generated/sql/bnf/create_changefeed_stmt.bnf

@@ -1,9 +1,9 @@
 create_changefeed_stmt ::=
-	'CREATE' 'CHANGEFEED' 'FOR' changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option '=' value ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
-	| 'CREATE' 'CHANGEFEED' 'FOR' changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
-	| 'CREATE' 'CHANGEFEED' 'FOR' changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option '=' value ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
-	| 'CREATE' 'CHANGEFEED' 'FOR' changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
-	| 'CREATE' 'CHANGEFEED' 'FOR' changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 
+	'CREATE' 'CHANGEFEED' for_with_lookahead_variants changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option '=' value ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
+	| 'CREATE' 'CHANGEFEED' for_with_lookahead_variants changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
+	| 'CREATE' 'CHANGEFEED' for_with_lookahead_variants changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option '=' value ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
+	| 'CREATE' 'CHANGEFEED' for_with_lookahead_variants changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 'WITH' option ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
+	| 'CREATE' 'CHANGEFEED' for_with_lookahead_variants changefeed_table_target ( ( ',' changefeed_table_target ) )* 'INTO' sink 
 	| 'CREATE_CHANGEFEED_FOR_DATABASE' 'CHANGEFEED' 'FOR' 'DATABASE' database_option db_level_changefeed_filter_option 'INTO' sink 'WITH' option '=' value ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
 	| 'CREATE_CHANGEFEED_FOR_DATABASE' 'CHANGEFEED' 'FOR' 'DATABASE' database_option db_level_changefeed_filter_option 'INTO' sink 'WITH' option ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*
 	| 'CREATE_CHANGEFEED_FOR_DATABASE' 'CHANGEFEED' 'FOR' 'DATABASE' database_option db_level_changefeed_filter_option 'INTO' sink 'WITH' option '=' value ( ( ',' ( option '=' value | option | option '=' value | option ) ) )*

docs/generated/sql/bnf/declare_cursor_stmt.bnf

@@ -1,4 +1,4 @@
 declare_cursor_stmt ::=
-	'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR' 'WITH' 'HOLD' 'FOR' select_stmt
-	| 'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR' 'WITHOUT' 'HOLD' 'FOR' select_stmt
-	| 'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR'  'FOR' select_stmt
+	'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR' 'WITH' 'HOLD' for_with_lookahead_variants select_stmt
+	| 'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR' 'WITHOUT' 'HOLD' for_with_lookahead_variants select_stmt
+	| 'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR'  for_with_lookahead_variants select_stmt

docs/generated/sql/bnf/show_inspect_errors_stmt.bnf

@@ -0,0 +1,2 @@
+show_inspect_errors_stmt ::=
+	'SHOW' 'INSPECT' 'ERRORS' opt_for_table_clause opt_for_job_clause opt_with_details

docs/generated/sql/bnf/show_stats.bnf

@@ -1,2 +1,2 @@
 show_stats_stmt ::=
-	'SHOW' 'STATISTICS' 'FOR' 'TABLE' table_name opt_with_options
+	'SHOW' 'STATISTICS' 'FOR_TABLE' 'TABLE' table_name opt_with_options

docs/generated/sql/bnf/show_var.bnf

@@ -39,3 +39,4 @@ show_stmt ::=
 	| show_zone_stmt
 	| show_full_scans_stmt
 	| show_default_privileges_stmt
+	| show_inspect_errors_stmt

docs/generated/sql/bnf/stmt_block.bnf

@@ -171,7 +171,7 @@ close_cursor_stmt ::=
 	| 'CLOSE' cursor_name
 
 declare_cursor_stmt ::=
-	'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR' opt_hold 'FOR' select_stmt
+	'DECLARE' cursor_name opt_binary opt_sensitivity opt_scroll 'CURSOR' opt_hold for_with_lookahead_variants select_stmt
 
 fetch_cursor_stmt ::=
 	'FETCH' cursor_movement_specifier
@@ -328,6 +328,7 @@ show_stmt ::=
 	| show_zone_stmt
 	| show_full_scans_stmt
 	| show_default_privileges_stmt
+	| show_inspect_errors_stmt
 
 truncate_stmt ::=
 	'TRUNCATE' opt_table relation_expr_list opt_drop_behavior
@@ -527,6 +528,10 @@ opt_hold ::=
 	| 'WITHOUT' 'HOLD'
 	| 
 
+for_with_lookahead_variants ::=
+	'FOR'
+	| 'FOR_TABLE'
+
 cursor_movement_specifier ::=
 	cursor_name
 	| from_or_in cursor_name
@@ -642,7 +647,7 @@ create_stats_stmt ::=
 	'CREATE' 'STATISTICS' statistics_name opt_stats_columns 'FROM' create_stats_target opt_create_stats_options
 
 create_changefeed_stmt ::=
-	'CREATE' 'CHANGEFEED' 'FOR' changefeed_table_targets opt_changefeed_sink opt_with_options
+	'CREATE' 'CHANGEFEED' for_with_lookahead_variants changefeed_table_targets opt_changefeed_sink opt_with_options
 	| 'CREATE_CHANGEFEED_FOR_DATABASE' 'CHANGEFEED' 'FOR' 'DATABASE' database_name db_level_changefeed_filter_option opt_changefeed_sink opt_with_options
 	| 'CREATE' 'CHANGEFEED' opt_changefeed_sink opt_with_options 'AS' 'SELECT' target_list 'FROM' changefeed_target_expr opt_where_clause
 
@@ -998,7 +1003,7 @@ show_sessions_stmt ::=
 	| 'SHOW' 'ALL' opt_cluster 'SESSIONS'
 
 show_stats_stmt ::=
-	'SHOW' 'STATISTICS' 'FOR' 'TABLE' table_name opt_with_options
+	'SHOW' 'STATISTICS' 'FOR_TABLE' 'TABLE' table_name opt_with_options
 
 show_tables_stmt ::=
 	'SHOW' 'TABLES' 'FROM' name '.' name with_comment
@@ -1043,6 +1048,9 @@ show_default_privileges_stmt ::=
 	| 'SHOW' 'DEFAULT' 'PRIVILEGES' 'FOR' 'GRANTEE' role_spec_list opt_in_schema
 	| 'SHOW' 'DEFAULT' 'PRIVILEGES' 'FOR' 'ALL' 'ROLES' opt_in_schema
 
+show_inspect_errors_stmt ::=
+	'SHOW' 'INSPECT' 'ERRORS' opt_for_table_clause opt_for_job_clause opt_with_details
+
 opt_table ::=
 	'TABLE'
 	| 
@@ -1201,6 +1209,7 @@ unreserved_keyword ::=
 	| 'ENCRYPTION_INFO_DIR'
 	| 'ENUM'
 	| 'ENUMS'
+	| 'ERRORS'
 	| 'ESCAPE'
 	| 'EXCLUDE'
 	| 'EXCLUDING'
@@ -1459,6 +1468,7 @@ unreserved_keyword ::=
 	| 'ROUTINES'
 	| 'ROWS'
 	| 'RULE'
+	| 'RUN'
 	| 'RUNNING'
 	| 'SCHEDULE'
 	| 'SCHEDULES'
@@ -2214,6 +2224,18 @@ opt_in_schema ::=
 	'IN' 'SCHEMA' schema_name
 	| 
 
+opt_for_table_clause ::=
+	'FOR_TABLE' 'TABLE' table_name
+	| 
+
+opt_for_job_clause ::=
+	'FOR_JOB' 'JOB' iconst64
+	| 
+
+opt_with_details ::=
+	'WITH' 'DETAILS'
+	| 
+
 relation_expr ::=
 	table_name
 	| table_name '*'
@@ -4111,6 +4133,7 @@ bare_label_keywords ::=
 	| 'END'
 	| 'ENUM'
 	| 'ENUMS'
+	| 'ERRORS'
 	| 'ESCAPE'
 	| 'EXCLUDE'
 	| 'EXCLUDING'
@@ -4421,6 +4444,7 @@ bare_label_keywords ::=
 	| 'ROW'
 	| 'ROWS'
 	| 'RULE'
+	| 'RUN'
 	| 'RUNNING'
 	| 'SAVEPOINT'
 	| 'SCANS'