Skip to content

hana-cli Quick Start Guide

Generated from hana-cli v4.202603.2 on 2026-03-17

Install

bash
npm install -g hana-cli

Connect to Your Database

bash
# Interactive connection wizard — prompts for host, port, user, password
hana-cli connect

# Or connect using a BTP service key file
hana-cli connectViaServiceKey

# Verify your connection
hana-cli status

Essential Commands

hana-cli status

Check current database user and connection Aliases: s, whoami

bash
hana-cli status

hana-cli connect

Configure database connection Aliases: c, login

bash
hana-cli connect [user] [password]

hana-cli tables

Find tables in schema Aliases: t, listTables, listtables

bash
hana-cli tables [schema] [table]

hana-cli inspectTable

Inspect table structure and properties Aliases: it, table, insTbl, inspecttable, inspectable

bash
hana-cli inspectTable [schema] [table]

hana-cli views

List views Aliases: v, listViews, listviews

bash
hana-cli views [schema] [view]

hana-cli import

Load data from CSV/Excel Aliases: imp, uploadData, uploaddata

bash
hana-cli import

hana-cli export

Extract table data to file Aliases: exp, downloadData, downloaddata

bash
hana-cli export

hana-cli querySimple

Run simple queries Aliases: qs, querysimple

bash
hana-cli querySimple

hana-cli healthCheck

Perform system health check Aliases: health, h

bash
hana-cli healthCheck

hana-cli schemas

List all schemas Aliases: sch, getSchemas, listSchemas, s

bash
hana-cli schemas [schema]

Common Workflows

Explore a Schema

bash
hana-cli schemas                                    # List schemas
hana-cli tables --schema MY_SCHEMA                  # List tables
hana-cli inspectTable --table MY_TABLE --schema MY_SCHEMA  # Column details

Import Data

bash
hana-cli import --filename data.csv --table MY_TABLE --schema MY_SCHEMA --dryRun  # Preview
hana-cli import --filename data.csv --table MY_TABLE --schema MY_SCHEMA           # Execute

Export Data

bash
hana-cli export --table MY_TABLE --schema MY_SCHEMA --filename export.csv

Run a Query

bash
hana-cli querySimple --query "SELECT TOP 10 * FROM MY_SCHEMA.MY_TABLE"

Check System Health

bash
hana-cli healthCheck
hana-cli systemInfo

Getting Help

bash
hana-cli --help         # List all commands
hana-cli <cmd> --help   # Help for specific command
hana-cli interactive    # Interactive menu mode