{"library":"pytd","title":"pytd - Treasure Data Driver","description":"pytd is the official Treasure Data Driver for Python, providing a client for interacting with Treasure Data's services. It allows users to query data, load data into tables, and manage databases. The current version is 2.4.0, and it maintains a regular release cadence, typically with several updates per year.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install pytd"],"cli":{"name":"pytd","version":"sh: 1: pytd: not found"}},"imports":["from pytd.client import Client"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom pytd.client import Client\n\n# Set your Treasure Data API key and server in environment variables\n# e.g., export TD_API_KEY=\"YOUR_API_KEY\"\n# e.g., export TD_API_SERVER=\"https://api.treasuredata.com\"\n\napi_key = os.environ.get('TD_API_KEY', '')\napi_server = os.environ.get('TD_API_SERVER', 'https://api.treasuredata.com')\n\nif not api_key:\n    print(\"Warning: TD_API_KEY environment variable not set. Client may fail to authenticate.\")\n\ntry:\n    # Initialize the client\n    client = Client(apikey=api_key, endpoint=api_server)\n\n    # List databases\n    databases = client.list_databases()\n    print(f\"Databases: {[db.name for db in databases]}\")\n\n    # Example: Execute a simple query (replace 'sample_datasets' and 'www_access' with your actual db/table)\n    # This part requires a valid database and table to exist in your Treasure Data account.\n    if databases and len(databases) > 0:\n        first_db_name = databases[0].name\n        print(f\"Using first database found: {first_db_name}\")\n        # Example query (uncomment and modify with an actual table in your account):\n        # query_result = client.query(f'SELECT count(*) FROM {first_db_name}.your_table_name_here')\n        # print(f\"Query result count: {query_result.fetchall()[0][0]}\")\n    else:\n        print(\"No databases found or API key/server invalid.\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    print(\"Please ensure your TD_API_KEY and TD_API_SERVER are correctly set and accessible, and you have network connectivity.\")","lang":"python","description":"This quickstart initializes a `pytd` client using environment variables for the API key and server. It then demonstrates how to list available databases. For actual data querying or loading, ensure your Treasure Data API key is valid and you have existing databases/tables that the client can access.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"2.2.0","pypi_latest":"2.4.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":50,"avg_install_s":11,"avg_import_s":1.71,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pytd","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pytd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":11.5,"import_time_s":1.31,"mem_mb":39.9,"disk_size":"344M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pytd","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pytd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":11,"import_time_s":1.91,"mem_mb":45.5,"disk_size":"361M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pytd","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pytd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.7,"import_time_s":2,"mem_mb":44.4,"disk_size":"346M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pytd","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pytd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.6,"import_time_s":1.98,"mem_mb":45.5,"disk_size":"345M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pytd","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pytd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":11.2,"import_time_s":1.35,"mem_mb":37,"disk_size":"203M"}]}}