提示 Windows 用户提供缺少的连接属性
如果缺少必需信息,Vertica Windows ODBC 驱动程序会提示用户提供连接信息。当客户端应用程序调用 SQLDriverConnect
以连接到 Vertica 并且以下任一条件成立时,驱动程序将显示“Vertica 连接对话框 (Vertica Connection Dialog)”:
-
DriverCompletion 属性已设置为 SQL_DRIVER_PROMPT。
-
DriverCompletion 属性已设置为 SQL_DRIVER_COMPLETE 或 SQL_DRIVER_COMPLETE_REQUIRED,且用于建立连接的连接字符串或 DSN 缺少服务器、数据库或端口信息。
如果以上任一条件成立,驱动程序将向用户显示“Vertica 连接对话框 (Vertica Connection Dialog)”以提示用户提供连接信息。
该对话框包含填入的连接字符串或 DSN 中提供的所有属性值。
注意
连接字符串至少需要指定 Vertica 作为驱动程序,否则 Windows 不知道应使用 Vertica ODBC 驱动程序来打开连接。连接对话框上的必填字段是“数据库 (Database)”、“UID”、“服务器 (Server)”和“端口 (Port)”。填充这些字段后,表单将启用确定 (OK) 按钮。
如果用户在该对话框上单击取消 (Cancel),SQLDriverConnect
函数调用将立即返回 SQL_NO_DATA,而不会尝试连接到 Vertica。如果用户提供的连接信息不完整或不正确,连接函数将在连接尝试失败后返回 SQL_ERROR。
注意
如果SQLDriverConnect
函数调用的 DriverCompletion 属性为 SQL_DRIVER_NOPROMPT,ODBC 驱动程序将立即返回 SQL_ERROR,以指示由于未提供足够信息且不允许驱动程序提示用户提供缺少的信息而无法连接。