Field | Type | Label | Description |
isTrue | bool |
|
Field | Type | Label | Description |
cookie | bytes |
|
Field | Type | Label | Description |
cookie | bytes |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
group | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
user | io.deephaven.proto.auth.UserContext |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
usersOrGroups | string | repeated |
|
Enough information to propagate the basics of an AuthException
from the server to the client by sending this message in
Metadata.
Field | Type | Label | Description |
callStatus | CallStatus |
|
|
message | string |
|
Request argument for authenticateByCookieRequest rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
client_id | ClientId | the new client id for the client making the request. |
|
user_context | UserContext | the credentials desired, which should match the cookie. |
|
cookie | bytes | a valid cookie for another client on the same user context. |
Request response for replaceClient rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
result | AuthenticationResult |
|
Request argument for authenticateByDelegateToken rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
client_id | ClientId |
|
|
delegate_token | Token |
|
Request response for authenticateByDelegateToken rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
result | AuthenticationResult |
|
Request argument for authenticateByExternal rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
client_id | ClientId | the client id for the client making the request. |
|
key | string | the key for external authentication. |
Request response for authenticateByExternal rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
result | AuthenticationResult |
|
Request argument for authenticateByPassword prc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
client_id | ClientId | the client id for the client making the request. |
|
user_context | UserContext | the credentials desired. |
|
password | string | the password. |
Request response for authenticateByPassword rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
result | AuthenticationResult |
|
Request argument for authenticateByPublicKey rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
client_id | ClientId | the client id for the client making the request. |
|
user_context | UserContext | the credentials desired. |
|
public_key | bytes | the public key. |
|
challenge_response | bytes | The nonce challenge response, which should have been obtained from processing the result of an earlier getNonce rpc request by the client. |
|
ip_address | bytes | the ip address of the server that provided the nonce |
Request response for authenticateByPublicKey rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
result | AuthenticationResult |
|
Servers respond to Authenticate* requests with an opaque cookie for the (client_id, user, effectiveUser) combination
granted in the request. clients remember and use the same cookie in subsequent RPCs to the server that intend to use
those credentials. This cookie should be refreshed prior to the deadline, which is represented as milliseconds since
epoch. Clients are encouraged to refresh considerably in advance of the deadline, as to be able to continue
operating under network delays. The expected pattern is for clients to refresh half-way throught their
available period from the last refresh to the deadline.
Field | Type | Label | Description |
authenticated | bool | true if authentication was successful. |
|
cookie | bytes | the cookie that the client should remember and refresh before its deadline to remain authenticated. |
|
cookie_deadline_time_millis | sfixed64 | the absolute time in milliseconds from the epoch when the cookie will expire. |
|
userContext | UserContext | the user context actually authenticated; if there was one in the request should match it. |
A unique client identifier sent by clients to introduce themselves to servers.
Field | Type | Label | Description |
name | string |
|
|
uuid | bytes | A client uuid in bytes is created by client library code and used for the lifetime of that client process. A client's uuid is expected by the server to be unique across all live client channels. If the same client process during its lifetime connects to different server processes, be it on different machines or different server process instances on the same machine (eg, server bounce), the client process is expected to use the same uuid to all servers. |
Request argument for getNonce rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
client_id | ClientId | the client id for the client making the request. |
Request response for getNonce rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
nonce | bytes | the nonce payload |
|
ip_address | bytes | the ip address of the server host that produced the nonce |
Request argument for getTokenAs rpc
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
cookie | bytes | the cookie for the client making the request. |
|
service | string | the service for which the token is intended. |
|
operateAsUser | string | the user as whom the client desires to operate. |
Request response for getTokenAs rpc
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
token | Token | the token payload |
Request argument for getToken rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
cookie | bytes | the cookie for the client making the request. |
|
service | string | the service for which the token is intended. |
Request response for getToken rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
token | Token | the token payload |
Request argument for invalidateCookie rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
cookie | bytes | the cookie value to invalidate. |
Request response for invalidateCookie rpc.
See the service definition file for details on the rpc request.
This message is not used in requests/responses, but to serialize/deserialize the
information associated with a uuid client (KV key) with its payload (KV value) in etcd.
Field | Type | Label | Description |
hashedCookie | bytes |
|
|
userContext | UserContext |
|
Request argument for refreshCookie rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
cookie | bytes | The actual cookie that was handed to the client by the server, that the client is trying to refresh. |
Request response for refreshCookie rpc.
See the service definition file for details on the rpc request.
If the RefreshCookieResponse includes a new cookie, then the cookie
has cycled and the previous cookie will timeout.
Field | Type | Label | Description |
cookie | bytes | The cookie; clients should note if it has changed from the one they handed to the request. |
|
cookie_deadline_time_millis | sfixed64 | Absolute time expressed as milliseconds from the epoch when cookie expires. |
Request argument for reload rpc.
See the service definition file for details on the rpc request.
Request response for reload rpc.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
result | string | A string that a tool asking for configuration reload can show. |
A token is a server-generated identifier for a client that allows the client to present themselves to other
services using the token as a means of verifying identity and credentials; the other service can validate
a token provided by a client with an authentication server to confirm the claimed identity and credentials.
Field | Type | Label | Description |
token_id | fixed64 | The actual token payload. |
|
service | string | The service for which the token is intended. |
|
user_context | UserContext | The credentials for the token. |
|
ip_address | bytes | The ip address of the authentication server that produced the token. |
Field | Type | Label | Description |
authenticatedUser | string |
|
|
effectiveUser | string |
|
Request argument for verifyNonce request.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
server_ip_address | bytes | the ip address of the server making the request on behalf of a client |
|
client_id | ClientId | the client id for the client making the originating request |
|
user_context | UserContext | the credentials desired. |
|
public_key | bytes | the public key. |
|
challenge_response | bytes | The nonce challenge response, which should have been obtained from processing the result of an earlier getNonce rpc request by the client on the server receiving this request ("this" server) |
Request response for verifyNonce request.
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
success | bool |
|
|
userContext | UserContext | The user context that can be actually authenticated; if there was one in the original client request this should match it. |
Request argument for verifyToken rpc
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
service | string | the service who received the token and wishes to verify. |
|
token | Token | the token payload for verification. |
Request response for verifyToken rpc
See the service definition file for details on the rpc request.
Field | Type | Label | Description |
token_valid | bool | whether the token is valid or not. |
Map directly to classes derived from AuthException.
If you modify this enum, ensure to keep consistent the mappings to/from it
in GrpcAuthenticationService.java and GrpcAuthenticationClientManager.java.
Name | Number | Description |
OK | 0 | No error, everything is fine. |
AUTH_ERROR_NON_RETRYABLE | 1 | AuthException, non-retryable. |
AUTH_ERROR_RETRYABLE | 2 | AuthException, retryable. |
ALREADY_AUTHENTICATED | 3 | AlreadyAuthenticatedException |
NOT_AUTHENTICATED | 4 | NotAuthenticatedException |
PUB_PRIV_KEY | 5 | PubPrivKeyException |
TOKEN_CREATION | 6 | TokenCreationException |
TOKEN_VERIFICATION | 7 | TokenVerificationException |
UNAVAILABLE | 8 | UnavailableException |
Method Name | Request Type | Response Type | Description |
ping | .io.deephaven.proto.common.PingRequest | .io.deephaven.proto.common.PingResponse | Simple ping method that allows a client to sample the latency to the server. |
authenticateByPassword | .io.deephaven.proto.auth.AuthenticateByPasswordRequest | .io.deephaven.proto.auth.AuthenticateByPasswordResponse | Authenticate by password. |
authenticateByPublicKey | .io.deephaven.proto.auth.AuthenticateByPublicKeyRequest | .io.deephaven.proto.auth.AuthenticateByPublicKeyResponse | Authenticate by public key challenge; should have obtained a nonce earlier via getNonce rpc. |
authenticateByDelegateToken | .io.deephaven.proto.auth.AuthenticateByDelegateTokenRequest | .io.deephaven.proto.auth.AuthenticateByDelegateTokenResponse | Authenticate by delegate token; should have obtained a token earlier from another service that created it and forwarded it. |
authenticateByExternal | .io.deephaven.proto.auth.AuthenticateByExternalRequest | .io.deephaven.proto.auth.AuthenticateByExternalResponse | Authenticate by an external method (eg, active directory). |
authenticateByCookie | .io.deephaven.proto.auth.AuthenticateByCookieRequest | .io.deephaven.proto.auth.AuthenticateByCookieResponse | Authenticate by providing an already existing cookie and the user context that cookie should be associated with. |
refreshCookie | .io.deephaven.proto.auth.RefreshCookieRequest | .io.deephaven.proto.auth.RefreshCookieResponse | Refresh a cookie to maintain credentials. Clients are expected to try to refresh cookies with enough time in advance before expiration; a reasonable default is half way through from the time the cookie was obtained with its deadline, and the actual deadline time. |
invalidateCookie | .io.deephaven.proto.auth.InvalidateCookieRequest | .io.deephaven.proto.auth.InvalidateCookieResponse | Clients that are about to terminate are expected to invalidate their credentials before going away. |
getNonce | .io.deephaven.proto.auth.GetNonceRequest | .io.deephaven.proto.auth.GetNonceResponse | Get a nonce for public key authentication. |
getToken | .io.deephaven.proto.auth.GetTokenRequest | .io.deephaven.proto.auth.GetTokenResponse | Get a token for a three-way handshake. |
getTokenAs | .io.deephaven.proto.auth.GetTokenAsRequest | .io.deephaven.proto.auth.GetTokenAsResponse | Get a token for a three-way handshake as a particular user. |
verifyToken | .io.deephaven.proto.auth.VerifyTokenRequest | .io.deephaven.proto.auth.VerifyTokenResponse | Verify a token provided by another service. |
reload | .io.deephaven.proto.auth.ReloadRequest | .io.deephaven.proto.auth.ReloadResponse | Request this server to reload its configuration. |
verifyChallenge | .io.deephaven.proto.auth.VerifyChallengeRequest | .io.deephaven.proto.auth.VerifyChallengeResponse | Verify a nonce challenge response for another server (not used directly by clients, only server-server) |
Response to about request.
Field | Type | Label | Description |
version | int32 |
|
|
name | string |
|
|
message | string |
|
Request for About information.
Response to authentication request.
Field | Type | Label | Description |
isAuthenticated | bool |
|
Request to authenticate.
Field | Type | Label | Description |
token | bytes | serialized AuthToken, will be empty if the token is null |
Field | Type | Label | Description |
errorMessage | string |
|
|
stackTrace | string |
|
|
shortCauses | string |
|
Field | Type | Label | Description |
sender_send_time_millis | sfixed64 |
|
|
from | string | a log-printable string identifying the sender of the request. |
Field | Type | Label | Description |
receiver_receive_time_millis | sfixed64 |
|
|
from | string | a log-printable string identifying the sender of the response. |
Enum mirroring NamespaceSet
Name | Number | Description |
UNSET | 0 | |
SYSTEM | 1 | |
USER | 2 |
Delete one or more properties files
Field | Type | Label | Description |
name | string | repeated |
|
response to DeleteFilesRequest
just success or an exception
Field | Type | Label | Description |
name | string |
|
Field | Type | Label | Description |
name | string |
|
|
contentBytes | bytes |
|
Field | Type | Label | Description |
name | string |
|
|
contentBytes | bytes |
|
|
updateOnSameContents | bool |
|
Field | Type | Label | Description |
updateFileRequest | UpdateFileRequest | repeated |
|
Method Name | Request Type | Response Type | Description |
about | .io.deephaven.proto.common.AboutRequest | .io.deephaven.proto.common.AboutReply | |
getFile | .io.deephaven.proto.config.GetFileRequest | .io.deephaven.proto.config.GetFileResponse | Get the text of a single file. This is needed to implement PropertInputStreamLoader. |
getAllFiles | .io.deephaven.proto.config.GetAllFilesRequest | .io.deephaven.proto.config.GetFileResponse stream | Get the text of all properties files. |
updateFile | .io.deephaven.proto.config.UpdateFileRequest | .io.deephaven.proto.config.UpdateFileResponse | Attempt to update a properties file. |
deleteFiles | .io.deephaven.proto.config.DeleteFilesRequest | .io.deephaven.proto.config.DeleteFilesResponse | Attempt to delete one or more properties files. Deleting a non-existant file is not considered an error. |
Field | Type | Label | Description |
cookie | bytes |
|
|
config | PersistentQueryConfigMessage |
|
Field | Type | Label | Description |
querySerial | int64 |
|
Field | Type | Label | Description |
name | string |
|
|
displayName | string |
|
|
description | string | optional |
|
acceptsParameters | bool |
|
Field | Type | Label | Description |
token | io.deephaven.proto.auth.Token |
|
|
clientId | io.deephaven.proto.auth.ClientId |
|
|
getConfiguration | bool |
|
Field | Type | Label | Description |
authenticated | bool |
|
|
cookie | bytes |
|
|
config | ControllerConfigurationMessage | optional |
|
Field | Type | Label | Description |
name | string |
|
|
displayName | string |
|
|
displayable | bool |
|
|
properties | ConsoleConfigurationTypeMessage.PropertiesEntry | repeated |
|
hasScript | bool |
|
|
serverClasses | string | repeated |
|
allowedGroups | string | repeated |
|
extraColumns | ExtraColumnMessage | repeated |
|
typeSpecificWireConfigJSON | string | optional |
|
configCheckerClass | string |
|
|
configPanelFactoryClass | string |
|
|
customActionProviderClass | string |
|
|
setupQueryClass | string |
|
|
configClass | string |
|
|
shutdownProcedureClass | string |
|
|
extraJvmArgsClass | string |
|
|
configProcessorClass | string |
|
|
extraColumnGetterClass | string |
|
|
popupProviderClass | string | repeated |
|
configTypeDetailsClass | string |
|
|
communityInitializerClass | string |
|
|
hasScriptLanguage | bool |
|
|
communityRequestProcessorClass | string |
|
|
supportsReplicas | bool |
|
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Field | Type | Label | Description |
maxHeapSizeGb | int32 |
|
|
minDataBufferPoolRatio | double |
|
|
maxDataBufferPoolRatio | double |
|
|
configurationTypes | ConsoleConfigurationTypeMessage | repeated |
|
temporaryQueueDetails | ControllerTempQueueDetailsMessage | repeated |
|
defaultTempQueueName | string |
|
|
dbServers | PQDBServerConfigMessage | repeated |
|
defaultSchedulingDetails | string | repeated |
|
scheduleLookForwardDays | int32 |
|
|
publicKey | bytes |
|
|
algorithm | string |
|
|
consoleServerGroups | NamedStringList | repeated |
|
jvmProfileNames | string | repeated |
|
defaultJvmProfileName | string |
|
|
dataRoutingImplName | string |
|
|
tdsConfigs | RoutingConfigMessage | repeated |
|
disConfigs | RoutingConfigMessage | repeated |
|
lasConfigs | RoutingConfigMessage | repeated |
|
assignmentPolicies | AssignmentPolicyConfigMessage | repeated |
|
defaultAssignmentPolicyName | string |
|
|
defaultAssignmentPolicyParams | string |
|
Field | Type | Label | Description |
name | string |
|
|
maxConcurrentQueries | int32 |
|
|
maxHeapMb | int32 |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
serverGroupName | string |
|
|
heapSizeMb | int32 |
|
|
workerKind | string |
|
Field | Type | Label | Description |
serverConfig | PQDBServerConfigMessage |
|
Field | Type | Label | Description |
name | string |
|
|
rendererName | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
Field | Type | Label | Description |
config | ControllerConfigurationMessage |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
command | ScriptCommandEnum |
|
|
querySerial | int64 | optional |
|
effectiveUser | string | optional |
|
scriptLoaderStateJSON | string | optional |
|
useRelativePath | bool |
|
Field | Type | Label | Description |
results | string | repeated |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
command | ScriptCommandEnum |
|
|
querySerial | int64 | optional |
|
effectiveUser | string | optional |
|
scriptLoaderStateJSON | string | optional |
|
scriptPath | string |
|
|
useRelativePath | bool |
|
Field | Type | Label | Description |
scriptBody | string | optional |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
config | PersistentQueryConfigMessage |
|
|
doRestart | bool |
|
Field | Type | Label | Description |
name | string |
|
|
host | string |
|
|
port | int32 |
|
|
classPushListResourceName | string | optional |
|
serverClass | string |
|
|
maxHeapSizeGb | double |
|
|
serverType | ServerTypeEnum |
|
|
consoleGroups | string | repeated |
|
serverInfo | string | optional |
|
Field | Type | Label | Description |
cookie | bytes |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
serial | int64 |
|
Field | Type | Label | Description |
serial | int64 |
|
|
replica | int32 |
|
|
spare | int32 |
|
|
processInfoId | string | optional |
|
Field | Type | Label | Description |
replica | ReplicaSpecifier |
|
|
success | bool |
|
|
error | string | optional |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
serials | int64 | repeated |
|
Field | Type | Label | Description |
successSerials | int64 | repeated |
|
errorSerials | RestartQueryResponse.ErrorSerialsEntry | repeated |
|
Field | Type | Label | Description |
key | int64 |
|
|
value | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
replicas | ReplicaSpecifier | repeated |
|
Field | Type | Label | Description |
status | ReplicaStatus | repeated |
|
Field | Type | Label | Description |
name | string |
|
|
tags | string | repeated |
|
description | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
command | string |
|
Field | Type | Label | Description |
result | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
Field | Type | Label | Description |
status | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
querySerial | int64 |
|
|
status | PersistentQueryStatusEnum | optional |
|
hasExportedObjects | bool |
|
|
exportedObjects | ExportedObjectInfoMessage | repeated |
|
hasTableGroups | bool |
|
|
tableGroups | NamedStringList | repeated |
|
processInfoId | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
serials | int64 | repeated |
|
Field | Type | Label | Description |
successSerials | int64 | repeated |
|
errorSerials | StopQueryResponse.ErrorSerialsEntry | repeated |
|
Field | Type | Label | Description |
key | int64 |
|
|
value | string |
|
Field | Type | Label | Description |
cookie | bytes |
|
|
replicas | ReplicaSpecifier | repeated |
|
Field | Type | Label | Description |
status | ReplicaStatus | repeated |
|
Field | Type | Label | Description |
cookie | bytes |
|
Field | Type | Label | Description |
event | SubscriptionEvent |
|
|
querySerial | int64 | Only populated for SE_REMOVE |
|
queryInfo | PersistentQueryInfoMessage | Only populated for SE_PUT or SE_BATCH_END |
|
config | ControllerConfigurationMessage | Only populated for SE_CONFIG_UPDATE |
Name | Number | Description |
SCE_UNSPECIFIED | 0 | |
SCE_GET_AS_SELF | 1 | |
SCE_GET_AS_OTHER | 2 | |
SCE_GET_FOR_QUERY | 3 |
Name | Number | Description |
STE_UNSPECIFIED | 0 | |
STE_DISPATCHER | 1 | |
STE_GROUP | 2 |
Name | Number | Description |
SE_UNSPECIFIED | 0 | |
SE_PUT | 1 | |
SE_REMOVE | 2 | |
SE_CONFIG_UPDATE | 3 | |
SE_BATCH_END | 4 |
Field | Type | Label | Description |
message | string |
|
Field | Type | Label | Description |
name | string |
|
|
values | string | repeated |
|
Field | Type | Label | Description |
cookie | bytes | optional |
|
Field | Type | Label | Description |
name | string |
|
|
type | ExportedObjectTypeEnum |
|
|
tableDefinition | io.deephaven.proto.common.TableDefinitionMessage |
|
|
originalType | string |
|
Field | Type | Label | Description |
serial | int64 | 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. |
|
version | int64 | The modification version of this persistent query, which increases by one each time the configuration is modified. |
|
name | string | The name of this persistent query. Currently, the name must be unique to make diagnosing problems easier. |
|
owner | string | The owner of the query. The query runs in the user context of the owner. |
|
enabled | bool | Is this query enabled? Enabled queries can be executed, disable queries cannot. |
|
heapSizeGb | double | How much heap should be allocated to this query? |
|
bufferPoolToHeapRatio | double |
|
|
detailedGCLoggingEnabled | bool |
|
|
extraJvmArguments | string | repeated | Extra JVM arguments for this query. |
extraEnvironmentVariables | string | repeated | Extra environment variables for this query. |
classPathAdditions | string | repeated | 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. |
serverName | string | 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. |
|
adminGroups | string | repeated | Groups that may administer the query. Administrators may change the query configuration, stop and start it, and view tables without ACL application. |
viewerGroups | string | repeated | Groups that may view the query. |
restartUsers | RestartUsersEnum | Controls the behavior of who can restart the query (admins, viewers, or viewers when down). |
|
scriptCode | string | The text of the query's startup script. |
|
scriptPath | string | A path to the query's startup script in the controller's Git repository. |
|
scriptLanguage | string | The query's script language. Groovy or Python are supported. |
|
configurationType | string | What kind of query is this. Typical values are "Script" or "RunAndDone". |
|
typeSpecificFieldsJson | string | optional | JSON representing the fields for this configuration type. The content of this field is dependent on configurationType. |
scheduling | string | repeated | An array of Strings that define when the query starts and stops. |
timeoutNanos | int64 | How many nanoseconds to allow the query to initialize (or execute for batch queries). |
|
jvmProfile | string | The jvm profile used by the query. |
|
lastModifiedByAuthenticated | string | The authenticated user that last modified the configuration. |
|
lastModifiedByEffective | string | The effective user that last modified the configuration. |
|
lastModifiedTimeNanos | int64 | The last time the query was modified, in nanoseconds since the epoch. |
|
completedStatus | string | The status of a temporary query that has entered a terminal state. |
|
expirationTimeNanos | int64 | When this temporary query should be removed, in nanoseconds since the epoch. |
|
kubernetesControl | string | A JSON string that is used by the dispatcher to customize the worker’s pod when deployed on Kubernetes. |
|
workerKind | string | What kind of worker is this. DeephavenEnterprise for Legacy workers. DeephavenCommunity for Core+ workers. |
|
createdTimeNanos | int64 | The query creation time, in nanoseconds since the epoch. |
|
replicaCount | int32 | The number of replicas to create and spread load across |
|
spareCount | int32 | The number of spare workers to create and use as spares to replace failed replicas |
|
assignmentPolicy | string | The policy the controller should use to assign clients to individual replicas |
|
assignmentPolicyParams | string | optional | The policy parameters |
additionalMemoryGb | double | How much memory beyond the JVM should be allocated to this query? |
|
pythonControl | string | Core+ Python virtual environment control |
|
genericWorkerControl | string | Generic worker control JSON |
Field | Type | Label | Description |
config | PersistentQueryConfigMessage |
|
|
state | PersistentQueryStateMessage | optional |
|
replicas | PersistentQueryStateMessage | repeated |
|
spares | PersistentQueryStateMessage | repeated |
|
Field | Type | Label | Description |
serial | int64 |
|
|
version | int64 |
|
|
status | PersistentQueryStatusEnum |
|
|
initializationStartNanos | int64 |
|
|
initializationCompleteNanos | int64 |
|
|
lastUpdateNanos | int64 |
|
|
dispatcherHost | string |
|
|
tableGroups | NamedStringList | repeated |
|
scopeTypes | ExportedObjectInfoMessage | repeated |
|
connectionDetails | ProcessorConnectionDetailsMessage | optional |
|
exceptionDetails | io.deephaven.proto.common.ExceptionDetailsMessage | optional |
|
typeSpecificStateJson | string | Encoded JSON |
|
lastAuthenticatedUser | string |
|
|
lastEffectiveUser | string |
|
|
scriptLoaderStateJson | string | optional | Encoded JSON |
hasProgress | bool |
|
|
progressValue | int32 |
|
|
progressMessage | string |
|
|
engineVersion | string |
|
|
dispatcherPort | int32 |
|
|
shouldStopNanos | int64 |
|
|
numFailures | int32 |
|
|
lastFailureTimeNanos | int64 |
|
|
replicaSlot | int32 |
|
|
statusDetails | string |
|
Field | Type | Label | Description |
protocols | WorkerProtocolMessage | repeated |
|
workerName | string |
|
|
processInfoId | string |
|
|
processorHost | string |
|
|
envoyPrefix | string |
|
|
grpcUrl | string |
|
|
staticUrl | string |
|
|
enterpriseWebSocketUrl | string |
|
Field | Type | Label | Description |
name | string |
|
|
port | int32 |
|
Name | Number | Description |
EOT_UNSPECIFIED | 0 | |
EOT_TABLE | 1 | |
EOT_TREE_TABLE | 2 | |
EOT_TABLE_MAP | 3 | |
EOT_FIGURE | 4 | |
EOT_OTHER_WIDGET | 5 | |
EOT_PARAMETERIZED_QUERY | 6 | |
EOT_PANDAS | 7 | |
EOT_NON_DISPLAYABLE | 8 |
Name | Number | Description |
PQS_UNSPECIFIED | 0 | |
PQS_UNINITIALIZED | 1 | |
PQS_CONNECTING | 2 | |
PQS_AUTHENTICATING | 3 | |
PQS_ACQUIRING_WORKER | 4 | |
PQS_INITIALIZING | 5 | |
PQS_RUNNING | 6 | |
PQS_FAILED | 7 | |
PQS_ERROR | 8 | |
PQS_DISCONNECTED | 9 | |
PQS_STOPPING | 10 | |
PQS_STOPPED | 11 | |
PQS_COMPLETED | 12 | |
PQS_EXECUTING | 13 |
Deephaven data types
Name | Number | Description |
RU_UNSPECIFIED | 0 | |
RU_ADMIN | 1 | |
RU_ADMIN_AND_VIEWERS | 2 | |
RU_RESERVED_1 | 3 | |
RU_VIEWERS_WHEN_DOWN | 4 |
Field | Type | Label | Description |
id | string |
|
|
workers | WorkerInfo | repeated |
|
Field | Type | Label | Description |
host | string |
|
|
port | int32 |
|
|
nonce | int64 |
|
|
workerKind | WorkerKind |
|
Name | Number | Description |
WK_UNSPECIFIED | 0 | The zero valued item is the default for a field of an enum type when not set; we want to ensure they are always set and plan to treat this default as an error. |
WK_ENTERPRISE | 1 | |
WK_DND | 2 |
Remoting for the ServiceRegistry interface.
Method Name | Request Type | Response Type | Description |
about | .io.deephaven.proto.common.AboutRequest | .io.deephaven.proto.common.AboutReply | |
updateWorkers | .io.deephaven.proto.registry.UpdateWorkersRequest | .io.deephaven.proto.registry.UpdateWorkersResponse |
Request for all DataImportServiceDestinationConfigs
Request for all LogAggregatorConfigs
Request for all TableDataServiceConfigs
A filter representing the claimed-by-claimant filter, against the global list of claims
Field | Type | Label | Description |
claimant | string |
|
|
claims | ClaimsMessage |
|
"Global" collection of all claims made in the configuration
Field | Type | Label | Description |
namespaceClaims | ClaimsMessage.NamespaceClaimsEntry | repeated | namespace to claimant |
tableClaims | ClaimsMessage.TableClaimsEntry | repeated | namespace to (table to claimant) |
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Field | Type | Label | Description |
key | string |
|
|
value | TableClaimMessage |
|
========== DataRoutingService metadata ======================================
empty
Field | Type | Label | Description |
collectedClaims | ClaimsMessage |
|
Message conveying a DataImportServiceConfig
Field | Type | Label | Description |
name | string |
|
|
intradayDirectoryName | string | int32 port = 2; // obsolete int32 tailerPort = 3; // obsolete |
|
filter | FilterMessage |
|
|
storageRoot | google.protobuf.StringValue |
|
|
definitionStorageRoot | string |
|
|
webserverParameters | WebserverParametersMessage |
|
|
properties | DataImportServiceConfigMessage.PropertiesEntry | repeated |
|
endpointConfig | DataImportServiceEndpointConfigMessage | bool isTableDataPortEnabled = 11; // obsolete bool isTailerPortEnabled = 12; // obsolete |
|
group | google.protobuf.StringValue |
|
|
claims | MyClaimsMessage |
|
|
storageName | string |
|
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Request for DataImportServiceConfigs
Field | Type | Label | Description |
name | string |
|
|
excludeCore | bool |
|
Response to request for DataImportServiceConfigs
Field | Type | Label | Description |
configMessage | DataImportServiceConfigMessage | repeated |
|
Response to request for DataImportServiceDestinationConfigs
Field | Type | Label | Description |
endpointConfig | DataImportServiceEndpointConfigMessage |
|
Request for DataImportServiceDestinationConfigs
Field | Type | Label | Description |
tableIdentifier | TableIdentifierMessage |
|
endpoint configuration with additional DIS fields
Field | Type | Label | Description |
endpointConfig | EndpointConfigMessage |
|
|
throttleKBps | int32 |
|
Message indicating that the data routing config has changed.
The actual changes must be requested via another channel.
This message is also used as a keep-alive heartbeat, indicated by an unchanged wrt value.
Field | Type | Label | Description |
clientId | int64 |
|
|
wrt | int64 |
|
Request to begin listening for routing config changes
Field | Type | Label | Description |
clientId | int64 |
|
Message requesting the current DataRoutingService configuration - main file plus additional DISes
Message conveying the current DataRoutingService file and additional DISes
Field | Type | Label | Description |
yml | string | the main routing file, as a yaml string |
|
disConfigs | DataRoutingConfigurationResponse.DisConfigsEntry | repeated | additional DIS configurations, by name |
Field | Type | Label | Description |
key | string |
|
|
value | DataImportServiceConfigMessage |
|
Message requesting the current DataRoutingService file (not additional DISes)
Request to update the main data routing file with the ymldata content
Field | Type | Label | Description |
ymldata | bytes |
|
|
user | string |
|
|
code | string |
|
|
comment | string |
|
Response to DataRoutingFileUpdateRequest
Request to update one or more items comprising the data routing configuration.
This is a composite message that may be used to add DISes, update or remove DISes, replace all DISes,
and optionally update the main routing file at the same time for an atomic change.
Field | Type | Label | Description |
configToAdd | DataImportServiceConfigMessage | repeated | DIS Configs to add. These must not already exist. |
configToUpdate | DataImportServiceConfigMessage | repeated | DIS Configs to update (update or replace/clobber) |
configToRemove | string | repeated | DIS Configs to remove. |
removeOthers | bool | when replacing/clobbering, remove all other DISes not in the update list |
|
lenient | bool | allow certain errors, such as deleting a non-existent DIS |
|
user | string |
|
|
code | string |
|
|
comment | string |
|
|
ignoreErrors | bool | ignore parsing errors |
|
routingYmlString | google.protobuf.StringValue | the main routing file, as a yaml string |
general endpoint configuration
Field | Type | Label | Description |
name | string |
|
|
serviceRegistryType | string |
|
|
properties | EndpointConfigMessage.PropertiesEntry | repeated |
|
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Message conveying a DataRoutingService.Filter
Field | Type | Label | Description |
yml | string | serialized filter |
|
claimsFilter | ClaimsFilterMessage | fully formed claims filter |
|
ifNotClaimedFilter | IfNotClaimedFilterMessage | fully formed ifNotClaimed filter |
|
listFilter | ListFilterMessage | List filter |
A filter representing if-not-claimed then my-filter filter, using the global list of claims
Field | Type | Label | Description |
claims | ClaimsMessage |
|
|
filter | FilterMessage |
|
A list of filters. Keep the proto parsing going for another level
Field | Type | Label | Description |
filter | FilterMessage | repeated |
|
Message conveying a LogAggregatorConfig
Field | Type | Label | Description |
name | string |
|
|
description | google.protobuf.StringValue |
|
|
port | int32 | obsolete |
|
filter | FilterMessage |
|
|
properties | LogAggregatorConfigMessage.PropertiesEntry | repeated |
|
endpointConfig | LogAggregatorEndpointConfigMessage |
|
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Request for LogAggregatorConfig
Field | Type | Label | Description |
name | string |
|
Response to request for LogAggregatorConfig
Field | Type | Label | Description |
configMessage | LogAggregatorConfigMessage |
|
Request for LogAggregatorEndpointConfig
Field | Type | Label | Description |
tableIdentifier | TableIdentifierMessage |
|
Response to request for LogAggregatorEndpointConfig
Field | Type | Label | Description |
endpointConfig | LogAggregatorEndpointConfigMessage |
|
endpoint configuration with additional LAS fields
Field | Type | Label | Description |
endpointConfig | EndpointConfigMessage |
|
The specific claims made by a single DIS
Field | Type | Label | Description |
namespaces | string | repeated |
|
tables | MyClaimsMessage.TableId | repeated |
|
Field | Type | Label | Description |
namespace | string |
|
|
tableName | string |
|
Component of ClaimsMessage, a claimed table associated with a namespace
Field | Type | Label | Description |
tableClaims | TableClaimMessage.TableClaimsEntry | repeated | table to claimant |
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Message conveying a DataRoutingService.TableDataServiceConfig
Field | Type | Label | Description |
name | string |
|
|
filter | FilterMessage |
|
|
storageRoot | google.protobuf.StringValue |
|
|
description | google.protobuf.StringValue |
|
|
tags | string | repeated |
|
port | google.protobuf.Int32Value | obsolete |
|
properties | TableDataServiceConfigMessage.PropertiesEntry | repeated | property provider |
endpointConfig | EndpointConfigMessage |
|
|
delegate | TableDataServiceConfigMessage | repeated |
|
storageName | google.protobuf.StringValue |
|
Field | Type | Label | Description |
key | string |
|
|
value | string |
|
Request for a TableDataServiceConfig
Field | Type | Label | Description |
name | string |
|
Response to request for TableDataServiceConfig
Field | Type | Label | Description |
tdsConfig | TableDataServiceConfigMessage |
|
|
collectedClaims | ClaimsMessage |
|
Response to request for multiple(all) DataRoutingService.TableDataServiceConfigs
Field | Type | Label | Description |
collectedClaims | ClaimsMessage |
|
|
tdsConfig | TableDataServiceConfigMessage | repeated |
|
Message conveying a DataRoutingService.TableDataService
TODO
Request for a TableDataService
Field | Type | Label | Description |
name | string |
|
Response to request for a TableDataService
Field | Type | Label | Description |
tds | TableDataServiceMessage |
|
Message conveying a TableIdentifier
Field | Type | Label | Description |
namespace | google.protobuf.StringValue |
|
|
tableName | google.protobuf.StringValue |
|
|
namespaceSet | io.deephaven.proto.common.NamespaceSetEnum |
|
Message conveying JettyServerHelper.Parameters data
Field | Type | Label | Description |
mainClassName | string |
|
|
enabled | bool |
|
|
authenticationRequired | bool |
|
|
sslRequired | bool |
|
|
port | int32 |
|
Remoting for the DataRoutingService interface.
Field | Type | Label | Description |
name | string |
|
|
namespaceSet | NamespaceSet | only valid for create |
|
code | string |
|
|
comment | string |
|
Field | Type | Label | Description |
set | NamespaceSet |
|
Field | Type | Label | Description |
namespaceSet | NamespaceSet |
|
Field | Type | Label | Description |
schema | bytes |
|
|
copySchema | google.protobuf.BytesValue |
|
Field | Type | Label | Description |
item | SchemaItem |
|
Field | Type | Label | Description |
namespace | string |
|
|
tableName | string |
|
|
version | int64 |
|
|
action | Action |
|
|
schema | SchemaItem |
|
|
code | string |
|
|
comment | string |
|
Field | Type | Label | Description |
namespaceSet | NamespaceSet |
|
|
namespace | string |
|
Field | Type | Label | Description |
namespaceSet | NamespaceSet |
|
|
namespace | string |
|
|
tableName | string |
|
Name | Number | Description |
Get | 0 | |
Create | 1 | |
Update | 2 | |
Delete | 3 |
Name | Number | Description |
Unset | 0 | |
System | 1 | |
User | 2 | |
DoesNotExist | 3 |
Remoting for the Schema Service.
Field | Type | Label | Description |
endpointConfigs | RoutingEndpointConfigMessage | repeated |
|
Field | Type | Label | Description |
name | string |
|
Field | Type | Label | Description |
endpointConfigs | RoutingEndpointConfigMessage | repeated |
|
Field | Type | Label | Description |
leaseId | google.protobuf.Int64Value |
|
|
endpointConfig | RoutingEndpointConfigMessage |
|
Field | Type | Label | Description |
leaseId | int64 |
|
|
name | string |
|
|
leaseTtl | int32 |
|
|
leaseRenewSeconds | int32 |
|
|
leaseRenewRetryDelay | int32 |
|
Field | Type | Label | Description |
name | string |
|
|
leaseId | int64 |
|
Field | Type | Label | Description |
success | bool |
|
Field | Type | Label | Description |
name | string |
|
|
leaseId | int64 |
|
Field | Type | Label | Description |
name | string |
|
|
endpointId | string |
|
|
host | string |
|
|
port | int32 |
|
|
processId | string |
|
Field | Type | Label | Description |
name | string |
|
|
endpointId | string |
|
Field | Type | Label | Description |
endpointConfig | RoutingEndpointConfigMessage |
|
Field | Type | Label | Description |
name | string |
|
|
dataType | string |
|
|
componentType | string | optional |
|
columnType | ColumnTypeEnum | optional |
|
isVarSizeString | bool |
|
|
encoding | EncodingTypeEnum | optional |
|
codec | string | optional |
|
codecArgs | string | optional |
|
objectWidthBytes | int32 | optional |
|
Field | Type | Label | Description |
namespace | string | optional |
|
tableName | string | optional |
|
columns | ColumnDefinitionMessage | repeated |
|
storageType | StorageTypeEnum | optional |
|
Name | Number | Description |
CT_UNSPECIFIED | 0 | |
CT_NORMAL | 1 | |
CT_GROUPING | 2 | |
CT_PARTITIONING | 4 | |
CT_VIRTUAL | 8 |
Name | Number | Description |
ET_UNSPECIFIED | 0 | |
ET_ISO_8859_1 | 1 | |
ET_UTF_8 | 2 | |
ET_US_ASCII | 4 | |
ET_UTF_16 | 8 | |
ET_UTF_16BE | 16 | |
ET_UTF_16LE | 32 |
Name | Number | Description |
ST_UNSPECIFIED | 0 | |
ST_IN_MEMORY | 1 | |
ST_NESTED_PARTITIONED_ON_DISK | 2 | |
ST_SPLAYED_ON_DISK | 4 | |
ST_EXTENDED | 8 |
Remoting for the Unified API
Method Name | Request Type | Response Type | Description |
about | .io.deephaven.proto.common.AboutRequest | .io.deephaven.proto.common.AboutReply | |
authenticate | .io.deephaven.proto.common.AuthRequest | .io.deephaven.proto.common.AuthReply | Authenticate using the AuthToken in the AuthRequest. This can be used to remove authentication. The client will hold on to this authenticated context for subsequent calls. |
Remoting for the ServiceRegistry interface.
.proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
double | double | double | float | float64 | double | float | Float | |
float | float | float | float | float32 | float | float | Float | |
int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum |
uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) |
uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) |
sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum |
fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) |
fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum |
sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum |
bool | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass | |
string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) |
bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | []byte | ByteString | string | String (ASCII-8BIT) |