Connect to a Database and Reverse Engineer

If you are reverse engineering from a database, you must connect to the database to complete the process. The parameters on the Database Connection dialog are displayed based on the database you select.

Follow these steps:

  1. Complete the following fields on the Database Connection dialog:
    Database

    Specifies the database that you want to connect to.

    Authentication

    Specifies the type of authentication to use to connect. Select one of the following options:

    Windows Authentication

    Uses Windows user names and passwords to access the database. The user name you provide here must be the dbo of the database.

    Note: This option is available only for Oracle and SQL Server.

    Database Authentication

    Specifies the User Name and Password for the connection.

  2. Complete the following fields, as appropriate for the selected database:
    Azure Synapse
    Connection Method

    Specifies the type of connection you want to use. Select JDBC to connect using JDBC. Or, select ODBC to connect using the ODBC data source that you have defined.

    ODBC Data Source

    Specifies the data source to which you want to connect. The drop-down list displays the data sources that are defined on your computer.

    Note: Reverse engineering a model from a database using the ODBC connection retrieves only 64 characters.

    Invoke ODBC Administrator

    Specifies whether you want to start the ODBC Administrator software and display the Select Data Source dialog. You can then select a previously defined data source, or create a data source.

    Connection String

    Specifies the connection string based on your JDBC instance and Azure Synapse database namein the following format:

    jdbc: sqlserver://<server name>.sql.azuresynapse.net:1433;

    For example, jdbc:sqlserver://localhost.sql.azuresynapse.net:1433;

    Database

    Specifies the name of the database that you want to connect to.

    SQL Server
    Connection Type

    Specifies the type of connection you want to use. Select Use Native Connection to connect using the API provided by the SQL Server Native client software. Select Use ODBC Data to connect using the ODBC data source that you have defined. Select Use JDBC Connection to connect using JDBC.

    Server

    Specifies the name of the server where the database is installed.

    Database

    Specifies the name of the database that you want to connect to.

    Use Encrypted Connection

    Indicates that the SQL Server connection that is being established is encrypted to guarantee privacy.

    ODBC Data Source

    Specifies the data source to which you want to connect. The drop-down list displays the data sources that are defined on your computer.

    Invoke ODBC Administrator

    Specifies whether you want to start the ODBC Administrator software and display the Select Data Source dialog. You can then select a previously defined data source, or create a data source.

    Instance

    Specifies the JDBC instance to which you want to connect.

    Connection String

    Specifies the connection string based on your JDBC instance and SQL Server database name in the following format:

    jdbc:sqlserver://<servername>:1433;instanceName=MSSQLSERVER;databaseName=<SqlDBname>

    For example, jdbc:sqlserver://localhost:1433;instanceName=MSSQLSERVER;databaseName=SqlDB

    SQL Azure
    Connection Type

    Specifies the type of connection you want to use. Select Use Native Connection to connect using the API provided by the SQL Server Native client software. Select Use ODBC Data to connect using the ODBC data source that you have defined. Select Use JDBC Connection to connect using JDBC.

    Server

    Specifies the name of the server where the database is installed.

    Note: You may need to append the SQL Azure server name to the login in the connection string using the <login>@<server> notation. If you do, separate the login and the SQL Azure server name with the at (@) symbol. For more information, see Connecting to SQL Azure.

    Database

    Specifies the name of the database that you want to connect to.

    Use Encrypted Connection

    Indicates that the SQL Server connection that is being established is encrypted to guarantee privacy.

    ODBC Data Source

    Specifies the data source to which you want to connect. The drop-down list displays the data sources that are defined on your computer.

    Invoke ODBC Administrator

    Specifies whether you want to start the ODBC Administrator software and display the Select Data Source dialog. You can then select a previously defined data source, or create a data source.

    Instance

    Specifies the JDBC instance to which you want to connect.

    Connection String

    Specifies the connection string based on your JDBC instance and SQL Server database name in the following format:

    jdbc:sqlserver://<servername>:<port>;database=<Databasename>
    For example, jdbc:sqlserver://localhost:1433;databaseName=SqlDB

    Connect to Managed Instance

    Specifies whether the connection should be to an Azure SQL Managed Instance.

    Note: erwin Data Modeler 2020 R2 SP2 supports Azure AD accounts connection via ODBC.

    SAP ASE
    Connection Method

    Specifies the type of connection you want to use. Select Use Native Connection to connect using the API provided by the SQL Server Native client software. Select Use JDBC Connection to connect using JDBC.

    Server

    Specifies the name of the server where the database is installed.

    Database

    Specifies the name of the database that you want to connect to.

    Connection String

    Specifies the connection string based on your JDBC instance and SAP ASE database name in the following format:

    jdbc:sybase:Tds:<servername>:5000

    For example, jdbc:sybase:Tds:localhost:5000

    SAP IQ
    Server

    Specifies the name of the server where the database is installed.

    Database

    Specifies the name of the database that you want to connect to.

    Oracle
    Connection String

    Specifies the connection string (TNSNames entry).

    Connect as SYSDBA

    Specifies that you want to connect to Oracle as SYSDBA. Select the check box.

    ODBC/Generic, Db2 LUW, Hive, Informix, Db2 for i, MySQL, Netezza, PostgreSQL, Progress, Redshift, SAS, and Teradata
    Metastore Database

    Specifies the relational database that stores the metadata for Hive tables and partitions in a relational database. This parameter is specific to Hive.

    Note: Ensure that you install the drivers that correspond to the Metastore Database that you select.

    ODBC Data Source

    Specifies the data source to which you want to connect. The drop-down list displays the data sources that are defined on your computer.

    Invoke ODBC Administrator

    Specifies whether you want to start the ODBC Administrator software and display the Select Data Source dialog. You can then select a previously defined data source, or create a data source.

    Note: For FE or Alter Script process, on the Hive Connection dialog, always set the Metastore Database to Default and the ODBC Data Source to relevant Hive connection driver.

    Db2/zOS, Db2 LUW
    Alternate Catalog

    Specifies the name of the alternate catalog that you want to use for the connection. If you leave this value empty, the application connects to the system catalog. If necessary, consider connecting to the alternate catalog for faster reverse engineering.

    MariaDB

    You can connect to a MariaDB database using Generic ODBC driver. The connection parameters are as follows:

    ODBC Data Source

    Specifies the data source to which you want to connect. The drop-down list displays the data sources that are defined on your computer.

    Invoke ODBC Administrator

    Specifies whether you want to start the ODBC Administrator software and display the Select Data Source dialog. You can then select a previously defined data source, or create a data source.

    Database

    Specifies the name of the database that you want to connect to.

    Snowflake

    You can connect to a Snowflake database using Generic ODBC driver or a JDBC driver. Based on your selection under Connection Method, the connection parameters are as follows:

    ODBC Generic

    ODBC Data Source

    Specifies the data source to which you want to connect. The drop-down list displays the data sources that are defined on your computer.

    Invoke ODBC Administrator

    Specifies whether you want to start the ODBC Administrator software and display the Select Data Source dialog. You can then select a previously defined data source, or create a data source.

    JDBC

    Connection String

    Specifies the connection string based on your JDBC instance and Snowflake database name. For example, jdbc:snowflake://<account_name>.snowflakecomputing.com/

    Connection String is a mandatory parameter.

    Database

    Specifies the name of the database that you want to connect to.

    Database is a mandatory parameter.

    Warehouse

    Specifies the name of the warehouse that you want to connect to.

    Warehouse is a mandatory parameter.

    Role

    Specifies the role that you want to use to connect to the database.

    Role is a mandatory parameter.

    Schema

    Specifies the name of the schema that you want to connect to.

Note: erwin Data Modeler (DM) 32-bit version does not support JDBC connectivity.