Main Content

close

Close and invalidate database and driver resource utilizer

Syntax

Description

example

close(object)closes and invalidates the database and driver resource utilizerobjectto free up database and driver resources.

Examples

collapse all

Connect to a Microsoft® SQL Server® database and verify the database connection. Then, import data from the database into MATLAB®. Determine the highest unit cost among the retrieved products in the table. Close the database connection.

创建一个n ODBC database connection to a Microsoft® SQL Server® database with Windows® authentication. Specify a blank user name and password. The database contains the tableproductTable.

datasource ='MS SQL Server Auth';conn = database(datasource,'','');

Check the database connection. If theMessageproperty is empty, the connection is successful.

conn.Message
ans = []

Select all data fromproductTableand sort it by the product number.datais a table containing the imported data that results from executing the SQLSELECTstatement.

selectquery ='SELECT * FROM productTable ORDER BY productNumber';data = select(conn,selectquery);

Display the first three rows of data.

data(1:3,:)
ans = 3×5 table productNumber stockNumber supplierNumber unitCost productDescription _____________ ___________ ______________ ________ __________________ 1 4.0035e+05 1001 14 'Building Blocks' 2 4.0031e+05 1002 9 'Painting Set' 3 4.01e+05 1009 17 'Slinky'

Determine the highest unit cost in the table.

max(data.unitCost)
ans = 24

Close the database connection.

close(conn)

创建一个database connection using a JDBC driver. To create this connection, you must configure a JDBC data source. For more information, see theconfigureJDBCDataSourcefunction. Then, create aDatabaseDatastoreobject and close it.

创建一个database connection to the JDBC data sourceMSSQLServerJDBCAuth. This data source configures a JDBC driver to a Microsoft® SQL Server® database with Windows® authentication. Specify a blank user name and password.

datasource ="MSSQLServerJDBCAuth";用户名="";password ="";conn = database(datasource,username,password);

创建一个DatabaseDatastoreobject using the database connection and an SQL query. This SQL query retrieves all data from theairlinesmalltable.

sqlquery ="select * from airlinesmall";dbds = databaseDatastore(conn,sqlquery);

Close theDatabaseDatastoreobject and the database connection.

close(dbds)

Input Arguments

collapse all

Database and driver resource utilizer, specified as one of the objects described in this table.

Object Argument Name Object Name Object Description Object Creation Function

conn

connection

创建一个connection between an installed database and MATLAB®. For details, seeConnect to Database.

database

dbds

DatabaseDatastore

创建一个connection to a type of datastore for working with large data.

databaseDatastore

  • connectionobjects andDatabaseDatastoreobjects remain open until you close them using theclosefunction. Always close these objects when you finish using them.

  • Executingclosewith aDatabaseDatastoreobject releases the MATLAB resources associated with theconnectionobject.

Note

When you close the MATLAB session, MATLAB closes openDatabaseDatastore对象和连接。然而,数据库米格ht not free up the connections. Consult your database administrator about the remaining connections.

版本History

Introduced before R2006a