DOC-7172 Add cross-client HIMPORT bulk-import examples and API mappings

[andy-stark-redis]

Adds client examples for bulk hash import with HIMPORT (Redis 8.10). Most client libraries now support it, and Jedis has a good example in its own docs, but our docs had no code for it. Part of the DOC-7164 effort to consolidate client library information. Ticket: DOC-7172.

Changes

• data-types/hashes.md: the "Bulk import with HIMPORT" section gets two tabbed code examples:

  • himport_basic: declare the field names once, import three users, and read one back.
  • himport_pipeline: import 1,000 users in one pipeline.

  New prose between them covers four points:

  • an import replaces an existing key;
  • HGETALL field order isn't guaranteed;
  • clients declare fieldsets on each connection for you, and most mark the API experimental;
  • send large imports in a pipeline (links to the pipelining page).

• Tabs: redis-py, node-redis, ioredis, go-redis, Jedis, Lettuce (sync, async, reactive), StackExchange.Redis (sync, async), Predis, and redis-rb. There's no Rust tab, because redis-rs has no HIMPORT support. phpredis support is unreleased.

• API mapping: new files for HIMPORT PREPARE/SET/DISCARD/DISCARDALL, read from source at each client's first HIMPORT release, plus the regenerated merged file. Jedis, Lettuce and SE.Redis appear only under SET, because they have no prepare or discard methods.

Notes for reviewers

• The tabs don't all look alike, on purpose. Jedis, Lettuce and SE.Redis use a fieldset object instead of a PREPARE call. ioredis declares fieldsets in its constructor, so that call is visible in each step. Predis and redis-rb send PREPARE inside the pipeline, as their READMEs recommend.
• Lettuce sync has no pipeline API, so its pipeline step is a plain loop, with a comment pointing to the async or reactive API.
• HGETALL order: Redis 8.10.1 returns age, name, email, not the declared order. The output comments show what each client actually prints.
• Upstream doc issues, not filed:
  • The Lettuce HashImport javadoc says try-with-resources is safe for reactive. It isn't if you subscribe after the block closes; the example avoids this.
  • SE.Redis docs/HImport.md still has a buffer-reuse caveat that 3.2.0 made unnecessary.

Testing

• Run against Redis 8.10.1: every file passed, using each client's first HIMPORT release: redis-py 8.1.0, node-redis 6.2.0, ioredis 6.0.0, go-redis 9.22.0, Jedis 8.0.0, Lettuce 7.7.0, SE.Redis 3.3.1 and 3.0.25, Predis 3.6.0, and redis-rb 6.0.0.
  • The shared harness's client pins predate HIMPORT, so each client was tested in an isolated scratch project with its own Redis container, not with run.sh. Raising those pins is a follow-up.
• Codex review: each file was reviewed separately. The one high finding, a misleading Lettuce sync comment, was fixed and re-reviewed clean.
• Site build: build/make.py and hugo both build cleanly. Every tab renders both steps, no test scaffolding shows, and API methods appear on all four HIMPORT subcommand pages.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and generated API metadata only; no runtime or server behavior changes.

Overview
Adds cross-client documentation for bulk hash import with HIMPORT in the compact-hashes section of hashes.md.

The Bulk import with HIMPORT section now includes two tabbed clients-example steps (himport_basic, himport_pipeline) plus prose on replace semantics, non-guaranteed HGETALL order, per-connection fieldsets, experimental APIs, and pipelining for large loads.

New local_examples/hash_import samples cover redis-py, node-redis, ioredis, go-redis, Jedis, Lettuce (sync/async/reactive), StackExchange.Redis (sync/async), Predis, and redis-rb, reflecting client-specific patterns (fieldset objects vs PREPARE, ioredis constructor config, PREPARE inside pipelines where needed).

Command API mapping adds entries for HIMPORT PREPARE, SET, DISCARD, and DISCARDALL (per-command JSON files and the merged command-api-mapping.json), with Jedis/Lettuce/SE.Redis mapped mainly on SET.

^{Reviewed by Cursor Bugbot for commit 72b1c08. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

DOC-7172

[github-actions]

🧠 Redis Memory

Found 5 related items from repository history (5 new this commit):

• PR — DOC-7170 Add compare-and-swap/compare-and-delete example to the strings page 🆕

  Adds a compare-and-swap / compare-and-delete example (Redis 8.4 SET ... IFEQ and DELEX ... IFEQ) to the strings data type page, and refr

• PR — DOC-7171 Add cross-client HOTKEYS example, API mapping, and produsage links 🆕

  Adds client examples for the HOTKEYS command family (Redis 8.6+), so this information isn't spread across client-specific sites such as [s

• PR — DOC-7032: Add tested client examples for JSONPath filter operators 🆕

  Summary

• PR — DOC-6887 Add hash field expiration examples to hash data type page 🆕

  What

• PR — DOC-7015 Stop HSCAN/HVALS examples depending on hash field order 🆕

  DOC-7015

Memory updated at 72b1c08

[github-actions]

Staging links:
https://redis.io/docs/staging/DOC-7172/develop/data-types/hashes/