deephaven_enterprise.proto.persistent_query_pb2¶
Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
Module Contents¶
- class ExportedObjectInfoMessage(*, name=..., type=..., tableDefinition=..., originalType=...)[source]¶
Bases:
google.protobuf.message.MessageAbstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.
- Parameters:
name (str)
tableDefinition (deephaven_enterprise.proto.table_definition_pb2.TableDefinitionMessage | None)
originalType (str)
- ClearField(field_name)[source]¶
Clears the contents of a given field.
Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group,
ValueErroris raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Raises:
ValueError – if the field_name is not a member of this message.
- Return type:
None
- HasField(field_name)[source]¶
Checks if a certain field is set for the message.
For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor,
ValueErrorwill be raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Returns:
Whether a value has been set for the named field.
- Return type:
- Raises:
ValueError – if the field_name is not a member of this message.
- DESCRIPTOR: google.protobuf.descriptor.Descriptor[source]¶
- property tableDefinition: deephaven_enterprise.proto.table_definition_pb2.TableDefinitionMessage[source]¶
- class PersistentQueryConfigMessage(*, serial=..., version=..., name=..., owner=..., enabled=..., heapSizeGb=..., bufferPoolToHeapRatio=..., detailedGCLoggingEnabled=..., extraJvmArguments=..., extraEnvironmentVariables=..., classPathAdditions=..., serverName=..., adminGroups=..., viewerGroups=..., restartUsers=..., scriptCode=..., scriptPath=..., scriptLanguage=..., configurationType=..., typeSpecificFieldsJson=..., scheduling=..., timeoutNanos=..., jvmProfile=..., lastModifiedByAuthenticated=..., lastModifiedByEffective=..., lastModifiedTimeNanos=..., completedStatus=..., expirationTimeNanos=..., kubernetesControl=..., workerKind=..., createdTimeNanos=..., replicaCount=..., spareCount=..., assignmentPolicy=..., assignmentPolicyParams=..., additionalMemoryGb=..., pythonControl=..., genericWorkerControl=...)[source]¶
Bases:
google.protobuf.message.MessageAbstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.
- Parameters:
serial (int)
version (int)
name (str)
owner (str)
enabled (bool)
heapSizeGb (float)
bufferPoolToHeapRatio (float)
detailedGCLoggingEnabled (bool)
extraJvmArguments (collections.abc.Iterable[str] | None)
extraEnvironmentVariables (collections.abc.Iterable[str] | None)
classPathAdditions (collections.abc.Iterable[str] | None)
serverName (str)
adminGroups (collections.abc.Iterable[str] | None)
viewerGroups (collections.abc.Iterable[str] | None)
restartUsers (Global___RestartUsersEnum)
scriptCode (str)
scriptPath (str)
scriptLanguage (str)
configurationType (str)
typeSpecificFieldsJson (str | None)
scheduling (collections.abc.Iterable[str] | None)
timeoutNanos (int)
jvmProfile (str)
lastModifiedByAuthenticated (str)
lastModifiedByEffective (str)
lastModifiedTimeNanos (int)
completedStatus (str)
expirationTimeNanos (int)
kubernetesControl (str)
workerKind (str)
createdTimeNanos (int)
replicaCount (int)
spareCount (int)
assignmentPolicy (str)
assignmentPolicyParams (str | None)
additionalMemoryGb (float)
pythonControl (str)
genericWorkerControl (str)
- ClearField(field_name)[source]¶
Clears the contents of a given field.
Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group,
ValueErroris raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Raises:
ValueError – if the field_name is not a member of this message.
- Return type:
None
- HasField(field_name)[source]¶
Checks if a certain field is set for the message.
For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor,
ValueErrorwill be raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Returns:
Whether a value has been set for the named field.
- Return type:
- Raises:
ValueError – if the field_name is not a member of this message.
- WhichOneof(oneof_group: Literal['_assignmentPolicyParams', b'_assignmentPolicyParams']) Literal['assignmentPolicyParams'] | None[source]¶
- WhichOneof(oneof_group: Literal['_typeSpecificFieldsJson', b'_typeSpecificFieldsJson']) Literal['typeSpecificFieldsJson'] | None
- WhichOneof(oneof_group: Literal['scriptData', b'scriptData']) Literal['scriptCode', 'scriptPath'] | None
Returns the name of the field that is set inside a oneof group.
If no field is set, returns None.
- Parameters:
oneof_group (str) – the name of the oneof group to check.
- Returns:
The name of the group that is set, or None.
- Return type:
str or None
- Raises:
ValueError – no group with the given name exists
- DESCRIPTOR: google.protobuf.descriptor.Descriptor[source]¶
- additionalMemoryGb: float[source]¶
How much memory beyond the JVM should be allocated to this query?
- property adminGroups: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str][source]¶
Groups that may administer the query. Administrators may change the query configuration, stop and start it, and view tables without ACL application.
- assignmentPolicy: str[source]¶
The policy the controller should use to assign clients to individual replicas
- property classPathAdditions: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str][source]¶
Extra paths to include in the queries class path. The class paths are included at the beginning of the worker’s classpath, thus overriding the default classes and resources.
- configurationType: str[source]¶
What kind of query is this. Typical values are “Script” or “RunAndDone”.
- enabled: bool[source]¶
Is this query enabled? Enabled queries can be executed, disable queries cannot.
- expirationTimeNanos: int[source]¶
When this temporary query should be removed, in nanoseconds since the epoch.
- property extraEnvironmentVariables: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str][source]¶
even-numbered entries contain the environment variable name; odd-numbered entries contain its value.
- Type:
Extra environment variables for this query. These must be supplied in pairs
- Return type:
google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]
- property extraJvmArguments: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str][source]¶
Extra JVM arguments for this query.
- kubernetesControl: str[source]¶
A JSON string that is used by the dispatcher to customize the worker’s pod when deployed on Kubernetes.
- lastModifiedByAuthenticated: str[source]¶
The authenticated user that last modified the configuration.
- lastModifiedTimeNanos: int[source]¶
The last time the query was modified, in nanoseconds since the epoch.
- name: str[source]¶
The name of this persistent query. Currently, the name must be unique to make diagnosing problems easier.
- restartUsers: Global___RestartUsersEnum[source]¶
Controls the behavior of who can restart the query (admins, viewers, or viewers when down).
- property scheduling: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str][source]¶
An array of Strings that define when the query starts and stops.
- serial: int[source]¶
The serial number is a unique identifier for this persistent query. From the perspective of the controller, the serial number is what determines which query is which.
- serverName: str[source]¶
The server to execute on. The server name is not a hostname, but rather a string used by the Controller to map to an underlying query dispatcher. For example, “Query_1” could map to the first query server or “Auto_Merge” could map to a server selection provider for merge servers.
- spareCount: int[source]¶
The number of spare workers to create and use as spares to replace failed replicas
- timeoutNanos: int[source]¶
How many nanoseconds to allow the query to initialize (or execute for batch queries).
- typeSpecificFieldsJson: str[source]¶
JSON representing the fields for this configuration type. The content of this field is dependent on configurationType.
- version: int[source]¶
The modification version of this persistent query, which increases by one each time the configuration is modified.
- property viewerGroups: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str][source]¶
Groups that may view the query.
- class PersistentQueryInfoMessage(*, config=..., state=..., replicas=..., spares=..., is_admin=...)[source]¶
Bases:
google.protobuf.message.MessageAbstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.
- Parameters:
config (Global___PersistentQueryConfigMessage | None)
state (Global___PersistentQueryStateMessage | None)
replicas (collections.abc.Iterable[Global___PersistentQueryStateMessage] | None)
spares (collections.abc.Iterable[Global___PersistentQueryStateMessage] | None)
is_admin (bool)
- ClearField(field_name)[source]¶
Clears the contents of a given field.
Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group,
ValueErroris raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Raises:
ValueError – if the field_name is not a member of this message.
- Return type:
None
- HasField(field_name)[source]¶
Checks if a certain field is set for the message.
For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor,
ValueErrorwill be raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Returns:
Whether a value has been set for the named field.
- Return type:
- Raises:
ValueError – if the field_name is not a member of this message.
- WhichOneof(oneof_group)[source]¶
Returns the name of the field that is set inside a oneof group.
If no field is set, returns None.
- Parameters:
oneof_group (str) – the name of the oneof group to check.
- Returns:
The name of the group that is set, or None.
- Return type:
str or None
- Raises:
ValueError – no group with the given name exists
- DESCRIPTOR: google.protobuf.descriptor.Descriptor[source]¶
- property config: Global___PersistentQueryConfigMessage[source]¶
- Return type:
- property replicas: google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___PersistentQueryStateMessage][source]¶
- property spares: google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___PersistentQueryStateMessage][source]¶
- property state: Global___PersistentQueryStateMessage[source]¶
- Return type:
- class PersistentQueryStateMessage(*, serial=..., version=..., status=..., initializationStartNanos=..., initializationCompleteNanos=..., lastUpdateNanos=..., dispatcherHost=..., tableGroups=..., scopeTypes=..., connectionDetails=..., exceptionDetails=..., typeSpecificStateJson=..., lastAuthenticatedUser=..., lastEffectiveUser=..., scriptLoaderStateJson=..., hasProgress=..., progressValue=..., progressMessage=..., engineVersion=..., dispatcherPort=..., shouldStopNanos=..., numFailures=..., lastFailureTimeNanos=..., replicaSlot=..., statusDetails=...)[source]¶
Bases:
google.protobuf.message.MessageAbstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.
- Parameters:
serial (int)
version (int)
status (Global___PersistentQueryStatusEnum)
initializationStartNanos (int)
initializationCompleteNanos (int)
lastUpdateNanos (int)
dispatcherHost (str)
tableGroups (collections.abc.Iterable[deephaven_enterprise.proto.controller_common_pb2.NamedStringList] | None)
scopeTypes (collections.abc.Iterable[Global___ExportedObjectInfoMessage] | None)
connectionDetails (Global___ProcessorConnectionDetailsMessage | None)
exceptionDetails (deephaven_enterprise.proto.common_pb2.ExceptionDetailsMessage | None)
typeSpecificStateJson (str)
lastAuthenticatedUser (str)
lastEffectiveUser (str)
scriptLoaderStateJson (str | None)
hasProgress (bool)
progressValue (int)
progressMessage (str)
engineVersion (str)
dispatcherPort (int)
shouldStopNanos (int)
numFailures (int)
lastFailureTimeNanos (int)
replicaSlot (int)
statusDetails (str)
- ClearField(field_name)[source]¶
Clears the contents of a given field.
Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group,
ValueErroris raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Raises:
ValueError – if the field_name is not a member of this message.
- Return type:
None
- HasField(field_name)[source]¶
Checks if a certain field is set for the message.
For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor,
ValueErrorwill be raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Returns:
Whether a value has been set for the named field.
- Return type:
- Raises:
ValueError – if the field_name is not a member of this message.
- WhichOneof(oneof_group: Literal['_connectionDetails', b'_connectionDetails']) Literal['connectionDetails'] | None[source]¶
- WhichOneof(oneof_group: Literal['_exceptionDetails', b'_exceptionDetails']) Literal['exceptionDetails'] | None
- WhichOneof(oneof_group: Literal['_scriptLoaderStateJson', b'_scriptLoaderStateJson']) Literal['scriptLoaderStateJson'] | None
Returns the name of the field that is set inside a oneof group.
If no field is set, returns None.
- Parameters:
oneof_group (str) – the name of the oneof group to check.
- Returns:
The name of the group that is set, or None.
- Return type:
str or None
- Raises:
ValueError – no group with the given name exists
- DESCRIPTOR: google.protobuf.descriptor.Descriptor[source]¶
- property connectionDetails: Global___ProcessorConnectionDetailsMessage[source]¶
- Return type:
- property exceptionDetails: deephaven_enterprise.proto.common_pb2.ExceptionDetailsMessage[source]¶
- initializationCompleteNanos: int[source]¶
The time in nanoseconds since the epoch when initialization completed. Zero if not completed.
- initializationStartNanos: int[source]¶
The time in nanoseconds since the epoch when initialization started. Zero if not started.
- lastUpdateNanos: int[source]¶
The time in nanoseconds since the epoch when the state was last updated. Zero if never updated.
- property scopeTypes: google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ExportedObjectInfoMessage][source]¶
- class ProcessorConnectionDetailsMessage(*, protocols=..., workerName=..., processInfoId=..., processorHost=..., envoyPrefix=..., grpcUrl=..., staticUrl=..., enterpriseWebSocketUrl=...)[source]¶
Bases:
google.protobuf.message.MessageAbstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.
- Parameters:
protocols (collections.abc.Iterable[Global___WorkerProtocolMessage] | None)
workerName (str)
processInfoId (str)
processorHost (str)
envoyPrefix (str)
grpcUrl (str)
staticUrl (str)
enterpriseWebSocketUrl (str)
- ClearField(field_name)[source]¶
Clears the contents of a given field.
Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group,
ValueErroris raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Raises:
ValueError – if the field_name is not a member of this message.
- Return type:
None
- DESCRIPTOR: google.protobuf.descriptor.Descriptor[source]¶
- envoyPrefix: str[source]¶
The envoy prefix/header to use when connecting to the worker, if any. Empty if unused.
- class WorkerProtocolMessage(*, name=..., port=...)[source]¶
Bases:
google.protobuf.message.MessageAbstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.
- ClearField(field_name)[source]¶
Clears the contents of a given field.
Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group,
ValueErroris raised.- Parameters:
field_name (str) – The name of the field to check for presence.
- Raises:
ValueError – if the field_name is not a member of this message.
- Return type:
None
- DESCRIPTOR: google.protobuf.descriptor.Descriptor[source]¶
- EOT_FIGURE: ExportedObjectTypeEnum[source]¶
- EOT_HIERARCHICAL_TABLE: ExportedObjectTypeEnum[source]¶
- EOT_NON_DISPLAYABLE: ExportedObjectTypeEnum[source]¶
- EOT_OTHER_WIDGET: ExportedObjectTypeEnum[source]¶
- EOT_PANDAS: ExportedObjectTypeEnum[source]¶
- EOT_PARAMETERIZED_QUERY: ExportedObjectTypeEnum[source]¶
- EOT_PARTITIONED_TABLE: ExportedObjectTypeEnum[source]¶
- EOT_TABLE: ExportedObjectTypeEnum[source]¶
- EOT_TABLE_MAP: ExportedObjectTypeEnum[source]¶
- EOT_TREE_TABLE: ExportedObjectTypeEnum[source]¶
- EOT_UNSPECIFIED: ExportedObjectTypeEnum[source]¶
- type Global___ExportedObjectInfoMessage = ExportedObjectInfoMessage[source]¶
- type Global___ExportedObjectTypeEnum = ExportedObjectTypeEnum[source]¶
- type Global___PersistentQueryConfigMessage = PersistentQueryConfigMessage[source]¶
- type Global___PersistentQueryInfoMessage = PersistentQueryInfoMessage[source]¶
- type Global___PersistentQueryStateMessage = PersistentQueryStateMessage[source]¶
- type Global___PersistentQueryStatusEnum = PersistentQueryStatusEnum[source]¶
- type Global___ProcessorConnectionDetailsMessage = ProcessorConnectionDetailsMessage[source]¶
- type Global___RestartUsersEnum = RestartUsersEnum[source]¶
- type Global___WorkerProtocolMessage = WorkerProtocolMessage[source]¶
- PQS_ACQUIRING_WORKER: PersistentQueryStatusEnum[source]¶
- PQS_AUTHENTICATING: PersistentQueryStatusEnum[source]¶
- PQS_COMPLETED: PersistentQueryStatusEnum[source]¶
- PQS_CONNECTING: PersistentQueryStatusEnum[source]¶
- PQS_DISCONNECTED: PersistentQueryStatusEnum[source]¶
- PQS_ERROR: PersistentQueryStatusEnum[source]¶
- PQS_EXECUTING: PersistentQueryStatusEnum[source]¶
- PQS_FAILED: PersistentQueryStatusEnum[source]¶
- PQS_FINDING_DISPATCHER: PersistentQueryStatusEnum[source]¶
This state is not used.
- PQS_INITIALIZING: PersistentQueryStatusEnum[source]¶
- PQS_RUNNING: PersistentQueryStatusEnum[source]¶
- PQS_STOPPED: PersistentQueryStatusEnum[source]¶
- PQS_STOPPING: PersistentQueryStatusEnum[source]¶
- PQS_UNINITIALIZED: PersistentQueryStatusEnum[source]¶
- PQS_UNSPECIFIED: PersistentQueryStatusEnum[source]¶
- RU_ADMIN: RestartUsersEnum[source]¶
- RU_ADMIN_AND_VIEWERS: RestartUsersEnum[source]¶
- RU_RESERVED_1: RestartUsersEnum[source]¶
- RU_UNSPECIFIED: RestartUsersEnum[source]¶
- RU_VIEWERS_WHEN_DOWN: RestartUsersEnum[source]¶