{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Guides","type":"markdown"},"seo":{"title":"Squirrel SQL Install and Use With TD","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"squirrel-sql-install-and-use-with-td","__idx":0},"children":["Squirrel SQL Install and Use With TD"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SQuirreL SQL is an open-source Java SQL Client program for any JDBC compliant database. You can use SQuirrelSQL as a SQL authoring tool to interactively develop SQL queries with Treasure Data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your screens might be different from these."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#install-squirrel"},"children":["Install SQuirrel"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#download-treasure-data-jdbc-driver"},"children":["Download Treasure Data JDBC Driver"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#add-treasure-data-jdbc-driver"},"children":["Add Treasure Data JDBC Driver"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#connect-to-treasure-data"},"children":["Connect to Treasure Data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#issue-the-query"},"children":["Issue the Query"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"install-squirrel","__idx":1},"children":["Install SQuirrel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download the latest SQuirreL SQL installer as a JAR file:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://squirrel-sql.sourceforge.net/"},"children":["SQuirrel SQL: Download and Installation"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you execute the JAR file, the installer starts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," to proceed through the installation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-193727.064c6b5fe669d7fb5d5ef348370b5e6e9de7a8df51eae0f92c660074747d0826.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only the Standard pack is required for Treasure Data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-193807.36e99493b92194c7dfc4ba4f4a58cdbbd038840fcdf04d45c7548cdf749de3b2.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the installation is complete, launch SQuirreL SQL."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-193842.4de3fe4cfa3256c8bb5bfb23bdb5d4073565d6accae1a7d4e75378ad33ddda60.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"download-treasure-data-jdbc-driver","__idx":2},"children":["Download Treasure Data JDBC Driver"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download Treasure Data’s JDBC Driver:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/queries/hive/quickstart"},"children":["JDBC Driver Download"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then, put the driver into the SQuirreL SQL's driver directory."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ mv td-jdbc-0.2.10-jar-with-dependencies.jar /Applications/SQuirreLSQL.app/Contents/Resources/Java/lib/\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The target directory is $SQUIRREL_SQL_INSTALL_PATH/lib/ on Windows and Linux."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"add-treasure-data-jdbc-driver","__idx":3},"children":["Add Treasure Data JDBC Driver"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Drivers"]}," in the left pane, and select + (the plus sign) to add a new driver."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-193933.43b37841230774f8f96bfd84c73d14f9552178187a8edafe94ffc0b2fc27b4b0.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete the information as shown in the following example."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-194037.7cbd2746ef8fad06618e5812c9b4b688b08fb4f161e4164362b5a865d3f10ee3.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Name: Treasure Data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example URL:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hive: jdbc:td://api.treasuredata.com/< database >;useSSL=true;type=hive"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Presto: jdbc:td://api.treasuredata.com/< database >;useSSL=true;type=presto"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Java Class Path: td-jdbc-xxx.jar"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Class Name: com.treasuredata.jdbc.TreasureDataDriver"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"connect-to-treasure-data","__idx":4},"children":["Connect to Treasure Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the Aliases tab on the left pane and select + (the plus sign) to add the Alias."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-194148.77623ce0cede48db62b548e37ac161a3514de0100dc2dac0e539345fb50c1c7f.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Name: Whatever you like"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Driver: Treasure Data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["URL: jdbc:td://api.treasuredata.com/< YOUR_DATABASE_NAME >;useSSL=true"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["User Name: Your account email"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Password: Your account password"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test"]}," when the forms are filled. If the information is correct, you receive the message",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Connection is successful."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-194247.4462526e81f2e910ad23e4025c88d3cd25dc3366570bcd35eea64c11f8a74121.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OK"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"issue-the-query","__idx":5},"children":["Issue the Query"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You’ll see a list of tables and their columns by GUI."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-194326.719fb1e669819b72229df000280dffbd178785df9d36452b43e44971fc50ba0a.60bcc915.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Move to the SQL pane, and edit the SQL query to be thrown. Select ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ctrl + Enter"]}," when the query is ready. The query runs and then shows the results. You can check the progress of the query from the Treasure Console."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190926-194409.9ed1d272fbd11ee0553c1b1861fb8959468fff29b75ef48e5cd75de71ce2ebc1.60bcc915.png","alt":""},"children":[]}]}]},"headings":[{"value":"Squirrel SQL Install and Use With TD","id":"squirrel-sql-install-and-use-with-td","depth":1},{"value":"Install SQuirrel","id":"install-squirrel","depth":1},{"value":"Download Treasure Data JDBC Driver","id":"download-treasure-data-jdbc-driver","depth":1},{"value":"Add Treasure Data JDBC Driver","id":"add-treasure-data-jdbc-driver","depth":1},{"value":"Connect to Treasure Data","id":"connect-to-treasure-data","depth":1},{"value":"Issue the Query","id":"issue-the-query","depth":1}],"frontmatter":{"seo":{"title":"Squirrel SQL Install and Use With TD"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tools/cli-and-sdks/squirrel-sql-install-and-use-with-td","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}