Struct TableRef 

pub struct TableRef { /* private fields */ }

Immutable query builder for a EdgeBase table.

let result = client.table("posts")
    .where_("status", "==", "published")
    .or_(|q| q.where_("status", "==", "draft"))
    .order_by("createdAt", "desc")
    .limit(20)
    .get_list()
    .await?;

Implementations

impl TableRef

pub fn new(http: Arc<HttpClient>, name: &str) -> Self

pub fn with_db( http: Arc<HttpClient>, name: &str, namespace: &str, instance_id: Option<&str>, ) -> Self

Create a TableRef for a specific DB namespace + optional instance ID.

pub fn where_<V: Serialize>(self, field: &str, op: &str, value: V) -> Self

pub fn or_(self, builder_fn: impl FnOnce(OrBuilder) -> OrBuilder) -> Self

pub fn order_by(self, field: &str, direction: &str) -> Self

pub fn limit(self, n: u32) -> Self

pub fn offset(self, n: u32) -> Self

pub fn page(self, n: u32) -> Self

pub fn search(self, q: &str) -> Self

pub fn after(self, cursor: &str) -> Self

pub fn before(self, cursor: &str) -> Self

pub fn name(&self) -> &str

Collection name.

pub async fn get_list(&self) -> Result<Value, Error>

List documents matching current filters/sorts.

pub async fn get_first(&self) -> Result<Value, Error>

Get the first record matching the current query conditions. Returns Ok(Value::Null) if no records match.

pub async fn sql( &self, query: &str, params: &[Value], ) -> Result<Vec<Value>, Error>

Execute admin SQL scoped to this table’s database namespace.

pub async fn get_one(&self, id: &str) -> Result<Value, Error>

Fetch a single document by ID.

pub async fn insert(&self, record: &Value) -> Result<Value, Error>

Create a new document.

pub async fn update(&self, id: &str, data: &Value) -> Result<Value, Error>

Update a document by ID.

pub async fn delete(&self, id: &str) -> Result<Value, Error>

Delete a document by ID.

pub async fn upsert( &self, record: &Value, conflict_target: Option<&str>, ) -> Result<Value, Error>

Create or update a document.

pub async fn count(&self) -> Result<u64, Error>

Count documents matching current filters.

pub async fn insert_many(&self, records: Vec<Value>) -> Result<Value, Error>

Create multiple documents in server-side batches.

pub async fn upsert_many( &self, records: Vec<Value>, conflict_target: Option<&str>, ) -> Result<Value, Error>

Upsert multiple documents in server-side batches.

pub async fn update_many(&self, update: &Value) -> Result<Value, Error>

Update all documents matching current filters.

pub async fn delete_many(&self) -> Result<Value, Error>

Delete all documents matching current filters.

pub fn doc(&self, id: &str) -> DocRef

Returns a document-scoped helper for record operations by id.

Trait Implementations

impl Clone for TableRef

fn clone(&self) -> TableRef

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.