snowflake-connector-python 5.2.0__cp315-cp315-win_amd64.whl

snowflake/connector/_internal/protobuf_gen/database_driver_v1_pb2.pyi

@@ -0,0 +1,4487 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+from collections import abc as _abc
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pb2 as _descriptor_pb2
+from google.protobuf import message as _message
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf.internal import extension_dict as _extension_dict
+import builtins as _builtins
+import sys
+import typing as _typing
+
+if sys.version_info >= (3, 11):
+    from typing import TypeAlias as _TypeAlias, Never as _Never
+else:
+    from typing_extensions import TypeAlias as _TypeAlias, Never as _Never
+
+if sys.version_info >= (3, 13):
+    from warnings import deprecated as _deprecated
+else:
+    from typing_extensions import deprecated as _deprecated
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class _ErrorKind:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _ErrorKindEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_ErrorKind.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    ERROR_KIND_UNSPECIFIED: _ErrorKind.ValueType  # 0
+    ERROR_KIND_AUTHENTICATION_ERROR: _ErrorKind.ValueType  # 1
+    ERROR_KIND_NOT_IMPLEMENTED: _ErrorKind.ValueType  # 2
+    ERROR_KIND_INVALID_ARGUMENT: _ErrorKind.ValueType  # 3
+    ERROR_KIND_IO: _ErrorKind.ValueType  # 4
+    ERROR_KIND_CANCELLED: _ErrorKind.ValueType  # 5
+    ERROR_KIND_INTERNAL_ERROR: _ErrorKind.ValueType  # 6
+    """driver invariant violation (locks, parse, spool)"""
+    ERROR_KIND_MISSING_PARAMETER: _ErrorKind.ValueType  # 7
+    ERROR_KIND_INVALID_PARAMETER_VALUE: _ErrorKind.ValueType  # 8
+    ERROR_KIND_LOGIN_ERROR: _ErrorKind.ValueType  # 9
+    ERROR_KIND_LOCAL_FILE_NOT_FOUND: _ErrorKind.ValueType  # 10
+    ERROR_KIND_REMOTE_FILE_NOT_FOUND: _ErrorKind.ValueType  # 11
+    ERROR_KIND_UNSUPPORTED_COMPRESSION: _ErrorKind.ValueType  # 12
+    ERROR_KIND_QUERY_FAILED: _ErrorKind.ValueType  # 13
+    """Snowflake query failure (syntax, missing object, ...)"""
+    ERROR_KIND_TIMEOUT: _ErrorKind.ValueType  # 14
+    ERROR_KIND_STAGE_BINDING: _ErrorKind.ValueType  # 15
+
+class ErrorKind(_ErrorKind, metaclass=_ErrorKindEnumTypeWrapper):
+    """classifies a DriverException, wrappers dispatch on `DriverException.kind`."""
+
+ERROR_KIND_UNSPECIFIED: ErrorKind.ValueType  # 0
+ERROR_KIND_AUTHENTICATION_ERROR: ErrorKind.ValueType  # 1
+ERROR_KIND_NOT_IMPLEMENTED: ErrorKind.ValueType  # 2
+ERROR_KIND_INVALID_ARGUMENT: ErrorKind.ValueType  # 3
+ERROR_KIND_IO: ErrorKind.ValueType  # 4
+ERROR_KIND_CANCELLED: ErrorKind.ValueType  # 5
+ERROR_KIND_INTERNAL_ERROR: ErrorKind.ValueType  # 6
+"""driver invariant violation (locks, parse, spool)"""
+ERROR_KIND_MISSING_PARAMETER: ErrorKind.ValueType  # 7
+ERROR_KIND_INVALID_PARAMETER_VALUE: ErrorKind.ValueType  # 8
+ERROR_KIND_LOGIN_ERROR: ErrorKind.ValueType  # 9
+ERROR_KIND_LOCAL_FILE_NOT_FOUND: ErrorKind.ValueType  # 10
+ERROR_KIND_REMOTE_FILE_NOT_FOUND: ErrorKind.ValueType  # 11
+ERROR_KIND_UNSUPPORTED_COMPRESSION: ErrorKind.ValueType  # 12
+ERROR_KIND_QUERY_FAILED: ErrorKind.ValueType  # 13
+"""Snowflake query failure (syntax, missing object, ...)"""
+ERROR_KIND_TIMEOUT: ErrorKind.ValueType  # 14
+ERROR_KIND_STAGE_BINDING: ErrorKind.ValueType  # 15
+Global___ErrorKind: _TypeAlias = ErrorKind  # noqa: Y015
+
+class _IoClass:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _IoClassEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_IoClass.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    IO_CLASS_UNSPECIFIED: _IoClass.ValueType  # 0
+    IO_CLASS_GENERIC: _IoClass.ValueType  # 1
+    IO_CLASS_NETWORK: _IoClass.ValueType  # 2
+    IO_CLASS_FILE_UPLOAD: _IoClass.ValueType  # 3
+    IO_CLASS_FILE_DOWNLOAD: _IoClass.ValueType  # 4
+    IO_CLASS_NO_SPACE_LEFT: _IoClass.ValueType  # 5
+
+class IoClass(_IoClass, metaclass=_IoClassEnumTypeWrapper):
+    """Distinguishes ERROR_KIND_IO failures that share one kind but different
+    legacy JDBC vendor codes. Unset when kind is not ERROR_KIND_IO, and when
+    an I/O failure has no JDBC vendor code.
+    """
+
+IO_CLASS_UNSPECIFIED: IoClass.ValueType  # 0
+IO_CLASS_GENERIC: IoClass.ValueType  # 1
+IO_CLASS_NETWORK: IoClass.ValueType  # 2
+IO_CLASS_FILE_UPLOAD: IoClass.ValueType  # 3
+IO_CLASS_FILE_DOWNLOAD: IoClass.ValueType  # 4
+IO_CLASS_NO_SPACE_LEFT: IoClass.ValueType  # 5
+Global___IoClass: _TypeAlias = IoClass  # noqa: Y015
+
+class _InfoCode:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _InfoCodeEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_InfoCode.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    INFO_CODE_UNSPECIFIED: _InfoCode.ValueType  # 0
+    INFO_CODE_VENDOR_NAME: _InfoCode.ValueType  # 1
+    INFO_CODE_VENDOR_VERSION: _InfoCode.ValueType  # 2
+    INFO_CODE_VENDOR_ARROW_VERSION: _InfoCode.ValueType  # 3
+    INFO_CODE_VENDOR_SQL: _InfoCode.ValueType  # 101
+    INFO_CODE_VENDOR_SUBSTRAIT: _InfoCode.ValueType  # 102
+    INFO_CODE_VENDOR_SUBSTRAIT_MIN_VERSION: _InfoCode.ValueType  # 103
+    INFO_CODE_VENDOR_SUBSTRAIT_MAX_VERSION: _InfoCode.ValueType  # 104
+    INFO_CODE_DRIVER_NAME: _InfoCode.ValueType  # 201
+    INFO_CODE_DRIVER_VERSION: _InfoCode.ValueType  # 202
+    INFO_CODE_DRIVER_ARROW_VERSION: _InfoCode.ValueType  # 203
+    INFO_CODE_DRIVER_ADBC_VERSION: _InfoCode.ValueType  # 204
+
+class InfoCode(_InfoCode, metaclass=_InfoCodeEnumTypeWrapper):
+    """Info codes corresponding to Thrift InfoCode enum"""
+
+INFO_CODE_UNSPECIFIED: InfoCode.ValueType  # 0
+INFO_CODE_VENDOR_NAME: InfoCode.ValueType  # 1
+INFO_CODE_VENDOR_VERSION: InfoCode.ValueType  # 2
+INFO_CODE_VENDOR_ARROW_VERSION: InfoCode.ValueType  # 3
+INFO_CODE_VENDOR_SQL: InfoCode.ValueType  # 101
+INFO_CODE_VENDOR_SUBSTRAIT: InfoCode.ValueType  # 102
+INFO_CODE_VENDOR_SUBSTRAIT_MIN_VERSION: InfoCode.ValueType  # 103
+INFO_CODE_VENDOR_SUBSTRAIT_MAX_VERSION: InfoCode.ValueType  # 104
+INFO_CODE_DRIVER_NAME: InfoCode.ValueType  # 201
+INFO_CODE_DRIVER_VERSION: InfoCode.ValueType  # 202
+INFO_CODE_DRIVER_ARROW_VERSION: InfoCode.ValueType  # 203
+INFO_CODE_DRIVER_ADBC_VERSION: InfoCode.ValueType  # 204
+Global___InfoCode: _TypeAlias = InfoCode  # noqa: Y015
+
+class _CancellationAbortOutcome:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _CancellationAbortOutcomeEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_CancellationAbortOutcome.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    CANCELLATION_ABORT_OUTCOME_UNSPECIFIED: _CancellationAbortOutcome.ValueType  # 0
+    """Required proto3 zero value; never sent. "No abort was issued" — because the
+    error is not a cancellation, or the operation was cancelled before its query
+    reached the server — is carried by the field being absent, so that state has
+    exactly one encoding.
+    """
+    CANCELLATION_ABORT_OUTCOME_ABORTED: _CancellationAbortOutcome.ValueType  # 1
+    """The server acknowledged the abort. Means the abort request was *processed*,
+    NOT a guarantee the query had stopped by the time this was reported.
+    """
+    CANCELLATION_ABORT_OUTCOME_NOT_RUNNING: _CancellationAbortOutcome.ValueType  # 2
+    """The server reported the query was not running, so there was nothing to
+    abort (it had already finished, or never started).
+    """
+    CANCELLATION_ABORT_OUTCOME_NOT_CONFIRMED: _CancellationAbortOutcome.ValueType  # 3
+    """The abort was issued but its result is unknown: the request failed, or it
+    had not finished by the time the cancelled caller was released.
+    """
+
+class CancellationAbortOutcome(_CancellationAbortOutcome, metaclass=_CancellationAbortOutcomeEnumTypeWrapper):
+    """What the abort-request the driver fired *because its operation was cancelled*
+    achieved. Only meaningful on a DriverException whose kind is
+    ERROR_KIND_CANCELLED; it is the answer to "did my cancel actually stop the
+    query on the server", delivered to the caller whose query was cancelled.
+
+    Deliberately not AbortQueryOutcome: that enum answers an explicit abort RPC
+    and reserves failures for the RPC error, whereas here the abort is a side
+    effect of cancellation and its failure has nowhere else to surface.
+    """
+
+CANCELLATION_ABORT_OUTCOME_UNSPECIFIED: CancellationAbortOutcome.ValueType  # 0
+"""Required proto3 zero value; never sent. "No abort was issued" — because the
+error is not a cancellation, or the operation was cancelled before its query
+reached the server — is carried by the field being absent, so that state has
+exactly one encoding.
+"""
+CANCELLATION_ABORT_OUTCOME_ABORTED: CancellationAbortOutcome.ValueType  # 1
+"""The server acknowledged the abort. Means the abort request was *processed*,
+NOT a guarantee the query had stopped by the time this was reported.
+"""
+CANCELLATION_ABORT_OUTCOME_NOT_RUNNING: CancellationAbortOutcome.ValueType  # 2
+"""The server reported the query was not running, so there was nothing to
+abort (it had already finished, or never started).
+"""
+CANCELLATION_ABORT_OUTCOME_NOT_CONFIRMED: CancellationAbortOutcome.ValueType  # 3
+"""The abort was issued but its result is unknown: the request failed, or it
+had not finished by the time the cancelled caller was released.
+"""
+Global___CancellationAbortOutcome: _TypeAlias = CancellationAbortOutcome  # noqa: Y015
+
+class _TokenRequestType:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _TokenRequestTypeEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_TokenRequestType.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    TOKEN_REQUEST_TYPE_UNSPECIFIED: _TokenRequestType.ValueType  # 0
+    TOKEN_REQUEST_TYPE_ISSUE: _TokenRequestType.ValueType  # 1
+    TOKEN_REQUEST_TYPE_RENEW: _TokenRequestType.ValueType  # 2
+
+class TokenRequestType(_TokenRequestType, metaclass=_TokenRequestTypeEnumTypeWrapper): ...
+
+TOKEN_REQUEST_TYPE_UNSPECIFIED: TokenRequestType.ValueType  # 0
+TOKEN_REQUEST_TYPE_ISSUE: TokenRequestType.ValueType  # 1
+TOKEN_REQUEST_TYPE_RENEW: TokenRequestType.ValueType  # 2
+Global___TokenRequestType: _TypeAlias = TokenRequestType  # noqa: Y015
+
+class _AbortQueryOutcome:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _AbortQueryOutcomeEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_AbortQueryOutcome.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    ABORT_QUERY_OUTCOME_UNSPECIFIED: _AbortQueryOutcome.ValueType  # 0
+    ABORT_QUERY_OUTCOME_ABORTED: _AbortQueryOutcome.ValueType  # 1
+    """The query was running and the abort was acknowledged."""
+    ABORT_QUERY_OUTCOME_NOT_RUNNING: _AbortQueryOutcome.ValueType  # 2
+    """The query was not running (e.g. already completed, or never started),
+    so there was nothing to abort.
+    """
+
+class AbortQueryOutcome(_AbortQueryOutcome, metaclass=_AbortQueryOutcomeEnumTypeWrapper):
+    """Outcome of a ConnectionAbortQuery call. Genuine failures (invalid handle,
+    transport errors, ...) are reported as an RPC error, not through this enum.
+    """
+
+ABORT_QUERY_OUTCOME_UNSPECIFIED: AbortQueryOutcome.ValueType  # 0
+ABORT_QUERY_OUTCOME_ABORTED: AbortQueryOutcome.ValueType  # 1
+"""The query was running and the abort was acknowledged."""
+ABORT_QUERY_OUTCOME_NOT_RUNNING: AbortQueryOutcome.ValueType  # 2
+"""The query was not running (e.g. already completed, or never started),
+so there was nothing to abort.
+"""
+Global___AbortQueryOutcome: _TypeAlias = AbortQueryOutcome  # noqa: Y015
+
+class _ChunkFormat:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _ChunkFormatEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_ChunkFormat.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    CHUNK_FORMAT_UNSPECIFIED: _ChunkFormat.ValueType  # 0
+    CHUNK_FORMAT_ARROW_IPC: _ChunkFormat.ValueType  # 1
+    CHUNK_FORMAT_JSON: _ChunkFormat.ValueType  # 2
+
+class ChunkFormat(_ChunkFormat, metaclass=_ChunkFormatEnumTypeWrapper):
+    """Distributed fetch types"""
+
+CHUNK_FORMAT_UNSPECIFIED: ChunkFormat.ValueType  # 0
+CHUNK_FORMAT_ARROW_IPC: ChunkFormat.ValueType  # 1
+CHUNK_FORMAT_JSON: ChunkFormat.ValueType  # 2
+Global___ChunkFormat: _TypeAlias = ChunkFormat  # noqa: Y015
+
+class _ValidationSeverity:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _ValidationSeverityEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_ValidationSeverity.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    VALIDATION_SEVERITY_ERROR: _ValidationSeverity.ValueType  # 0
+    VALIDATION_SEVERITY_WARNING: _ValidationSeverity.ValueType  # 1
+
+class ValidationSeverity(_ValidationSeverity, metaclass=_ValidationSeverityEnumTypeWrapper): ...
+
+VALIDATION_SEVERITY_ERROR: ValidationSeverity.ValueType  # 0
+VALIDATION_SEVERITY_WARNING: ValidationSeverity.ValueType  # 1
+Global___ValidationSeverity: _TypeAlias = ValidationSeverity  # noqa: Y015
+
+class _ValidationCode:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _ValidationCodeEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_ValidationCode.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    VALIDATION_CODE_UNSPECIFIED: _ValidationCode.ValueType  # 0
+    VALIDATION_CODE_MISSING_REQUIRED: _ValidationCode.ValueType  # 1
+    VALIDATION_CODE_INVALID_TYPE: _ValidationCode.ValueType  # 2
+    VALIDATION_CODE_INVALID_VALUE: _ValidationCode.ValueType  # 3
+    VALIDATION_CODE_UNKNOWN_PARAMETER: _ValidationCode.ValueType  # 4
+    VALIDATION_CODE_DEPRECATED_PARAMETER: _ValidationCode.ValueType  # 5
+    VALIDATION_CODE_CONFLICTING_PARAMETERS: _ValidationCode.ValueType  # 6
+    VALIDATION_CODE_CONFLICTING_WIF_PARAMETERS: _ValidationCode.ValueType  # 7
+    """Specialization of CONFLICTING_PARAMETERS for the WIF cross-parameter
+    guards, carried across FFI so wrappers can remap to a native WIF error
+    identity (Python errno=251017) without matching on parameter name.
+    """
+
+class ValidationCode(_ValidationCode, metaclass=_ValidationCodeEnumTypeWrapper): ...
+
+VALIDATION_CODE_UNSPECIFIED: ValidationCode.ValueType  # 0
+VALIDATION_CODE_MISSING_REQUIRED: ValidationCode.ValueType  # 1
+VALIDATION_CODE_INVALID_TYPE: ValidationCode.ValueType  # 2
+VALIDATION_CODE_INVALID_VALUE: ValidationCode.ValueType  # 3
+VALIDATION_CODE_UNKNOWN_PARAMETER: ValidationCode.ValueType  # 4
+VALIDATION_CODE_DEPRECATED_PARAMETER: ValidationCode.ValueType  # 5
+VALIDATION_CODE_CONFLICTING_PARAMETERS: ValidationCode.ValueType  # 6
+VALIDATION_CODE_CONFLICTING_WIF_PARAMETERS: ValidationCode.ValueType  # 7
+"""Specialization of CONFLICTING_PARAMETERS for the WIF cross-parameter
+guards, carried across FFI so wrappers can remap to a native WIF error
+identity (Python errno=251017) without matching on parameter name.
+"""
+Global___ValidationCode: _TypeAlias = ValidationCode  # noqa: Y015
+
+@_typing.final
+class ErrorTraceEntry(_message.Message):
+    """Single entry in an error trace (analogous to a stack-trace frame)"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    FILE_FIELD_NUMBER: _builtins.int
+    LINE_FIELD_NUMBER: _builtins.int
+    COLUMN_FIELD_NUMBER: _builtins.int
+    MESSAGE_FIELD_NUMBER: _builtins.int
+    file: _builtins.str
+    line: _builtins.int
+    column: _builtins.int
+    message: _builtins.str
+    def __init__(
+        self,
+        *,
+        file: _builtins.str = ...,
+        line: _builtins.int = ...,
+        column: _builtins.int = ...,
+        message: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["column", b"column", "file", b"file", "line", b"line", "message", b"message"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ErrorTraceEntry: _TypeAlias = ErrorTraceEntry  # noqa: Y015
+
+@_typing.final
+class DriverException(_message.Message):
+    """Driver exception"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    MESSAGE_FIELD_NUMBER: _builtins.int
+    KIND_FIELD_NUMBER: _builtins.int
+    ERROR_TRACE_FIELD_NUMBER: _builtins.int
+    VENDOR_CODE_FIELD_NUMBER: _builtins.int
+    SQL_STATE_FIELD_NUMBER: _builtins.int
+    ROOT_CAUSE_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    REQUEST_ID_FIELD_NUMBER: _builtins.int
+    PARAMETER_FIELD_NUMBER: _builtins.int
+    PARAMETER_VALUE_FIELD_NUMBER: _builtins.int
+    VALIDATION_CODE_FIELD_NUMBER: _builtins.int
+    REAUTHENTICATION_REQUIRED_FIELD_NUMBER: _builtins.int
+    CANCELLATION_ABORT_OUTCOME_FIELD_NUMBER: _builtins.int
+    IO_CLASS_FIELD_NUMBER: _builtins.int
+    message: _builtins.str
+    kind: Global___ErrorKind.ValueType
+    vendor_code: _builtins.int
+    """Snowflake server error code (e.g. 1003 for syntax error, 904 for invalid identifier).
+    Present when the error originated from a Snowflake server response.
+    """
+    sql_state: _builtins.str
+    """ANSI SQL state code (e.g. "42000" for syntax error).
+    Present when the server provides a sqlState in its response.
+    """
+    root_cause: _builtins.str
+    """The deepest cause in the error chain (root cause).
+    More informative than the top-level message for end users.
+    """
+    query_id: _builtins.str
+    """Snowflake Query ID (sfqid) associated with the failed query, if available."""
+    request_id: _builtins.str
+    """Client-generated UUID v4 sent as ?requestId= on the query submission
+    request. Present when the error originated from a query execution attempt.
+    """
+    parameter: _builtins.str
+    """Offending config/bind parameter name, when the failure is about a parameter."""
+    parameter_value: _builtins.str
+    """Value associated with `parameter`; for conflicts, the other parameter's name."""
+    validation_code: Global___ValidationCode.ValueType
+    """Discriminant for which sf_core validation rule produced this error, when
+    known. Unset when the error did not originate from `validate_settings`.
+    """
+    reauthentication_required: _builtins.bool
+    """True when the session cannot be renewed automatically; the caller must
+    open a new connection. Additive field, default false. The GS code, if
+    any, travels on vendor_code — the same channel every other error type
+    uses — not duplicated here.
+    """
+    cancellation_abort_outcome: Global___CancellationAbortOutcome.ValueType
+    """What the abort-request fired on cancellation achieved. Set only when kind is
+    ERROR_KIND_CANCELLED *and* an abort was actually issued; unset otherwise.
+    """
+    io_class: Global___IoClass.ValueType
+    """Present when kind is ERROR_KIND_IO and the failure has a legacy JDBC vendor code."""
+    @_builtins.property
+    def error_trace(self) -> _containers.RepeatedCompositeFieldContainer[Global___ErrorTraceEntry]: ...
+    def __init__(
+        self,
+        *,
+        message: _builtins.str = ...,
+        kind: Global___ErrorKind.ValueType = ...,
+        error_trace: _abc.Iterable[Global___ErrorTraceEntry] | None = ...,
+        vendor_code: _builtins.int | None = ...,
+        sql_state: _builtins.str | None = ...,
+        root_cause: _builtins.str | None = ...,
+        query_id: _builtins.str | None = ...,
+        request_id: _builtins.str | None = ...,
+        parameter: _builtins.str | None = ...,
+        parameter_value: _builtins.str | None = ...,
+        validation_code: Global___ValidationCode.ValueType | None = ...,
+        reauthentication_required: _builtins.bool = ...,
+        cancellation_abort_outcome: Global___CancellationAbortOutcome.ValueType | None = ...,
+        io_class: Global___IoClass.ValueType | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_cancellation_abort_outcome", b"_cancellation_abort_outcome", "_io_class", b"_io_class", "_parameter", b"_parameter", "_parameter_value", b"_parameter_value", "_query_id", b"_query_id", "_request_id", b"_request_id", "_root_cause", b"_root_cause", "_sql_state", b"_sql_state", "_validation_code", b"_validation_code", "_vendor_code", b"_vendor_code", "cancellation_abort_outcome", b"cancellation_abort_outcome", "io_class", b"io_class", "parameter", b"parameter", "parameter_value", b"parameter_value", "query_id", b"query_id", "request_id", b"request_id", "root_cause", b"root_cause", "sql_state", b"sql_state", "validation_code", b"validation_code", "vendor_code", b"vendor_code"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_cancellation_abort_outcome", b"_cancellation_abort_outcome", "_io_class", b"_io_class", "_parameter", b"_parameter", "_parameter_value", b"_parameter_value", "_query_id", b"_query_id", "_request_id", b"_request_id", "_root_cause", b"_root_cause", "_sql_state", b"_sql_state", "_validation_code", b"_validation_code", "_vendor_code", b"_vendor_code", "cancellation_abort_outcome", b"cancellation_abort_outcome", "error_trace", b"error_trace", "io_class", b"io_class", "kind", b"kind", "message", b"message", "parameter", b"parameter", "parameter_value", b"parameter_value", "query_id", b"query_id", "reauthentication_required", b"reauthentication_required", "request_id", b"request_id", "root_cause", b"root_cause", "sql_state", b"sql_state", "validation_code", b"validation_code", "vendor_code", b"vendor_code"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__cancellation_abort_outcome: _TypeAlias = _typing.Literal["cancellation_abort_outcome"]  # noqa: Y015
+    _WhichOneofArgType__cancellation_abort_outcome: _TypeAlias = _typing.Literal["_cancellation_abort_outcome", b"_cancellation_abort_outcome"]  # noqa: Y015
+    _WhichOneofReturnType__io_class: _TypeAlias = _typing.Literal["io_class"]  # noqa: Y015
+    _WhichOneofArgType__io_class: _TypeAlias = _typing.Literal["_io_class", b"_io_class"]  # noqa: Y015
+    _WhichOneofReturnType__parameter: _TypeAlias = _typing.Literal["parameter"]  # noqa: Y015
+    _WhichOneofArgType__parameter: _TypeAlias = _typing.Literal["_parameter", b"_parameter"]  # noqa: Y015
+    _WhichOneofReturnType__parameter_value: _TypeAlias = _typing.Literal["parameter_value"]  # noqa: Y015
+    _WhichOneofArgType__parameter_value: _TypeAlias = _typing.Literal["_parameter_value", b"_parameter_value"]  # noqa: Y015
+    _WhichOneofReturnType__query_id: _TypeAlias = _typing.Literal["query_id"]  # noqa: Y015
+    _WhichOneofArgType__query_id: _TypeAlias = _typing.Literal["_query_id", b"_query_id"]  # noqa: Y015
+    _WhichOneofReturnType__request_id: _TypeAlias = _typing.Literal["request_id"]  # noqa: Y015
+    _WhichOneofArgType__request_id: _TypeAlias = _typing.Literal["_request_id", b"_request_id"]  # noqa: Y015
+    _WhichOneofReturnType__root_cause: _TypeAlias = _typing.Literal["root_cause"]  # noqa: Y015
+    _WhichOneofArgType__root_cause: _TypeAlias = _typing.Literal["_root_cause", b"_root_cause"]  # noqa: Y015
+    _WhichOneofReturnType__sql_state: _TypeAlias = _typing.Literal["sql_state"]  # noqa: Y015
+    _WhichOneofArgType__sql_state: _TypeAlias = _typing.Literal["_sql_state", b"_sql_state"]  # noqa: Y015
+    _WhichOneofReturnType__validation_code: _TypeAlias = _typing.Literal["validation_code"]  # noqa: Y015
+    _WhichOneofArgType__validation_code: _TypeAlias = _typing.Literal["_validation_code", b"_validation_code"]  # noqa: Y015
+    _WhichOneofReturnType__vendor_code: _TypeAlias = _typing.Literal["vendor_code"]  # noqa: Y015
+    _WhichOneofArgType__vendor_code: _TypeAlias = _typing.Literal["_vendor_code", b"_vendor_code"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__cancellation_abort_outcome) -> _WhichOneofReturnType__cancellation_abort_outcome | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__io_class) -> _WhichOneofReturnType__io_class | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__parameter) -> _WhichOneofReturnType__parameter | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__parameter_value) -> _WhichOneofReturnType__parameter_value | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__query_id) -> _WhichOneofReturnType__query_id | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__request_id) -> _WhichOneofReturnType__request_id | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__root_cause) -> _WhichOneofReturnType__root_cause | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__sql_state) -> _WhichOneofReturnType__sql_state | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__validation_code) -> _WhichOneofReturnType__validation_code | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__vendor_code) -> _WhichOneofReturnType__vendor_code | None: ...
+
+Global___DriverException: _TypeAlias = DriverException  # noqa: Y015
+
+@_typing.final
+class ColumnMetadata(_message.Message):
+    """Column metadata for description"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    NAME_FIELD_NUMBER: _builtins.int
+    TYPE_FIELD_NUMBER: _builtins.int
+    PRECISION_FIELD_NUMBER: _builtins.int
+    SCALE_FIELD_NUMBER: _builtins.int
+    LENGTH_FIELD_NUMBER: _builtins.int
+    BYTE_LENGTH_FIELD_NUMBER: _builtins.int
+    NULLABLE_FIELD_NUMBER: _builtins.int
+    DIMENSION_FIELD_NUMBER: _builtins.int
+    FIXED_FIELD_NUMBER: _builtins.int
+    COLUMN_SRC_DATABASE_FIELD_NUMBER: _builtins.int
+    COLUMN_SRC_SCHEMA_FIELD_NUMBER: _builtins.int
+    COLUMN_SRC_TABLE_FIELD_NUMBER: _builtins.int
+    IS_AUTO_INCREMENT_FIELD_NUMBER: _builtins.int
+    EXT_COL_TYPE_NAME_FIELD_NUMBER: _builtins.int
+    UDT_OUTPUT_TYPE_FIELD_NUMBER: _builtins.int
+    FIELDS_FIELD_NUMBER: _builtins.int
+    name: _builtins.str
+    type: _builtins.str
+    precision: _builtins.int
+    scale: _builtins.int
+    length: _builtins.int
+    byte_length: _builtins.int
+    nullable: _builtins.bool
+    dimension: _builtins.int
+    fixed: _builtins.bool
+    column_src_database: _builtins.str
+    column_src_schema: _builtins.str
+    column_src_table: _builtins.str
+    is_auto_increment: _builtins.bool
+    ext_col_type_name: _builtins.str
+    udt_output_type: _builtins.str
+    @_builtins.property
+    def fields(self) -> _containers.RepeatedCompositeFieldContainer[Global___ColumnMetadata]:
+        """Nested column metadata for structured types. Carries the element type for
+        VECTOR and ARRAY, the key and value types for MAP, and one entry per
+        attribute for structured OBJECT. Empty for every other type, and also for
+        semi-structured (unstructured) ARRAY/OBJECT/MAP, which the server sends
+        without a nested field list.
+        """
+
+    def __init__(
+        self,
+        *,
+        name: _builtins.str = ...,
+        type: _builtins.str = ...,
+        precision: _builtins.int | None = ...,
+        scale: _builtins.int | None = ...,
+        length: _builtins.int | None = ...,
+        byte_length: _builtins.int | None = ...,
+        nullable: _builtins.bool = ...,
+        dimension: _builtins.int | None = ...,
+        fixed: _builtins.bool = ...,
+        column_src_database: _builtins.str = ...,
+        column_src_schema: _builtins.str = ...,
+        column_src_table: _builtins.str = ...,
+        is_auto_increment: _builtins.bool = ...,
+        ext_col_type_name: _builtins.str = ...,
+        udt_output_type: _builtins.str = ...,
+        fields: _abc.Iterable[Global___ColumnMetadata] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_byte_length", b"_byte_length", "_dimension", b"_dimension", "_length", b"_length", "_precision", b"_precision", "_scale", b"_scale", "byte_length", b"byte_length", "dimension", b"dimension", "length", b"length", "precision", b"precision", "scale", b"scale"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_byte_length", b"_byte_length", "_dimension", b"_dimension", "_length", b"_length", "_precision", b"_precision", "_scale", b"_scale", "byte_length", b"byte_length", "column_src_database", b"column_src_database", "column_src_schema", b"column_src_schema", "column_src_table", b"column_src_table", "dimension", b"dimension", "ext_col_type_name", b"ext_col_type_name", "fields", b"fields", "fixed", b"fixed", "is_auto_increment", b"is_auto_increment", "length", b"length", "name", b"name", "nullable", b"nullable", "precision", b"precision", "scale", b"scale", "type", b"type", "udt_output_type", b"udt_output_type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__byte_length: _TypeAlias = _typing.Literal["byte_length"]  # noqa: Y015
+    _WhichOneofArgType__byte_length: _TypeAlias = _typing.Literal["_byte_length", b"_byte_length"]  # noqa: Y015
+    _WhichOneofReturnType__dimension: _TypeAlias = _typing.Literal["dimension"]  # noqa: Y015
+    _WhichOneofArgType__dimension: _TypeAlias = _typing.Literal["_dimension", b"_dimension"]  # noqa: Y015
+    _WhichOneofReturnType__length: _TypeAlias = _typing.Literal["length"]  # noqa: Y015
+    _WhichOneofArgType__length: _TypeAlias = _typing.Literal["_length", b"_length"]  # noqa: Y015
+    _WhichOneofReturnType__precision: _TypeAlias = _typing.Literal["precision"]  # noqa: Y015
+    _WhichOneofArgType__precision: _TypeAlias = _typing.Literal["_precision", b"_precision"]  # noqa: Y015
+    _WhichOneofReturnType__scale: _TypeAlias = _typing.Literal["scale"]  # noqa: Y015
+    _WhichOneofArgType__scale: _TypeAlias = _typing.Literal["_scale", b"_scale"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__byte_length) -> _WhichOneofReturnType__byte_length | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__dimension) -> _WhichOneofReturnType__dimension | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__length) -> _WhichOneofReturnType__length | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__precision) -> _WhichOneofReturnType__precision | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__scale) -> _WhichOneofReturnType__scale | None: ...
+
+Global___ColumnMetadata: _TypeAlias = ColumnMetadata  # noqa: Y015
+
+@_typing.final
+class QueryStats(_message.Message):
+    """DML operation statistics"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    NUM_ROWS_INSERTED_FIELD_NUMBER: _builtins.int
+    NUM_ROWS_UPDATED_FIELD_NUMBER: _builtins.int
+    NUM_ROWS_DELETED_FIELD_NUMBER: _builtins.int
+    NUM_DML_DUPLICATES_FIELD_NUMBER: _builtins.int
+    num_rows_inserted: _builtins.int
+    num_rows_updated: _builtins.int
+    num_rows_deleted: _builtins.int
+    num_dml_duplicates: _builtins.int
+    def __init__(
+        self,
+        *,
+        num_rows_inserted: _builtins.int | None = ...,
+        num_rows_updated: _builtins.int | None = ...,
+        num_rows_deleted: _builtins.int | None = ...,
+        num_dml_duplicates: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_num_dml_duplicates", b"_num_dml_duplicates", "_num_rows_deleted", b"_num_rows_deleted", "_num_rows_inserted", b"_num_rows_inserted", "_num_rows_updated", b"_num_rows_updated", "num_dml_duplicates", b"num_dml_duplicates", "num_rows_deleted", b"num_rows_deleted", "num_rows_inserted", b"num_rows_inserted", "num_rows_updated", b"num_rows_updated"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_num_dml_duplicates", b"_num_dml_duplicates", "_num_rows_deleted", b"_num_rows_deleted", "_num_rows_inserted", b"_num_rows_inserted", "_num_rows_updated", b"_num_rows_updated", "num_dml_duplicates", b"num_dml_duplicates", "num_rows_deleted", b"num_rows_deleted", "num_rows_inserted", b"num_rows_inserted", "num_rows_updated", b"num_rows_updated"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__num_dml_duplicates: _TypeAlias = _typing.Literal["num_dml_duplicates"]  # noqa: Y015
+    _WhichOneofArgType__num_dml_duplicates: _TypeAlias = _typing.Literal["_num_dml_duplicates", b"_num_dml_duplicates"]  # noqa: Y015
+    _WhichOneofReturnType__num_rows_deleted: _TypeAlias = _typing.Literal["num_rows_deleted"]  # noqa: Y015
+    _WhichOneofArgType__num_rows_deleted: _TypeAlias = _typing.Literal["_num_rows_deleted", b"_num_rows_deleted"]  # noqa: Y015
+    _WhichOneofReturnType__num_rows_inserted: _TypeAlias = _typing.Literal["num_rows_inserted"]  # noqa: Y015
+    _WhichOneofArgType__num_rows_inserted: _TypeAlias = _typing.Literal["_num_rows_inserted", b"_num_rows_inserted"]  # noqa: Y015
+    _WhichOneofReturnType__num_rows_updated: _TypeAlias = _typing.Literal["num_rows_updated"]  # noqa: Y015
+    _WhichOneofArgType__num_rows_updated: _TypeAlias = _typing.Literal["_num_rows_updated", b"_num_rows_updated"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__num_dml_duplicates) -> _WhichOneofReturnType__num_dml_duplicates | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__num_rows_deleted) -> _WhichOneofReturnType__num_rows_deleted | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__num_rows_inserted) -> _WhichOneofReturnType__num_rows_inserted | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__num_rows_updated) -> _WhichOneofReturnType__num_rows_updated | None: ...
+
+Global___QueryStats: _TypeAlias = QueryStats  # noqa: Y015
+
+@_typing.final
+class ResultSetDescriptor(_message.Message):
+    """Describes one result set from a (possibly multi-statement) execution."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    COLUMNS_FIELD_NUMBER: _builtins.int
+    ROWS_AFFECTED_FIELD_NUMBER: _builtins.int
+    STATEMENT_TYPE_ID_FIELD_NUMBER: _builtins.int
+    SQL_STATE_FIELD_NUMBER: _builtins.int
+    STATS_FIELD_NUMBER: _builtins.int
+    ROW_COUNT_FIELD_NUMBER: _builtins.int
+    QUERY_RESULT_FORMAT_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    rows_affected: _builtins.int
+    statement_type_id: _builtins.int
+    sql_state: _builtins.str
+    row_count: _builtins.int
+    query_result_format: _builtins.str
+    """Server's `data.queryResultFormat`, verbatim. Absent when the response
+    carried none, as some PUT/GET responses do.
+    """
+    @_builtins.property
+    def columns(self) -> _containers.RepeatedCompositeFieldContainer[Global___ColumnMetadata]: ...
+    @_builtins.property
+    def stats(self) -> Global___QueryStats: ...
+    def __init__(
+        self,
+        *,
+        query_id: _builtins.str = ...,
+        columns: _abc.Iterable[Global___ColumnMetadata] | None = ...,
+        rows_affected: _builtins.int | None = ...,
+        statement_type_id: _builtins.int | None = ...,
+        sql_state: _builtins.str | None = ...,
+        stats: Global___QueryStats | None = ...,
+        row_count: _builtins.int | None = ...,
+        query_result_format: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_query_result_format", b"_query_result_format", "_row_count", b"_row_count", "_rows_affected", b"_rows_affected", "_sql_state", b"_sql_state", "_statement_type_id", b"_statement_type_id", "_stats", b"_stats", "query_result_format", b"query_result_format", "row_count", b"row_count", "rows_affected", b"rows_affected", "sql_state", b"sql_state", "statement_type_id", b"statement_type_id", "stats", b"stats"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_query_result_format", b"_query_result_format", "_row_count", b"_row_count", "_rows_affected", b"_rows_affected", "_sql_state", b"_sql_state", "_statement_type_id", b"_statement_type_id", "_stats", b"_stats", "columns", b"columns", "query_id", b"query_id", "query_result_format", b"query_result_format", "row_count", b"row_count", "rows_affected", b"rows_affected", "sql_state", b"sql_state", "statement_type_id", b"statement_type_id", "stats", b"stats"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__query_result_format: _TypeAlias = _typing.Literal["query_result_format"]  # noqa: Y015
+    _WhichOneofArgType__query_result_format: _TypeAlias = _typing.Literal["_query_result_format", b"_query_result_format"]  # noqa: Y015
+    _WhichOneofReturnType__row_count: _TypeAlias = _typing.Literal["row_count"]  # noqa: Y015
+    _WhichOneofArgType__row_count: _TypeAlias = _typing.Literal["_row_count", b"_row_count"]  # noqa: Y015
+    _WhichOneofReturnType__rows_affected: _TypeAlias = _typing.Literal["rows_affected"]  # noqa: Y015
+    _WhichOneofArgType__rows_affected: _TypeAlias = _typing.Literal["_rows_affected", b"_rows_affected"]  # noqa: Y015
+    _WhichOneofReturnType__sql_state: _TypeAlias = _typing.Literal["sql_state"]  # noqa: Y015
+    _WhichOneofArgType__sql_state: _TypeAlias = _typing.Literal["_sql_state", b"_sql_state"]  # noqa: Y015
+    _WhichOneofReturnType__statement_type_id: _TypeAlias = _typing.Literal["statement_type_id"]  # noqa: Y015
+    _WhichOneofArgType__statement_type_id: _TypeAlias = _typing.Literal["_statement_type_id", b"_statement_type_id"]  # noqa: Y015
+    _WhichOneofReturnType__stats: _TypeAlias = _typing.Literal["stats"]  # noqa: Y015
+    _WhichOneofArgType__stats: _TypeAlias = _typing.Literal["_stats", b"_stats"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__query_result_format) -> _WhichOneofReturnType__query_result_format | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__row_count) -> _WhichOneofReturnType__row_count | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__rows_affected) -> _WhichOneofReturnType__rows_affected | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__sql_state) -> _WhichOneofReturnType__sql_state | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__statement_type_id) -> _WhichOneofReturnType__statement_type_id | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__stats) -> _WhichOneofReturnType__stats | None: ...
+
+Global___ResultSetDescriptor: _TypeAlias = ResultSetDescriptor  # noqa: Y015
+
+@_typing.final
+class ResultSetResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_SET_HANDLE_FIELD_NUMBER: _builtins.int
+    RESULT_DESCRIPTOR_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result_set_handle(self) -> Global___ResultSetHandle: ...
+    @_builtins.property
+    def result_descriptor(self) -> Global___ResultSetDescriptor: ...
+    def __init__(
+        self,
+        *,
+        result_set_handle: Global___ResultSetHandle | None = ...,
+        result_descriptor: Global___ResultSetDescriptor | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result_descriptor", b"result_descriptor", "result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result_descriptor", b"result_descriptor", "result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetResponse: _TypeAlias = ResultSetResponse  # noqa: Y015
+
+@_typing.final
+class MultiStatementResult(_message.Message):
+    """Multi-statement execution: child query IDs and their statement types."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    PARENT_FIELD_NUMBER: _builtins.int
+    QUERY_IDS_FIELD_NUMBER: _builtins.int
+    STATEMENT_TYPE_IDS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def parent(self) -> Global___ResultSetDescriptor: ...
+    @_builtins.property
+    def query_ids(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]: ...
+    @_builtins.property
+    def statement_type_ids(self) -> _containers.RepeatedScalarFieldContainer[_builtins.int]:
+        """Statement type IDs for each child, parallel to query_ids.
+        Used by wrappers to classify results (ResultSet vs update count) without lazy fetch.
+        """
+
+    def __init__(
+        self,
+        *,
+        parent: Global___ResultSetDescriptor | None = ...,
+        query_ids: _abc.Iterable[_builtins.str] | None = ...,
+        statement_type_ids: _abc.Iterable[_builtins.int] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["parent", b"parent"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["parent", b"parent", "query_ids", b"query_ids", "statement_type_ids", b"statement_type_ids"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___MultiStatementResult: _TypeAlias = MultiStatementResult  # noqa: Y015
+
+@_typing.final
+class PartitionedResult(_message.Message):
+    """Partitioned result"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SCHEMA_FIELD_NUMBER: _builtins.int
+    PARTITIONS_FIELD_NUMBER: _builtins.int
+    ROWS_AFFECTED_FIELD_NUMBER: _builtins.int
+    schema: _builtins.int
+    rows_affected: _builtins.int
+    @_builtins.property
+    def partitions(self) -> _containers.RepeatedScalarFieldContainer[_builtins.bytes]: ...
+    def __init__(
+        self,
+        *,
+        schema: _builtins.int = ...,
+        partitions: _abc.Iterable[_builtins.bytes] | None = ...,
+        rows_affected: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_rows_affected", b"_rows_affected", "rows_affected", b"rows_affected"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_rows_affected", b"_rows_affected", "partitions", b"partitions", "rows_affected", b"rows_affected", "schema", b"schema"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__rows_affected: _TypeAlias = _typing.Literal["rows_affected"]  # noqa: Y015
+    _WhichOneofArgType__rows_affected: _TypeAlias = _typing.Literal["_rows_affected", b"_rows_affected"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__rows_affected) -> _WhichOneofReturnType__rows_affected | None: ...
+
+Global___PartitionedResult: _TypeAlias = PartitionedResult  # noqa: Y015
+
+@_typing.final
+class DatabaseHandle(_message.Message):
+    """Database handle"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ID_FIELD_NUMBER: _builtins.int
+    MAGIC_FIELD_NUMBER: _builtins.int
+    id: _builtins.int
+    magic: _builtins.int
+    def __init__(
+        self,
+        *,
+        id: _builtins.int = ...,
+        magic: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["id", b"id", "magic", b"magic"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseHandle: _TypeAlias = DatabaseHandle  # noqa: Y015
+
+@_typing.final
+class ConnectionHandle(_message.Message):
+    """Connection handle"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ID_FIELD_NUMBER: _builtins.int
+    MAGIC_FIELD_NUMBER: _builtins.int
+    id: _builtins.int
+    magic: _builtins.int
+    def __init__(
+        self,
+        *,
+        id: _builtins.int = ...,
+        magic: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["id", b"id", "magic", b"magic"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionHandle: _TypeAlias = ConnectionHandle  # noqa: Y015
+
+@_typing.final
+class StatementHandle(_message.Message):
+    """Statement handle"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ID_FIELD_NUMBER: _builtins.int
+    MAGIC_FIELD_NUMBER: _builtins.int
+    id: _builtins.int
+    magic: _builtins.int
+    def __init__(
+        self,
+        *,
+        id: _builtins.int = ...,
+        magic: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["id", b"id", "magic", b"magic"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementHandle: _TypeAlias = StatementHandle  # noqa: Y015
+
+@_typing.final
+class ResultSetHandle(_message.Message):
+    """ResultSet handle"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ID_FIELD_NUMBER: _builtins.int
+    MAGIC_FIELD_NUMBER: _builtins.int
+    id: _builtins.int
+    magic: _builtins.int
+    def __init__(
+        self,
+        *,
+        id: _builtins.int = ...,
+        magic: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["id", b"id", "magic", b"magic"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetHandle: _TypeAlias = ResultSetHandle  # noqa: Y015
+
+@_typing.final
+class ArrowArrayStreamPtr(_message.Message):
+    """Arrow array stream pointer"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    VALUE_FIELD_NUMBER: _builtins.int
+    value: _builtins.bytes
+    def __init__(
+        self,
+        *,
+        value: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ArrowArrayStreamPtr: _TypeAlias = ArrowArrayStreamPtr  # noqa: Y015
+
+@_typing.final
+class ArrowSchemaPtr(_message.Message):
+    """Arrow schema pointer"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    VALUE_FIELD_NUMBER: _builtins.int
+    value: _builtins.bytes
+    def __init__(
+        self,
+        *,
+        value: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ArrowSchemaPtr: _TypeAlias = ArrowSchemaPtr  # noqa: Y015
+
+@_typing.final
+class BinaryDataPtr(_message.Message):
+    """=============================================================================
+    POINTER TYPES - For passing data references to core
+    =============================================================================
+
+    Pointer to raw binary data in memory with explicit length.
+    Used for passing data from language wrappers without copying.
+
+    Both JSON and CSV use this same pointer type since both point to raw bytes:
+    - JSON: pointer to UTF-8 encoded JSON bytes (e.g., from json_str.encode('utf-8'))
+    - CSV: pointer to raw CSV file bytes
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    VALUE_FIELD_NUMBER: _builtins.int
+    LENGTH_FIELD_NUMBER: _builtins.int
+    value: _builtins.bytes
+    """8-byte pointer (encoded as little-endian)"""
+    length: _builtins.int
+    """Length of data in bytes"""
+    def __init__(
+        self,
+        *,
+        value: _builtins.bytes = ...,
+        length: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["length", b"length", "value", b"value"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___BinaryDataPtr: _TypeAlias = BinaryDataPtr  # noqa: Y015
+
+@_typing.final
+class QueryBindings(_message.Message):
+    """Union of all binding types.
+    Both variants use BinaryDataPtr since both point to raw bytes in memory.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    JSON_FIELD_NUMBER: _builtins.int
+    CSV_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def json(self) -> Global___BinaryDataPtr:
+        """Pointer to UTF-8 encoded JSON bytes"""
+
+    @_builtins.property
+    def csv(self) -> Global___BinaryDataPtr:
+        """Pointer to raw CSV bytes"""
+
+    def __init__(
+        self,
+        *,
+        json: Global___BinaryDataPtr | None = ...,
+        csv: Global___BinaryDataPtr | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["binding_type", b"binding_type", "csv", b"csv", "json", b"json"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["binding_type", b"binding_type", "csv", b"csv", "json", b"json"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType_binding_type: _TypeAlias = _typing.Literal["json", "csv"]  # noqa: Y015
+    _WhichOneofArgType_binding_type: _TypeAlias = _typing.Literal["binding_type", b"binding_type"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_binding_type) -> _WhichOneofReturnType_binding_type | None: ...
+
+Global___QueryBindings: _TypeAlias = QueryBindings  # noqa: Y015
+
+@_typing.final
+class DatabaseNewRequest(_message.Message):
+    """Database service requests and responses"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseNewRequest: _TypeAlias = DatabaseNewRequest  # noqa: Y015
+
+@_typing.final
+class DatabaseNewResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DB_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def db_handle(self) -> Global___DatabaseHandle: ...
+    def __init__(
+        self,
+        *,
+        db_handle: Global___DatabaseHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseNewResponse: _TypeAlias = DatabaseNewResponse  # noqa: Y015
+
+@_typing.final
+class DatabaseInitRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DB_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def db_handle(self) -> Global___DatabaseHandle: ...
+    def __init__(
+        self,
+        *,
+        db_handle: Global___DatabaseHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseInitRequest: _TypeAlias = DatabaseInitRequest  # noqa: Y015
+
+@_typing.final
+class DatabaseInitResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseInitResponse: _TypeAlias = DatabaseInitResponse  # noqa: Y015
+
+@_typing.final
+class DatabaseReleaseRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DB_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def db_handle(self) -> Global___DatabaseHandle: ...
+    def __init__(
+        self,
+        *,
+        db_handle: Global___DatabaseHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseReleaseRequest: _TypeAlias = DatabaseReleaseRequest  # noqa: Y015
+
+@_typing.final
+class DatabaseReleaseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseReleaseResponse: _TypeAlias = DatabaseReleaseResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionNewRequest(_message.Message):
+    """Connection service requests and responses"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionNewRequest: _TypeAlias = ConnectionNewRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionNewResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionNewResponse: _TypeAlias = ConnectionNewResponse  # noqa: Y015
+
+@_typing.final
+class WrapperIdentity(_message.Message):
+    """Identity of the language-specific wrapper invoking core via protobuf."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DRIVER_NAME_FIELD_NUMBER: _builtins.int
+    DRIVER_VERSION_FIELD_NUMBER: _builtins.int
+    LANGUAGE_RUNTIME_FIELD_NUMBER: _builtins.int
+    LANGUAGE_VERSION_FIELD_NUMBER: _builtins.int
+    LANGUAGE_COMPILER_FIELD_NUMBER: _builtins.int
+    RELEASE_TYPE_FIELD_NUMBER: _builtins.int
+    APPLICATION_PATH_FIELD_NUMBER: _builtins.int
+    driver_name: _builtins.str
+    driver_version: _builtins.str
+    language_runtime: _builtins.str
+    language_version: _builtins.str
+    language_compiler: _builtins.str
+    release_type: _builtins.str
+    application_path: _builtins.str
+    def __init__(
+        self,
+        *,
+        driver_name: _builtins.str | None = ...,
+        driver_version: _builtins.str | None = ...,
+        language_runtime: _builtins.str | None = ...,
+        language_version: _builtins.str | None = ...,
+        language_compiler: _builtins.str | None = ...,
+        release_type: _builtins.str | None = ...,
+        application_path: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_application_path", b"_application_path", "_driver_name", b"_driver_name", "_driver_version", b"_driver_version", "_language_compiler", b"_language_compiler", "_language_runtime", b"_language_runtime", "_language_version", b"_language_version", "_release_type", b"_release_type", "application_path", b"application_path", "driver_name", b"driver_name", "driver_version", b"driver_version", "language_compiler", b"language_compiler", "language_runtime", b"language_runtime", "language_version", b"language_version", "release_type", b"release_type"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_application_path", b"_application_path", "_driver_name", b"_driver_name", "_driver_version", b"_driver_version", "_language_compiler", b"_language_compiler", "_language_runtime", b"_language_runtime", "_language_version", b"_language_version", "_release_type", b"_release_type", "application_path", b"application_path", "driver_name", b"driver_name", "driver_version", b"driver_version", "language_compiler", b"language_compiler", "language_runtime", b"language_runtime", "language_version", b"language_version", "release_type", b"release_type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__application_path: _TypeAlias = _typing.Literal["application_path"]  # noqa: Y015
+    _WhichOneofArgType__application_path: _TypeAlias = _typing.Literal["_application_path", b"_application_path"]  # noqa: Y015
+    _WhichOneofReturnType__driver_name: _TypeAlias = _typing.Literal["driver_name"]  # noqa: Y015
+    _WhichOneofArgType__driver_name: _TypeAlias = _typing.Literal["_driver_name", b"_driver_name"]  # noqa: Y015
+    _WhichOneofReturnType__driver_version: _TypeAlias = _typing.Literal["driver_version"]  # noqa: Y015
+    _WhichOneofArgType__driver_version: _TypeAlias = _typing.Literal["_driver_version", b"_driver_version"]  # noqa: Y015
+    _WhichOneofReturnType__language_compiler: _TypeAlias = _typing.Literal["language_compiler"]  # noqa: Y015
+    _WhichOneofArgType__language_compiler: _TypeAlias = _typing.Literal["_language_compiler", b"_language_compiler"]  # noqa: Y015
+    _WhichOneofReturnType__language_runtime: _TypeAlias = _typing.Literal["language_runtime"]  # noqa: Y015
+    _WhichOneofArgType__language_runtime: _TypeAlias = _typing.Literal["_language_runtime", b"_language_runtime"]  # noqa: Y015
+    _WhichOneofReturnType__language_version: _TypeAlias = _typing.Literal["language_version"]  # noqa: Y015
+    _WhichOneofArgType__language_version: _TypeAlias = _typing.Literal["_language_version", b"_language_version"]  # noqa: Y015
+    _WhichOneofReturnType__release_type: _TypeAlias = _typing.Literal["release_type"]  # noqa: Y015
+    _WhichOneofArgType__release_type: _TypeAlias = _typing.Literal["_release_type", b"_release_type"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__application_path) -> _WhichOneofReturnType__application_path | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__driver_name) -> _WhichOneofReturnType__driver_name | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__driver_version) -> _WhichOneofReturnType__driver_version | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__language_compiler) -> _WhichOneofReturnType__language_compiler | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__language_runtime) -> _WhichOneofReturnType__language_runtime | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__language_version) -> _WhichOneofReturnType__language_version | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__release_type) -> _WhichOneofReturnType__release_type | None: ...
+
+Global___WrapperIdentity: _TypeAlias = WrapperIdentity  # noqa: Y015
+
+@_typing.final
+class ConnectionInitRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    DB_HANDLE_FIELD_NUMBER: _builtins.int
+    WRAPPER_IDENTITY_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def db_handle(self) -> Global___DatabaseHandle: ...
+    @_builtins.property
+    def wrapper_identity(self) -> Global___WrapperIdentity:
+        """Wrapper identity — used to emit session_init telemetry during connection init."""
+
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        db_handle: Global___DatabaseHandle | None = ...,
+        wrapper_identity: Global___WrapperIdentity | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_wrapper_identity", b"_wrapper_identity", "conn_handle", b"conn_handle", "db_handle", b"db_handle", "wrapper_identity", b"wrapper_identity"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_wrapper_identity", b"_wrapper_identity", "conn_handle", b"conn_handle", "db_handle", b"db_handle", "wrapper_identity", b"wrapper_identity"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__wrapper_identity: _TypeAlias = _typing.Literal["wrapper_identity"]  # noqa: Y015
+    _WhichOneofArgType__wrapper_identity: _TypeAlias = _typing.Literal["_wrapper_identity", b"_wrapper_identity"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__wrapper_identity) -> _WhichOneofReturnType__wrapper_identity | None: ...
+
+Global___ConnectionInitRequest: _TypeAlias = ConnectionInitRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionInitResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionInitResponse: _TypeAlias = ConnectionInitResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionReleaseRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionReleaseRequest: _TypeAlias = ConnectionReleaseRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionReleaseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionReleaseResponse: _TypeAlias = ConnectionReleaseResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionCloseRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionCloseRequest: _TypeAlias = ConnectionCloseRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionCloseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionCloseResponse: _TypeAlias = ConnectionCloseResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionIsClosedRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionIsClosedRequest: _TypeAlias = ConnectionIsClosedRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionIsClosedResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    IS_CLOSED_FIELD_NUMBER: _builtins.int
+    is_closed: _builtins.bool
+    def __init__(
+        self,
+        *,
+        is_closed: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["is_closed", b"is_closed"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionIsClosedResponse: _TypeAlias = ConnectionIsClosedResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionIsExpiredRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionIsExpiredRequest: _TypeAlias = ConnectionIsExpiredRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionIsExpiredResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    IS_EXPIRED_FIELD_NUMBER: _builtins.int
+    is_expired: _builtins.bool
+    def __init__(
+        self,
+        *,
+        is_expired: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["is_expired", b"is_expired"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionIsExpiredResponse: _TypeAlias = ConnectionIsExpiredResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetInfoRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    INFO_CODES_FIELD_NUMBER: _builtins.int
+    INCLUDE_MASTER_TOKEN_FIELD_NUMBER: _builtins.int
+    include_master_token: _builtins.bool
+    """Opt-in to include sensitive tokens (e.g. master_token) in the response.
+    Defaults to false; only set when the caller needs tokens for REST-compat.
+    """
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def info_codes(self) -> _containers.RepeatedScalarFieldContainer[Global___InfoCode.ValueType]: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        info_codes: _abc.Iterable[Global___InfoCode.ValueType] | None = ...,
+        include_master_token: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "include_master_token", b"include_master_token", "info_codes", b"info_codes"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetInfoRequest: _TypeAlias = ConnectionGetInfoRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetInfoResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    HOST_FIELD_NUMBER: _builtins.int
+    PORT_FIELD_NUMBER: _builtins.int
+    SERVER_URL_FIELD_NUMBER: _builtins.int
+    SESSION_TOKEN_FIELD_NUMBER: _builtins.int
+    SESSION_ID_FIELD_NUMBER: _builtins.int
+    ACCOUNT_FIELD_NUMBER: _builtins.int
+    USER_FIELD_NUMBER: _builtins.int
+    ROLE_FIELD_NUMBER: _builtins.int
+    DATABASE_FIELD_NUMBER: _builtins.int
+    SCHEMA_FIELD_NUMBER: _builtins.int
+    WAREHOUSE_FIELD_NUMBER: _builtins.int
+    MASTER_TOKEN_FIELD_NUMBER: _builtins.int
+    USER_AGENT_FIELD_NUMBER: _builtins.int
+    PROXY_HOST_FIELD_NUMBER: _builtins.int
+    PROXY_PORT_FIELD_NUMBER: _builtins.int
+    PROXY_USER_FIELD_NUMBER: _builtins.int
+    PROXY_PASSWORD_FIELD_NUMBER: _builtins.int
+    NO_PROXY_FIELD_NUMBER: _builtins.int
+    SESSION_TOKEN_EXPIRES_AT_MS_FIELD_NUMBER: _builtins.int
+    MASTER_TOKEN_EXPIRES_AT_MS_FIELD_NUMBER: _builtins.int
+    host: _builtins.str
+    port: _builtins.int
+    server_url: _builtins.str
+    session_token: _builtins.str
+    session_id: _builtins.int
+    account: _builtins.str
+    user: _builtins.str
+    role: _builtins.str
+    database: _builtins.str
+    schema: _builtins.str
+    warehouse: _builtins.str
+    master_token: _builtins.str
+    user_agent: _builtins.str
+    proxy_host: _builtins.str
+    proxy_port: _builtins.int
+    proxy_user: _builtins.str
+    proxy_password: _builtins.str
+    no_proxy: _builtins.str
+    session_token_expires_at_ms: _builtins.int
+    """Token expiry as milliseconds since the Unix epoch, resolved against the
+    wall clock when the response is built. Both are set regardless of
+    include_master_token.
+    """
+    master_token_expires_at_ms: _builtins.int
+    def __init__(
+        self,
+        *,
+        host: _builtins.str | None = ...,
+        port: _builtins.int | None = ...,
+        server_url: _builtins.str | None = ...,
+        session_token: _builtins.str | None = ...,
+        session_id: _builtins.int | None = ...,
+        account: _builtins.str | None = ...,
+        user: _builtins.str | None = ...,
+        role: _builtins.str | None = ...,
+        database: _builtins.str | None = ...,
+        schema: _builtins.str | None = ...,
+        warehouse: _builtins.str | None = ...,
+        master_token: _builtins.str | None = ...,
+        user_agent: _builtins.str | None = ...,
+        proxy_host: _builtins.str | None = ...,
+        proxy_port: _builtins.int | None = ...,
+        proxy_user: _builtins.str | None = ...,
+        proxy_password: _builtins.str | None = ...,
+        no_proxy: _builtins.str | None = ...,
+        session_token_expires_at_ms: _builtins.int | None = ...,
+        master_token_expires_at_ms: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_account", b"_account", "_database", b"_database", "_host", b"_host", "_master_token", b"_master_token", "_master_token_expires_at_ms", b"_master_token_expires_at_ms", "_no_proxy", b"_no_proxy", "_port", b"_port", "_proxy_host", b"_proxy_host", "_proxy_password", b"_proxy_password", "_proxy_port", b"_proxy_port", "_proxy_user", b"_proxy_user", "_role", b"_role", "_schema", b"_schema", "_server_url", b"_server_url", "_session_id", b"_session_id", "_session_token", b"_session_token", "_session_token_expires_at_ms", b"_session_token_expires_at_ms", "_user", b"_user", "_user_agent", b"_user_agent", "_warehouse", b"_warehouse", "account", b"account", "database", b"database", "host", b"host", "master_token", b"master_token", "master_token_expires_at_ms", b"master_token_expires_at_ms", "no_proxy", b"no_proxy", "port", b"port", "proxy_host", b"proxy_host", "proxy_password", b"proxy_password", "proxy_port", b"proxy_port", "proxy_user", b"proxy_user", "role", b"role", "schema", b"schema", "server_url", b"server_url", "session_id", b"session_id", "session_token", b"session_token", "session_token_expires_at_ms", b"session_token_expires_at_ms", "user", b"user", "user_agent", b"user_agent", "warehouse", b"warehouse"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_account", b"_account", "_database", b"_database", "_host", b"_host", "_master_token", b"_master_token", "_master_token_expires_at_ms", b"_master_token_expires_at_ms", "_no_proxy", b"_no_proxy", "_port", b"_port", "_proxy_host", b"_proxy_host", "_proxy_password", b"_proxy_password", "_proxy_port", b"_proxy_port", "_proxy_user", b"_proxy_user", "_role", b"_role", "_schema", b"_schema", "_server_url", b"_server_url", "_session_id", b"_session_id", "_session_token", b"_session_token", "_session_token_expires_at_ms", b"_session_token_expires_at_ms", "_user", b"_user", "_user_agent", b"_user_agent", "_warehouse", b"_warehouse", "account", b"account", "database", b"database", "host", b"host", "master_token", b"master_token", "master_token_expires_at_ms", b"master_token_expires_at_ms", "no_proxy", b"no_proxy", "port", b"port", "proxy_host", b"proxy_host", "proxy_password", b"proxy_password", "proxy_port", b"proxy_port", "proxy_user", b"proxy_user", "role", b"role", "schema", b"schema", "server_url", b"server_url", "session_id", b"session_id", "session_token", b"session_token", "session_token_expires_at_ms", b"session_token_expires_at_ms", "user", b"user", "user_agent", b"user_agent", "warehouse", b"warehouse"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__account: _TypeAlias = _typing.Literal["account"]  # noqa: Y015
+    _WhichOneofArgType__account: _TypeAlias = _typing.Literal["_account", b"_account"]  # noqa: Y015
+    _WhichOneofReturnType__database: _TypeAlias = _typing.Literal["database"]  # noqa: Y015
+    _WhichOneofArgType__database: _TypeAlias = _typing.Literal["_database", b"_database"]  # noqa: Y015
+    _WhichOneofReturnType__host: _TypeAlias = _typing.Literal["host"]  # noqa: Y015
+    _WhichOneofArgType__host: _TypeAlias = _typing.Literal["_host", b"_host"]  # noqa: Y015
+    _WhichOneofReturnType__master_token: _TypeAlias = _typing.Literal["master_token"]  # noqa: Y015
+    _WhichOneofArgType__master_token: _TypeAlias = _typing.Literal["_master_token", b"_master_token"]  # noqa: Y015
+    _WhichOneofReturnType__master_token_expires_at_ms: _TypeAlias = _typing.Literal["master_token_expires_at_ms"]  # noqa: Y015
+    _WhichOneofArgType__master_token_expires_at_ms: _TypeAlias = _typing.Literal["_master_token_expires_at_ms", b"_master_token_expires_at_ms"]  # noqa: Y015
+    _WhichOneofReturnType__no_proxy: _TypeAlias = _typing.Literal["no_proxy"]  # noqa: Y015
+    _WhichOneofArgType__no_proxy: _TypeAlias = _typing.Literal["_no_proxy", b"_no_proxy"]  # noqa: Y015
+    _WhichOneofReturnType__port: _TypeAlias = _typing.Literal["port"]  # noqa: Y015
+    _WhichOneofArgType__port: _TypeAlias = _typing.Literal["_port", b"_port"]  # noqa: Y015
+    _WhichOneofReturnType__proxy_host: _TypeAlias = _typing.Literal["proxy_host"]  # noqa: Y015
+    _WhichOneofArgType__proxy_host: _TypeAlias = _typing.Literal["_proxy_host", b"_proxy_host"]  # noqa: Y015
+    _WhichOneofReturnType__proxy_password: _TypeAlias = _typing.Literal["proxy_password"]  # noqa: Y015
+    _WhichOneofArgType__proxy_password: _TypeAlias = _typing.Literal["_proxy_password", b"_proxy_password"]  # noqa: Y015
+    _WhichOneofReturnType__proxy_port: _TypeAlias = _typing.Literal["proxy_port"]  # noqa: Y015
+    _WhichOneofArgType__proxy_port: _TypeAlias = _typing.Literal["_proxy_port", b"_proxy_port"]  # noqa: Y015
+    _WhichOneofReturnType__proxy_user: _TypeAlias = _typing.Literal["proxy_user"]  # noqa: Y015
+    _WhichOneofArgType__proxy_user: _TypeAlias = _typing.Literal["_proxy_user", b"_proxy_user"]  # noqa: Y015
+    _WhichOneofReturnType__role: _TypeAlias = _typing.Literal["role"]  # noqa: Y015
+    _WhichOneofArgType__role: _TypeAlias = _typing.Literal["_role", b"_role"]  # noqa: Y015
+    _WhichOneofReturnType__schema: _TypeAlias = _typing.Literal["schema"]  # noqa: Y015
+    _WhichOneofArgType__schema: _TypeAlias = _typing.Literal["_schema", b"_schema"]  # noqa: Y015
+    _WhichOneofReturnType__server_url: _TypeAlias = _typing.Literal["server_url"]  # noqa: Y015
+    _WhichOneofArgType__server_url: _TypeAlias = _typing.Literal["_server_url", b"_server_url"]  # noqa: Y015
+    _WhichOneofReturnType__session_id: _TypeAlias = _typing.Literal["session_id"]  # noqa: Y015
+    _WhichOneofArgType__session_id: _TypeAlias = _typing.Literal["_session_id", b"_session_id"]  # noqa: Y015
+    _WhichOneofReturnType__session_token: _TypeAlias = _typing.Literal["session_token"]  # noqa: Y015
+    _WhichOneofArgType__session_token: _TypeAlias = _typing.Literal["_session_token", b"_session_token"]  # noqa: Y015
+    _WhichOneofReturnType__session_token_expires_at_ms: _TypeAlias = _typing.Literal["session_token_expires_at_ms"]  # noqa: Y015
+    _WhichOneofArgType__session_token_expires_at_ms: _TypeAlias = _typing.Literal["_session_token_expires_at_ms", b"_session_token_expires_at_ms"]  # noqa: Y015
+    _WhichOneofReturnType__user: _TypeAlias = _typing.Literal["user"]  # noqa: Y015
+    _WhichOneofArgType__user: _TypeAlias = _typing.Literal["_user", b"_user"]  # noqa: Y015
+    _WhichOneofReturnType__user_agent: _TypeAlias = _typing.Literal["user_agent"]  # noqa: Y015
+    _WhichOneofArgType__user_agent: _TypeAlias = _typing.Literal["_user_agent", b"_user_agent"]  # noqa: Y015
+    _WhichOneofReturnType__warehouse: _TypeAlias = _typing.Literal["warehouse"]  # noqa: Y015
+    _WhichOneofArgType__warehouse: _TypeAlias = _typing.Literal["_warehouse", b"_warehouse"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__account) -> _WhichOneofReturnType__account | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__database) -> _WhichOneofReturnType__database | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__host) -> _WhichOneofReturnType__host | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__master_token) -> _WhichOneofReturnType__master_token | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__master_token_expires_at_ms) -> _WhichOneofReturnType__master_token_expires_at_ms | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__no_proxy) -> _WhichOneofReturnType__no_proxy | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__port) -> _WhichOneofReturnType__port | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__proxy_host) -> _WhichOneofReturnType__proxy_host | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__proxy_password) -> _WhichOneofReturnType__proxy_password | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__proxy_port) -> _WhichOneofReturnType__proxy_port | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__proxy_user) -> _WhichOneofReturnType__proxy_user | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__role) -> _WhichOneofReturnType__role | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__schema) -> _WhichOneofReturnType__schema | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__server_url) -> _WhichOneofReturnType__server_url | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__session_id) -> _WhichOneofReturnType__session_id | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__session_token) -> _WhichOneofReturnType__session_token | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__session_token_expires_at_ms) -> _WhichOneofReturnType__session_token_expires_at_ms | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__user) -> _WhichOneofReturnType__user | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__user_agent) -> _WhichOneofReturnType__user_agent | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__warehouse) -> _WhichOneofReturnType__warehouse | None: ...
+
+Global___ConnectionGetInfoResponse: _TypeAlias = ConnectionGetInfoResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetObjectsRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    DEPTH_FIELD_NUMBER: _builtins.int
+    CATALOG_FIELD_NUMBER: _builtins.int
+    DB_SCHEMA_FIELD_NUMBER: _builtins.int
+    TABLE_NAME_FIELD_NUMBER: _builtins.int
+    TABLE_TYPE_FIELD_NUMBER: _builtins.int
+    COLUMN_NAME_FIELD_NUMBER: _builtins.int
+    depth: _builtins.int
+    catalog: _builtins.str
+    db_schema: _builtins.str
+    table_name: _builtins.str
+    column_name: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def table_type(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        depth: _builtins.int = ...,
+        catalog: _builtins.str | None = ...,
+        db_schema: _builtins.str | None = ...,
+        table_name: _builtins.str | None = ...,
+        table_type: _abc.Iterable[_builtins.str] | None = ...,
+        column_name: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_catalog", b"_catalog", "_column_name", b"_column_name", "_db_schema", b"_db_schema", "_table_name", b"_table_name", "catalog", b"catalog", "column_name", b"column_name", "conn_handle", b"conn_handle", "db_schema", b"db_schema", "table_name", b"table_name"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_catalog", b"_catalog", "_column_name", b"_column_name", "_db_schema", b"_db_schema", "_table_name", b"_table_name", "catalog", b"catalog", "column_name", b"column_name", "conn_handle", b"conn_handle", "db_schema", b"db_schema", "depth", b"depth", "table_name", b"table_name", "table_type", b"table_type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__catalog: _TypeAlias = _typing.Literal["catalog"]  # noqa: Y015
+    _WhichOneofArgType__catalog: _TypeAlias = _typing.Literal["_catalog", b"_catalog"]  # noqa: Y015
+    _WhichOneofReturnType__column_name: _TypeAlias = _typing.Literal["column_name"]  # noqa: Y015
+    _WhichOneofArgType__column_name: _TypeAlias = _typing.Literal["_column_name", b"_column_name"]  # noqa: Y015
+    _WhichOneofReturnType__db_schema: _TypeAlias = _typing.Literal["db_schema"]  # noqa: Y015
+    _WhichOneofArgType__db_schema: _TypeAlias = _typing.Literal["_db_schema", b"_db_schema"]  # noqa: Y015
+    _WhichOneofReturnType__table_name: _TypeAlias = _typing.Literal["table_name"]  # noqa: Y015
+    _WhichOneofArgType__table_name: _TypeAlias = _typing.Literal["_table_name", b"_table_name"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__catalog) -> _WhichOneofReturnType__catalog | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__column_name) -> _WhichOneofReturnType__column_name | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__db_schema) -> _WhichOneofReturnType__db_schema | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__table_name) -> _WhichOneofReturnType__table_name | None: ...
+
+Global___ConnectionGetObjectsRequest: _TypeAlias = ConnectionGetObjectsRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetObjectsResponse(_message.Message):
+    """ConnectionGetObjects returns a result set (streaming, via result_set_get_stream)
+    containing a nested ADBC-shaped Arrow batch:
+      catalog_name: utf8
+      catalog_db_schemas: list<struct<
+        db_schema_name: utf8,
+        db_schema_tables: list<struct<
+          table_name: utf8,
+          table_type: utf8,
+          table_columns: list (always empty in this impl),
+          table_constraints: list (always empty in this impl)
+        >>
+      >>
+
+    depth constants:
+      0 = ALL (not used)
+      1 = CATALOGS  -> populates only catalog_name
+      2 = DB_SCHEMAS -> populates catalog_name + db_schema_name
+      3 = TABLES    -> populates down to table_name/table_type
+      4 = COLUMNS   -> deferred (not implemented yet)
+
+    Filter semantics (search patterns, ADBC + backslash-escape extension):
+      - NULL filter = no filter (account-wide or connection-context if
+        CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX is set)
+      - empty string "" = matches nothing (returns empty result)
+      - % = any sequence, _ = any single char
+      - \\%, \\_, \\\\ = literal %, _, \\ (escape extension, not in ADBC spec)
+      - Matching is case-insensitive (Snowflake unquoted-identifier semantics)
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_SET_HANDLE_FIELD_NUMBER: _builtins.int
+    RESULT_DESCRIPTOR_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result_set_handle(self) -> Global___ResultSetHandle: ...
+    @_builtins.property
+    def result_descriptor(self) -> Global___ResultSetDescriptor: ...
+    def __init__(
+        self,
+        *,
+        result_set_handle: Global___ResultSetHandle | None = ...,
+        result_descriptor: Global___ResultSetDescriptor | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result_descriptor", b"result_descriptor", "result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result_descriptor", b"result_descriptor", "result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetObjectsResponse: _TypeAlias = ConnectionGetObjectsResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetTableSchemaRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    CATALOG_FIELD_NUMBER: _builtins.int
+    DB_SCHEMA_FIELD_NUMBER: _builtins.int
+    TABLE_NAME_FIELD_NUMBER: _builtins.int
+    catalog: _builtins.str
+    db_schema: _builtins.str
+    table_name: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        catalog: _builtins.str | None = ...,
+        db_schema: _builtins.str | None = ...,
+        table_name: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_catalog", b"_catalog", "_db_schema", b"_db_schema", "catalog", b"catalog", "conn_handle", b"conn_handle", "db_schema", b"db_schema"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_catalog", b"_catalog", "_db_schema", b"_db_schema", "catalog", b"catalog", "conn_handle", b"conn_handle", "db_schema", b"db_schema", "table_name", b"table_name"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__catalog: _TypeAlias = _typing.Literal["catalog"]  # noqa: Y015
+    _WhichOneofArgType__catalog: _TypeAlias = _typing.Literal["_catalog", b"_catalog"]  # noqa: Y015
+    _WhichOneofReturnType__db_schema: _TypeAlias = _typing.Literal["db_schema"]  # noqa: Y015
+    _WhichOneofArgType__db_schema: _TypeAlias = _typing.Literal["_db_schema", b"_db_schema"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__catalog) -> _WhichOneofReturnType__catalog | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__db_schema) -> _WhichOneofReturnType__db_schema | None: ...
+
+Global___ConnectionGetTableSchemaRequest: _TypeAlias = ConnectionGetTableSchemaRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetTableSchemaResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SCHEMA_DATA_FIELD_NUMBER: _builtins.int
+    schema_data: _builtins.bytes
+    def __init__(
+        self,
+        *,
+        schema_data: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["schema_data", b"schema_data"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetTableSchemaResponse: _TypeAlias = ConnectionGetTableSchemaResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetTableTypesRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetTableTypesRequest: _TypeAlias = ConnectionGetTableTypesRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetTableTypesResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    TABLE_TYPES_DATA_FIELD_NUMBER: _builtins.int
+    table_types_data: _builtins.bytes
+    def __init__(
+        self,
+        *,
+        table_types_data: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["table_types_data", b"table_types_data"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetTableTypesResponse: _TypeAlias = ConnectionGetTableTypesResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionCommitRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionCommitRequest: _TypeAlias = ConnectionCommitRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionCommitResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionCommitResponse: _TypeAlias = ConnectionCommitResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionRollbackRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionRollbackRequest: _TypeAlias = ConnectionRollbackRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionRollbackResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionRollbackResponse: _TypeAlias = ConnectionRollbackResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionSetAutocommitRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    AUTOCOMMIT_FIELD_NUMBER: _builtins.int
+    autocommit: _builtins.bool
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        autocommit: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["autocommit", b"autocommit", "conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionSetAutocommitRequest: _TypeAlias = ConnectionSetAutocommitRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionSetAutocommitResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionSetAutocommitResponse: _TypeAlias = ConnectionSetAutocommitResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionUseDatabaseRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    DATABASE_FIELD_NUMBER: _builtins.int
+    database: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        database: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "database", b"database"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUseDatabaseRequest: _TypeAlias = ConnectionUseDatabaseRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionUseDatabaseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUseDatabaseResponse: _TypeAlias = ConnectionUseDatabaseResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionUseSchemaRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    SCHEMA_FIELD_NUMBER: _builtins.int
+    schema: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        schema: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "schema", b"schema"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUseSchemaRequest: _TypeAlias = ConnectionUseSchemaRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionUseSchemaResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUseSchemaResponse: _TypeAlias = ConnectionUseSchemaResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionSetSessionParametersRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class ParametersEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.str
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.str = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    PARAMETERS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def parameters(self) -> _containers.ScalarMap[_builtins.str, _builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        parameters: _abc.Mapping[_builtins.str, _builtins.str] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "parameters", b"parameters"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionSetSessionParametersRequest: _TypeAlias = ConnectionSetSessionParametersRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionSetSessionParametersResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionSetSessionParametersResponse: _TypeAlias = ConnectionSetSessionParametersResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetParameterRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    KEY_FIELD_NUMBER: _builtins.int
+    key: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        key: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "key", b"key"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetParameterRequest: _TypeAlias = ConnectionGetParameterRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetParameterResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    VALUE_FIELD_NUMBER: _builtins.int
+    TYPED_VALUE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    @_deprecated("""This field has been marked as deprecated using proto field options.""")
+    def value(self) -> _builtins.str:
+        """Superseded by typed_value, which carries the server's native type. Removed
+        once every wrapper reads typed_value; both fields are populated until then.
+        """
+
+    @value.setter
+    @_deprecated("""This field has been marked as deprecated using proto field options.""")
+    def value(self, value: _builtins.str) -> None:
+        """Superseded by typed_value, which carries the server's native type. Removed
+        once every wrapper reads typed_value; both fields are populated until then.
+        """
+
+    @_builtins.property
+    def typed_value(self) -> Global___ConfigSetting: ...
+    def __init__(
+        self,
+        *,
+        value: _builtins.str | None = ...,
+        typed_value: Global___ConfigSetting | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_typed_value", b"_typed_value", "_value", b"_value", "typed_value", b"typed_value", "value", b"value"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_typed_value", b"_typed_value", "_value", b"_value", "typed_value", b"typed_value", "value", b"value"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__typed_value: _TypeAlias = _typing.Literal["typed_value"]  # noqa: Y015
+    _WhichOneofArgType__typed_value: _TypeAlias = _typing.Literal["_typed_value", b"_typed_value"]  # noqa: Y015
+    _WhichOneofReturnType__value: _TypeAlias = _typing.Literal["value"]  # noqa: Y015
+    _WhichOneofArgType__value: _TypeAlias = _typing.Literal["_value", b"_value"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__typed_value) -> _WhichOneofReturnType__typed_value | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__value) -> _WhichOneofReturnType__value | None: ...
+
+Global___ConnectionGetParameterResponse: _TypeAlias = ConnectionGetParameterResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetAllParametersRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetAllParametersRequest: _TypeAlias = ConnectionGetAllParametersRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetAllParametersResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class ParametersEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.str
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.str = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    @_typing.final
+    class TypedParametersEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ConfigSetting: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ConfigSetting | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    PARAMETERS_FIELD_NUMBER: _builtins.int
+    TYPED_PARAMETERS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    @_deprecated("""This field has been marked as deprecated using proto field options.""")
+    def parameters(self) -> _containers.ScalarMap[_builtins.str, _builtins.str]:
+        """Superseded by typed_parameters. See ConnectionGetParameterResponse.value."""
+
+    @_builtins.property
+    def typed_parameters(self) -> _containers.MessageMap[_builtins.str, Global___ConfigSetting]: ...
+    def __init__(
+        self,
+        *,
+        parameters: _abc.Mapping[_builtins.str, _builtins.str] | None = ...,
+        typed_parameters: _abc.Mapping[_builtins.str, Global___ConfigSetting] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["parameters", b"parameters", "typed_parameters", b"typed_parameters"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetAllParametersResponse: _TypeAlias = ConnectionGetAllParametersResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetServerVersionRequest(_message.Message):
+    """Reads the Snowflake server version cached from the login response.
+    Distinct from ConnectionGetInfo (which aggregates ~12 fields and takes
+    several locks) so SQLGetInfo(SQL_DBMS_VER) / JDBC getDatabaseProductVersion
+    stay cheap even when callers poll them per-statement.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetServerVersionRequest: _TypeAlias = ConnectionGetServerVersionRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetServerVersionResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SERVER_VERSION_FIELD_NUMBER: _builtins.int
+    server_version: _builtins.str
+    """Empty when called before login completes."""
+    def __init__(
+        self,
+        *,
+        server_version: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_server_version", b"_server_version", "server_version", b"server_version"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_server_version", b"_server_version", "server_version", b"server_version"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__server_version: _TypeAlias = _typing.Literal["server_version"]  # noqa: Y015
+    _WhichOneofArgType__server_version: _TypeAlias = _typing.Literal["_server_version", b"_server_version"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__server_version) -> _WhichOneofReturnType__server_version | None: ...
+
+Global___ConnectionGetServerVersionResponse: _TypeAlias = ConnectionGetServerVersionResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionValidateOptionsRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionValidateOptionsRequest: _TypeAlias = ConnectionValidateOptionsRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionValidateOptionsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ISSUES_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def issues(self) -> _containers.RepeatedCompositeFieldContainer[Global___ValidationIssue]: ...
+    def __init__(
+        self,
+        *,
+        issues: _abc.Iterable[Global___ValidationIssue] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["issues", b"issues"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionValidateOptionsResponse: _TypeAlias = ConnectionValidateOptionsResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionSendHttpRequest(_message.Message):
+    """HTTP request via sf_core (uses connection's TLS/OCSP/CRL client).
+    URL is resolved relative to the connection's server_url.
+    Auth is always the current session token (managed by sf_core).
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class HeadersEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.str
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.str = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    METHOD_FIELD_NUMBER: _builtins.int
+    URL_FIELD_NUMBER: _builtins.int
+    HEADERS_FIELD_NUMBER: _builtins.int
+    BODY_FIELD_NUMBER: _builtins.int
+    method: _builtins.str
+    """GET, POST, PUT, DELETE, PATCH"""
+    url: _builtins.str
+    """relative URL path (e.g. "/session/token-request")"""
+    body: _builtins.bytes
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def headers(self) -> _containers.ScalarMap[_builtins.str, _builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        method: _builtins.str = ...,
+        url: _builtins.str = ...,
+        headers: _abc.Mapping[_builtins.str, _builtins.str] | None = ...,
+        body: _builtins.bytes | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_body", b"_body", "body", b"body", "conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_body", b"_body", "body", b"body", "conn_handle", b"conn_handle", "headers", b"headers", "method", b"method", "url", b"url"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__body: _TypeAlias = _typing.Literal["body"]  # noqa: Y015
+    _WhichOneofArgType__body: _TypeAlias = _typing.Literal["_body", b"_body"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__body) -> _WhichOneofReturnType__body | None: ...
+
+Global___ConnectionSendHttpRequest: _TypeAlias = ConnectionSendHttpRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionSendHttpResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class HeadersEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.str
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.str = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    STATUS_CODE_FIELD_NUMBER: _builtins.int
+    HEADERS_FIELD_NUMBER: _builtins.int
+    BODY_FIELD_NUMBER: _builtins.int
+    status_code: _builtins.int
+    body: _builtins.bytes
+    @_builtins.property
+    def headers(self) -> _containers.ScalarMap[_builtins.str, _builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        status_code: _builtins.int = ...,
+        headers: _abc.Mapping[_builtins.str, _builtins.str] | None = ...,
+        body: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["body", b"body", "headers", b"headers", "status_code", b"status_code"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionSendHttpResponse: _TypeAlias = ConnectionSendHttpResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionTokenRequest(_message.Message):
+    """Token request (ISSUE/RENEW) — executed entirely in sf_core with master token"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    REQUEST_TYPE_FIELD_NUMBER: _builtins.int
+    request_type: Global___TokenRequestType.ValueType
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        request_type: Global___TokenRequestType.ValueType = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "request_type", b"request_type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionTokenRequest: _TypeAlias = ConnectionTokenRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionTokenResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SESSION_TOKEN_FIELD_NUMBER: _builtins.int
+    VALIDITY_IN_SECONDS_FIELD_NUMBER: _builtins.int
+    session_token: _builtins.str
+    validity_in_seconds: _builtins.int
+    def __init__(
+        self,
+        *,
+        session_token: _builtins.str = ...,
+        validity_in_seconds: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_validity_in_seconds", b"_validity_in_seconds", "validity_in_seconds", b"validity_in_seconds"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_validity_in_seconds", b"_validity_in_seconds", "session_token", b"session_token", "validity_in_seconds", b"validity_in_seconds"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__validity_in_seconds: _TypeAlias = _typing.Literal["validity_in_seconds"]  # noqa: Y015
+    _WhichOneofArgType__validity_in_seconds: _TypeAlias = _typing.Literal["_validity_in_seconds", b"_validity_in_seconds"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__validity_in_seconds) -> _WhichOneofReturnType__validity_in_seconds | None: ...
+
+Global___ConnectionTokenResponse: _TypeAlias = ConnectionTokenResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionHeartbeatRequest(_message.Message):
+    """Heartbeat request to validate that the connection and session are still alive."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    TIMEOUT_SECONDS_FIELD_NUMBER: _builtins.int
+    timeout_seconds: _builtins.int
+    """0 / absent = use default (300s)"""
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        timeout_seconds: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_timeout_seconds", b"_timeout_seconds", "conn_handle", b"conn_handle", "timeout_seconds", b"timeout_seconds"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_timeout_seconds", b"_timeout_seconds", "conn_handle", b"conn_handle", "timeout_seconds", b"timeout_seconds"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__timeout_seconds: _TypeAlias = _typing.Literal["timeout_seconds"]  # noqa: Y015
+    _WhichOneofArgType__timeout_seconds: _TypeAlias = _typing.Literal["_timeout_seconds", b"_timeout_seconds"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__timeout_seconds) -> _WhichOneofReturnType__timeout_seconds | None: ...
+
+Global___ConnectionHeartbeatRequest: _TypeAlias = ConnectionHeartbeatRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionHeartbeatResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    VALID_FIELD_NUMBER: _builtins.int
+    valid: _builtins.bool
+    def __init__(
+        self,
+        *,
+        valid: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["valid", b"valid"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionHeartbeatResponse: _TypeAlias = ConnectionHeartbeatResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetQueryResultRequest(_message.Message):
+    """Fetch the result of a previously executed query by its Snowflake Query ID."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        query_id: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "query_id", b"query_id"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetQueryResultRequest: _TypeAlias = ConnectionGetQueryResultRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetResultSetRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        query_id: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "query_id", b"query_id"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetResultSetRequest: _TypeAlias = ConnectionGetResultSetRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionAbortQueryRequest(_message.Message):
+    """Abort a running query by its Snowflake Query ID."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        query_id: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "query_id", b"query_id"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionAbortQueryRequest: _TypeAlias = ConnectionAbortQueryRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionAbortQueryResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    OUTCOME_FIELD_NUMBER: _builtins.int
+    outcome: Global___AbortQueryOutcome.ValueType
+    def __init__(
+        self,
+        *,
+        outcome: Global___AbortQueryOutcome.ValueType = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["outcome", b"outcome"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionAbortQueryResponse: _TypeAlias = ConnectionAbortQueryResponse  # noqa: Y015
+
+@_typing.final
+class UploadStreamHandle(_message.Message):
+    """Handle for a chunked upload stream session opened by
+    ConnectionUploadStreamBegin. Opaque outside sf_core, same shape as the
+    other handle types.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ID_FIELD_NUMBER: _builtins.int
+    MAGIC_FIELD_NUMBER: _builtins.int
+    id: _builtins.int
+    magic: _builtins.int
+    def __init__(
+        self,
+        *,
+        id: _builtins.int = ...,
+        magic: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["id", b"id", "magic", b"magic"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___UploadStreamHandle: _TypeAlias = UploadStreamHandle  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamBeginRequest(_message.Message):
+    """Chunked streaming PUT, part 1/3: registers the PUT SQL and opens a session
+    that accumulates chunks handed in via ConnectionUploadStreamChunk. The core
+    does not contact GS until ConnectionUploadStreamFinish — bounding wrapper
+    memory to ~one chunk while preserving the existing upload path (digest,
+    retry, CSE, multipart) unchanged. Backs JDBC `uploadStream` and Python
+    `cursor.execute(file_stream=…)`.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    SQL_FIELD_NUMBER: _builtins.int
+    sql: _builtins.str
+    """The PUT SQL statement. Must begin with PUT and reference a `file://`
+    path whose basename is used as the destination filename in the stage.
+    """
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        sql: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "sql", b"sql"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamBeginRequest: _TypeAlias = ConnectionUploadStreamBeginRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamBeginResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    UPLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def upload_handle(self) -> Global___UploadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        upload_handle: Global___UploadStreamHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamBeginResponse: _TypeAlias = ConnectionUploadStreamBeginResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamChunkRequest(_message.Message):
+    """Chunked streaming PUT, part 2/3: appends one chunk of the source to the
+    session opened by ConnectionUploadStreamBegin. Callers should keep chunks
+    bounded (e.g. 8 MiB) to preserve the wrapper memory bound this RPC exists
+    for.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    UPLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    DATA_FIELD_NUMBER: _builtins.int
+    data: _builtins.bytes
+    @_builtins.property
+    def upload_handle(self) -> Global___UploadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        upload_handle: Global___UploadStreamHandle | None = ...,
+        data: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["data", b"data", "upload_handle", b"upload_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamChunkRequest: _TypeAlias = ConnectionUploadStreamChunkRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamChunkResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamChunkResponse: _TypeAlias = ConnectionUploadStreamChunkResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamFinishRequest(_message.Message):
+    """Chunked streaming PUT, part 3/3: closes the session, reassembles the
+    buffered chunks into a re-readable source, and runs the PUT. Mirrors
+    `ResultSetResponse`: a PUT-shaped result set (handle + descriptor), so the
+    caller can read the standard 8-column PUT rowset.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    UPLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def upload_handle(self) -> Global___UploadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        upload_handle: Global___UploadStreamHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamFinishRequest: _TypeAlias = ConnectionUploadStreamFinishRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamFinishResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_SET_HANDLE_FIELD_NUMBER: _builtins.int
+    RESULT_DESCRIPTOR_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result_set_handle(self) -> Global___ResultSetHandle: ...
+    @_builtins.property
+    def result_descriptor(self) -> Global___ResultSetDescriptor: ...
+    def __init__(
+        self,
+        *,
+        result_set_handle: Global___ResultSetHandle | None = ...,
+        result_descriptor: Global___ResultSetDescriptor | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result_descriptor", b"result_descriptor", "result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result_descriptor", b"result_descriptor", "result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamFinishResponse: _TypeAlias = ConnectionUploadStreamFinishResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamAbortRequest(_message.Message):
+    """Aborts a chunked upload session opened by ConnectionUploadStreamBegin
+    without running the PUT (e.g. the caller's source stream failed mid-read).
+    Any buffered/spooled bytes are discarded.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    UPLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def upload_handle(self) -> Global___UploadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        upload_handle: Global___UploadStreamHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["upload_handle", b"upload_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamAbortRequest: _TypeAlias = ConnectionUploadStreamAbortRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionUploadStreamAbortResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionUploadStreamAbortResponse: _TypeAlias = ConnectionUploadStreamAbortResponse  # noqa: Y015
+
+@_typing.final
+class DownloadStreamHandle(_message.Message):
+    """Handle for a chunked download stream session opened by
+    ConnectionDownloadStreamBegin. Opaque outside sf_core, same shape as the
+    other handle types.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ID_FIELD_NUMBER: _builtins.int
+    MAGIC_FIELD_NUMBER: _builtins.int
+    id: _builtins.int
+    magic: _builtins.int
+    def __init__(
+        self,
+        *,
+        id: _builtins.int = ...,
+        magic: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["id", b"id", "magic", b"magic"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DownloadStreamHandle: _TypeAlias = DownloadStreamHandle  # noqa: Y015
+
+@_typing.final
+class ConnectionDownloadStreamBeginRequest(_message.Message):
+    """Chunked streaming GET, part 1/3: resolves the stage location and opens a
+    session that streams the file from cloud storage without ever landing the
+    whole file on local disk or fully buffering it in memory. The core keeps
+    only a small bounded window of bytes in flight regardless of file size.
+    Supports S3, GCS, and Azure-backed stages.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    STAGE_NAME_FIELD_NUMBER: _builtins.int
+    SOURCE_FILENAME_FIELD_NUMBER: _builtins.int
+    DECOMPRESS_FIELD_NUMBER: _builtins.int
+    stage_name: _builtins.str
+    source_filename: _builtins.str
+    decompress: _builtins.bool
+    """When true, the core gunzips the downloaded bytes before returning
+    (opt-in; the bytes are returned verbatim otherwise).
+    """
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        stage_name: _builtins.str = ...,
+        source_filename: _builtins.str = ...,
+        decompress: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "decompress", b"decompress", "source_filename", b"source_filename", "stage_name", b"stage_name"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionDownloadStreamBeginRequest: _TypeAlias = ConnectionDownloadStreamBeginRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionDownloadStreamBeginResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DOWNLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    TOTAL_LEN_FIELD_NUMBER: _builtins.int
+    total_len: _builtins.int
+    """Size of the file in the stage, in bytes, when known up front (before
+    any decompression). Absent if the size could not be determined.
+    """
+    @_builtins.property
+    def download_handle(self) -> Global___DownloadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        download_handle: Global___DownloadStreamHandle | None = ...,
+        total_len: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_total_len", b"_total_len", "download_handle", b"download_handle", "total_len", b"total_len"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_total_len", b"_total_len", "download_handle", b"download_handle", "total_len", b"total_len"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__total_len: _TypeAlias = _typing.Literal["total_len"]  # noqa: Y015
+    _WhichOneofArgType__total_len: _TypeAlias = _typing.Literal["_total_len", b"_total_len"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__total_len) -> _WhichOneofReturnType__total_len | None: ...
+
+Global___ConnectionDownloadStreamBeginResponse: _TypeAlias = ConnectionDownloadStreamBeginResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionDownloadStreamChunkRequest(_message.Message):
+    """Chunked streaming GET, part 2/3: pulls up to max_len bytes of the session
+    opened by ConnectionDownloadStreamBegin. The core clamps max_len to 8 MiB
+    per call regardless of what is requested here — this is an enforced cap,
+    not just advisory guidance — to keep its bounded-memory guarantee a real
+    guarantee. eof is true once the producer has finished and no more bytes
+    remain.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DOWNLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    MAX_LEN_FIELD_NUMBER: _builtins.int
+    max_len: _builtins.int
+    @_builtins.property
+    def download_handle(self) -> Global___DownloadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        download_handle: Global___DownloadStreamHandle | None = ...,
+        max_len: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["download_handle", b"download_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["download_handle", b"download_handle", "max_len", b"max_len"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionDownloadStreamChunkRequest: _TypeAlias = ConnectionDownloadStreamChunkRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionDownloadStreamChunkResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DATA_FIELD_NUMBER: _builtins.int
+    EOF_FIELD_NUMBER: _builtins.int
+    data: _builtins.bytes
+    eof: _builtins.bool
+    def __init__(
+        self,
+        *,
+        data: _builtins.bytes = ...,
+        eof: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["data", b"data", "eof", b"eof"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionDownloadStreamChunkResponse: _TypeAlias = ConnectionDownloadStreamChunkResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionDownloadStreamCloseRequest(_message.Message):
+    """Chunked streaming GET, part 3/3: closes the session, aborting the
+    in-flight download if it has not already finished. Safe to call after
+    eof, or early (e.g. the caller's consumer failed mid-read).
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    DOWNLOAD_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def download_handle(self) -> Global___DownloadStreamHandle: ...
+    def __init__(
+        self,
+        *,
+        download_handle: Global___DownloadStreamHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["download_handle", b"download_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["download_handle", b"download_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionDownloadStreamCloseRequest: _TypeAlias = ConnectionDownloadStreamCloseRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionDownloadStreamCloseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionDownloadStreamCloseResponse: _TypeAlias = ConnectionDownloadStreamCloseResponse  # noqa: Y015
+
+@_typing.final
+class StatementNewRequest(_message.Message):
+    """Statement service requests and responses"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementNewRequest: _TypeAlias = StatementNewRequest  # noqa: Y015
+
+@_typing.final
+class StatementNewResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementNewResponse: _TypeAlias = StatementNewResponse  # noqa: Y015
+
+@_typing.final
+class StatementReleaseRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementReleaseRequest: _TypeAlias = StatementReleaseRequest  # noqa: Y015
+
+@_typing.final
+class StatementReleaseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementReleaseResponse: _TypeAlias = StatementReleaseResponse  # noqa: Y015
+
+@_typing.final
+class StatementSetSqlQueryRequest(_message.Message):
+    """Cancel the query currently in flight on a statement (cross-thread SQLCancel).
+    Keyed on the statement's own client-generated requestId, captured by the core
+    at submit time — the caller passes only the handle.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    QUERY_FIELD_NUMBER: _builtins.int
+    query: _builtins.str
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        query: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["query", b"query", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementSetSqlQueryRequest: _TypeAlias = StatementSetSqlQueryRequest  # noqa: Y015
+
+@_typing.final
+class StatementSetSqlQueryResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementSetSqlQueryResponse: _TypeAlias = StatementSetSqlQueryResponse  # noqa: Y015
+
+@_typing.final
+class StatementSetSubstraitPlanRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    PLAN_FIELD_NUMBER: _builtins.int
+    plan: _builtins.bytes
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        plan: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["plan", b"plan", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementSetSubstraitPlanRequest: _TypeAlias = StatementSetSubstraitPlanRequest  # noqa: Y015
+
+@_typing.final
+class StatementSetSubstraitPlanResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementSetSubstraitPlanResponse: _TypeAlias = StatementSetSubstraitPlanResponse  # noqa: Y015
+
+@_typing.final
+class PrepareResult(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STREAM_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    COLUMNS_FIELD_NUMBER: _builtins.int
+    NUMBER_OF_BINDS_FIELD_NUMBER: _builtins.int
+    QUERY_FIELD_NUMBER: _builtins.int
+    SQL_STATE_FIELD_NUMBER: _builtins.int
+    ARRAY_BIND_SUPPORTED_FIELD_NUMBER: _builtins.int
+    BINDS_FIELD_NUMBER: _builtins.int
+    REQUEST_ID_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    number_of_binds: _builtins.int
+    query: _builtins.str
+    sql_state: _builtins.str
+    array_bind_supported: _builtins.bool
+    request_id: _builtins.str
+    """Client-generated UUID v4 sent as ?requestId= on the submission request; unlike ExecuteQueryResponse.request_id, never absent."""
+    @_builtins.property
+    def stream(self) -> Global___ArrowArrayStreamPtr: ...
+    @_builtins.property
+    def columns(self) -> _containers.RepeatedCompositeFieldContainer[Global___ColumnMetadata]: ...
+    @_builtins.property
+    def binds(self) -> _containers.RepeatedCompositeFieldContainer[Global___ColumnMetadata]: ...
+    def __init__(
+        self,
+        *,
+        stream: Global___ArrowArrayStreamPtr | None = ...,
+        query_id: _builtins.str = ...,
+        columns: _abc.Iterable[Global___ColumnMetadata] | None = ...,
+        number_of_binds: _builtins.int = ...,
+        query: _builtins.str = ...,
+        sql_state: _builtins.str | None = ...,
+        array_bind_supported: _builtins.bool = ...,
+        binds: _abc.Iterable[Global___ColumnMetadata] | None = ...,
+        request_id: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_sql_state", b"_sql_state", "sql_state", b"sql_state", "stream", b"stream"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_sql_state", b"_sql_state", "array_bind_supported", b"array_bind_supported", "binds", b"binds", "columns", b"columns", "number_of_binds", b"number_of_binds", "query", b"query", "query_id", b"query_id", "request_id", b"request_id", "sql_state", b"sql_state", "stream", b"stream"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__sql_state: _TypeAlias = _typing.Literal["sql_state"]  # noqa: Y015
+    _WhichOneofArgType__sql_state: _TypeAlias = _typing.Literal["_sql_state", b"_sql_state"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__sql_state) -> _WhichOneofReturnType__sql_state | None: ...
+
+Global___PrepareResult: _TypeAlias = PrepareResult  # noqa: Y015
+
+@_typing.final
+class StatementPrepareRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    BINDINGS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    @_builtins.property
+    def bindings(self) -> Global___QueryBindings:
+        """None = no bindings"""
+
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        bindings: Global___QueryBindings | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_bindings", b"_bindings", "bindings", b"bindings", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_bindings", b"_bindings", "bindings", b"bindings", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__bindings: _TypeAlias = _typing.Literal["bindings"]  # noqa: Y015
+    _WhichOneofArgType__bindings: _TypeAlias = _typing.Literal["_bindings", b"_bindings"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__bindings) -> _WhichOneofReturnType__bindings | None: ...
+
+Global___StatementPrepareRequest: _TypeAlias = StatementPrepareRequest  # noqa: Y015
+
+@_typing.final
+class StatementPrepareResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result(self) -> Global___PrepareResult: ...
+    def __init__(
+        self,
+        *,
+        result: Global___PrepareResult | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result", b"result"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result", b"result"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementPrepareResponse: _TypeAlias = StatementPrepareResponse  # noqa: Y015
+
+@_typing.final
+class StatementGetParameterSchemaRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementGetParameterSchemaRequest: _TypeAlias = StatementGetParameterSchemaRequest  # noqa: Y015
+
+@_typing.final
+class StatementGetParameterSchemaResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SCHEMA_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def schema(self) -> Global___ArrowSchemaPtr: ...
+    def __init__(
+        self,
+        *,
+        schema: Global___ArrowSchemaPtr | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["schema", b"schema"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["schema", b"schema"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementGetParameterSchemaResponse: _TypeAlias = StatementGetParameterSchemaResponse  # noqa: Y015
+
+@_typing.final
+class StatementExecuteQueryRequest(_message.Message):
+    """Extend current StatementExecute"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    BINDINGS_FIELD_NUMBER: _builtins.int
+    TIMEOUT_SECONDS_FIELD_NUMBER: _builtins.int
+    timeout_seconds: _builtins.int
+    """0 / absent = no timeout override"""
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    @_builtins.property
+    def bindings(self) -> Global___QueryBindings:
+        """None = no bindings"""
+
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        bindings: Global___QueryBindings | None = ...,
+        timeout_seconds: _builtins.int | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_bindings", b"_bindings", "_timeout_seconds", b"_timeout_seconds", "bindings", b"bindings", "stmt_handle", b"stmt_handle", "timeout_seconds", b"timeout_seconds"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_bindings", b"_bindings", "_timeout_seconds", b"_timeout_seconds", "bindings", b"bindings", "stmt_handle", b"stmt_handle", "timeout_seconds", b"timeout_seconds"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__bindings: _TypeAlias = _typing.Literal["bindings"]  # noqa: Y015
+    _WhichOneofArgType__bindings: _TypeAlias = _typing.Literal["_bindings", b"_bindings"]  # noqa: Y015
+    _WhichOneofReturnType__timeout_seconds: _TypeAlias = _typing.Literal["timeout_seconds"]  # noqa: Y015
+    _WhichOneofArgType__timeout_seconds: _TypeAlias = _typing.Literal["_timeout_seconds", b"_timeout_seconds"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__bindings) -> _WhichOneofReturnType__bindings | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__timeout_seconds) -> _WhichOneofReturnType__timeout_seconds | None: ...
+
+Global___StatementExecuteQueryRequest: _TypeAlias = StatementExecuteQueryRequest  # noqa: Y015
+
+@_typing.final
+class ExecuteQueryResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SINGLE_FIELD_NUMBER: _builtins.int
+    MULTI_FIELD_NUMBER: _builtins.int
+    REQUEST_ID_FIELD_NUMBER: _builtins.int
+    request_id: _builtins.str
+    """Client-generated UUID v4 sent as ?requestId= on the submission request.
+    Absent only for connection_get_query_result, which fetches results for
+    an already-executed query and never generates a new submission UUID.
+    """
+    @_builtins.property
+    def single(self) -> Global___ResultSetResponse:
+        """Single statement — descriptor + result_set_handle for stream/chunks access."""
+
+    @_builtins.property
+    def multi(self) -> Global___MultiStatementResult:
+        """Multi-statement — child query IDs only, fetch metadata lazily."""
+
+    def __init__(
+        self,
+        *,
+        single: Global___ResultSetResponse | None = ...,
+        multi: Global___MultiStatementResult | None = ...,
+        request_id: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_request_id", b"_request_id", "multi", b"multi", "request_id", b"request_id", "result", b"result", "single", b"single"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_request_id", b"_request_id", "multi", b"multi", "request_id", b"request_id", "result", b"result", "single", b"single"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__request_id: _TypeAlias = _typing.Literal["request_id"]  # noqa: Y015
+    _WhichOneofArgType__request_id: _TypeAlias = _typing.Literal["_request_id", b"_request_id"]  # noqa: Y015
+    _WhichOneofReturnType_result: _TypeAlias = _typing.Literal["single", "multi"]  # noqa: Y015
+    _WhichOneofArgType_result: _TypeAlias = _typing.Literal["result", b"result"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__request_id) -> _WhichOneofReturnType__request_id | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_result) -> _WhichOneofReturnType_result | None: ...
+
+Global___ExecuteQueryResponse: _TypeAlias = ExecuteQueryResponse  # noqa: Y015
+
+@_typing.final
+class StatementExecuteAsyncRequest(_message.Message):
+    """Async query execution: submit and return immediately with query_id"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    BINDINGS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    @_builtins.property
+    def bindings(self) -> Global___QueryBindings: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        bindings: Global___QueryBindings | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_bindings", b"_bindings", "bindings", b"bindings", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_bindings", b"_bindings", "bindings", b"bindings", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__bindings: _TypeAlias = _typing.Literal["bindings"]  # noqa: Y015
+    _WhichOneofArgType__bindings: _TypeAlias = _typing.Literal["_bindings", b"_bindings"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__bindings) -> _WhichOneofReturnType__bindings | None: ...
+
+Global___StatementExecuteAsyncRequest: _TypeAlias = StatementExecuteAsyncRequest  # noqa: Y015
+
+@_typing.final
+class StatementExecuteAsyncResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    REQUEST_ID_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    request_id: _builtins.str
+    """Client-generated UUID v4 sent as ?requestId= on the submission request."""
+    def __init__(
+        self,
+        *,
+        query_id: _builtins.str = ...,
+        request_id: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["query_id", b"query_id", "request_id", b"request_id"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementExecuteAsyncResponse: _TypeAlias = StatementExecuteAsyncResponse  # noqa: Y015
+
+@_typing.final
+class StatementExecutePartitionsRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementExecutePartitionsRequest: _TypeAlias = StatementExecutePartitionsRequest  # noqa: Y015
+
+@_typing.final
+class StatementExecutePartitionsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result(self) -> Global___PartitionedResult: ...
+    def __init__(
+        self,
+        *,
+        result: Global___PartitionedResult | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result", b"result"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result", b"result"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementExecutePartitionsResponse: _TypeAlias = StatementExecutePartitionsResponse  # noqa: Y015
+
+@_typing.final
+class StatementReadPartitionRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    PARTITION_DESCRIPTOR_FIELD_NUMBER: _builtins.int
+    partition_descriptor: _builtins.bytes
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        partition_descriptor: _builtins.bytes = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["partition_descriptor", b"partition_descriptor", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementReadPartitionRequest: _TypeAlias = StatementReadPartitionRequest  # noqa: Y015
+
+@_typing.final
+class StatementReadPartitionResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    PARTITION_STREAM_FIELD_NUMBER: _builtins.int
+    partition_stream: _builtins.int
+    def __init__(
+        self,
+        *,
+        partition_stream: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["partition_stream", b"partition_stream"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementReadPartitionResponse: _TypeAlias = StatementReadPartitionResponse  # noqa: Y015
+
+@_typing.final
+class RemoteChunk(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class HeadersEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.str
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.str = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    URL_FIELD_NUMBER: _builtins.int
+    HEADERS_FIELD_NUMBER: _builtins.int
+    COMPRESSED_SIZE_FIELD_NUMBER: _builtins.int
+    UNCOMPRESSED_SIZE_FIELD_NUMBER: _builtins.int
+    url: _builtins.str
+    compressed_size: _builtins.int
+    uncompressed_size: _builtins.int
+    @_builtins.property
+    def headers(self) -> _containers.ScalarMap[_builtins.str, _builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        url: _builtins.str = ...,
+        headers: _abc.Mapping[_builtins.str, _builtins.str] | None = ...,
+        compressed_size: _builtins.int = ...,
+        uncompressed_size: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["compressed_size", b"compressed_size", "headers", b"headers", "uncompressed_size", b"uncompressed_size", "url", b"url"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___RemoteChunk: _TypeAlias = RemoteChunk  # noqa: Y015
+
+@_typing.final
+class ResultChunk(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    FORMAT_FIELD_NUMBER: _builtins.int
+    INLINE_FIELD_NUMBER: _builtins.int
+    REMOTE_FIELD_NUMBER: _builtins.int
+    ROW_COUNT_FIELD_NUMBER: _builtins.int
+    format: Global___ChunkFormat.ValueType
+    """Format of the decoded payload (after base64 decoding when using `inline`)."""
+    inline: _builtins.str
+    """Inline payload: the UTF-8 bytes of a base64-encoded string.
+    Clients must base64-decode this field, then interpret the resulting
+    bytes according to `format` (e.g. Arrow IPC or JSON).
+    """
+    row_count: _builtins.int
+    @_builtins.property
+    def remote(self) -> Global___RemoteChunk: ...
+    def __init__(
+        self,
+        *,
+        format: Global___ChunkFormat.ValueType = ...,
+        inline: _builtins.str = ...,
+        remote: Global___RemoteChunk | None = ...,
+        row_count: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["data", b"data", "inline", b"inline", "remote", b"remote"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["data", b"data", "format", b"format", "inline", b"inline", "remote", b"remote", "row_count", b"row_count"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType_data: _TypeAlias = _typing.Literal["inline", "remote"]  # noqa: Y015
+    _WhichOneofArgType_data: _TypeAlias = _typing.Literal["data", b"data"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_data) -> _WhichOneofReturnType_data | None: ...
+
+Global___ResultChunk: _TypeAlias = ResultChunk  # noqa: Y015
+
+@_typing.final
+class DatabaseFetchChunkRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    CHUNKS_FIELD_NUMBER: _builtins.int
+    COLUMNS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def chunks(self) -> _containers.RepeatedCompositeFieldContainer[Global___ResultChunk]: ...
+    @_builtins.property
+    def columns(self) -> _containers.RepeatedCompositeFieldContainer[Global___ColumnMetadata]:
+        """Required for JSON remote chunks (forward from ResultSetGetChunksResponse.columns). Ignored otherwise."""
+
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        chunks: _abc.Iterable[Global___ResultChunk] | None = ...,
+        columns: _abc.Iterable[Global___ColumnMetadata] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["chunks", b"chunks", "columns", b"columns", "conn_handle", b"conn_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseFetchChunkRequest: _TypeAlias = DatabaseFetchChunkRequest  # noqa: Y015
+
+@_typing.final
+class DatabaseFetchChunkResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STREAM_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stream(self) -> Global___ArrowArrayStreamPtr: ...
+    def __init__(
+        self,
+        *,
+        stream: Global___ArrowArrayStreamPtr | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stream", b"stream"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["stream", b"stream"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseFetchChunkResponse: _TypeAlias = DatabaseFetchChunkResponse  # noqa: Y015
+
+@_typing.final
+class ResultSetGetStreamRequest(_message.Message):
+    """ResultSet RPCs"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_SET_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result_set_handle(self) -> Global___ResultSetHandle: ...
+    def __init__(
+        self,
+        *,
+        result_set_handle: Global___ResultSetHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetGetStreamRequest: _TypeAlias = ResultSetGetStreamRequest  # noqa: Y015
+
+@_typing.final
+class ResultSetGetStreamResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STREAM_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stream(self) -> Global___ArrowArrayStreamPtr: ...
+    def __init__(
+        self,
+        *,
+        stream: Global___ArrowArrayStreamPtr | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stream", b"stream"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["stream", b"stream"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetGetStreamResponse: _TypeAlias = ResultSetGetStreamResponse  # noqa: Y015
+
+@_typing.final
+class ResultSetGetChunksRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_SET_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result_set_handle(self) -> Global___ResultSetHandle: ...
+    def __init__(
+        self,
+        *,
+        result_set_handle: Global___ResultSetHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetGetChunksRequest: _TypeAlias = ResultSetGetChunksRequest  # noqa: Y015
+
+@_typing.final
+class ResultSetGetChunksResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CHUNKS_FIELD_NUMBER: _builtins.int
+    COLUMNS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def chunks(self) -> _containers.RepeatedCompositeFieldContainer[Global___ResultChunk]: ...
+    @_builtins.property
+    def columns(self) -> _containers.RepeatedCompositeFieldContainer[Global___ColumnMetadata]:
+        """Column metadata. Required when any chunk is CHUNK_FORMAT_JSON; ignored for Arrow-only results."""
+
+    def __init__(
+        self,
+        *,
+        chunks: _abc.Iterable[Global___ResultChunk] | None = ...,
+        columns: _abc.Iterable[Global___ColumnMetadata] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["chunks", b"chunks", "columns", b"columns"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetGetChunksResponse: _TypeAlias = ResultSetGetChunksResponse  # noqa: Y015
+
+@_typing.final
+class ResultSetReleaseRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULT_SET_HANDLE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def result_set_handle(self) -> Global___ResultSetHandle: ...
+    def __init__(
+        self,
+        *,
+        result_set_handle: Global___ResultSetHandle | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["result_set_handle", b"result_set_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetReleaseRequest: _TypeAlias = ResultSetReleaseRequest  # noqa: Y015
+
+@_typing.final
+class ResultSetReleaseResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ResultSetReleaseResponse: _TypeAlias = ResultSetReleaseResponse  # noqa: Y015
+
+@_typing.final
+class ValidationIssue(_message.Message):
+    """Validation issue reported during set or validate operations."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SEVERITY_FIELD_NUMBER: _builtins.int
+    PARAMETER_FIELD_NUMBER: _builtins.int
+    MESSAGE_FIELD_NUMBER: _builtins.int
+    CODE_FIELD_NUMBER: _builtins.int
+    severity: Global___ValidationSeverity.ValueType
+    parameter: _builtins.str
+    message: _builtins.str
+    code: Global___ValidationCode.ValueType
+    def __init__(
+        self,
+        *,
+        severity: Global___ValidationSeverity.ValueType = ...,
+        parameter: _builtins.str = ...,
+        message: _builtins.str = ...,
+        code: Global___ValidationCode.ValueType = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["code", b"code", "message", b"message", "parameter", b"parameter", "severity", b"severity"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ValidationIssue: _TypeAlias = ValidationIssue  # noqa: Y015
+
+@_typing.final
+class ConfigSetting(_message.Message):
+    """Config setting value (union type)"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STRING_VALUE_FIELD_NUMBER: _builtins.int
+    INT_VALUE_FIELD_NUMBER: _builtins.int
+    DOUBLE_VALUE_FIELD_NUMBER: _builtins.int
+    BYTES_VALUE_FIELD_NUMBER: _builtins.int
+    BOOL_VALUE_FIELD_NUMBER: _builtins.int
+    string_value: _builtins.str
+    int_value: _builtins.int
+    double_value: _builtins.float
+    bytes_value: _builtins.bytes
+    bool_value: _builtins.bool
+    def __init__(
+        self,
+        *,
+        string_value: _builtins.str = ...,
+        int_value: _builtins.int = ...,
+        double_value: _builtins.float = ...,
+        bytes_value: _builtins.bytes = ...,
+        bool_value: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["bool_value", b"bool_value", "bytes_value", b"bytes_value", "double_value", b"double_value", "int_value", b"int_value", "string_value", b"string_value", "value", b"value"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["bool_value", b"bool_value", "bytes_value", b"bytes_value", "double_value", b"double_value", "int_value", b"int_value", "string_value", b"string_value", "value", b"value"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType_value: _TypeAlias = _typing.Literal["string_value", "int_value", "double_value", "bytes_value", "bool_value"]  # noqa: Y015
+    _WhichOneofArgType_value: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_value) -> _WhichOneofReturnType_value | None: ...
+
+Global___ConfigSetting: _TypeAlias = ConfigSetting  # noqa: Y015
+
+@_typing.final
+class ConfigSection(_message.Message):
+    """A config section containing key-value settings"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class SettingsEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ConfigSetting: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ConfigSetting | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    SETTINGS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def settings(self) -> _containers.MessageMap[_builtins.str, Global___ConfigSetting]: ...
+    def __init__(
+        self,
+        *,
+        settings: _abc.Mapping[_builtins.str, Global___ConfigSetting] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["settings", b"settings"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConfigSection: _TypeAlias = ConfigSection  # noqa: Y015
+
+@_typing.final
+class ConnectionSetOptionsRequest(_message.Message):
+    """Batch set options"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class OptionsEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ConfigSetting: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ConfigSetting | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    OPTIONS_FIELD_NUMBER: _builtins.int
+    NO_CONNECTION_DETAILS_FIELD_NUMBER: _builtins.int
+    CONNECTIONS_FILE_PATH_FIELD_NUMBER: _builtins.int
+    no_connection_details: _builtins.bool
+    """True when the caller invoked connect() with zero connection-identifying
+    options (the legacy Python driver's `is_kwargs_empty` condition). The core
+    then falls back to the default connection profile from connections.toml,
+    honoring SNOWFLAKE_DEFAULT_CONNECTION_NAME and config.toml's
+    `default_connection_name`. Language wrappers MUST compute this from the
+    raw caller input *before* injecting any bookkeeping params (application,
+    client_app_id, …); a value of `false` (the default) means "caller supplied
+    something", so do not load the default profile.
+    """
+    connections_file_path: _builtins.str
+    """Optional override for connections.toml. When set (and non-empty), profiles
+    are loaded from this path instead of SNOWFLAKE_HOME / the platform config
+    directory — both the profile named by `connection_name` and, when
+    `no_connection_details` is true, the default profile. A leading `~` is
+    expanded the same way as SNOWFLAKE_HOME. Empty string is treated as unset.
+    Setting this alone does not identify a connection, so wrappers MUST NOT
+    let it clear `no_connection_details`.
+    """
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def options(self) -> _containers.MessageMap[_builtins.str, Global___ConfigSetting]: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        options: _abc.Mapping[_builtins.str, Global___ConfigSetting] | None = ...,
+        no_connection_details: _builtins.bool = ...,
+        connections_file_path: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_connections_file_path", b"_connections_file_path", "conn_handle", b"conn_handle", "connections_file_path", b"connections_file_path"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_connections_file_path", b"_connections_file_path", "conn_handle", b"conn_handle", "connections_file_path", b"connections_file_path", "no_connection_details", b"no_connection_details", "options", b"options"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__connections_file_path: _TypeAlias = _typing.Literal["connections_file_path"]  # noqa: Y015
+    _WhichOneofArgType__connections_file_path: _TypeAlias = _typing.Literal["_connections_file_path", b"_connections_file_path"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__connections_file_path) -> _WhichOneofReturnType__connections_file_path | None: ...
+
+Global___ConnectionSetOptionsRequest: _TypeAlias = ConnectionSetOptionsRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionSetOptionsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    WARNINGS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def warnings(self) -> _containers.RepeatedCompositeFieldContainer[Global___ValidationIssue]: ...
+    def __init__(
+        self,
+        *,
+        warnings: _abc.Iterable[Global___ValidationIssue] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["warnings", b"warnings"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionSetOptionsResponse: _TypeAlias = ConnectionSetOptionsResponse  # noqa: Y015
+
+@_typing.final
+class DatabaseSetOptionsRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class OptionsEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ConfigSetting: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ConfigSetting | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    DB_HANDLE_FIELD_NUMBER: _builtins.int
+    OPTIONS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def db_handle(self) -> Global___DatabaseHandle: ...
+    @_builtins.property
+    def options(self) -> _containers.MessageMap[_builtins.str, Global___ConfigSetting]: ...
+    def __init__(
+        self,
+        *,
+        db_handle: Global___DatabaseHandle | None = ...,
+        options: _abc.Mapping[_builtins.str, Global___ConfigSetting] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["db_handle", b"db_handle", "options", b"options"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseSetOptionsRequest: _TypeAlias = DatabaseSetOptionsRequest  # noqa: Y015
+
+@_typing.final
+class DatabaseSetOptionsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    WARNINGS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def warnings(self) -> _containers.RepeatedCompositeFieldContainer[Global___ValidationIssue]: ...
+    def __init__(
+        self,
+        *,
+        warnings: _abc.Iterable[Global___ValidationIssue] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["warnings", b"warnings"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DatabaseSetOptionsResponse: _TypeAlias = DatabaseSetOptionsResponse  # noqa: Y015
+
+@_typing.final
+class StatementSetOptionsRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
+    class OptionsEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ConfigSetting: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ConfigSetting | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    STMT_HANDLE_FIELD_NUMBER: _builtins.int
+    OPTIONS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def stmt_handle(self) -> Global___StatementHandle: ...
+    @_builtins.property
+    def options(self) -> _containers.MessageMap[_builtins.str, Global___ConfigSetting]: ...
+    def __init__(
+        self,
+        *,
+        stmt_handle: Global___StatementHandle | None = ...,
+        options: _abc.Mapping[_builtins.str, Global___ConfigSetting] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["options", b"options", "stmt_handle", b"stmt_handle"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementSetOptionsRequest: _TypeAlias = StatementSetOptionsRequest  # noqa: Y015
+
+@_typing.final
+class StatementSetOptionsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    WARNINGS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def warnings(self) -> _containers.RepeatedCompositeFieldContainer[Global___ValidationIssue]: ...
+    def __init__(
+        self,
+        *,
+        warnings: _abc.Iterable[Global___ValidationIssue] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["warnings", b"warnings"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___StatementSetOptionsResponse: _TypeAlias = StatementSetOptionsResponse  # noqa: Y015
+
+@_typing.final
+class ConfigLoadAllSectionsRequest(_message.Message):
+    """Config service requests and responses"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONFIG_FILE_FIELD_NUMBER: _builtins.int
+    CONNECTIONS_FILE_FIELD_NUMBER: _builtins.int
+    SKIP_PERMISSIONS_FIELD_NUMBER: _builtins.int
+    config_file: _builtins.str
+    connections_file: _builtins.str
+    skip_permissions: _builtins.bool
+    def __init__(
+        self,
+        *,
+        config_file: _builtins.str | None = ...,
+        connections_file: _builtins.str | None = ...,
+        skip_permissions: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_config_file", b"_config_file", "_connections_file", b"_connections_file", "config_file", b"config_file", "connections_file", b"connections_file"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_config_file", b"_config_file", "_connections_file", b"_connections_file", "config_file", b"config_file", "connections_file", b"connections_file", "skip_permissions", b"skip_permissions"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__config_file: _TypeAlias = _typing.Literal["config_file"]  # noqa: Y015
+    _WhichOneofArgType__config_file: _TypeAlias = _typing.Literal["_config_file", b"_config_file"]  # noqa: Y015
+    _WhichOneofReturnType__connections_file: _TypeAlias = _typing.Literal["connections_file"]  # noqa: Y015
+    _WhichOneofArgType__connections_file: _TypeAlias = _typing.Literal["_connections_file", b"_connections_file"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__config_file) -> _WhichOneofReturnType__config_file | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__connections_file) -> _WhichOneofReturnType__connections_file | None: ...
+
+Global___ConfigLoadAllSectionsRequest: _TypeAlias = ConfigLoadAllSectionsRequest  # noqa: Y015
+
+@_typing.final
+class ConfigLoadAllSectionsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONFIG_JSON_FIELD_NUMBER: _builtins.int
+    config_json: _builtins.str
+    def __init__(
+        self,
+        *,
+        config_json: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["config_json", b"config_json"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConfigLoadAllSectionsResponse: _TypeAlias = ConfigLoadAllSectionsResponse  # noqa: Y015
+
+@_typing.final
+class ConnectionGetQueryStatusRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    query_id: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        query_id: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "query_id", b"query_id"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConnectionGetQueryStatusRequest: _TypeAlias = ConnectionGetQueryStatusRequest  # noqa: Y015
+
+@_typing.final
+class ConnectionGetQueryStatusResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    STATUS_NAME_FIELD_NUMBER: _builtins.int
+    END_TIME_FIELD_NUMBER: _builtins.int
+    ERROR_CODE_FIELD_NUMBER: _builtins.int
+    ERROR_MESSAGE_FIELD_NUMBER: _builtins.int
+    QUERY_ID_FIELD_NUMBER: _builtins.int
+    SESSION_ID_FIELD_NUMBER: _builtins.int
+    SQL_TEXT_FIELD_NUMBER: _builtins.int
+    START_TIME_FIELD_NUMBER: _builtins.int
+    STATE_FIELD_NUMBER: _builtins.int
+    TOTAL_DURATION_FIELD_NUMBER: _builtins.int
+    WAREHOUSE_EXTERNAL_SIZE_FIELD_NUMBER: _builtins.int
+    WAREHOUSE_ID_FIELD_NUMBER: _builtins.int
+    WAREHOUSE_NAME_FIELD_NUMBER: _builtins.int
+    WAREHOUSE_SERVER_TYPE_FIELD_NUMBER: _builtins.int
+    status_name: _builtins.str
+    """Status name as returned by the server (e.g. "RUNNING", "SUCCESS", "FAILED_WITH_ERROR")"""
+    end_time: _builtins.int
+    error_code: _builtins.int
+    error_message: _builtins.str
+    query_id: _builtins.str
+    session_id: _builtins.int
+    sql_text: _builtins.str
+    start_time: _builtins.int
+    state: _builtins.str
+    total_duration: _builtins.int
+    warehouse_external_size: _builtins.str
+    warehouse_id: _builtins.int
+    warehouse_name: _builtins.str
+    warehouse_server_type: _builtins.str
+    def __init__(
+        self,
+        *,
+        status_name: _builtins.str = ...,
+        end_time: _builtins.int = ...,
+        error_code: _builtins.int | None = ...,
+        error_message: _builtins.str | None = ...,
+        query_id: _builtins.str = ...,
+        session_id: _builtins.int = ...,
+        sql_text: _builtins.str = ...,
+        start_time: _builtins.int = ...,
+        state: _builtins.str = ...,
+        total_duration: _builtins.int = ...,
+        warehouse_external_size: _builtins.str | None = ...,
+        warehouse_id: _builtins.int = ...,
+        warehouse_name: _builtins.str | None = ...,
+        warehouse_server_type: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_error_code", b"_error_code", "_error_message", b"_error_message", "_warehouse_external_size", b"_warehouse_external_size", "_warehouse_name", b"_warehouse_name", "_warehouse_server_type", b"_warehouse_server_type", "error_code", b"error_code", "error_message", b"error_message", "warehouse_external_size", b"warehouse_external_size", "warehouse_name", b"warehouse_name", "warehouse_server_type", b"warehouse_server_type"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_error_code", b"_error_code", "_error_message", b"_error_message", "_warehouse_external_size", b"_warehouse_external_size", "_warehouse_name", b"_warehouse_name", "_warehouse_server_type", b"_warehouse_server_type", "end_time", b"end_time", "error_code", b"error_code", "error_message", b"error_message", "query_id", b"query_id", "session_id", b"session_id", "sql_text", b"sql_text", "start_time", b"start_time", "state", b"state", "status_name", b"status_name", "total_duration", b"total_duration", "warehouse_external_size", b"warehouse_external_size", "warehouse_id", b"warehouse_id", "warehouse_name", b"warehouse_name", "warehouse_server_type", b"warehouse_server_type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__error_code: _TypeAlias = _typing.Literal["error_code"]  # noqa: Y015
+    _WhichOneofArgType__error_code: _TypeAlias = _typing.Literal["_error_code", b"_error_code"]  # noqa: Y015
+    _WhichOneofReturnType__error_message: _TypeAlias = _typing.Literal["error_message"]  # noqa: Y015
+    _WhichOneofArgType__error_message: _TypeAlias = _typing.Literal["_error_message", b"_error_message"]  # noqa: Y015
+    _WhichOneofReturnType__warehouse_external_size: _TypeAlias = _typing.Literal["warehouse_external_size"]  # noqa: Y015
+    _WhichOneofArgType__warehouse_external_size: _TypeAlias = _typing.Literal["_warehouse_external_size", b"_warehouse_external_size"]  # noqa: Y015
+    _WhichOneofReturnType__warehouse_name: _TypeAlias = _typing.Literal["warehouse_name"]  # noqa: Y015
+    _WhichOneofArgType__warehouse_name: _TypeAlias = _typing.Literal["_warehouse_name", b"_warehouse_name"]  # noqa: Y015
+    _WhichOneofReturnType__warehouse_server_type: _TypeAlias = _typing.Literal["warehouse_server_type"]  # noqa: Y015
+    _WhichOneofArgType__warehouse_server_type: _TypeAlias = _typing.Literal["_warehouse_server_type", b"_warehouse_server_type"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__error_code) -> _WhichOneofReturnType__error_code | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__error_message) -> _WhichOneofReturnType__error_message | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__warehouse_external_size) -> _WhichOneofReturnType__warehouse_external_size | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__warehouse_name) -> _WhichOneofReturnType__warehouse_name | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__warehouse_server_type) -> _WhichOneofReturnType__warehouse_server_type | None: ...
+
+Global___ConnectionGetQueryStatusResponse: _TypeAlias = ConnectionGetQueryStatusResponse  # noqa: Y015
+
+@_typing.final
+class ConfigGetPathsRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConfigGetPathsRequest: _TypeAlias = ConfigGetPathsRequest  # noqa: Y015
+
+@_typing.final
+class ConfigGetPathsResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONFIG_FILE_FIELD_NUMBER: _builtins.int
+    CONNECTIONS_FILE_FIELD_NUMBER: _builtins.int
+    config_file: _builtins.str
+    connections_file: _builtins.str
+    def __init__(
+        self,
+        *,
+        config_file: _builtins.str = ...,
+        connections_file: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["config_file", b"config_file", "connections_file", b"connections_file"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___ConfigGetPathsResponse: _TypeAlias = ConfigGetPathsResponse  # noqa: Y015
+
+@_typing.final
+class DriverGetFipsStatusRequest(_message.Message):
+    """Reports whether this process is the FIPS driver. Does not open a connection."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DriverGetFipsStatusRequest: _TypeAlias = DriverGetFipsStatusRequest  # noqa: Y015
+
+@_typing.final
+class DriverGetFipsStatusResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    IS_FIPS_FIELD_NUMBER: _builtins.int
+    is_fips: _builtins.bool
+    """True when this binary was built with the fips feature and its linked TLS
+    provider is in FIPS mode. A standard build returns false.
+    """
+    def __init__(
+        self,
+        *,
+        is_fips: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["is_fips", b"is_fips"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___DriverGetFipsStatusResponse: _TypeAlias = DriverGetFipsStatusResponse  # noqa: Y015
+
+@_typing.final
+class WifCreateAttestationRequest(_message.Message):
+    """=============================================================================
+    WORKLOAD IDENTITY FEDERATION (WIF) - standalone attestation
+    =============================================================================
+    Acquires a WIF attestation independently of the driver's own login flow.
+    Reused by Snowpark to authenticate to the external event-table telemetry
+    endpoint with the connection's already-configured WIF provider, not to
+    establish a Snowflake session.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    PROVIDER_FIELD_NUMBER: _builtins.int
+    ENTRA_RESOURCE_FIELD_NUMBER: _builtins.int
+    TOKEN_FIELD_NUMBER: _builtins.int
+    IMPERSONATION_PATH_FIELD_NUMBER: _builtins.int
+    AWS_USE_OUTBOUND_TOKEN_FIELD_NUMBER: _builtins.int
+    WIF_HOST_FIELD_NUMBER: _builtins.int
+    provider: _builtins.str
+    """Wire-format provider name: "AWS", "AZURE", "GCP", or "OIDC"."""
+    entra_resource: _builtins.str
+    """Azure Entra resource URI. AZURE provider only; ignored otherwise.
+    Empty ⇒ use the default Snowflake Entra resource.
+    """
+    token: _builtins.str
+    """Pre-acquired OIDC JWT. OIDC provider only; ignored otherwise."""
+    aws_use_outbound_token: _builtins.bool
+    """When true (AWS provider only), use outbound STS GetWebIdentityToken instead
+    of the default pre-signed GetCallerIdentity attestation. Takes precedence
+    over SNOWFLAKE_ENABLE_AWS_WIF_OUTBOUND_TOKEN.
+    """
+    wif_host: _builtins.str
+    """AWS STS hostname override. Empty/unset uses the regional STS default."""
+    @_builtins.property
+    def impersonation_path(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]:
+        """Ordered impersonation chain, forwarded verbatim to sf_core's
+        WorkloadIdentityConfig.impersonation_path. Empty ⇒ use the ambient
+        workload identity directly (AWS/GCP role chain; Azure: single SP client_id).
+        """
+
+    def __init__(
+        self,
+        *,
+        provider: _builtins.str = ...,
+        entra_resource: _builtins.str | None = ...,
+        token: _builtins.str | None = ...,
+        impersonation_path: _abc.Iterable[_builtins.str] | None = ...,
+        aws_use_outbound_token: _builtins.bool | None = ...,
+        wif_host: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_aws_use_outbound_token", b"_aws_use_outbound_token", "_entra_resource", b"_entra_resource", "_token", b"_token", "_wif_host", b"_wif_host", "aws_use_outbound_token", b"aws_use_outbound_token", "entra_resource", b"entra_resource", "token", b"token", "wif_host", b"wif_host"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_aws_use_outbound_token", b"_aws_use_outbound_token", "_entra_resource", b"_entra_resource", "_token", b"_token", "_wif_host", b"_wif_host", "aws_use_outbound_token", b"aws_use_outbound_token", "entra_resource", b"entra_resource", "impersonation_path", b"impersonation_path", "provider", b"provider", "token", b"token", "wif_host", b"wif_host"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__aws_use_outbound_token: _TypeAlias = _typing.Literal["aws_use_outbound_token"]  # noqa: Y015
+    _WhichOneofArgType__aws_use_outbound_token: _TypeAlias = _typing.Literal["_aws_use_outbound_token", b"_aws_use_outbound_token"]  # noqa: Y015
+    _WhichOneofReturnType__entra_resource: _TypeAlias = _typing.Literal["entra_resource"]  # noqa: Y015
+    _WhichOneofArgType__entra_resource: _TypeAlias = _typing.Literal["_entra_resource", b"_entra_resource"]  # noqa: Y015
+    _WhichOneofReturnType__token: _TypeAlias = _typing.Literal["token"]  # noqa: Y015
+    _WhichOneofArgType__token: _TypeAlias = _typing.Literal["_token", b"_token"]  # noqa: Y015
+    _WhichOneofReturnType__wif_host: _TypeAlias = _typing.Literal["wif_host"]  # noqa: Y015
+    _WhichOneofArgType__wif_host: _TypeAlias = _typing.Literal["_wif_host", b"_wif_host"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__aws_use_outbound_token) -> _WhichOneofReturnType__aws_use_outbound_token | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__entra_resource) -> _WhichOneofReturnType__entra_resource | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__token) -> _WhichOneofReturnType__token | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__wif_host) -> _WhichOneofReturnType__wif_host | None: ...
+
+Global___WifCreateAttestationRequest: _TypeAlias = WifCreateAttestationRequest  # noqa: Y015
+
+@_typing.final
+class WifCreateAttestationResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    PROVIDER_FIELD_NUMBER: _builtins.int
+    CREDENTIAL_FIELD_NUMBER: _builtins.int
+    provider: _builtins.str
+    """Wire-format provider name echoed back ("AWS", "AZURE", "GCP", "OIDC")."""
+    credential: _builtins.str
+    """The attestation credential (JWT or attested request) to forward to the
+    relying party as proof of workload identity.
+    """
+    def __init__(
+        self,
+        *,
+        provider: _builtins.str = ...,
+        credential: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["credential", b"credential", "provider", b"provider"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___WifCreateAttestationResponse: _TypeAlias = WifCreateAttestationResponse  # noqa: Y015
+
+@_typing.final
+class TelemetrySendApiUsageRequest(_message.Message):
+    """=============================================================================
+    TELEMETRY - In-band telemetry messages sent from wrappers via core
+    =============================================================================
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    API_METHOD_FIELD_NUMBER: _builtins.int
+    PASSED_ARGUMENTS_FIELD_NUMBER: _builtins.int
+    api_method: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    @_builtins.property
+    def passed_arguments(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]:
+        """Names of the arguments the caller explicitly passed to the API method.
+        Names only — never argument values, and parameters left at their default
+        are omitted. Used to learn which optional fields callers actually exercise.
+        """
+
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        api_method: _builtins.str = ...,
+        passed_arguments: _abc.Iterable[_builtins.str] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["api_method", b"api_method", "conn_handle", b"conn_handle", "passed_arguments", b"passed_arguments"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___TelemetrySendApiUsageRequest: _TypeAlias = TelemetrySendApiUsageRequest  # noqa: Y015
+
+@_typing.final
+class TelemetrySendWrapperErrorRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    EXCEPTION_TYPE_FIELD_NUMBER: _builtins.int
+    ERROR_SOURCE_FIELD_NUMBER: _builtins.int
+    exception_type: _builtins.str
+    error_source: _builtins.str
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        exception_type: _builtins.str = ...,
+        error_source: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "error_source", b"error_source", "exception_type", b"exception_type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___TelemetrySendWrapperErrorRequest: _TypeAlias = TelemetrySendWrapperErrorRequest  # noqa: Y015
+
+@_typing.final
+class TelemetrySendResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___TelemetrySendResponse: _TypeAlias = TelemetrySendResponse  # noqa: Y015
+
+@_typing.final
+class TelemetrySendLogRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CONN_HANDLE_FIELD_NUMBER: _builtins.int
+    MESSAGE_JSON_FIELD_NUMBER: _builtins.int
+    TIMESTAMP_MS_FIELD_NUMBER: _builtins.int
+    message_json: _builtins.str
+    timestamp_ms: _builtins.int
+    @_builtins.property
+    def conn_handle(self) -> Global___ConnectionHandle: ...
+    def __init__(
+        self,
+        *,
+        conn_handle: Global___ConnectionHandle | None = ...,
+        message_json: _builtins.str = ...,
+        timestamp_ms: _builtins.int = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["conn_handle", b"conn_handle", "message_json", b"message_json", "timestamp_ms", b"timestamp_ms"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___TelemetrySendLogRequest: _TypeAlias = TelemetrySendLogRequest  # noqa: Y015
+
+SERVICE_ERROR_FIELD_NUMBER: _builtins.int
+METHOD_ERROR_FIELD_NUMBER: _builtins.int
+ASYNC_FIRST_FIELD_NUMBER: _builtins.int
+service_error: _extension_dict._ExtensionFieldDescriptor[_descriptor_pb2.ServiceOptions, _builtins.str]
+method_error: _extension_dict._ExtensionFieldDescriptor[_descriptor_pb2.MethodOptions, _builtins.str]
+async_first: _extension_dict._ExtensionFieldDescriptor[_descriptor_pb2.MethodOptions, _builtins.bool]
+"""Marks a slow, cancellable RPC as async-first: language generators emit a
+Future/awaitable-returning client method instead of a blocking one.
+"""