apache/cassandra · error · InvalidRequestException

In this context function name must be explictly qualified…

Error message

In this context function name must be explictly qualified by a keyspace

What it means

FunctionResource.functionFromCql builds a function-level permission resource from a CQL function signature. When the keyspace argument is null the function name is unqualified, and Cassandra refuses to guess the keyspace in that context, throwing InvalidRequestException.

Solutions

  1. Qualify the function name with its keyspace: 'ON FUNCTION <keyspace>.<name>(<types>)'
  2. Or first issue 'USE <keyspace>' in the same session so the keyspace is resolved
  3. If calling programmatically (AuthPermissions/RoleManager style code), pass a non-null keyspace string to functionFromCql

Example fix

// before
GRANT EXECUTE ON FUNCTION total(int) TO role1;
// after
GRANT EXECUTE ON FUNCTION mykeyspace.total(int) TO role1;
Defensive patterns

Strategy: validation

Validate before calling

if (keyspace == null || keyspace.isEmpty())
    throw new IllegalArgumentException("Function name in GRANT/REVOKE must be keyspace-qualified: <ks>.<fn>");

Try / catch

try { ... } catch (InvalidRequestException e) { /* prompt user to qualify the function with a keyspace */ }

Prevention

When it happens

Trigger: Executing GRANT/REVOKE/LIST PERMISSIONS on a function without a keyspace qualifier, e.g. 'GRANT EXECUTE ON FUNCTION myfn(int) TO role' instead of 'ON FUNCTION ks.myfn(int)', when the statement is not executed within a USE keyspace context that supplies a default.

Common situations: Copy-pasting function signatures from CREATE FUNCTION statements that omitted the keyspace; running auth statements from cqlsh without a keyspace selected; tools generating permission DDL from unqualified function names.

Understand the failure class

Background: "missing required argument" and "the following required arguments were not provided": what required-argument errors mean and how to fix them — this error's family across 20 libraries.

Related errors

AI-assisted analysis of apache/cassandra@88fd0f6a0e (2026-09-10). Data as JSON: /api/errors/3659efd8ef6836df. Report an issue: GitHub.

Appendix: source

Thrown at src/java/org/apache/cassandra/auth/FunctionResource.java:159

    {
        return new FunctionResource(function.name().keyspace, function.name().name, function.argTypes());
    }

    /**
     * Creates a FunctionResource representing a specific, keyspace-scoped function.
     * This variant is used to create an instance during parsing of a CQL statement.
     * It includes transposition of the arg types from CQL types to AbstractType
     * implementations
     *
     * @param keyspace the keyspace in which the function is scoped
     * @param name     name of the function.
     * @param argTypes the types of the function arguments in raw CQL form
     * @return FunctionResource instance reresenting the function.
     */
    public static FunctionResource functionFromCql(String keyspace, String name, List<CQL3Type.Raw> argTypes)
    {
        if (keyspace == null)
            throw new InvalidRequestException("In this context function name must be " +
                                              "explictly qualified by a keyspace");
        List<AbstractType<?>> abstractTypes = new ArrayList<>(argTypes.size());
        for (CQL3Type.Raw cqlType : argTypes)
            abstractTypes.add(cqlType.prepare(keyspace).getType().udfType());

        return new FunctionResource(keyspace, name, abstractTypes);
    }

    public static FunctionResource functionFromCql(FunctionName name, List<CQL3Type.Raw> argTypes)
    {
        return functionFromCql(name.keyspace, name.name, argTypes);
    }

    /**
     * Parses a resource name into a FunctionResource instance.
     * A valid resource name for function should be in the follow format:
     * functions/KEYSPACE/FUNCTION_NAME[FUNCTION_ARGS]
     * Note that

View on GitHub (pinned to 88fd0f6a0e)