Struct PySessionContext

pub struct PySessionContext {
    pub ctx: SessionContext,
}

PySessionContext is able to plan and execute DataFusion plans. It has a powerful optimizer, a physical planner for local execution, and a multi-threaded execution engine to perform the execution.

Fields

ctx: SessionContext

Implementations

impl PySessionContext

pub fn new( config: Option<PySessionConfig>, runtime: Option<PyRuntimeEnvBuilder>, ) -> PyDataFusionResult<Self>

pub fn enable_url_table(&self) -> PyResult<Self>

pub fn register_object_store( &mut self, scheme: &str, store: StorageContexts, host: Option<&str>, ) -> PyResult<()>

Register an object store with the given name

pub fn register_listing_table( &mut self, name: &str, path: &str, table_partition_cols: Vec<(String, String)>, file_extension: &str, schema: Option<PyArrowType<Schema>>, file_sort_order: Option<Vec<Vec<PySortExpr>>>, py: Python<'_>, ) -> PyDataFusionResult<()>

pub fn sql( &mut self, query: &str, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

Returns a PyDataFrame whose plan corresponds to the SQL statement.

pub fn sql_with_options( &mut self, query: &str, options: Option<PySQLOptions>, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

pub fn create_dataframe( &mut self, partitions: PyArrowType<Vec<Vec<RecordBatch>>>, name: Option<&str>, schema: Option<PyArrowType<Schema>>, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

pub fn create_dataframe_from_logical_plan( &mut self, plan: PyLogicalPlan, ) -> PyDataFrame

Create a DataFrame from an existing logical plan

pub fn from_pylist( &mut self, data: Bound<'_, PyList>, name: Option<&str>, ) -> PyResult<PyDataFrame>

Construct datafusion dataframe from Python list

pub fn from_pydict( &mut self, data: Bound<'_, PyDict>, name: Option<&str>, ) -> PyResult<PyDataFrame>

Construct datafusion dataframe from Python dictionary

pub fn from_arrow( &mut self, data: Bound<'_, PyAny>, name: Option<&str>, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

Construct datafusion dataframe from Arrow Table

pub fn from_pandas( &mut self, data: Bound<'_, PyAny>, name: Option<&str>, ) -> PyResult<PyDataFrame>

Construct datafusion dataframe from pandas

pub fn from_polars( &mut self, data: Bound<'_, PyAny>, name: Option<&str>, ) -> PyResult<PyDataFrame>

Construct datafusion dataframe from polars

pub fn register_table( &mut self, name: &str, table: &PyTable, ) -> PyDataFusionResult<()>

pub fn deregister_table(&mut self, name: &str) -> PyDataFusionResult<()>

pub fn register_table_provider( &mut self, name: &str, provider: Bound<'_, PyAny>, ) -> PyDataFusionResult<()>

Construct datafusion dataframe from Arrow Table

pub fn register_record_batches( &mut self, name: &str, partitions: PyArrowType<Vec<Vec<RecordBatch>>>, ) -> PyDataFusionResult<()>

pub fn register_parquet( &mut self, name: &str, path: &str, table_partition_cols: Vec<(String, String)>, parquet_pruning: bool, file_extension: &str, skip_metadata: bool, schema: Option<PyArrowType<Schema>>, file_sort_order: Option<Vec<Vec<PySortExpr>>>, py: Python<'_>, ) -> PyDataFusionResult<()>

pub fn register_csv( &mut self, name: &str, path: &Bound<'_, PyAny>, schema: Option<PyArrowType<Schema>>, has_header: bool, delimiter: &str, schema_infer_max_records: usize, file_extension: &str, file_compression_type: Option<String>, py: Python<'_>, ) -> PyDataFusionResult<()>

pub fn register_json( &mut self, name: &str, path: PathBuf, schema: Option<PyArrowType<Schema>>, schema_infer_max_records: usize, file_extension: &str, table_partition_cols: Vec<(String, String)>, file_compression_type: Option<String>, py: Python<'_>, ) -> PyDataFusionResult<()>

pub fn register_avro( &mut self, name: &str, path: PathBuf, schema: Option<PyArrowType<Schema>>, file_extension: &str, table_partition_cols: Vec<(String, String)>, py: Python<'_>, ) -> PyDataFusionResult<()>

pub fn register_dataset( &self, name: &str, dataset: &Bound<'_, PyAny>, py: Python<'_>, ) -> PyDataFusionResult<()>

pub fn register_udf(&mut self, udf: PyScalarUDF) -> PyResult<()>

pub fn register_udaf(&mut self, udaf: PyAggregateUDF) -> PyResult<()>

pub fn register_udwf(&mut self, udwf: PyWindowUDF) -> PyResult<()>

pub fn catalog(&self, name: &str) -> PyResult<PyCatalog>

pub fn tables(&self) -> HashSet<String>

pub fn table(&self, name: &str, py: Python<'_>) -> PyResult<PyDataFrame>

pub fn table_exist(&self, name: &str) -> PyDataFusionResult<bool>

pub fn empty_table(&self) -> PyDataFusionResult<PyDataFrame>

pub fn session_id(&self) -> String

pub fn read_json( &mut self, path: PathBuf, schema: Option<PyArrowType<Schema>>, schema_infer_max_records: usize, file_extension: &str, table_partition_cols: Vec<(String, String)>, file_compression_type: Option<String>, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

pub fn read_csv( &self, path: &Bound<'_, PyAny>, schema: Option<PyArrowType<Schema>>, has_header: bool, delimiter: &str, schema_infer_max_records: usize, file_extension: &str, table_partition_cols: Vec<(String, String)>, file_compression_type: Option<String>, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

pub fn read_parquet( &self, path: &str, table_partition_cols: Vec<(String, String)>, parquet_pruning: bool, file_extension: &str, skip_metadata: bool, schema: Option<PyArrowType<Schema>>, file_sort_order: Option<Vec<Vec<PySortExpr>>>, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

pub fn read_avro( &self, path: &str, schema: Option<PyArrowType<Schema>>, table_partition_cols: Vec<(String, String)>, file_extension: &str, py: Python<'_>, ) -> PyDataFusionResult<PyDataFrame>

pub fn read_table(&self, table: &PyTable) -> PyDataFusionResult<PyDataFrame>

pub fn execute( &self, plan: PyExecutionPlan, part: usize, py: Python<'_>, ) -> PyDataFusionResult<PyRecordBatchStream>

Execute a partition of an execution plan and return a stream of record batches

Trait Implementations

impl Clone for PySessionContext

fn clone(&self) -> PySessionContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<PySessionContext> for SessionContext

fn from(ctx: PySessionContext) -> SessionContext

Converts to this type from the input type.

impl From<SessionContext> for PySessionContext

fn from(ctx: SessionContext) -> PySessionContext

Converts to this type from the input type.

impl IntoPy<Py<PyAny>> for PySessionContext

fn into_py(self, py: Python<'_>) -> PyObject

👎Deprecated since 0.23.0: IntoPy is going to be replaced by IntoPyObject. See the migration guide (https://pyo3.rs/v0.23.0/migration) for more information.

Performs the conversion.

impl<'py> IntoPyObject<'py> for PySessionContext

type Target = PySessionContext

The Python output type

type Output = Bound<'py, <PySessionContext as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl PyClass for PySessionContext

type Frozen = False

Whether the pyclass is frozen.

impl PyClassBaseType for PySessionContext

type LayoutAsBase = PyClassObject<PySessionContext>

type BaseNativeType = <PySessionContext as PyClassImpl>::BaseNativeType

type Initializer = PyClassInitializer<PySessionContext>

type PyClassMutability = <PySessionContext as PyClassImpl>::PyClassMutability

impl PyClassImpl for PySessionContext

const IS_BASETYPE: bool = true

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<PySessionContext>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn doc(py: Python<'_>) -> PyResult<&'static CStr>

Rendered class doc

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyClassNewTextSignature<PySessionContext> for PyClassImplCollector<PySessionContext>

fn new_text_signature(self) -> Option<&'static str>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a PySessionContext

type Holder = Option<PyRef<'py, PySessionContext>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'a mut Self::Holder, ) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a mut PySessionContext

type Holder = Option<PyRefMut<'py, PySessionContext>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'a mut Self::Holder, ) -> PyResult<Self>

impl PyMethods<PySessionContext> for PyClassImplCollector<PySessionContext>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for PySessionContext

const NAME: &'static str = "SessionContext"

Class name.

const MODULE: Option<&'static str>

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn type_object_bound(py: Python<'_>) -> Bound<'_, PyType>

👎Deprecated since 0.23.0: renamed to PyTypeInfo::type_object

Deprecated name for PyTypeInfo::type_object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_type_of_bound(object: &Bound<'_, PyAny>) -> bool

👎Deprecated since 0.23.0: renamed to PyTypeInfo::is_type_of

Deprecated name for PyTypeInfo::is_type_of.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

fn is_exact_type_of_bound(object: &Bound<'_, PyAny>) -> bool

👎Deprecated since 0.23.0: renamed to PyTypeInfo::is_exact_type_of

Deprecated name for PyTypeInfo::is_exact_type_of.

impl DerefToPyAny for PySessionContext