# Setting up a distant database

Available in...

* Big Data Platform
* Data Fabric
* Data Management Platform
* Data Services Platform
* MDM Platform
* Real-Time Big Data Platform

* Available in:
* Big Data Platform
* Data Fabric
* Data Management Platform
* Data Services Platform
* MDM Platform
* Real-Time Big Data Platform

Talend DQ Portal is deprecated from Talend 7.1 onwards.

By default, Talend Studio stores reports and analyses in an embedded HSQL database.

From the Profiling perspective, you can set up an other default distant database to store reports and analysis results. You will then be able to share the results of the analyses with other users.

## Before you begin

You have selected the Profiling perspective.

## Procedure

1. In the menu bar, select Window &gt; Preferences to display the Preferences window.
2. Start typing Reporting in the filter field and then select Reporting from the list to open the Reporting page.

   ![](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/reporting_db.png)
3. In the DB Type list, select the name of the database you want to define.

   By default, your Studio stores reports and analysis results in an embedded HSQL database. You cannot share reports and analysis results when stored in the HSQL database.
4. Define the connection parameters in the individual connection fields or directly in the Url field.

   When you modify any parameter in the Url field, it is modified automatically in the individual fields and vice versa.
   * Available in:
   * Big Data Platform
   * Data Fabric
   * Data Management Platform
   * Data Services Platform
   * MDM Platform
   * Real-Time Big Data Platform

   In the DB Name, you must use the same database name that is defined when installing Talend DQ Portal.
   | Database | Details |
   | --- | --- |
   | MySQL | In the DB Name<br>field, you can:<br><br><ul> <li>Use the default database name                                                  (<kbd>talend_dq</kbd>). In this                                                  database, you can have access to all analyses and                                                  results of generated reports.</li> <li>Enter a database name (catalog) that does not                                                  exist in your database. A catalog will be created                                                  and the required tables to store analyses and                                                  reports will be generated.</li> <li>Enter a database name that exists in the                                                  database. <p>If there is no data mart structure in                                                  this database, it will be created.</p> <p>If the                                                  data mart structure already exists but is a lower                                                  version that the current one, the data mart                                                  structure is updated.</p>If the data mart                                                  structure already exists but is an higher version                                                  that the current one, you cannot use this data                                                  mart structure.<div> <div><span>Information note</span><span>Note:</span> Database names with a                                                  dot "<kbd>.</kbd>" are allowed.</div> </div> </li> <li> <p>When using the IPV6 address format for a local                                                  MySQL, configure the database connection using the                                                  logical hostname,                                                  <kbd>localhost</kbd>, and map this in                                                  the hosts file to the IPV6 local address,                                                  <kbd>[::1]</kbd>. Otherwise the                                                  startup of the <span>Talend DQ Portal</span> fails.</p> </li> <li> <p>You can connect to an Azure forMySQL                                                  database.</p> </li> </ul> |
   | Oracle with SID<br><br>Oracle with service<br>name<br><br>Oracle OCI | <ul> <li>Fill the <span>SID</span> or the                                                  <span>Service Name</span> field with the                                                  name of an existing database.</li> <li>Fill the <span>Schema</span> field                                                  with an Oracle schema to which the specified user                                                  in the <span>User</span> field has                                                  access, or leave it blank. If you leave this field                                                  blank, your reports will be written to the default                                                  schema of the defined user. <div> <div><span>Information note</span><span>Note:</span> The collation of the                                                  schema must be case sensitive. Otherwise the                                                  columns may not be analyzed and will be missing                                                  from the report. For more information, see the                                                  <a href="https://docs.oracle.com/en/database/oracle/oracle-database/18/nlspg/linguistic-sorting-and-matching.html#GUID-2AC4EE67-D3C0-4E26-87AD-2DA4584F874A" target="_blank">Oracle                                                  documentation</a>.</div> </div> </li> </ul> |
   | PostgreSQL | <ul> <li>Fill in the connection information to the                                                  database. You can use only the default schemas                                                  when you create the data mart on this                                                  database.<div><span>Information note</span><span>Note:</span> Database                                                  names with a dot "<kbd>.</kbd>" or an                                                  hyphen "<kbd>-</kbd>" are                                                  allowed.</div> </li> <li>You can connect to an Azure for PostgreSQL or                                                  an Azure SQL database.<p>When connecting to an                                                  Azure for PostgreSQL database, use the                                                  <kbd>username@hostname</kbd> syntax                                                for the <span>User</span> field and leave                                                the <span>Additional parameters</span>                                                field empty.</p> </li> <li>You can use only the default schemas of PostgreSQL                                                when you create the data mart on it.</li> </ul> |
   | Microsoft SQL Server | <ul> <li>Fill in the connection information to the                                                  database.<div><span>Information note</span><span>Note:</span> Database names with a dot                                                  "<kbd>.</kbd>" or an hyphen                                                  "<kbd>-</kbd>" are allowed.                                                  <p>To enable writing reports to the defined                                                  database, make sure that the specified user has                                                  enough system privileges.</p> </div> </li> <li>You can use only the default schemas of Microsoft                                                SQL Server when you create the data mart on it.</li> <li>If you want to connect via Windows authentication,                                                leave the <span>User</span> and                                                  <span>Password</span> fields empty.                                                  <p>When creating a connection to a Microsoft SQL                                                  Server database to store reports and analysis                                                  results, both <span>Microsoft</span> and                                                  <span>Open source JTDS</span> drivers                                                  are supported.</p> </li> <li>The collation used by the Microsoft SQL Server                                                database must be case-insensitive, otherwise the                                                report generation may not succeed. You may encounter                                                the following error: <span>java.sql.SQLException:                                                  Invalid column name 'rep_runtime'</span>. For                                                more information about collation rules, check <a href="https://docs.microsoft.com/en-us/sql/t-sql/statements/windows-collation-name-transact-sql?view=sql-server-2017" target="_blank">Microsoft                                                documentation</a>.</li> <li>For more information about setting up a connection                                                to a Microsoft SQL Server database, see <a href="https://help.qlik.com/talend/en-US/studio-user-guide/7.3/what-you-need-to-know-about-some-databases" target="_blank">What you need to know about some databases</a>.</li> </ul> |
5. If you have not selected HSQL from the DB Type list, specify additional connection properties in the Additional parameters field.

   When connecting to a MySQL 8 database, configure the useSSL, requireSSL and serverTimezone property. Enter useSSL=false&requireSSL=false&serverTimezone=UTC for example.

   When connecting to an Azure SQL database, enter ssl=require.
6. Enter your login information to the database in the corresponding fields.
7. Optional: To export the data mart connection and the path of the report folder and logo as a context, click Export as context and follow the steps.

   For further information, see [Using context variables to connect to the report database](https://help.qlik.com/talend/en-US/studio-user-guide/7.3/using-context-variables-to-connect-to-report-database).

   You can click Revert Context to switch the connection back to its initial state.
8. Either:
   * Click Apply to report editors... to open a list from which you can select the reports which results you want to store in the defined datamart or context connection.
   * Click Apply to store the results of all analyses and reports in the defined database.
9. Click OK to validate the changes and close the Preferences window.

   When the version of the distant database created from the Profiling perspective of Talend Studio is older than that of the Talend Studio, a pop-up message is displayed to ask you if you want a database upgrade.