SEARCH.DESCRIBE - Upstash Documentation

Use SEARCH.DESCRIBE to return metadata about a search index.

The reply reports how the index is defined, the key type and prefixes it covers, and the fields in its schema with their types and options, along with its current state such as the number of indexed documents. It is the way to confirm what an index actually indexes before writing queries against it, and to check whether a schema change was applied.

See Describing an Index for the feature guide.

The command accepts an index name or alias. When an alias is used, the response describes its target and reports the target's index name.

Syntax#

SEARCH.DESCRIBE <name>

Response#

Returns index metadata as alternating field names and values. The response contains:

Field	Description
`name`	The index name.
`type`	The indexed Redis value type: `HASH`, `JSON`, or `STRING`.
`prefixes`	Key prefixes included in the index.
`language`	Stemming language used by `TEXT` fields.
`indexSize`	Current index size in bytes.
`pendingUpdates`	Number of updates waiting to be indexed.
`schema`	Field definitions, including `FROM`, `NOSTEM`, `NOTOKENIZE`, and `FAST` options where present.

[  "name", "products",  "type", "JSON",  "prefixes", ["product:"],  "language", "english",  "indexSize", 1234,  "pendingUpdates", 0,  "schema", [["name", "TEXT"], ["price", "F64", "FAST"]]]

Returns null if the index does not exist.

Examples#

Redis CLI

SEARCH.DESCRIBE products

@upstash/redis

import { Redis } from "@upstash/redis";const redis = Redis.fromEnv();const products = redis.search.index({ name: "products" });const description = await products.describe();

upstash_redis

from upstash_redis import Redisredis = Redis.from_env()products = redis.search.index(name="products")description = products.describe()

ioredis

import IORedis from "ioredis";import { createSearch } from "@upstash/search-ioredis";const redis = new IORedis(process.env.REDIS_URL!);const search = createSearch(redis);const products = search.index({ name: "products" });const description = await products.describe();

node-redis

import { createClient } from "redis";import { createSearch } from "@upstash/search-redis";const client = await createClient({ url: process.env.REDIS_URL })  .on("error", console.error)  .connect();const search = createSearch(client);const products = search.index({ name: "products" });const description = await products.describe();

curl

curl -X POST https://YOUR_ENDPOINT.upstash.io \  -H "Authorization: Bearer $UPSTASH_REDIS_REST_TOKEN" \  -d '["SEARCH.DESCRIBE", "products"]'