你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 C 和 C++ 连接到 SQL 数据库

适用于：Azure SQL 数据库

本文可帮助 C 和 C++ 开发人员连接到 Azure SQL 数据库。

先决条件

要完成本指南中的步骤，需具备以下各项：

• 有效的 Azure 帐户。 如果没有，可以注册 Azure 免费试用版。
• Visual Studio。 必须安装 C++ 语言组件才能生成和运行此示例。
• Visual Studio Linux 开发。 如果基于 Linux 开发，还必须安装 Visual Studio Linux 扩展。

数据访问技术：ODBC 和 OLE DB

当前有两种方法连接到 Azure SQL 数据库：ODBC（开放式数据库连接）和 OLE DB（对象链接和嵌入数据库）。 最近几年，Microsoft 已在使用 ODBC 进行本地关系数据访问。 ODBC 比 OLE DB 快得多。 唯一需要说明的是，ODBC 使用的是旧的 C 样式 API。

创建 Azure SQL 数据库

请参阅入门页，以了解如何创建示例数据库。 或者，可以遵循此两分钟短视频使用 Azure 门户创建 Azure SQL 数据库。

获取连接字符串

预配 Azure SQL 数据库后，需要执行以下步骤，确定连接信息及添加用于防火墙访问的客户端 IP。

在 Azure 门户中，使用“显示数据库连接字符串”（包含在数据库的“概述”部分中）转到 Azure SQL 数据库 ODBC 连接字符串：

复制 ODBC (包括 Node.js) [SQL 身份验证] 字符串的内容。 稍后，我们使用此字符串从 C++ ODBC 命令行解释程序进行连接。 此字符串提供驱动程序、服务器和其他数据库连接参数等详细信息。

将 IP 添加到防火墙

转到服务器的防火墙部分，并使用以下步骤将客户端 IP 添加到防火墙，以确保我们可以建立成功的连接：

此时，已配置好 Azure SQL 数据库，并已准备好通过 C++ 代码连接。

从 Windows C/C++ 应用程序连接

可以使用通过 Visual Studio 生成的此示例在 Windows 上轻松连接到使用 ODBC 的 Azure SQL 数据库。 该示例实现可用于连接到 Azure SQL 数据库的 ODBC 命令行解释器。 此示例将数据库源名称文件 (DSN) 文件作为命令行参数，或我们先前从 Azure 门户复制的详细的连接字符串。 打开此项目的属性页，并将连接字符串作为命令行参数粘贴，如下所示：

确保在该数据库连接字符串中为数据库提供正确的身份验证详细信息。

启动用于生成的应用程序。 应看到如下所示确认成功连接的窗口。 甚至可以运行一些基本的 SQL 命令（例如 create table ）来验证数据库连接：

或者，可以使用未提供命令行参数时启动的向导创建 DSN 文件。 我们也建议尝试此选项。 可以使用此 DSN 文件进行自动化以及保护身份验证设置：

祝贺！ 现在已成功在 Windows 上使用 C++和 ODBC 连接到 Azure SQL。 可以继续阅读如何为 Linux 平台执行相同操作的内容。

从 Linux C/C++ 应用程序连接

可以在 Visual Studio 中开发 C++ Linux 应用程序。 若要了解详细信息，请查看以下博客：适用于 Linux 开发的 Visual C++。

若要为 Linux 生成，需要运行 Linux 分发的远程计算机。 如果没有可用的远程计算机，可以使用 Linux Azure 虚拟机快速设置。

本指南假定你已设置好 Ubuntu 16.04 Linux 分发。 这些步骤还适用于 Ubuntu 15.10、Red Hat 6 和 Red Hat 7。

按照以下步骤安装发行版 SQL 和 ODBC 所需的库：

    sudo su
    sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/mssql-ubuntu-test/ xenial main" > /etc/apt/sources.list.d/mssqlpreview.list'
    sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
    apt-get update
    apt-get install msodbcsql
    apt-get install unixodbc-dev-utf16 #this step is optional but recommended*

启动 Visual Studio。 在“工具”->“选项”->“跨平台”->“连接管理器”下，添加到 Linux 框的连接：

建立通过 SSH 的连接后，创建一个空项目 (Linux) 模板：

然后，可以添加 新的 C 源文件，并将其替换为此内容。 使用 ODBC API SQLAllocHandle、SQLSetConnectAttr 和 SQLDriverConnect 时，应能够初始化并建立与数据库的连接。 和 Windows ODBC 示例一样，需要使用数据库连接字符串参数的详细信息（之前从 Azure 门户复制）替换 SQLDriverConnect 调用。

     retcode = SQLDriverConnect(
        hdbc, NULL, "Driver=ODBC Driver 13 for SQL"
                    "Server;Server=<yourserver>;Uid=<yourusername>;Pwd=<"
                    "yourpassword>;database=<yourdatabase>",
        SQL_NTS, outstr, sizeof(outstr), &outstrlen, SQL_DRIVER_NOPROMPT);

编译前需要完成的最后一步是将 odbc 作为库依赖项添加：

若要启动应用程序，请从“调试” 菜单打开 Linux 控制台：

如果已成功连接，现在应看到 Linux 控制台中显示当前数据库名称：

祝贺你！ 你已成功完成本指南，现在可以在 Windows 和 Linux 平台上通过 C++ 连接到 Azure SQL 数据库。

获取完整的 C/C++ 教程解决方案

可以在 GitHub 中查找包括本文所有示例的 GetStarted 解决方案：

• ODBC C++ Windows 示例，下载 Windows C++ ODBC 示例，连接到 Azure SQL
• ODBC C++ Linux 示例，下载 Linux C++ ODBC 示例，连接到 Azure SQL

相关内容

• 参阅 SQL 数据库开发概述
• ODBC API 参考
• 包含 Azure SQL 数据库的多租户 SaaS 应用程序的设计模式
• 浏览所有 SQL 数据库的功能。