You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@geode.apache.org by db...@apache.org on 2021/08/25 21:29:21 UTC
[geode-native] branch develop updated: GEODE-9550: Native Client
user guide: warn against floating point values in keys (#857) (#859)
This is an automated email from the ASF dual-hosted git repository.
dbarnes pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/geode-native.git
The following commit(s) were added to refs/heads/develop by this push:
new 8386624 GEODE-9550: Native Client user guide: warn against floating point values in keys (#857) (#859)
8386624 is described below
commit 8386624c9acdcece729c370f007496262fc65d65
Author: Dave Barnes <db...@apache.org>
AuthorDate: Wed Aug 25 14:28:39 2021 -0700
GEODE-9550: Native Client user guide: warn against floating point values in keys (#857) (#859)
---
docs/geode-native-docs-cpp/continuous-queries.html.md.erb | 3 +++
docs/geode-native-docs-cpp/remote-queries.html.md.erb | 3 +++
docs/geode-native-docs-dotnet/continuous-queries.html.md.erb | 3 +++
docs/geode-native-docs-dotnet/remote-queries.html.md.erb | 3 +++
4 files changed, 12 insertions(+)
diff --git a/docs/geode-native-docs-cpp/continuous-queries.html.md.erb b/docs/geode-native-docs-cpp/continuous-queries.html.md.erb
index daf2d85..5e12670 100644
--- a/docs/geode-native-docs-cpp/continuous-queries.html.md.erb
+++ b/docs/geode-native-docs-cpp/continuous-queries.html.md.erb
@@ -45,6 +45,9 @@ Compare this to register interest by reviewing [Registering Interest for Entries
- **Active query execution**. Once initialized, the queries operate on new events. Events that change the query result are sent to the client immediately.
+**Note:** Because floating point numbers can not reliably be compared for equality, do not use
+floating point values as keys or key components when constructing a query.
+
## <a id="cq_api"></a>Typical Continuous Query Lifecycle
1. The client creates the CQ. This sets up everything for running the query and provides the client with a `CqQuery` object, but does not execute the CQ. At this point, the query is in a `STOPPED `state, ready to be closed or run.
diff --git a/docs/geode-native-docs-cpp/remote-queries.html.md.erb b/docs/geode-native-docs-cpp/remote-queries.html.md.erb
index b46f9fd..4bb9947 100644
--- a/docs/geode-native-docs-cpp/remote-queries.html.md.erb
+++ b/docs/geode-native-docs-cpp/remote-queries.html.md.erb
@@ -28,6 +28,9 @@ You can optimize your queries by defining indexes on the cache server.
Querying and indexing operate only on remote cache server contents.
+**Note:** Because floating point numbers can not reliably be compared for equality, do not use
+floating point values as keys or key components when constructing a query.
+
### <a id="QueryLanguage"></a>Query language: OQL
<%=vars.product_name%> provides a SQL-like querying language called OQL that allows you to access data stored in <%=vars.product_name%> regions.
OQL is very similar to SQL, but OQL allows you to query complex objects, object attributes, and methods.
diff --git a/docs/geode-native-docs-dotnet/continuous-queries.html.md.erb b/docs/geode-native-docs-dotnet/continuous-queries.html.md.erb
index 7904c26..665bbef 100644
--- a/docs/geode-native-docs-dotnet/continuous-queries.html.md.erb
+++ b/docs/geode-native-docs-dotnet/continuous-queries.html.md.erb
@@ -45,6 +45,9 @@ Compare this to register interest by reviewing [Registering Interest for Entries
- **Active query execution**. Once initialized, the queries operate on new events. Events that change the query result are sent to the client immediately.
+**Note:** Because floating point numbers can not reliably be compared for equality, do not use
+floating point values as keys or key components when constructing a query.
+
## <a id="cq_api"></a>Typical Continuous Query Lifecycle
1. The client creates the CQ. This sets up everything for running the query and provides the client with a `CqQuery` object, but does not execute the CQ. At this point, the query is in a `STOPPED `state, ready to be closed or run.
diff --git a/docs/geode-native-docs-dotnet/remote-queries.html.md.erb b/docs/geode-native-docs-dotnet/remote-queries.html.md.erb
index 1851482..a93901f 100644
--- a/docs/geode-native-docs-dotnet/remote-queries.html.md.erb
+++ b/docs/geode-native-docs-dotnet/remote-queries.html.md.erb
@@ -28,6 +28,9 @@ You can optimize your queries by defining indexes on the cache server.
Querying and indexing operate only on remote cache server contents.
+**Note:** Because floating point numbers can not reliably be compared for equality, do not use
+floating point values as keys or key components when constructing a query.
+
### <a id="QueryLanguage"></a>Query language: OQL
<%=vars.product_name%> provides a SQL-like querying language called OQL that allows you to access data stored in <%=vars.product_name%> regions.
OQL is very similar to SQL, but OQL allows you to query complex objects, object attributes, and methods.