The easiest way to connect to a database to Periscope is through an SSL JDBC connection. Below is what is needed to get connected.
This is the name of the database as it is configured on the database server.
Databases connect slightly differently depending on their types so it is important to select the correct database type when connecting a database.
The database host is the web address at which Periscope can find the database. The database host needs to be publicly accessible via the internet and accepting connections from the Periscope IP addresses: 184.108.40.206 and 220.127.116.11. Databases that sit within firewall or private network will either need to have traffic from the Periscope IP addresses forwarded to the database or utilize an SSH Tunnel.
For Snowflake databases which decouple storage from computation, a warehouse needs to be specified for query processing. Once specified, Periscope will continue to use the same warehouse to run every query.
Each database type has a default port through which it accepts connections. If the database has not been configured to use a special port, it is likely accepting connections through these ports:
This is the username and the corresponding password that Periscope will connect to the database with. Periscope currently supports password authentication to a database and cannot accept connections utilizing public key authentication. It is recommended that a user is created specifically for Periscope to access the database.
If the database is sitting within a private network or behind a firewall an SSH Tunnel is a great way to connect to the database to Periscope. These are the pieces of information required to make that connection.
While all other connection components will remain the same as an SSL JDBC connection when connecting using SSH, the database host will now be an internal address that does not have to be publicly accessible.
This is the public facing URL or IP address of the server that is listening for SSH connections.
This is the username that has been created on the SSH host at the operating system level that has been authorized with the Periscope public key. For more information on setting up the SSH host, check out Periscope's Private Network SSH Tunnels docs.
The default SSH port is 22, but if the SSH host server is configured to listen for SSH connections on a different port, that should be entered instead.