Package org.apache.arrow.adbc.driver.flightsql

Class FlightSqlStatement

java.lang.Object

org.apache.arrow.adbc.driver.flightsql.FlightSqlStatement

All Implemented Interfaces:

AutoCloseable, AdbcOptions, AdbcStatement

public class FlightSqlStatement
extends Object
implements AdbcStatement

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.arrow.adbc.core.AdbcStatement

AdbcStatement.PartitionResult, AdbcStatement.QueryResult, AdbcStatement.UpdateResult

Method Summary

Modifier and Type	Method	Description
void	bind(VectorSchemaRoot root)	Bind this statement to a VectorSchemaRoot to provide parameter values/bulk data ingestion.
void	close()
AdbcStatement.PartitionResult	executePartitioned()	Execute a result set-generating query and get a list of partitions of the result set.
AdbcStatement.QueryResult	executeQuery()	Execute a result set-generating query and get the result.
Schema	executeSchema()	Get the schema of the result set without executing the query.
AdbcStatement.UpdateResult	executeUpdate()	Execute a query.
Schema	getParameterSchema()	Get the schema for bound parameters.
void	prepare()	Turn this statement into a prepared statement.
void	setSqlQuery(String query)	Set a SQL query to be executed on this statement.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.arrow.adbc.core.AdbcOptions

getOption, setOption

Methods inherited from interface org.apache.arrow.adbc.core.AdbcStatement

cancel, getMaxProgress, getProgress, pollPartitioned, setOption, setSubstraitPlan

Method Details

setSqlQuery

public void setSqlQuery(String query)
                 throws AdbcException

Description copied from interface: AdbcStatement

Set a SQL query to be executed on this statement.

Specified by:

setSqlQuery in interface AdbcStatement

Parameters:

query - The SQL query.

Throws:

AdbcException

bind

public void bind(VectorSchemaRoot root)

Description copied from interface: AdbcStatement

Bind this statement to a VectorSchemaRoot to provide parameter values/bulk data ingestion.

Specified by:

bind in interface AdbcStatement

executePartitioned

public AdbcStatement.PartitionResult executePartitioned()
                                                 throws AdbcException

Description copied from interface: AdbcStatement

Execute a result set-generating query and get a list of partitions of the result set.

These can be serialized and deserialized for parallel and/or distributed fetching.

This may invalidate any prior result sets.

Specified by:

executePartitioned in interface AdbcStatement

Throws:

AdbcException

executeQuery

public AdbcStatement.QueryResult executeQuery()
                                       throws AdbcException

Description copied from interface: AdbcStatement

Execute a result set-generating query and get the result.

This may invalidate any prior result sets.

Specified by:

executeQuery in interface AdbcStatement

Throws:

AdbcException

executeSchema

public Schema executeSchema()
                     throws AdbcException

Description copied from interface: AdbcStatement

Get the schema of the result set without executing the query.

Specified by:

executeSchema in interface AdbcStatement

Throws:

AdbcException

executeUpdate

public AdbcStatement.UpdateResult executeUpdate()
                                         throws AdbcException

Description copied from interface: AdbcStatement

Execute a query.

This may invalidate any prior result sets.

Specified by:

executeUpdate in interface AdbcStatement

Throws:

AdbcException

getParameterSchema

public Schema getParameterSchema()
                          throws AdbcException

Description copied from interface: AdbcStatement

Get the schema for bound parameters.

This retrieves an Arrow schema describing the number, names, and types of the parameters in a parameterized statement. The fields of the schema should be in order of the ordinal position of the parameters; named parameters should appear only once.

If the parameter does not have a name, or the name cannot be determined, the name of the corresponding field in the schema will be an empty string. If the type cannot be determined, the type of the corresponding field will be NA (NullType).

This should be called after AdbcStatementPrepare.

Specified by:

getParameterSchema in interface AdbcStatement

Throws:

AdbcException - with AdbcStatusCode.NOT_IMPLEMENTED if the parameters cannot be determined at all.

prepare

public void prepare()
             throws AdbcException

Description copied from interface: AdbcStatement

Turn this statement into a prepared statement.

Call AdbcStatement.executeQuery(), AdbcStatement.executeUpdate(), or AdbcStatement.executePartitioned() to execute the query.

Specified by:

prepare in interface AdbcStatement

Throws:

AdbcException

close

public void close()
           throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception