Struct worker::d1::D1Database

pub struct D1Database(/* private fields */);

Implementations

impl D1Database

pub fn prepare<T: Into<String>>(&self, query: T) -> D1PreparedStatement

Prepare a query statement from a query string.

pub async fn dump(&self) -> Result<Vec<u8>>

Dump the data in the database to a Vec.

pub async fn batch( &self, statements: Vec<D1PreparedStatement> ) -> Result<Vec<D1Result>>

Batch execute one or more statements against the database.

Returns the results in the same order as the provided statements.

pub async fn exec(&self, query: &str) -> Result<D1ExecResult>

Execute one or more queries directly against the database.

The input can be one or multiple queries separated by \n.

Considerations

This method can have poorer performance (prepared statements can be reused in some cases) and, more importantly, is less safe. Only use this method for maintenance and one-shot tasks (example: migration jobs).

If an error occurs, an exception is thrown with the query and error messages, execution stops and further statements are not executed.

Trait Implementations

impl AsRef<JsValue> for D1Database

fn as_ref(&self) -> &JsValue

Converts this type into a shared reference of the (usually inferred) input type.

impl EnvBinding for D1Database

const TYPE_NAME: &'static str = "D1Database"

fn get(val: JsValue) -> Result<Self>

impl From<D1Database> for D1Database

fn from(inner: D1DatabaseSys) -> Self

Converts to this type from the input type.

impl From<D1Database> for JsValue

fn from(database: D1Database) -> Self

Converts to this type from the input type.

impl JsCast for D1Database

fn instanceof(val: &JsValue) -> bool

Performs a dynamic instanceof check to see whether the JsValue provided is an instance of this type.

fn unchecked_from_js(val: JsValue) -> Self

Performs a zero-cost unchecked conversion from a JsValue into an instance of Self

fn unchecked_from_js_ref(val: &JsValue) -> &Self

Performs a zero-cost unchecked conversion from a &JsValue into an instance of &Self.

fn has_type<T>(&self) -> bool

where T: JsCast,

Test whether this JS value has a type T.

fn dyn_into<T>(self) -> Result<T, Self>

where T: JsCast,

Performs a dynamic cast (checked at runtime) of this value into the target type T.

fn dyn_ref<T>(&self) -> Option<&T>

where T: JsCast,

Performs a dynamic cast (checked at runtime) of this value into the target type T.

fn unchecked_into<T>(self) -> T

where T: JsCast,

Performs a zero-cost unchecked cast into the specified type.

fn unchecked_ref<T>(&self) -> &T

where T: JsCast,

Performs a zero-cost unchecked cast into a reference to the specified type.

fn is_instance_of<T>(&self) -> bool

where T: JsCast,

Test whether this JS value is an instance of the type T.

fn is_type_of(val: &JsValue) -> bool

Performs a dynamic check to see whether the JsValue provided is a value of this type.

impl Send for D1Database

impl Sync for D1Database