prestodb/presto · error · PrestoException

INVALID_SESSION_PROPERTY

INVALID_SESSION_PROPERTY

Error message

Unknown session property: %s.%s

What it means

FullConnectorSession.getProperty was asked for a catalog session property but the connector session has no property map (null properties), meaning the property name is unknown to this connector; rejected with INVALID_SESSION_PROPERTY. The catalog and property name are included.

Source

Thrown at presto-main-base/src/main/java/com/facebook/presto/FullConnectorSession.java:261

    }

    @Override
    public SqlFunctionProperties getSqlFunctionProperties()
    {
        return sqlFunctionProperties;
    }

    @Override
    public Map<SqlFunctionId, SqlInvokedFunction> getSessionFunctions()
    {
        return sessionFunctions;
    }

    @Override
    public <T> T getProperty(String propertyName, Class<T> type)
    {
        if (properties == null) {
            throw new PrestoException(INVALID_SESSION_PROPERTY, format("Unknown session property: %s.%s", catalog, propertyName));
        }

        return sessionPropertyManager.decodeCatalogPropertyValue(connectorId, catalog, propertyName, properties.get(propertyName), type);
    }

    @Override
    public Optional<String> getSchema()
    {
        return session.getSchema();
    }

    @Override
    public Optional<ConnectorId> getConnectorId()
    {
        return Optional.ofNullable(connectorId);
    }

    @Override

View on GitHub (pinned to 55bb57d202)

Solutions

  1. Check the property name spelling and that it belongs to the named catalog
  2. Verify the connector actually exposes the session property
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at presto-main-base/src/main/java/com/facebook/presto/FullConnectorSession.java:261 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of prestodb/presto@55bb57d202 (2026-09-04). Data as JSON: /api/errors/c62bffc861b796ae. Report an issue: GitHub.