ExceededMemoryLimitException.java

/*
 * 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 com.facebook.presto;

import com.facebook.presto.spi.ErrorCause;
import com.facebook.presto.spi.PrestoException;
import com.facebook.presto.spi.StandardErrorCode;
import io.airlift.units.DataSize;

import java.util.Optional;

import static com.facebook.presto.spi.ErrorCause.EXCEEDS_BROADCAST_MEMORY_LIMIT;
import static com.facebook.presto.spi.ErrorCause.UNKNOWN;
import static com.facebook.presto.spi.StandardErrorCode.EXCEEDED_GLOBAL_MEMORY_LIMIT;
import static com.facebook.presto.spi.StandardErrorCode.EXCEEDED_LOCAL_BROADCAST_JOIN_MEMORY_LIMIT;
import static com.facebook.presto.spi.StandardErrorCode.EXCEEDED_LOCAL_MEMORY_LIMIT;
import static com.facebook.presto.spi.StandardErrorCode.EXCEEDED_REVOCABLE_MEMORY_LIMIT;
import static com.facebook.presto.util.HeapDumper.dumpHeap;
import static java.lang.String.format;

public class ExceededMemoryLimitException
        extends PrestoException
{
    private final ErrorCause errorCause;

    public static ExceededMemoryLimitException exceededGlobalUserLimit(DataSize maxMemory)
    {
        return new ExceededMemoryLimitException(EXCEEDED_GLOBAL_MEMORY_LIMIT, format("Query exceeded distributed user memory limit of %s", maxMemory));
    }

    public static ExceededMemoryLimitException exceededGlobalTotalLimit(DataSize maxMemory, String limitSource)
    {
        return new ExceededMemoryLimitException(EXCEEDED_GLOBAL_MEMORY_LIMIT, format("Query exceeded distributed total memory limit of %s defined at the %s", maxMemory, limitSource));
    }

    public static ExceededMemoryLimitException exceededLocalUserMemoryLimit(
            DataSize maxMemory,
            String additionalFailureInfo,
            boolean heapDumpOnExceededMemoryLimitEnabled,
            Optional<String> heapDumpFilePath,
            ErrorCause errorCause)
    {
        performHeapDumpIfEnabled(heapDumpOnExceededMemoryLimitEnabled, heapDumpFilePath);
        return new ExceededMemoryLimitException(EXCEEDED_LOCAL_MEMORY_LIMIT,
                format("Query exceeded per-node user memory limit of %s [%s]", maxMemory, additionalFailureInfo),
                errorCause);
    }

    public static ExceededMemoryLimitException exceededLocalBroadcastMemoryLimit(DataSize maxMemory, String additionalFailureInfo)
    {
        return new ExceededMemoryLimitException(EXCEEDED_LOCAL_BROADCAST_JOIN_MEMORY_LIMIT,
                format("Query exceeded per-node broadcast memory limit of %s [%s]", maxMemory, additionalFailureInfo),
                EXCEEDS_BROADCAST_MEMORY_LIMIT);
    }

    public static ExceededMemoryLimitException exceededLocalTotalMemoryLimit(
            DataSize maxMemory,
            String additionalFailureInfo,
            boolean heapDumpOnExceededMemoryLimitEnabled,
            Optional<String> heapDumpFilePath,
            ErrorCause errorCause)
    {
        performHeapDumpIfEnabled(heapDumpOnExceededMemoryLimitEnabled, heapDumpFilePath);
        return new ExceededMemoryLimitException(EXCEEDED_LOCAL_MEMORY_LIMIT,
                format("Query exceeded per-node total memory limit of %s [%s]", maxMemory, additionalFailureInfo),
                errorCause);
    }

    public static ExceededMemoryLimitException exceededLocalRevocableMemoryLimit(
            DataSize maxMemory,
            String additionalFailureInfo,
            boolean heapDumpOnExceededMemoryLimitEnabled,
            Optional<String> heapDumpFilePath)
    {
        performHeapDumpIfEnabled(heapDumpOnExceededMemoryLimitEnabled, heapDumpFilePath);
        return new ExceededMemoryLimitException(
                EXCEEDED_REVOCABLE_MEMORY_LIMIT,
                format("Query exceeded per-node revocable memory limit of %s [%s]", maxMemory, additionalFailureInfo));
    }

    // Heap dump is done synchronously to ensure that we capture the current state of the heap
    // This is intended to be used for debugging purposes only
    private static void performHeapDumpIfEnabled(boolean heapDumpOnExceededMemoryLimitEnabled, Optional<String> heapDumpFilePath)
    {
        if (heapDumpOnExceededMemoryLimitEnabled && heapDumpFilePath.isPresent()) {
            dumpHeap(heapDumpFilePath.get());
        }
    }

    private ExceededMemoryLimitException(StandardErrorCode errorCode, String message)
    {
        this(errorCode, message, UNKNOWN);
    }

    private ExceededMemoryLimitException(StandardErrorCode errorCode, String message, ErrorCause errorCause)
    {
        super(errorCode, message);
        this.errorCause = errorCause;
    }

    public ErrorCause getErrorCause()
    {
        return errorCause;
    }
}