/*
* 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.flink.compiler.operators;
import java.util.ArrayList;
import java.util.List;
import org.apache.flink.api.common.operators.util.FieldList;
import org.apache.flink.compiler.dataproperties.GlobalProperties;
import org.apache.flink.compiler.dataproperties.PartitioningProperty;
import org.apache.flink.compiler.dataproperties.RequestedGlobalProperties;
/**
* Defines the possible global properties for a join.
*/
public abstract class AbstractJoinDescriptor extends OperatorDescriptorDual {
private final boolean broadcastFirstAllowed;
private final boolean broadcastSecondAllowed;
private final boolean repartitionAllowed;
protected AbstractJoinDescriptor(FieldList keys1, FieldList keys2) {
this(keys1, keys2, true, true, true);
}
protected AbstractJoinDescriptor(FieldList keys1, FieldList keys2,
boolean broadcastFirstAllowed, boolean broadcastSecondAllowed, boolean repartitionAllowed)
{
super(keys1, keys2);
this.broadcastFirstAllowed = broadcastFirstAllowed;
this.broadcastSecondAllowed = broadcastSecondAllowed;
this.repartitionAllowed = repartitionAllowed;
}
@Override
protected List<GlobalPropertiesPair> createPossibleGlobalProperties() {
ArrayList<GlobalPropertiesPair> pairs = new ArrayList<GlobalPropertiesPair>();
if (repartitionAllowed) {
// partition both (hash)
RequestedGlobalProperties partitioned1 = new RequestedGlobalProperties();
partitioned1.setHashPartitioned(this.keys1);
RequestedGlobalProperties partitioned2 = new RequestedGlobalProperties();
partitioned2.setHashPartitioned(this.keys2);
pairs.add(new GlobalPropertiesPair(partitioned1, partitioned2));
}
if (broadcastSecondAllowed) {
// replicate second
RequestedGlobalProperties any1 = new RequestedGlobalProperties();
RequestedGlobalProperties replicated2 = new RequestedGlobalProperties();
replicated2.setFullyReplicated();
pairs.add(new GlobalPropertiesPair(any1, replicated2));
}
if (broadcastFirstAllowed) {
// replicate first
RequestedGlobalProperties replicated1 = new RequestedGlobalProperties();
replicated1.setFullyReplicated();
RequestedGlobalProperties any2 = new RequestedGlobalProperties();
pairs.add(new GlobalPropertiesPair(replicated1, any2));
}
return pairs;
}
@Override
public GlobalProperties computeGlobalProperties(GlobalProperties in1, GlobalProperties in2) {
GlobalProperties gp = GlobalProperties.combine(in1, in2);
if (gp.getUniqueFieldCombination() != null && gp.getUniqueFieldCombination().size() > 0 &&
gp.getPartitioning() == PartitioningProperty.RANDOM)
{
gp.setAnyPartitioning(gp.getUniqueFieldCombination().iterator().next().toFieldList());
}
gp.clearUniqueFieldCombinations();
return gp;
}
}