diff --git a/features/connection-sharing.mdx b/features/connection-sharing.mdx index 32bef5b..4d08e95 100644 --- a/features/connection-sharing.mdx +++ b/features/connection-sharing.mdx @@ -123,7 +123,7 @@ Choose **File > Import > Import from AWS…** to list the RDS instances and Auro TablePro for iPhone reads and writes the same file. Tap the **more** menu (•••) above the connection list and choose **Import Connections**, or open a `.tablepro` file from Files or AirDrop. **Export Connections** shares through the system share sheet, leaving passwords out unless you turn on **Include passwords** and set a passphrase. -Groups nest on iPhone the way they do on the Mac. Saved queries do not: an iPhone import skips the ones in a file, and an iPhone export carries none, so a Mac file exported again from an iPhone loses its queries. +Groups and saved queries come across the way they do on the Mac. The review lists a file's saved queries below its connections, and an export carries the exported connections' queries while **Include Saved Queries** is on, adding global ones with **Also include global saved queries**. ## Linked Folders diff --git a/features/icloud-sync.mdx b/features/icloud-sync.mdx index 0455d89..0e1787f 100644 --- a/features/icloud-sync.mdx +++ b/features/icloud-sync.mdx @@ -1,9 +1,9 @@ --- title: iCloud Sync -description: Sync connections, groups, and tags to your Macs, iPhone, and iPad, and settings, table favorites, and SSH profiles between Macs +description: Sync connections, groups, tags, and saved queries to your Macs, iPhone, and iPad, and settings, table favorites, and SSH profiles between Macs --- -Sync needs a Starter or Team [license](/features/licensing) and starts off. Press `Cmd+,`, open **Settings > Sync**, turn on **Sync this Mac with iCloud**, pick the categories, and click **Sync Now**. The iPhone and iPad app shares the same CloudKit data but carries connections, groups, and tags only. +Sync needs a Starter or Team [license](/features/licensing) and starts off. Press `Cmd+,`, open **Settings > Sync**, turn on **Sync this Mac with iCloud**, pick the categories, and click **Sync Now**. The iPhone and iPad app shares the same CloudKit data but carries connections, groups, tags, and saved queries only. Sync pane with the Sync this Mac with iCloud switch and its Starter badge @@ -12,7 +12,7 @@ Sync needs a Starter or Team [license](/features/licensing) and starts off. Pres ## What syncs -Each synced category has its own toggle under **Sync Categories**. +Each synced category has its own toggle under **Sync Categories**. Turning one on brings down what other devices added or changed while it was off, but not what they deleted: remove those items on this Mac too. | Data | Synced | Notes | |------|--------|-------| diff --git a/images/ios-saved-queries-dark.png b/images/ios-saved-queries-dark.png new file mode 100644 index 0000000..6868f4e Binary files /dev/null and b/images/ios-saved-queries-dark.png differ diff --git a/images/ios-saved-queries.png b/images/ios-saved-queries.png new file mode 100644 index 0000000..ae5fbd5 Binary files /dev/null and b/images/ios-saved-queries.png differ diff --git a/ios/index.mdx b/ios/index.mdx index aa9274e..437eba5 100644 --- a/ios/index.mdx +++ b/ios/index.mdx @@ -3,7 +3,7 @@ title: iPhone and iPad description: Browse tables, run queries, and edit rows on ten database engines from a synced connection list --- -You need iOS 18 or later. Builds ship on their own schedule, so a feature in a Mac release note may not be on your phone yet. Your version and build are under **Settings > About**. Connections saved on a Mac come over iCloud; the rest of your Mac setup stays on the Mac. +You need iOS 18 or later. Builds ship on their own schedule, so a feature in a Mac release note may not be on your phone yet. Your version and build are under **Settings > About**. Connections and saved queries from a Mac come over iCloud; the rest of your Mac setup stays on the Mac. Connections grouped under Favorites and a Production folder, next to Settings with Security, iCloud and New Connections sections @@ -80,7 +80,7 @@ A connection, group or tag form with unsaved changes stays open when swiped down ## What syncs over -The same CloudKit container as the Mac. iCloud Sync is off on both until you turn it on: here during first launch or under **Settings > iCloud**. While it is off nothing leaves the device, and edits made in the meantime go up when you turn it back on, provided the device is still signed in to the same Apple Account. Sign in to a different Apple Account and sync starts over for that account: its connections come down, edits not yet sent go up to it, deletions not yet sent are dropped, and the other connections already on the device stay and go up the next time you edit them. Three record types cross: connections (host, port, SSH tunnel and SSL settings, color, icon, safe mode level, favorite), groups with their nesting and icons, and tags. SSH profiles, table favorites, saved queries, and app settings are skipped, and query history on the phone is only what you ran on the phone. +The same CloudKit container as the Mac. iCloud Sync is off on both until you turn it on: here during first launch or under **Settings > iCloud**. While it is off nothing leaves the device, and edits made in the meantime go up when you turn it back on, provided the device is still signed in to the same Apple Account. Sign in to a different Apple Account and sync starts over for that account: its connections come down, edits not yet sent go up to it, deletions not yet sent are dropped, and the other connections already on the device stay and go up the next time you edit them. Four kinds of data cross: connections (host, port, SSH tunnel and SSL settings, color, icon, safe mode level, favorite), groups with their nesting and icons, tags, and [saved queries](#saved-queries) with their folders. Saved queries have no switch of their own here and sync whenever iCloud Sync is on. SSH profiles, table favorites, and app settings are skipped, and query history on the phone is only what you ran on the phone. Four things a connection depends on are per device and never sync: @@ -175,6 +175,26 @@ On Redis a command ends at a semicolon or at a line break outside quotes, so eac A running query appears in a Live Activity on the lock screen and Dynamic Island, with the elapsed time and the row count so far. **Settings > Live Activities > Hide Query** replaces the SQL text there with "Running query". The card clears when the query ends. Quitting the app mid-query leaves it behind, marked interrupted, until the next launch clears it. +### Saved queries + +Open the **More** menu (•••) beside **Run** and choose **Saved Queries**. The list holds this connection's queries and the global ones, in their folders, and search matches names, keywords and SQL. Tap a query to put its SQL in the editor in place of what was there. Nothing runs until you tap **Run**. + +**Save Query…** in the same menu keeps the editor's text, with the first line of the SQL filled in as its name. Turn on **Global** to list the query on every connection. Keywords and the size limit follow the [Mac's rules](/features/favorites#keywords), and a keyword expands in the Mac's editor only. + + + Query menu with Saved Queries and Save Query above History, beside the Saved Queries sheet with a Reports folder and two queries carrying keyword badges + Query menu with Saved Queries and Save Query above History, beside the Saved Queries sheet with a Reports folder and two queries carrying keyword badges + + +| To | Do this | +| --- | --- | +| Rename, move or delete a query | Touch and hold it and choose **Rename**, **Move to Folder…** or **Delete** | +| Change its name, folder, keyword or scope | Swipe right on it, or touch and hold it and choose **Edit…** | +| Add a folder | Tap **New Folder** at the top of the list, or touch and hold a folder and choose **New Subfolder** | +| Rename a folder, make it global, or delete it | Touch and hold the folder. Deleting one moves what it held up a level | + +To change a saved query's SQL, edit it on the Mac. Version history and linked SQL folders are Mac only. + ### Open transactions After `BEGIN` in **Query**, a bar sits at the bottom of every section until the transaction ends, by its buttons or by a typed `COMMIT` or `ROLLBACK`. On a MySQL or MariaDB server with autocommit off, opening a table is enough to start one. The bar names the database, or the connection on an engine with one database, and the connection list marks the row with an hourglass. Where their titles do not fit, **Roll Back** and **Commit** show as an arrow and a checkmark. @@ -234,4 +254,4 @@ Hops synced from the Mac arrive with key paths that name files on the Mac, so ea Three App Intents put the app in Shortcuts, the Share Sheet, and Siri: **Open Connection**, **Add Row to Table**, **Add Rows to Table**. See [iOS Shortcuts](/integrations/ios-shortcuts) for pickers, data formats, and limits. -A **Quick Connect** home screen widget opens a saved connection directly, and Handoff carries an open connection between devices. A `tablepro://connect/` link opens a connection and `tablepro://connect//table/` opens a table; the Mac's other links do less or nothing here, as [URL scheme](/developers/url-scheme#on-iphone-and-ipad) lists. A `.tablepro` file from Files or AirDrop imports its connections, leaving out any saved queries it carries. +A **Quick Connect** home screen widget opens a saved connection directly, and Handoff carries an open connection between devices. A `tablepro://connect/` link opens a connection and `tablepro://connect//table/` opens a table; the Mac's other links do less or nothing here, as [URL scheme](/developers/url-scheme#on-iphone-and-ipad) lists. A `.tablepro` file from Files or AirDrop imports its connections and saved queries.