ti fs search-file-content

Searches remote file content, optionally in a layer. The command alias is ti fs grep.

Syntax

ti fs search-file-content
  --pattern <string>
  [--file-system-id <string>]
  [--fs-token <string>]
  [--help]
  [--layer-id <string>]
  [--limit <int32>]
  [--path <string>]
  [--version]

Options

• --pattern <string>: Text query used for full-text and, when configured, semantic search over extracted file content and descriptions. The value is not a regular expression or glob. [required]
• --file-system-id <string>: Select the file system. You can also set TI_FS_FILE_SYSTEM_ID.
• --fs-token <string>: Set the Filesystem token. If omitted, the command uses the TI_FS_TOKEN environment variable. If neither is provided, the command uses the local token stored for the selected Filesystem.
• --help: Display help information.
• --layer-id <string>: Search within a file system layer.
• --limit <int32>: Maximum number of search results; 0 uses the service default.
• --path <string>: File path prefix to be searched. [default: /]
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Search base Filesystem content:

  # Find matching text under a remote directory and limit the result count.
  ti fs search-file-content --file-system-id <file-system-id> --path /workspace --pattern "TODO" --limit 50
  

• Search content in a layer:

  # Inspect uncommitted layer content separately from the base Filesystem.
  ti fs search-file-content --file-system-id <file-system-id> --path /workspace --pattern "deprecated" --layer-id "<layer-id>"
  

Related documentation

• TiDB Cloud Filesystem CLI Command Reference