AppCode 2023.1 Help


  1. In the Database tool window ( View | Tool Windows | Database), click the Data Source Properties icon The Data Source Properties icon.

  2. On the Data Sources tab in the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Oracle.

  3. Check if there is a Download missing driver files link at the bottom of the data source settings area. As you click this link, AppCode downloads drivers that are required to interact with a database. The IDE does not include bundled drivers in order to have a smaller size of the installation package and to keep driver versions up-to-date for each IDE version.

    You can specify your drivers for the data source if you do not want to download the provided drivers. For more information about creating a database connection with your driver, see Add a user driver to an existing connection.

  4. From the Connection type list, select a connection type:

    • SID: to use a unique name of an Oracle instance (a process that runs on the workstation).

      To use a correct value, check the environment variable ORACLE_SID on the server host, or contact your database administrator. Commonly-used values are XE or ORCL.

    • Service name: to use an alias to an Oracle instance (or many instances).

    • TNS: to use tnsnames.ora configuration file. In the TNSADMIN field, specify a path to the folder with tnsnames.ora. In the TNS name field, specify what service name to use (see a value of net_service_name in tnsnames.ora) if you have more than one service.

      For more information about tnsnames.ora, see Local Naming Parameters in the tnsnames.ora file.

    • URL only: to use the JDBC URL.

  5. From the Driver list, specify the driver type. For more information about driver types, see Oracle JDBC FAQ.

  6. From the Authentication list, select the authentication technology that you want to use. The following options are available:

    • User & Password: use your login and password for a database.

    • Kerberos: use Kerberos for authentication.

    • No auth: connect to database by using connection URL only, no authentication is required.

  7. Specify database connection details. Alternatively, paste the JDBC URL in the URL field.

    To delete a password, right-click the Password field and select Set Empty.

  8. To ensure that the connection to the data source is successful, click the Test Connection link.

  9. (Optional) If you are connecting to a data source that contains a lot of databases and schemas, in the Schemas tab, select the schemas that you need to work with.

  10. Click OK to create the data source.

Last modified: 21 February 2023