主要内容

testConnection

测试JDBC数据库连接

自从R2020b

描述

例子

状态= testConnection (选择,用户名,密码)测试指定的JDBC数据库连接SQLConnectionOptions对象选择、用户名和密码。

例子

(状态,消息)= testConnection (选择,用户名,密码)还返回错误消息与测试数据库连接。

例子

全部折叠

创建、配置、测试和保存一个Microsoft®SQL Server的JDBC数据源®数据库。

创建一个SQL Server数据源JDBC数据库连接。

供应商=“微软SQL Server”;选择= databaseConnectionOptions (“jdbc”、供应商)
选择= SQLConnectionOptions属性:DataSourceName:“供应商:“Microsoft SQL Server”JDBCDriverLocation:“数据库名:“服务器:“localhost”PortNumber: 1433 AuthenticationType:“服务器”

选择是一个SQLConnectionOptions对象与这些属性:

  • DataSourceName——数据源的名称

  • 供应商——数据库供应商的名字

  • JDBCDriverLocation- JDBC驱动程序文件的完整路径

  • 数据库名——数据库的名称

  • 服务器——数据库服务器的名称

  • PortNumber——端口号

  • AuthenticationType——验证类型

通过设置配置数据源JDBC数据源的连接选项SQLServerDataSourceJDBC驱动程序文件的完整路径,数据库名称toystore_doc、数据库服务器dbtb04、端口号54317年和Windows®身份验证。

选择= setoption(选择,“DataSourceName”,“SQLServerDataSource”,“JDBCDriverLocation”,“C: \ \ mssql-jdbc-7.0.0.jre8.jar司机”,“数据库名”,“toystore_doc”,“服务器”,“dbtb04”,“PortNumber”,54317,“AuthenticationType”,“Windows”)
选择= SQLConnectionOptions属性:DataSourceName:“SQLServerDataSource”供应商:“Microsoft SQL Server”JDBCDriverLocation:“C: \ \ mssql-jdbc-7.0.0.jre8司机。jar”数据库名:“toystore_doc”服务器:“dbtb04”PortNumber: 54317 AuthenticationType:“Windows”

setoption函数设置DataSourceName,JDBCDriverLocation,数据库名,服务器,PortNumber,AuthenticationType属性SQLConnectionOptions对象。

测试数据库连接与一个空白的用户名和密码。的testConnection函数返回的逻辑1,这表明数据库连接成功。

用户名=”“;密码=”“;状态= testConnection(选择、用户名、密码)
状态=逻辑1

保存配置数据源。

saveAsDataSource(选择)

你可以使用连接到新的数据源数据库函数或数据库资源管理器应用程序。

创建和配置JDBC数据源到Microsoft®SQL Server®数据库。测试数据库连接的JDBC数据源和检索错误消息。

创建一个SQL Server数据源JDBC数据库连接。

供应商=“微软SQL Server”;选择= databaseConnectionOptions (“jdbc”、供应商)
选择= SQLConnectionOptions属性:DataSourceName:“供应商:“Microsoft SQL Server”JDBCDriverLocation:“数据库名:“服务器:“localhost”PortNumber: 1433 AuthenticationType:“服务器”

选择是一个SQLConnectionOptions对象与这些属性:

  • DataSourceName——数据源的名称

  • 供应商——数据库供应商的名字

  • JDBCDriverLocation- JDBC驱动程序文件的完整路径

  • 数据库名——数据库的名称

  • 服务器——数据库服务器的名称

  • PortNumber——端口号

  • AuthenticationType——验证类型

通过设置配置数据源JDBC数据源的连接选项SQLServerDataSourceJDBC驱动程序文件的完整路径,数据库名称toystore_doc、数据库服务器dbtb04、端口号54317年和SQL Server身份验证。

选择= setoption(选择,“DataSourceName”,“SQLServerDataSource”,“JDBCDriverLocation”,“C: \ \ mssql-jdbc-7.0.0.jre8.jar司机”,“数据库名”,“toystore_doc”,“服务器”,“dbtb04”,“PortNumber”,54317,“AuthenticationType”,“服务器”)
选择= SQLConnectionOptions属性:DataSourceName:“SQLServerDataSource”供应商:“Microsoft SQL Server”JDBCDriverLocation:“C: \ \ mssql-jdbc-7.0.0.jre8司机。jar”数据库名:“toystore_doc”服务器:“dbtb04 PortNumber: 54317 AuthenticationType:“服务器”

setoption函数设置DataSourceName,JDBCDriverLocation,数据库名,服务器,PortNumber,AuthenticationType属性SQLConnectionOptions对象。

测试数据库连接使用一个不正确的用户名和密码。的testConnection函数返回的逻辑0,这表明数据库连接失败。检索和显示连接失败的错误消息。

用户名=“wronguser”;密码=“wrongpassword”;(地位、消息)= testConnection(选择、用户名、密码)
状态=逻辑0
消息=“JDBC驱动程序错误:用户的登录失败”wronguser”。ClientConnectionId: dfe57aed - 973 f - 4 - c5f - 838 b d733a24c40f0”

输入参数

全部折叠

数据库连接选项,指定为一个SQLConnectionOptions对象。

用户名需要访问数据库,指定为一个特征向量或字符串标量。如果不需要用户名,指定一个空值”“

数据类型:字符|字符串

密码需要访问数据库,指定为一个特征向量或字符串标量。如果不需要密码,指定一个空值”“

数据类型:字符|字符串

输出参数

全部折叠

连接状态,作为一个逻辑返回真正的如果连接测试通过如果连接测试失败。

错误消息,作为一个特征向量返回。如果连接测试通过,那么错误消息是一个空的特征向量。否则,失败的错误消息包含文本数据库连接。

版本历史

介绍了R2020b