t8y2/dbx · error

Hive connection string must start with jdbc:hive2:// or hive

Error message

Hive connection string must start with jdbc:hive2:// or hive://

What it means

parseHiveConnection only accepts connection strings beginning with the jdbc:hive2:// or hive:// scheme. Any other prefix causes this error. The scheme check is the driver's first validation gate before parsing hosts, parameters, and hive vars.

Source

Thrown at agents/drivers/argo-go/config.go:329

		}
		port := defaultHivePort
		if parsedURL.Port() != "" {
			parsedPort, err := strconv.Atoi(parsedURL.Port())
			if err != nil {
				return parsedHiveConnection{}, fmt.Errorf("invalid Hive port: %w", err)
			}
			port = parsedPort
		}
		result.endpoints = []endpoint{{Host: parsedURL.Hostname(), Port: port}}
		result.database = strings.Trim(parsedURL.Path, "/")
		for key, entries := range parsedURL.Query() {
			if len(entries) > 0 {
				setCaseInsensitive(result.parameters, key, entries[len(entries)-1])
			}
		}
		return result, nil
	} else {
		return parsedHiveConnection{}, errors.New("Hive connection string must start with jdbc:hive2:// or hive://")
	}

	result := newParsedHiveConnection()
	if fragment := strings.IndexByte(value, '#'); fragment >= 0 {
		result.hiveVars = parseHiveAssignments(value[fragment+1:], false)
		value = value[:fragment]
	}
	if query := strings.IndexByte(value, '?'); query >= 0 {
		result.hiveConfs = parseHiveAssignments(value[query+1:], false)
		value = value[:query]
	}
	pathStart := strings.IndexByte(value, '/')
	authority := value
	pathAndParams := ""
	if pathStart >= 0 {
		authority = value[:pathStart]
		pathAndParams = value[pathStart+1:]
	}

View on GitHub (pinned to c0390bff16)

Solutions

1. Prefix the string with jdbc:hive2:// (or hive://), e.g. jdbc:hive2://host:10000/default
2. Fix typos in the scheme (hive2:// or jdbc:hive are not accepted)
3. Validate the connection-string format before passing it to the driver

Example fix

// before
cfg, err := Open("hive2://host:10000")
// after
cfg, err := Open("jdbc:hive2://host:10000")

func validHiveConnString(s string) bool {
    return strings.HasPrefix(s, "jdbc:hive2://") || strings.HasPrefix(s, "hive://")
}

parsed, err := parseHiveConnection(value)
if err != nil {
    return fmt.Errorf("bad connection string %q: %w", value, err)
}

When it happens

Trigger: Passing a connection string with a wrong scheme (e.g. 'jdbc:hive://', 'hive2://', 'http://', or a bare hostname) to the driver's connection-string parser.

Common situations: Copy-pasting a URL from another driver (Spark/Impala docs); omitting the scheme entirely; mixing up hive2 vs hive:// spelling; trimming code accidentally removing the prefix.

Related errors

• token is empty
• table is required
• SQL is required
• SQL is required
• statements are required

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