PhpStorm 2021.2 Help

Other

To create a data source, you need a JDBC driver. There are two types of drivers in PhpStorm: with Complete Support and with Basic Support. You can see a list of database vendors with complete and basic support on the Drivers tab in the Data Sources and Drivers dialog. Also, note that user-created drivers are considered as drivers with basic support.

  • Complete Support includes such features as enhanced code completion and better retrieval of database objects (introspection). For example, with complete support, you will see the following objects in the corresponding databases: user-defined types in Apache Cassandra, macros in Apache Hive, extensions in PostgreSQL. Also, all inspections, quick-fixes, and other code assistance features are available for databases with the complete support.

  • Basic Support has code highlighting and displays objects that were retrieved by the JDBC driver. PhpStorm uses JDBC metadata for database introspection and the SQL 2016 dialect for code highlighting. No errors are detected and highlighted.

    The introspection with JDBC metadata means that some specific database objects will not appear in the database tree view. Code completion will not include objects that were not retrieved during introspection.

drivers with complete and basic

Creating data sources from drivers with basic support

There are two ways to create data sources from drivers with basic support.

  • Using the Other submenu

  • Using user driver files

Using the Other submenu

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

  2. In the Data Sources and Drivers dialog, you can use Data Sources and Drivers tabs to create a data source.

    • Data Sources: click the Add icon (The Add icon) and navigate to Other. In this submenu, select the driver that you want to use for the data source creation.

    • Drivers: click the Drivers tab and select the necessary driver. In the settings of this driver, click Create Data Source.

  3. At the bottom of the data source settings area, click the Download missing driver files link. As you click this link, PhpStorm 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. 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.

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

drivers-that-have-basic-support

Using user driver files

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

  2. In the Data Sources and Drivers dialog, ensure that you are on the Drivers tab.

  3. In the Data Sources and Drivers dialog, click the Add icon (The Add icon).

  4. In the Name field, type the name of the driver.

  5. In the Driver Files pane, click the Add icon (The Add icon) and select Custom JARs.

  6. Navigate to the JAR file of the JDBC driver, select it, and click OK.

  7. In the Class field, specify the value that you want to use for the driver.

  8. Click Apply.

  9. To create a data source from the driver's dialog, click Create Data Source.

    Connect to a database with a user driver

Library paths for user drivers

To work properly, some JDBC drivers require a path to library files along with the driver.

For example, to determine if the application should operate in the Instant Client mode, Oracle Instant Client (OCI) applications look for library files in the runtime library search path (LD_LIBRARY_PATH on Linux or PATH on Windows). You can set these paths in the Data Sources and Drivers dialog.

Adding library paths

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

  2. In the Data Sources and Drivers dialog, click the driver entry to which you want to add a path to library files.

  3. (Optional) Add a driver for which you want to add library files. If the existing driver does not meet the requirements, replace the existing driver. To delete the existing driver entry, select the driver and click Remove. For more information about adding a driver, see create a connection to a database with a JDBC driver.

  4. In the Driver files pane, click the Add icon (The Add icon) and select Native Library Path.

  5. Navigate to the folder with library files. Ensure that the driver version corresponds to the version of these library files. For example, if you use the driver version 19.6, the attached library files must also have the 19.6 version.

    Working with the Native Library Path

Productivity tips

Create a data source from the JDBC URL

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

  2. In the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Data Source from URL.

  3. In the URL field, paste the JDBC URL.

  4. From the Driver list, select the necessary driver for the data source.

  5. In the Data Sources and Drivers dialog, enter credentials.

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

Create a data source from the JDBC URL
Last modified: 16 August 2021