{"id":27627181,"url":"https://github.com/treasure-data/td","last_synced_at":"2025-04-23T13:53:23.494Z","repository":{"id":1480425,"uuid":"1725847","full_name":"treasure-data/td","owner":"treasure-data","description":"CUI Interface","archived":false,"fork":false,"pushed_at":"2025-04-22T10:54:24.000Z","size":213541,"stargazers_count":49,"open_issues_count":23,"forks_count":21,"subscribers_count":86,"default_branch":"master","last_synced_at":"2025-04-22T11:40:55.113Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://toolbelt.treasuredata.com","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/treasure-data.png","metadata":{"files":{"readme":"README.rdoc","changelog":"ChangeLog","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-05-10T02:04:48.000Z","updated_at":"2024-06-17T15:07:31.000Z","dependencies_parsed_at":"2023-01-13T11:10:49.121Z","dependency_job_id":"ee8759ac-5284-4ea8-8fe7-7c532fa536ee","html_url":"https://github.com/treasure-data/td","commit_stats":{"total_commits":1278,"total_committers":46,"mean_commits":"27.782608695652176","dds":0.7018779342723005,"last_synced_commit":"3f3015674c32ae61bb839cf7f5627c26a85299d9"},"previous_names":[],"tags_count":169,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/treasure-data%2Ftd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/treasure-data%2Ftd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/treasure-data%2Ftd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/treasure-data%2Ftd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/treasure-data","download_url":"https://codeload.github.com/treasure-data/td/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250237825,"owners_count":21397400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-23T13:53:22.843Z","updated_at":"2025-04-23T13:53:23.486Z","avatar_url":"https://github.com/treasure-data.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Treasure Data command line tool\n{\u003cimg src=\"https://circleci.com/gh/treasure-data/td.svg?style=svg\" alt=\"Build Status\" /\u003e}[https://circleci.com/gh/treasure-data/td.svg?style=svg]\n{\u003cimg src=\"https://ci.appveyor.com/api/projects/status/github/treasure-data/td?branch=master\u0026svg=true\" alt=\"appveyor\" /\u003e}[https://ci.appveyor.com/project/treasure-data/td/branch/master]\n{\u003cimg src=\"https://coveralls.io/repos/treasure-data/td/badge.svg?branch=master\u0026service=github\" alt=\"Coverage Status\" /\u003e}[https://coveralls.io/github/treasure-data/td?branch=master]\n\nThis CUI utility wraps the {Ruby Client Library td-client-ruby}[https://github.com/treasure-data/td-client-ruby]\nto interact with the REST API in managing databases and jobs on the Treasure Data Cloud.\n\nFor more info about Treasure Data, see \u003chttps://www.treasuredata.com/\u003e.\n\nFor full documentation see \u003chttps://docs.treasuredata.com/\u003e.\n\n= Getting Started\n\nInstall td command as a gem.\n\n    \u003e gem install td\n\nSee help message for details.\n\n    \u003e td\n\nYou need to authorize the account, before executing any other commands.\n\n    \u003e td account\n\n= Sample Workflow\n\n    \u003e td account -f                       # authorize an account\n    user: k@treasure-data.com\n    password: **********\n    \u003e td database:create mydb             # create a database\n    \u003e td table:create mydb www_access     # create a table\n\n= Packaging\n\n== Mac OS X\n\nDisable RVM or rbenv and use ruby.pkg's ruby (/usr/local/td/ruby/bin/ruby).\nAnd then run following commands:\n\n    $ /usr/local/td/ruby/bin/gem install bundler rubyzip\n    $ /usr/local/td/ruby/bin/bundle install\n    $ /usr/local/td/ruby/bin/rake pkg:build\n\nIt uses https://github.com/treasure-data/ruby-osx-packager\n\n== Windows\n\nInstall following binary packages:\n\n  * MinGW with MSYS Basic System and using mingw-get-inst\n  * Git for Windows, with Windows Command Prompt support\n  * Ruby ruby-1.9.3p327 using RubyInstaller for Windows, with PATH update\n  * Inno Setup 5\n\nThen run following commands on MinGW Shell:\n\n    $ mingw-get install msys-vim\n    $ mingw-get install msys-wget\n    $ gem install bundler rubyzip\n    $ bundle install  # don't use \"--path\" option\n    $ rake exe:build  # don't use \"bundle exec\"\n\n== Bulk Import\n\nSome of the +td+ commands prefixed with +td+ +import+ leverages the {Java Bulk Import CLI td-import-java}[https://github.com/treasure-data/td-import-java]\nto process and Bulk load data in the Treasure Data Cloud.\n\nThe Bulk Import CLI is downloaded automatically at the first call to any of the command that require it; the use will\nneed internet connectivity in order to fetch the Bulk Import CLI JAR file from the\n{Central Maven repository}[https://repo1.maven.org/maven2/com/treasuredata/td-import/]\nand take advantage of these advanced features. If you need to setup a proxy, please consult this\n{documentation}[https://docs.treasuredata.com/display/public/INT/Legacy+Bulk+Import+Tips+and+Tricks#LegacyBulkImportTipsandTricks-UsingaProxyServer] page.\n\nThe log levels and properties of the Bulk Import CLI can be configured in a +logging.properties+ file. A default\nconfiguration is provided in a file within the gem or Toolbelt folder root, in the +java/+ folder. If you wish to\ncustomize it, please make a copy of this file and store it in the:\n\n    ~/.td/java             folder on Mac OSX or Linux\n    %USERPROFILE%\\.td\\java folder on Windows\n\n== Testing Hooks\n\nThe CLI implements several hooks to enable/disable/trigger special behaviors.\nThese hooks are expressed as environment variables and can therefore be provided in several ways:\n\n=== How to Use\n\n* Unix / Linux / MacOSX\n  * environment variable export in the shell the command is executed. The setting remains active until the shell is closed. E.g.:\n\n        $ export TD_TOOLBELT_DEBUG=1\n\n  * in the shell configuration file, to be active in any new shell that is opened. E.g.: add\n\n        export TD_TOOLBELT_DEBUG=1\n\n    to \u003ctt\u003e~/.bashrc\u003c/tt\u003e or equivalent shell configuration file.\n    To make the setting active in the current shell, source the configuration file, e.g.:\n\n        $ source ~/.bashrc\n\n  * on the command line at runtime (active only for the duration of the command). E.g.:\n\n        $ TD_TOOLBELT_DEBUG=1 td ....\n\n  * as alias on in the current shell. The setting remains active until the shell is closed. E.g.:\n\n        $ alias td='TD_TOOLBELT_DEBUG=1 td'\n\n  * as alias in configuration file, to be active in any new shell that is opened. E.g.:\n\n        alias td='TD_TOOLBELT_DEBUG=1 td'`\n\n    to \u003ctt\u003e~/.bashrc\u003c/tt\u003e or equivalent shell configuration file.\n    To make the setting active in the current shell, source the configuration file, e.g.:\n\n        $ source ~/.bashrc\n\n* Windows\n  * in the command prompt the command is executed. The setting remains active until the command prompt window is closed. E.g.:\n\n        cmd\u003e set TD_TOOLBELT_DEBUG=1\n\n  * as a global environment variable in the system settings. It will be active for all new command prompt windows.\n\nThese are the available hooks:\n\n* Enable debugging mode:\n\n    $ TD_TOOLBELT_DEBUG=1\n\n* JAR auto update (enabled by default is not specified). This setting does not affect \u003ctt\u003eimport:jar_update\u003c/tt\u003e:\n  * Enable:\n\n      $ TD_TOOLBELT_JAR_UPDATE=1\n\n  * Disable:\n\n      $ TD_TOOLBELT_JAR_UPDATE=0\n\n* Specify an alternative endpoint to use updating the toolbelt (default: http://toolbelt.treasuredata.com):\n\n    $ TD_TOOLBELT_UPDATE_ROOT=\"http://toolbelt.treasuredata.com\"\n\n* Specify an alternative endpoint to use updating the JAR file (default: https://repo1.maven.org):\n\n    $ TD_TOOLBELT_JARUPDATE_ROOT=\"https://repo1.maven.org\"\n\n\n= Copyright\n\nCopyright:: Copyright (c) 2015 Treasure Data Inc.\nLicense::   Apache License, Version 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftreasure-data%2Ftd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftreasure-data%2Ftd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftreasure-data%2Ftd/lists"}