> ## Documentation Index
> Fetch the complete documentation index at: https://flextable-docs-oracle-client-choice.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Connect to a database and run your first query in a few minutes.

This takes you from a fresh install to your first query. It assumes FlexTable is [installed](/installation).

<Tip>**No database handy?** On the Home screen, click **Try a sample database** to open a ready-made SQLite database with example data, so you can explore browsing, queries, and charts without connecting to anything of your own. Skip straight to step 2.</Tip>

<Steps>
  <Step title="Create a connection">
    Click **+ New Connection** at the top of the sidebar, choose a database type (for example **PostgreSQL**), and fill in the host, port, database, username, and password. For **SQLite**, just pick the `.db` file.

    Click **Test** to verify, then **Save**.

    <img src="https://mintcdn.com/flextable-docs-oracle-client-choice/tHXEy7Wr6vLxVTOF/images/01-getting-started/new-connection.png?fit=max&auto=format&n=tHXEy7Wr6vLxVTOF&q=85&s=fb59c628bfbc972f4eb33ca7528b89a0" alt="New connection dialog" width="675" height="516" data-path="images/01-getting-started/new-connection.png" />

    <Tip>A green **Connected** badge means the credentials and network are good. Fix any issue here before you save. Full per-engine details are in [Connect to a database](/connecting).</Tip>
  </Step>

  <Step title="Open a table">
    In the sidebar, expand your connection, expand a database, and click a **table**. It opens as a tab and rows load into the grid.

    <img src="https://mintcdn.com/flextable-docs-oracle-client-choice/tHXEy7Wr6vLxVTOF/images/01-getting-started/first-table.png?fit=max&auto=format&n=tHXEy7Wr6vLxVTOF&q=85&s=38df9f1dcddf6fb89a11d6d135295a9c" alt="Table in the grid" width="1489" height="854" data-path="images/01-getting-started/first-table.png" />

    <Tip>Even million-row tables scroll smoothly, so large data feels as fast as small.</Tip>
  </Step>

  <Step title="Run a query">
    Click **+** in the tab bar and choose **New Query**. Type a statement (autocomplete suggests tables and columns as you type):

    ```sql theme={null}
    SELECT * FROM users WHERE created_at > '2024-01-01' LIMIT 100;
    ```

    Press **Cmd/Ctrl + Enter** to run. Results appear in the grid below.

    <img src="https://mintcdn.com/flextable-docs-oracle-client-choice/tHXEy7Wr6vLxVTOF/images/04-query-editor/editor.png?fit=max&auto=format&n=tHXEy7Wr6vLxVTOF&q=85&s=bb16345a1124bc42ca8ef80ebf10cdb7" alt="Query editor with results" width="1496" height="858" data-path="images/04-query-editor/editor.png" />
  </Step>

  <Step title="Visualize (optional)">
    Switch the result from **Table** to **Chart** to see it as a bar, line, or pie chart.
  </Step>
</Steps>

## Where to next

<CardGroup cols={2}>
  <Card title="Connect to a database" icon="plug" href="/connecting">Per-engine connection details.</Card>
  <Card title="Browse and edit data" icon="table" href="/browse-and-edit">Filter, sort, inspect, and edit rows.</Card>
  <Card title="Query editor" icon="terminal" href="/query-editor">Autocomplete, results, export, charts.</Card>
  <Card title="Import and export" icon="arrow-right-arrow-left" href="/import-and-export">Move data in and out.</Card>
</CardGroup>
