io.trino.execution.scheduler.NodeSelector Maven / Gradle / Ivy
/*
* Licensed 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 io.trino.execution.scheduler;
import com.google.common.collect.ImmutableSet;
import io.trino.execution.RemoteTask;
import io.trino.metadata.InternalNode;
import io.trino.metadata.Split;
import java.util.List;
import java.util.Set;
public interface NodeSelector
{
void lockDownNodes();
List allNodes();
InternalNode selectCurrentNode();
default List selectRandomNodes(int limit)
{
return selectRandomNodes(limit, ImmutableSet.of());
}
List selectRandomNodes(int limit, Set excludedNodes);
/**
* Identifies the nodes for running the specified splits.
*
* @param splits the splits that need to be assigned to nodes
* @return a multimap from node to splits only for splits for which we could identify a node to schedule on.
* If we cannot find an assignment for a split, it is not included in the map. Also returns a future indicating when
* to reattempt scheduling of this batch of splits, if some of them could not be scheduled.
*/
SplitPlacementResult computeAssignments(Set splits, List existingTasks);
/**
* Identifies the nodes for running the specified splits based on a precomputed fixed partitioning.
*
* @param splits the splits that need to be assigned to nodes
* @return a multimap from node to splits only for splits for which we could identify a node with free space.
* If we cannot find an assignment for a split, it is not included in the map. Also returns a future indicating when
* to reattempt scheduling of this batch of splits, if some of them could not be scheduled.
*/
SplitPlacementResult computeAssignments(Set splits, List existingTasks, BucketNodeMap bucketNodeMap);
}