diff --git a/developers/url-scheme.mdx b/developers/url-scheme.mdx index 72e89ea0..c90cf791 100644 --- a/developers/url-scheme.mdx +++ b/developers/url-scheme.mdx @@ -19,6 +19,7 @@ Raycast extension with `open()` from `@raycast/api`. | [`integrations/pair?…`](#start-pairing) | The pairing approval sheet | | [`integrations/start-mcp`](#start-the-mcp-server) | Nothing. Starts the MCP server and returns | | [`settings/`](#open-a-settings-pane) | Settings on that pane, or on the last-used pane | +| [`share?token=…`](#open-a-shared-link) | A new query tab with a shared link's SQL, never run | ## Connection IDs are UUIDs @@ -193,6 +194,14 @@ Settings on an older one. Path segments and query items after the id are ignored open "tablepro://settings/mcp" ``` +## Open a shared link + +``` +tablepro://share?token= +``` + +**Open in TablePro** on a [shared link](/features/shared-links#open-in-tablepro) page sends this URL. The token is the 43 letters and digits at the end of the link. TablePro reads the link, asks for its password if it has one, and opens the SQL in a new query tab without running it. A link that hides its SQL opens nothing. The Linux and Windows apps answer this path too. + ## On iPhone and iPad The iOS app answers two of these paths: `connect/` opens the connection, and diff --git a/docs.json b/docs.json index 34d52a9e..6247cc7f 100644 --- a/docs.json +++ b/docs.json @@ -396,7 +396,8 @@ "features/icloud-sync", "features/handoff", "features/licensing", - "features/team" + "features/team", + "features/shared-links" ] }, { @@ -463,7 +464,8 @@ "group": "TablePro for Windows", "pages": [ "windows/data-grid", - "windows/browsing" + "windows/browsing", + "windows/account" ] } ] diff --git a/features/data-masking.mdx b/features/data-masking.mdx index 1fc72502..29bdefb5 100644 --- a/features/data-masking.mdx +++ b/features/data-masking.mdx @@ -52,6 +52,7 @@ One rule covers every place a value leaves TablePro: - **File > Export**, for every format. - The AI assistant, both the results summary it reads and the queries it runs. - Every [MCP](/features/mcp) tool that returns rows, and AppleScript and Shortcuts results. +- [Shared links](/features/shared-links#sensitive-data), where a column a rule masks cannot be set to **Keep**. - The referenced-row preview of a foreign key, Server Dashboard tiles and the [Routine Debugger](/features/routine-debugger) result grid. A query result has no source table for most engines, so a `table.column` rule matches a query result by its column name alone. `users.ssn` then also masks an `ssn` column a query reads from another table. diff --git a/features/favorites.mdx b/features/favorites.mdx index d7116845..4a8d7544 100644 --- a/features/favorites.mdx +++ b/features/favorites.mdx @@ -108,15 +108,11 @@ The cursor lands right after `orders.`, ready for a column name. `;;` means the ## Working with saved queries -Double-click a favorite, or press `Return`, to insert it into the editor. The right-click menu has **Insert in Editor**, **Run in New Tab**, **Copy Query**, **Edit…**, **Show History**, **Share Link…**, **Move to**, and **Delete**. Arrow keys move between rows, typing jumps to a name, and `Delete` asks first. +Double-click a favorite, or press `Return`, to insert it into the editor. The right-click menu has **Insert in Editor**, **Run in New Tab**, **Copy Query**, **Share…**, **Edit…**, **Show History**, **Move to**, and **Delete**. Arrow keys move between rows, typing jumps to a name, and `Delete` asks first. -Folders come from the same background menu. A folder's own menu has **New Favorite…**, **New Subfolder**, **Rename**, **Global**, and **Delete Folder**; deleting one moves what was inside up to the parent level. A global folder carries a globe, and **Global** changes that folder alone: the queries inside keep the scope they had, so mark them global too if you want them everywhere. Anything kept in a folder a connection cannot see is listed at that connection's top level, whether it is a global query or a global subfolder. Drag a query or a linked file out of the sidebar to drop its SQL into the editor or another app. - -### Sharing a public link +**Share…** makes a web link to the query's SQL that anyone with the link can open; the connection never goes with it. See [Shared Links](/features/shared-links). -On a Pro license, right-click a saved query and choose **Share Link…**. TablePro creates a public link and copies it to the clipboard. Anyone with the link opens it in a browser, with no TablePro account, and sees the query's name, note, and SQL; **Open in TablePro** on that page loads it straight into the app. - -Only the SQL text is shared, never the connection or its credentials. +Folders come from the same background menu. A folder's own menu has **New Favorite…**, **New Subfolder**, **Rename**, **Global**, and **Delete Folder**; deleting one moves what was inside up to the parent level. A global folder carries a globe, and **Global** changes that folder alone: the queries inside keep the scope they had, so mark them global too if you want them everywhere. Anything kept in a folder a connection cannot see is listed at that connection's top level, whether it is a global query or a global subfolder. Drag a query or a linked file out of the sidebar to drop its SQL into the editor or another app. ## Saved query versions diff --git a/features/licensing.mdx b/features/licensing.mdx index 803f8973..1f4a13b9 100644 --- a/features/licensing.mdx +++ b/features/licensing.mdx @@ -1,34 +1,31 @@ --- title: Licensing -description: Activate and deactivate a license key, what each tier includes, and how offline validation works +description: Sign in to your TablePro account on the Mac, what each plan includes, the 3-device limit, and how the plan works offline --- -You never have to buy TablePro to keep using it, and nothing counts down. A license adds the features in the table, and purchase, renewal, and billing all happen on [tablepro.app](https://tablepro.app/#pricing) rather than in the app. +You never have to buy TablePro to keep using it, and nothing counts down. A plan adds the features in the table. You buy one on [tablepro.app](https://tablepro.app/#pricing), and billing lives in your account at [account.tablepro.app](https://account.tablepro.app), not in the app. ## Tiers -There are two tiers, Pro and Team. Team includes everything in Pro. Starter was the earlier name of Pro, so a Starter license is a Pro license. +There are two paid plans, Pro and Team. Team includes everything in Pro. Starter was the earlier name of Pro, so a Starter license is a Pro license. A seat on a team gives you the team's plan. -| Feature | Required tier | Without a license | +| Feature | Required tier | Without the plan | |---------|---------------|-------------------| -| [iCloud Sync](/features/icloud-sync) | Pro | Dimmed, with a row naming the plan and **Activate License…** | -| [Encrypted connection export](/features/connection-sharing) | Pro | Dimmed, with a row naming the plan and **Activate License…** | +| [iCloud Sync](/features/icloud-sync) | Pro | Dimmed, with a row saying it needs a paid plan | +| [Encrypted connection export](/features/connection-sharing) | Pro | Dimmed, with a row saying it needs a paid plan | | [Environment variables in connection fields](/features/connection-sharing) | Pro | References stay unresolved | -| [Linked Folders](/features/connection-sharing) | Pro | Dimmed, with a row naming the plan and **Activate License…** | -| [Query Insights](/features/query-insights) | Pro | Overlay with **Activate License…** | -| [Result charts](/features/data-grid#chart-mode) | Pro | Overlay with **Activate License…** | +| [Linked Folders](/features/connection-sharing) | Pro | Dimmed, with a row saying it needs a paid plan | +| [Query Insights](/features/query-insights) | Pro | Overlay saying it needs a paid plan | +| [Result charts](/features/data-grid#chart-mode) | Pro | Overlay saying it needs a paid plan | | [Compare & Sync](/features/compare-sync) | Pro | Dialog naming the requirement | | [Data Rewind](/features/change-tracking#restoring-a-save) | Pro | Dialog naming the requirement | +| [Shared links](/features/shared-links#who-can-share) past the Free limits | Pro | Free limits; Pro options carry a **Pro** tag | | [Team Catalog](/features/connection-sharing) | Team | Menu item hidden | | [Team Library](/features/team) | Team | Menu item hidden | -The table describes macOS features. The [Linux beta](/linux/install) uses the same plans and accounts; its [account guide](https://github.com/TableProApp/TablePro/blob/main/linux/README.md#tablepro-account) covers device limits and sign-in. The [iPhone and iPad app](/ios) needs no license. +The table describes macOS features. The [Linux beta](/linux/install) uses the same plans and accounts; its [account guide](https://github.com/TableProApp/TablePro/blob/main/linux/README.md#tablepro-account) covers device limits and sign-in. The Windows preview signs in to the same accounts: see [TablePro account](/windows/account). The [iPhone and iPad app](/ios) needs no plan. -The activation instructions on this page apply to the Mac. - -**Settings > License** lists these features under **Pro Plan** and **Team Plan** and marks each plan your license includes. On a Pro license, **Upgrade Plan** sits beside **Team Plan**. Everything else in the app works. - -The **Activate License…** dialog also links to the pricing page. A license you already hold never gets that offer: every gate says what the top of **Settings > License** says for its state, so an expired license offers **Renew License**, a suspended one says so, and one that has not reached the server in 30 days offers **Try Again**. +Signed out, a row, overlay or dialog offers **Sign In** and **Purchase License**. Signed in to an account without the feature, it offers **Upgrade Plan**, which opens the pricing page. A plan you already hold is never offered for sale: when it could not be checked, the gate says what **Settings > Account** says and offers **Try Again**, and past the [device limit](#devices) it offers **Open Account Settings…**. Everything else in the app works without a plan. ## Buy a license @@ -39,7 +36,7 @@ Choose **Help > Support TablePro**, or click **Support TablePro** under the app A window stating the funding model above a Buy a License button and a Sponsor on GitHub button -Use at work is free too. If TablePro is part of your work, a license is asked for, never required: the AGPL puts no condition on use. Prices, renewals, and invoices live on tablepro.app. Once a license is active, the window keeps only the sponsorship action and the **Support TablePro** links disappear. +Use at work is free too. If TablePro is part of your work, a license is asked for, never required: the AGPL puts no condition on use. Prices live on tablepro.app, and renewals and invoices in your account. Once your plan is active, the window keeps only the sponsorship action and the **Support TablePro** links disappear. ### The ask on the 30th day @@ -53,42 +50,60 @@ On the 30th day you use TablePro without a license, a sheet on the window in use It waits out the first five minutes after launch and any running query, and appears only on a connection, data file, or welcome window. A day counts once TablePro is in use on it, and the count stays on your Mac. -## Activate +## Sign in + +The first launch opens **Sign in to TablePro**, with **Sign In** and **Continue Without Account**. To sign in later: -Open **Settings > License** (`Cmd+,`), paste your license key (`XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`), and click **Activate**. + + + Press `Cmd+,` and choose **Account**. Signed out, the welcome window also shows a **Sign In** link, and every gate carries **Sign In**. + + + A sign-in sheet opens. Sign in, or create an account, there. Signing in by email, type the 6-digit code from the email into the sheet: the link in the email opens your browser instead. + + -Without a license, the welcome window has an **Activate License** link to the same dialog. With one, the link names the license's state whenever the pane would: **License Expiring Soon** and **License Expired** open the renewal page, **Could Not Check This License** opens **Settings > License** and checks again, and **License Suspended** or **License Removed** opens the pane. The field also takes a team invite code, which TablePro tells apart from a key on its own. See [Team Plan](/features/team). + +**Account** shows your name and email, with **Manage Account…**, which opens your account in the browser, and **Sign Out**. + - - A license pane listing email, a masked key, plan and expiry above a list of activated Macs - A license pane listing email, a masked key, plan and expiry above a list of activated Macs + + Account pane with name and email, a Pro plan row, the Features list, Devices with this Mac marked, and Offline with the machine ID + Account pane with name and email, a Pro plan row, the Features list, Devices with this Mac marked, and Offline with the machine ID -Once active, the pane shows your email, a masked license key, plan, and expiry date or One-time. **Copy Key** puts the full key on the clipboard and marks it so clipboard-history apps skip it; the key itself stays masked on screen. +The rest of the pane: -A license that has expired, been suspended, or gone 30 days without reaching the server says so at the top of the pane, with the one action that state needs. The key field stays available throughout, so a renewal key goes in without deactivating first. +| Section | Shows | +|---|---| +| **Plan** | One row per license: the plan and its cycle, whose it is (Personal, or the team's name), and its status, such as **Renews on**, **Ends on**, **Lifetime** or **Payment problem**. On a plan you pay for, **Billing…** opens its billing in your account. On Free: **You're on Free** with **Upgrade…** | +| **Features** | Every paid feature, marked **Included** or locked | +| **Devices** | The devices signed in to your account. See [Devices](#devices) | +| **Teams** | Each team you belong to, your role, **Seat** or **No seat**, and **Manage…**, which opens the team in your account | +| **Offline** | When the plan was last verified and until when it holds, **Refresh**, the **Machine ID**, **Import Offline File…** and **Use License Key…** | -## Devices +Notices at the top of **Plan** name what needs doing: a failed payment offers **Update Payment Method…**, and a plan that is canceling says when it ends. Seats, invitations and roles are managed in your account; see [Team Plan](/features/team). -A license binds to each Mac it is activated on through a hashed hardware ID. The **Devices** section lists every activated Mac with its app and macOS version, marks the one you are sitting at, and counts them against the limit your plan sets on tablepro.app. +### A license key from an older version -Activating one Mac too many fails with "This license has reached its activation limit. Remove a Mac from your account, then activate again." Click **Manage Macs** under the message to open [tablepro.app/account/machines](https://tablepro.app/account/machines), sign in with the email on your license if asked, click **Remove…** beside a Mac, then click **Activate** again. On a Mac that already holds the license, **Release…** on a row in **Devices** frees a seat too, including a Mac you no longer have. A Mac you remove or release keeps working until its next check, within 7 days, and paid features pause there. +A key saved by an older version of TablePro signs the Mac in on its own, to the account the key belongs to, the first time the new version reaches the server. To use a key by hand, click **Use License Key…** under **Offline**, paste it (`XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`) and click **Use Key**. On a Mac already signed in, the sheet says which account the key replaces. A key is deleted from the Mac once it is used. -On a Team license only your own Mac carries **Release…**, because releasing a teammate's seat belongs to whoever manages the team. Seats there are handled at [tablepro.app/account](https://tablepro.app/account); see [Team Plan](/features/team). +## Devices -Deactivating with the license server unreachable still removes the license from that Mac, but the slot may stay occupied until it expires on the server. +A plan works on up to 3 devices at a time: Macs, Linux and Windows computers counted together. A Free account has no device limit. **Devices** lists every device signed in to your account, this Mac first and marked **This Mac**, with its system and when it was last seen. -## Validation and offline use +**Remove** beside a device signs TablePro out there at its next check, and its paid features run until its last check expires. This Mac has no **Remove**, and neither does a device whose offline file has not expired; it shows until when instead. -Activation stores a signed license on your Mac, and the license key goes to the macOS Keychain. +Signing in on a fourth device keeps it on Free and says "Your plan is in use on 3 other devices." Click **Choose a Device…** to list the 3, then **Remove** one, and this Mac takes its place. **Manage Devices…** in the same sheet opens the list in your account. Until you remove one, **Plan** shows **Device limit reached**. + +## Validation and offline use -- Every launch re-verifies the signature offline, with no network. Tier, status, and expiry all come from the signed license, so editing the copy on disk changes nothing. -- Every 7 days the app re-validates with the license server in the background. -- If the server is unreachable, the license keeps working for 30 days after the last successful validation. After that the pane says **Could Not Check This License** and offers **Try Again**, and paid features pause until a validation succeeds. Nothing in that state asks for a license key: the way out is a working connection. -- If the server answers that the license is suspended, expired, or no longer activated on this Mac, paid features pause at that check. The 30-day grace period only covers a server TablePro could not reach. +Your plan reaches the Mac as a signed file, valid for up to 14 days and never past the end of the license. The signature is checked on your Mac, with no network, so editing the file changes nothing. -**Refresh** in **Settings > License** re-validates with the server and reloads the device list, and a gated screen or row offers **Try Again**. When a check cannot reach the server, the reason shows under the button and stays until a check succeeds. Inside the last week before expiry, the pane carries a renewal notice linking to tablepro.app. +- The plan is refreshed at launch, then 24 hours after a check that worked, or 1 hour after one that failed. **Refresh** under **Offline** checks now. A plan changed in your account shows at the next check. +- Without a network, paid features keep working until the file expires. With 3 days left, **Plan** says **Verify your plan soon**. Once it expires, it says **Your plan could not be verified** and paid features pause until a check succeeds. Both offer **Try Again**. +- A Mac that never reaches the internet uses an offline file. Copy the **Machine ID** under **Offline**, create an offline file for it in your account, then click **Import Offline File…**. A file is valid until the end of the paid period, or for one year on a lifetime license, and its device keeps its slot until it expires. ## What syncs -Devices never sync. Each Mac takes its own seat, and a license restored from another Mac's backup is cleared on launch. Team seats, invites, and member roles are managed on tablepro.app; see [Team Plan](/features/team). +Nothing about the account syncs. Account tokens stay on the Mac that signed in and are never in iCloud Keychain, so each Mac signs in on its own and counts as its own device. diff --git a/features/shared-links.mdx b/features/shared-links.mdx new file mode 100644 index 00000000..854e9261 --- /dev/null +++ b/features/shared-links.mdx @@ -0,0 +1,207 @@ +--- +title: Shared Links +description: Share a query or a result as a web link from the Mac, Linux and Windows apps, mask its sensitive columns, and manage, open and report links +--- + +A shared link is a copy taken when you share: the SQL, and for a result the rows as the grid showed them at that moment. Anyone who has the link reads it in a web browser, with no account and no TablePro. + +## Who can share + +Sharing needs a TablePro account with a verified email address. Sign in under **Settings > Account** on the Mac, **Preferences > Account** on Linux, or [Settings > Account](/windows/account) on Windows. + +| | Free | Pro | +|---|---|---| +| Live links | 5 | 1,000 | +| Rows in a shared result | The first 1,000 | The first 10,000 | +| Expires after | 1, 7 or 30 days; 30 by default | 1, 7 or 30 days, or never; never by default | +| Password | No | Yes | +| Turn viewer downloads off | No | Yes | +| Team links | No | With a seat on the team, while the team allows public links | + +Pro means a Pro or Team license, a seat on a team included. See [Licensing](/features/licensing). + +A link is live until it expires, you revoke it, or TablePro removes it. A link that expired, was revoked or was removed frees its slot. A [suspended](#link-status) link keeps its slot. Team links count against the team's own limit of 1,000, never against yours. + +On Free, extend a link to 30 days from now at any time, from [your account](#manage-your-links). + +### After Pro ends + +Your links keep working. Once, every live personal link that never expires, or expires more than 30 days later, is set to expire 30 days from then. Passwords stay on the links that have them. A new link waits until fewer than 5 are live. + +## Share from the Mac + +| To share | Do this | +|---|---| +| A result | Right-click the grid and choose **Share Result…**, or choose **File > Share Result…** | +| A query | Right-click in the editor and choose **Share Query…**, or choose **File > Share Query…**. The selection is shared, or the whole editor when nothing is selected | +| A saved query | Right-click it in the [Favorites](/features/favorites#working-with-saved-queries) sidebar and choose **Share…** | + +From a table tab, the link holds the table from its first row, with the tab's filter and sort, up to your plan's row limit, whichever page is on screen. With a [value filter](/features/data-grid#filtering) on, it holds the rows the filter shows. From a query tab whose result stopped before its end, the rows past those loaded are read from the server, up to the limit. A table view that cannot be written as SQL shares its rows only, and the sheet says so. + +On Linux and Windows the commands sit elsewhere: see [Linux](/linux/sql-editor#share-a-query-or-result) and [Windows](/windows/browsing#share-a-result-or-query). + +## The share sheet + + + Share Result sheet with Title, Note, Expires set to Never, Hide SQL off under a personal data notice with a Hide SQL button, Password, Allow viewers to download, and five preview rows with email, phone and display_name masked + Share Result sheet with Title, Note, Expires set to Never, Hide SQL off under a personal data notice with a Hide SQL button, Password, Allow viewers to download, and five preview rows with email, phone and display_name masked + + +Signed out, the sheet offers **Sign In…** and nothing else. With an email address not yet verified, it offers **Open Account**, where you verify it. + +| Field | What it sets | +|---|---| +| **Share as** | Whose link it is: **Personal**, or a team where you hold a seat. Shown only when you hold one | +| **Title** | The page heading. Starts as the tab, saved query or result name | +| **Note** | Optional text under the title | +| **Expires** | When the link stops opening. **Never** needs Pro | +| **Hide SQL** | Results only. The page shows the rows without the query | +| **Password** | Pro. Viewers type it before anything shows | +| **Allow viewers to download** | On by default. Pro can turn it off, which removes the page's export buttons | + +The field labels read the same in all three apps, except **Share As** on Linux. Windows words its buttons in sentence case, such as **Sign in...** and **Open in browser**. + +On Free, **Never**, **Password** and **Allow viewers to download** are dimmed and carry a **Pro** tag. Click the tag to see the plans in your browser. + +Under **Share as**, a team whose public links are off is listed but dimmed, with "Public links are off for this team." Choosing a team makes a [team link](#team-links): the footer and the at-limit list then count that team's links instead of yours. + +For a result, **Rows that will be shared** previews the first 5 rows as they will be sent: the columns the grid shows, in its order, with masks applied and removed columns left out. Under it, **Columns** sets what each column sends, as [Sensitive data](#sensitive-data) explains. A result longer than your plan allows is cut, and the sheet says so: "Shares the first 1,000 of 48,210 rows." The page tells viewers the same. + +A query that looks like it holds a secret, such as an AWS access key, a private key, a JSON Web Token, an API token or a password in a URL, gets a warning naming it. So does a column set to **Keep** whose name looks like `password`, `token`, `secret`, `api_key` or `ssn`. Warnings never stop the share. With **Hide SQL** on, the query's warnings go away, since the page does not show the query. + +The footer counts your links: `Free · 3 of 5 links · first 1,000 rows`, or `Pro · 12 links`. + +Click **Create Link**, or **Share** on Windows. The link goes to the clipboard, and the sheet shows it under **Link copied** with **Copy** and **Open in Browser**. + +### Large results + +A link holds up to 100 columns and about 4.5 MB of values, weighed after masking. + +- With more than 100 columns kept or masked, the first 100 go, and the sheet says "Shares the first 100 columns." Remove columns under **Columns** to choose which go. +- Rows that would take the link past 4.5 MB are cut, and the sheet shows the same "Shares the first … of … rows." note as for your plan's limit. +- A single value over 256 KiB, or a first row over 4.5 MB, stops the share with "This result is too large to share." Mask or remove that column. Windows names the column. + +### At the link limit + +With every slot taken, the sheet lists the live links holding them, oldest first, each with **Revoke**. Revoke one and the form comes back. + +### If the link is not created + +| Message | What to do | +|---|---| +| This result is too large to share. | A value is over 256 KiB, or the first row over 4.5 MB. Mask or remove that column under **Columns**, or select less in the query, and share again | +| Too many links just now. Try again in a moment. | An account makes up to 60 links an hour and 300 a day. Wait, then click **Create Link** again | +| Sharing is turned off for this account. | TablePro turned sharing off for the account. Contact support | +| You appear to be offline. Try again once you're connected. | Check the network, then click **Create Link** again | + +## Sensitive data + +Check **Columns** before every result share. Each shared column is set to one of three choices, applied on your computer: masked values are masked before they leave it, and a removed column is never sent. + +| Choice | The link holds | +|---|---| +| **Keep** | The values as the grid shows them | +| **Mask** | The values under a mask you pick from [Masks](/features/data-masking#masks): Full, Last 4 Characters, Email, Stable Hash or NULL | +| **Remove** | Nothing from that column | + +On the Mac and Windows, **Mask** shows a second menu for the mask. Linux gives each column one menu: **Keep**, **Mask as Full** and each other mask, then **Remove**. + + + Columns list with id on Keep, email on Mask and Email and phone on Mask and Last 4 Characters masked by the connection's rules, display_name on Mask and Full, notes on Remove, last_ip on Mask and Stable Hash, and plan on Keep, above 4 columns masked, 1 removed + Columns list with id on Keep, email on Mask and Email and phone on Mask and Last 4 Characters masked by the connection's rules, display_name on Mask and Full, notes on Remove, last_ip on Mask and Stable Hash, and plan on Keep, above 4 columns masked, 1 removed + + +Each column starts from what is known about it: + +| Column | Starts as | Can be set to | +|---|---|---| +| On the Mac, masked by the connection's [masking rules](/features/data-masking) | **Mask**, with the rule's mask | The rule's mask, **Full**, **NULL** or **Remove**. Never **Keep** | +| Looks sensitive, by its name or its values | **Mask**, with the suggested mask | Anything, **Keep** included | +| Anything else | **Keep** | Anything | + +The line under a masked column's name says why: "Looks like: email address", or on Linux "The name looks like personal data" or "Values look like email addresses". On the Mac, "Masked by this connection's rules" marks a rule. On a Mac connection with rules, a column that reads no table column, such as `count(*)`, says "Masked because TablePro cannot tell which table column this comes from." and cannot be set to **Keep**. [Masking for AI and scripts](/features/data-masking#masking-for-ai-and-scripts) lists what counts. + +Under the list, a line counts the result, such as "2 columns masked, 1 removed." After a detection, it adds "TablePro masked columns that look sensitive. Check them before sharing." + +### What looks sensitive + +A column's name is split into words at `_`, `-`, `.`, spaces, capitals and digits, and a term matches one whole word or several joined: `stripe_api_key` and `apiKey` match `api_key`, and `company` does not match `pan`. When a name matches two terms, the one covering more words wins. + +| Looks like | Name terms | Values | Suggested mask | +|---|---|---|---| +| Email address | `email`, `mail` | Half or more are email addresses | Email | +| Phone number | `phone`, `mobile`, `tel`, `telephone`, `fax`, `msisdn` | Half or more are phone numbers | Last 4 Characters | +| Password or secret | `password`, `passwd`, `pwd`, `secret`, `token`, `api_key`, `access_key`, `private_key`, `credential` | One JSON Web Token or API key | Full | +| ID number | `ssn`, `social_security`, `national_id`, `passport`, `tax_id`, `tin` | | Last 4 Characters | +| Card or account number | `credit_card`, `card_number`, `cc_number`, `pan`, `iban`, `account_number`, `routing_number` | One card number that passes the Luhn check, or one valid IBAN | Last 4 Characters | +| Postal address | `address`, `street`, `zip`, `zipcode`, `postcode`, `postal` | | Full | +| Date of birth | `dob`, `birthdate`, `date_of_birth`, `birthday` | | Full | +| IP address | `ip`, `ip_address`, `ipv4`, `ipv6` | Half or more are IP addresses | Stable Hash | +| Person's name | `first_name`, `last_name`, `full_name`, `surname`, `given_name` | | Full | + +Values are read from the rows the link holds, and only in text columns: a number, date, boolean or UUID column is judged by its name alone. A column matched by both its name and its values takes the name's mask. On the Mac, a column a rule already masks is not checked. + +### Personal data in the SQL + +A result whose SQL holds a string literal that looks like an email address, phone number, card number, IBAN, JSON Web Token or API key shows "This query contains what looks like personal data (email address). Turn on Hide SQL to keep the query private." Click its **Hide SQL** button, or turn on **Hide SQL** in the form. The page then shows the rows without the query, though the service still stores it. + +### What viewers see + +A masked column's header on the page carries a **Masked** badge. Hover over it, or tap or click it, to read "Values in this column were masked before sharing." with the mask's name. A removed column does not appear at all. + +## Manage your links + +Choose **File > Manage Shared Links…**, or open [account.tablepro.app/shared-links](https://account.tablepro.app/shared-links). **Shared links** in your account lists every personal link with its kind, status, expiry and view count, and a lock on the ones with a password. The line at the top counts them against your plan, such as `Free · 3 of 5 links`. + +Each live or expired link has a menu: + +- **Copy link** and **Open**, while the link is live. +- **Extend 30 days**, on Free. The new expiry counts from now. +- **Edit…** changes the title, note, expiry, password, downloads, and **Hide SQL** on a result. A password or downloads off still need Pro, and a password a link already has can be removed on Free. +- **Revoke…** stops the link for everyone at once. It cannot be undone. + +Editing the title or note of an expired link leaves it expired. Setting a new expiry makes it live again, if a slot is free. A link is deleted 7 days after it expires or is revoked. + +### Link status + +| Status | Means | +|---|---| +| Live | Opens for anyone with the link | +| Expired | No longer opens. A new expiry in **Edit…** brings it back | +| Revoked | No longer opens, for good | +| Removed | TablePro removed it after a report. The reason shows under the title, and the link cannot be edited or brought back | +| Suspended | Still live, but does not open while sharing is turned off for the account or public links are off for its team. It opens again once that is turned back on | + +### Team links + +A team link is made by choosing the team under **Share as** in the share sheet. A team's **Shared links** page, under the team in your account, lists its team links. Owners and admins see every team link, edit or revoke any of them, and hold the **Allow public links** switch. Turning it off stops new team links, and the team's existing links stop opening, shown as suspended, until it is on again. Nothing is revoked. A member with a seat sees the team links they shared. + +## Open a link + +The page shows the title, note, database type, the day the link was shared and the day it expires. Under them: + +- The query, with **Copy SQL** and **Open in TablePro**. A result shared with **Hide SQL**, or from a table view with no SQL, has neither. +- The result, with a [**Masked** badge](#what-viewers-see) on each masked column, and **Export CSV** and **Export JSON** unless the owner turned downloads off. The rows stay readable on the page either way. + +A result that was cut says "First 1,000 of 48,210 rows", or "First 1,000 rows of a larger result" when its total is not known. + +A link with a password asks for it first. After 10 tries in 15 minutes, the page makes you wait before the next. A link that expired, was revoked or removed, or is suspended shows "This shared link is no longer available". + +**Report this link**, at the bottom of every page, sends a reason, optional details and an optional email address to TablePro. Reasons are illegal content, malware or phishing, personal or private data, spam, copyright infringement, and something else. Staff review each report and remove links that break the rules. + +### Open in TablePro + +**Open in TablePro** puts the SQL in a new query tab, on the connection you are looking at, and never runs it. No connection details travel with a link. Opening one needs no account. + +- A link with a password asks for it in the app. +- A result shared with **Hide SQL** says "This shared result hides its SQL, so there is nothing to open." +- With no connection open, the Mac opens the welcome window and the tab follows the next connection you open. Linux asks you to choose a connection. Windows shows the SQL with **Copy SQL**, and asks you to connect first. + +## What a link sends + +Nothing leaves your computer until you click **Create Link**. Then the service at `api.tablepro.app` stores: + +- The title, note, database type, and the SQL. A result shared with **Hide SQL** still stores the SQL, and only the page leaves it out. +- For a result, the columns the grid shows and the rows up to your plan's limit. Hidden and removed columns stay behind. Masked columns are sent masked, with the name of their mask, so the original values never reach the service. Binary values are sent as their size, such as `(binary, 120 bytes)`. + +Connections, hosts, user names and passwords are never part of a link. The link itself is the only key: anyone who has it can read the page, so treat it like the data it shows. The page asks search engines not to index it, and its browser title never names the link. Network details are in [Privacy](/security/privacy#shared-links). diff --git a/features/team.mdx b/features/team.mdx index 26702069..42ce6175 100644 --- a/features/team.mdx +++ b/features/team.mdx @@ -1,50 +1,57 @@ --- title: Team Plan -description: Share one license across your team, manage seats on the web, and join with an invite code +description: Share one plan across your team, manage members and seats in your account, and join a team from an emailed invitation --- -Buy seats, hand them out from your account at [tablepro.app/account](https://tablepro.app/account), and each person redeems the invite code that arrives by email. One seat covers one Mac, and the app's only part is the redeeming. +Joining a team happens in the browser, from an emailed invitation. The app's part is that you are signed in to the account that accepted it. Members, seats, roles and billing all live in your account at [account.tablepro.app](https://account.tablepro.app). -## Seats +## Roles and seats -A Team license has a fixed number of seats, and each activated Mac takes one. Members carry a role, set and shown on the web only: +| Role | Can | +|------|-----| +| Owner | Everything an admin can, plus billing, transferring ownership and deleting the team. Exactly one per team, and never removed | +| Admin | Change members' roles and seats, invite and remove members, publish to the team library, manage API tokens | +| Member | Use the team's features and library, and leave the team | -| Role | Meaning | -|------|---------| -| Owner | The person who bought the license. Manages members and billing. Cannot be removed. | -| Admin | Invited with the Admin role. | -| Member | A regular seat. | +A seat turns the team's paid features on for one person, on up to 3 of their devices; see [Devices](/features/licensing#devices). Someone in the team without a seat keeps a Free plan unless they have one of their own. The owner does not need a seat. -## Manage your team on the web +## Manage your team -Sign in at [tablepro.app/account](https://tablepro.app/account) with the email on your license, using the one-time link sent to that address. The team panel shows seats used against seats total, and holds the controls to invite a member by email with a role, cancel an invite nobody has accepted, and remove a member. +Sign in at [account.tablepro.app](https://account.tablepro.app) and open the team. **Members** lists who is in it, their role and seat, and the seats taken, such as `3 of 5 seats taken`. Owners and admins work from there: -Removing a member frees the seat on the server at once. Their copy keeps running on its signed license until its next check, at most 7 days later, and paid features pause then. See [Licensing](/features/licensing) for the validation schedule and what each tier includes. +- **Invite member…** sends an invitation to an email address, with a role and, while a seat is free, **Include a seat**. The seat stays reserved until the invitation is accepted or revoked. +- Pending invitations have **Resend invitation**, which sends a new link, and **Revoke invitation…**, which frees a reserved seat. +- Each member's menu has **Change role**, **Give seat** or **Take seat…**, and **Remove member…**. +- The owner adds seats in **Billing**. -## Join a team +A member whose seat is taken, or who is removed, loses the team's features at their app's next check, within a day while online. On a device that stays offline, they last until its plan file expires, at most 14 days. + +In TablePro, **Settings > Account** lists your teams under **Teams**, with your role, **Seat** or **No seat**, and **Manage…**, which opens the team in your account. -You join from the invite email, with no license key of your own. +## Join a team - - Install TablePro, then open **Settings > License** with `Cmd+,`, or click **Activate License** on the welcome window. + + The link in the email opens the invitation in your browser. It works for 7 days, and the page says your role and whether a seat comes with it. - - It goes in the same field as a license key, and TablePro tells the two apart. + + Sign in, then click **Accept invitation**. Any TablePro account can accept, not only the address it was sent to. Signing in with that address creates an account if you have none. - - Click **Activate**. TablePro takes a seat on the team, and from then on your copy validates and renews like any other license. + + Sign in to the same account under **Settings > Account**. The team's features turn on at the next check; **Refresh** under **Offline** checks now. - - License activation sheet accepting a team invite code - License activation sheet accepting a team invite code + +**Teams** in **Settings > Account** lists the team with **Seat**, and **Features** marks the team's features **Included**. + + + + Invitation page naming the team, the invited address, the Member role and a reserved seat, above Accept invitation + Invitation page naming the team, the invited address, the Member role and a reserved seat, above Accept invitation - -An invite code is single use and seats the first Mac that redeems it. To add a second Mac, ask your team owner for another invite. To move your seat, deactivate the old Mac under **Settings > License** and redeem a fresh invite. - +An expired invitation says so; ask an owner or admin to resend it. When every seat is taken and the invitation's seat was taken back, the page says that too, and accepting works once a seat is free. Leave a team from its **Settings** page in your account. The owner cannot leave, only transfer ownership or delete the team. ## Share connections with your team @@ -52,10 +59,10 @@ Two routes, and the choice is whether your team already shares a folder. If it d ### Team Library -Right-click a connection and choose **Share > Publish to Team Library…**, or publish saved queries from the Favorites sidebar with **Publish Saved Queries to Team…**. Only the connection definition and the query text are sent, never passwords, tunnel commands or startup SQL. +Owners and admins publish: right-click a connection and choose **Share > Publish to Team Library…**, or publish saved queries from the Favorites sidebar with **Publish Saved Queries to Team…**. Only the connection definition and the query text are sent, never passwords, tunnel commands or startup SQL. -Teammates get the connections in their list the way a Linked Folder delivers them, and shared queries in their Favorites sidebar labeled with whoever published each one. Their app pulls the library every 7 days, and **Settings > License > Team** shows when it last did, with **Refresh** to pull now. A pull that fails keeps what was there and says **Couldn't refresh the team library** with the reason. A pulled connection arrives without its startup SQL, because it lands with no confirmation step and nothing that would run by itself travels with it. +Everyone with a seat gets the connections in their list the way a Linked Folder delivers them, and shared queries in the Favorites sidebar under **Team Library**, labeled with whoever published each one. The app pulls the library at launch, every 15 minutes and after each publish. A pulled connection arrives without its startup SQL, because it lands with no confirmation step and nothing that would run by itself travels with it. Shared sign-in settings need [approval on each Mac](/connections/connection-form#sign-ins-from-this-mac) before using local cloud credentials or Kerberos tickets. -You review and remove what you published from your account at [tablepro.app/account](https://tablepro.app/account). +The team's **Library** page in your account lists what was published, and owners and admins delete items there. diff --git a/images/account-settings-dark.png b/images/account-settings-dark.png new file mode 100644 index 00000000..743ad30e Binary files /dev/null and b/images/account-settings-dark.png differ diff --git a/images/account-settings.png b/images/account-settings.png new file mode 100644 index 00000000..92ff9476 Binary files /dev/null and b/images/account-settings.png differ diff --git a/images/license-settings-dark.png b/images/license-settings-dark.png deleted file mode 100644 index e3067186..00000000 Binary files a/images/license-settings-dark.png and /dev/null differ diff --git a/images/license-settings.png b/images/license-settings.png deleted file mode 100644 index cc41a27c..00000000 Binary files a/images/license-settings.png and /dev/null differ diff --git a/images/share-sheet-columns-dark.png b/images/share-sheet-columns-dark.png new file mode 100644 index 00000000..2b130ffb Binary files /dev/null and b/images/share-sheet-columns-dark.png differ diff --git a/images/share-sheet-columns.png b/images/share-sheet-columns.png new file mode 100644 index 00000000..f173ec43 Binary files /dev/null and b/images/share-sheet-columns.png differ diff --git a/images/share-sheet-dark.png b/images/share-sheet-dark.png new file mode 100644 index 00000000..9ee2ad13 Binary files /dev/null and b/images/share-sheet-dark.png differ diff --git a/images/share-sheet.png b/images/share-sheet.png new file mode 100644 index 00000000..bc551ab3 Binary files /dev/null and b/images/share-sheet.png differ diff --git a/images/team-invitation-dark.png b/images/team-invitation-dark.png new file mode 100644 index 00000000..7c5248d1 Binary files /dev/null and b/images/team-invitation-dark.png differ diff --git a/images/team-invitation.png b/images/team-invitation.png new file mode 100644 index 00000000..d8ce383e Binary files /dev/null and b/images/team-invitation.png differ diff --git a/images/team-invite-activation-dark.png b/images/team-invite-activation-dark.png deleted file mode 100644 index b7bec5e5..00000000 Binary files a/images/team-invite-activation-dark.png and /dev/null differ diff --git a/images/team-invite-activation.png b/images/team-invite-activation.png deleted file mode 100644 index cc37642b..00000000 Binary files a/images/team-invite-activation.png and /dev/null differ diff --git a/images/windows-account-dark.png b/images/windows-account-dark.png new file mode 100644 index 00000000..2579817c Binary files /dev/null and b/images/windows-account-dark.png differ diff --git a/images/windows-account.png b/images/windows-account.png new file mode 100644 index 00000000..98172998 Binary files /dev/null and b/images/windows-account.png differ diff --git a/linux/sql-editor.mdx b/linux/sql-editor.mdx index bd40e861..e0ea187f 100644 --- a/linux/sql-editor.mdx +++ b/linux/sql-editor.mdx @@ -1,6 +1,6 @@ --- title: SQL editor -description: Run statements and scripts, read several result sets, and write with completion, snippets, multiple cursors and Vim mode in TablePro for Linux +description: Run statements and scripts, read several result sets, write with completion, snippets, multiple cursors and Vim mode, and share queries as links in TablePro for Linux tag: "Beta" --- @@ -88,3 +88,18 @@ On a Redis connection the editor takes Redis commands, one per line, and shows e `Ctrl+Shift+H` opens **Query History**: every run from the editor, with full-text search, filters by connection, time and status, and export as SQL or CSV. A run that can carry a password is left out. **Save Query…** in the editor's menu keeps the text against the connection. **Saved Queries** in the main menu lists them, the window's connection first. + +## Share a query or result + +Sign in to your TablePro account first, under **Preferences > Account > Sign In** or with **Sign In…** in the share dialog. + +| To share | Do this | +|---|---| +| The selection, or the whole text when nothing is selected | **Share Query…** in the editor's menu | +| The result shown | **Share Result…** in the editor's menu, or right-click a result grid and choose **Share Result…**, under **Export…** | +| A table's rows, with its filter and sort | Right-click the table tab's grid and choose **Share Result…** | +| A saved query | Click **Favorites** at the top of the sidebar, right-click the query and choose **Share…** | + +A table shares from its first row, whichever page is on screen. With a seat on a team, **Share As** in the dialog picks **Personal** or the team. For a result, **Columns** offers **Keep**, **Mask as** each mask, or **Remove** for every column, and columns that look sensitive start masked. **Manage Shared Links…** in the main menu opens your links in the browser. + +The dialog, the Free and Pro limits, and what a link sends are in [Shared Links](/features/shared-links#the-share-sheet). The column choices are in [Sensitive data](/features/shared-links#sensitive-data). Opening a `tablepro://share` link puts its SQL in a new editor tab without running it, and asks for a connection when the window has none. diff --git a/security/privacy.mdx b/security/privacy.mdx index 55f19be6..309123f9 100644 --- a/security/privacy.mdx +++ b/security/privacy.mdx @@ -18,6 +18,7 @@ Turn off app usage data in the privacy settings if you do not want to send it. M | [iCloud sync](#icloud-sync) | Your iCloud account | Off; **Settings > Sync** | | [MCP clients](#the-mcp-server) | Local HTTP and a private Unix socket | Off; **Settings > MCP** | | [Accounts and Team Library](#license-checks-and-the-team-library) | `api.tablepro.app` | Account requests after sign-in; content uploads when published | +| [Shared links](#shared-links) | `api.tablepro.app`; link pages on `s.tablepro.app` | Only when you open a share sheet, create or revoke a link, or open one | | [Database connections](#your-database-connections) | Your configured servers | When you connect | The remaining sections describe Mac features unless a platform is named. @@ -157,12 +158,18 @@ There is no setting that turns the catalog fetch off. ## License checks and the team library -From Mac 0.86.0 (including 0.86.0-beta.1) and Linux 0.1.0-beta.1, sign-in uses the account service at `https://api.tablepro.app`. `POST /v2/devices` registers the machine ID, name, platform and app/OS versions. Account access tokens and signed plan files replace routine license-key checks. On Mac, the machine ID is the SHA-256 hardware identifier; on Linux it is HMAC-SHA256 of `/etc/machine-id` with `app.tablepro.TablePro`, with a stored random fallback. Refresh tokens use the Mac Keychain or Linux keyring; Mac account tokens never sync. +From Mac 0.86.0 (including 0.86.0-beta.1), Linux 0.1.0-beta.1 and the Windows preview, sign-in uses the account service at `https://api.tablepro.app`. `POST /v2/devices` registers the machine ID, name, platform and app/OS versions. Account access tokens and signed plan files replace routine license-key checks. On Mac, the machine ID is the SHA-256 hardware identifier; on Linux it is HMAC-SHA256 of `/etc/machine-id` with `app.tablepro.TablePro`, with a stored random fallback; on Windows it is HMAC-SHA256 of the `MachineGuid` registry value with the same key. Refresh tokens use the Mac Keychain, the Linux keyring or Windows Credential Manager; Mac account tokens never sync. Mac builds before 0.86.0 use `https://api.tablepro.app/v1/license` after a key is entered. Activation and seven-day revalidation send the license key, machine ID, Mac name and app/OS versions. Deactivation sends the key and machine ID. Device records and audit changes are covered by the [account policy](https://tablepro.app/privacy#account). On Mac, publishing Team Library sends connection definitions and saved SQL to the service. Structured credentials are excluded; free text is not scrubbed. Current account builds use `/v2/teams/{id}/library`, pull changes at launch, every 15 minutes and after publishing, and publish changes rather than replacing the whole library. Older builds use `/v1/license/library` and pull at most weekly. [Team Library](https://tablepro.app/privacy#library) describes access, and [retention](https://tablepro.app/privacy#retention) distinguishes normal team deletion from deleting its sole owner's account. +## Shared links + +The Mac, Linux and Windows apps send nothing for sharing until you open a share sheet, which reads your limits from `GET /v2/share-limits` on `https://api.tablepro.app`. **Create Link** sends `POST /v2/shares` with the title, note, database type and SQL, and for a result the columns the grid shows and its rows up to your plan's limit. Masked columns are masked on your computer and sent with the name of their mask. Removed columns are not sent. The at-limit list and **Revoke** use `GET /v2/shares` and `DELETE /v2/shares/{id}`. **Open in TablePro** reads `GET /v2/shared/{token}` without the account, sending a password in `X-Share-Password` when the link has one. + +A link's page is served from `https://s.tablepro.app`. Its responses carry `X-Robots-Tag: noindex, nofollow, noarchive`, `Cache-Control: no-store` and `Referrer-Policy: no-referrer`. Views are counted per request, leaving out link previews and crawlers. A report sends its reason, details and optional email, checked with Cloudflare Turnstile, and the service keeps an HMAC of the reporter's IP address, never the address. [Shared Links](/features/shared-links#what-a-link-sends) lists what a link holds. + ## Crash reports Mac 0.86.0 includes PostHog's SDK with automatic crash capture disabled. Earlier Mac builds have no crash reporter. Linux sends no automatic crash reports. Local Mac logging uses OSLog. The iPhone and iPad app has no crash SDK; Apple's separate **Share With App Developers** setting can supply crash reports and usage statistics through App Store Connect. diff --git a/windows/account.mdx b/windows/account.mdx new file mode 100644 index 00000000..058e9a6a --- /dev/null +++ b/windows/account.mdx @@ -0,0 +1,46 @@ +--- +title: TablePro account +description: Sign in to your TablePro account on Windows, check your plan, and remove a device from the license +tag: "Preview" +--- + +Connections, queries and every other part of the app work signed out. [Shared links](/features/shared-links) need an account, and signing in puts your Free or Pro plan on this computer. The account is the one the Mac and Linux apps use. + +## Sign in + + + + Choose **Settings** in the **File** menu. **Account** is the first section. + + + Click **Sign in...**. The sign-in page opens in your web browser, and the button turns into **Cancel** until you finish there. + + + Sign in, or create an account, at account.tablepro.app. When the page says so, close the tab and go back to TablePro. + + + + +The card names the account and shows its email and plan, Free or Pro, with **Sign out**. + + + + Account section of Settings with the account card, Plan with Refresh, and Devices listing this computer and a Mac + Account section of Settings with the account card, Plan with Refresh, and Devices listing this computer and a Mac + + +The sign-in is kept in Windows Credential Manager for your Windows user. When Credential Manager does not take it, a notice says **Sign-in not saved**, and the next start asks you to sign in again. + +## Your plan + +Your plan is checked once a day. **Refresh** under **Plan** checks it now; a plan changed on the web shows after the next check. Expand **Plan** for **Manage account** and **Manage shared links**, which open account.tablepro.app in the browser. + +A plan that has not been checked lately says **Plan not verified lately** with **Refresh**, and a check that failed says **Could not verify your plan** with **Try again**. + +Billing, license keys and offline files are not in the Windows app yet. Use [account.tablepro.app](https://account.tablepro.app) for them. + +## Devices + +Expand **Devices** to list the computers signed in to your account, this computer first, each with its platform and the day it was last seen. **Remove** takes a device off the account, and that device is signed out at its next check. This computer, and a device whose offline file has not expired, have no **Remove**. + +A Free account has no device limit. A license covers 3 devices at a time, counting Macs, Linux and Windows computers together. On a fourth, the Account section says **Device limit reached** and the computer keeps working on Free. Click **Remove a device...**, remove one of the 3, and the license moves to this computer. diff --git a/windows/browsing.mdx b/windows/browsing.mdx index 855e23eb..0096d4a6 100644 --- a/windows/browsing.mdx +++ b/windows/browsing.mdx @@ -1,6 +1,6 @@ --- title: Browsing a connection -description: Filter a table, read its structure and DDL, open routines and triggers, export results, and find past queries in TablePro for Windows +description: Filter a table, read its structure and DDL, open routines and triggers, export or share results, and find past queries in TablePro for Windows tag: "Preview" --- @@ -105,6 +105,22 @@ Choose **File > Export results** or press `Ctrl+Shift+E`. From a query tab, export writes the result shown. Export waits until the run has finished. CSV is the default; pick Excel for a spreadsheet, which holds up to 1,048,575 rows. +## Share a result or query + +Sharing needs a signed-in [TablePro account](/windows/account); signed out, the share dialog offers **Sign in...**. + +| To share | Do this | +|---|---| +| The result a query tab shows | Right-click the results grid and choose **Share result...**, or choose **Share result...** in the **File** menu | +| A table's rows, with its filter and sort | Right-click the table's grid and choose **Share...**, or choose **Share result...** in the **File** menu | +| The selection, or the whole query when nothing is selected | Right-click in the editor and choose **Share query...**, or choose **Share query...** in the **File** menu | + +A result can be shared once its run has finished. A table shares from its first row, whichever page is on screen, and **Share...** is dimmed while edits are pending. When TablePro cannot write the table's query for its database, the link holds the rows without SQL and opens nothing in TablePro. + +In the dialog, **Share as** picks **Personal** or a team where you hold a seat, and **Share** creates the link and copies it, with **Open in browser** beside it. For a result, **Columns** sets each column to **Keep**, **Mask** with a mask, or **Remove**, and columns that look sensitive start masked. **Manage shared links...** in the **File** menu opens your links in the browser. The dialog's fields, the Free and Pro limits, and what a link sends are in [Shared Links](/features/shared-links#the-share-sheet), and the column choices in [Sensitive data](/features/shared-links#sensitive-data). + +Opening a `tablepro://share` link puts its SQL in a new query tab without running it. With no connection open, a dialog shows the SQL with **Copy SQL** instead. + ## Find a past query Choose **View > Show query history** to open the history beside the tabs. Every query you run in a query tab is kept with its time, duration and outcome, newest first. Type in the search box to find one by any words it contains.