This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Oracle JDBC for Windows

This tutorial shows how to set up a data source and connect to an Oracle® database using the Database Explorer app or the command line. This tutorial uses the Oracle Database 11g Release 2 (11.2.0.3) JDBC driver for use with JDK™ 1.6 to connect to an Oracle 11g Enterprise Edition Release 11.2.0.1.0 database.

Step 1. Verify the driver installation.

If the JDBC driver for Oracle is not installed on your computer, find the link on the Driver Installation page to install the driver. Follow the instructions to download and install this driver on your computer.

Step 2. Set up the operating system authentication.

Windows® authentication enables you to connect to a database using your system or network user name and password. In this case, the database does not require a different user name and password. Windows authentication facilitates connecting to the database and maintaining database access credentials. After you add the required libraries to the system path, the Oracle JDBC driver enables connectivity using Windows authentication. The following steps show how to add these libraries to the Java® library path in MATLAB®. For details about Java libraries, see Java Class Path (MATLAB).

  1. Ensure that you have the latest Oracle OCI libraries installed on your computer. To install the latest library, see Driver Installation.

  2. Run the prefdir function in the Command Window. The output of this command is a file path to the MATLAB preferences folder on your computer. For details, see prefdir.

  3. Close MATLAB.

  4. Navigate to the folder from step 2, and create a file named javalibrarypath.txt in the folder.

  5. Open javalibrarypath.txt and insert the path to the Oracle OCI libraries. The entry must include the full path to the library files. The entry must not contain the library file names. The following is an example of the path: C:\DB_Libraries\instantclient_11_2. Save and close javalibrarypath.txt.

  6. In the environment variables of the advanced system settings, add the Oracle OCI library full path to the Windows Path environment variable.

  7. Restart MATLAB.

Step 3. Set up the data source.

You can set up a data source using the JDBC Data Source Configuration dialog box, which you can open from the Database Explorer app or at the command line.

  1. Open the Database Explorer app by clicking the Apps tab on the MATLAB Toolstrip. Then, on the right of the Apps section, click the Show more arrow to open the apps gallery. Under Database Connectivity and Reporting, click Database Explorer. Alternatively, enter databaseExplorer at the command line.

  2. In the Data Source section, select Configure Data Source > Configure JDBC data source.

    Or, enter configureJDBCDataSource at the command line.

    The JDBC Data Source Configuration dialog box opens.

  3. In the Name box, enter the name of your data source. (This example uses a data source named ORA.) You use this name to establish a connection to your database. If you enter a name that duplicates an existing ODBC data source name, the Database Explorer app appends _JDBC to the name after you save it.

  4. From the Vendor list, select ORACLE.

    Note

    To use the full entry from your tnsnames.ora file, select OTHER instead and enter the full entry in the resulting URL box. Then, enter the full path to the JDBC driver file in the Driver Location box and the name of the driver in the resulting Driver box. Save the JDBC data source. For details about these steps, see Other ODBC-Compliant or JDBC-Compliant Databases.

  5. In the Driver Location box, enter the full path to the JDBC driver file.

  6. In the Database box, enter the name of your database.

    The name can be the service name or the Oracle system identifier (SID), depending on your specific Oracle database setup. For details, see your tnsnames.ora file, which is often stored in <ORACLE_HOME>\NETWORK\ADMIN, where <ORACLE_HOME> is the folder containing the installed database or Oracle client.

  7. In the Server box, enter the name of your database server. Consult your database administrator for the name of your database server. In the Port Number box, enter the port number.

  8. To establish the data source with Windows authentication, set Driver Type to oci.

    Or, to establish the data source without Windows authentication, set Driver Type to thin.

  9. Click Test. The Test Connection dialog box opens. Enter the user name and password for your database. If you are connecting with Windows authentication, then leave these boxes blank. Click Test.

    If your connection succeeds, the Database Explorer dialog box displays a message indicating the connection is successful. Otherwise, it displays an error message.

  10. Click Save. The JDBC Data Source Configuration dialog box displays a message indicating the data source is saved successfully. Close this dialog box.

After you complete the data source setup, connect to the Oracle database using the Database Explorer app or JDBC driver and command line.

Step 4. Connect using the Database Explorer app or the command line.

Connect to Oracle Using Database Explorer App

  1. On the Database Explorer tab, in the Data Source section, click New Query.

  2. In the Connect to a Data Source dialog box, connect to your database with Windows authentication by selecting the data source you defined from the Data Source list. Leave the Username and Password boxes blank. Click Connect.

    Or, connect to your database without Windows authentication by selecting the data source you defined. Enter a user name and password. Click Connect.

    The Catalog and Schema dialog box opens.

  3. In the Schema list, select the schema. Click OK.

    The Database Explorer app connects to the database and displays database tables in the Data Browser pane. A data source tab appears to the right of the pane. The title of the data source tab is the data source name that you defined during the setup. The data source tab contains empty SQL Query and Data Preview panes.

  4. Select tables in the Data Browser pane to query the database.

  5. Close the data source tab to close the SQL query and the database connection.

    Tip

    To close the database connection, close all tabs that have titles beginning with the name of the corresponding data source. For example, if the data source name is ORA, and two tabs named ORA and ORA1 are open, then close both tabs.

    To close all database connections, close the Database Explorer app.

Connect to Oracle Using JDBC Driver and Command Line

  1. To connect with Windows authentication, use the configured JDBC data source and specify a blank user name and password. For example, this code assumes that you are connecting to a JDBC data source named ORA_Auth.

    datasource = "ORA_Auth";
    username = "";
    password = "";
    conn = database(datasource,username,password);

    Or, to connect without Windows authentication, use the configured JDBC data source and specify the user name username and the password pwd. For example, this code assumes that you are connecting to a JDBC data source named ORA.

    datasource = "ORA";
    username = "username";
    password = "pwd";
    conn = database(datasource,username,password);

    If you have trouble using the database function, use the full entry from your tnsnames.ora file in the URL string as one consecutive line. Leave the first argument blank. For example, this code assumes that the value of the 'URL' name-value pair argument is set to the specified tnsnames.ora file entry for an Oracle database.

    conn = database('','username','pwd', ...
        'Vendor','Oracle', ...
        'URL',['jdbc:oracle:thin:@(DESCRIPTION = ' ...
        '(ADDRESS = (PROTOCOL = TCP)(HOST = sname)' ...
        '(PORT = 123456)) (CONNECT_DATA = ' ...
        '(SERVER = DEDICATED) (SERVICE_NAME = dbname) ) )']);
  2. Close the database connection.

    close(conn)

See Also

Apps

Functions

Related Topics