Skip to main content

GraphService

Struct GraphService 

Source
pub struct GraphService<S: StorageClient + Clone + 'static> {
    pub stats_manager: Arc<StatsManager>,
    /* private fields */
}

Fields§

§stats_manager: Arc<StatsManager>

Implementations§

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + AutoCommitBatchOps + 'static> GraphService<S>

Source

pub async fn execute_batch( &self, session_id: i64, statements: &[String], parameters: Option<HashMap<String, Value>>, session_variables: Option<HashMap<String, Value>>, ) -> Vec<Result<QueryResult, GraphServiceError>>

Execute a batch of auto-commit DML statements inside one shared auto-commit batch window.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + AutoCommitBatchOps + AutoCommitGroupOps + 'static> GraphService<S>

Source

pub async fn execute_batch_grouped( &self, session_id: i64, statements: &[String], group_size: usize, ) -> Vec<Result<QueryResult, GraphServiceError>>

Execute a batch of auto-commit DML statements inside shared group-commit windows.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + 'static> GraphService<S>

Source

pub async fn open_cursor( &self, session_id: i64, stmt: &str, ) -> Result<(u64, Vec<String>), String>

Open a forward-only cursor over a single statement’s result.

Source

pub async fn fetch_cursor( &self, session_id: i64, cursor_id: u64, page_size: usize, ) -> Result<CursorPage, String>

Fetch one page from a cursor. Chunk pulls run off the async runtime; a failed execution drops the cursor and reports the error.

Source

pub async fn close_cursor( &self, session_id: i64, cursor_id: u64, ) -> Result<bool, String>

Release a cursor. Unknown ids report closed: false, never an error.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + 'static> GraphService<S>

Source

pub async fn estimate_rows(&self, session_id: i64, stmt: &str) -> Option<u64>

Best-effort output row estimate for automatic routing.

Source

pub async fn explain( &self, session_id: i64, stmt: &str, parameters: Option<HashMap<String, Value>>, session_variables: Option<HashMap<String, Value>>, ) -> Result<QueryResult, GraphServiceError>

Plan a statement via EXPLAIN without executing it.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + 'static> GraphService<S>

Source

pub async fn new(config: Config, storage: Arc<S>) -> Arc<Self> ⓘ

Create a new GraphService (without a transaction manager, for use in a production environment).

Source

pub async fn new_for_test(config: Config, storage: Arc<S>) -> Arc<Self> ⓘ

Create a new GraphService (without a transaction manager and without starting any background tasks, for testing purposes).

Source

pub async fn new_with_transaction_manager( config: Config, storage: Arc<S>, transaction_manager: Arc<TransactionManager>, ) -> Arc<Self> ⓘ

Use the transaction manager to create a GraphService.

Source

pub async fn new_with_transaction_manager_and_stats( config: Config, storage: Arc<S>, transaction_manager: Arc<TransactionManager>, stats_manager: Arc<StatsManager>, ) -> Arc<Self> ⓘ

Use the transaction manager and external StatsManager to create a GraphService.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + 'static> GraphService<S>

Source

pub async fn execute( &self, session_id: i64, stmt: &str, ) -> Result<QueryResult, GraphServiceError>

Source

pub async fn execute_with_params( &self, session_id: i64, stmt: &str, parameters: Option<HashMap<String, Value>>, session_variables: Option<HashMap<String, Value>>, ) -> Result<QueryResult, GraphServiceError>

Execute a query with client-supplied query parameters (@name references) and/or session variables ($name references).

Source

pub async fn execute_with_consistency( &self, session_id: i64, stmt: &str, parameters: Option<HashMap<String, Value>>, session_variables: Option<HashMap<String, Value>>, consistency: ConsistencyLevel, ) -> Result<QueryResult, GraphServiceError>

Execute a query with explicit consistency requirement.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + 'static> GraphService<S>

Source

pub async fn authenticate( &self, username: &str, password: &str, ) -> Result<Arc<ClientSession>, String>

Source

pub fn security_config(&self) -> &SecurityConfig

Password-policy settings snapshotted at startup.

Source

pub fn validate_new_password( &self, username: &str, password: &str, ) -> Result<(), String>

Validate a new plaintext password against the configured policy.

Applies on every write path, including auth-disabled deployments: disabling auth only skips the login step, never weak-password writes.

Source

pub fn password_expired(&self, username: &str) -> bool

Whether the account password is past the configured maximum age.

Source

pub fn session_idle_timeout(&self) -> Duration

Session idle timeout driving expiry responses and reclamation.

Source

pub fn must_change_password(&self, username: &str) -> bool

Whether the login response should prompt a password change.

True when forced rotation is configured and the default seed account has never changed its password, or when the account password is past the configured maximum age.

Source

pub fn is_user_locked(&self, username: &str) -> bool

Whether the account is currently disabled.

Source

pub fn shutdown(&self)

Graceful shutdown of the shared execution infrastructure.

Source

pub async fn signout(&self, session_id: i64)

Source

pub fn get_session_manager(&self) -> &Arc<GraphSessionManager> ⓘ

Source

pub fn get_permission_manager(&self) -> &Arc<PermissionManager> ⓘ

Source

pub fn permission_checker(&self) -> PermissionChecker

Source

pub fn is_auth_disabled(&self) -> bool

Whether authentication is globally disabled.

Returns true when either [auth].enable_authorize = false or [bootstrap].single_user_mode = true. Both flags cause the middleware layer to skip session-id verification and fall through to a default identity so purely-local deployments can operate without a login round-trip.

Source

pub fn auth_config(&self) -> &AuthConfig

Authenticator configuration reference.

Source

pub fn bootstrap_config(&self) -> &BootstrapConfig

Bootstrap configuration reference.

Source

pub fn get_storage_space_id(&self, space_name: &str) -> Option<i64>

Source

pub fn get_stats_manager(&self) -> &Arc<StatsManager> ⓘ

Source

pub fn sync_api(&self) -> Option<&Arc<SyncApi>>

Source

pub fn query_manager(&self) -> Arc<QueryManager> ⓘ

Shared process-level query manager.

Source

pub async fn list_sessions(&self) -> Vec<SessionInfo>

Obtain the session list (SHOW SESSIONS)

Source

pub async fn get_session_info(&self, session_id: i64) -> Option<SessionInfo>

Obtain detailed information about the specified session.

Source

pub async fn kill_session( &self, session_id: i64, current_user: &str, ) -> SessionResult<()>

Terminate the session (KILL SESSION)

Source

pub fn kill_query(&self, session_id: i64, query_id: u32) -> SessionResult<()>

Terminate the query (KILL QUERY)

Source

pub fn list_users_detailed(&self) -> Vec<UserDetail>

List users with display role, enablement status and last login time.

Source

pub fn admin_create_user( &self, caller: &str, username: &str, password: &str, ) -> Result<(), String>

Create a user through the admin channel.

Source

pub async fn admin_reset_password( &self, caller: &str, caller_session_id: Option<i64>, username: &str, new_password: &str, ) -> Result<(), String>

Reset a password through the admin channel without old-password check.

except_session_id keeps the caller’s own session alive while every other session of the target account is invalidated.

Source

pub async fn admin_set_user_enabled( &self, caller: &str, caller_session_id: Option<i64>, username: &str, enabled: bool, ) -> Result<(), String>

Enable or disable a user; disabling evicts existing sessions.

Source

pub async fn admin_drop_user( &self, caller: &str, username: &str, ) -> Result<(), String>

Drop a user and clean roles plus sessions.

Source

pub fn admin_grant_role( &self, caller: &str, username: &str, space: &str, role_name: &str, ) -> Result<(), String>

Grant a role with dual write to storage and permission state.

Source

pub fn admin_revoke_role( &self, caller: &str, username: &str, space: &str, ) -> Result<(), String>

Revoke a role with dual write to storage and permission state.

Source

pub fn sync_role_from_storage(&self, username: &str)

Sync query-channel role writes into permission state.

Storage remains the source of truth; this keeps the in-memory permission map consistent when GRANT/REVOKE arrive via queries.

Source§

impl<S: StorageClient + StorageSchemaContextOps + StorageSyncContextOps + StorageOperationContextOps + Clone + 'static> GraphService<S>

Source

pub async fn execute_stream( &self, session_id: i64, stmt: &str, ) -> Result<StreamingQueryResult, GraphServiceError>

Execute a query and return a StreamingQueryResult for chunk-at-a-time consumption.

Source

pub async fn execute_stream_with_params( &self, session_id: i64, stmt: &str, parameters: Option<HashMap<String, Value>>, session_variables: Option<HashMap<String, Value>>, ) -> Result<StreamingQueryResult, GraphServiceError>

Execute a query with caller-supplied bindings and return a streaming handle.

Auto Trait Implementations§

§

impl<S> !Freeze for GraphService<S>

§

impl<S> !RefUnwindSafe for GraphService<S>

§

impl<S> !UnwindSafe for GraphService<S>

§

impl<S> Send for GraphService<S>
where Arc<RwLock<RawRwLock, QueryApi<S>>>: Send, Arc<S>: Send,

§

impl<S> Sync for GraphService<S>
where Arc<RwLock<RawRwLock, QueryApi<S>>>: Sync, Arc<S>: Sync,

§

impl<S> Unpin for GraphService<S>

§

impl<S> UnsafeUnpin for GraphService<S>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Conv for T

Source§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
Source§

impl<T> FmtForward for T

Source§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
Source§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
Source§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
Source§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
Source§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
Source§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
Source§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
Source§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
Source§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<A, B, T> HttpServerConnExec<A, B> for T
where B: Body,

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pipe for T
where T: ?Sized,

Source§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
Source§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
Source§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Source§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
Source§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
Source§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
Source§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> Tap for T

Source§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
Source§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
Source§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
Source§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
Source§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
Source§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
Source§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
Source§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
Source§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
Source§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> TryConv for T

Source§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more