pyspiral 0.6.8__cp312-abi3-manylinux_2_28_aarch64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. pyspiral-0.6.8.dist-info/METADATA +51 -0
  2. pyspiral-0.6.8.dist-info/RECORD +102 -0
  3. pyspiral-0.6.8.dist-info/WHEEL +4 -0
  4. pyspiral-0.6.8.dist-info/entry_points.txt +2 -0
  5. spiral/__init__.py +35 -0
  6. spiral/_lib.abi3.so +0 -0
  7. spiral/adbc.py +411 -0
  8. spiral/api/__init__.py +78 -0
  9. spiral/api/admin.py +15 -0
  10. spiral/api/client.py +164 -0
  11. spiral/api/filesystems.py +134 -0
  12. spiral/api/key_space_indexes.py +23 -0
  13. spiral/api/organizations.py +77 -0
  14. spiral/api/projects.py +219 -0
  15. spiral/api/telemetry.py +19 -0
  16. spiral/api/text_indexes.py +56 -0
  17. spiral/api/types.py +22 -0
  18. spiral/api/workers.py +40 -0
  19. spiral/api/workloads.py +52 -0
  20. spiral/arrow_.py +216 -0
  21. spiral/cli/__init__.py +88 -0
  22. spiral/cli/__main__.py +4 -0
  23. spiral/cli/admin.py +14 -0
  24. spiral/cli/app.py +104 -0
  25. spiral/cli/console.py +95 -0
  26. spiral/cli/fs.py +76 -0
  27. spiral/cli/iceberg.py +97 -0
  28. spiral/cli/key_spaces.py +89 -0
  29. spiral/cli/login.py +24 -0
  30. spiral/cli/orgs.py +89 -0
  31. spiral/cli/printer.py +53 -0
  32. spiral/cli/projects.py +147 -0
  33. spiral/cli/state.py +5 -0
  34. spiral/cli/tables.py +174 -0
  35. spiral/cli/telemetry.py +17 -0
  36. spiral/cli/text.py +115 -0
  37. spiral/cli/types.py +50 -0
  38. spiral/cli/workloads.py +58 -0
  39. spiral/client.py +178 -0
  40. spiral/core/__init__.pyi +0 -0
  41. spiral/core/_tools/__init__.pyi +5 -0
  42. spiral/core/authn/__init__.pyi +27 -0
  43. spiral/core/client/__init__.pyi +237 -0
  44. spiral/core/table/__init__.pyi +101 -0
  45. spiral/core/table/manifests/__init__.pyi +35 -0
  46. spiral/core/table/metastore/__init__.pyi +58 -0
  47. spiral/core/table/spec/__init__.pyi +213 -0
  48. spiral/dataloader.py +285 -0
  49. spiral/dataset.py +255 -0
  50. spiral/datetime_.py +27 -0
  51. spiral/debug/__init__.py +0 -0
  52. spiral/debug/manifests.py +87 -0
  53. spiral/debug/metrics.py +56 -0
  54. spiral/debug/scan.py +266 -0
  55. spiral/expressions/__init__.py +276 -0
  56. spiral/expressions/base.py +157 -0
  57. spiral/expressions/http.py +86 -0
  58. spiral/expressions/io.py +100 -0
  59. spiral/expressions/list_.py +68 -0
  60. spiral/expressions/mp4.py +62 -0
  61. spiral/expressions/png.py +18 -0
  62. spiral/expressions/qoi.py +18 -0
  63. spiral/expressions/refs.py +58 -0
  64. spiral/expressions/str_.py +39 -0
  65. spiral/expressions/struct.py +59 -0
  66. spiral/expressions/text.py +62 -0
  67. spiral/expressions/tiff.py +223 -0
  68. spiral/expressions/udf.py +46 -0
  69. spiral/grpc_.py +32 -0
  70. spiral/iceberg.py +31 -0
  71. spiral/iterable_dataset.py +106 -0
  72. spiral/key_space_index.py +44 -0
  73. spiral/project.py +199 -0
  74. spiral/protogen/_/__init__.py +0 -0
  75. spiral/protogen/_/arrow/__init__.py +0 -0
  76. spiral/protogen/_/arrow/flight/__init__.py +0 -0
  77. spiral/protogen/_/arrow/flight/protocol/__init__.py +0 -0
  78. spiral/protogen/_/arrow/flight/protocol/sql/__init__.py +2548 -0
  79. spiral/protogen/_/google/__init__.py +0 -0
  80. spiral/protogen/_/google/protobuf/__init__.py +2310 -0
  81. spiral/protogen/_/message_pool.py +3 -0
  82. spiral/protogen/_/py.typed +0 -0
  83. spiral/protogen/_/scandal/__init__.py +190 -0
  84. spiral/protogen/_/spfs/__init__.py +72 -0
  85. spiral/protogen/_/spql/__init__.py +61 -0
  86. spiral/protogen/_/substrait/__init__.py +6196 -0
  87. spiral/protogen/_/substrait/extensions/__init__.py +169 -0
  88. spiral/protogen/__init__.py +0 -0
  89. spiral/protogen/util.py +41 -0
  90. spiral/py.typed +0 -0
  91. spiral/scan.py +285 -0
  92. spiral/server.py +17 -0
  93. spiral/settings.py +114 -0
  94. spiral/snapshot.py +56 -0
  95. spiral/streaming_/__init__.py +3 -0
  96. spiral/streaming_/reader.py +133 -0
  97. spiral/streaming_/stream.py +157 -0
  98. spiral/substrait_.py +274 -0
  99. spiral/table.py +293 -0
  100. spiral/text_index.py +17 -0
  101. spiral/transaction.py +58 -0
  102. spiral/types_.py +6 -0
@@ -0,0 +1,2548 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # sources: arrow/flight_sql.proto
3
+ # plugin: python-betterproto2
4
+ # This file has been @generated
5
+
6
+ __all__ = (
7
+ "ActionBeginSavepointRequest",
8
+ "ActionBeginSavepointResult",
9
+ "ActionBeginTransactionRequest",
10
+ "ActionBeginTransactionResult",
11
+ "ActionCancelQueryRequest",
12
+ "ActionCancelQueryResult",
13
+ "ActionCancelQueryResultCancelResult",
14
+ "ActionClosePreparedStatementRequest",
15
+ "ActionCreatePreparedStatementRequest",
16
+ "ActionCreatePreparedStatementResult",
17
+ "ActionCreatePreparedSubstraitPlanRequest",
18
+ "ActionEndSavepointRequest",
19
+ "ActionEndSavepointRequestEndSavepoint",
20
+ "ActionEndTransactionRequest",
21
+ "ActionEndTransactionRequestEndTransaction",
22
+ "CommandGetCatalogs",
23
+ "CommandGetCrossReference",
24
+ "CommandGetDbSchemas",
25
+ "CommandGetExportedKeys",
26
+ "CommandGetImportedKeys",
27
+ "CommandGetPrimaryKeys",
28
+ "CommandGetSqlInfo",
29
+ "CommandGetTableTypes",
30
+ "CommandGetTables",
31
+ "CommandGetXdbcTypeInfo",
32
+ "CommandPreparedStatementQuery",
33
+ "CommandPreparedStatementUpdate",
34
+ "CommandStatementQuery",
35
+ "CommandStatementSubstraitPlan",
36
+ "CommandStatementUpdate",
37
+ "DoPutPreparedStatementResult",
38
+ "DoPutUpdateResult",
39
+ "Nullable",
40
+ "Searchable",
41
+ "SqlInfo",
42
+ "SqlNullOrdering",
43
+ "SqlOuterJoinsSupportLevel",
44
+ "SqlSupportedCaseSensitivity",
45
+ "SqlSupportedElementActions",
46
+ "SqlSupportedGroupBy",
47
+ "SqlSupportedPositionedCommands",
48
+ "SqlSupportedResultSetConcurrency",
49
+ "SqlSupportedResultSetType",
50
+ "SqlSupportedSubqueries",
51
+ "SqlSupportedTransaction",
52
+ "SqlSupportedTransactions",
53
+ "SqlSupportedUnions",
54
+ "SqlSupportsConvert",
55
+ "SqlTransactionIsolationLevel",
56
+ "SubstraitPlan",
57
+ "SupportedAnsi92SqlGrammarLevel",
58
+ "SupportedSqlGrammar",
59
+ "TicketStatementQuery",
60
+ "UpdateDeleteRules",
61
+ "XdbcDataType",
62
+ "XdbcDatetimeSubcode",
63
+ )
64
+
65
+ import warnings
66
+ from dataclasses import dataclass
67
+
68
+ import betterproto2
69
+
70
+ from .....message_pool import default_message_pool
71
+
72
+ _COMPILER_VERSION = "0.9.0"
73
+ betterproto2.check_compiler_version(_COMPILER_VERSION)
74
+
75
+
76
+ class ActionCancelQueryResultCancelResult(betterproto2.Enum):
77
+ UNSPECIFIED = 0
78
+ """
79
+ The cancellation status is unknown. Servers should avoid using
80
+ this value (send a NOT_FOUND error if the requested query is
81
+ not known). Clients can retry the request.
82
+ """
83
+
84
+ CANCELLED = 1
85
+ """
86
+ The cancellation request is complete. Subsequent requests with
87
+ the same payload may return CANCELLED or a NOT_FOUND error.
88
+ """
89
+
90
+ CANCELLING = 2
91
+ """
92
+ The cancellation request is in progress. The client may retry
93
+ the cancellation request.
94
+ """
95
+
96
+ NOT_CANCELLABLE = 3
97
+ """
98
+ The query is not cancellable. The client should not retry the
99
+ cancellation request.
100
+ """
101
+
102
+ @classmethod
103
+ def betterproto_value_to_renamed_proto_names(cls) -> dict[int, str]:
104
+ return {
105
+ 0: "CANCEL_RESULT_UNSPECIFIED",
106
+ 1: "CANCEL_RESULT_CANCELLED",
107
+ 2: "CANCEL_RESULT_CANCELLING",
108
+ 3: "CANCEL_RESULT_NOT_CANCELLABLE",
109
+ }
110
+
111
+ @classmethod
112
+ def betterproto_renamed_proto_names_to_value(cls) -> dict[str, int]:
113
+ return {
114
+ "CANCEL_RESULT_UNSPECIFIED": 0,
115
+ "CANCEL_RESULT_CANCELLED": 1,
116
+ "CANCEL_RESULT_CANCELLING": 2,
117
+ "CANCEL_RESULT_NOT_CANCELLABLE": 3,
118
+ }
119
+
120
+
121
+ class ActionEndSavepointRequestEndSavepoint(betterproto2.Enum):
122
+ UNSPECIFIED = 0
123
+
124
+ RELEASE = 1
125
+ """
126
+ Release the savepoint.
127
+ """
128
+
129
+ ROLLBACK = 2
130
+ """
131
+ Roll back to a savepoint.
132
+ """
133
+
134
+ @classmethod
135
+ def betterproto_value_to_renamed_proto_names(cls) -> dict[int, str]:
136
+ return {
137
+ 0: "END_SAVEPOINT_UNSPECIFIED",
138
+ 1: "END_SAVEPOINT_RELEASE",
139
+ 2: "END_SAVEPOINT_ROLLBACK",
140
+ }
141
+
142
+ @classmethod
143
+ def betterproto_renamed_proto_names_to_value(cls) -> dict[str, int]:
144
+ return {
145
+ "END_SAVEPOINT_UNSPECIFIED": 0,
146
+ "END_SAVEPOINT_RELEASE": 1,
147
+ "END_SAVEPOINT_ROLLBACK": 2,
148
+ }
149
+
150
+
151
+ class ActionEndTransactionRequestEndTransaction(betterproto2.Enum):
152
+ UNSPECIFIED = 0
153
+
154
+ COMMIT = 1
155
+ """
156
+ Commit the transaction.
157
+ """
158
+
159
+ ROLLBACK = 2
160
+ """
161
+ Roll back the transaction.
162
+ """
163
+
164
+ @classmethod
165
+ def betterproto_value_to_renamed_proto_names(cls) -> dict[int, str]:
166
+ return {
167
+ 0: "END_TRANSACTION_UNSPECIFIED",
168
+ 1: "END_TRANSACTION_COMMIT",
169
+ 2: "END_TRANSACTION_ROLLBACK",
170
+ }
171
+
172
+ @classmethod
173
+ def betterproto_renamed_proto_names_to_value(cls) -> dict[str, int]:
174
+ return {
175
+ "END_TRANSACTION_UNSPECIFIED": 0,
176
+ "END_TRANSACTION_COMMIT": 1,
177
+ "END_TRANSACTION_ROLLBACK": 2,
178
+ }
179
+
180
+
181
+ class Nullable(betterproto2.Enum):
182
+ NULLABILITY_NO_NULLS = 0
183
+ """
184
+ *
185
+ Indicates that the fields does not allow the use of null values.
186
+ """
187
+
188
+ NULLABILITY_NULLABLE = 1
189
+ """
190
+ *
191
+ Indicates that the fields allow the use of null values.
192
+ """
193
+
194
+ NULLABILITY_UNKNOWN = 2
195
+ """
196
+ *
197
+ Indicates that nullability of the fields cannot be determined.
198
+ """
199
+
200
+
201
+ class Searchable(betterproto2.Enum):
202
+ NONE = 0
203
+ """
204
+ *
205
+ Indicates that column cannot be used in a WHERE clause.
206
+ """
207
+
208
+ CHAR = 1
209
+ """
210
+ *
211
+ Indicates that the column can be used in a WHERE clause if it is using a
212
+ LIKE operator.
213
+ """
214
+
215
+ BASIC = 2
216
+ """
217
+ *
218
+ Indicates that the column can be used In a WHERE clause with any
219
+ operator other than LIKE.
220
+
221
+ - Allowed operators: comparison, quantified comparison, BETWEEN,
222
+ DISTINCT, IN, MATCH, and UNIQUE.
223
+ """
224
+
225
+ FULL = 3
226
+ """
227
+ *
228
+ Indicates that the column can be used in a WHERE clause using any operator.
229
+ """
230
+
231
+ @classmethod
232
+ def betterproto_value_to_renamed_proto_names(cls) -> dict[int, str]:
233
+ return {
234
+ 0: "SEARCHABLE_NONE",
235
+ 1: "SEARCHABLE_CHAR",
236
+ 2: "SEARCHABLE_BASIC",
237
+ 3: "SEARCHABLE_FULL",
238
+ }
239
+
240
+ @classmethod
241
+ def betterproto_renamed_proto_names_to_value(cls) -> dict[str, int]:
242
+ return {
243
+ "SEARCHABLE_NONE": 0,
244
+ "SEARCHABLE_CHAR": 1,
245
+ "SEARCHABLE_BASIC": 2,
246
+ "SEARCHABLE_FULL": 3,
247
+ }
248
+
249
+
250
+ class SqlInfo(betterproto2.Enum):
251
+ """
252
+ Options for CommandGetSqlInfo.
253
+ """
254
+
255
+ FLIGHT_SQL_SERVER_NAME = 0
256
+ """
257
+ Server Information [0-500): Provides basic information about the Flight SQL Server.
258
+
259
+ Retrieves a UTF-8 string with the name of the Flight SQL Server.
260
+ """
261
+
262
+ FLIGHT_SQL_SERVER_VERSION = 1
263
+ """
264
+ Retrieves a UTF-8 string with the native version of the Flight SQL Server.
265
+ """
266
+
267
+ FLIGHT_SQL_SERVER_ARROW_VERSION = 2
268
+ """
269
+ Retrieves a UTF-8 string with the Arrow format version of the Flight SQL Server.
270
+ """
271
+
272
+ FLIGHT_SQL_SERVER_READ_ONLY = 3
273
+ """
274
+
275
+ Retrieves a boolean value indicating whether the Flight SQL Server is read only.
276
+
277
+ Returns:
278
+ - false: if read-write
279
+ - true: if read only
280
+ """
281
+
282
+ FLIGHT_SQL_SERVER_SQL = 4
283
+ """
284
+
285
+ Retrieves a boolean value indicating whether the Flight SQL Server supports executing
286
+ SQL queries.
287
+
288
+ Note that the absence of this info (as opposed to a false value) does not necessarily
289
+ mean that SQL is not supported, as this property was not originally defined.
290
+ """
291
+
292
+ FLIGHT_SQL_SERVER_SUBSTRAIT = 5
293
+ """
294
+
295
+ Retrieves a boolean value indicating whether the Flight SQL Server supports executing
296
+ Substrait plans.
297
+ """
298
+
299
+ FLIGHT_SQL_SERVER_SUBSTRAIT_MIN_VERSION = 6
300
+ """
301
+
302
+ Retrieves a string value indicating the minimum supported Substrait version, or null
303
+ if Substrait is not supported.
304
+ """
305
+
306
+ FLIGHT_SQL_SERVER_SUBSTRAIT_MAX_VERSION = 7
307
+ """
308
+
309
+ Retrieves a string value indicating the maximum supported Substrait version, or null
310
+ if Substrait is not supported.
311
+ """
312
+
313
+ FLIGHT_SQL_SERVER_TRANSACTION = 8
314
+ """
315
+
316
+ Retrieves an int32 indicating whether the Flight SQL Server supports the
317
+ BeginTransaction/EndTransaction/BeginSavepoint/EndSavepoint actions.
318
+
319
+ Even if this is not supported, the database may still support explicit "BEGIN
320
+ TRANSACTION"/"COMMIT" SQL statements (see SQL_TRANSACTIONS_SUPPORTED); this property
321
+ is only about whether the server implements the Flight SQL API endpoints.
322
+
323
+ The possible values are listed in `SqlSupportedTransaction`.
324
+ """
325
+
326
+ FLIGHT_SQL_SERVER_CANCEL = 9
327
+ """
328
+
329
+ Retrieves a boolean value indicating whether the Flight SQL Server supports explicit
330
+ query cancellation (the CancelQuery action).
331
+ """
332
+
333
+ FLIGHT_SQL_SERVER_STATEMENT_TIMEOUT = 100
334
+ """
335
+
336
+ Retrieves an int32 indicating the timeout (in milliseconds) for prepared statement handles.
337
+
338
+ If 0, there is no timeout. Servers should reset the timeout when the handle is used in a command.
339
+ """
340
+
341
+ FLIGHT_SQL_SERVER_TRANSACTION_TIMEOUT = 101
342
+ """
343
+
344
+ Retrieves an int32 indicating the timeout (in milliseconds) for transactions, since transactions are not tied to a connection.
345
+
346
+ If 0, there is no timeout. Servers should reset the timeout when the handle is used in a command.
347
+ """
348
+
349
+ SQL_DDL_CATALOG = 500
350
+ """
351
+ SQL Syntax Information [500-1000): provides information about SQL syntax supported by the Flight SQL Server.
352
+
353
+ Retrieves a boolean value indicating whether the Flight SQL Server supports CREATE and DROP of catalogs.
354
+
355
+ Returns:
356
+ - false: if it doesn't support CREATE and DROP of catalogs.
357
+ - true: if it supports CREATE and DROP of catalogs.
358
+ """
359
+
360
+ SQL_DDL_SCHEMA = 501
361
+ """
362
+
363
+ Retrieves a boolean value indicating whether the Flight SQL Server supports CREATE and DROP of schemas.
364
+
365
+ Returns:
366
+ - false: if it doesn't support CREATE and DROP of schemas.
367
+ - true: if it supports CREATE and DROP of schemas.
368
+ """
369
+
370
+ SQL_DDL_TABLE = 502
371
+ """
372
+
373
+ Indicates whether the Flight SQL Server supports CREATE and DROP of tables.
374
+
375
+ Returns:
376
+ - false: if it doesn't support CREATE and DROP of tables.
377
+ - true: if it supports CREATE and DROP of tables.
378
+ """
379
+
380
+ SQL_IDENTIFIER_CASE = 503
381
+ """
382
+
383
+ Retrieves a int32 ordinal representing the case sensitivity of catalog, table, schema and table names.
384
+
385
+ The possible values are listed in `arrow.flight.protocol.sql.SqlSupportedCaseSensitivity`.
386
+ """
387
+
388
+ SQL_IDENTIFIER_QUOTE_CHAR = 504
389
+ """
390
+ Retrieves a UTF-8 string with the supported character(s) used to surround a delimited identifier.
391
+ """
392
+
393
+ SQL_QUOTED_IDENTIFIER_CASE = 505
394
+ """
395
+
396
+ Retrieves a int32 describing the case sensitivity of quoted identifiers.
397
+
398
+ The possible values are listed in `arrow.flight.protocol.sql.SqlSupportedCaseSensitivity`.
399
+ """
400
+
401
+ SQL_ALL_TABLES_ARE_SELECTABLE = 506
402
+ """
403
+
404
+ Retrieves a boolean value indicating whether all tables are selectable.
405
+
406
+ Returns:
407
+ - false: if not all tables are selectable or if none are;
408
+ - true: if all tables are selectable.
409
+ """
410
+
411
+ SQL_NULL_ORDERING = 507
412
+ """
413
+
414
+ Retrieves the null ordering.
415
+
416
+ Returns a int32 ordinal for the null ordering being used, as described in
417
+ `arrow.flight.protocol.sql.SqlNullOrdering`.
418
+ """
419
+
420
+ SQL_KEYWORDS = 508
421
+ """
422
+ Retrieves a UTF-8 string list with values of the supported keywords.
423
+ """
424
+
425
+ SQL_NUMERIC_FUNCTIONS = 509
426
+ """
427
+ Retrieves a UTF-8 string list with values of the supported numeric functions.
428
+ """
429
+
430
+ SQL_STRING_FUNCTIONS = 510
431
+ """
432
+ Retrieves a UTF-8 string list with values of the supported string functions.
433
+ """
434
+
435
+ SQL_SYSTEM_FUNCTIONS = 511
436
+ """
437
+ Retrieves a UTF-8 string list with values of the supported system functions.
438
+ """
439
+
440
+ SQL_DATETIME_FUNCTIONS = 512
441
+ """
442
+ Retrieves a UTF-8 string list with values of the supported datetime functions.
443
+ """
444
+
445
+ SQL_SEARCH_STRING_ESCAPE = 513
446
+ """
447
+
448
+ Retrieves the UTF-8 string that can be used to escape wildcard characters.
449
+ This is the string that can be used to escape '_' or '%' in the catalog search parameters that are a pattern
450
+ (and therefore use one of the wildcard characters).
451
+ The '_' character represents any single character; the '%' character represents any sequence of zero or more
452
+ characters.
453
+ """
454
+
455
+ SQL_EXTRA_NAME_CHARACTERS = 514
456
+ """
457
+
458
+ Retrieves a UTF-8 string with all the "extra" characters that can be used in unquoted identifier names
459
+ (those beyond a-z, A-Z, 0-9 and _).
460
+ """
461
+
462
+ SQL_SUPPORTS_COLUMN_ALIASING = 515
463
+ """
464
+
465
+ Retrieves a boolean value indicating whether column aliasing is supported.
466
+ If so, the SQL AS clause can be used to provide names for computed columns or to provide alias names for columns
467
+ as required.
468
+
469
+ Returns:
470
+ - false: if column aliasing is unsupported;
471
+ - true: if column aliasing is supported.
472
+ """
473
+
474
+ SQL_NULL_PLUS_NULL_IS_NULL = 516
475
+ """
476
+
477
+ Retrieves a boolean value indicating whether concatenations between null and non-null values being
478
+ null are supported.
479
+
480
+ - Returns:
481
+ - false: if concatenations between null and non-null values being null are unsupported;
482
+ - true: if concatenations between null and non-null values being null are supported.
483
+ """
484
+
485
+ SQL_SUPPORTS_CONVERT = 517
486
+ """
487
+
488
+ Retrieves a map where the key is the type to convert from and the value is a list with the types to convert to,
489
+ indicating the supported conversions. Each key and each item on the list value is a value to a predefined type on
490
+ SqlSupportsConvert enum.
491
+ The returned map will be: map<int32, list<int32>>
492
+ """
493
+
494
+ SQL_SUPPORTS_TABLE_CORRELATION_NAMES = 518
495
+ """
496
+
497
+ Retrieves a boolean value indicating whether, when table correlation names are supported,
498
+ they are restricted to being different from the names of the tables.
499
+
500
+ Returns:
501
+ - false: if table correlation names are unsupported;
502
+ - true: if table correlation names are supported.
503
+ """
504
+
505
+ SQL_SUPPORTS_DIFFERENT_TABLE_CORRELATION_NAMES = 519
506
+ """
507
+
508
+ Retrieves a boolean value indicating whether, when table correlation names are supported,
509
+ they are restricted to being different from the names of the tables.
510
+
511
+ Returns:
512
+ - false: if different table correlation names are unsupported;
513
+ - true: if different table correlation names are supported
514
+ """
515
+
516
+ SQL_SUPPORTS_EXPRESSIONS_IN_ORDER_BY = 520
517
+ """
518
+
519
+ Retrieves a boolean value indicating whether expressions in ORDER BY lists are supported.
520
+
521
+ Returns:
522
+ - false: if expressions in ORDER BY are unsupported;
523
+ - true: if expressions in ORDER BY are supported;
524
+ """
525
+
526
+ SQL_SUPPORTS_ORDER_BY_UNRELATED = 521
527
+ """
528
+
529
+ Retrieves a boolean value indicating whether using a column that is not in the SELECT statement in a GROUP BY
530
+ clause is supported.
531
+
532
+ Returns:
533
+ - false: if using a column that is not in the SELECT statement in a GROUP BY clause is unsupported;
534
+ - true: if using a column that is not in the SELECT statement in a GROUP BY clause is supported.
535
+ """
536
+
537
+ SQL_SUPPORTED_GROUP_BY = 522
538
+ """
539
+
540
+ Retrieves the supported GROUP BY commands;
541
+
542
+ Returns an int32 bitmask value representing the supported commands.
543
+ The returned bitmask should be parsed in order to retrieve the supported commands.
544
+
545
+ For instance:
546
+ - return 0 (\\b0) => [] (GROUP BY is unsupported);
547
+ - return 1 (\\b1) => [SQL_GROUP_BY_UNRELATED];
548
+ - return 2 (\\b10) => [SQL_GROUP_BY_BEYOND_SELECT];
549
+ - return 3 (\\b11) => [SQL_GROUP_BY_UNRELATED, SQL_GROUP_BY_BEYOND_SELECT].
550
+ Valid GROUP BY types are described under `arrow.flight.protocol.sql.SqlSupportedGroupBy`.
551
+ """
552
+
553
+ SQL_SUPPORTS_LIKE_ESCAPE_CLAUSE = 523
554
+ """
555
+
556
+ Retrieves a boolean value indicating whether specifying a LIKE escape clause is supported.
557
+
558
+ Returns:
559
+ - false: if specifying a LIKE escape clause is unsupported;
560
+ - true: if specifying a LIKE escape clause is supported.
561
+ """
562
+
563
+ SQL_SUPPORTS_NON_NULLABLE_COLUMNS = 524
564
+ """
565
+
566
+ Retrieves a boolean value indicating whether columns may be defined as non-nullable.
567
+
568
+ Returns:
569
+ - false: if columns cannot be defined as non-nullable;
570
+ - true: if columns may be defined as non-nullable.
571
+ """
572
+
573
+ SQL_SUPPORTED_GRAMMAR = 525
574
+ """
575
+
576
+ Retrieves the supported SQL grammar level as per the ODBC specification.
577
+
578
+ Returns an int32 bitmask value representing the supported SQL grammar level.
579
+ The returned bitmask should be parsed in order to retrieve the supported grammar levels.
580
+
581
+ For instance:
582
+ - return 0 (\\b0) => [] (SQL grammar is unsupported);
583
+ - return 1 (\\b1) => [SQL_MINIMUM_GRAMMAR];
584
+ - return 2 (\\b10) => [SQL_CORE_GRAMMAR];
585
+ - return 3 (\\b11) => [SQL_MINIMUM_GRAMMAR, SQL_CORE_GRAMMAR];
586
+ - return 4 (\\b100) => [SQL_EXTENDED_GRAMMAR];
587
+ - return 5 (\\b101) => [SQL_MINIMUM_GRAMMAR, SQL_EXTENDED_GRAMMAR];
588
+ - return 6 (\\b110) => [SQL_CORE_GRAMMAR, SQL_EXTENDED_GRAMMAR];
589
+ - return 7 (\\b111) => [SQL_MINIMUM_GRAMMAR, SQL_CORE_GRAMMAR, SQL_EXTENDED_GRAMMAR].
590
+ Valid SQL grammar levels are described under `arrow.flight.protocol.sql.SupportedSqlGrammar`.
591
+ """
592
+
593
+ SQL_ANSI92_SUPPORTED_LEVEL = 526
594
+ """
595
+
596
+ Retrieves the supported ANSI92 SQL grammar level.
597
+
598
+ Returns an int32 bitmask value representing the supported ANSI92 SQL grammar level.
599
+ The returned bitmask should be parsed in order to retrieve the supported commands.
600
+
601
+ For instance:
602
+ - return 0 (\\b0) => [] (ANSI92 SQL grammar is unsupported);
603
+ - return 1 (\\b1) => [ANSI92_ENTRY_SQL];
604
+ - return 2 (\\b10) => [ANSI92_INTERMEDIATE_SQL];
605
+ - return 3 (\\b11) => [ANSI92_ENTRY_SQL, ANSI92_INTERMEDIATE_SQL];
606
+ - return 4 (\\b100) => [ANSI92_FULL_SQL];
607
+ - return 5 (\\b101) => [ANSI92_ENTRY_SQL, ANSI92_FULL_SQL];
608
+ - return 6 (\\b110) => [ANSI92_INTERMEDIATE_SQL, ANSI92_FULL_SQL];
609
+ - return 7 (\\b111) => [ANSI92_ENTRY_SQL, ANSI92_INTERMEDIATE_SQL, ANSI92_FULL_SQL].
610
+ Valid ANSI92 SQL grammar levels are described under `arrow.flight.protocol.sql.SupportedAnsi92SqlGrammarLevel`.
611
+ """
612
+
613
+ SQL_SUPPORTS_INTEGRITY_ENHANCEMENT_FACILITY = 527
614
+ """
615
+
616
+ Retrieves a boolean value indicating whether the SQL Integrity Enhancement Facility is supported.
617
+
618
+ Returns:
619
+ - false: if the SQL Integrity Enhancement Facility is supported;
620
+ - true: if the SQL Integrity Enhancement Facility is supported.
621
+ """
622
+
623
+ SQL_OUTER_JOINS_SUPPORT_LEVEL = 528
624
+ """
625
+
626
+ Retrieves the support level for SQL OUTER JOINs.
627
+
628
+ Returns a int32 ordinal for the SQL ordering being used, as described in
629
+ `arrow.flight.protocol.sql.SqlOuterJoinsSupportLevel`.
630
+ """
631
+
632
+ SQL_SCHEMA_TERM = 529
633
+ """
634
+ Retrieves a UTF-8 string with the preferred term for "schema".
635
+ """
636
+
637
+ SQL_PROCEDURE_TERM = 530
638
+ """
639
+ Retrieves a UTF-8 string with the preferred term for "procedure".
640
+ """
641
+
642
+ SQL_CATALOG_TERM = 531
643
+ """
644
+
645
+ Retrieves a UTF-8 string with the preferred term for "catalog".
646
+ If a empty string is returned its assumed that the server does NOT supports catalogs.
647
+ """
648
+
649
+ SQL_CATALOG_AT_START = 532
650
+ """
651
+
652
+ Retrieves a boolean value indicating whether a catalog appears at the start of a fully qualified table name.
653
+
654
+ - false: if a catalog does not appear at the start of a fully qualified table name;
655
+ - true: if a catalog appears at the start of a fully qualified table name.
656
+ """
657
+
658
+ SQL_SCHEMAS_SUPPORTED_ACTIONS = 533
659
+ """
660
+
661
+ Retrieves the supported actions for a SQL schema.
662
+
663
+ Returns an int32 bitmask value representing the supported actions for a SQL schema.
664
+ The returned bitmask should be parsed in order to retrieve the supported actions for a SQL schema.
665
+
666
+ For instance:
667
+ - return 0 (\\b0) => [] (no supported actions for SQL schema);
668
+ - return 1 (\\b1) => [SQL_ELEMENT_IN_PROCEDURE_CALLS];
669
+ - return 2 (\\b10) => [SQL_ELEMENT_IN_INDEX_DEFINITIONS];
670
+ - return 3 (\\b11) => [SQL_ELEMENT_IN_PROCEDURE_CALLS, SQL_ELEMENT_IN_INDEX_DEFINITIONS];
671
+ - return 4 (\\b100) => [SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS];
672
+ - return 5 (\\b101) => [SQL_ELEMENT_IN_PROCEDURE_CALLS, SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS];
673
+ - return 6 (\\b110) => [SQL_ELEMENT_IN_INDEX_DEFINITIONS, SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS];
674
+ - return 7 (\\b111) => [SQL_ELEMENT_IN_PROCEDURE_CALLS, SQL_ELEMENT_IN_INDEX_DEFINITIONS, SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS].
675
+ Valid actions for a SQL schema described under `arrow.flight.protocol.sql.SqlSupportedElementActions`.
676
+ """
677
+
678
+ SQL_CATALOGS_SUPPORTED_ACTIONS = 534
679
+ """
680
+
681
+ Retrieves the supported actions for a SQL schema.
682
+
683
+ Returns an int32 bitmask value representing the supported actions for a SQL catalog.
684
+ The returned bitmask should be parsed in order to retrieve the supported actions for a SQL catalog.
685
+
686
+ For instance:
687
+ - return 0 (\\b0) => [] (no supported actions for SQL catalog);
688
+ - return 1 (\\b1) => [SQL_ELEMENT_IN_PROCEDURE_CALLS];
689
+ - return 2 (\\b10) => [SQL_ELEMENT_IN_INDEX_DEFINITIONS];
690
+ - return 3 (\\b11) => [SQL_ELEMENT_IN_PROCEDURE_CALLS, SQL_ELEMENT_IN_INDEX_DEFINITIONS];
691
+ - return 4 (\\b100) => [SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS];
692
+ - return 5 (\\b101) => [SQL_ELEMENT_IN_PROCEDURE_CALLS, SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS];
693
+ - return 6 (\\b110) => [SQL_ELEMENT_IN_INDEX_DEFINITIONS, SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS];
694
+ - return 7 (\\b111) => [SQL_ELEMENT_IN_PROCEDURE_CALLS, SQL_ELEMENT_IN_INDEX_DEFINITIONS, SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS].
695
+ Valid actions for a SQL catalog are described under `arrow.flight.protocol.sql.SqlSupportedElementActions`.
696
+ """
697
+
698
+ SQL_SUPPORTED_POSITIONED_COMMANDS = 535
699
+ """
700
+
701
+ Retrieves the supported SQL positioned commands.
702
+
703
+ Returns an int32 bitmask value representing the supported SQL positioned commands.
704
+ The returned bitmask should be parsed in order to retrieve the supported SQL positioned commands.
705
+
706
+ For instance:
707
+ - return 0 (\\b0) => [] (no supported SQL positioned commands);
708
+ - return 1 (\\b1) => [SQL_POSITIONED_DELETE];
709
+ - return 2 (\\b10) => [SQL_POSITIONED_UPDATE];
710
+ - return 3 (\\b11) => [SQL_POSITIONED_DELETE, SQL_POSITIONED_UPDATE].
711
+ Valid SQL positioned commands are described under `arrow.flight.protocol.sql.SqlSupportedPositionedCommands`.
712
+ """
713
+
714
+ SQL_SELECT_FOR_UPDATE_SUPPORTED = 536
715
+ """
716
+
717
+ Retrieves a boolean value indicating whether SELECT FOR UPDATE statements are supported.
718
+
719
+ Returns:
720
+ - false: if SELECT FOR UPDATE statements are unsupported;
721
+ - true: if SELECT FOR UPDATE statements are supported.
722
+ """
723
+
724
+ SQL_STORED_PROCEDURES_SUPPORTED = 537
725
+ """
726
+
727
+ Retrieves a boolean value indicating whether stored procedure calls that use the stored procedure escape syntax
728
+ are supported.
729
+
730
+ Returns:
731
+ - false: if stored procedure calls that use the stored procedure escape syntax are unsupported;
732
+ - true: if stored procedure calls that use the stored procedure escape syntax are supported.
733
+ """
734
+
735
+ SQL_SUPPORTED_SUBQUERIES = 538
736
+ """
737
+
738
+ Retrieves the supported SQL subqueries.
739
+
740
+ Returns an int32 bitmask value representing the supported SQL subqueries.
741
+ The returned bitmask should be parsed in order to retrieve the supported SQL subqueries.
742
+
743
+ For instance:
744
+ - return 0 (\\b0) => [] (no supported SQL subqueries);
745
+ - return 1 (\\b1) => [SQL_SUBQUERIES_IN_COMPARISONS];
746
+ - return 2 (\\b10) => [SQL_SUBQUERIES_IN_EXISTS];
747
+ - return 3 (\\b11) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_EXISTS];
748
+ - return 4 (\\b100) => [SQL_SUBQUERIES_IN_INS];
749
+ - return 5 (\\b101) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_INS];
750
+ - return 6 (\\b110) => [SQL_SUBQUERIES_IN_INS, SQL_SUBQUERIES_IN_EXISTS];
751
+ - return 7 (\\b111) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_EXISTS, SQL_SUBQUERIES_IN_INS];
752
+ - return 8 (\\b1000) => [SQL_SUBQUERIES_IN_QUANTIFIEDS];
753
+ - return 9 (\\b1001) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
754
+ - return 10 (\\b1010) => [SQL_SUBQUERIES_IN_EXISTS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
755
+ - return 11 (\\b1011) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_EXISTS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
756
+ - return 12 (\\b1100) => [SQL_SUBQUERIES_IN_INS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
757
+ - return 13 (\\b1101) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_INS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
758
+ - return 14 (\\b1110) => [SQL_SUBQUERIES_IN_EXISTS, SQL_SUBQUERIES_IN_INS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
759
+ - return 15 (\\b1111) => [SQL_SUBQUERIES_IN_COMPARISONS, SQL_SUBQUERIES_IN_EXISTS, SQL_SUBQUERIES_IN_INS, SQL_SUBQUERIES_IN_QUANTIFIEDS];
760
+ - ...
761
+ Valid SQL subqueries are described under `arrow.flight.protocol.sql.SqlSupportedSubqueries`.
762
+ """
763
+
764
+ SQL_CORRELATED_SUBQUERIES_SUPPORTED = 539
765
+ """
766
+
767
+ Retrieves a boolean value indicating whether correlated subqueries are supported.
768
+
769
+ Returns:
770
+ - false: if correlated subqueries are unsupported;
771
+ - true: if correlated subqueries are supported.
772
+ """
773
+
774
+ SQL_SUPPORTED_UNIONS = 540
775
+ """
776
+
777
+ Retrieves the supported SQL UNIONs.
778
+
779
+ Returns an int32 bitmask value representing the supported SQL UNIONs.
780
+ The returned bitmask should be parsed in order to retrieve the supported SQL UNIONs.
781
+
782
+ For instance:
783
+ - return 0 (\\b0) => [] (no supported SQL positioned commands);
784
+ - return 1 (\\b1) => [SQL_UNION];
785
+ - return 2 (\\b10) => [SQL_UNION_ALL];
786
+ - return 3 (\\b11) => [SQL_UNION, SQL_UNION_ALL].
787
+ Valid SQL positioned commands are described under `arrow.flight.protocol.sql.SqlSupportedUnions`.
788
+ """
789
+
790
+ SQL_MAX_BINARY_LITERAL_LENGTH = 541
791
+ """
792
+ Retrieves a int64 value representing the maximum number of hex characters allowed in an inline binary literal.
793
+ """
794
+
795
+ SQL_MAX_CHAR_LITERAL_LENGTH = 542
796
+ """
797
+ Retrieves a int64 value representing the maximum number of characters allowed for a character literal.
798
+ """
799
+
800
+ SQL_MAX_COLUMN_NAME_LENGTH = 543
801
+ """
802
+ Retrieves a int64 value representing the maximum number of characters allowed for a column name.
803
+ """
804
+
805
+ SQL_MAX_COLUMNS_IN_GROUP_BY = 544
806
+ """
807
+ Retrieves a int64 value representing the maximum number of columns allowed in a GROUP BY clause.
808
+ """
809
+
810
+ SQL_MAX_COLUMNS_IN_INDEX = 545
811
+ """
812
+ Retrieves a int64 value representing the maximum number of columns allowed in an index.
813
+ """
814
+
815
+ SQL_MAX_COLUMNS_IN_ORDER_BY = 546
816
+ """
817
+ Retrieves a int64 value representing the maximum number of columns allowed in an ORDER BY clause.
818
+ """
819
+
820
+ SQL_MAX_COLUMNS_IN_SELECT = 547
821
+ """
822
+ Retrieves a int64 value representing the maximum number of columns allowed in a SELECT list.
823
+ """
824
+
825
+ SQL_MAX_COLUMNS_IN_TABLE = 548
826
+ """
827
+ Retrieves a int64 value representing the maximum number of columns allowed in a table.
828
+ """
829
+
830
+ SQL_MAX_CONNECTIONS = 549
831
+ """
832
+ Retrieves a int64 value representing the maximum number of concurrent connections possible.
833
+ """
834
+
835
+ SQL_MAX_CURSOR_NAME_LENGTH = 550
836
+ """
837
+ Retrieves a int64 value the maximum number of characters allowed in a cursor name.
838
+ """
839
+
840
+ SQL_MAX_INDEX_LENGTH = 551
841
+ """
842
+
843
+ Retrieves a int64 value representing the maximum number of bytes allowed for an index,
844
+ including all of the parts of the index.
845
+ """
846
+
847
+ SQL_DB_SCHEMA_NAME_LENGTH = 552
848
+ """
849
+ Retrieves a int64 value representing the maximum number of characters allowed in a schema name.
850
+ """
851
+
852
+ SQL_MAX_PROCEDURE_NAME_LENGTH = 553
853
+ """
854
+ Retrieves a int64 value representing the maximum number of characters allowed in a procedure name.
855
+ """
856
+
857
+ SQL_MAX_CATALOG_NAME_LENGTH = 554
858
+ """
859
+ Retrieves a int64 value representing the maximum number of characters allowed in a catalog name.
860
+ """
861
+
862
+ SQL_MAX_ROW_SIZE = 555
863
+ """
864
+ Retrieves a int64 value representing the maximum number of bytes allowed in a single row.
865
+ """
866
+
867
+ SQL_MAX_ROW_SIZE_INCLUDES_BLOBS = 556
868
+ """
869
+
870
+ Retrieves a boolean indicating whether the return value for the JDBC method getMaxRowSize includes the SQL
871
+ data types LONGVARCHAR and LONGVARBINARY.
872
+
873
+ Returns:
874
+ - false: if return value for the JDBC method getMaxRowSize does
875
+ not include the SQL data types LONGVARCHAR and LONGVARBINARY;
876
+ - true: if return value for the JDBC method getMaxRowSize includes
877
+ the SQL data types LONGVARCHAR and LONGVARBINARY.
878
+ """
879
+
880
+ SQL_MAX_STATEMENT_LENGTH = 557
881
+ """
882
+
883
+ Retrieves a int64 value representing the maximum number of characters allowed for an SQL statement;
884
+ a result of 0 (zero) means that there is no limit or the limit is not known.
885
+ """
886
+
887
+ SQL_MAX_STATEMENTS = 558
888
+ """
889
+ Retrieves a int64 value representing the maximum number of active statements that can be open at the same time.
890
+ """
891
+
892
+ SQL_MAX_TABLE_NAME_LENGTH = 559
893
+ """
894
+ Retrieves a int64 value representing the maximum number of characters allowed in a table name.
895
+ """
896
+
897
+ SQL_MAX_TABLES_IN_SELECT = 560
898
+ """
899
+ Retrieves a int64 value representing the maximum number of tables allowed in a SELECT statement.
900
+ """
901
+
902
+ SQL_MAX_USERNAME_LENGTH = 561
903
+ """
904
+ Retrieves a int64 value representing the maximum number of characters allowed in a user name.
905
+ """
906
+
907
+ SQL_DEFAULT_TRANSACTION_ISOLATION = 562
908
+ """
909
+
910
+ Retrieves this database's default transaction isolation level as described in
911
+ `arrow.flight.protocol.sql.SqlTransactionIsolationLevel`.
912
+
913
+ Returns a int32 ordinal for the SQL transaction isolation level.
914
+ """
915
+
916
+ SQL_TRANSACTIONS_SUPPORTED = 563
917
+ """
918
+
919
+ Retrieves a boolean value indicating whether transactions are supported. If not, invoking the method commit is a
920
+ noop, and the isolation level is `arrow.flight.protocol.sql.SqlTransactionIsolationLevel.TRANSACTION_NONE`.
921
+
922
+ Returns:
923
+ - false: if transactions are unsupported;
924
+ - true: if transactions are supported.
925
+ """
926
+
927
+ SQL_SUPPORTED_TRANSACTIONS_ISOLATION_LEVELS = 564
928
+ """
929
+
930
+ Retrieves the supported transactions isolation levels.
931
+
932
+ Returns an int32 bitmask value representing the supported transactions isolation levels.
933
+ The returned bitmask should be parsed in order to retrieve the supported transactions isolation levels.
934
+
935
+ For instance:
936
+ - return 0 (\\b0) => [] (no supported SQL transactions isolation levels);
937
+ - return 1 (\\b1) => [SQL_TRANSACTION_NONE];
938
+ - return 2 (\\b10) => [SQL_TRANSACTION_READ_UNCOMMITTED];
939
+ - return 3 (\\b11) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_READ_UNCOMMITTED];
940
+ - return 4 (\\b100) => [SQL_TRANSACTION_REPEATABLE_READ];
941
+ - return 5 (\\b101) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_REPEATABLE_READ];
942
+ - return 6 (\\b110) => [SQL_TRANSACTION_READ_UNCOMMITTED, SQL_TRANSACTION_REPEATABLE_READ];
943
+ - return 7 (\\b111) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_READ_UNCOMMITTED, SQL_TRANSACTION_REPEATABLE_READ];
944
+ - return 8 (\\b1000) => [SQL_TRANSACTION_REPEATABLE_READ];
945
+ - return 9 (\\b1001) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_REPEATABLE_READ];
946
+ - return 10 (\\b1010) => [SQL_TRANSACTION_READ_UNCOMMITTED, SQL_TRANSACTION_REPEATABLE_READ];
947
+ - return 11 (\\b1011) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_READ_UNCOMMITTED, SQL_TRANSACTION_REPEATABLE_READ];
948
+ - return 12 (\\b1100) => [SQL_TRANSACTION_REPEATABLE_READ, SQL_TRANSACTION_REPEATABLE_READ];
949
+ - return 13 (\\b1101) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_REPEATABLE_READ, SQL_TRANSACTION_REPEATABLE_READ];
950
+ - return 14 (\\b1110) => [SQL_TRANSACTION_READ_UNCOMMITTED, SQL_TRANSACTION_REPEATABLE_READ, SQL_TRANSACTION_REPEATABLE_READ];
951
+ - return 15 (\\b1111) => [SQL_TRANSACTION_NONE, SQL_TRANSACTION_READ_UNCOMMITTED, SQL_TRANSACTION_REPEATABLE_READ, SQL_TRANSACTION_REPEATABLE_READ];
952
+ - return 16 (\\b10000) => [SQL_TRANSACTION_SERIALIZABLE];
953
+ - ...
954
+ Valid SQL positioned commands are described under `arrow.flight.protocol.sql.SqlTransactionIsolationLevel`.
955
+ """
956
+
957
+ SQL_DATA_DEFINITION_CAUSES_TRANSACTION_COMMIT = 565
958
+ """
959
+
960
+ Retrieves a boolean value indicating whether a data definition statement within a transaction forces
961
+ the transaction to commit.
962
+
963
+ Returns:
964
+ - false: if a data definition statement within a transaction does not force the transaction to commit;
965
+ - true: if a data definition statement within a transaction forces the transaction to commit.
966
+ """
967
+
968
+ SQL_DATA_DEFINITIONS_IN_TRANSACTIONS_IGNORED = 566
969
+ """
970
+
971
+ Retrieves a boolean value indicating whether a data definition statement within a transaction is ignored.
972
+
973
+ Returns:
974
+ - false: if a data definition statement within a transaction is taken into account;
975
+ - true: a data definition statement within a transaction is ignored.
976
+ """
977
+
978
+ SQL_SUPPORTED_RESULT_SET_TYPES = 567
979
+ """
980
+
981
+ Retrieves an int32 bitmask value representing the supported result set types.
982
+ The returned bitmask should be parsed in order to retrieve the supported result set types.
983
+
984
+ For instance:
985
+ - return 0 (\\b0) => [] (no supported result set types);
986
+ - return 1 (\\b1) => [SQL_RESULT_SET_TYPE_UNSPECIFIED];
987
+ - return 2 (\\b10) => [SQL_RESULT_SET_TYPE_FORWARD_ONLY];
988
+ - return 3 (\\b11) => [SQL_RESULT_SET_TYPE_UNSPECIFIED, SQL_RESULT_SET_TYPE_FORWARD_ONLY];
989
+ - return 4 (\\b100) => [SQL_RESULT_SET_TYPE_SCROLL_INSENSITIVE];
990
+ - return 5 (\\b101) => [SQL_RESULT_SET_TYPE_UNSPECIFIED, SQL_RESULT_SET_TYPE_SCROLL_INSENSITIVE];
991
+ - return 6 (\\b110) => [SQL_RESULT_SET_TYPE_FORWARD_ONLY, SQL_RESULT_SET_TYPE_SCROLL_INSENSITIVE];
992
+ - return 7 (\\b111) => [SQL_RESULT_SET_TYPE_UNSPECIFIED, SQL_RESULT_SET_TYPE_FORWARD_ONLY, SQL_RESULT_SET_TYPE_SCROLL_INSENSITIVE];
993
+ - return 8 (\\b1000) => [SQL_RESULT_SET_TYPE_SCROLL_SENSITIVE];
994
+ - ...
995
+ Valid result set types are described under `arrow.flight.protocol.sql.SqlSupportedResultSetType`.
996
+ """
997
+
998
+ SQL_SUPPORTED_CONCURRENCIES_FOR_RESULT_SET_UNSPECIFIED = 568
999
+ """
1000
+
1001
+ Returns an int32 bitmask value concurrency types supported for
1002
+ `arrow.flight.protocol.sql.SqlSupportedResultSetType.SQL_RESULT_SET_TYPE_UNSPECIFIED`.
1003
+
1004
+ For instance:
1005
+ - return 0 (\\b0) => [] (no supported concurrency types for this result set type)
1006
+ - return 1 (\\b1) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED]
1007
+ - return 2 (\\b10) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1008
+ - return 3 (\\b11) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1009
+ - return 4 (\\b100) => [SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1010
+ - return 5 (\\b101) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1011
+ - return 6 (\\b110) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1012
+ - return 7 (\\b111) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1013
+ Valid result set types are described under `arrow.flight.protocol.sql.SqlSupportedResultSetConcurrency`.
1014
+ """
1015
+
1016
+ SQL_SUPPORTED_CONCURRENCIES_FOR_RESULT_SET_FORWARD_ONLY = 569
1017
+ """
1018
+
1019
+ Returns an int32 bitmask value concurrency types supported for
1020
+ `arrow.flight.protocol.sql.SqlSupportedResultSetType.SQL_RESULT_SET_TYPE_FORWARD_ONLY`.
1021
+
1022
+ For instance:
1023
+ - return 0 (\\b0) => [] (no supported concurrency types for this result set type)
1024
+ - return 1 (\\b1) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED]
1025
+ - return 2 (\\b10) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1026
+ - return 3 (\\b11) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1027
+ - return 4 (\\b100) => [SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1028
+ - return 5 (\\b101) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1029
+ - return 6 (\\b110) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1030
+ - return 7 (\\b111) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1031
+ Valid result set types are described under `arrow.flight.protocol.sql.SqlSupportedResultSetConcurrency`.
1032
+ """
1033
+
1034
+ SQL_SUPPORTED_CONCURRENCIES_FOR_RESULT_SET_SCROLL_SENSITIVE = 570
1035
+ """
1036
+
1037
+ Returns an int32 bitmask value concurrency types supported for
1038
+ `arrow.flight.protocol.sql.SqlSupportedResultSetType.SQL_RESULT_SET_TYPE_SCROLL_SENSITIVE`.
1039
+
1040
+ For instance:
1041
+ - return 0 (\\b0) => [] (no supported concurrency types for this result set type)
1042
+ - return 1 (\\b1) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED]
1043
+ - return 2 (\\b10) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1044
+ - return 3 (\\b11) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1045
+ - return 4 (\\b100) => [SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1046
+ - return 5 (\\b101) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1047
+ - return 6 (\\b110) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1048
+ - return 7 (\\b111) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1049
+ Valid result set types are described under `arrow.flight.protocol.sql.SqlSupportedResultSetConcurrency`.
1050
+ """
1051
+
1052
+ SQL_SUPPORTED_CONCURRENCIES_FOR_RESULT_SET_SCROLL_INSENSITIVE = 571
1053
+ """
1054
+
1055
+ Returns an int32 bitmask value concurrency types supported for
1056
+ `arrow.flight.protocol.sql.SqlSupportedResultSetType.SQL_RESULT_SET_TYPE_SCROLL_INSENSITIVE`.
1057
+
1058
+ For instance:
1059
+ - return 0 (\\b0) => [] (no supported concurrency types for this result set type)
1060
+ - return 1 (\\b1) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED]
1061
+ - return 2 (\\b10) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1062
+ - return 3 (\\b11) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY]
1063
+ - return 4 (\\b100) => [SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1064
+ - return 5 (\\b101) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1065
+ - return 6 (\\b110) => [SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1066
+ - return 7 (\\b111) => [SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED, SQL_RESULT_SET_CONCURRENCY_READ_ONLY, SQL_RESULT_SET_CONCURRENCY_UPDATABLE]
1067
+ Valid result set types are described under `arrow.flight.protocol.sql.SqlSupportedResultSetConcurrency`.
1068
+ """
1069
+
1070
+ SQL_BATCH_UPDATES_SUPPORTED = 572
1071
+ """
1072
+
1073
+ Retrieves a boolean value indicating whether this database supports batch updates.
1074
+
1075
+ - false: if this database does not support batch updates;
1076
+ - true: if this database supports batch updates.
1077
+ """
1078
+
1079
+ SQL_SAVEPOINTS_SUPPORTED = 573
1080
+ """
1081
+
1082
+ Retrieves a boolean value indicating whether this database supports savepoints.
1083
+
1084
+ Returns:
1085
+ - false: if this database does not support savepoints;
1086
+ - true: if this database supports savepoints.
1087
+ """
1088
+
1089
+ SQL_NAMED_PARAMETERS_SUPPORTED = 574
1090
+ """
1091
+
1092
+ Retrieves a boolean value indicating whether named parameters are supported in callable statements.
1093
+
1094
+ Returns:
1095
+ - false: if named parameters in callable statements are unsupported;
1096
+ - true: if named parameters in callable statements are supported.
1097
+ """
1098
+
1099
+ SQL_LOCATORS_UPDATE_COPY = 575
1100
+ """
1101
+
1102
+ Retrieves a boolean value indicating whether updates made to a LOB are made on a copy or directly to the LOB.
1103
+
1104
+ Returns:
1105
+ - false: if updates made to a LOB are made directly to the LOB;
1106
+ - true: if updates made to a LOB are made on a copy.
1107
+ """
1108
+
1109
+ SQL_STORED_FUNCTIONS_USING_CALL_SYNTAX_SUPPORTED = 576
1110
+ """
1111
+
1112
+ Retrieves a boolean value indicating whether invoking user-defined or vendor functions
1113
+ using the stored procedure escape syntax is supported.
1114
+
1115
+ Returns:
1116
+ - false: if invoking user-defined or vendor functions using the stored procedure escape syntax is unsupported;
1117
+ - true: if invoking user-defined or vendor functions using the stored procedure escape syntax is supported.
1118
+ """
1119
+
1120
+
1121
+ class SqlNullOrdering(betterproto2.Enum):
1122
+ SQL_NULLS_SORTED_HIGH = 0
1123
+
1124
+ SQL_NULLS_SORTED_LOW = 1
1125
+
1126
+ SQL_NULLS_SORTED_AT_START = 2
1127
+
1128
+ SQL_NULLS_SORTED_AT_END = 3
1129
+
1130
+
1131
+ class SqlOuterJoinsSupportLevel(betterproto2.Enum):
1132
+ SQL_JOINS_UNSUPPORTED = 0
1133
+
1134
+ SQL_LIMITED_OUTER_JOINS = 1
1135
+
1136
+ SQL_FULL_OUTER_JOINS = 2
1137
+
1138
+
1139
+ class SqlSupportedCaseSensitivity(betterproto2.Enum):
1140
+ SQL_CASE_SENSITIVITY_UNKNOWN = 0
1141
+
1142
+ SQL_CASE_SENSITIVITY_CASE_INSENSITIVE = 1
1143
+
1144
+ SQL_CASE_SENSITIVITY_UPPERCASE = 2
1145
+
1146
+ SQL_CASE_SENSITIVITY_LOWERCASE = 3
1147
+
1148
+
1149
+ class SqlSupportedElementActions(betterproto2.Enum):
1150
+ SQL_ELEMENT_IN_PROCEDURE_CALLS = 0
1151
+
1152
+ SQL_ELEMENT_IN_INDEX_DEFINITIONS = 1
1153
+
1154
+ SQL_ELEMENT_IN_PRIVILEGE_DEFINITIONS = 2
1155
+
1156
+
1157
+ class SqlSupportedGroupBy(betterproto2.Enum):
1158
+ SQL_GROUP_BY_UNRELATED = 0
1159
+
1160
+ SQL_GROUP_BY_BEYOND_SELECT = 1
1161
+
1162
+
1163
+ class SqlSupportedPositionedCommands(betterproto2.Enum):
1164
+ SQL_POSITIONED_DELETE = 0
1165
+
1166
+ SQL_POSITIONED_UPDATE = 1
1167
+
1168
+
1169
+ class SqlSupportedResultSetConcurrency(betterproto2.Enum):
1170
+ SQL_RESULT_SET_CONCURRENCY_UNSPECIFIED = 0
1171
+
1172
+ SQL_RESULT_SET_CONCURRENCY_READ_ONLY = 1
1173
+
1174
+ SQL_RESULT_SET_CONCURRENCY_UPDATABLE = 2
1175
+
1176
+
1177
+ class SqlSupportedResultSetType(betterproto2.Enum):
1178
+ SQL_RESULT_SET_TYPE_UNSPECIFIED = 0
1179
+
1180
+ SQL_RESULT_SET_TYPE_FORWARD_ONLY = 1
1181
+
1182
+ SQL_RESULT_SET_TYPE_SCROLL_INSENSITIVE = 2
1183
+
1184
+ SQL_RESULT_SET_TYPE_SCROLL_SENSITIVE = 3
1185
+
1186
+
1187
+ class SqlSupportedSubqueries(betterproto2.Enum):
1188
+ SQL_SUBQUERIES_IN_COMPARISONS = 0
1189
+
1190
+ SQL_SUBQUERIES_IN_EXISTS = 1
1191
+
1192
+ SQL_SUBQUERIES_IN_INS = 2
1193
+
1194
+ SQL_SUBQUERIES_IN_QUANTIFIEDS = 3
1195
+
1196
+
1197
+ class SqlSupportedTransaction(betterproto2.Enum):
1198
+ """
1199
+ The level of support for Flight SQL transaction RPCs.
1200
+ """
1201
+
1202
+ NONE = 0
1203
+ """
1204
+ Unknown/not indicated/no support
1205
+ """
1206
+
1207
+ TRANSACTION = 1
1208
+ """
1209
+ Transactions, but not savepoints.
1210
+ A savepoint is a mark within a transaction that can be individually
1211
+ rolled back to. Not all databases support savepoints.
1212
+ """
1213
+
1214
+ SAVEPOINT = 2
1215
+ """
1216
+ Transactions and savepoints
1217
+ """
1218
+
1219
+ @classmethod
1220
+ def betterproto_value_to_renamed_proto_names(cls) -> dict[int, str]:
1221
+ return {
1222
+ 0: "SQL_SUPPORTED_TRANSACTION_NONE",
1223
+ 1: "SQL_SUPPORTED_TRANSACTION_TRANSACTION",
1224
+ 2: "SQL_SUPPORTED_TRANSACTION_SAVEPOINT",
1225
+ }
1226
+
1227
+ @classmethod
1228
+ def betterproto_renamed_proto_names_to_value(cls) -> dict[str, int]:
1229
+ return {
1230
+ "SQL_SUPPORTED_TRANSACTION_NONE": 0,
1231
+ "SQL_SUPPORTED_TRANSACTION_TRANSACTION": 1,
1232
+ "SQL_SUPPORTED_TRANSACTION_SAVEPOINT": 2,
1233
+ }
1234
+
1235
+
1236
+ class SqlSupportedTransactions(betterproto2.Enum):
1237
+ SQL_TRANSACTION_UNSPECIFIED = 0
1238
+
1239
+ SQL_DATA_DEFINITION_TRANSACTIONS = 1
1240
+
1241
+ SQL_DATA_MANIPULATION_TRANSACTIONS = 2
1242
+
1243
+
1244
+ class SqlSupportedUnions(betterproto2.Enum):
1245
+ SQL_UNION = 0
1246
+
1247
+ SQL_UNION_ALL = 1
1248
+
1249
+
1250
+ class SqlSupportsConvert(betterproto2.Enum):
1251
+ SQL_CONVERT_BIGINT = 0
1252
+
1253
+ SQL_CONVERT_BINARY = 1
1254
+
1255
+ SQL_CONVERT_BIT = 2
1256
+
1257
+ SQL_CONVERT_CHAR = 3
1258
+
1259
+ SQL_CONVERT_DATE = 4
1260
+
1261
+ SQL_CONVERT_DECIMAL = 5
1262
+
1263
+ SQL_CONVERT_FLOAT = 6
1264
+
1265
+ SQL_CONVERT_INTEGER = 7
1266
+
1267
+ SQL_CONVERT_INTERVAL_DAY_TIME = 8
1268
+
1269
+ SQL_CONVERT_INTERVAL_YEAR_MONTH = 9
1270
+
1271
+ SQL_CONVERT_LONGVARBINARY = 10
1272
+
1273
+ SQL_CONVERT_LONGVARCHAR = 11
1274
+
1275
+ SQL_CONVERT_NUMERIC = 12
1276
+
1277
+ SQL_CONVERT_REAL = 13
1278
+
1279
+ SQL_CONVERT_SMALLINT = 14
1280
+
1281
+ SQL_CONVERT_TIME = 15
1282
+
1283
+ SQL_CONVERT_TIMESTAMP = 16
1284
+
1285
+ SQL_CONVERT_TINYINT = 17
1286
+
1287
+ SQL_CONVERT_VARBINARY = 18
1288
+
1289
+ SQL_CONVERT_VARCHAR = 19
1290
+
1291
+
1292
+ class SqlTransactionIsolationLevel(betterproto2.Enum):
1293
+ SQL_TRANSACTION_NONE = 0
1294
+
1295
+ SQL_TRANSACTION_READ_UNCOMMITTED = 1
1296
+
1297
+ SQL_TRANSACTION_READ_COMMITTED = 2
1298
+
1299
+ SQL_TRANSACTION_REPEATABLE_READ = 3
1300
+
1301
+ SQL_TRANSACTION_SERIALIZABLE = 4
1302
+
1303
+
1304
+ class SupportedAnsi92SqlGrammarLevel(betterproto2.Enum):
1305
+ ANSI92_ENTRY_SQL = 0
1306
+
1307
+ ANSI92_INTERMEDIATE_SQL = 1
1308
+
1309
+ ANSI92_FULL_SQL = 2
1310
+
1311
+
1312
+ class SupportedSqlGrammar(betterproto2.Enum):
1313
+ SQL_MINIMUM_GRAMMAR = 0
1314
+
1315
+ SQL_CORE_GRAMMAR = 1
1316
+
1317
+ SQL_EXTENDED_GRAMMAR = 2
1318
+
1319
+
1320
+ class UpdateDeleteRules(betterproto2.Enum):
1321
+ CASCADE = 0
1322
+
1323
+ RESTRICT = 1
1324
+
1325
+ SET_NULL = 2
1326
+
1327
+ NO_ACTION = 3
1328
+
1329
+ SET_DEFAULT = 4
1330
+
1331
+
1332
+ class XdbcDataType(betterproto2.Enum):
1333
+ """
1334
+ *
1335
+ The JDBC/ODBC-defined type of any object.
1336
+ All the values here are the same as in the JDBC and ODBC specs.
1337
+ """
1338
+
1339
+ XDBC_UNKNOWN_TYPE = 0
1340
+
1341
+ XDBC_CHAR = 1
1342
+
1343
+ XDBC_NUMERIC = 2
1344
+
1345
+ XDBC_DECIMAL = 3
1346
+
1347
+ XDBC_INTEGER = 4
1348
+
1349
+ XDBC_SMALLINT = 5
1350
+
1351
+ XDBC_FLOAT = 6
1352
+
1353
+ XDBC_REAL = 7
1354
+
1355
+ XDBC_DOUBLE = 8
1356
+
1357
+ XDBC_DATETIME = 9
1358
+
1359
+ XDBC_INTERVAL = 10
1360
+
1361
+ XDBC_VARCHAR = 12
1362
+
1363
+ XDBC_DATE = 91
1364
+
1365
+ XDBC_TIME = 92
1366
+
1367
+ XDBC_TIMESTAMP = 93
1368
+
1369
+ XDBC_LONGVARCHAR = -1
1370
+
1371
+ XDBC_BINARY = -2
1372
+
1373
+ XDBC_VARBINARY = -3
1374
+
1375
+ XDBC_LONGVARBINARY = -4
1376
+
1377
+ XDBC_BIGINT = -5
1378
+
1379
+ XDBC_TINYINT = -6
1380
+
1381
+ XDBC_BIT = -7
1382
+
1383
+ XDBC_WCHAR = -8
1384
+
1385
+ XDBC_WVARCHAR = -9
1386
+
1387
+
1388
+ class XdbcDatetimeSubcode(betterproto2.Enum):
1389
+ """
1390
+ *
1391
+ Detailed subtype information for XDBC_TYPE_DATETIME and XDBC_TYPE_INTERVAL.
1392
+ """
1393
+
1394
+ XDBC_SUBCODE_UNKNOWN = 0
1395
+
1396
+ XDBC_SUBCODE_YEAR = 1
1397
+
1398
+ XDBC_SUBCODE_DATE = 1
1399
+
1400
+ XDBC_SUBCODE_TIME = 2
1401
+
1402
+ XDBC_SUBCODE_MONTH = 2
1403
+
1404
+ XDBC_SUBCODE_TIMESTAMP = 3
1405
+
1406
+ XDBC_SUBCODE_DAY = 3
1407
+
1408
+ XDBC_SUBCODE_TIME_WITH_TIMEZONE = 4
1409
+
1410
+ XDBC_SUBCODE_HOUR = 4
1411
+
1412
+ XDBC_SUBCODE_TIMESTAMP_WITH_TIMEZONE = 5
1413
+
1414
+ XDBC_SUBCODE_MINUTE = 5
1415
+
1416
+ XDBC_SUBCODE_SECOND = 6
1417
+
1418
+ XDBC_SUBCODE_YEAR_TO_MONTH = 7
1419
+
1420
+ XDBC_SUBCODE_DAY_TO_HOUR = 8
1421
+
1422
+ XDBC_SUBCODE_DAY_TO_MINUTE = 9
1423
+
1424
+ XDBC_SUBCODE_DAY_TO_SECOND = 10
1425
+
1426
+ XDBC_SUBCODE_HOUR_TO_MINUTE = 11
1427
+
1428
+ XDBC_SUBCODE_HOUR_TO_SECOND = 12
1429
+
1430
+ XDBC_SUBCODE_MINUTE_TO_SECOND = 13
1431
+
1432
+ XDBC_SUBCODE_INTERVAL_YEAR = 101
1433
+
1434
+ XDBC_SUBCODE_INTERVAL_MONTH = 102
1435
+
1436
+ XDBC_SUBCODE_INTERVAL_DAY = 103
1437
+
1438
+ XDBC_SUBCODE_INTERVAL_HOUR = 104
1439
+
1440
+ XDBC_SUBCODE_INTERVAL_MINUTE = 105
1441
+
1442
+ XDBC_SUBCODE_INTERVAL_SECOND = 106
1443
+
1444
+ XDBC_SUBCODE_INTERVAL_YEAR_TO_MONTH = 107
1445
+
1446
+ XDBC_SUBCODE_INTERVAL_DAY_TO_HOUR = 108
1447
+
1448
+ XDBC_SUBCODE_INTERVAL_DAY_TO_MINUTE = 109
1449
+
1450
+ XDBC_SUBCODE_INTERVAL_DAY_TO_SECOND = 110
1451
+
1452
+ XDBC_SUBCODE_INTERVAL_HOUR_TO_MINUTE = 111
1453
+
1454
+ XDBC_SUBCODE_INTERVAL_HOUR_TO_SECOND = 112
1455
+
1456
+ XDBC_SUBCODE_INTERVAL_MINUTE_TO_SECOND = 113
1457
+
1458
+
1459
+ @dataclass(eq=False, repr=False)
1460
+ class ActionBeginSavepointRequest(betterproto2.Message):
1461
+ """
1462
+
1463
+ Request message for the "BeginSavepoint" action.
1464
+ Creates a savepoint within a transaction.
1465
+
1466
+ Only supported if FLIGHT_SQL_TRANSACTION is
1467
+ FLIGHT_SQL_TRANSACTION_SUPPORT_SAVEPOINT.
1468
+ """
1469
+
1470
+ transaction_id: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1471
+ """
1472
+ The transaction to which a savepoint belongs.
1473
+ """
1474
+
1475
+ name: "str" = betterproto2.field(2, betterproto2.TYPE_STRING)
1476
+ """
1477
+ Name for the savepoint.
1478
+ """
1479
+
1480
+
1481
+ default_message_pool.register_message(
1482
+ "arrow.flight.protocol.sql", "ActionBeginSavepointRequest", ActionBeginSavepointRequest
1483
+ )
1484
+
1485
+
1486
+ @dataclass(eq=False, repr=False)
1487
+ class ActionBeginSavepointResult(betterproto2.Message):
1488
+ """
1489
+
1490
+ The result of a "BeginSavepoint" action.
1491
+
1492
+ The transaction can be manipulated with the "EndSavepoint" action.
1493
+ If the associated transaction is committed, rolled back, or times
1494
+ out, then the savepoint is also invalidated.
1495
+
1496
+ The result should be wrapped in a google.protobuf.Any message.
1497
+ """
1498
+
1499
+ savepoint_id: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1500
+ """
1501
+ Opaque handle for the savepoint on the server.
1502
+ """
1503
+
1504
+
1505
+ default_message_pool.register_message(
1506
+ "arrow.flight.protocol.sql", "ActionBeginSavepointResult", ActionBeginSavepointResult
1507
+ )
1508
+
1509
+
1510
+ @dataclass(eq=False, repr=False)
1511
+ class ActionBeginTransactionRequest(betterproto2.Message):
1512
+ """
1513
+
1514
+ Request message for the "BeginTransaction" action.
1515
+ Begins a transaction.
1516
+ """
1517
+
1518
+ pass
1519
+
1520
+
1521
+ default_message_pool.register_message(
1522
+ "arrow.flight.protocol.sql", "ActionBeginTransactionRequest", ActionBeginTransactionRequest
1523
+ )
1524
+
1525
+
1526
+ @dataclass(eq=False, repr=False)
1527
+ class ActionBeginTransactionResult(betterproto2.Message):
1528
+ """
1529
+
1530
+ The result of a "BeginTransaction" action.
1531
+
1532
+ The transaction can be manipulated with the "EndTransaction" action, or
1533
+ automatically via server timeout. If the transaction times out, then it is
1534
+ automatically rolled back.
1535
+
1536
+ The result should be wrapped in a google.protobuf.Any message.
1537
+ """
1538
+
1539
+ transaction_id: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1540
+ """
1541
+ Opaque handle for the transaction on the server.
1542
+ """
1543
+
1544
+
1545
+ default_message_pool.register_message(
1546
+ "arrow.flight.protocol.sql", "ActionBeginTransactionResult", ActionBeginTransactionResult
1547
+ )
1548
+
1549
+
1550
+ @dataclass(eq=False, repr=False)
1551
+ class ActionCancelQueryRequest(betterproto2.Message):
1552
+ """
1553
+
1554
+ Request message for the "CancelQuery" action.
1555
+
1556
+ Explicitly cancel a running query.
1557
+
1558
+ This lets a single client explicitly cancel work, no matter how many clients
1559
+ are involved/whether the query is distributed or not, given server support.
1560
+ The transaction/statement is not rolled back; it is the application's job to
1561
+ commit or rollback as appropriate. This only indicates the client no longer
1562
+ wishes to read the remainder of the query results or continue submitting
1563
+ data.
1564
+
1565
+ This command is idempotent.
1566
+
1567
+ This command is deprecated since 13.0.0. Use the "CancelFlightInfo"
1568
+ action with DoAction instead.
1569
+ """
1570
+
1571
+ info: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1572
+ """
1573
+ The result of the GetFlightInfo RPC that initiated the query.
1574
+ XXX(ARROW-16902): this must be a serialized FlightInfo, but is
1575
+ rendered as bytes because Protobuf does not really support one
1576
+ DLL using Protobuf definitions from another DLL.
1577
+ """
1578
+
1579
+ def __post_init__(self) -> None:
1580
+ warnings.warn("ActionCancelQueryRequest is deprecated", DeprecationWarning)
1581
+ super().__post_init__()
1582
+
1583
+
1584
+ default_message_pool.register_message("arrow.flight.protocol.sql", "ActionCancelQueryRequest", ActionCancelQueryRequest)
1585
+
1586
+
1587
+ @dataclass(eq=False, repr=False)
1588
+ class ActionCancelQueryResult(betterproto2.Message):
1589
+ """
1590
+
1591
+ The result of cancelling a query.
1592
+
1593
+ The result should be wrapped in a google.protobuf.Any message.
1594
+
1595
+ This command is deprecated since 13.0.0. Use the "CancelFlightInfo"
1596
+ action with DoAction instead.
1597
+ """
1598
+
1599
+ result: "ActionCancelQueryResultCancelResult" = betterproto2.field(
1600
+ 1, betterproto2.TYPE_ENUM, default_factory=lambda: ActionCancelQueryResultCancelResult(0)
1601
+ )
1602
+
1603
+ def __post_init__(self) -> None:
1604
+ warnings.warn("ActionCancelQueryResult is deprecated", DeprecationWarning)
1605
+ super().__post_init__()
1606
+
1607
+
1608
+ default_message_pool.register_message("arrow.flight.protocol.sql", "ActionCancelQueryResult", ActionCancelQueryResult)
1609
+
1610
+
1611
+ @dataclass(eq=False, repr=False)
1612
+ class ActionClosePreparedStatementRequest(betterproto2.Message):
1613
+ """
1614
+
1615
+ Request message for the "ClosePreparedStatement" action on a Flight SQL enabled backend.
1616
+ Closes server resources associated with the prepared statement handle.
1617
+ """
1618
+
1619
+ prepared_statement_handle: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1620
+ """
1621
+ Opaque handle for the prepared statement on the server.
1622
+ """
1623
+
1624
+
1625
+ default_message_pool.register_message(
1626
+ "arrow.flight.protocol.sql", "ActionClosePreparedStatementRequest", ActionClosePreparedStatementRequest
1627
+ )
1628
+
1629
+
1630
+ @dataclass(eq=False, repr=False)
1631
+ class ActionCreatePreparedStatementRequest(betterproto2.Message):
1632
+ """
1633
+ Query Execution Action Messages
1634
+
1635
+ Request message for the "CreatePreparedStatement" action on a Flight SQL enabled backend.
1636
+ """
1637
+
1638
+ query: "str" = betterproto2.field(1, betterproto2.TYPE_STRING)
1639
+ """
1640
+ The valid SQL string to create a prepared statement for.
1641
+ """
1642
+
1643
+ transaction_id: "bytes | None" = betterproto2.field(2, betterproto2.TYPE_BYTES, optional=True)
1644
+ """
1645
+ Create/execute the prepared statement as part of this transaction (if
1646
+ unset, executions of the prepared statement will be auto-committed).
1647
+ """
1648
+
1649
+
1650
+ default_message_pool.register_message(
1651
+ "arrow.flight.protocol.sql", "ActionCreatePreparedStatementRequest", ActionCreatePreparedStatementRequest
1652
+ )
1653
+
1654
+
1655
+ @dataclass(eq=False, repr=False)
1656
+ class ActionCreatePreparedStatementResult(betterproto2.Message):
1657
+ """
1658
+
1659
+ Wrap the result of a "CreatePreparedStatement" or "CreatePreparedSubstraitPlan" action.
1660
+
1661
+ The resultant PreparedStatement can be closed either:
1662
+ - Manually, through the "ClosePreparedStatement" action;
1663
+ - Automatically, by a server timeout.
1664
+
1665
+ The result should be wrapped in a google.protobuf.Any message.
1666
+ """
1667
+
1668
+ prepared_statement_handle: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1669
+ """
1670
+ Opaque handle for the prepared statement on the server.
1671
+ """
1672
+
1673
+ dataset_schema: "bytes" = betterproto2.field(2, betterproto2.TYPE_BYTES)
1674
+ """
1675
+ If a result set generating query was provided, dataset_schema contains the
1676
+ schema of the result set. It should be an IPC-encapsulated Schema, as described in Schema.fbs.
1677
+ For some queries, the schema of the results may depend on the schema of the parameters. The server
1678
+ should provide its best guess as to the schema at this point. Clients must not assume that this
1679
+ schema, if provided, will be accurate.
1680
+ """
1681
+
1682
+ parameter_schema: "bytes" = betterproto2.field(3, betterproto2.TYPE_BYTES)
1683
+ """
1684
+ If the query provided contained parameters, parameter_schema contains the
1685
+ schema of the expected parameters. It should be an IPC-encapsulated Schema, as described in Schema.fbs.
1686
+ """
1687
+
1688
+
1689
+ default_message_pool.register_message(
1690
+ "arrow.flight.protocol.sql", "ActionCreatePreparedStatementResult", ActionCreatePreparedStatementResult
1691
+ )
1692
+
1693
+
1694
+ @dataclass(eq=False, repr=False)
1695
+ class ActionCreatePreparedSubstraitPlanRequest(betterproto2.Message):
1696
+ """
1697
+
1698
+ Request message for the "CreatePreparedSubstraitPlan" action on a Flight SQL enabled backend.
1699
+ """
1700
+
1701
+ plan: "SubstraitPlan | None" = betterproto2.field(1, betterproto2.TYPE_MESSAGE, optional=True)
1702
+ """
1703
+ The serialized substrait.Plan to create a prepared statement for.
1704
+ """
1705
+
1706
+ transaction_id: "bytes | None" = betterproto2.field(2, betterproto2.TYPE_BYTES, optional=True)
1707
+ """
1708
+ Create/execute the prepared statement as part of this transaction (if
1709
+ unset, executions of the prepared statement will be auto-committed).
1710
+ """
1711
+
1712
+
1713
+ default_message_pool.register_message(
1714
+ "arrow.flight.protocol.sql", "ActionCreatePreparedSubstraitPlanRequest", ActionCreatePreparedSubstraitPlanRequest
1715
+ )
1716
+
1717
+
1718
+ @dataclass(eq=False, repr=False)
1719
+ class ActionEndSavepointRequest(betterproto2.Message):
1720
+ """
1721
+
1722
+ Request message for the "EndSavepoint" action.
1723
+
1724
+ Release (RELEASE) the savepoint or rollback (ROLLBACK) to the
1725
+ savepoint.
1726
+
1727
+ Releasing a savepoint invalidates that savepoint. Rolling back to
1728
+ a savepoint does not invalidate the savepoint, but invalidates all
1729
+ savepoints created after the current savepoint.
1730
+ """
1731
+
1732
+ savepoint_id: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1733
+ """
1734
+ Opaque handle for the savepoint on the server.
1735
+ """
1736
+
1737
+ action: "ActionEndSavepointRequestEndSavepoint" = betterproto2.field(
1738
+ 2, betterproto2.TYPE_ENUM, default_factory=lambda: ActionEndSavepointRequestEndSavepoint(0)
1739
+ )
1740
+ """
1741
+ Whether to rollback/release the given savepoint.
1742
+ """
1743
+
1744
+
1745
+ default_message_pool.register_message(
1746
+ "arrow.flight.protocol.sql", "ActionEndSavepointRequest", ActionEndSavepointRequest
1747
+ )
1748
+
1749
+
1750
+ @dataclass(eq=False, repr=False)
1751
+ class ActionEndTransactionRequest(betterproto2.Message):
1752
+ """
1753
+
1754
+ Request message for the "EndTransaction" action.
1755
+
1756
+ Commit (COMMIT) or rollback (ROLLBACK) the transaction.
1757
+
1758
+ If the action completes successfully, the transaction handle is
1759
+ invalidated, as are all associated savepoints.
1760
+ """
1761
+
1762
+ transaction_id: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
1763
+ """
1764
+ Opaque handle for the transaction on the server.
1765
+ """
1766
+
1767
+ action: "ActionEndTransactionRequestEndTransaction" = betterproto2.field(
1768
+ 2, betterproto2.TYPE_ENUM, default_factory=lambda: ActionEndTransactionRequestEndTransaction(0)
1769
+ )
1770
+ """
1771
+ Whether to commit/rollback the given transaction.
1772
+ """
1773
+
1774
+
1775
+ default_message_pool.register_message(
1776
+ "arrow.flight.protocol.sql", "ActionEndTransactionRequest", ActionEndTransactionRequest
1777
+ )
1778
+
1779
+
1780
+ @dataclass(eq=False, repr=False)
1781
+ class CommandGetCatalogs(betterproto2.Message):
1782
+ """
1783
+
1784
+ Represents a request to retrieve the list of catalogs on a Flight SQL enabled backend.
1785
+ The definition of a catalog depends on vendor/implementation. It is usually the database itself
1786
+ Used in the command member of FlightDescriptor for the following RPC calls:
1787
+ - GetSchema: return the Arrow schema of the query.
1788
+ - GetFlightInfo: execute the catalog metadata request.
1789
+
1790
+ The returned Arrow schema will be:
1791
+ <
1792
+ catalog_name: utf8 not null
1793
+ >
1794
+ The returned data should be ordered by catalog_name.
1795
+ """
1796
+
1797
+ pass
1798
+
1799
+
1800
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetCatalogs", CommandGetCatalogs)
1801
+
1802
+
1803
+ @dataclass(eq=False, repr=False)
1804
+ class CommandGetCrossReference(betterproto2.Message):
1805
+ """
1806
+
1807
+ Represents a request to retrieve a description of the foreign key columns in the given foreign key table that
1808
+ reference the primary key or the columns representing a unique constraint of the parent table (could be the same
1809
+ or a different table) on a Flight SQL enabled backend.
1810
+ Used in the command member of FlightDescriptor for the following RPC calls:
1811
+ - GetSchema: return the Arrow schema of the query.
1812
+ - GetFlightInfo: execute the catalog metadata request.
1813
+
1814
+ The returned Arrow schema will be:
1815
+ <
1816
+ pk_catalog_name: utf8,
1817
+ pk_db_schema_name: utf8,
1818
+ pk_table_name: utf8 not null,
1819
+ pk_column_name: utf8 not null,
1820
+ fk_catalog_name: utf8,
1821
+ fk_db_schema_name: utf8,
1822
+ fk_table_name: utf8 not null,
1823
+ fk_column_name: utf8 not null,
1824
+ key_sequence: int32 not null,
1825
+ fk_key_name: utf8,
1826
+ pk_key_name: utf8,
1827
+ update_rule: uint8 not null,
1828
+ delete_rule: uint8 not null
1829
+ >
1830
+ The returned data should be ordered by pk_catalog_name, pk_db_schema_name, pk_table_name, pk_key_name, then key_sequence.
1831
+ update_rule and delete_rule returns a byte that is equivalent to actions:
1832
+ - 0 = CASCADE
1833
+ - 1 = RESTRICT
1834
+ - 2 = SET NULL
1835
+ - 3 = NO ACTION
1836
+ - 4 = SET DEFAULT
1837
+ """
1838
+
1839
+ pk_catalog: "str | None" = betterproto2.field(1, betterproto2.TYPE_STRING, optional=True)
1840
+ """
1841
+ *
1842
+ The catalog name where the parent table is.
1843
+ An empty string retrieves those without a catalog.
1844
+ If omitted the catalog name should not be used to narrow the search.
1845
+ """
1846
+
1847
+ pk_db_schema: "str | None" = betterproto2.field(2, betterproto2.TYPE_STRING, optional=True)
1848
+ """
1849
+ *
1850
+ The Schema name where the parent table is.
1851
+ An empty string retrieves those without a schema.
1852
+ If omitted the schema name should not be used to narrow the search.
1853
+ """
1854
+
1855
+ pk_table: "str" = betterproto2.field(3, betterproto2.TYPE_STRING)
1856
+ """
1857
+ *
1858
+ The parent table name. It cannot be null.
1859
+ """
1860
+
1861
+ fk_catalog: "str | None" = betterproto2.field(4, betterproto2.TYPE_STRING, optional=True)
1862
+ """
1863
+ *
1864
+ The catalog name where the foreign table is.
1865
+ An empty string retrieves those without a catalog.
1866
+ If omitted the catalog name should not be used to narrow the search.
1867
+ """
1868
+
1869
+ fk_db_schema: "str | None" = betterproto2.field(5, betterproto2.TYPE_STRING, optional=True)
1870
+ """
1871
+ *
1872
+ The schema name where the foreign table is.
1873
+ An empty string retrieves those without a schema.
1874
+ If omitted the schema name should not be used to narrow the search.
1875
+ """
1876
+
1877
+ fk_table: "str" = betterproto2.field(6, betterproto2.TYPE_STRING)
1878
+ """
1879
+ *
1880
+ The foreign table name. It cannot be null.
1881
+ """
1882
+
1883
+
1884
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetCrossReference", CommandGetCrossReference)
1885
+
1886
+
1887
+ @dataclass(eq=False, repr=False)
1888
+ class CommandGetDbSchemas(betterproto2.Message):
1889
+ """
1890
+
1891
+ Represents a request to retrieve the list of database schemas on a Flight SQL enabled backend.
1892
+ The definition of a database schema depends on vendor/implementation. It is usually a collection of tables.
1893
+ Used in the command member of FlightDescriptor for the following RPC calls:
1894
+ - GetSchema: return the Arrow schema of the query.
1895
+ - GetFlightInfo: execute the catalog metadata request.
1896
+
1897
+ The returned Arrow schema will be:
1898
+ <
1899
+ catalog_name: utf8,
1900
+ db_schema_name: utf8 not null
1901
+ >
1902
+ The returned data should be ordered by catalog_name, then db_schema_name.
1903
+ """
1904
+
1905
+ catalog: "str | None" = betterproto2.field(1, betterproto2.TYPE_STRING, optional=True)
1906
+ """
1907
+
1908
+ Specifies the Catalog to search for the tables.
1909
+ An empty string retrieves those without a catalog.
1910
+ If omitted the catalog name should not be used to narrow the search.
1911
+ """
1912
+
1913
+ db_schema_filter_pattern: "str | None" = betterproto2.field(2, betterproto2.TYPE_STRING, optional=True)
1914
+ """
1915
+
1916
+ Specifies a filter pattern for schemas to search for.
1917
+ When no db_schema_filter_pattern is provided, the pattern will not be used to narrow the search.
1918
+ In the pattern string, two special characters can be used to denote matching rules:
1919
+ - "%" means to match any substring with 0 or more characters.
1920
+ - "_" means to match any one character.
1921
+ """
1922
+
1923
+
1924
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetDbSchemas", CommandGetDbSchemas)
1925
+
1926
+
1927
+ @dataclass(eq=False, repr=False)
1928
+ class CommandGetExportedKeys(betterproto2.Message):
1929
+ """
1930
+
1931
+ Represents a request to retrieve a description of the foreign key columns that reference the given table's
1932
+ primary key columns (the foreign keys exported by a table) of a table on a Flight SQL enabled backend.
1933
+ Used in the command member of FlightDescriptor for the following RPC calls:
1934
+ - GetSchema: return the Arrow schema of the query.
1935
+ - GetFlightInfo: execute the catalog metadata request.
1936
+
1937
+ The returned Arrow schema will be:
1938
+ <
1939
+ pk_catalog_name: utf8,
1940
+ pk_db_schema_name: utf8,
1941
+ pk_table_name: utf8 not null,
1942
+ pk_column_name: utf8 not null,
1943
+ fk_catalog_name: utf8,
1944
+ fk_db_schema_name: utf8,
1945
+ fk_table_name: utf8 not null,
1946
+ fk_column_name: utf8 not null,
1947
+ key_sequence: int32 not null,
1948
+ fk_key_name: utf8,
1949
+ pk_key_name: utf8,
1950
+ update_rule: uint8 not null,
1951
+ delete_rule: uint8 not null
1952
+ >
1953
+ The returned data should be ordered by fk_catalog_name, fk_db_schema_name, fk_table_name, fk_key_name, then key_sequence.
1954
+ update_rule and delete_rule returns a byte that is equivalent to actions declared on UpdateDeleteRules enum.
1955
+ """
1956
+
1957
+ catalog: "str | None" = betterproto2.field(1, betterproto2.TYPE_STRING, optional=True)
1958
+ """
1959
+
1960
+ Specifies the catalog to search for the foreign key table.
1961
+ An empty string retrieves those without a catalog.
1962
+ If omitted the catalog name should not be used to narrow the search.
1963
+ """
1964
+
1965
+ db_schema: "str | None" = betterproto2.field(2, betterproto2.TYPE_STRING, optional=True)
1966
+ """
1967
+
1968
+ Specifies the schema to search for the foreign key table.
1969
+ An empty string retrieves those without a schema.
1970
+ If omitted the schema name should not be used to narrow the search.
1971
+ """
1972
+
1973
+ table: "str" = betterproto2.field(3, betterproto2.TYPE_STRING)
1974
+ """
1975
+ Specifies the foreign key table to get the foreign keys for.
1976
+ """
1977
+
1978
+
1979
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetExportedKeys", CommandGetExportedKeys)
1980
+
1981
+
1982
+ @dataclass(eq=False, repr=False)
1983
+ class CommandGetImportedKeys(betterproto2.Message):
1984
+ """
1985
+
1986
+ Represents a request to retrieve the foreign keys of a table on a Flight SQL enabled backend.
1987
+ Used in the command member of FlightDescriptor for the following RPC calls:
1988
+ - GetSchema: return the Arrow schema of the query.
1989
+ - GetFlightInfo: execute the catalog metadata request.
1990
+
1991
+ The returned Arrow schema will be:
1992
+ <
1993
+ pk_catalog_name: utf8,
1994
+ pk_db_schema_name: utf8,
1995
+ pk_table_name: utf8 not null,
1996
+ pk_column_name: utf8 not null,
1997
+ fk_catalog_name: utf8,
1998
+ fk_db_schema_name: utf8,
1999
+ fk_table_name: utf8 not null,
2000
+ fk_column_name: utf8 not null,
2001
+ key_sequence: int32 not null,
2002
+ fk_key_name: utf8,
2003
+ pk_key_name: utf8,
2004
+ update_rule: uint8 not null,
2005
+ delete_rule: uint8 not null
2006
+ >
2007
+ The returned data should be ordered by pk_catalog_name, pk_db_schema_name, pk_table_name, pk_key_name, then key_sequence.
2008
+ update_rule and delete_rule returns a byte that is equivalent to actions:
2009
+ - 0 = CASCADE
2010
+ - 1 = RESTRICT
2011
+ - 2 = SET NULL
2012
+ - 3 = NO ACTION
2013
+ - 4 = SET DEFAULT
2014
+ """
2015
+
2016
+ catalog: "str | None" = betterproto2.field(1, betterproto2.TYPE_STRING, optional=True)
2017
+ """
2018
+
2019
+ Specifies the catalog to search for the primary key table.
2020
+ An empty string retrieves those without a catalog.
2021
+ If omitted the catalog name should not be used to narrow the search.
2022
+ """
2023
+
2024
+ db_schema: "str | None" = betterproto2.field(2, betterproto2.TYPE_STRING, optional=True)
2025
+ """
2026
+
2027
+ Specifies the schema to search for the primary key table.
2028
+ An empty string retrieves those without a schema.
2029
+ If omitted the schema name should not be used to narrow the search.
2030
+ """
2031
+
2032
+ table: "str" = betterproto2.field(3, betterproto2.TYPE_STRING)
2033
+ """
2034
+ Specifies the primary key table to get the foreign keys for.
2035
+ """
2036
+
2037
+
2038
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetImportedKeys", CommandGetImportedKeys)
2039
+
2040
+
2041
+ @dataclass(eq=False, repr=False)
2042
+ class CommandGetPrimaryKeys(betterproto2.Message):
2043
+ """
2044
+
2045
+ Represents a request to retrieve the primary keys of a table on a Flight SQL enabled backend.
2046
+ Used in the command member of FlightDescriptor for the following RPC calls:
2047
+ - GetSchema: return the Arrow schema of the query.
2048
+ - GetFlightInfo: execute the catalog metadata request.
2049
+
2050
+ The returned Arrow schema will be:
2051
+ <
2052
+ catalog_name: utf8,
2053
+ db_schema_name: utf8,
2054
+ table_name: utf8 not null,
2055
+ column_name: utf8 not null,
2056
+ key_name: utf8,
2057
+ key_sequence: int32 not null
2058
+ >
2059
+ The returned data should be ordered by catalog_name, db_schema_name, table_name, key_name, then key_sequence.
2060
+ """
2061
+
2062
+ catalog: "str | None" = betterproto2.field(1, betterproto2.TYPE_STRING, optional=True)
2063
+ """
2064
+
2065
+ Specifies the catalog to search for the table.
2066
+ An empty string retrieves those without a catalog.
2067
+ If omitted the catalog name should not be used to narrow the search.
2068
+ """
2069
+
2070
+ db_schema: "str | None" = betterproto2.field(2, betterproto2.TYPE_STRING, optional=True)
2071
+ """
2072
+
2073
+ Specifies the schema to search for the table.
2074
+ An empty string retrieves those without a schema.
2075
+ If omitted the schema name should not be used to narrow the search.
2076
+ """
2077
+
2078
+ table: "str" = betterproto2.field(3, betterproto2.TYPE_STRING)
2079
+ """
2080
+ Specifies the table to get the primary keys for.
2081
+ """
2082
+
2083
+
2084
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetPrimaryKeys", CommandGetPrimaryKeys)
2085
+
2086
+
2087
+ @dataclass(eq=False, repr=False)
2088
+ class CommandGetSqlInfo(betterproto2.Message):
2089
+ """
2090
+
2091
+ Represents a metadata request. Used in the command member of FlightDescriptor
2092
+ for the following RPC calls:
2093
+ - GetSchema: return the Arrow schema of the query.
2094
+ - GetFlightInfo: execute the metadata request.
2095
+
2096
+ The returned Arrow schema will be:
2097
+ <
2098
+ info_name: uint32 not null,
2099
+ value: dense_union<
2100
+ string_value: utf8,
2101
+ bool_value: bool,
2102
+ bigint_value: int64,
2103
+ int32_bitmask: int32,
2104
+ string_list: list<string_data: utf8>
2105
+ int32_to_int32_list_map: map<key: int32, value: list<$data$: int32>>
2106
+ >
2107
+ where there is one row per requested piece of metadata information.
2108
+ """
2109
+
2110
+ info: "list[int]" = betterproto2.field(1, betterproto2.TYPE_UINT32, repeated=True)
2111
+ """
2112
+
2113
+ Values are modelled after ODBC's SQLGetInfo() function. This information is intended to provide
2114
+ Flight SQL clients with basic, SQL syntax and SQL functions related information.
2115
+ More information types can be added in future releases.
2116
+ E.g. more SQL syntax support types, scalar functions support, type conversion support etc.
2117
+
2118
+ Note that the set of metadata may expand.
2119
+
2120
+ Initially, Flight SQL will support the following information types:
2121
+ - Server Information - Range [0-500)
2122
+ - Syntax Information - Range [500-1000)
2123
+ Range [0-10,000) is reserved for defaults (see SqlInfo enum for default options).
2124
+ Custom options should start at 10,000.
2125
+
2126
+ If omitted, then all metadata will be retrieved.
2127
+ Flight SQL Servers may choose to include additional metadata above and beyond the specified set, however they must
2128
+ at least return the specified set. IDs ranging from 0 to 10,000 (exclusive) are reserved for future use.
2129
+ If additional metadata is included, the metadata IDs should start from 10,000.
2130
+ """
2131
+
2132
+
2133
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetSqlInfo", CommandGetSqlInfo)
2134
+
2135
+
2136
+ @dataclass(eq=False, repr=False)
2137
+ class CommandGetTables(betterproto2.Message):
2138
+ """
2139
+
2140
+ Represents a request to retrieve the list of tables, and optionally their schemas, on a Flight SQL enabled backend.
2141
+ Used in the command member of FlightDescriptor for the following RPC calls:
2142
+ - GetSchema: return the Arrow schema of the query.
2143
+ - GetFlightInfo: execute the catalog metadata request.
2144
+
2145
+ The returned Arrow schema will be:
2146
+ <
2147
+ catalog_name: utf8,
2148
+ db_schema_name: utf8,
2149
+ table_name: utf8 not null,
2150
+ table_type: utf8 not null,
2151
+ [optional] table_schema: bytes not null (schema of the table as described in Schema.fbs::Schema,
2152
+ it is serialized as an IPC message.)
2153
+ >
2154
+ Fields on table_schema may contain the following metadata:
2155
+ - ARROW:FLIGHT:SQL:CATALOG_NAME - Table's catalog name
2156
+ - ARROW:FLIGHT:SQL:DB_SCHEMA_NAME - Database schema name
2157
+ - ARROW:FLIGHT:SQL:TABLE_NAME - Table name
2158
+ - ARROW:FLIGHT:SQL:TYPE_NAME - The data source-specific name for the data type of the column.
2159
+ - ARROW:FLIGHT:SQL:PRECISION - Column precision/size
2160
+ - ARROW:FLIGHT:SQL:SCALE - Column scale/decimal digits if applicable
2161
+ - ARROW:FLIGHT:SQL:IS_AUTO_INCREMENT - "1" indicates if the column is auto incremented, "0" otherwise.
2162
+ - ARROW:FLIGHT:SQL:IS_CASE_SENSITIVE - "1" indicates if the column is case-sensitive, "0" otherwise.
2163
+ - ARROW:FLIGHT:SQL:IS_READ_ONLY - "1" indicates if the column is read only, "0" otherwise.
2164
+ - ARROW:FLIGHT:SQL:IS_SEARCHABLE - "1" indicates if the column is searchable via WHERE clause, "0" otherwise.
2165
+ The returned data should be ordered by catalog_name, db_schema_name, table_name, then table_type, followed by table_schema if requested.
2166
+ """
2167
+
2168
+ catalog: "str | None" = betterproto2.field(1, betterproto2.TYPE_STRING, optional=True)
2169
+ """
2170
+
2171
+ Specifies the Catalog to search for the tables.
2172
+ An empty string retrieves those without a catalog.
2173
+ If omitted the catalog name should not be used to narrow the search.
2174
+ """
2175
+
2176
+ db_schema_filter_pattern: "str | None" = betterproto2.field(2, betterproto2.TYPE_STRING, optional=True)
2177
+ """
2178
+
2179
+ Specifies a filter pattern for schemas to search for.
2180
+ When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
2181
+ In the pattern string, two special characters can be used to denote matching rules:
2182
+ - "%" means to match any substring with 0 or more characters.
2183
+ - "_" means to match any one character.
2184
+ """
2185
+
2186
+ table_name_filter_pattern: "str | None" = betterproto2.field(3, betterproto2.TYPE_STRING, optional=True)
2187
+ """
2188
+
2189
+ Specifies a filter pattern for tables to search for.
2190
+ When no table_name_filter_pattern is provided, all tables matching other filters are searched.
2191
+ In the pattern string, two special characters can be used to denote matching rules:
2192
+ - "%" means to match any substring with 0 or more characters.
2193
+ - "_" means to match any one character.
2194
+ """
2195
+
2196
+ table_types: "list[str]" = betterproto2.field(4, betterproto2.TYPE_STRING, repeated=True)
2197
+ """
2198
+
2199
+ Specifies a filter of table types which must match.
2200
+ The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
2201
+ TABLE, VIEW, and SYSTEM TABLE are commonly supported.
2202
+ """
2203
+
2204
+ include_schema: "bool" = betterproto2.field(5, betterproto2.TYPE_BOOL)
2205
+ """
2206
+ Specifies if the Arrow schema should be returned for found tables.
2207
+ """
2208
+
2209
+
2210
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetTables", CommandGetTables)
2211
+
2212
+
2213
+ @dataclass(eq=False, repr=False)
2214
+ class CommandGetTableTypes(betterproto2.Message):
2215
+ """
2216
+
2217
+ Represents a request to retrieve the list of table types on a Flight SQL enabled backend.
2218
+ The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
2219
+ TABLE, VIEW, and SYSTEM TABLE are commonly supported.
2220
+ Used in the command member of FlightDescriptor for the following RPC calls:
2221
+ - GetSchema: return the Arrow schema of the query.
2222
+ - GetFlightInfo: execute the catalog metadata request.
2223
+
2224
+ The returned Arrow schema will be:
2225
+ <
2226
+ table_type: utf8 not null
2227
+ >
2228
+ The returned data should be ordered by table_type.
2229
+ """
2230
+
2231
+ pass
2232
+
2233
+
2234
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetTableTypes", CommandGetTableTypes)
2235
+
2236
+
2237
+ @dataclass(eq=False, repr=False)
2238
+ class CommandGetXdbcTypeInfo(betterproto2.Message):
2239
+ """
2240
+
2241
+ Represents a request to retrieve information about data type supported on a Flight SQL enabled backend.
2242
+ Used in the command member of FlightDescriptor for the following RPC calls:
2243
+ - GetSchema: return the schema of the query.
2244
+ - GetFlightInfo: execute the catalog metadata request.
2245
+
2246
+ The returned schema will be:
2247
+ <
2248
+ type_name: utf8 not null (The name of the data type, for example: VARCHAR, INTEGER, etc),
2249
+ data_type: int32 not null (The SQL data type),
2250
+ column_size: int32 (The maximum size supported by that column.
2251
+ In case of exact numeric types, this represents the maximum precision.
2252
+ In case of string types, this represents the character length.
2253
+ In case of datetime data types, this represents the length in characters of the string representation.
2254
+ NULL is returned for data types where column size is not applicable.),
2255
+ literal_prefix: utf8 (Character or characters used to prefix a literal, NULL is returned for
2256
+ data types where a literal prefix is not applicable.),
2257
+ literal_suffix: utf8 (Character or characters used to terminate a literal,
2258
+ NULL is returned for data types where a literal suffix is not applicable.),
2259
+ create_params: list<utf8 not null>
2260
+ (A list of keywords corresponding to which parameters can be used when creating
2261
+ a column for that specific type.
2262
+ NULL is returned if there are no parameters for the data type definition.),
2263
+ nullable: int32 not null (Shows if the data type accepts a NULL value. The possible values can be seen in the
2264
+ Nullable enum.),
2265
+ case_sensitive: bool not null (Shows if a character data type is case-sensitive in collations and comparisons),
2266
+ searchable: int32 not null (Shows how the data type is used in a WHERE clause. The possible values can be seen in the
2267
+ Searchable enum.),
2268
+ unsigned_attribute: bool (Shows if the data type is unsigned. NULL is returned if the attribute is
2269
+ not applicable to the data type or the data type is not numeric.),
2270
+ fixed_prec_scale: bool not null (Shows if the data type has predefined fixed precision and scale.),
2271
+ auto_increment: bool (Shows if the data type is auto incremental. NULL is returned if the attribute
2272
+ is not applicable to the data type or the data type is not numeric.),
2273
+ local_type_name: utf8 (Localized version of the data source-dependent name of the data type. NULL
2274
+ is returned if a localized name is not supported by the data source),
2275
+ minimum_scale: int32 (The minimum scale of the data type on the data source.
2276
+ If a data type has a fixed scale, the MINIMUM_SCALE and MAXIMUM_SCALE
2277
+ columns both contain this value. NULL is returned if scale is not applicable.),
2278
+ maximum_scale: int32 (The maximum scale of the data type on the data source.
2279
+ NULL is returned if scale is not applicable.),
2280
+ sql_data_type: int32 not null (The value of the SQL DATA TYPE which has the same values
2281
+ as data_type value. Except for interval and datetime, which
2282
+ uses generic values. More info about those types can be
2283
+ obtained through datetime_subcode. The possible values can be seen
2284
+ in the XdbcDataType enum.),
2285
+ datetime_subcode: int32 (Only used when the SQL DATA TYPE is interval or datetime. It contains
2286
+ its sub types. For type different from interval and datetime, this value
2287
+ is NULL. The possible values can be seen in the XdbcDatetimeSubcode enum.),
2288
+ num_prec_radix: int32 (If the data type is an approximate numeric type, this column contains
2289
+ the value 2 to indicate that COLUMN_SIZE specifies a number of bits. For
2290
+ exact numeric types, this column contains the value 10 to indicate that
2291
+ column size specifies a number of decimal digits. Otherwise, this column is NULL.),
2292
+ interval_precision: int32 (If the data type is an interval data type, then this column contains the value
2293
+ of the interval leading precision. Otherwise, this column is NULL. This fields
2294
+ is only relevant to be used by ODBC).
2295
+ >
2296
+ The returned data should be ordered by data_type and then by type_name.
2297
+ """
2298
+
2299
+ data_type: "int | None" = betterproto2.field(1, betterproto2.TYPE_INT32, optional=True)
2300
+ """
2301
+
2302
+ Specifies the data type to search for the info.
2303
+ """
2304
+
2305
+
2306
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandGetXdbcTypeInfo", CommandGetXdbcTypeInfo)
2307
+
2308
+
2309
+ @dataclass(eq=False, repr=False)
2310
+ class CommandPreparedStatementQuery(betterproto2.Message):
2311
+ """
2312
+
2313
+ Represents an instance of executing a prepared statement. Used in the command member of FlightDescriptor for
2314
+ the following RPC calls:
2315
+ - GetSchema: return the Arrow schema of the query.
2316
+ Fields on this schema may contain the following metadata:
2317
+ - ARROW:FLIGHT:SQL:CATALOG_NAME - Table's catalog name
2318
+ - ARROW:FLIGHT:SQL:DB_SCHEMA_NAME - Database schema name
2319
+ - ARROW:FLIGHT:SQL:TABLE_NAME - Table name
2320
+ - ARROW:FLIGHT:SQL:TYPE_NAME - The data source-specific name for the data type of the column.
2321
+ - ARROW:FLIGHT:SQL:PRECISION - Column precision/size
2322
+ - ARROW:FLIGHT:SQL:SCALE - Column scale/decimal digits if applicable
2323
+ - ARROW:FLIGHT:SQL:IS_AUTO_INCREMENT - "1" indicates if the column is auto incremented, "0" otherwise.
2324
+ - ARROW:FLIGHT:SQL:IS_CASE_SENSITIVE - "1" indicates if the column is case-sensitive, "0" otherwise.
2325
+ - ARROW:FLIGHT:SQL:IS_READ_ONLY - "1" indicates if the column is read only, "0" otherwise.
2326
+ - ARROW:FLIGHT:SQL:IS_SEARCHABLE - "1" indicates if the column is searchable via WHERE clause, "0" otherwise.
2327
+
2328
+ If the schema is retrieved after parameter values have been bound with DoPut, then the server should account
2329
+ for the parameters when determining the schema.
2330
+ - DoPut: bind parameter values. All of the bound parameter sets will be executed as a single atomic execution.
2331
+ - GetFlightInfo: execute the prepared statement instance.
2332
+ """
2333
+
2334
+ prepared_statement_handle: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
2335
+ """
2336
+ Opaque handle for the prepared statement on the server.
2337
+ """
2338
+
2339
+
2340
+ default_message_pool.register_message(
2341
+ "arrow.flight.protocol.sql", "CommandPreparedStatementQuery", CommandPreparedStatementQuery
2342
+ )
2343
+
2344
+
2345
+ @dataclass(eq=False, repr=False)
2346
+ class CommandPreparedStatementUpdate(betterproto2.Message):
2347
+ """
2348
+
2349
+ Represents a SQL update query. Used in the command member of FlightDescriptor
2350
+ for the RPC call DoPut to cause the server to execute the included
2351
+ prepared statement handle as an update.
2352
+ """
2353
+
2354
+ prepared_statement_handle: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
2355
+ """
2356
+ Opaque handle for the prepared statement on the server.
2357
+ """
2358
+
2359
+
2360
+ default_message_pool.register_message(
2361
+ "arrow.flight.protocol.sql", "CommandPreparedStatementUpdate", CommandPreparedStatementUpdate
2362
+ )
2363
+
2364
+
2365
+ @dataclass(eq=False, repr=False)
2366
+ class CommandStatementQuery(betterproto2.Message):
2367
+ """
2368
+ Query Execution Messages.
2369
+
2370
+ Represents a SQL query. Used in the command member of FlightDescriptor
2371
+ for the following RPC calls:
2372
+ - GetSchema: return the Arrow schema of the query.
2373
+ Fields on this schema may contain the following metadata:
2374
+ - ARROW:FLIGHT:SQL:CATALOG_NAME - Table's catalog name
2375
+ - ARROW:FLIGHT:SQL:DB_SCHEMA_NAME - Database schema name
2376
+ - ARROW:FLIGHT:SQL:TABLE_NAME - Table name
2377
+ - ARROW:FLIGHT:SQL:TYPE_NAME - The data source-specific name for the data type of the column.
2378
+ - ARROW:FLIGHT:SQL:PRECISION - Column precision/size
2379
+ - ARROW:FLIGHT:SQL:SCALE - Column scale/decimal digits if applicable
2380
+ - ARROW:FLIGHT:SQL:IS_AUTO_INCREMENT - "1" indicates if the column is auto incremented, "0" otherwise.
2381
+ - ARROW:FLIGHT:SQL:IS_CASE_SENSITIVE - "1" indicates if the column is case-sensitive, "0" otherwise.
2382
+ - ARROW:FLIGHT:SQL:IS_READ_ONLY - "1" indicates if the column is read only, "0" otherwise.
2383
+ - ARROW:FLIGHT:SQL:IS_SEARCHABLE - "1" indicates if the column is searchable via WHERE clause, "0" otherwise.
2384
+ - GetFlightInfo: execute the query.
2385
+ """
2386
+
2387
+ query: "str" = betterproto2.field(1, betterproto2.TYPE_STRING)
2388
+ """
2389
+ The SQL syntax.
2390
+ """
2391
+
2392
+ transaction_id: "bytes | None" = betterproto2.field(2, betterproto2.TYPE_BYTES, optional=True)
2393
+ """
2394
+ Include the query as part of this transaction (if unset, the query is auto-committed).
2395
+ """
2396
+
2397
+
2398
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandStatementQuery", CommandStatementQuery)
2399
+
2400
+
2401
+ @dataclass(eq=False, repr=False)
2402
+ class CommandStatementSubstraitPlan(betterproto2.Message):
2403
+ """
2404
+
2405
+ Represents a Substrait plan. Used in the command member of FlightDescriptor
2406
+ for the following RPC calls:
2407
+ - GetSchema: return the Arrow schema of the query.
2408
+ Fields on this schema may contain the following metadata:
2409
+ - ARROW:FLIGHT:SQL:CATALOG_NAME - Table's catalog name
2410
+ - ARROW:FLIGHT:SQL:DB_SCHEMA_NAME - Database schema name
2411
+ - ARROW:FLIGHT:SQL:TABLE_NAME - Table name
2412
+ - ARROW:FLIGHT:SQL:TYPE_NAME - The data source-specific name for the data type of the column.
2413
+ - ARROW:FLIGHT:SQL:PRECISION - Column precision/size
2414
+ - ARROW:FLIGHT:SQL:SCALE - Column scale/decimal digits if applicable
2415
+ - ARROW:FLIGHT:SQL:IS_AUTO_INCREMENT - "1" indicates if the column is auto incremented, "0" otherwise.
2416
+ - ARROW:FLIGHT:SQL:IS_CASE_SENSITIVE - "1" indicates if the column is case-sensitive, "0" otherwise.
2417
+ - ARROW:FLIGHT:SQL:IS_READ_ONLY - "1" indicates if the column is read only, "0" otherwise.
2418
+ - ARROW:FLIGHT:SQL:IS_SEARCHABLE - "1" indicates if the column is searchable via WHERE clause, "0" otherwise.
2419
+ - GetFlightInfo: execute the query.
2420
+ - DoPut: execute the query.
2421
+ """
2422
+
2423
+ plan: "SubstraitPlan | None" = betterproto2.field(1, betterproto2.TYPE_MESSAGE, optional=True)
2424
+ """
2425
+ A serialized substrait.Plan
2426
+ """
2427
+
2428
+ transaction_id: "bytes | None" = betterproto2.field(2, betterproto2.TYPE_BYTES, optional=True)
2429
+ """
2430
+ Include the query as part of this transaction (if unset, the query is auto-committed).
2431
+ """
2432
+
2433
+
2434
+ default_message_pool.register_message(
2435
+ "arrow.flight.protocol.sql", "CommandStatementSubstraitPlan", CommandStatementSubstraitPlan
2436
+ )
2437
+
2438
+
2439
+ @dataclass(eq=False, repr=False)
2440
+ class CommandStatementUpdate(betterproto2.Message):
2441
+ """
2442
+
2443
+ Represents a SQL update query. Used in the command member of FlightDescriptor
2444
+ for the RPC call DoPut to cause the server to execute the included SQL update.
2445
+ """
2446
+
2447
+ query: "str" = betterproto2.field(1, betterproto2.TYPE_STRING)
2448
+ """
2449
+ The SQL syntax.
2450
+ """
2451
+
2452
+ transaction_id: "bytes | None" = betterproto2.field(2, betterproto2.TYPE_BYTES, optional=True)
2453
+ """
2454
+ Include the query as part of this transaction (if unset, the query is auto-committed).
2455
+ """
2456
+
2457
+
2458
+ default_message_pool.register_message("arrow.flight.protocol.sql", "CommandStatementUpdate", CommandStatementUpdate)
2459
+
2460
+
2461
+ @dataclass(eq=False, repr=False)
2462
+ class DoPutPreparedStatementResult(betterproto2.Message):
2463
+ """
2464
+ An *optional* response returned when `DoPut` is called with `CommandPreparedStatementQuery`.
2465
+
2466
+ *Note on legacy behavior*: previous versions of the protocol did not return any result for
2467
+ this command, and that behavior should still be supported by clients. In that case, the client
2468
+ can continue as though the fields in this message were not provided or set to sensible default values.
2469
+ """
2470
+
2471
+ prepared_statement_handle: "bytes | None" = betterproto2.field(1, betterproto2.TYPE_BYTES, optional=True)
2472
+ """
2473
+ Represents a (potentially updated) opaque handle for the prepared statement on the server.
2474
+ Because the handle could potentially be updated, any previous handles for this prepared
2475
+ statement should be considered invalid, and all subsequent requests for this prepared
2476
+ statement must use this new handle.
2477
+ The updated handle allows implementing query parameters with stateless services.
2478
+
2479
+ When an updated handle is not provided by the server, clients should contiue
2480
+ using the previous handle provided by `ActionCreatePreparedStatementResonse`.
2481
+ """
2482
+
2483
+
2484
+ default_message_pool.register_message(
2485
+ "arrow.flight.protocol.sql", "DoPutPreparedStatementResult", DoPutPreparedStatementResult
2486
+ )
2487
+
2488
+
2489
+ @dataclass(eq=False, repr=False)
2490
+ class DoPutUpdateResult(betterproto2.Message):
2491
+ """
2492
+
2493
+ Returned from the RPC call DoPut when a CommandStatementUpdate
2494
+ CommandPreparedStatementUpdate was in the request, containing
2495
+ results from the update.
2496
+ """
2497
+
2498
+ record_count: "int" = betterproto2.field(1, betterproto2.TYPE_INT64)
2499
+ """
2500
+ The number of records updated. A return value of -1 represents
2501
+ an unknown updated record count.
2502
+ """
2503
+
2504
+
2505
+ default_message_pool.register_message("arrow.flight.protocol.sql", "DoPutUpdateResult", DoPutUpdateResult)
2506
+
2507
+
2508
+ @dataclass(eq=False, repr=False)
2509
+ class SubstraitPlan(betterproto2.Message):
2510
+ """
2511
+
2512
+ An embedded message describing a Substrait plan to execute.
2513
+ """
2514
+
2515
+ plan: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
2516
+ """
2517
+ The serialized substrait.Plan to create a prepared statement for.
2518
+ XXX(ARROW-16902): this is bytes instead of an embedded message
2519
+ because Protobuf does not really support one DLL using Protobuf
2520
+ definitions from another DLL.
2521
+ """
2522
+
2523
+ version: "str" = betterproto2.field(2, betterproto2.TYPE_STRING)
2524
+ """
2525
+ The Substrait release, e.g. "0.12.0". This information is not
2526
+ tracked in the plan itself, so this is the only way for consumers
2527
+ to potentially know if they can handle the plan.
2528
+ """
2529
+
2530
+
2531
+ default_message_pool.register_message("arrow.flight.protocol.sql", "SubstraitPlan", SubstraitPlan)
2532
+
2533
+
2534
+ @dataclass(eq=False, repr=False)
2535
+ class TicketStatementQuery(betterproto2.Message):
2536
+ """
2537
+ *
2538
+ Represents a ticket resulting from GetFlightInfo with a CommandStatementQuery.
2539
+ This should be used only once and treated as an opaque value, that is, clients should not attempt to parse this.
2540
+ """
2541
+
2542
+ statement_handle: "bytes" = betterproto2.field(1, betterproto2.TYPE_BYTES)
2543
+ """
2544
+ Unique identifier for the instance of the statement to execute.
2545
+ """
2546
+
2547
+
2548
+ default_message_pool.register_message("arrow.flight.protocol.sql", "TicketStatementQuery", TicketStatementQuery)