weaviate/weaviate · error

load concept %q

Error message

load concept %q

What it means

This error wraps a failure from the extensions key-value storage's Get call when the text2vec-contextionary module tries to load a single stored concept (extension) by key. It is thrown by the module's UseCase.Load, which reads the concept bytes from the configured extension storage provider. The original storage error (I/O, bucket not found, etc.) is preserved via errors.Wrapf with the concept name included.

Source

Thrown at modules/text2vec-contextionary/extensions/usecase.go:44

func NewUseCase(storage moduletools.Storage) *UseCase {
	return &UseCase{
		storage: storage,
	}
}

func (uc *UseCase) Store(concept string, value []byte) error {
	err := uc.storage.Put([]byte(concept), value)
	if err != nil {
		return errors.Wrapf(err, "store concept %q", concept)
	}

	return nil
}

func (uc *UseCase) Load(concept string) ([]byte, error) {
	val, err := uc.storage.Get([]byte(concept))
	if err != nil {
		return nil, errors.Wrapf(err, "load concept %q", concept)
	}

	return val, nil
}

func (uc *UseCase) LoadAll() ([]byte, error) {
	buf := bytes.NewBuffer(nil)
	err := uc.storage.Scan(func(k, v []byte) (bool, error) {
		_, err := buf.Write(v)
		if err != nil {
			return false, errors.Wrapf(err, "write concept %q", string(k))
		}

		_, err = buf.Write([]byte("\n"))
		if err != nil {
			return false, errors.Wrap(err, "write newline separator")
		}

View on GitHub (pinned to 75aa4b6d11)

Solutions

1. Check the wrapped root cause error for the real storage failure (disk, permissions, closed bucket)
2. Verify the Weaviate data directory (where extensions persist) is readable and not corrupted
3. Restart Weaviate to reopen the extensions storage cleanly
4. If extensions storage is persistently corrupted, restore from backup or clear and re-create the stored extensions

// Go: no pre-call validation available for storage health; verify store opened earlier
if uc.storage == nil {
    return fmt.Errorf("extensions storage not initialized")
}

val, err := uc.Load(concept)
if err != nil {
    var root error
    errors.As(err, &root)
    logger.Warnf("concept load failed: %v", err) // handle root storage cause
}

When it happens

Trigger: Calling uc.Load(concept) when the underlying storage bucket is unavailable/corrupted, the storage provider fails on Get (disk I/O error, closed store), or the concept key cannot be read from the extensions bucket.

Common situations: Disk or state directory issues after a crash while extensions storage is being read; corrupted or manually edited extension files; requesting Load during module shutdown when the store is already closed.

Related errors

• load all concepts
• store concept %q
• write concept %q
• write newline separator
• init extensions

AI-assisted analysis of weaviate/weaviate@75aa4b6d11 (2026-09-04). Data as JSON: /api/errors/af8cedb8469d13ab. Report an issue: GitHub.