Struct azure_functions::bindings::Table

pub struct Table(_);

Represents an Azure Storage table input or output binding.

Examples

Read a table storage row based on a key posted to the example queue:

use azure_functions::bindings::{QueueTrigger, Table};
use azure_functions::func;

#[func]
#[binding(name = "trigger", queue_name = "example")]
#[binding(name = "table", table_name = "MyTable", partition_key = "MyPartition", row_key = "{queueTrigger}")]
pub fn log_row(trigger: &QueueTrigger, table: &Table) {
    info!("Row: {:?}", table.rows().nth(0));
}

Run an Azure Storage table query based on a HTTP request:

use azure_functions::bindings::{HttpRequest, Table};
use azure_functions::func;

#[func]
#[binding(name = "table", table_name = "MyTable", filter = "{filter}")]
pub fn log_rows(req: &HttpRequest, table: &Table) {
    for row in table.rows() {
        info!("Row: {:?}", row);
    }
}

Methods

impl Table

pub fn new() -> Table

Creates a new table binding.

The new table binding can be used for output.

pub fn is_empty(&self) -> bool

Gets whether or not the table binding is empty (no rows).

pub fn len(&self) -> usize

Gets the current length of the rows stored in the table binding.

pub fn rows(
    &self
) -> impl Iterator<Item = &Row>

Gets the iterator over the rows stored in the table binding.

For input bindings, this will be the rows returned from either a single entity lookup or a filter query.

For output bindings, this will be the rows that have been added to the table binding.

pub fn add_row(&mut self, partition_key: &str, row_key: &str) -> &mut Row

Adds a new row to the table binding with the specified partition and row keys.

pub fn add_row_value(&mut self, value: Value)

Adds a row as a value to the table.

pub fn as_value(&self) -> &Value

Gets the table as a JSON value.

pub fn into_value(self) -> Value

Converts the table binding to a JSON value.

Trait Implementations

impl Default for Table

fn default() -> Table

Returns the "default value" for a type.

impl Clone for Table

fn clone(&self) -> Table

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<TypedData> for Table

fn from(data: TypedData) -> Self

Performs the conversion.

impl Into<TypedData> for Table

fn into(self) -> TypedData

Performs the conversion.

impl Display for Table

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Debug for Table

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.