From 916df0ea18cd19f2af883d5981c08d5c25f14dc8 Mon Sep 17 00:00:00 2001 From: billy-the-fish Date: Wed, 29 Oct 2025 12:03:27 +0100 Subject: [PATCH 01/10] chore: compress on INSERT. --- use-timescale/write-data/insert.md | 36 ++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/use-timescale/write-data/insert.md b/use-timescale/write-data/insert.md index 7753dc3a58..b43c11809a 100644 --- a/use-timescale/write-data/insert.md +++ b/use-timescale/write-data/insert.md @@ -6,6 +6,8 @@ keywords: [ingest] tags: [insert, write, hypertables] --- +import EarlyAccess2230 from "versionContent/_partials/_early_access_2_23_0.mdx"; + # Insert data Insert data into a hypertable with a standard [`INSERT`][postgres-insert] SQL @@ -65,4 +67,38 @@ time | location | temperature | humidity (1 row) ``` +## Direct compress on INSERT + +When you create a $HYPERTABLE using [CREATE TABLE ... WITH ...][hypertable-create-table], $TIMESCALE_DB creates a +[columnstore policy][add_columnstore_policy] that automatically converts your data to the $COLUMNSTORE after an interval +that matches the default [chunk_interval][create_table_arguments]. This columnar format enables fast scanning and +aggregation, optimizing performance for analytical workloads while also saving significant storage space. In the +$COLUMNSTORE conversion, $HYPERTABLE chunks are compressed by up to 98%, and organized for efficient, large-scale +queries. + +To improve performance, you can compress data during `INSERT` so that it is injected directly into chunks +in the $COLUMNSTORE rather than waiting for the policy. + +To enable direct compress on INSERT, enable the following [GUC parameters][gucs]: + +```sql +SET timescaledb.enable_compressed_insert = true; +SET timescaledb.enable_compressed_insert_sort_batches = true; +SET timescaledb.enable_compressed_insert_client_sorted = true; +``` + +When you set `enable_compressed_insert_client_sorted` to `true`, you must ensure that data in the input +stream is sorted. + + + +[postgres-update]: https://www.postgresql.org/docs/current/sql-update.html +[hypertable-create-table]: /api/:currentVersion:/hypertable/create_table/ +[add_columnstore_policy]: /api/:currentVersion:/hypercore/add_columnstore_policy/ +[remove_columnstore_policy]: /api/:currentVersion:/hypercore/remove_columnstore_policy/ +[create_table_arguments]: /api/:currentVersion:/hypertable/create_table/#arguments +[alter_job_samples]: /api/:currentVersion:/jobs-automation/alter_job/#samples +[convert_to_columnstore]: /api/:currentVersion:/hypercore/convert_to_columnstore/ +[gucs]: /api/:currentVersion:/configuration/gucs/ + [postgres-insert]: https://www.postgresql.org/docs/current/sql-insert.html From ca33f03bd55fe1b02cdf404ca5e66f5b6a46ac34 Mon Sep 17 00:00:00 2001 From: billy-the-fish Date: Wed, 29 Oct 2025 13:49:53 +0100 Subject: [PATCH 02/10] chore: add missing partials. --- _partials/_early_access_2_23_0.md | 1 + _partials/_since_2_23_0.md | 1 + 2 files changed, 2 insertions(+) create mode 100644 _partials/_early_access_2_23_0.md create mode 100644 _partials/_since_2_23_0.md diff --git a/_partials/_early_access_2_23_0.md b/_partials/_early_access_2_23_0.md new file mode 100644 index 0000000000..268b2f2ec4 --- /dev/null +++ b/_partials/_early_access_2_23_0.md @@ -0,0 +1 @@ +Early access: [TimescaleDB v2.23.0](https://github.com/timescale/timescaledb/releases/tag/2.23.0) diff --git a/_partials/_since_2_23_0.md b/_partials/_since_2_23_0.md new file mode 100644 index 0000000000..d80336c95e --- /dev/null +++ b/_partials/_since_2_23_0.md @@ -0,0 +1 @@ +Since [TimescaleDB v2.23.0](https://github.com/timescale/timescaledb/releases/tag/2.23.0) From 089d442c5240c1cc977b4855d41c9cd76df1a754 Mon Sep 17 00:00:00 2001 From: Brandon Date: Fri, 31 Oct 2025 08:29:26 -0400 Subject: [PATCH 03/10] Update changelog with new features and enhancements (#4536) * Update changelog with new features and enhancements Added details about Crypto Payments early access and S3 Source Connector improvements. Signed-off-by: Brandon * review and images * crypto payments added --------- Signed-off-by: Brandon Co-authored-by: Anastasiia Tovpeko <114177030+atovpeko@users.noreply.github.com> Co-authored-by: atovpeko --- _partials/_manage-pricing-plan.md | 4 +-- about/changelog.md | 48 +++++++++++++++++++++++++++++++ migrate/livesync-for-s3.md | 2 +- 3 files changed, 51 insertions(+), 3 deletions(-) diff --git a/_partials/_manage-pricing-plan.md b/_partials/_manage-pricing-plan.md index f18d9a5331..dbbf10b846 100644 --- a/_partials/_manage-pricing-plan.md +++ b/_partials/_manage-pricing-plan.md @@ -2,12 +2,12 @@ You handle all details about your $CLOUD_LONG project including updates to your payment methods, and add-ons in the [billing section in $CONSOLE][cloud-billing]: Adding a payment method in Timescale - **Details**: an overview of your $PRICING_PLAN, usage, and payment details. You can add up to three credit cards to your `Wallet`. If you prefer to pay by invoice, - [contact $COMPANY][contact-company] and ask to change to corporate billing. + [contact $COMPANY][contact-company] and ask to change to corporate billing. You can also request early access to paying with crypto. - **Emails**: the addresses $COMPANY uses to communicate with you. Payment confirmations and alerts are sent to the email address you signed up with. diff --git a/about/changelog.md b/about/changelog.md index 0d29280c72..189b01d973 100644 --- a/about/changelog.md +++ b/about/changelog.md @@ -9,6 +9,54 @@ products: [cloud] All the latest features and updates to $CLOUD_LONG. +## S3 source connector and crypto payments + + +### πŸ” Crypto payments β€” early access! + +You can now pay your Tiger Cloud invoices with stablecoins through Stripe’s crypto payments. Each month, you can receive a Stripe crypto payment link to pay the prior month’s invoice in USD. Request access via the `Billing` page in Tiger Console. + +![Crypto payments](https://assets.timescale.com/docs/images/tiger-on-azure/tiger-cloud-crypto-payment.png) + +**Note:** Payments must be completed within 7 days. + +Supported currencies: + +- **USDC** (Ethereum, Solana, Polygon, Base) +- **USDP** (Ethereum, Solana) +- **USDG** (Ethereum) + +Eligibility: + +- Paid customer for 1 month or more +- No outstanding invoices +- $500–$10,000 monthly spend + +For a higher spend, simply contact us! + +### ✨ Detailed S3 source connector progress screen + +We’ve introduced major improvements to the S3 source connector on Tiger Cloud, to enhance observability and provide deeper visibility into connector performance. This update will help you quickly understand the overall state of the connector, take action faster, and trace the complete lifecycle of every imported file. + +![S3 connector stats](https://assets.timescale.com/docs/images/tiger-on-azure/tiger-console-s3-connector-import-details.png) + +The improvements include: + +- **Cumulative summary** of total imported, queued, and failed files +- **Search** capability across all files +- **Detailed file statuses** including: + - In-queue + - In-progress + - Completed + - Error + - Retry + - Resolve + - Cancelled +- **Filtering** by file status +- **Bulk retry** option for all failed files +- **Lifecycle history** showing file progression across states and time spent in each +- **Auto-refresh** option (every minute) for real-time updates + ## 🧠 πŸ… ☁️ AI and Tiger Cloud major changes! diff --git a/migrate/livesync-for-s3.md b/migrate/livesync-for-s3.md index b5c9e91ae1..3ed85198b5 100644 --- a/migrate/livesync-for-s3.md +++ b/migrate/livesync-for-s3.md @@ -144,7 +144,7 @@ To sync data from your S3 bucket to your $SERVICE_LONG using $CONSOLE: 1. To view file import statistics and logs, click `Connectors` > `Source connectors`, then select the name of your connector in the table. - ![S3 connector stats](https://assets.timescale.com/docs/images/tiger-on-azure/tiger-console-s3-connector-import-stats.png) + ![S3 connector stats](https://assets.timescale.com/docs/images/tiger-on-azure/tiger-console-s3-connector-import-details.png) 1. **Manage the connector** From 1590b31d603704bea63e640bfd39f94bafa2b335 Mon Sep 17 00:00:00 2001 From: Anastasiia Tovpeko <114177030+atovpeko@users.noreply.github.com> Date: Fri, 31 Oct 2025 15:25:34 +0200 Subject: [PATCH 04/10] fixes on azure review (#4538) --- _partials/_aws-features.md | 4 +++- _partials/_azure-features.md | 8 +++++--- _partials/_billing-example.md | 4 ++++ _partials/_prometheus-integrate.md | 2 +- 4 files changed, 13 insertions(+), 5 deletions(-) diff --git a/_partials/_aws-features.md b/_partials/_aws-features.md index 6b83b8229b..9487a115ad 100644 --- a/_partials/_aws-features.md +++ b/_partials/_aws-features.md @@ -62,4 +62,6 @@ The features included in each [$PRICING_PLAN][pricing-plans] are: For a personalized quote, [get in touch with $COMPANY][contact-company]. [pricing-plans]: https://www.timescale.com/pricing -[contact-company]: https://www.tigerdata.com/contact/ \ No newline at end of file +[contact-company]: https://www.tigerdata.com/contact/ +[hipaa-compliance]: https://www.hhs.gov/hipaa/for-professionals/index.html +[commercial-sla]: https://www.timescale.com/legal/timescale-cloud-terms-of-service \ No newline at end of file diff --git a/_partials/_azure-features.md b/_partials/_azure-features.md index 7a14f11fac..b8aba46031 100644 --- a/_partials/_azure-features.md +++ b/_partials/_azure-features.md @@ -15,7 +15,7 @@ The features included in each [$PRICING_PLAN][pricing-plans] are: | Number of $SERVICE_SHORTs | Up to 2 free services | Up to 2 free and 4 standard services | Up to 2 free and and unlimited standard services | Up to 2 free and and unlimited standard services | | CPU limit per $SERVICE_SHORT | Shared | Up to 8 CPU | Up to 32 CPU | Up to 64 CPU | | Memory limit per $SERVICE_SHORT | Shared | Up to 32 GB | Up to 128 GB | Up to 256 GB | -| Storage limit per $SERVICE_SHORT | 750 MB | Up to 16 TB | Up to 16 TB | Up to 64 TB | +| Storage limit per $SERVICE_SHORT | 750 MB | Up to 16 TB | Up to 16 TB | Up to 16 TB | | Independently scale compute and storage | | Standard services only | Standard services only | Standard services only | | **Data services and workloads** | | | | | Relational | βœ“ | βœ“ | βœ“ | βœ“ | @@ -28,7 +28,7 @@ The features included in each [$PRICING_PLAN][pricing-plans] are: | **Storage and performance** | | | | | | IOPS | Shared | 3,000 - 5,000 | 5,000 - 8,000 | 5,000 - 8,000 | | Bandwidth (autoscales) | Shared | 125 - 250 Mbps | 250 - 500 Mbps | Up to 500 mbps | -| I/O boost | | | Add-on:
Up to 16K IOPS, 1000 Mbps BW | Add-on:
Up to 32K IOPS, 4000 Mbps BW | +| I/O boost | | | Add-on:
Up to 16K IOPS, 1000 Mbps BW | Add-on:
Up to 16K IOPS, 1000 Mbps BW | | **Availability and monitoring** | | | | | | High-availability replicas
(Automated multi-AZ failover) | | βœ“ | βœ“ | βœ“ | | Read replicas | | | βœ“ | βœ“ | @@ -58,4 +58,6 @@ The features included in each [$PRICING_PLAN][pricing-plans] are: For a personalized quote, [get in touch with $COMPANY][contact-company]. [pricing-plans]: https://www.timescale.com/pricing -[contact-company]: https://www.tigerdata.com/contact/ \ No newline at end of file +[contact-company]: https://www.tigerdata.com/contact/ +[hipaa-compliance]: https://www.hhs.gov/hipaa/for-professionals/index.html +[commercial-sla]: https://www.timescale.com/legal/timescale-cloud-terms-of-service \ No newline at end of file diff --git a/_partials/_billing-example.md b/_partials/_billing-example.md index 3be33287ba..7b3dfc2eb5 100644 --- a/_partials/_billing-example.md +++ b/_partials/_billing-example.md @@ -1,3 +1,5 @@ +import BillingForInactiveServices from "versionContent/_partials/_billing-for-inactive-services.mdx"; + You are billed at the end of each month in arrears. Your monthly invoice includes an itemized cost accounting for each $SERVICE_LONG and any additional charges. @@ -22,4 +24,6 @@ and consumed high-performance storage for 720 hours total: Some add-ons such as tiered storage, HA replicas, and connection pooling may incur additional charges. These charges are clearly marked in your billing snapshot in $CONSOLE. + + \ No newline at end of file diff --git a/_partials/_prometheus-integrate.md b/_partials/_prometheus-integrate.md index 744ea2e3d3..744ac2cc09 100644 --- a/_partials/_prometheus-integrate.md +++ b/_partials/_prometheus-integrate.md @@ -29,7 +29,7 @@ To export your data, do the following: - + From 9fefed43ad43ce3363220ddfc415e1c9d9d21623 Mon Sep 17 00:00:00 2001 From: Nathan Cochran Date: Fri, 31 Oct 2025 10:52:13 -0400 Subject: [PATCH 05/10] CLI/MCP fixes (#4537) * Fix erroneous references to --cpu-memory flag * Improve documentation of configuration parameters, env vars, and flags * Add new 'create role' command * Add backticks around output format * Minor tweaks to global CLI flags * List config options, not env vars * MCP tools, not commands * Add new service_fork MCP tool * chore: update on review. --------- Signed-off-by: Iain Cox Co-authored-by: billy-the-fish Co-authored-by: Iain Cox --- _partials/_devops-cli-config-options.md | 15 ++++ _partials/_devops-cli-global-flags.md | 4 +- _partials/_devops-cli-reference.md | 107 +++++++++++------------- _partials/_devops-mcp-commands.md | 62 ++++++++------ ai/mcp-server.md | 4 +- 5 files changed, 105 insertions(+), 87 deletions(-) create mode 100644 _partials/_devops-cli-config-options.md diff --git a/_partials/_devops-cli-config-options.md b/_partials/_devops-cli-config-options.md new file mode 100644 index 0000000000..962e25b6f6 --- /dev/null +++ b/_partials/_devops-cli-config-options.md @@ -0,0 +1,15 @@ + +| Flag | Default | Description | +|---------------------------|-------------------|-----------------------------------------------------------------------------| +| `analytics` | `true` | Set to `false` to disable usage analytics | +| `color ` | `true` | Set to `false` to disable colored output | +| `debug` | No debugging | Enable debug logging | +| `docs_mcp` | `true` | Enable or disable the $COMPANY documentation MCP proxy | +| `output` | `table` | Set the output format to `json`, `yaml`, or `table` | +| `password-storage` string | `keyring` | Set the password storage method. Options are `keyring`, `pgpass`, or `none` | +| `service-id` string | - | Set the $SERVICE_LONG to manage | +| `version_check_interval` | `24h` | Set how often the $CLI_SHORT checks for a new version | + +You can also set these configuration options as environment variables. Environment variables: +* Take precedence over configuration parameters values. +* Are in upper case and use the `TIGER_` prefix. For example, `TIGER_ANALYTICS` \ No newline at end of file diff --git a/_partials/_devops-cli-global-flags.md b/_partials/_devops-cli-global-flags.md index 1fd8c692dc..4bfc3d0bad 100644 --- a/_partials/_devops-cli-global-flags.md +++ b/_partials/_devops-cli-global-flags.md @@ -3,9 +3,9 @@ |-------------------------------|-------------------|-----------------------------------------------------------------------------| | `--analytics` | `true` | Set to `false` to disable usage analytics | | `--color ` | `true` | Set to `false` to disable colored output | -| `--config-dir` string | `.config/tiger` | Set the directory that holds `config.yaml` | +| `--config-dir` string | `~/.config/tiger` | Set the directory that holds `config.yaml` | | `--debug` | No debugging | Enable debug logging | | `--help` | - | Print help about the current command. For example, `tiger service --help` | | `--password-storage` string | keyring | Set the password storage method. Options are `keyring`, `pgpass`, or `none` | | `--service-id` string | - | Set the $SERVICE_LONG to manage | -| ` --skip-update-check ` | - | Do not check if a new version of $CLI_LONG is available| \ No newline at end of file +| `--skip-update-check` | - | Do not check if a new version of $CLI_LONG is available | diff --git a/_partials/_devops-cli-reference.md b/_partials/_devops-cli-reference.md index 5af5462e50..4fe8151ff6 100644 --- a/_partials/_devops-cli-reference.md +++ b/_partials/_devops-cli-reference.md @@ -1,77 +1,70 @@ import GLOBALFLAGS from "versionContent/_partials/_devops-cli-global-flags.mdx"; +import CONFIGOPTIONS from "versionContent/_partials/_devops-cli-config-options.mdx"; ## Commands You can use the following commands with $CLI_LONG. For more information on each command, use the `-h` flag. For example: `tiger auth login -h` -| Command | Subcommand | Description | -|---------|----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| auth | | Manage authentication and credentials for your $ACCOUNT_LONG | -| | login | Create an authenticated connection to your $ACCOUNT_LONG | -| | logout | Remove the credentials used to create authenticated connections to $CLOUD_LONG | -| | status | Show your current authentication status and project ID | -| version | | Show information about the currently installed version of $CLI_LONG | -| config | | Manage your $CLI_LONG configuration | -| | show | Show the current configuration | -| | set `` `` | Set a specific value in your configuration. For example, `tiger config set debug true` | -| | unset `` | Clear the value of a configuration parameter. For example, `tiger config unset debug` | -| | reset | Reset the configuration to the defaults. This also logs you out from the current $PROJECT_LONG | -| service | | Manage the $SERVICE_LONGs in this $PROJECT_SHORT | -| | create | Create a new $SERVICE_SHORT in this $PROJECT_SHORT. Possible flags are:
  • `--name`: service name (auto-generated if not provided)
  • `--addons`: addons to enable (time-series, ai, or none for PostgreSQL-only)
  • `--region`: the region code to deploy the service in. Set an AWS region to deploy the service in AWS, an Azure region for Azure
  • `--cpu-memory`: CPU/memory allocation combination
  • `--replicas`: number of high-availability replicas
  • `--no-wait`: don't wait for the operation to complete
  • `--wait-timeout`: wait timeout duration (for example, 30m, 1h30m, 90s)
  • `--no-set-default`: don't set this service as the default service
  • `--with-password`: include password in output
  • `--output, -o`: output format (`json`, `yaml`, table)

Possible `cpu-memory` combinations are:
  • shared/shared
  • 0.5 CPU/2 GB
  • 1 CPU/4 GB
  • 2 CPU/8 GB
  • 4 CPU/16 GB
  • 8 CPU/32 GB
  • 16 CPU/64 GB
  • 32 CPU/128 GB
| -| | delete `` | Delete a $SERVICE_SHORT from this $PROJECT_SHORT. This operation is irreversible and requires confirmation by typing the service ID | -| | fork `` | Fork an existing service to create a new independent copy. Key features are:
  • Timing options: `--now`, `--last-snapshot`, `--to-timestamp`
  • Resource configuration: `--cpu-memory`
  • Naming: `--name `. Defaults to `{source-service-name}-fork`
  • Wait behavior: `--no-wait`, `--wait-timeout`
  • Default service: `--no-set-default`
| -| | get `` (aliases: describe, show) | Show detailed information about a specific $SERVICE_SHORT in this $PROJECT_SHORT | -| | list | List all the $SERVICE_SHORTs in this $PROJECT_SHORT | -| | update-password `` | Update the master password for a $SERVICE_SHORT | -| db | | Database operations and management | -| | connect `` | Connect to a $SERVICE_SHORT | -| | connection-string `` | Retrieve the connection string for a $SERVICE_SHORT | -| | save-password `` | Save the password for a service | -| | test-connection `` | Test the connectivity to a $SERVICE_SHORT | -| mcp | | Manage $MCP_LONG for AI Assistant integration | -| | install `[client]` | Install and configure $MCP_LONG for a specific client (`claude-code`, `cursor`, `windsurf`, or other). If no client is specified, you'll be prompted to select one interactively | -| | start | Start $MCP_LONG. This is the same as `tiger mcp start stdio` | -| | start stdio | Start $MCP_LONG with stdio transport (default) | -| | start http | Start $MCP_LONG with HTTP transport. Includes flags: `--port` (default: `8080`), `--host` (default: `localhost`) | - - -## Global flags - -You can use the following global flags with $CLI_LONG: - - +| Command | Subcommand | Description | +|---------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| auth | | Manage authentication and credentials for your $ACCOUNT_LONG | +| | login | Create an authenticated connection to your $ACCOUNT_LONG | +| | logout | Remove the credentials used to create authenticated connections to $CLOUD_LONG | +| | status | Show your current authentication status and project ID | +| version | | Show information about the currently installed version of $CLI_LONG | +| config | | Manage your $CLI_LONG configuration | +| | show | Show the current configuration | +| | set `` `` | Set a specific value in your configuration. For example, `tiger config set debug true` | +| | unset `` | Clear the value of a configuration parameter. For example, `tiger config unset debug` | +| | reset | Reset the configuration to the defaults. This also logs you out from the current $PROJECT_LONG | +| service | | Manage the $SERVICE_LONGs in this $PROJECT_SHORT | +| | create | Create a new $SERVICE_SHORT in this $PROJECT_SHORT. Possible flags are:
  • `--name`: service name (auto-generated if not provided)
  • `--addons`: addons to enable. Possible values are `time-series`, `ai`. Set to `none` for vanille $PG
  • `--region`: region code where the service will be deployed
  • `--cpu`: CPU allocation in millicores. Set to `shared` to create a free service. See the allowed CPU/memory configurations below.
  • `--memory`: memory allocation in gigabytes. Set to `shared` to create a free service. See the allowed CPU/memory configurations below.
  • `--replicas`: number of high-availability replicas
  • `--no-wait`: don't wait for the operation to complete
  • `--wait-timeout`: wait timeout duration (for example, 30m, 1h30m, 90s)
  • `--no-set-default`: don't set this service as the default service
  • `--with-password`: include password in output
  • `--output, -o`: set the output format to `json`, `yaml`, or `table`

Allowed CPU/memory configurations are:
  • shared / shared
  • 0.5 CPU (500m) / 2GB
  • 1 CPU (1000m) / 4GB
  • 2 CPU (2000m) / 8GB
  • 4 CPU (4000m) / 16GB
  • 8 CPU (8000m) / 32GB
  • 16 CPU (16000m) / 64GB
  • 32 CPU (32000m) / 128GB
Note: You can specify both CPU and memory together, or specify only one (the other will be automatically configured). | +| | delete `` | Delete a $SERVICE_SHORT from this $PROJECT_SHORT. This operation is irreversible and requires confirmation by typing the service ID | +| | fork `` | Fork an existing service to create a new independent copy. Key features are:
  • Timing options:
    • `--now`
    • `--last-snapshot`
    • `--to-timestamp`
  • Resource configuration:
    • `--cpu`: CPU allocation in millicores. Set to `shared` to create a free service. See the allowed CPU/memory configurations in the `create` subcommand
    • `--memory`: memory allocation in gigabytes. Set to `shared` to create a free service. If you do not specify this parameter, `--memory` takes the same value as the source service. See the allowed CPU/memory configurations in the `create` subcommand
  • Naming:
    • `--name `: defaults to `{source-service-name}-fork`
  • Wait behavior:
    • `--no-wait`
    • `--wait-timeout`
  • Default service:
    • `--no-set-default`
| +| | get ``
aliases: `describe`, `show` | Show detailed information about a specific $SERVICE_SHORT in this $PROJECT_SHORT | +| | list | List all the $SERVICE_SHORTs in this $PROJECT_SHORT | +| | update-password `` | Update the master password for a $SERVICE_SHORT | +| db | | Database operations and management | +| | connect `` | Connect to a $SERVICE_SHORT | +| | connection-string `` | Retrieve the connection string for a $SERVICE_SHORT | +| | create role `` | Create a new database role. Possible flags are:
  • `--name` (required): the name for the role you are creating
  • `--read-only`: enable permanent read-only enforcement for `--name` using `tsdb_admin.read_only_role`
  • `--from`: inherit grants from one or more roles. For example, `--from app_role`, `--from readonly_role`, `--from app_role,readonly_role`
  • `--statement-timeout`: set the statement timeout for `--name`. For example, `30s`, `5m`
  • `--password`: set the password for `--name`. If not provided, the CLI checks the `TIGER_NEW_PASSWORD` environment variable. If you have not defined `TIGER_NEW_PASSWORD` the CLI auto-generates a secure random password.
  • `-o, --output`: set the output format to `json`, `yaml`, or `table`
| +| | save-password `` | Save the password for a service | +| | test-connection `` | Test the connectivity to a $SERVICE_SHORT | +| mcp | | Manage $MCP_LONG for AI Assistant integration | +| | install `[client]` | Install and configure $MCP_LONG for a specific client (`claude-code`, `cursor`, `windsurf`, or other). If no client is specified, you'll be prompted to select one interactively | +| | start | Start $MCP_LONG. This is the same as `tiger mcp start stdio` | +| | start stdio | Start $MCP_LONG with stdio transport (default) | +| | start http | Start $MCP_LONG with HTTP transport. Includes flags: `--port` (default: `8080`), `--host` (default: `localhost`) | + ## Configuration parameters -By default, $CLI_LONG stores your configuration in `~/.config/tiger/config.yaml`. The name of these -variables matches the flags you use to update them. However, you can override them using the following -environmental variables: - -- **Configuration parameters** - - `TIGER_CONFIG_DIR`: path to configuration directory (default: `~/.config/tiger`) - - `TIGER_API_URL`: $REST_LONG base endpoint (default: https://console.cloud.timescale.com/public/api/v1) - - `TIGER_CONSOLE_URL`: URL to $CONSOLE (default: https://console.cloud.timescale.com) - - `TIGER_GATEWAY_URL`: URL to the $CONSOLE gateway (default: https://console.cloud.timescale.com/api) - - `TIGER_DOCS_MCP`: enable/disable docs MCP proxy (default: `true`) - - `TIGER_DOCS_MCP_URL`: URL to $MCP_SHORT for $COMPANY docs (default: https://mcp.tigerdata.com/docs) - - `TIGER_SERVICE_ID`: ID for the $SERVICE_SHORT updated when you call $CLI_SHORT commands - - `TIGER_ANALYTICS`: enable or disable analytics (default: `true`) - - `TIGER_PASSWORD_STORAGE`: password storage method (keyring, pgpass, or none) - - `TIGER_DEBUG`: enable/disable debug logging (default: `false`) - - `TIGER_COLOR`: set to `false` to disable colored output (default: `true`) - +By default, $CLI_LONG stores your configuration in `~/.config/tiger/config.yaml`. The location of the config +directory can be adjusted via the `--config-dir` flag or the `TIGER_CONFIG_DIR` environment variable. + +- **Configuration options** + + You set the following configuration options using `tiger config set `: + + + +- **Global Flags** + + These flags are available on all commands and take precedence over both environment variables and configuration file values: + + - **Authentication parameters** - To authenticate without using the interactive login, either: + To authenticate without using the interactive login, either: - Set the following parameters with your [client credentials][rest-api-credentials], then `login`: ```shell - TIGER_PUBLIC_KEY= TIGER_SECRET_KEY= TIGER_PROJECT_ID=\ + TIGER_PUBLIC_KEY= TIGER_SECRET_KEY= TIGER_PROJECT_ID=\ tiger auth login ``` - - Add your [client credentials][rest-api-credentials] to the `login` command: + - Add your [client credentials][rest-api-credentials] to the `login` command: ```shell tiger auth login --public-key= --secret-key= --project-id= ``` @@ -81,4 +74,4 @@ environmental variables: [get-project-id]: /integrations/:currentVersion:/find-connection-details/#find-your-project-and-service-id [create-client-credentials]: /integrations/:currentVersion:/find-connection-details/#create-client-credentials [curl]: https://curl.se/ -[rest-api-credentials]: https://console.cloud.timescale.com/dashboard/settings \ No newline at end of file +[rest-api-credentials]: https://console.cloud.timescale.com/dashboard/settings diff --git a/_partials/_devops-mcp-commands.md b/_partials/_devops-mcp-commands.md index 0b91f74756..f2acb7481a 100644 --- a/_partials/_devops-mcp-commands.md +++ b/_partials/_devops-mcp-commands.md @@ -1,32 +1,42 @@ $MCP_LONG exposes the following MCP tools to your AI Assistant: -| Command | Parameter | Required | Description | -|--------------------------|---------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `service_list` | - | - | Returns a list of the $SERVICE_SHORTs in the current $PROJECT_SHORT. | -| `service_get` | - | - | Returns detailed information about a $SERVICE_SHORT. | -| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT (10-character alphanumeric string). | -| | `with_password` | - | Set to `true` to include the password in the response and connection string.
**WARNING**: never do this unless the user explicitly requests the password. | -| `service_create` | - | - | Create a new $SERVICE_SHORT in $CLOUD_LONG.
**WARNING**: creates billable resources. | -| | `name` | - | Set the human-readable name of up to 128 characters for this $SERVICE_SHORT. | -| | `addons` | - | Set the array of [addons][create-service] to enable for the $SERVICE_SHORT. Options:
  • `time-series`: enables $TIMESCALE_DB
  • `ai`: enables the AI and vector extensions
Set an empty array for $PG-only. | -| | `region` | - | Set the [AWS region][cloud-regions] to deploy this $SERVICE_SHORT in. | -| | `cpu_memory` | - | CPU and memory allocation combination.
Available configurations are:
  • shared/shared
  • 0.5 CPU/2 GB
  • 1 CPU/4 GB
  • 2 CPU/8 GB
  • 4 CPU/16 GB
  • 8 CPU/32 GB
  • 16 CPU/64 GB
  • 32 CPU/128 GB
| -| | `replicas` | - | Set the number of [high-availability replicas][readreplica] for fault tolerance. | -| | `wait` | - | Set to `true` to wait for $SERVICE_SHORT to be fully ready before returning. | -| | `timeout_minutes` | - | Set the timeout in minutes to wait for $SERVICE_SHORT to be ready. Only used when `wait=true`. Default: 30 minutes | -| | `set_default` | - | By default, the new $SERVICE_SHORT is the default for following commands in $CLI_SHORT. Set to `false` to keep the previous $SERVICE_SHORT as the default. | -| | `with_password` | - | Set to `true` to include the password for this $SERVICE_SHORT in response and connection string.
**WARNING**: never set to `true` unless user explicitly requests the password. | -| `service_update_password` | - | - | Update the password for the `tsdbadmin` for this $SERVICE_SHORT. The password change takes effect immediately and may terminate existing connections. | -| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT you want to update the password for. | -| | `password` | βœ“ | The new password for the `tsdbadmin` user. | -| `db_execute_query` | - | - | Execute a single SQL query against a $SERVICE_SHORT. This command returns column metadata, result rows, affected row count, and execution time. Multi-statement queries are not supported.
**WARNING**: can execute destructive SQL including INSERT, UPDATE, DELETE, and DDL commands. | -| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT. Use `tiger_service_list` to find $SERVICE_SHORT IDs. | -| | `query` | βœ“ | The SQL query to execute. Single statement queries are supported. | -| | `parameters` | - | Query parameters for parameterized queries. Values are substituted for the `$n` placeholders in the query. | -| | `timeout_seconds` | - | The query timeout in seconds. Default: `30`. | -| | `role` | - | The $SERVICE_SHORT role/username to connect as. Default: `tsdbadmin`. | -| | `pooled` | - | Use [connection pooling][Connection pooling]. This is only available if you have already enabled it for the $SERVICE_SHORT. Default: `false`. | +| Command | Parameter | Required | Description | +|--------------------------|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `service_list` | - | - | Returns a list of the $SERVICE_SHORTs in the current $PROJECT_SHORT. | +| `service_get` | - | - | Returns detailed information about a $SERVICE_SHORT. | +| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT (10-character alphanumeric string). | +| | `with_password` | - | Set to `true` to include the password in the response and connection string.
**WARNING**: never do this unless the user explicitly requests the password. | +| `service_create` | - | - | Create a new $SERVICE_SHORT in $CLOUD_LONG.
**WARNING**: creates billable resources. | +| | `name` | - | Set the human-readable name of up to 128 characters for this $SERVICE_SHORT. | +| | `addons` | - | Set the array of [addons][create-service] to enable for the $SERVICE_SHORT. Options:
  • `time-series`: enables $TIMESCALE_DB
  • `ai`: enables the AI and vector extensions
Set an empty array for $PG-only. | +| | `region` | - | Set the [AWS region][cloud-regions] to deploy this $SERVICE_SHORT in. | +| | `cpu_memory` | - | CPU and memory allocation combination.
Available configurations are:
  • shared/shared
  • 0.5 CPU/2 GB
  • 1 CPU/4 GB
  • 2 CPU/8 GB
  • 4 CPU/16 GB
  • 8 CPU/32 GB
  • 16 CPU/64 GB
  • 32 CPU/128 GB
| +| | `replicas` | - | Set the number of [high-availability replicas][readreplica] for fault tolerance. | +| | `wait` | - | Set to `true` to wait for the $SERVICE_SHORT to be fully ready before returning. | +| | `timeout_minutes` | - | Set the timeout in minutes to wait for $SERVICE_SHORT to be ready. Only used when `wait=true`. Default: 30 minutes | +| | `set_default` | - | By default, the new $SERVICE_SHORT is the default for following commands in $CLI_SHORT. Set to `false` to keep the previous $SERVICE_SHORT as the default. | +| | `with_password` | - | Set to `true` to include the password for this $SERVICE_SHORT in response and connection string.
**WARNING**: never set to `true` unless user explicitly requests the password. | +| `service_fork` | - | - | Fork an existing $SERVICE_SHORT to create a new independent copy.
**WARNING**: creates billable resources. | +| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT to fork (10-character alphanumeric string). | +| | `fork_strategy` | βœ“ | Fork strategy:
  • `NOW`: fork at the current database state
  • `LAST_SNAPSHOT`:fork at last existing snapshot. This is the faster option
  • `PITR`: create a point-in-time recovery. You must also set the `target_time` parameter for PITR forks.
| +| | `target_time` | - | Set the target time for a `PIRT` `fork_strategy` in RFC3339 format. For example `2025-01-15T10:30:00Z`). | +| | `name` | - | Set the human-readable name for the forked $SERVICE_SHORT. Defaults to `{source-service-name}-fork`. | +| | `cpu_memory` | - | CPU and memory allocation combination. Inherits from source $SERVICE_SHORT if not specified.
Available configurations are:
  • shared/shared
  • 0.5 CPU/2 GB
  • 1 CPU/4 GB
  • 2 CPU/8 GB
  • 4 CPU/16 GB
  • 8 CPU/32 GB
  • 16 CPU/64 GB
  • 32 CPU/128 GB
| +| | `wait` | - | Set to `true` to wait for the forked $SERVICE_SHORT to be fully ready before returning. Default: `false`. | +| | `timeout_minutes` | - | Set the timeout in minutes to wait for forked $SERVICE_SHORT to be ready. Only used when `wait=true`. Default: 30 minutes | +| | `set_default` | - | By default, the forked $SERVICE_SHORT is set as the default for following commands in $CLI_SHORT. Set to `false` to keep the previous $SERVICE_SHORT as the default. | +| | `with_password` | - | Set to `true` to include the password for the forked $SERVICE_SHORT in response and connection string.
**WARNING**: never set to `true` unless user explicitly requests the password. | +| `service_update_password` | - | - | Update the password for the `tsdbadmin` for this $SERVICE_SHORT. The password change takes effect immediately and may terminate existing connections. | +| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT you want to update the password for. | +| | `password` | βœ“ | The new password for the `tsdbadmin` user. | +| `db_execute_query` | - | - | Execute a single SQL query against a $SERVICE_SHORT. This command returns column metadata, result rows, affected row count, and execution time. Multi-statement queries are not supported.
**WARNING**: can execute destructive SQL including INSERT, UPDATE, DELETE, and DDL commands. | +| | `service_id` | βœ“ | The unique identifier of the $SERVICE_SHORT. Use `tiger_service_list` to find $SERVICE_SHORT IDs. | +| | `query` | βœ“ | The SQL query to execute. Single statement queries are supported. | +| | `parameters` | - | Query parameters for parameterized queries. Values are substituted for the `$n` placeholders in the query. | +| | `timeout_seconds` | - | The query timeout in seconds. Default: `30`. | +| | `role` | - | The $SERVICE_SHORT role/username to connect as. Default: `tsdbadmin`. | +| | `pooled` | - | Use [connection pooling][Connection pooling]. This is only available if you have already enabled it for the $SERVICE_SHORT. Default: `false`. | [cloud-regions]: /use-timescale/:currentVersion:/regions/ [create-service]: /getting-started/:currentVersion:/services/ diff --git a/ai/mcp-server.md b/ai/mcp-server.md index 9e82771484..078cd598e8 100644 --- a/ai/mcp-server.md +++ b/ai/mcp-server.md @@ -207,7 +207,7 @@ start $MCP_LONG: } ``` -## $MCP_LONG commands +## $MCP_LONG tools @@ -230,4 +230,4 @@ You can use the following $CLI_LONG global flags when you run $MCP_SHORT: [cloud-regions]: /use-timescale/:currentVersion:/regions/ [readreplica]: /use-timescale/:currentVersion:/ha-replicas/read-scaling/ [manual-config]: /ai/:currentVersion:/mcp-server/#manually-configure-the-tiger-mcp-server - \ No newline at end of file + From c9d8fbf4a7fbd2d0b2d9223ed840734acfb188c8 Mon Sep 17 00:00:00 2001 From: Anastasiia Tovpeko <114177030+atovpeko@users.noreply.github.com> Date: Mon, 3 Nov 2025 12:53:38 +0200 Subject: [PATCH 06/10] Link to support portal + fix duplication (#4541) --- _partials/_support-plans.md | 7 ++++--- about/pricing-and-account-management.md | 4 ++-- getting-started/try-key-features-timescale-products.md | 5 +++++ self-hosted/configuration/timescaledb-config.md | 6 ------ 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/_partials/_support-plans.md b/_partials/_support-plans.md index 61cbcd1c9c..744bb18156 100644 --- a/_partials/_support-plans.md +++ b/_partials/_support-plans.md @@ -1,8 +1,9 @@ $COMPANY runs a global support organization with Customer Satisfaction (CSAT) scores above 99%. -Support covers all timezones, and is fully staffed at weekend hours. +Support covers all timezones and is fully staffed at weekend hours. All paid $PRICING_PLANs have free Developer Support through email with a target response time of 1 business day; we are often faster. If you need 24x7 responsiveness, talk to us about -[Production Support][production-support]. +[Production Support][production-support]. With Production Support, you can request help at any time at our [Support portal][support-portal]. -[production-support]: https://www.timescale.com/support \ No newline at end of file +[production-support]: https://www.timescale.com/support +[support-portal]: https://portal.support.timescale.com/login \ No newline at end of file diff --git a/about/pricing-and-account-management.md b/about/pricing-and-account-management.md index 75757e0303..baaf802e8f 100644 --- a/about/pricing-and-account-management.md +++ b/about/pricing-and-account-management.md @@ -50,7 +50,7 @@ If you create a $ACCOUNT_LONG from AWS Marketplace, the pricing options are pay- -## $COMPANY support +## $CLOUD_LONG support @@ -103,7 +103,7 @@ When you get $CLOUD_LONG at AWS Marketplace, the following pricing options are a -## $COMPANY support +## $CLOUD_LONG support diff --git a/getting-started/try-key-features-timescale-products.md b/getting-started/try-key-features-timescale-products.md index 1a65536eb0..d76c2b8e36 100644 --- a/getting-started/try-key-features-timescale-products.md +++ b/getting-started/try-key-features-timescale-products.md @@ -12,6 +12,7 @@ import HypercoreIntroShort from "versionContent/_partials/_hypercore-intro-short import HypercoreDirectCompress from "versionContent/_partials/_hypercore-direct-compress.mdx"; import NotAvailableFreePlan from "versionContent/_partials/_not-available-in-free-plan.mdx"; import NotSupportedAzure from "versionContent/_partials/_not-supported-for-azure.mdx"; +import SupportPlans from "versionContent/_partials/_support-plans.mdx"; # Try the key features in $COMPANY products @@ -410,6 +411,10 @@ data loss during failover. For more information, see [High availability][high-availability]. +## $CLOUD_LONG support + + + What next? See the [use case tutorials][tutorials], interact with the data in your $SERVICE_LONG using [your favorite programming language][connect-with-code], integrate your $SERVICE_LONG with a range of [third-party tools][integrations], plain old [Use $COMPANY products][use-timescale], or dive into [the API][use-the-api]. diff --git a/self-hosted/configuration/timescaledb-config.md b/self-hosted/configuration/timescaledb-config.md index 4b01ae3d76..c94aaf1104 100644 --- a/self-hosted/configuration/timescaledb-config.md +++ b/self-hosted/configuration/timescaledb-config.md @@ -11,12 +11,6 @@ import MultiNodeDeprecation from "versionContent/_partials/_multi-node-deprecati # $TIMESCALE_DB configuration and tuning -Just as you can tune settings in $PG, $TIMESCALE_DB provides a number of configuration -settings that may be useful to your specific installation and performance needs. These can -also be set within the `postgresql.conf` file or as command-line parameters -when starting $PG. -when starting $PG. - ## Distributed hypertables From bbc4669613d3a1654ce3705751415b0059dd8d11 Mon Sep 17 00:00:00 2001 From: Iain Cox Date: Mon, 3 Nov 2025 14:10:34 +0100 Subject: [PATCH 07/10] chore: update logo in the readme. (#4542) --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d80f6e3900..a583f3a6a2 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@
- - + + Tiger Data logo
From 2eed5f8df7462d3b21c196addbb5618fa59db8b3 Mon Sep 17 00:00:00 2001 From: Philip Krauss <35487337+philkra@users.noreply.github.com> Date: Mon, 3 Nov 2025 17:38:18 +0100 Subject: [PATCH 08/10] Remove table access method option (#4543) This option no longer exists Signed-off-by: Philip Krauss <35487337+philkra@users.noreply.github.com> --- api/hypercore/alter_table.md | 1 - 1 file changed, 1 deletion(-) diff --git a/api/hypercore/alter_table.md b/api/hypercore/alter_table.md index ffffa3acd5..1289c38f45 100644 --- a/api/hypercore/alter_table.md +++ b/api/hypercore/alter_table.md @@ -66,7 +66,6 @@ ALTER TABLE SET (timescaledb.enable_columnstore, timescaledb.compress_segmentby = ' [, ...]', timescaledb.sparse_index = '(), ()' timescaledb.compress_chunk_time_interval='interval', - SET ACCESS METHOD { new_access_method | DEFAULT }, ALTER SET NOT NULL, ADD CONSTRAINT UNIQUE (, ... ) ); From b044285c168c25577e7c11b3c8bf0e7f684cb22c Mon Sep 17 00:00:00 2001 From: Iain Cox Date: Tue, 4 Nov 2025 08:43:03 +0000 Subject: [PATCH 09/10] Apply suggestions from code review Co-authored-by: Philip Krauss <35487337+philkra@users.noreply.github.com> Signed-off-by: Iain Cox --- _partials/_early_access_2_23_0.md | 2 +- use-timescale/write-data/insert.md | 4 +--- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/_partials/_early_access_2_23_0.md b/_partials/_early_access_2_23_0.md index 268b2f2ec4..62f3c93c3c 100644 --- a/_partials/_early_access_2_23_0.md +++ b/_partials/_early_access_2_23_0.md @@ -1 +1 @@ -Early access: [TimescaleDB v2.23.0](https://github.com/timescale/timescaledb/releases/tag/2.23.0) +Tech preview: [TimescaleDB v2.23.0](https://github.com/timescale/timescaledb/releases/tag/2.23.0) diff --git a/use-timescale/write-data/insert.md b/use-timescale/write-data/insert.md index b43c11809a..3d79f95444 100644 --- a/use-timescale/write-data/insert.md +++ b/use-timescale/write-data/insert.md @@ -69,9 +69,7 @@ time | location | temperature | humidity ## Direct compress on INSERT -When you create a $HYPERTABLE using [CREATE TABLE ... WITH ...][hypertable-create-table], $TIMESCALE_DB creates a -[columnstore policy][add_columnstore_policy] that automatically converts your data to the $COLUMNSTORE after an interval -that matches the default [chunk_interval][create_table_arguments]. This columnar format enables fast scanning and +This columnar format enables fast scanning and aggregation, optimizing performance for analytical workloads while also saving significant storage space. In the $COLUMNSTORE conversion, $HYPERTABLE chunks are compressed by up to 98%, and organized for efficient, large-scale queries. From 8c159e324e3433a4914aa9efd9cf586cd7447048 Mon Sep 17 00:00:00 2001 From: Raja Yogan Date: Tue, 4 Nov 2025 16:42:17 +0530 Subject: [PATCH 10/10] Update _use-case-transport-geolocation.md (#4501) Hinting about the tuple decompression limit error and how to set it to zero. Signed-off-by: Raja Yogan Co-authored-by: Iain Cox --- _partials/_use-case-transport-geolocation.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/_partials/_use-case-transport-geolocation.md b/_partials/_use-case-transport-geolocation.md index e92679180a..e9ef5b9f3d 100644 --- a/_partials/_use-case-transport-geolocation.md +++ b/_partials/_use-case-transport-geolocation.md @@ -26,7 +26,20 @@ data by time and location. UPDATE rides SET pickup_geom = ST_Transform(ST_SetSRID(ST_MakePoint(pickup_longitude,pickup_latitude),4326),2163), dropoff_geom = ST_Transform(ST_SetSRID(ST_MakePoint(dropoff_longitude,dropoff_latitude),4326),2163); ``` - This updates 10,906,860 rows of data on both columns, it takes a while. Coffee is your friend. + This updates 10,906,860 rows of data on both columns, it takes a while. Coffee is your friend. + + You might run into this error while the update happens + + `Error: tuple decompression limit exceeded by operation + Error Code: 53400 + Details: current limit: 100000, tuples decompressed: 10906860 + Hint: Consider increasing timescaledb.max_tuples_decompressed_per_dml_transaction or set to 0 (unlimited).` + + To fix this, use + + ```sql + SET timescaledb.max_tuples_decompressed_per_dml_transaction TO 0; + ```