2 * Copyright (c) 2010-2023 Contributors to the openHAB project
4 * See the NOTICE file(s) distributed with this work for additional
7 * This program and the accompanying materials are made available under the
8 * terms of the Eclipse Public License 2.0 which is available at
9 * http://www.eclipse.org/legal/epl-2.0
11 * SPDX-License-Identifier: EPL-2.0
13 package org.openhab.persistence.influxdb.internal.influx2;
15 import static com.influxdb.query.dsl.functions.restriction.Restrictions.measurement;
16 import static com.influxdb.query.dsl.functions.restriction.Restrictions.tag;
17 import static org.openhab.persistence.influxdb.internal.InfluxDBConstants.*;
18 import static org.openhab.persistence.influxdb.internal.InfluxDBStateConvertUtils.stateToObject;
20 import java.time.temporal.ChronoUnit;
22 import org.eclipse.jdt.annotation.NonNullByDefault;
23 import org.openhab.core.items.MetadataRegistry;
24 import org.openhab.core.persistence.FilterCriteria;
25 import org.openhab.persistence.influxdb.internal.FilterCriteriaQueryCreator;
26 import org.openhab.persistence.influxdb.internal.InfluxDBConfiguration;
27 import org.openhab.persistence.influxdb.internal.InfluxDBMetadataUtils;
28 import org.openhab.persistence.influxdb.internal.InfluxDBVersion;
30 import com.influxdb.query.dsl.Flux;
31 import com.influxdb.query.dsl.functions.RangeFlux;
32 import com.influxdb.query.dsl.functions.restriction.Restrictions;
35 * Implementation of {@link FilterCriteriaQueryCreator} for InfluxDB 2.0
37 * @author Joan Pujol Espinar - Initial contribution
40 public class Influx2FilterCriteriaQueryCreatorImpl implements FilterCriteriaQueryCreator {
42 private InfluxDBConfiguration configuration;
43 private MetadataRegistry metadataRegistry;
45 public Influx2FilterCriteriaQueryCreatorImpl(InfluxDBConfiguration configuration,
46 MetadataRegistry metadataRegistry) {
47 this.configuration = configuration;
48 this.metadataRegistry = metadataRegistry;
52 public String createQuery(FilterCriteria criteria, String retentionPolicy) {
53 Flux flux = Flux.from(retentionPolicy);
55 RangeFlux range = flux.range();
56 if (criteria.getBeginDate() != null) {
57 range = range.withStart(criteria.getBeginDate().toInstant());
59 range = flux.range(-100L, ChronoUnit.YEARS); // Flux needs a mandatory start range
61 if (criteria.getEndDate() != null) {
62 range = range.withStop(criteria.getEndDate().toInstant());
66 String itemName = criteria.getItemName();
67 if (itemName != null) {
68 String measurementName = calculateMeasurementName(itemName);
69 boolean needsToUseItemTagName = !measurementName.equals(itemName);
71 flux = flux.filter(measurement().equal(measurementName));
72 if (needsToUseItemTagName) {
73 flux = flux.filter(tag(TAG_ITEM_NAME).equal(itemName));
76 if (needsToUseItemTagName) {
77 flux = flux.keep(new String[] { FIELD_MEASUREMENT_NAME, COLUMN_TIME_NAME_V2, COLUMN_VALUE_NAME_V2,
80 flux = flux.keep(new String[] { FIELD_MEASUREMENT_NAME, COLUMN_TIME_NAME_V2, COLUMN_VALUE_NAME_V2 });
84 if (criteria.getState() != null && criteria.getOperator() != null) {
85 Restrictions restrictions = Restrictions.and(Restrictions.field().equal(FIELD_VALUE_NAME),
86 Restrictions.value().custom(stateToObject(criteria.getState()),
87 getOperationSymbol(criteria.getOperator(), InfluxDBVersion.V2)));
88 flux = flux.filter(restrictions);
91 flux = applyOrderingAndPageSize(criteria, flux);
93 return flux.toString();
96 private Flux applyOrderingAndPageSize(FilterCriteria criteria, Flux flux) {
97 var lastOptimization = criteria.getOrdering() == FilterCriteria.Ordering.DESCENDING
98 && criteria.getPageSize() == 1;
100 if (lastOptimization) {
103 if (criteria.getOrdering() != null) {
104 boolean desc = criteria.getOrdering() == FilterCriteria.Ordering.DESCENDING;
105 flux = flux.sort().withDesc(desc).withColumns(new String[] { COLUMN_TIME_NAME_V2 });
108 if (criteria.getPageSize() != Integer.MAX_VALUE) {
109 flux = flux.limit(criteria.getPageSize()).withPropertyValue("offset",
110 criteria.getPageNumber() * criteria.getPageSize());
116 private String calculateMeasurementName(String itemName) {
117 String name = itemName;
119 name = InfluxDBMetadataUtils.calculateMeasurementNameFromMetadataIfPresent(metadataRegistry, name, itemName);
121 if (configuration.isReplaceUnderscore()) {
122 name = name.replace('_', '.');