Nawiązywanie połączenia z usługą SQL Database przy użyciu języków C i C++

Dotyczy: Azure SQL Database

Ten artykuł ułatwia deweloperom języka C i C++ łączenie się z usługą Azure SQL Database.

Wymagania wstępne

Aby wykonać kroki opisane w tym przewodniku, potrzebne są następujące elementy:

• Aktywne konto platformy Azure. Jeśli go nie masz, możesz zarejestrować się w celu uzyskania bezpłatnej wersji próbnej platformy Azure.
• Visual Studio. Aby skompilować i uruchomić ten przykład, należy zainstalować składniki języka C++.
• Tworzenie aplikacji dla systemu Linux w programie Visual Studio. Jeśli programujesz w systemie Linux, musisz również zainstalować rozszerzenie programu Visual Studio Dla systemu Linux.

Technologie dostępu do danych: ODBC i OLE DB

Obecnie istnieją dwa sposoby nawiązywania połączenia z usługą Azure SQL Database: ODBC (Open Database Connectivity) i OLE DB (Object Linking and Embedding Database). W ostatnich latach firma Microsoft jest zgodna z ODBC na potrzeby natywnego dostępu do danych relacyjnych. OdBC jest znacznie szybszy niż OLE DB. Jedynym zastrzeżeniem jest to, że ODBC używa starego interfejsu API w stylu C.

Tworzenie usługi Azure SQL Database

Zobacz stronę wprowadzenie, aby dowiedzieć się, jak utworzyć przykładową bazę danych. Możesz też skorzystać z tego krótkiego dwuminutowego klipu wideo , aby utworzyć usługę Azure SQL Database przy użyciu witryny Azure Portal.

Pobieranie parametrów połączenia

Po aprowizacji usługi Azure SQL Database należy wykonać następujące kroki, aby określić informacje o połączeniu i dodać adres IP klienta na potrzeby dostępu do zapory.

W witrynie Azure Portal przejdź do parametry połączenia ODBC usługi Azure SQL Database przy użyciu listy Pokaż parametry połączenia bazy danych w sekcji Przegląd bazy danych:

Skopiuj zawartość ciągu ODBC (obejmuje Node.js) [uwierzytelnianie SQL]. Użyjemy tego ciągu później, aby nawiązać połączenie z interpretera wiersza polecenia ODBC języka C++. Ten ciąg zawiera szczegółowe informacje, takie jak sterownik, serwer i inne parametry połączenia bazy danych.

Dodawanie adresu IP do zapory

Przejdź do sekcji zapory dla serwera i dodaj adres IP klienta do zapory, wykonując następujące kroki , aby upewnić się, że możemy nawiązać pomyślne połączenie:

Na tym etapie skonfigurowano usługę Azure SQL Database i wszystko jest gotowe do nawiązania połączenia z poziomu kodu C++.

Nawiązywanie połączenia z poziomu aplikacji C/C++ systemu Windows

Możesz łatwo nawiązać połączenie z usługą Azure SQL Database przy użyciu funkcji ODBC w systemie Windows przy użyciu tego przykładu , który kompiluje się z programem Visual Studio. Przykład implementuje interpreter wiersza polecenia ODBC, który może służyć do nawiązywania połączenia z naszą usługą Azure SQL Database. W tym przykładzie jest pobierany plik nazwy źródłowej bazy danych (DSN) jako argument wiersza polecenia lub pełny parametry połączenia skopiowany wcześniej z witryny Azure Portal. Wyświetl stronę właściwości dla tego projektu i wklej parametry połączenia jako argument polecenia, jak pokazano poniżej:

Upewnij się, że podano odpowiednie szczegóły uwierzytelniania dla bazy danych w ramach tej bazy danych parametry połączenia.

Uruchom aplikację, aby ją skompilować. Powinno zostać wyświetlone następujące okno z walidacją pomyślnego połączenia. Możesz nawet uruchomić kilka podstawowych poleceń SQL, takich jak tworzenie tabeli , aby zweryfikować łączność bazy danych:

Alternatywnie można utworzyć plik DSN przy użyciu kreatora, który jest uruchamiany, gdy nie podano żadnych argumentów polecenia. Zalecamy również wypróbowanie tej opcji. Tego pliku DSN można użyć do automatyzacji i ochrony ustawień uwierzytelniania:

Gratulacje! Połączenie z usługą Azure SQL zostało pomyślnie nawiązane przy użyciu języka C++ i ODBC w systemie Windows. Możesz również kontynuować czytanie, aby wykonać to samo dla platformy Linux.

Nawiązywanie połączenia z poziomu aplikacji C/C++ systemu Linux

Aplikacje języka C++ dla systemu Linux można opracowywać w programie Visual Studio. Aby dowiedzieć się więcej, zapoznaj się z następującym blogem: Visual C++ for Linux Development.

Do kompilacji dla systemu Linux potrzebna jest maszyna zdalna, na której działa dystrybucja systemu Linux. Jeśli nie masz dostępnej maszyny wirtualnej platformy Azure, możesz je szybko skonfigurować przy użyciu maszyn wirtualnych platformy Azure z systemem Linux.

W tym przewodniku założono, że masz skonfigurowaną dystrybucję systemu Linux w systemie Ubuntu 16.04. Kroki dotyczą również systemów Ubuntu 15.10, Red Hat 6 i Red Hat 7.

Poniższe kroki umożliwiają zainstalowanie bibliotek wymaganych do dystrybucji SQL i 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*

Uruchom program Visual Studio. W obszarze Narzędzia —> opcje —> międzyplatformowe —> Menedżer połączeń dodaj połączenie z polem systemu Linux:

Po nawiązaniu połączenia za pośrednictwem protokołu SSH utwórz szablon Pusty projekt (Linux):

Następnie możesz dodać nowy plik źródłowy języka C i zastąpić go tą zawartością. Korzystając z interfejsów API ODBC SQLAllocHandle, SQLSetConnectAttr i SQLDriverConnect, powinno być możliwe zainicjowanie i nawiązanie połączenia z bazą danych. Podobnie jak w przypadku przykładu ODBC systemu Windows, musisz zastąpić wywołanie SQLDriverConnect szczegółami z bazy danych parametry połączenia parametrami skopiowanymi wcześniej z witryny Azure Portal.

     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);

Ostatnią czynnością, którą należy wykonać przed kompilowaniem, jest dodanie odbc jako zależności biblioteki:

Aby uruchomić aplikację, uruchom konsolę systemu Linux z menu Debugowanie :

Jeśli połączenie zakończyło się pomyślnie, w konsoli systemu Linux powinna zostać wyświetlona bieżąca nazwa bazy danych:

Gratulacje! Przewodnik został ukończony pomyślnie i można teraz nawiązać połączenie z usługą Azure SQL Database z poziomu języka C++ na platformach Windows i Linux.

Uzyskiwanie kompletnego rozwiązania samouczka języka C/C++

Rozwiązanie GetStarted zawierające wszystkie przykłady w tym artykule można znaleźć w witrynie GitHub:

• Przykład ODBC C++ dla systemu Windows, pobierz przykład odBC języka Windows C++ w celu nawiązania połączenia z usługą Azure SQL
• Przykład ODBC C++ Dla systemu Linux pobierz przykład odBC języka Linux C++ w celu nawiązania połączenia z usługą Azure SQL

Powiązana zawartość

• Przegląd programowania w usłudze SQL Database
• Więcej informacji na temat dokumentacji interfejsu API ODBC
• Wzorce projektowe dla wielodostępnych aplikacji SaaS z usługą Azure SQL Database
• Poznaj wszystkie możliwości usługi SQL Database