|
|
|
|
@ -1,182 +0,0 @@
|
|
|
|
|
/*
|
|
|
|
|
* 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.
|
|
|
|
|
*/
|
|
|
|
|
package org.apache.calcite.config;
|
|
|
|
|
|
|
|
|
|
import java.util.HashMap;
|
|
|
|
|
import java.util.Map;
|
|
|
|
|
import java.util.Properties;
|
|
|
|
|
|
|
|
|
|
import org.apache.calcite.avatica.ConnectionProperty;
|
|
|
|
|
import org.apache.calcite.avatica.util.Casing;
|
|
|
|
|
import org.apache.calcite.avatica.util.Quoting;
|
|
|
|
|
import org.apache.calcite.model.JsonSchema;
|
|
|
|
|
import org.apache.calcite.sql.validate.SqlConformance;
|
|
|
|
|
|
|
|
|
|
import static org.apache.calcite.avatica.ConnectionConfigImpl.PropEnv;
|
|
|
|
|
import static org.apache.calcite.avatica.ConnectionConfigImpl.parse;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Properties that may be specified on the JDBC connect string.
|
|
|
|
|
*/
|
|
|
|
|
public enum CalciteConnectionProperty implements ConnectionProperty {
|
|
|
|
|
/** Whether to store query results in temporary tables. */
|
|
|
|
|
AUTO_TEMP("autoTemp", Type.BOOLEAN, false, false),
|
|
|
|
|
|
|
|
|
|
/** Whether Calcite should use materializations. */
|
|
|
|
|
MATERIALIZATIONS_ENABLED("materializationsEnabled", Type.BOOLEAN, true,
|
|
|
|
|
false),
|
|
|
|
|
|
|
|
|
|
/** Whether Calcite should create materializations. */
|
|
|
|
|
CREATE_MATERIALIZATIONS("createMaterializations", Type.BOOLEAN, true, false),
|
|
|
|
|
|
|
|
|
|
/** How NULL values should be sorted if neither NULLS FIRST nor NULLS LAST are
|
|
|
|
|
* specified. The default, HIGH, sorts NULL values the same as Oracle. */
|
|
|
|
|
DEFAULT_NULL_COLLATION("defaultNullCollation", Type.ENUM, NullCollation.HIGH, NullCollation.class,
|
|
|
|
|
true),
|
|
|
|
|
|
|
|
|
|
/** How many rows the Druid adapter should fetch at a time when executing
|
|
|
|
|
* "select" queries. */
|
|
|
|
|
DRUID_FETCH("druidFetch", Type.NUMBER, 16384, false),
|
|
|
|
|
|
|
|
|
|
/** URI of the model. */
|
|
|
|
|
MODEL("model", Type.STRING, null, false),
|
|
|
|
|
|
|
|
|
|
/** Lexical policy. */
|
|
|
|
|
LEX("lex", Type.ENUM, Lex.ORACLE, Lex.class, false),
|
|
|
|
|
|
|
|
|
|
/** Collection of built-in functions and operators. Valid values include
|
|
|
|
|
* "standard" and "oracle". */
|
|
|
|
|
FUN("fun", Type.STRING, "standard", true),
|
|
|
|
|
|
|
|
|
|
/** How identifiers are quoted.
|
|
|
|
|
* If not specified, value from {@link #LEX} is used. */
|
|
|
|
|
QUOTING("quoting", Type.ENUM, null, Quoting.class, false),
|
|
|
|
|
|
|
|
|
|
/** How identifiers are stored if they are quoted.
|
|
|
|
|
* If not specified, value from {@link #LEX} is used. */
|
|
|
|
|
QUOTED_CASING("quotedCasing", Type.ENUM, null, Casing.class, false),
|
|
|
|
|
|
|
|
|
|
/** How identifiers are stored if they are not quoted.
|
|
|
|
|
* If not specified, value from {@link #LEX} is used. */
|
|
|
|
|
UNQUOTED_CASING("unquotedCasing", Type.ENUM, null, Casing.class, false),
|
|
|
|
|
|
|
|
|
|
/** Whether identifiers are matched case-sensitively.
|
|
|
|
|
* If not specified, value from {@link #LEX} is used. */
|
|
|
|
|
CASE_SENSITIVE("caseSensitive", Type.BOOLEAN, null, false),
|
|
|
|
|
|
|
|
|
|
/** Name of initial schema. */
|
|
|
|
|
SCHEMA("schema", Type.STRING, null, false),
|
|
|
|
|
|
|
|
|
|
/** Schema factory.
|
|
|
|
|
*
|
|
|
|
|
* <p>The name of a class that implements
|
|
|
|
|
* {@link org.apache.calcite.schema.SchemaFactory}.
|
|
|
|
|
*
|
|
|
|
|
* <p>Ignored if {@link #MODEL} is specified. */
|
|
|
|
|
SCHEMA_FACTORY("schemaFactory", Type.PLUGIN, null, false),
|
|
|
|
|
|
|
|
|
|
/** Schema type.
|
|
|
|
|
*
|
|
|
|
|
* <p>Value may be null, "MAP", "JDBC", or "CUSTOM"
|
|
|
|
|
* (implicit if {@link #SCHEMA_FACTORY} is specified).
|
|
|
|
|
* The value "NONE" is converted to null.
|
|
|
|
|
*
|
|
|
|
|
* <p>Ignored if {@link #MODEL} is specified. */
|
|
|
|
|
SCHEMA_TYPE("schemaType", Type.ENUM, JsonSchema.Type.NONE, JsonSchema.Type.class, false),
|
|
|
|
|
|
|
|
|
|
/** Specifies whether Spark should be used as the engine for processing that
|
|
|
|
|
* cannot be pushed to the source system. If false (the default), Calcite
|
|
|
|
|
* generates code that implements the Enumerable interface. */
|
|
|
|
|
SPARK("spark", Type.BOOLEAN, false, false),
|
|
|
|
|
|
|
|
|
|
/** Time zone, for example 'gmt-3'. Default is the JVM's time zone. */
|
|
|
|
|
TIME_ZONE("timeZone", Type.STRING, null, false),
|
|
|
|
|
|
|
|
|
|
/** If the planner should try de-correlating as much as it is possible.
|
|
|
|
|
* If true (the default), Calcite de-correlates the plan. */
|
|
|
|
|
FORCE_DECORRELATE("forceDecorrelate", Type.BOOLEAN, true, false),
|
|
|
|
|
|
|
|
|
|
/** Type system. The name of a class that implements
|
|
|
|
|
* {@link org.apache.calcite.rel.type.RelDataTypeSystem} and has a public
|
|
|
|
|
* default constructor or an {@code INSTANCE} constant. */
|
|
|
|
|
TYPE_SYSTEM("typeSystem", Type.PLUGIN, null, false),
|
|
|
|
|
|
|
|
|
|
/** SQL conformance level. */
|
|
|
|
|
CONFORMANCE("conformance", Type.ENUM, SqlConformance.DEFAULT, SqlConformance.class, false);
|
|
|
|
|
|
|
|
|
|
private final String camelName;
|
|
|
|
|
private final Type type;
|
|
|
|
|
private final Object defaultValue;
|
|
|
|
|
private final Class valueClass;
|
|
|
|
|
private final boolean required;
|
|
|
|
|
|
|
|
|
|
private static final Map<String, CalciteConnectionProperty> NAME_TO_PROPS;
|
|
|
|
|
|
|
|
|
|
/** Deprecated; use {@link #TIME_ZONE}. */
|
|
|
|
|
@Deprecated // to be removed before 2.0
|
|
|
|
|
public static final CalciteConnectionProperty TIMEZONE = TIME_ZONE;
|
|
|
|
|
|
|
|
|
|
static {
|
|
|
|
|
NAME_TO_PROPS = new HashMap<>();
|
|
|
|
|
for (CalciteConnectionProperty p : CalciteConnectionProperty.values()) {
|
|
|
|
|
NAME_TO_PROPS.put(p.camelName.toUpperCase(), p);
|
|
|
|
|
NAME_TO_PROPS.put(p.name(), p);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
CalciteConnectionProperty(String camelName, Type type, Object defaultValue,
|
|
|
|
|
boolean required) {
|
|
|
|
|
this(camelName, type, defaultValue, type.defaultValueClass(), required);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
CalciteConnectionProperty(String camelName, Type type, Object defaultValue,
|
|
|
|
|
Class valueClass, boolean required) {
|
|
|
|
|
this.camelName = camelName;
|
|
|
|
|
this.type = type;
|
|
|
|
|
this.defaultValue = defaultValue;
|
|
|
|
|
this.valueClass = valueClass;
|
|
|
|
|
this.required = required;
|
|
|
|
|
assert defaultValue == null || type.valid(defaultValue, valueClass);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public String camelName() {
|
|
|
|
|
return camelName;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public Object defaultValue() {
|
|
|
|
|
return defaultValue;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public Type type() {
|
|
|
|
|
return type;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public boolean required() {
|
|
|
|
|
return required;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public Class valueClass() {
|
|
|
|
|
return valueClass;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public PropEnv wrap(Properties properties) {
|
|
|
|
|
return new PropEnv(parse(properties, NAME_TO_PROPS), this);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// End CalciteConnectionProperty.java
|
Kevin Risden