Skip to main content

Amazon Timestream Database Table Cleanup Tool

This Python CLI tool allows you to delete all tables in a specified Amazon Timestream database.

Features

  • List all tables in a Timestream database
  • Delete multiple tables (with user confirmation)
  • Detailed logging

Requirements

  • Python 3.12+
  • AWS credentials with Timestream permissions

Installation

  1. Clone this repository:

    git clone https://github.com/jbsilva/timestream-cleaner.git
    cd timestream-cleaner
    
  2. Install the required dependencies:

    uv sync
    

    Or use the Setup Python Environment VS Code task.

Usage

To delete all tables in a Timestream database:

timestream-cleaner [OPTIONS] DATABASE_NAME

Options:

  • --region TEXT: AWS region for Timestream database (default: eu-west-1)
  • --help: Show help message and exit

Example:

timestream-cleaner --region eu-west-2 my-database

Permissions

Required IAM permissions:

  • timestream:ListTables
  • timestream:DeleteTable

Development

To contribute to this project:

  1. Fork the repository
  2. Create a new branch for your feature
  3. Implement your changes
  4. Run tests
  5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This tool can permanently delete data. Use with caution and always backup your data before running deletion operations.

Metadata

Release files for timestream-cleaner 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for timestream-cleaner 0.1.0
File Size Uploaded
timestream_cleaner-0.1.0.tar.gz 5.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for timestream-cleaner 0.1.0
File Interpreter ABI Platform
timestream_cleaner-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 10.4 kB

Release files / timestream_cleaner-0.1.0.tar.gz

Download URL timestream_cleaner-0.1.0.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
ffd2210b9c1beacec80db93e1b092ac7aba692007c4a664a6ef966221d38b0b8
BLAKE2b-256 checksum
How to use checksums
5be34bca21e752420ff84975385d4cca84c0b818b4b689262f621ffd6c37d59f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.18

Release files / timestream_cleaner-0.1.0-py3-none-any.whl

Download URL timestream_cleaner-0.1.0-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b626a1b33733045fa5b796bf008fb854db3308908e744e9c301ad2d275ce82d1
BLAKE2b-256 checksum
How to use checksums
aa5dac034af7754185d617dbae55222a7a0767eef2931b859d37f2b31a789c6d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.18

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page