Opening tables
Access the table viewer from the schema explorer:- Navigate to Table Viewer in the sidebar
- Expand your server and database in the tree
- Click any table name to open it
The currently selected table is highlighted in the tree, making it easy to see what you’re viewing.
Viewing data
The table viewer displays your data in a grid with:- Column headers: Clickable headers showing column names and data types
- Row data: All column values for each row
- Pagination controls: Navigate through large datasets
- Row counter: Total number of rows in the table
Virtual rendering
For tables with thousands of rows, Poge uses virtual rendering (components/virtual-table.tsx) to:
- Render only visible rows
- Maintain smooth scrolling performance
- Handle datasets of any size
Pagination
Tables are loaded in pages to optimize performance:- Default page size: 100 rows
- Page size options: 50, 100, 200, 500 rows per page
- Navigation: Previous, Next, First, Last page buttons
- Page counter: Shows current page and total pages
Table schema
View the table’s structure by clicking the Schema tab or button:Column information
For each column, the schema shows:- Column name: The column identifier
- Data type: PostgreSQL data type (varchar, integer, timestamp, etc.)
- Nullable: Whether the column accepts NULL values
- Default value: Default value for new rows
- Primary key: Whether this column is part of the primary key
Indexes
View all indexes on the table:- Index name: Unique identifier for the index
- Columns: Which columns are included
- Type: Index type (btree, hash, gin, gist)
- Unique: Whether the index enforces uniqueness
Constraints
See all table constraints:- Primary keys: Unique row identifiers
- Foreign keys: References to other tables
- Unique constraints: Enforce unique values
- Check constraints: Validation rules
Editing data
To edit a cell:- Click the cell to select it
- Type the new value
- Press Enter to confirm or Escape to cancel
Adding rows
Add new rows to the table:- Click the Add Row button in the toolbar
- Fill in values for each column
- Click Save to insert the row
Columns with default values or auto-increment (SERIAL) don’t need to be filled in.
Deleting rows
Delete one or more rows:- Select rows using the checkboxes
- Click the Delete Selected button
- Confirm the deletion in the dialog
Exporting data
Export table data in multiple formats:- CSV
- JSON
- Excel
Export as comma-separated values:
- Click Export → CSV
- Choose to include headers (recommended)
- File downloads automatically
Large exports (>10,000 rows) may take a few seconds to generate. The browser will show a progress indicator.
Filtering and sorting
Sorting
Click any column header to sort by that column:- First click: Sort ascending
- Second click: Sort descending
- Third click: Remove sorting
Filtering
Filter rows by column values:- Click the Filter icon in the column header
- Enter your filter criteria
- Press Enter to apply
- Equals: Exact match
- Contains: Partial match (case-insensitive)
- Starts with: Value begins with text
- Ends with: Value ends with text
- Greater than / Less than: Numeric and date comparisons
Multiple filters can be combined. All conditions must be met for a row to be displayed (AND logic).
Table operations
Rename table
- Right-click the table name in the schema tree
- Select Rename
- Enter the new name
- Click Rename
Edit table structure
Open the table designer to modify:- Add/remove columns
- Change column types
- Add/remove indexes
- Modify constraints
Drop table
- Right-click the table name
- Select Drop Table
- Confirm by typing the table name
- Click Drop Table
Performance tips
Large tables
For tables with millions of rows:- Use pagination instead of loading all rows
- Apply filters to reduce the result set
- Create indexes on frequently queried columns
- Export in smaller batches
Virtual scrolling
The virtual table component renders only visible rows, so:- Scrolling remains smooth even with large page sizes
- Memory usage is optimized
- Initial load time is fast
Keyboard navigation
Navigate the table using keyboard shortcuts:| Action | Key |
|---|---|
| Move right | → or Tab |
| Move left | ← or Shift + Tab |
| Move down | ↓ |
| Move up | ↑ |
| Edit cell | Enter or F2 |
| Cancel edit | Escape |
| Save edit | Enter |
| Select all | Ctrl/Cmd + A |