public class FilterByAreaRequest extends Object implements org.apache.avro.generic.IndexedRecord
GPUdb.filterByArea
.
Calculates which objects from a table are within a named area of interest
(NAI/polygon). The operation is synchronous, meaning that a response will
not be returned until all the matching objects are fully available. The
response payload provides the count of the resulting set. A new resultant
set (view) which satisfies the input NAI restriction specification is
created with the name viewName
passed in as part of
the input.
Modifier and Type | Class and Description |
---|---|
static class |
FilterByAreaRequest.Options
A set of string constants for the
FilterByAreaRequest parameter
options . |
Constructor and Description |
---|
FilterByAreaRequest()
Constructs a FilterByAreaRequest object with default parameters.
|
FilterByAreaRequest(String tableName,
String viewName,
String xColumnName,
List<Double> xVector,
String yColumnName,
List<Double> yVector,
Map<String,String> options)
Constructs a FilterByAreaRequest 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.
|
||||
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 to filter, 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
String getXColumnName()
Name of the column containing the x values to be filtered.
| ||||
List<Double> |
getXVector()
List of x coordinates of the vertices of the polygon representing the
area to be filtered.
|
||||
String |
getYColumnName()
Name of the column containing the y values to be filtered.
|
||||
List<Double> |
getYVector()
List of y coordinates of the vertices of the polygon representing the
area to be filtered.
|
||||
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.
|
||||
FilterByAreaRequest |
setOptions(Map<String,String> options)
Optional parameters.
|
||||
FilterByAreaRequest |
setTableName(String tableName)
Name of the table to filter, in [schema_name.]table_name format, using
standard
FilterByAreaRequest setViewName(String viewName)
If provided, then this will be the name of the view containing the
results, in [schema_name.]view_name format, using standard
FilterByAreaRequest setXColumnName(String xColumnName)
Name of the column containing the x values to be filtered.
| ||||
FilterByAreaRequest |
setXVector(List<Double> xVector)
List of x coordinates of the vertices of the polygon representing the
area to be filtered.
|
||||
FilterByAreaRequest |
setYColumnName(String yColumnName)
Name of the column containing the y values to be filtered.
|
||||
FilterByAreaRequest |
setYVector(List<Double> yVector)
List of y coordinates of the vertices of the polygon representing the
area to be filtered.
|
||||
String |
toString() |
public FilterByAreaRequest()
public FilterByAreaRequest(String tableName, String viewName, String xColumnName, List<Double> xVector, String yColumnName, List<Double> yVector, Map<String,String> options)
tableName
- Name of the table to filter, in
[schema_name.]table_name format, using standard name resolution rules. This may be
the name of a table or a view (when chaining queries).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
''.xColumnName
- Name of the column containing the x values to be
filtered.xVector
- List of x coordinates of the vertices of the polygon
representing the area to be filtered.yColumnName
- Name of the column containing the y values to be
filtered.yVector
- List of y coordinates of the vertices of the polygon
representing the area to be filtered.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 FilterByAreaRequest setTableName(String tableName)
tableName
- The new value for tableName
.this
to mimic the builder pattern.public String getViewName()
viewName
.public FilterByAreaRequest setViewName(String viewName)
viewName
- The new value for viewName
.this
to mimic the builder pattern.public String getXColumnName()
xColumnName
.public FilterByAreaRequest setXColumnName(String xColumnName)
xColumnName
- The new value for xColumnName
.this
to mimic the builder pattern.public List<Double> getXVector()
xVector
.public FilterByAreaRequest setXVector(List<Double> xVector)
xVector
- The new value for xVector
.this
to mimic the builder pattern.public String getYColumnName()
yColumnName
.public FilterByAreaRequest setYColumnName(String yColumnName)
yColumnName
- The new value for yColumnName
.this
to mimic the builder pattern.public List<Double> getYVector()
yVector
.public FilterByAreaRequest setYVector(List<Double> yVector)
yVector
- The new value for yVector
.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 FilterByAreaRequest 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.