| /* |
| * 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.wayang.java.operators; |
| |
| import java.util.Arrays; |
| import java.util.Collection; |
| import java.util.Collections; |
| import java.util.HashMap; |
| import java.util.LinkedList; |
| import java.util.List; |
| import java.util.Map; |
| import java.util.Optional; |
| import java.util.function.Function; |
| import java.util.stream.Stream; |
| import org.apache.wayang.basic.data.Tuple2; |
| import org.apache.wayang.basic.operators.JoinOperator; |
| import org.apache.wayang.core.api.Configuration; |
| import org.apache.wayang.core.function.TransformationDescriptor; |
| import org.apache.wayang.core.optimizer.OptimizationContext; |
| import org.apache.wayang.core.optimizer.cardinality.CardinalityEstimate; |
| import org.apache.wayang.core.optimizer.costs.LoadProfileEstimator; |
| import org.apache.wayang.core.optimizer.costs.LoadProfileEstimators; |
| import org.apache.wayang.core.plan.wayangplan.ExecutionOperator; |
| import org.apache.wayang.core.platform.ChannelDescriptor; |
| import org.apache.wayang.core.platform.ChannelInstance; |
| import org.apache.wayang.core.platform.lineage.ExecutionLineageNode; |
| import org.apache.wayang.core.types.DataSetType; |
| import org.apache.wayang.core.util.Tuple; |
| import org.apache.wayang.java.channels.CollectionChannel; |
| import org.apache.wayang.java.channels.JavaChannelInstance; |
| import org.apache.wayang.java.channels.StreamChannel; |
| import org.apache.wayang.java.execution.JavaExecutor; |
| |
| /** |
| * Java implementation of the {@link JoinOperator}. |
| */ |
| public class JavaJoinOperator<InputType0, InputType1, KeyType> |
| extends JoinOperator<InputType0, InputType1, KeyType> |
| implements JavaExecutionOperator { |
| |
| /** |
| * Creates a new instance. |
| */ |
| public JavaJoinOperator(DataSetType<InputType0> inputType0, |
| DataSetType<InputType1> inputType1, |
| TransformationDescriptor<InputType0, KeyType> keyDescriptor0, |
| TransformationDescriptor<InputType1, KeyType> keyDescriptor1) { |
| |
| super(keyDescriptor0, keyDescriptor1, inputType0, inputType1); |
| } |
| |
| /** |
| * Copies an instance (exclusive of broadcasts). |
| * |
| * @param that that should be copied |
| */ |
| public JavaJoinOperator(JoinOperator<InputType0, InputType1, KeyType> that) { |
| super(that); |
| } |
| |
| @Override |
| public Tuple<Collection<ExecutionLineageNode>, Collection<ChannelInstance>> evaluate( |
| ChannelInstance[] inputs, |
| ChannelInstance[] outputs, |
| JavaExecutor javaExecutor, |
| OptimizationContext.OperatorContext operatorContext) { |
| assert inputs.length == this.getNumInputs(); |
| assert outputs.length == this.getNumOutputs(); |
| |
| final Function<InputType0, KeyType> keyExtractor0 = javaExecutor.getCompiler().compile(this.keyDescriptor0); |
| final Function<InputType1, KeyType> keyExtractor1 = javaExecutor.getCompiler().compile(this.keyDescriptor1); |
| |
| final CardinalityEstimate cardinalityEstimate0 = operatorContext.getInputCardinality(0); |
| final CardinalityEstimate cardinalityEstimate1 = operatorContext.getInputCardinality(1); |
| |
| ExecutionLineageNode indexingExecutionLineageNode = new ExecutionLineageNode(operatorContext); |
| indexingExecutionLineageNode.add(LoadProfileEstimators.createFromSpecification( |
| "wayang.java.join.load.indexing", javaExecutor.getConfiguration() |
| )); |
| ExecutionLineageNode probingExecutionLineageNode = new ExecutionLineageNode(operatorContext); |
| probingExecutionLineageNode.add(LoadProfileEstimators.createFromSpecification( |
| "wayang.java.join.load.probing", javaExecutor.getConfiguration() |
| )); |
| |
| final Stream<Tuple2<InputType0, InputType1>> joinStream; |
| Collection<ExecutionLineageNode> executionLineageNodes = new LinkedList<>(); |
| Collection<ChannelInstance> producedChannelInstances = new LinkedList<>(); |
| |
| boolean isMaterialize0 = cardinalityEstimate0 != null && |
| cardinalityEstimate1 != null && |
| cardinalityEstimate0.getGeometricMeanEstimate() <= cardinalityEstimate1.getGeometricMeanEstimate(); |
| |
| if (isMaterialize0) { |
| final int expectedNumElements = |
| (int) cardinalityEstimate0.getGeometricMeanEstimate(); |
| Map<KeyType, Collection<InputType0>> probeTable = new HashMap<>(expectedNumElements); |
| ((JavaChannelInstance) inputs[0]).<InputType0>provideStream().forEach(dataQuantum0 -> |
| probeTable.compute(keyExtractor0.apply(dataQuantum0), |
| (key, value) -> { |
| value = value == null ? new LinkedList<>() : value; |
| value.add(dataQuantum0); |
| return value; |
| } |
| ) |
| ); |
| joinStream = ((JavaChannelInstance) inputs[1]).<InputType1>provideStream().flatMap(dataQuantum1 -> |
| probeTable.getOrDefault(keyExtractor1.apply(dataQuantum1), Collections.emptyList()).stream() |
| .map(dataQuantum0 -> new Tuple2<>(dataQuantum0, dataQuantum1))); |
| indexingExecutionLineageNode.addPredecessor(inputs[0].getLineage()); |
| indexingExecutionLineageNode.collectAndMark(executionLineageNodes, producedChannelInstances); |
| probingExecutionLineageNode.addPredecessor(inputs[1].getLineage()); |
| } else { |
| final int expectedNumElements = cardinalityEstimate1 == null ? |
| 1000 : |
| (int) cardinalityEstimate1.getGeometricMeanEstimate(); |
| Map<KeyType, Collection<InputType1>> probeTable = new HashMap<>(expectedNumElements); |
| ((JavaChannelInstance) inputs[1]).<InputType1>provideStream().forEach(dataQuantum1 -> |
| probeTable.compute(keyExtractor1.apply(dataQuantum1), |
| (key, value) -> { |
| value = value == null ? new LinkedList<>() : value; |
| value.add(dataQuantum1); |
| return value; |
| } |
| ) |
| ); |
| joinStream = ((JavaChannelInstance) inputs[0]).<InputType0>provideStream().flatMap(dataQuantum0 -> |
| probeTable.getOrDefault(keyExtractor0.apply(dataQuantum0), Collections.emptyList()).stream() |
| .map(dataQuantum1 -> new Tuple2<>(dataQuantum0, dataQuantum1))); |
| indexingExecutionLineageNode.addPredecessor(inputs[1].getLineage()); |
| indexingExecutionLineageNode.collectAndMark(executionLineageNodes, producedChannelInstances); |
| probingExecutionLineageNode.addPredecessor(inputs[0].getLineage()); |
| } |
| |
| ((StreamChannel.Instance) outputs[0]).accept(joinStream); |
| outputs[0].getLineage().addPredecessor(probingExecutionLineageNode); |
| |
| return new Tuple<>(executionLineageNodes, producedChannelInstances); |
| } |
| |
| @Override |
| public Collection<String> getLoadProfileEstimatorConfigurationKeys() { |
| return Arrays.asList("wayang.java.join.load.indexing", "wayang.java.join.load.probing"); |
| } |
| |
| @Override |
| public Optional<LoadProfileEstimator> createLoadProfileEstimator(Configuration configuration) { |
| final Optional<LoadProfileEstimator> optEstimator = |
| JavaExecutionOperator.super.createLoadProfileEstimator(configuration); |
| LoadProfileEstimators.nestUdfEstimator(optEstimator, this.keyDescriptor0, configuration); |
| LoadProfileEstimators.nestUdfEstimator(optEstimator, this.keyDescriptor1, configuration); |
| return optEstimator; |
| } |
| |
| @Override |
| protected ExecutionOperator createCopy() { |
| return new JavaJoinOperator<>(this.getInputType0(), this.getInputType1(), |
| this.getKeyDescriptor0(), this.getKeyDescriptor1()); |
| } |
| |
| @Override |
| public List<ChannelDescriptor> getSupportedInputChannels(int index) { |
| assert index <= this.getNumInputs() || (index == 0 && this.getNumInputs() == 0); |
| return Arrays.asList(CollectionChannel.DESCRIPTOR, StreamChannel.DESCRIPTOR); |
| } |
| |
| @Override |
| public List<ChannelDescriptor> getSupportedOutputChannels(int index) { |
| assert index <= this.getNumOutputs() || (index == 0 && this.getNumOutputs() == 0); |
| return Collections.singletonList(StreamChannel.DESCRIPTOR); |
| } |
| |
| } |