Get started

Tacnode in 10 Minutes

Welcome to Tacnode! This quick-start guide will walk you through setting up your first database environment and running your first queries in just 10 minutes.

πŸ“‹ What You'll Learn

By the end of this guide, you'll know how to:

  • βœ… Create and configure your Tacnode environment
  • βœ… Connect to your database using psql
  • βœ… Create databases and tables
  • βœ… Insert, query, and update data

🎯 Step 1: Prerequisites

Before we begin, you'll need to complete these quick setup steps:

πŸ“ Create Your Tacnode Account

  1. Visit the signup page: Go to Tacnode Signup
  2. Register with your email: New users can quickly register using any email address

πŸ’» Install psql Client

You'll need the PostgreSQL command-line client to connect to Tacnode:

πŸ’‘ Tip: psql is the standard way to interact with PostgreSQL-compatible databases like Tacnode


βš™οΈ Step 2: Set Up Your Environment

πŸ—οΈ Create Your Data Cloud

The Data Cloud is your dedicated workspace where all data operations happen.

  1. Log in to Tacnode
  2. Navigate to the Data Cloud management page
  3. Click "Create Data Cloud" to set up your workspace

πŸ“š Learn more: Data Cloud Documentation

πŸ–₯️ Create Your Nodegroup

A Nodegroup is Tacnode's compute engine that processes all your database operations (DDL, DML, queries).

  1. Access Nodegroup management in one of two ways:
    • From Data Cloud Center β†’ Nodegroup
    • Direct URL: https://<cloud_regionid>-app.tacnode.io
  2. Click "+Nodegroup" to create your compute instance

πŸ“š Learn more: Nodegroup Documentation
🌍 Regions: Check supported regions


πŸ”Œ Step 3: Connect to Your Database

🌐 Enable Public Access

By default, Nodegroups use VPC networking. For this tutorial, we'll enable public access:

  1. Go to your Nodegroup details page
  2. Click the network settings
  3. Enable public network access
  4. Copy the connection details provided

πŸ”— Connect Using psql

Use the following command template to connect:

psql -U <Account> -d postgres -h <Host> -p 5432

Where:

  • <Account>: Your Tacnode account username
  • <Host>: The public domain name from the connection details

πŸ” Security Note: You'll be prompted for your password when connecting


πŸ—„οΈ Step 4: Create Your First Database

Now that you're connected, let's create your first database and table!

πŸ“Š Create a Database

Create a new database called tac_test:

CREATE DATABASE tac_test;

Switch to your new database:

postgres=# \c tac_test
You are now connected to database "tac_test" as user "judy".
tac_test=#

βœ… Success! You're now working in your new database

πŸ“‹ Create a Table

Let's create a simple cars table to store vehicle information:

CREATE TABLE cars (
  brand VARCHAR(255),
  model VARCHAR(255),
  year INT
);

Verify your table was created:

tac_test=# CREATE TABLE cars (
  brand VARCHAR(255),
  model VARCHAR(255),
  year INT
);
CREATE TABLE
 
tac_test=# \d cars
                       Table "public.cars"
 Column |          Type          | Collation | Nullable | Default
--------+------------------------+-----------+----------+---------
 brand  | character varying(255) |           |          |
 model  | character varying(255) |           |          |
 year   | integer                |           |          |

πŸŽ‰ Great! Your table is ready for data


πŸ“ Step 5: Work with Your Data

Now let's add some data and run queries to see Tacnode in action!

βž• Insert Data

Add your first record to the cars table:

INSERT INTO cars (brand, model, year)
VALUES ('Ford', 'Mustang', 1964);

Result:

tac_test=# INSERT INTO cars (brand, model, year)
VALUES ('Ford', 'Mustang', 1964);
INSERT 0 1

βœ… Success! One row inserted

πŸ” Query Your Data

Let's see what we've stored:

SELECT * FROM cars;

Result:

tac_test=# SELECT * FROM cars;
 brand |  model  | year
-------+---------+------
 Ford  | Mustang | 1964
(1 row)

🎯 Perfect! Your data is there and ready to query

πŸ”„ Update Data

Let's modify the existing record:

UPDATE cars
SET model = 'NEWMustang'
WHERE brand = 'Ford';

Result:

tac_test=# UPDATE cars
SET model = 'NEWMustang'
WHERE brand = 'Ford';
UPDATE 1
 
tac_test=# SELECT * FROM cars;
 brand |   model    | year
-------+------------+------
 Ford  | NEWMustang | 1964
(1 row)

πŸŽ‰ Excellent! Your data has been successfully updated


🎊 Congratulations!

You've successfully completed the Tacnode 10-minute quickstart! Here's what you accomplished:

βœ… Set up your Tacnode environment
βœ… Connected to your database
βœ… Created a database and table
βœ… Inserted, queried, and updated data

πŸš€ Next Steps

Ready to explore more? Here are your next steps:

πŸ’¬ Need Help?

  • πŸ“– Browse our full documentation
  • πŸ’¬ Join our community forums
  • πŸ“§ Contact our support team

Happy querying with Tacnode! πŸš€