Skip to main content

​
Intro

Amazon Aurora is a MySQL and PostgreSQL compatible relational database built for the cloud that combines the performance and availability of high-end commercial databases with the simplicity and cost-effectiveness of open source databases. Use the Amazon Aurora Partition connector to efficiently and securely bring in the data from your database based on number of past days provided. Once your data is in Domo, you can provide the transparency with real-time and interactive dashboards to the managers and stakeholders. You can set up alerts to be notified of changes in your key data points, and access all your data in real time, from any device. To learn more about the Amazon Aurora API, visit https://aws.amazon.com/rds/aurora/. You connect to your Amazon Aurora account in the Data Center. This topic discusses the fields and menus that are specific to the Amazon Aurora Partition connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

​
Prerequisites

To connect to your Amazon Aurora account and create a DataSet, you must have the following:
  • The username and password you use to log into your database
  • The hostname or IP address of your database server
  • The port number for your database
  • The database name or schema name
You can also include the URL where your SSL CA Certificate is located, though this is optional.

​
Connecting to Your Amazon Aurora Account

This section enumerates the options in the Credentials and Details panes in the Amazon Aurora Partition Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

​
Credentials Pane

This pane contains fields for entering credentials to connect to your Amazon Aurora account. The following table describes what is needed for each field:

Field

Description

Username Enter your database username.
Password Enter your database password.
Host Enter the hostname or IP address of your database server. Example: db.company.com
Port Enter the port number for your database server.
Database Name Enter your database name.
CA Certificate (optional) Enter the URL where the SSL CA Certificate is located.
Once you have entered valid credentials, you can use the same account any time you go to create a new Amazon Aurora Partition DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

​
Details Pane

In this pane you create an SQL query to pull data from your database and specify the attributes to partition your data.

Menu

Description

Query Enter the SQL query to execute.
Database Table Select the database table.
Partition Column Name Select partition column name.
Past Days Enter the number of past days you want to get data for. Value can be a positive integer. For example: 30.
Date Format Select the required date format. By default, yyyy-MM-dd will be used.
TinyInt Values Treated as Bit (Boolean) Values Select Yes if you want the tiny integer values to be treated as boolean values, else select No.
Cast Boolean Values To… Select whether the String or Integer boolean values will be cast to within your dataset.
String: False/True
Integer: 0/1

​
FAQs

You need the username, password, hostname or IP address, port number, and database name associated with your database. You can also include the URL where your SSL CA certificate is located, though it is optional.
To get a certificate bundle that contains both the intermediate and root certificates for all AWS Regions, download from https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem.If your application is on Microsoft Windows and requires a PKCS7 file, you can download the PKCS7 certificate bundle. This bundle contains both the intermediate and root certificates at https://truststore.pki.rds.amazonaws.com/global/global-bundle.p7b.
Note:Amazon RDS Proxy and Aurora Serverless use certificates from the AWS Certificate Manager (ACM). If you are using RDS Proxy, you don’t need to download Amazon RDS certificates or update applications that use RDS Proxy connections. For more information about using TLS/SSL with RDS Proxy, see Using TLS/SSL with RDS Proxy.If you are Aurora Serverless, downloading Amazon RDS certificates isn’t required. For more information about using TLS/SSL with Aurora Serverless, seeUsing TLS/SSL with Aurora Serverless v1.
Limits depend on your server configuration.
Datasets can run as often as every 15 minutes. However, depending on the runtime of the query, datasets may need to run less frequently.
Make sure that all the words, table names, and field names are correctly spelled.
Before you can connect to your database, you must also whitelist a number of IP addresses on your database server on the port you want to connect to. For the full list of IP addresses, see Whitelisting IP Addresses.
In the Amazon Aurora connector, you need to select a JDBC driver to connect to your database. The Amazon Aurora connector gives you a choice to write an SQL query with or without the query parameter. It allows you to select the database table and table columns. It also provides a Query Helper to guide you in writing an SQL query.The Amazon Aurora Partition connector supports partitioning, thus optimizing your database performance. You need to select the table name and partition column name. You also need to specify the number of past days you want to get data for. It gives you a choice if you want your TinyInt values to be treated as String or Integer, though it’s optional. You can select the Date format for your data to be retrieved.

​
Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.