A Carbon datasource is an RDBMS or a custom datasource created using the management console of WSO2 Data Services Server (WSO2 DSS). You can simply use that as the datasource for a data service. A Carbon datasource is persistent, and can be used whenever required.
Creating a Carbon datasource
See Managing Datasources for instructions on how to create a Carbon datasource. Be sure to copy the JDBC driver relevant to the database engine to one of the locations given below.
- If the driver is a JAR file, add it to the
<PRODUCT_HOME>/repository/components/libdirectory, so that it will be converted to an OSGI bundle and copied to thedropinsdirectory during server startup. For example, if you are using MySQL, you would specifycom.mysql.jdbc.Driveras the driver and would copymysql-connector-java-5.XX-bin.jarto this directory. - If the driver is already an OSGI bundle, you can directly add it to the
<PRODUCT_HOME>/repository/components/dropinsdirectory.
If you do not copy the driver to the relevant directory, you will get an exception similar to "Cannot load JDBC driver class com.mysql.jdbc.Driver" when you create the datasource.
Creating a data service using the Carbon datasource
Follow the instructions in exposing an RDBMS as a data service and when you get to the Add New Data Source screen, select Carbon Data Source as the data source type. You get a drop-down list from which an existing Carbon data source can be selected as shown below.