hana-cli/docs/02-commands/object-inspection/tables-p-g.md

HANA Developer Command Line Interface

# tablesPG

> Command: `tablesPG`  
> Category: **Object Inspection**  
> Status: Production Ready

## Description

Get a list of all tables from PostgreSQL

## Syntax

```bash
hana-cli tablesPG [schema] [table] [options]
```

## Aliases

- `tablespg`
- `tablespostgres`
- `tablesPostgres`
- `tables-postgres`
- `tables-postgressql`
- `tablesPOSTGRES`

## Command Diagram

```mermaid
graph TD
    Start([hana-cli tablesPG]) --> Inputs{Inputs}
    Inputs --> Schema[Schema<br/>default **CURRENT_SCHEMA**]
    Inputs --> Table[Table pattern<br/>default *]
    Inputs --> Profile[Profile<br/>default pg]
    Inputs --> Limit[Limit<br/>default 200]
    Schema --> Query[List tables via postgres profile]
    Table --> Query
    Profile --> Query
    Limit --> Query
    Query --> Output[Render results table]
    Output --> Done([Command Complete])

    style Start fill:#0092d1
    style Done fill:#2ecc71
    style Inputs fill:#f39c12
```

## Parameters

### Positional Arguments

| Parameter | Type | Description |
|---|---|---|
| `schema` | string | Schema name filter (optional positional input). |
| `table` | string | Table name filter (optional positional input). |

### Options

| Option | Alias | Type | Default | Description |
|---|---|---|---|---|
| `--table` | `-t` | string | `*` | PostgreSQL table name pattern to match. |
| `--schema` | `-s` | string | `**CURRENT_SCHEMA**` | Schema name or pattern to match. |
| `--profile` | `-p` | string | `pg` | Profile used to route execution to PostgreSQL mode. |
| `--limit` | `-l` | number | `200` | Maximum number of rows returned. |

For additional shared options from the common command builder, use `hana-cli tablesPG --help`.

## Examples

### Basic Usage

```bash
hana-cli tablesPG --table * --schema MYSCHEMA
```

List PostgreSQL tables matching schema and table filters.

## Related Commands

- [`tables`](tables.md)
- [`tablesSQLite`](tables-s-q-lite.md)

## See Also

- [Category: Object Inspection](..)
- [All Commands A-Z](../all-commands.md)