v1.3.0

Spring Cleaning

Minimum Supported ThoughtSpot version

The minimum supported ThoughtSpot version has been raised to 7.1.1, versions prior to that are only incidentally supported.

Please consult with your Customer Success Manager and ThoughtSpot Support Engineer to ensure you have a recent version.

This release of the tools bring a lot of much-needed organization and cleanup. v1.3.0 comes the week before our annual customer conference, Beyond 2022. Along with plenty of cleanup, we have an official release on ThoughtSpot Community as well as Knowledge Articles on how to implement tools to achieve certain objectives.

Another big change in this release is the provisional release of Syncers. Syncers allow CS Tools to interact with a data storage layer without having to know the explicit details of how to do so. We've implemented syncers to many popular data storage formats. Head on over to the documentation page to learn more about them!

We've also released new tools for Scriptability, bulk User Management, and the Searchable family of tools have been vastly improved as well.

Try it now Scriptability

cs_tools tools scriptability

Hoping to bring more software development lifecycle to your platform, or simply need a better way to migrate between environments? Scriptability will help work with TML and perform other data change management activities -- and will only get better in the coming releases.

Try it now User Management

cs_tools tools user-management

Migrating authentication providers? Want to sync your users and groups from an external data format? Need to transfer all the content from one user to another? The commands under the User Management tool have you covered!

Added

Modified

Bugfix

CS Tools Internals

Syncers!.. interact with external data sources
User Management a collection of bulk user tools
Scriptability a 🔐 private tool to aid in migration activities

the minimum supported version of ThoughtSpot is now 7.1.1
Windows is hard, hopefully we've fixed the Instal & Activate scripts
cs_tools config create|modify now supports specifying a default config
cs_tools logs export now supports specifying a subset of the latest logfiles
Archiver now has much more sensible defaults
Bulk Deleter and Searchable are now public tools
Searchable is now a single tool with a larger data model

user/transfer/ownership now properly bulk transfers individually identified objects
nicer, less scary error formatting for known exceptional behavior
Bulk Deleter will no longer delete invalidly configured objects

we had a full project reorganization

<cs_tools>
├─ cs_tools/
│  ├─ api/     <---- contains rest_api_v1, models, middlewares, rest utilies
│  ├─ cli/     <---- powers the cli, contains all tools, cli utilities
│  ├─ data/    <---- database models, data transer objects, enums
│  ├─ sync/    <---- syncer protcol, registry, built-in syncers
│  ├─ ...
│  └─ thoughtspot.py
├─ docs/
│  ├─ ...
│  └─ ...
└─ tests/
   ├─ ...
   └─ ...

v1 of a dependency injection framework (mostly for the ThoughtSpot client itself)
new middlewares for tsload, tql, connection, and metadata
install distribution build is now automated.. and hopefully more resilient

(.cs_tools) C:\work\thoughtspot\cs_tools>cs_tools tools --private
Usage: cs_tools tools [--help] <tool>

  Run an installed tool.

  Tools are a collection of different scripts to perform different functions which aren't native to the ThoughtSpot or
  advanced functionality for clients who have a well-adopted platform.

Options:
  --version               Show the version and exit.
  -h, --help, --helpfull  Show this message and exit.

Commands:
  archiver              Manage stale answers and liveboards within your platform.
  bulk-deleter          Bulk delete metadata objects from your ThoughtSpot platform.
  extractor             Extract data from a worksheet, view, or table in your platform.
  rtql                  Enable querying the ThoughtSpot TQL CLI from a remote machine.
  rtsload               Enable loading files to ThoughtSpot from a remote machine.
  scriptability         Tool for easily migrating TML between clusters.
  searchable            Explore your ThoughtSpot metadata, in ThoughtSpot!
  security-sharing      Scalably manage your table- and column-level security right in the browser.
  sharding-recommender  Gather data on your existing Falcon tables for sharding.
  user-management       Managing Users and Groups in bulk.

To upgrade your environment , please download the latest distribution and run the install script.