Skip to content

Aurora DSQL

tag-outline Available since 25.3

This documentation outlines how to configure and use Aurora DSQL with Team Edition. For information on the service itself, see the official Amazon Aurora DSQL documentation.

To get started, select the Aurora DSQL driver when creating a new connection. For step-by-step instructions, see Creating a Connection.

Info

Team Edition can connect to Aurora DSQL using the Cloud Explorer.

Aurora DSQL specifics

Aurora DSQL is a serverless, distributed SQL database built for always-available cloud workloads. AWS handles infrastructure, scaling, and maintenance, so you don’t manage servers or plan capacity.

It’s PostgreSQL-compatible and keeps a familiar SQL experience, while adding cloud-native features like automatic scaling, and built-in high availability. Aurora DSQL is designed for fast multi-Region reads and writes, with strong data consistency and minimal downtime. Compared to a traditional PostgreSQL database, some system and administrative behaviors are different. These changes enable seamless scaling and high availability across Regions, which is the core strength of Aurora DSQL.

Setting up

This section provides an overview of Team Edition's settings for establishing a direct connection and the configuration of secure connections using SSH, SSL, Proxies, Kubernetes, and the setup of JDBC driver for Aurora DSQL.

Aurora DSQL connection settings

Configure the connection settings to connect Team Edition to your Aurora DSQL database.

Main tab

The Main tab of the connection settings requires you to fill in specific fields to establish the initial connection.

Field Description
Connect by (Host/URL) Choose whether you want to connect using a host or a URL.
URL If you are connecting via URL, enter the URL of your Aurora DSQL database here. This field is hidden if you are connecting via the host.
Host/Instance If you are connecting via host or instance, enter the address of your Aurora DSQL database here.
Database Enter the name of the Aurora DSQL database you want to connect to.
Show all databases Displays all databases in the database navigator.
Note: This option works only when the Host connection type is selected. It does not work when connecting via URL.
Port Enter the port number for your Aurora DSQL database.
Authentication Choose the type of authentication you want to use for the connection. For detailed guides on authentication types, please refer to the following articles:

- Aurora DSQL Auth
- DBeaver Profile Authentication
- PostgreSQL Kerberos
- PostgreSQL PgPass
- PostgreSQL SSPI (Windows SSO)
Connection Details Provide additional connection details if necessary.
Driver Name This field will be auto-filled based on your selected driver type.
Driver Settings If there are any specific driver settings, configure them here.

Advanced tab

The Advanced tab of the connection settings offers additional options that allow you to customize your further connection to the Aurora DSQL database.

Field Description
Session Role This option allows you to define a specific role that your database session assumes upon connection. Setting a session role can be useful for managing permissions and access control within your Aurora DSQL database.
Local Client Specify the local client, see our article about local client configuration.
Show template databases Displays template databases. This option is available when Show all databases is checked.
Show databases unavailable for connection Show databases not available for connection in database list. This option is available when Show all databases is checked.
Show databases statistics Displays statistics for databases.
Read all data types Reads all data types from the server (including arrays).
Read table keys with columns Enable reading table constraints during the column reading stage to ensure accurate recognition of keys. Note that this setting may decrease metadata loading performance.
Replace legacy timezone Replaces legacy timezone settings. Enable only if you need to connect with legacy timezones like Europe/Kyiv or Asia/Calcutta. Only these two timezones are affected.
Show $$ quote as Displays $$ quotes as code blocks or strings.
Show $tagName$ quote as Displays $tagName$ quotes as code blocks or strings.

Driver properties tab

Use the Driver properties tab to fine-tune how the JDBC driver connects to Aurora DSQL.

This tab exposes low-level JDBC parameters, such as timeouts, fetch behavior, binary transfer, and metadata handling.

Info

In most cases, the default values work well and don’t require changes.

Connection details

The Connection Details section in Team Edition allows for further customization of your Aurora DSQL connection. This includes options for adjusting the Navigator View, setting up Security measures, applying Filters, configuring Connection Initialization settings, and setting up Shell Commands. Each of these settings can significantly impact your database operations and workflow. For detailed guides on these settings, please refer to the following articles:

Aurora DSQL driver properties

The settings for Aurora DSQL Driver properties enable you to adjust the performance of the Aurora DSQL JDBC driver. These adjustments can influence the efficiency, compatibility, and features of your Aurora DSQL database.

You can customize the Aurora DSQL driver in Team Edition via the Edit Driver page, accessible by clicking on the Driver Settings button on the first page of the driver settings. This page offers a range of settings that can influence your Aurora DSQL database connections.

Info

For a comprehensive guide on these settings, refer to our Driver manager article.

Secure Connection Configurations

Team Edition supports secure connections to your Aurora DSQL database. Guidance on configuring such connections, specifically SSH, Proxy, Kubernetes, AWS SSM and SSL connections, can be found in various referenced articles. For a comprehensive understanding, please refer to these articles:

Secure Storage with Secret Providers

Team Edition supports various cloud-based secret providers to retrieve database credentials. For detailed setup instructions, see Secret Providers.

Powering Aurora DSQL with DBeaver

Team Edition provides a host of features designed for Aurora DSQL databases. This includes the ability to view schemas, along with numerous unique capabilities aimed at optimizing database operations.

Aurora DSQL database objects

Team Edition has extensive support for various Aurora DSQL metadata types, allowing you to interact with a wide variety of database objects, such as:

  • Databases
    • Schemas
      • Tables
        • Columns
        • Constraints
        • Dependencies
        • Rules
        • Policies
      • Views
      • Functions
      • Data types
    • Event Triggers
    • Extensions
    • Roles

Additional features

Category Feature
Data Transfer Data Import
Data Export
Data Visualization ERD Guide
Data Generation Mock Data Generation