t8y2/dbx · error

scheduler job name is required

Error message

scheduler job name is required

What it means

This error is returned by resolveCatalogSchedulerJobName when the scheduler job name argument is empty or only whitespace. The driver refuses to issue a catalog lookup for scheduler jobs without a name, since the resulting query would be meaningless.

Source

Thrown at agents/drivers/xugu/main.go:3254

	if !rows.Next() {
		return result, rows.Err()
	}
	var job xuguSchedulerJobMetadata
	if err := rows.Scan(
		&job.Name, &job.JobType, &job.ParameterCount, &job.Action, &job.BeginTime,
		&job.RepeatInterval, &job.EndTime, &job.Enabled, &job.AutoDrop, &job.Comments,
	); err != nil {
		return nil, err
	}
	result["name"] = job.Name
	result["source"] = renderXuguSchedulerJobDDL(job)
	return result, rows.Err()
}

func (s *server) resolveCatalogSchedulerJobName(name string) (string, error) {
	name = strings.TrimSpace(name)
	if name == "" {
		return "", errors.New("scheduler job name is required")
	}
	candidates, err := s.catalogSchedulerJobNameCandidates(xuguCatalogSchedulerJobNameQuery(name, false))
	if err != nil {
		return "", err
	}
	if len(candidates) == 0 {
		candidates, err = s.catalogSchedulerJobNameCandidates(xuguCatalogSchedulerJobNameQuery(name, true))
		if err != nil {
			return "", err
		}
	}
	for _, candidate := range candidates {
		if candidate == name {
			return candidate, nil
		}
	}
	if len(candidates) == 1 {
		return candidates[0], nil

View on GitHub (pinned to c0390bff16)

Solutions

1. Provide a non-empty scheduler job name before calling the API
2. Trim and validate user input before resolving the job name
3. Check that the identifier field is populated in the request payload

Example fix

// before
name, _ := resolveCatalogSchedulerJobName("")
// after
if strings.TrimSpace(jobName) == "" { return nil }
job, err := resolveCatalogSchedulerJobName(jobName)

if strings.TrimSpace(jobName) == "" {
    return fmt.Errorf("scheduler job name is required")
}

func hasSchedulerJobName(name string) bool {
    return strings.TrimSpace(name) != ""
}

job, err := s.resolveCatalogSchedulerJobName(name)
if err != nil {
    if err.Error() == "scheduler job name is required" {
        return nil, fmt.Errorf("invalid request: %w", err)
    }
    return nil, err
}

When it happens

Trigger: Calling the scheduler-job catalog resolution path with an empty or whitespace-only job name string.

Common situations: An agent passes an empty ParentName/objectName field when requesting scheduler job metadata, or code that strips identifiers ends up with an empty string after trimming.

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

• sequence name is required
• synonym name is required
• sql is required
• completion assistant search is not supported for this reques
• parent_schema is required for Xugu package members

AI-assisted analysis of t8y2/dbx@c0390bff16 (2026-09-05). Data as JSON: /api/errors/9b3e7189949d2c3a. Report an issue: GitHub.