You can access the Data Stores page from Settings > Team > Data Stores.
Data Stores Page Overview
The Data Stores page allows you to manage connections to external PostgreSQL databases. Registered database connections can be used within workflows using the Data Store Node and Data Query Node. Currently, the following databases are supported:- PostgreSQL: Connect to PostgreSQL databases and execute SQL queries
Verified Services
The following PostgreSQL hosting services have been verified to work:- Neon
- Supabase
- Supabase does not support Direct connection. When obtaining the connection string, select Transaction pooler or Session pooler.
Plan-Based Quotas
The number of Data Stores you can create is limited based on your team’s subscription plan.Quotas by Plan
| Plan | Data Stores Limit |
|---|---|
| Free | 0 (unavailable) |
| Pro | 10 |
| Team | 20 |
Checking Usage
The Data Stores page displays your current usage:- Used / Maximum: Example: “3 / 10 stores”
- Remaining: Example: “7 Data Stores remaining in your Pro plan.”
- Plan name: Your current plan (Free, Pro, Team)
Managing Plan Limits
When you reach the maximum capacity:-
An alert is displayed:
- Title: “Maximum capacity reached”
- Message: “Delete an existing store or upgrade your plan in Team Settings to add more Data Stores.”
-
New Data Store button is disabled:
- Hover over the button to see a tooltip explaining why
- “You’ve reached the maximum number of Data Stores included in your plan.”
-
How to proceed:
- Delete an existing Data Store
- Upgrade your plan in Team Settings
For Free Plan Users
Data Stores are not available on the Free plan:-
Locked state is displayed:
- Title: “Data Stores are locked”
- Message: “Upgrade to the Pro or Team plan to connect PostgreSQL databases and use Data Stores in your agents.”
-
Warning alert:
- “Data Stores are not included in the Free plan”
- “Upgrade to Pro or Team to connect PostgreSQL databases with Data Stores.”
-
How to upgrade:
- Click the View plans button to go to Team Settings
- Upgrade to the Pro or Team plan
For more details about plans, see Plans Information.
Creating a Data Store
Navigate to Data Stores Settings
Go to Settings > Team > Data Stores in Giselle.
Enter Connection Information
Configure the following fields:The following
Name
Enter a name for the Data Store (e.g., “Production Database”, “Analytics DB”). This helps you identify the connection later.Connection String
Enter the PostgreSQL connection string.The connection string is encrypted and stored securely. For security reasons, the connection string is not displayed in the UI once saved.
Currently, only IPv4 addresses are supported. Databases using IPv6 addresses cannot be connected.
SSL Connection (sslmode)
You can control the SSL connection mode by specifying thesslmode parameter in the connection string.sslmode options are available:| sslmode | Description |
|---|---|
disable | Do not use SSL |
allow | Try non-SSL first, then SSL if that fails |
prefer | Try SSL first, then non-SSL if that fails |
require | Require SSL, but do not verify the certificate |
verify-ca | Require SSL and verify the CA certificate |
verify-full | Require SSL and verify the CA certificate and hostname |
For security,
verify-full is recommended.Managing Data Stores
Viewing Data Stores
The Data Stores page displays all Data Stores for your team with the following information:- Name: The descriptive name you set
- ID: The unique identifier for the Data Store
- Action Menu: Options for editing and deleting
Editing a Data Store
To edit a Data Store:- Select Edit from the action menu (three dots)
- The “Edit Data Store” dialog opens
- You can update the following fields:
Name
You can change the name of the Data Store.Update connection string
Check the checkbox to update the connection string.When updating the connection string, you must enter the new connection string completely. For security reasons, the existing connection string is not displayed.
- Click Save to save your changes
Deleting a Data Store
To delete a Data Store:- Select Delete from the action menu
- Confirm in the “Delete Data Store” dialog
- Execute the deletion
Error Messages
The following errors may occur:- Name is required: Please enter a name
- Connection string is required: Please enter a connection string
- Invalid connection string format: The connection string format is incorrect
- Connection string must use postgresql:// or postgres:// protocol: The protocol is incorrect
- Connection string must include a host: The connection string must include a host
- Connection to private or internal IP addresses is not allowed: Connections to private IPs are not allowed
- Unable to resolve hostname: Cannot resolve the hostname
- IPv6 addresses are not supported: IPv6 addresses are not supported
- Data store not found: Data Store not found
- No DataStore node connected to DataQuery node: Data Store Node is not connected to Data Query Node
- DataStore node is not configured: Data Store Node is not configured
- Data Stores are not included in your plan: Your plan does not support Data Stores
- You’ve reached the maximum number of Data Stores included in your plan: Quota limit reached
Using Data Stores
Registered database connections can be used with the following Nodes:- Data Store Node: Select a database connection
- Data Query Node: Execute SQL queries against the Data Store