public class FilterByGeometryRequest extends Object implements org.apache.avro.generic.IndexedRecord
GPUdb.filterByGeometry
.
Applies a geometry filter against a geospatial geometry column in a given
table or view. The filtering geometry is provided by inputWkt
.
Modifier and Type | Class and Description |
---|---|
static class |
FilterByGeometryRequest.Operation
A set of string constants for the
FilterByGeometryRequest
parameter operation . |
static class |
FilterByGeometryRequest.Options
A set of string constants for the
FilterByGeometryRequest
parameter options . |
Constructor and Description |
---|
FilterByGeometryRequest()
Constructs a FilterByGeometryRequest object with default parameters.
|
FilterByGeometryRequest(String tableName,
String viewName,
String columnName,
String inputWkt,
String operation,
Map<String,String> options)
Constructs a FilterByGeometryRequest object with the specified
parameters.
|
Modifier and Type | Method and Description | ||||
---|---|---|---|---|---|
boolean |
equals(Object obj) |
||||
Object |
get(int index)
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
static org.apache.avro.Schema |
getClassSchema()
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
String |
getColumnName()
Name of the column to be used in the filter.
|
||||
String |
getInputWkt()
A geometry in WKT format that will be used to filter the objects in
tableName . |
||||
String |
getOperation()
The geometric filtering operation to perform.
|
||||
Map<String,String> |
getOptions()
Optional parameters.
|
||||
org.apache.avro.Schema |
getSchema()
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
String |
getTableName()
Name of the table on which the filter by geometry will be performed, in
[schema_name.]table_name format, using standard
String getViewName()
If provided, then this will be the name of the view containing the
results, in [schema_name.]view_name format, using standard
int hashCode() | ||||
void |
put(int index,
Object value)
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
FilterByGeometryRequest |
setColumnName(String columnName)
Name of the column to be used in the filter.
|
||||
FilterByGeometryRequest |
setInputWkt(String inputWkt)
A geometry in WKT format that will be used to filter the objects in
tableName . |
||||
FilterByGeometryRequest |
setOperation(String operation)
The geometric filtering operation to perform.
|
||||
FilterByGeometryRequest |
setOptions(Map<String,String> options)
Optional parameters.
|
||||
FilterByGeometryRequest |
setTableName(String tableName)
Name of the table on which the filter by geometry will be performed, in
[schema_name.]table_name format, using standard
FilterByGeometryRequest setViewName(String viewName)
|
public FilterByGeometryRequest()
public FilterByGeometryRequest(String tableName, String viewName, String columnName, String inputWkt, String operation, Map<String,String> options)
tableName
- Name of the table on which the filter by geometry will
be performed, in [schema_name.]table_name format,
using standard name resolution rules. Must be an
existing table or view containing a geospatial
geometry column.viewName
- If provided, then this will be the name of the view
containing the results, in [schema_name.]view_name
format, using standard name resolution rules and meeting table naming criteria. Must not be
an already existing table or view. The default value is
''.columnName
- Name of the column to be used in the filter. Must be
a geospatial geometry column.inputWkt
- A geometry in WKT format that will be used to filter
the objects in tableName
. The default value is
''.operation
- The geometric filtering operation to perform.
Supported values:
CONTAINS
: Matches
records that contain the given WKT in inputWkt
, i.e. the given WKT is within the
bounds of a record's geometry.
CROSSES
: Matches
records that cross the given WKT.
DISJOINT
: Matches
records that are disjoint from the given WKT.
EQUALS
: Matches
records that are the same as the given WKT.
INTERSECTS
:
Matches records that intersect the given WKT.
OVERLAPS
: Matches
records that overlap the given WKT.
TOUCHES
: Matches
records that touch the given WKT.
WITHIN
: Matches
records that are within the given WKT.
options
- Optional parameters.
CREATE_TEMP_TABLE
: If TRUE
, a unique temporary table name will be
generated in the sys_temp schema and used in
place of viewName
. This is always
allowed even if the caller does not have
permission to create tables. The generated name
is returned in QUALIFIED_VIEW_NAME
.
Supported values:
The default value is FALSE
.
COLLECTION_NAME
:
[DEPRECATED--please specify the containing
schema for the view as part of viewName
and use GPUdb.createSchema
to create the schema if
non-existent] Name of a schema for the newly
created view. If the schema provided is
non-existent, it will be automatically created.
Map
.public static org.apache.avro.Schema getClassSchema()
public String getTableName()
tableName
.public FilterByGeometryRequest setTableName(String tableName)
tableName
- The new value for tableName
.this
to mimic the builder pattern.public String getViewName()
viewName
.public FilterByGeometryRequest setViewName(String viewName)
viewName
- The new value for viewName
.this
to mimic the builder pattern.public String getColumnName()
columnName
.public FilterByGeometryRequest setColumnName(String columnName)
columnName
- The new value for columnName
.this
to mimic the builder pattern.public String getInputWkt()
tableName
. The default value is ''.inputWkt
.public FilterByGeometryRequest setInputWkt(String inputWkt)
tableName
. The default value is ''.inputWkt
- The new value for inputWkt
.this
to mimic the builder pattern.public String getOperation()
CONTAINS
: Matches records that
contain the given WKT in inputWkt
, i.e.
the given WKT is within the bounds of a record's geometry.
CROSSES
: Matches records that cross
the given WKT.
DISJOINT
: Matches records that are
disjoint from the given WKT.
EQUALS
: Matches records that are the
same as the given WKT.
INTERSECTS
: Matches records that
intersect the given WKT.
OVERLAPS
: Matches records that
overlap the given WKT.
TOUCHES
: Matches records that touch
the given WKT.
WITHIN
: Matches records that are within
the given WKT.
operation
.public FilterByGeometryRequest setOperation(String operation)
CONTAINS
: Matches records that
contain the given WKT in inputWkt
, i.e.
the given WKT is within the bounds of a record's geometry.
CROSSES
: Matches records that cross
the given WKT.
DISJOINT
: Matches records that are
disjoint from the given WKT.
EQUALS
: Matches records that are the
same as the given WKT.
INTERSECTS
: Matches records that
intersect the given WKT.
OVERLAPS
: Matches records that
overlap the given WKT.
TOUCHES
: Matches records that touch
the given WKT.
WITHIN
: Matches records that are within
the given WKT.
operation
- The new value for operation
.this
to mimic the builder pattern.public Map<String,String> getOptions()
CREATE_TEMP_TABLE
: If TRUE
, a unique temporary table name will be
generated in the sys_temp schema and used in place of viewName
. This is always allowed even if the
caller does not have permission to create tables. The generated
name is returned in QUALIFIED_VIEW_NAME
.
Supported values:
The default value is FALSE
.
COLLECTION_NAME
:
[DEPRECATED--please specify the containing schema for the view
as part of viewName
and use GPUdb.createSchema
to create the schema if non-existent] Name
of a schema for the newly created view. If the schema provided
is non-existent, it will be automatically created.
Map
.options
.public FilterByGeometryRequest setOptions(Map<String,String> options)
CREATE_TEMP_TABLE
: If TRUE
, a unique temporary table name will be
generated in the sys_temp schema and used in place of viewName
. This is always allowed even if the
caller does not have permission to create tables. The generated
name is returned in QUALIFIED_VIEW_NAME
.
Supported values:
The default value is FALSE
.
COLLECTION_NAME
:
[DEPRECATED--please specify the containing schema for the view
as part of viewName
and use GPUdb.createSchema
to create the schema if non-existent] Name
of a schema for the newly created view. If the schema provided
is non-existent, it will be automatically created.
Map
.options
- The new value for options
.this
to mimic the builder pattern.public org.apache.avro.Schema getSchema()
getSchema
in interface org.apache.avro.generic.GenericContainer
public Object get(int index)
get
in interface org.apache.avro.generic.IndexedRecord
index
- the position of the field to getIndexOutOfBoundsException
public void put(int index, Object value)
put
in interface org.apache.avro.generic.IndexedRecord
index
- the position of the field to setvalue
- the value to setIndexOutOfBoundsException
Copyright © 2025. All rights reserved.