hana-cli/docs/02-commands/system-admin/recommendations.md

HANA Developer Command Line Interface

# recommendations

> Command: `recommendations`  
> Category: **System Admin**  
> Status: Production Ready

## Description

Generate AI-based performance recommendations for SAP HANA database optimization. This command analyzes various database aspects including indexes, queries, cache, tables, locks, and memory to provide actionable improvement suggestions.

## Syntax

```bash
hana-cli recommendations [options]
```

## Aliases

- `rec`
- `recommend`

## Command Diagram

```mermaid
graph TD
    Start([hana-cli recommendations]) --> Connect[Connect to Database]
    Connect --> Category{Category Type}
    
    Category -->|indexes| IndexAnalysis[Analyze Index Usage<br/>Recommend Optimization]
    Category -->|queries| QueryAnalysis[Analyze Query Performance<br/>Suggest Improvements]
    Category -->|cache| CacheAnalysis[Analyze Cache Efficiency<br/>Recommend Cache Settings]
    Category -->|tables| TableAnalysis[Analyze Table Structure<br/>Suggest Partitioning]
    Category -->|locks| LockAnalysis[Analyze Locking Issues<br/>Recommend Resolution]
    Category -->|memory| MemoryAnalysis[Analyze Memory Usage<br/>Suggest Optimization]
    Category -->|all| AllAnalysis[Run All Analyses<br/>Comprehensive Report]
    
    IndexAnalysis --> Aggregate
    QueryAnalysis --> Aggregate
    CacheAnalysis --> Aggregate
    TableAnalysis --> Aggregate
    LockAnalysis --> Aggregate
    MemoryAnalysis --> Aggregate
    AllAnalysis --> Aggregate
    
    Aggregate[Generate<br/>Recommendations] --> ApplyLimit[Apply Result Limit]
    ApplyLimit --> Display[Display Recommendations<br/>with Priority]
    
    Display --> Complete([Command Complete])
    
    style Start fill:#0092d1
    style Complete fill:#2ecc71
    style Category fill:#f39c12
```

## Parameters

### Options

| Option       | Alias | Type   | Default | Description                                                                                           |
|--------------|-------|--------|---------|-------------------------------------------------------------------------------------------------------|
| `--category` | `-c`  | string | `all`   | Recommendation category. Choices: `all`, `indexes`, `queries`, `cache`, `tables`, `locks`, `memory`  |
| `--limit`    | `-l`  | number | `50`    | Maximum number of recommendations to return                                                           |

### Connection Parameters

| Option    | Alias | Type    | Default | Description                                          |
|-----------|-------|---------|---------|------------------------------------------------------|
| `--admin` | `-a`  | boolean | `false` | Connect via admin (default-env-admin.json)           |
| `--conn`  | -     | string  | -       | Connection filename to override default-env.json     |

### Troubleshooting

| Option              | Alias     | Type    | Default | Description                                                                                              |
|---------------------|-----------|---------|---------|----------------------------------------------------------------------------------------------------------|
| `--disableVerbose`  | `--quiet` | boolean | `false` | Disable verbose output - removes all extra output that is only helpful to human readable interface       |
| `--debug`           | `-d`      | boolean | `false` | Debug hana-cli itself by adding output of LOTS of intermediate details                                   |

## Examples

### All Recommendations

```bash
hana-cli recommendations --category all
```

Generate comprehensive recommendations across all categories.

### Index Recommendations

```bash
hana-cli recommendations --category indexes --limit 25
```

Get top 25 index optimization recommendations.

### Query Performance

```bash
hana-cli recommendations --category queries --limit 10
```

Analyze query performance and get top 10 improvement suggestions.

## Related Commands

See the [Commands Reference](../all-commands.md) for other commands in this category.

## See Also

- [Category: System Admin](..)
- [healthCheck](./health-check.md) - Comprehensive health assessment
- [diagnose](./diagnose.md) - System diagnostics
- [All Commands A-Z](../all-commands.md)