You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by Apache Wiki <wi...@apache.org> on 2010/10/05 17:36:37 UTC
[Cassandra Wiki] Update of "API07" by zznate
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Cassandra Wiki" for change notification.
The "API07" page has been changed by zznate.
http://wiki.apache.org/cassandra/API07?action=diff&rev1=6&rev2=7
--------------------------------------------------
=== IndexOperator ===
- An enum that details the type of operator to use in an `IndexExpression`. Currently, on `EQ` is supported.
+ An enum that details the type of operator to use in an `IndexExpression`. Currently, on `EQ` is supported for configuring a `ColumnFamily`, but the other operators may be used in conjunction with and `EQ` operator on other non-indexed columns.
||'''Operator'''||'''Description'''||
||`EQ`|| Equality ||
||`GTE`||Greater than or equal to||
@@ -159, +159 @@
A struct that defines the `IndexOperator` to use against a column for a lookup value. Used only by the `IndexClause` in the `get_indexed_slices` method.
||'''Attribute''' ||'''Type''' ||'''Default''' ||'''Required''' ||'''Description''' ||
||`column_name` ||`binary` ||n/a ||Y ||The column name to against which the operator and value will be applied ||
- ||`op` ||`IndexOperator` ||n/a ||Y || The `IndexOperator` to use (currently only `EQ` is supported) ||
+ ||`op` ||`IndexOperator` ||n/a ||Y || The `IndexOperator` to use. Currently only `EQ` is supported for direct queries, but other `IndexExpression` structs may be created and passed to `IndexClause` ||
||`value` ||`binary` ||n/a ||Y ||The value for which to the column ||
=== IndexClause ===
- Defines one or more `IndexExpression`s for `get_indexed_slices`
+ Defines one or more `IndexExpression`s for `get_indexed_slices`. An `IndexExpression` containing an `EQ` `IndexOperator` must be present.
||'''Attribute''' ||'''Type''' ||'''Default''' ||'''Required''' ||'''Description''' ||
- ||`expressions` ||`list<IndexExpression>` ||n/a ||Y ||The column name to against which the operator and value will be applied ||
+ ||`expressions` ||`list<IndexExpression>` ||n/a ||Y ||The list of `IndexExpression` objects which must contain one `EQ` `IndexOperator` among the expressions ||
||`start_key` ||`binary` ||n/a ||Y || Start the index query at the specified key - can be set to `''`, i.e., an empty byte array, to start with the first key ||
||`count` ||`integer` ||100 ||Y ||The number of results to which the index query will be constrained ||
@@ -249, +249 @@
=== get_indexed_slices ===
. `list<KeySlice> get_indexed_slices(column_parent, index_clause, predicate, consistency_level)`
- Like `get_range_slices`, returns a list of slices, but uses `IndexClause` instead of `KeyRange`. To use this method, the underlying `ColumnFamily` of the `ColumnParent` must have been configured with a column_metadata attribute, specifying at least the name and index_type attributes. See `CfDef` and `ColumnDef` above for the list of attributes.
+ Like `get_range_slices`, returns a list of slices, but uses `IndexClause` instead of `KeyRange`. To use this method, the underlying `ColumnFamily` of the `ColumnParent` must have been configured with a column_metadata attribute, specifying at least the name and index_type attributes. See `CfDef` and `ColumnDef` above for the list of attributes. Note: the `IndexClause` must contain one `IndexExpression` with an `EQ` operator on a configured index column. Other `IndexExpression` structs may be added to the `IndexClause` for non-indexed columns to further refine the results of the `EQ` expression.
=== insert ===
. `insert(key, column_path, value, timestamp, consistency_level)`