http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/configure_pr_single_hop.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/configure_pr_single_hop.html.md.erb b/geode-docs/developing/partitioned_regions/configure_pr_single_hop.html.md.erb index 5518905..a7eeeb2 100644 --- a/geode-docs/developing/partitioned_regions/configure_pr_single_hop.html.md.erb +++ b/geode-docs/developing/partitioned_regions/configure_pr_single_hop.html.md.erb @@ -2,6 +2,23 @@ title: Configure Client Single-Hop Access to Server-Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Configure your client/server system for direct, single-hop access to partitioned region data in the servers. This requires a client/server installation that uses one or more partitioned regions on the server.
http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/configuring_bucket_for_pr.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/configuring_bucket_for_pr.html.md.erb b/geode-docs/developing/partitioned_regions/configuring_bucket_for_pr.html.md.erb index 7ee7133..ccb7e71 100644 --- a/geode-docs/developing/partitioned_regions/configuring_bucket_for_pr.html.md.erb +++ b/geode-docs/developing/partitioned_regions/configuring_bucket_for_pr.html.md.erb @@ -2,6 +2,23 @@ title: Configuring the Number of Buckets for a Partitioned Region --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Decide how many buckets to assign to your partitioned region and set the configuration accordingly. <a id="configuring_total_buckets__section_DF52B2BF467F4DB4B8B3D16A79EFCA39"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/configuring_ha_for_pr.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/configuring_ha_for_pr.html.md.erb b/geode-docs/developing/partitioned_regions/configuring_ha_for_pr.html.md.erb index a9a98fb..c084f4a 100644 --- a/geode-docs/developing/partitioned_regions/configuring_ha_for_pr.html.md.erb +++ b/geode-docs/developing/partitioned_regions/configuring_ha_for_pr.html.md.erb @@ -2,6 +2,23 @@ title: Configure High Availability for a Partitioned Region --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Configure in-memory high availability for your partitioned region. Set other high-availability options, like redundancy zones and redundancy recovery strategies. Here are the main steps for configuring high availability for a partitioned region. See later sections for details. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/custom_partitioning_and_data_colocation.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/custom_partitioning_and_data_colocation.html.md.erb b/geode-docs/developing/partitioned_regions/custom_partitioning_and_data_colocation.html.md.erb index 0cd5f63..3e4f185 100644 --- a/geode-docs/developing/partitioned_regions/custom_partitioning_and_data_colocation.html.md.erb +++ b/geode-docs/developing/partitioned_regions/custom_partitioning_and_data_colocation.html.md.erb @@ -2,6 +2,23 @@ title: Understanding Custom Partitioning and Data Colocation --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Custom partitioning and data colocation can be used separately or in conjunction with one another. ## <a id="custom_partitioning_and_data_colocation__section_ABFEE9CB17AF44F1AE252AC10FB5E999" class="no-quick-link"></a>Custom Partitioning http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/how_partitioning_works.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/how_partitioning_works.html.md.erb b/geode-docs/developing/partitioned_regions/how_partitioning_works.html.md.erb index 68e8dd2..c846995 100644 --- a/geode-docs/developing/partitioned_regions/how_partitioning_works.html.md.erb +++ b/geode-docs/developing/partitioned_regions/how_partitioning_works.html.md.erb @@ -2,6 +2,23 @@ title: Understanding Partitioning --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + To use partitioned regions, you should understand how they work and your options for managing them. <a id="how_partitioning_works__section_B540C49A80124551853AFCE2DE6BCFE8"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/how_pr_ha_works.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/how_pr_ha_works.html.md.erb b/geode-docs/developing/partitioned_regions/how_pr_ha_works.html.md.erb index 5082cc4..ba83732 100644 --- a/geode-docs/developing/partitioned_regions/how_pr_ha_works.html.md.erb +++ b/geode-docs/developing/partitioned_regions/how_pr_ha_works.html.md.erb @@ -2,6 +2,23 @@ title: Understanding High Availability for Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + With high availability, each member that hosts data for the partitioned region gets some primary copies and some redundant (secondary) copies. <a id="how_pr_ha_works__section_04FDCC6C2130496F8B33B9DF5CDED362"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/how_pr_single_hop_works.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/how_pr_single_hop_works.html.md.erb b/geode-docs/developing/partitioned_regions/how_pr_single_hop_works.html.md.erb index 9002719..c4592b9 100644 --- a/geode-docs/developing/partitioned_regions/how_pr_single_hop_works.html.md.erb +++ b/geode-docs/developing/partitioned_regions/how_pr_single_hop_works.html.md.erb @@ -2,6 +2,23 @@ title: Understanding Client Single-Hop Access to Server-Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + With single-hop access the client connects to every server, so more connections are generally used. This works fine for smaller installations, but is a barrier to scaling. If you have a large installation with many clients, you may want to disable single hop by setting the pool attribute, `pr-single-hop-enabled` to false in your pool declarations. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/join_query_partitioned_regions.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/join_query_partitioned_regions.html.md.erb b/geode-docs/developing/partitioned_regions/join_query_partitioned_regions.html.md.erb index b8399e2..e6beab2 100644 --- a/geode-docs/developing/partitioned_regions/join_query_partitioned_regions.html.md.erb +++ b/geode-docs/developing/partitioned_regions/join_query_partitioned_regions.html.md.erb @@ -2,6 +2,23 @@ title: Performing an Equi-Join Query on Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + In order to perform equi-join operations on partitioned regions or partitioned regions and replicated regions, you need to use the `query.execute` method and supply it with a function execution context. You need to use Geode's FunctionService executor because join operations are not yet directly supported for partitioned regions without providing a function execution context. See [Partitioned Region Query Restrictions](../query_additional/partitioned_region_query_restrictions.html#concept_5353476380D44CC1A7F586E5AE1CE7E8) for more information on partitioned region query limitations. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/managing_partitioned_regions.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/managing_partitioned_regions.html.md.erb b/geode-docs/developing/partitioned_regions/managing_partitioned_regions.html.md.erb index fd7494f..aedcba7 100644 --- a/geode-docs/developing/partitioned_regions/managing_partitioned_regions.html.md.erb +++ b/geode-docs/developing/partitioned_regions/managing_partitioned_regions.html.md.erb @@ -2,6 +2,23 @@ title: Configuring Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Plan the configuration and ongoing management of your partitioned region for host and accessor members and configure the regions for startup. <a id="configure_partitioned_regions__section_241583D88E244AB6AB5CD05BF55F6A0A"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/moving_partitioned_data.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/moving_partitioned_data.html.md.erb b/geode-docs/developing/partitioned_regions/moving_partitioned_data.html.md.erb index 054f7fe..b7e6e1b 100644 --- a/geode-docs/developing/partitioned_regions/moving_partitioned_data.html.md.erb +++ b/geode-docs/developing/partitioned_regions/moving_partitioned_data.html.md.erb @@ -2,6 +2,23 @@ title: Moving Partitioned Region Data to Another Member --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + You can use the `PartitionRegionHelper` `moveBucketByKey` and `moveData` methods to explicitly move partitioned region data from one member to another. The `moveBucketByKey` method moves the bucket that contains the specified key from a source member to a destination member. For example, you could use the method to move a popular product item to a new, empty member to reduce load on the source member. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/overview_custom_partitioning_and_data_colocation.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/overview_custom_partitioning_and_data_colocation.html.md.erb b/geode-docs/developing/partitioned_regions/overview_custom_partitioning_and_data_colocation.html.md.erb index 3cf5c10..1221873 100644 --- a/geode-docs/developing/partitioned_regions/overview_custom_partitioning_and_data_colocation.html.md.erb +++ b/geode-docs/developing/partitioned_regions/overview_custom_partitioning_and_data_colocation.html.md.erb @@ -2,6 +2,23 @@ title: Custom-Partitioning and Colocating Data --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + You can customize how Apache Geode groups your partitioned region data with custom partitioning and data colocation. - **[Understanding Custom Partitioning and Data Colocation](../../developing/partitioned_regions/custom_partitioning_and_data_colocation.html)** http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/overview_how_pr_ha_works.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/overview_how_pr_ha_works.html.md.erb b/geode-docs/developing/partitioned_regions/overview_how_pr_ha_works.html.md.erb index 7b182c5..889c56c 100644 --- a/geode-docs/developing/partitioned_regions/overview_how_pr_ha_works.html.md.erb +++ b/geode-docs/developing/partitioned_regions/overview_how_pr_ha_works.html.md.erb @@ -2,6 +2,23 @@ title: Configuring High Availability for Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + By default, Apache Geode stores only a single copy of your partitioned region data among the region's data stores. You can configure Geode to maintain redundant copies of your partitioned region data for high availability. - **[Understanding High Availability for Partitioned Regions](../../developing/partitioned_regions/how_pr_ha_works.html)** http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/overview_how_pr_single_hop_works.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/overview_how_pr_single_hop_works.html.md.erb b/geode-docs/developing/partitioned_regions/overview_how_pr_single_hop_works.html.md.erb index 651c851..8be43f6 100644 --- a/geode-docs/developing/partitioned_regions/overview_how_pr_single_hop_works.html.md.erb +++ b/geode-docs/developing/partitioned_regions/overview_how_pr_single_hop_works.html.md.erb @@ -2,6 +2,23 @@ title: Configuring Single-Hop Client Access to Server-Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Single-hop data access enables the client pool to track where a partitioned regionâs data is hosted in the servers. To access a single entry, the client directly contacts the server that hosts the key, in a single hop. - **[Understanding Client Single-Hop Access to Server-Partitioned Regions](../../developing/partitioned_regions/how_pr_single_hop_works.html)** http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/rebalancing_pr_data.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/rebalancing_pr_data.html.md.erb b/geode-docs/developing/partitioned_regions/rebalancing_pr_data.html.md.erb index 93c31e7..d40a4f2 100644 --- a/geode-docs/developing/partitioned_regions/rebalancing_pr_data.html.md.erb +++ b/geode-docs/developing/partitioned_regions/rebalancing_pr_data.html.md.erb @@ -2,6 +2,23 @@ title: Rebalancing Partitioned Region Data --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + In a distributed system with minimal contention to the concurrent threads reading or updating from the members, you can use rebalancing to dynamically increase or decrease your data and processing capacity. <a id="rebalancing_pr_data__section_D3649ADD28DB4FF78C47A3E428C80510"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/set_crash_redundancy_recovery.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/set_crash_redundancy_recovery.html.md.erb b/geode-docs/developing/partitioned_regions/set_crash_redundancy_recovery.html.md.erb index 4c7311e..a24b966 100644 --- a/geode-docs/developing/partitioned_regions/set_crash_redundancy_recovery.html.md.erb +++ b/geode-docs/developing/partitioned_regions/set_crash_redundancy_recovery.html.md.erb @@ -2,6 +2,23 @@ title: Configure Member Crash Redundancy Recovery for a Partitioned Region --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Configure whether and how redundancy is recovered in a partition region after a member crashes. <a id="set_crash_redundancy_recovery__section_86CF741758E54DA29519E9CDDF1BC393"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/set_enforce_unique_host.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/set_enforce_unique_host.html.md.erb b/geode-docs/developing/partitioned_regions/set_enforce_unique_host.html.md.erb index 19cc1ec..000216c 100644 --- a/geode-docs/developing/partitioned_regions/set_enforce_unique_host.html.md.erb +++ b/geode-docs/developing/partitioned_regions/set_enforce_unique_host.html.md.erb @@ -2,6 +2,23 @@ title: Set Enforce Unique Host --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Configure Geode to use only unique physical machines for redundant copies of partitioned region data. Understand how to set a member's `gemfire.properties` settings. See [Reference](../../reference/book_intro.html#reference). http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/set_join_redundancy_recovery.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/set_join_redundancy_recovery.html.md.erb b/geode-docs/developing/partitioned_regions/set_join_redundancy_recovery.html.md.erb index 4fe790e..6461f0e 100644 --- a/geode-docs/developing/partitioned_regions/set_join_redundancy_recovery.html.md.erb +++ b/geode-docs/developing/partitioned_regions/set_join_redundancy_recovery.html.md.erb @@ -2,6 +2,23 @@ title: Configure Member Join Redundancy Recovery for a Partitioned Region --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Configure whether and how redundancy is recovered in a partition region after a member joins. <a id="set_join_redundancy_recovery__section_D6FB0D69CC454B53B9CF1E656A44465C"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/set_pr_redundancy.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/set_pr_redundancy.html.md.erb b/geode-docs/developing/partitioned_regions/set_pr_redundancy.html.md.erb index ae12721..7ecbd71 100644 --- a/geode-docs/developing/partitioned_regions/set_pr_redundancy.html.md.erb +++ b/geode-docs/developing/partitioned_regions/set_pr_redundancy.html.md.erb @@ -2,6 +2,23 @@ title: Set the Number of Redundant Copies --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Configure in-memory high availability for your partitioned region by specifying the number of secondary copies you want to maintain in the region's data stores. Specify the number of redundant copies you want for your partitioned region data in the partition attribute `redundant-copies` setting. The default setting is 0. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/set_redundancy_zones.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/set_redundancy_zones.html.md.erb b/geode-docs/developing/partitioned_regions/set_redundancy_zones.html.md.erb index f5a0a10..e08be5d 100644 --- a/geode-docs/developing/partitioned_regions/set_redundancy_zones.html.md.erb +++ b/geode-docs/developing/partitioned_regions/set_redundancy_zones.html.md.erb @@ -2,6 +2,23 @@ title: Configure Redundancy Zones for Members --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Group members into redundancy zones so Geode will separate redundant data copies into different zones. Understand how to set a member's `gemfire.properties` settings. See [Reference](../../reference/book_intro.html#reference). http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/partitioned_regions/using_custom_partition_resolvers.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/partitioned_regions/using_custom_partition_resolvers.html.md.erb b/geode-docs/developing/partitioned_regions/using_custom_partition_resolvers.html.md.erb index df9e4b3..61a0e36 100644 --- a/geode-docs/developing/partitioned_regions/using_custom_partition_resolvers.html.md.erb +++ b/geode-docs/developing/partitioned_regions/using_custom_partition_resolvers.html.md.erb @@ -2,6 +2,23 @@ title: Custom-Partition Your Region Data --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + By default, Geode partitions each data entry into a bucket using a hashing policy on the key. Additionally, the physical location of the key-value pair is abstracted away from the application. You can change these policies for a partitioned region. You can provide your own data partitioning resolver and you can additionally specify which members host which data buckets. <a id="custom_partition_region_data__section_CF05CE974C9C4AF78430DA55601D2158"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/advanced_querying.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/advanced_querying.html.md.erb b/geode-docs/developing/query_additional/advanced_querying.html.md.erb index d94da69..7054868 100644 --- a/geode-docs/developing/query_additional/advanced_querying.html.md.erb +++ b/geode-docs/developing/query_additional/advanced_querying.html.md.erb @@ -2,6 +2,23 @@ title: Advanced Querying --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + This section includes advanced querying topics such as using query indexes, using query bind parameters, querying partitioned regions and query debugging. - **[Performance Considerations](../../developing/querying_basics/performance_considerations.html)** http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/case_sensitivity.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/case_sensitivity.html.md.erb b/geode-docs/developing/query_additional/case_sensitivity.html.md.erb index 2d49259..e67a22a 100644 --- a/geode-docs/developing/query_additional/case_sensitivity.html.md.erb +++ b/geode-docs/developing/query_additional/case_sensitivity.html.md.erb @@ -2,6 +2,23 @@ title: Case Sensitivity --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Query language keywords such as SELECT, NULL, DATE, and <TRACE> are case-insensitive. Identifiers such as attribute names, method names, and path expressions are case-sensitive. In terms of query string and region entry matching, if you want to perform a case-insensitive search on a particular field, you can use the Java String class `toUpperCase` and `toLowerCase` methods in your query. For example: http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/literals.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/literals.html.md.erb b/geode-docs/developing/query_additional/literals.html.md.erb index 37fcc0f..e86371c 100644 --- a/geode-docs/developing/query_additional/literals.html.md.erb +++ b/geode-docs/developing/query_additional/literals.html.md.erb @@ -2,6 +2,23 @@ title: Supported Literals --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + ## <a id="literals__section_BA2D0AC444EB45088F00D9E2C8A1DD06" class="no-quick-link"></a>Comparing Values With java.util.Date Geode supports the following literal types: http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/operators.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/operators.html.md.erb b/geode-docs/developing/query_additional/operators.html.md.erb index b05d5d3..e8cca37 100644 --- a/geode-docs/developing/query_additional/operators.html.md.erb +++ b/geode-docs/developing/query_additional/operators.html.md.erb @@ -2,6 +2,23 @@ title: Operators --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Geode supports comparison, logical, unary, map, index, dot, and right arrow operators. ## <a id="operators__section_A3FB372F85D840D7A49CB95BD7FCA7C6" class="no-quick-link"></a>Comparison Operators http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/order_by_on_partitioned_regions.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/order_by_on_partitioned_regions.html.md.erb b/geode-docs/developing/query_additional/order_by_on_partitioned_regions.html.md.erb index 4d52a88..8bcc41b 100644 --- a/geode-docs/developing/query_additional/order_by_on_partitioned_regions.html.md.erb +++ b/geode-docs/developing/query_additional/order_by_on_partitioned_regions.html.md.erb @@ -2,6 +2,23 @@ title: Using ORDER BY on Partitioned Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + To execute a query with an ORDER BY clause on a partitioned region, the fields specified in the ORDER BY clause must be part of the projection list. When an ORDER BY clause is used with a partition region query, the query is executed separately on each region host, the local query coordinator, and all remote members. The results are all gathered by the query coordinator. The cumulative result set is built by applying ORDER BY on the gathered results. If the LIMIT clause is also used in the query, ORDER BY and LIMIT are applied on each node before each nodeâs results are returned to the coordinator. Then the clauses are applied to the cumulative result set to get the final result set, which is returned to the calling application. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/partitioned_region_key_or_field_value.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/partitioned_region_key_or_field_value.html.md.erb b/geode-docs/developing/query_additional/partitioned_region_key_or_field_value.html.md.erb index f97c011..8ee443e 100644 --- a/geode-docs/developing/query_additional/partitioned_region_key_or_field_value.html.md.erb +++ b/geode-docs/developing/query_additional/partitioned_region_key_or_field_value.html.md.erb @@ -2,6 +2,23 @@ title: Optimizing Queries on Data Partitioned by a Key or Field Value --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + You can improve query performance on data that is partitioned by key or a field value by creating a key index and then executing the query using the `FunctionService` with the key or field value used as filter. The following is an example how to optimize a query that will be run on data partitioned by region key value. In the following example, data is partitioned by the "orderId" field. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/partitioned_region_query_restrictions.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/partitioned_region_query_restrictions.html.md.erb b/geode-docs/developing/query_additional/partitioned_region_query_restrictions.html.md.erb index 429081e..4fe4cd9 100644 --- a/geode-docs/developing/query_additional/partitioned_region_query_restrictions.html.md.erb +++ b/geode-docs/developing/query_additional/partitioned_region_query_restrictions.html.md.erb @@ -2,6 +2,23 @@ title: Partitioned Region Query Restrictions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + ## <a id="concept_5353476380D44CC1A7F586E5AE1CE7E8__section_16875A7EA07D42C08FB194F4A854360D" class="no-quick-link"></a>Query Restrictions in Partitioned Regions Partitioned region queries function the same as non-partitioned region queries, except for the restrictions listed in this section. Partitioned region queries that do not follow these guidelines generate an `UnsupportedOperationException`. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/query_debugging.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/query_debugging.html.md.erb b/geode-docs/developing/query_additional/query_debugging.html.md.erb index b39cf08..c404d6b 100644 --- a/geode-docs/developing/query_additional/query_debugging.html.md.erb +++ b/geode-docs/developing/query_additional/query_debugging.html.md.erb @@ -2,6 +2,23 @@ title: Query Debugging --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + You can debug a specific query at the query level by adding the `<trace>` keyword before the query string that you want to debug. Here is an example: http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/query_language_features.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/query_language_features.html.md.erb b/geode-docs/developing/query_additional/query_language_features.html.md.erb index eea7cc0..10ab0c6 100644 --- a/geode-docs/developing/query_additional/query_language_features.html.md.erb +++ b/geode-docs/developing/query_additional/query_language_features.html.md.erb @@ -2,6 +2,23 @@ title: OQL Syntax and Semantics --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + <a id="concept_5B8BA904DF2A41BEAA057017777D4E90__section_33F0FD791A2448CB812E8397828B33C2"></a> This section covers the following querying language features: http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/query_on_a_single_node.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/query_on_a_single_node.html.md.erb b/geode-docs/developing/query_additional/query_on_a_single_node.html.md.erb index 6b56cb0..bf83999 100644 --- a/geode-docs/developing/query_additional/query_on_a_single_node.html.md.erb +++ b/geode-docs/developing/query_additional/query_on_a_single_node.html.md.erb @@ -2,6 +2,23 @@ title: Querying a Partitioned Region on a Single Node --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + To direct a query to specific partitioned region node, you can execute the query within a function. Use the following steps: 1. Implement a function which executes a query using RegionFunctionContext. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/supported_keywords.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/supported_keywords.html.md.erb b/geode-docs/developing/query_additional/supported_keywords.html.md.erb index 1a257f6..bbc3204 100644 --- a/geode-docs/developing/query_additional/supported_keywords.html.md.erb +++ b/geode-docs/developing/query_additional/supported_keywords.html.md.erb @@ -2,6 +2,23 @@ title: Supported Keywords --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + | Query Language Keyword | Description | Example | |------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | AND | Logical operator used to create complex expressions by combining two or more expressions to produce a Boolean result. When you combine two conditional expressions using the AND operator, both conditions must evaluate to true for the entire expression to be true. | See [Operators](operators.html#operators) | http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_additional/using_query_bind_parameters.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_additional/using_query_bind_parameters.html.md.erb b/geode-docs/developing/query_additional/using_query_bind_parameters.html.md.erb index cf9dcea..8fee56b 100644 --- a/geode-docs/developing/query_additional/using_query_bind_parameters.html.md.erb +++ b/geode-docs/developing/query_additional/using_query_bind_parameters.html.md.erb @@ -2,6 +2,23 @@ title: Using Query Bind Parameters --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Using query bind parameters in Geode queries is similar to using prepared statements in SQL where parameters can be set during query execution. This allows user to build a query once and execute it multiple times by passing the query conditions during run time. Query objects are thread-safe. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/create_multiple_indexes.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/create_multiple_indexes.html.md.erb b/geode-docs/developing/query_index/create_multiple_indexes.html.md.erb index a629349..e5a15c0 100644 --- a/geode-docs/developing/query_index/create_multiple_indexes.html.md.erb +++ b/geode-docs/developing/query_index/create_multiple_indexes.html.md.erb @@ -2,6 +2,23 @@ title: Creating Multiple Indexes at Once --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + In order to speed and promote efficiency when creating indexes, you can define multiple indexes and then create them all at once. Defining multiple indexes before creating them speeds up the index creation process by iterating over region entries only once. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/creating_an_index.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/creating_an_index.html.md.erb b/geode-docs/developing/query_index/creating_an_index.html.md.erb index 8e977a7..2438447 100644 --- a/geode-docs/developing/query_index/creating_an_index.html.md.erb +++ b/geode-docs/developing/query_index/creating_an_index.html.md.erb @@ -2,6 +2,23 @@ title: Creating, Listing and Removing Indexes --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + The Geode `QueryService` API provides methods to create, list and remove the index. You can also use `gfsh` command-line interface to create, list and remove indexes, and use cache.xml to create an index. ## <a id="indexing__section_565C080FBDD0443C8504DF372E3C32C8" class="no-quick-link"></a>Creating Indexes http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/creating_hash_indexes.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/creating_hash_indexes.html.md.erb b/geode-docs/developing/query_index/creating_hash_indexes.html.md.erb index f7fe579..bd97e6f 100644 --- a/geode-docs/developing/query_index/creating_hash_indexes.html.md.erb +++ b/geode-docs/developing/query_index/creating_hash_indexes.html.md.erb @@ -2,6 +2,23 @@ title: Creating Hash Indexes --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Geode supports the creation of hash indexes for the purposes of performing equality-based queries. ## <a id="concept_5C7614F71F394C62ACA1BDC5684A7AC4__section_8A927DFB29364DA7856E7FE122FC1654" class="no-quick-link"></a>Why Create a HashIndex http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/creating_key_indexes.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/creating_key_indexes.html.md.erb b/geode-docs/developing/query_index/creating_key_indexes.html.md.erb index fb9de44..c7baff2 100644 --- a/geode-docs/developing/query_index/creating_key_indexes.html.md.erb +++ b/geode-docs/developing/query_index/creating_key_indexes.html.md.erb @@ -2,6 +2,23 @@ title: Creating Key Indexes --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Creating a key index is a good way to improve query performance when data is partitioned using a key or a field value. You can create key indexes by using the `createKeyIndex` method of the QueryService or by defining the index in `cache.xml`. Creating a key index makes the query service aware of the relationship between the values in the region and the keys in the region. The FROM clause for a primary key index must be just a region path. The indexed expression is an expression that, when applied to an entry value, produces the key. For example, if a region has Portfolios as the values and the keys are the id field of the Portfolios region, the indexed expression is id. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/creating_map_indexes.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/creating_map_indexes.html.md.erb b/geode-docs/developing/query_index/creating_map_indexes.html.md.erb index 32a5cf2..d1b1523 100644 --- a/geode-docs/developing/query_index/creating_map_indexes.html.md.erb +++ b/geode-docs/developing/query_index/creating_map_indexes.html.md.erb @@ -2,6 +2,23 @@ title: Creating Indexes on Map Fields ("Map Indexes") --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + To assist with the quick lookup of multiple values in a Map (or HashMap) type field, you can create an index (sometimes referred to as a "map index") on specific (or all) keys in that field. For example, you could create a map index to support the following query: http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/index_samples.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/index_samples.html.md.erb b/geode-docs/developing/query_index/index_samples.html.md.erb index ce2e67c..6429a97 100644 --- a/geode-docs/developing/query_index/index_samples.html.md.erb +++ b/geode-docs/developing/query_index/index_samples.html.md.erb @@ -2,6 +2,23 @@ title: Index Samples --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + This topic provides code samples for creating query indexes. ``` pre http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/indexes_on_single_region_queries.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/indexes_on_single_region_queries.html.md.erb b/geode-docs/developing/query_index/indexes_on_single_region_queries.html.md.erb index 35662f7..c378cfd 100644 --- a/geode-docs/developing/query_index/indexes_on_single_region_queries.html.md.erb +++ b/geode-docs/developing/query_index/indexes_on_single_region_queries.html.md.erb @@ -2,6 +2,23 @@ title: Using Indexes on Single Region Queries --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Queries with one comparison operation may be improved with either a key or range index, depending on whether the attribute being compared is also the primary key. <a id="concept_0210701C193A470E8C572111F6CEC3FC__section_751427643EC3480BABCE9CA44E831E27"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/indexes_with_overflow_regions.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/indexes_with_overflow_regions.html.md.erb b/geode-docs/developing/query_index/indexes_with_overflow_regions.html.md.erb index 126b2e6..e89443d 100644 --- a/geode-docs/developing/query_index/indexes_with_overflow_regions.html.md.erb +++ b/geode-docs/developing/query_index/indexes_with_overflow_regions.html.md.erb @@ -2,6 +2,23 @@ title: Using Indexes with Overflow Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + You can use indexes when querying on overflow regions; however, there are caveats. The following are caveats for querying overflow regions: http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/indexing_guidelines.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/indexing_guidelines.html.md.erb b/geode-docs/developing/query_index/indexing_guidelines.html.md.erb index 8cf229f..88c14b0 100644 --- a/geode-docs/developing/query_index/indexing_guidelines.html.md.erb +++ b/geode-docs/developing/query_index/indexing_guidelines.html.md.erb @@ -2,6 +2,23 @@ title: Tips and Guidelines on Using Indexes --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Optimizing your queries with indexes requires a cycle of careful planning, testing, and tuning. Poorly-defined indexes can degrade the performance of your queries instead of improving it. This section gives guidelines for index usage in the query service. <a id="indexing_guidelines__section_A8885DFC334243508C4563C9692E0801"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/maintaining_indexes.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/maintaining_indexes.html.md.erb b/geode-docs/developing/query_index/maintaining_indexes.html.md.erb index ae8c29b..838f380 100644 --- a/geode-docs/developing/query_index/maintaining_indexes.html.md.erb +++ b/geode-docs/developing/query_index/maintaining_indexes.html.md.erb @@ -2,6 +2,23 @@ title: Maintaining Indexes (Synchronously or Asynchronously) and Index Storage --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Indexes are automatically kept current with the region data they reference. The region attribute `IndexMaintenanceSynchronous` specifies whether the region indexes are updated synchronously when a region is modified or asynchronously in a background thread. ## <a id="concept_98ED3F38919A490B9AE2553568455C35__section_FF1945F2AAFA4B158067CEE967410616" class="no-quick-link"></a>Index Maintenance Behavior http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/query_index.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/query_index.html.md.erb b/geode-docs/developing/query_index/query_index.html.md.erb index accbf00..0f2c698 100644 --- a/geode-docs/developing/query_index/query_index.html.md.erb +++ b/geode-docs/developing/query_index/query_index.html.md.erb @@ -2,6 +2,23 @@ title: Working with Indexes --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + The Geode query engine supports indexing. An index can provide significant performance gains for query execution. <a id="indexing__section_565C080FBDD0443C8504DF372E3C32C8"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/query_index_hints.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/query_index_hints.html.md.erb b/geode-docs/developing/query_index/query_index_hints.html.md.erb index 37b1005..9911014 100644 --- a/geode-docs/developing/query_index/query_index_hints.html.md.erb +++ b/geode-docs/developing/query_index/query_index_hints.html.md.erb @@ -2,6 +2,23 @@ title: Using Query Index Hints --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + You can use the hint keyword to allow Geode's query engine to prefer certain indexes. In cases where one index is hinted in a query, the query engine filters off the hinted index (if possible) and then iterates and filters from the resulting values. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/using_indexes_with_equijoin_queries.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/using_indexes_with_equijoin_queries.html.md.erb b/geode-docs/developing/query_index/using_indexes_with_equijoin_queries.html.md.erb index 2d7accc..a5ca840 100644 --- a/geode-docs/developing/query_index/using_indexes_with_equijoin_queries.html.md.erb +++ b/geode-docs/developing/query_index/using_indexes_with_equijoin_queries.html.md.erb @@ -2,6 +2,23 @@ title: Using Indexes with Equi-Join Queries --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + Equi-join queries are queries in which two regions are joined through an equality condition in the WHERE clause. <a id="concept_A90C5FD84FCB45B2B28D6CE78DE1D117__section_47CFF4EF4D964FCFBB772B0347C02214"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_index/using_indexes_with_equijoin_queries_multiple_regions.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_index/using_indexes_with_equijoin_queries_multiple_regions.html.md.erb b/geode-docs/developing/query_index/using_indexes_with_equijoin_queries_multiple_regions.html.md.erb index a834b60..04e63d2 100644 --- a/geode-docs/developing/query_index/using_indexes_with_equijoin_queries_multiple_regions.html.md.erb +++ b/geode-docs/developing/query_index/using_indexes_with_equijoin_queries_multiple_regions.html.md.erb @@ -2,6 +2,23 @@ title: Using Indexes on Equi-Join Queries using Multiple Regions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + To query across multiple regions, identify all equi-join conditions. Then, create as few indexes for the equi-join conditions as you can while still joining all regions. <a id="concept_DB2407C49F064B04AA58BC9D1DBA3666__section_70735ED43C4D47B0A19B910BB7E3A1DA"></a> http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_select/aggregates.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_select/aggregates.html.md.erb b/geode-docs/developing/query_select/aggregates.html.md.erb index 1a4e0aa..38bd490 100644 --- a/geode-docs/developing/query_select/aggregates.html.md.erb +++ b/geode-docs/developing/query_select/aggregates.html.md.erb @@ -2,6 +2,23 @@ title: OQL Aggregate Functions --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + The aggregate functions ```MIN```, ```MAX```, http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_select/the_from_clause.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_select/the_from_clause.html.md.erb b/geode-docs/developing/query_select/the_from_clause.html.md.erb index 2ecc2e8..4490972 100644 --- a/geode-docs/developing/query_select/the_from_clause.html.md.erb +++ b/geode-docs/developing/query_select/the_from_clause.html.md.erb @@ -2,6 +2,23 @@ title: FROM Clause --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + <a id="the_from_clause__section_FAEBC02C4E414F91B1CA8D33E11218AF"></a> Use the FROM clause to bring the data you need into scope for the rest of your query. The FROM clause also includes object typing and iterator variables. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_select/the_import_statement.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_select/the_import_statement.html.md.erb b/geode-docs/developing/query_select/the_import_statement.html.md.erb index 1269f79..f58d443 100644 --- a/geode-docs/developing/query_select/the_import_statement.html.md.erb +++ b/geode-docs/developing/query_select/the_import_statement.html.md.erb @@ -2,6 +2,23 @@ title: IMPORT Statement --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + It is sometimes necessary for an OQL query to refer to the class of an object. In cases where the same class name resides in two different namescopes (packages), you must be able to differentiate the classes having the same name. The **IMPORT** statement is used to establish a name for a class in a query. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_select/the_select_statement.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_select/the_select_statement.html.md.erb b/geode-docs/developing/query_select/the_select_statement.html.md.erb index 04d14df..baaf6c1 100644 --- a/geode-docs/developing/query_select/the_select_statement.html.md.erb +++ b/geode-docs/developing/query_select/the_select_statement.html.md.erb @@ -2,6 +2,23 @@ title: SELECT Statement --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + The SELECT statement allows you to filter data from the collection of object(s) returned by a WHERE search operation. The projection list is either specified as \* or as a comma delimited list of expressions. For \*, the interim results of the WHERE clause are returned from the query. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/6bea8204/geode-docs/developing/query_select/the_where_clause.html.md.erb ---------------------------------------------------------------------- diff --git a/geode-docs/developing/query_select/the_where_clause.html.md.erb b/geode-docs/developing/query_select/the_where_clause.html.md.erb index fd2405e..834bae9 100644 --- a/geode-docs/developing/query_select/the_where_clause.html.md.erb +++ b/geode-docs/developing/query_select/the_where_clause.html.md.erb @@ -2,6 +2,23 @@ title: WHERE Clause --- +<!-- +Licensed to the Apache Software Foundation (ASF) under one or more +contributor license agreements. See the NOTICE file distributed with +this work for additional information regarding copyright ownership. +The ASF licenses this file to You under the Apache License, Version 2.0 +(the "License"); you may not use this file except in compliance with +the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + <a id="the_where_clause__section_56BB3A7F44124CA9BFBC20E19399C6E4"></a> Each FROM clause expression must resolve to a collection of objects. The collection is then available for iteration in the query expressions that follow in the WHERE clause.
