risingwavelabs/risingwave · error · SinkError::Config

Cannot find ` `, please set it or use JSON or set ` ` to

Error message

Cannot find `{LAT_NAME}`, please set it or use JSON or set `{REDIS_VALUE_TYPE}` to `{REDIS_VALUE_TYPE_STRING}`

What it means

A Redis geospatial sink (template encoding, redis_value_type='geospatial') requires the `latitude` option naming the column that holds latitude. RedisSink::validate raises this SinkError::Config when `latitude` is missing, suggesting setting it, using JSON encoding, or switching to the string value type.

Solutions

  1. Add `latitude = '<column_name>'` to the sink options
  2. Or change redis_value_type to 'string' if GEO semantics are not needed
  3. Or use a JSON encoding which does not require this option

Example fix

-- before
... encode template (redis_value_type = 'geospatial', key_format = 'geo::{pk}', longitude = 'lon', member = 'm')
-- after
... encode template (redis_value_type = 'geospatial', key_format = 'geo::{pk}', longitude = 'lon', latitude = 'lat', member = 'm')
Defensive patterns

Strategy: validation

Validate before calling

-- for redis_value_type='geospatial', verify latitude option present and column exists:
-- options.contains_key("latitude") && schema.contains(options["latitude"])

Try / catch

match result.err() { Some(e) if e.contains("latitude") => add_option("latitude", numeric_column), _ => propagate(result) }

Prevention

When it happens

Trigger: CREATE SINK with encode template, redis_value_type = 'geospatial', with key_format and longitude set but no `latitude = '<column>'` option (src/connector/src/sink/redis.rs:379-383).

Common situations: GEO sink configs that specify longitude/member but omit latitude; typos like `lat`; assuming longitude alone suffices for GEOADD.

Understand the failure class

Background: "is required", "must be set", "missing required field": configuration validation errors across open-source libraries — this error's family across 36 libraries.

Related errors


AI-assisted analysis of risingwavelabs/risingwave@6469eb736d (2026-09-11). Data as JSON: /api/errors/c99576873931a353. Report an issue: GitHub.

Appendix: source

Thrown at src/connector/src/sink/redis.rs:380

                            ))
                        })?;
                    TemplateStringEncoder::check_string_format(value_format, &all_map)?;
                }
                Some(REDIS_VALUE_TYPE_GEO) => {
                    let key_format = self.format_desc.options.get(KEY_FORMAT).ok_or_else(|| {
                        SinkError::Config(anyhow!(
                            "Cannot find '{KEY_FORMAT}', please set it or use JSON"
                        ))
                    })?;
                    TemplateStringEncoder::check_string_format(key_format, &pk_map)?;

                    let lon_name = self.format_desc.options.get(LON_NAME).ok_or_else(|| {
                        SinkError::Config(anyhow!(
                            "Cannot find `{LON_NAME}`, please set it or use JSON or set `{REDIS_VALUE_TYPE}` to `{REDIS_VALUE_TYPE_STRING}`"
                        ))
                    })?;
                    let lat_name = self.format_desc.options.get(LAT_NAME).ok_or_else(|| {
                        SinkError::Config(anyhow!(
                            "Cannot find `{LAT_NAME}`, please set it or use JSON or set `{REDIS_VALUE_TYPE}` to `{REDIS_VALUE_TYPE_STRING}`"
                        ))
                    })?;
                    let member_name = self.format_desc.options.get(MEMBER_NAME).ok_or_else(|| {
                        SinkError::Config(anyhow!(
                            "Cannot find `{MEMBER_NAME}`, please set it or use JSON or set `{REDIS_VALUE_TYPE}` to `{REDIS_VALUE_TYPE_STRING}`"
                        ))
                    })?;
                    if let Some(lon_type) = all_map.get(lon_name)
                        && (lon_type == &DataType::Float64
                            || lon_type == &DataType::Float32
                            || lon_type == &DataType::Varchar)
                    {
                        // do nothing
                    } else {
                        return Err(SinkError::Config(anyhow!(
                            "`{LON_NAME}` must be set to `float64` or `float32` or `varchar`"
                        )));

View on GitHub (pinned to 6469eb736d)