hasura/graphql-engine · error

unsupported source kind, source name: %v kind: %v

Error message

unsupported source kind, source name: %v kind: %v

What it means

HasuraDB driver Run() dispatches on the source kind (e.g. postgres, mssql, bigquery) and returns this error when the configured source kind is not one it knows how to execute SQL against.

Source

Thrown at cli/migrate/database/hasuradb/hasuradb.go:367

			if err != nil {
				return errors.E(op, err)
			}
		case hasura.SourceKindBigQuery:
			if noTransaction {
				h.logger.Warn(
					"no-transaction is not supported for BigQuery sources; the migration will run inside a transaction",
				)
			}

			_, err := h.bigquerySourceOps.BigQueryRunSQL(hasura.BigQueryRunSQLInput(sqlInput))
			if err != nil {
				return err
			}

		default:
			return errors.E(
				op,
				fmt.Errorf(
					"unsupported source kind, source name: %v kind: %v",
					h.hasuraOpts.SourceName,
					h.hasuraOpts.SourceKind,
				),
			)
		}
	case "meta":
		var metadataRequests []any

		err := json.Unmarshal(migr, &metadataRequests)
		if err != nil {
			h.migrationQuery.ResetArgs()

			return errors.E(op, err)
		}

		err = sendMetadataMigrations(h, metadataRequests)
		if err != nil {

View on GitHub (pinned to 724551b9ae)

Solutions

1. Upgrade the CLI to a version that supports your source kind
2. Run migrations against a supported source kind (typically postgres)
3. Check config.yaml / source settings for the correct source kind string

switch sourceKind {
case "postgres", "mssql", "bigquery":
default:
    return fmt.Errorf("cannot run migrations against source kind %q", sourceKind)
}

When it happens

Trigger: Executing a migration/data API call via the hasuradb driver while hasuraOpts.SourceKind is set to a kind the Run switch does not handle (anything beyond the supported kinds).

Common situations: Adding a new or exotic source kind (e.g. ClickHouse, Citus) to a Hasura instance while using a CLI version whose migrate driver does not support it.

Related errors

• unable to marshal run_sql args in %s: %w
• unable to unmarshal run_sql args in %s: %w
• seed operations on database '%s' of kind '%s' is not support
• creating Version table failed %s
• cannot create migration: %w

AI-assisted analysis of hasura/graphql-engine@724551b9ae (2026-08-28). Data as JSON: /api/errors/5dec30e1b2c06981. Report an issue: GitHub.