Connettersi a un database SQL tramite C e C++

  • Articolo

Si applica a: Database SQL di Azure

Questo articolo aiuta gli sviluppatori C e C++ a connettersi a database SQL di Azure.

Prerequisiti

Per seguire la procedura descritta in questa guida, sono necessari gli elementi seguenti:

Tecnologie di accesso ai dati: ODBC e OLE DB

Attualmente sono disponibili due modi per connettersi a database SQL di Azure: ODBC (Open Database Connectivity) e OLE DB (Object Linking and Embedding Database). Negli ultimi anni Microsoft si è allineata a ODBC per l'accesso ai dati relazionali nativi. ODBC è molto più veloce di OLE DB. Si tenga tuttavia presente che ODBC usa una vecchia API di tipo C.

Creare il database SQL di Azure

Vedere la pagina introduttiva per informazioni su come creare un database di esempio. In alternativa, è possibile guardare questo breve video di due minuti per creare un database SQL di Azure tramite il portale di Azure.

Ottenere una stringa di connessione

Dopo aver eseguito il provisioning del database SQL di Azure, è necessario eseguire la seguente procedura per determinare le informazioni di connessione e aggiungere l'IP client per l'accesso al firewall.

Nel portale di Azure, passare alla stringa di connessione ODBC del database SQL di Azure usando l'opzione Mostra stringhe di connessione del database elencata come parte della sezione relativa alle informazioni generali del database:

ODBCConnectionString

ODBCConnectionStringProps

Copiare il contenuto della stringa ODBC (include Node.js) [SQL authentication]. Questa stringa verrà usata successivamente per connettersi dall'interprete della riga di comando ODBC di C++ . La stringa include informazioni dettagliate quali il driver, il server e altri parametri di connessione al database.

Aggiungere l'indirizzo IP al firewall

Passare alla sezione relativa al firewall del server e aggiungere l'IP client al firewall seguendo i passaggi seguenti per assicurarsi di stabilire correttamente la connessione:

AddyourIPWindow

A questo punto, il database SQL di Azure è stato configurato ed è possibile collegarsi dal codice C++.

Connettersi da un'applicazione C/C++ per Windows

È possibile connettersi facilmente al database SQL di Azure tramite ODBC su Windows seguendo questo esempio compilato con Visual Studio. Nell'esempio viene implementato un interprete della riga di comando ODBC, che può essere usato per connettersi al database SQL di Azure. In questo esempio viene accettato come argomento della riga di comando un file DSN (Database Source Name ) oppure la stringa di connessione dettagliata copiata in precedenza dal portale di Azure. Visualizzare la pagina delle proprietà per il progetto e incollare la stringa di connessione come argomento di comando, come illustrato di seguito:

Propsfile DNS

Assicurarsi di specificare i dettagli di autenticazione corretti per il database come parte della stringa di connessione al database.

Avviare l'applicazione per compilarla. Se la connessione ha esito positivo, verrà visualizzata la finestra seguente. È anche possibile eseguire alcuni semplici comandi SQL come crea tabella per convalidare la connettività al database:

Comandi SQL

In alternativa, è possibile creare un file DSN mediante la procedura guidata avviata quando non è specificato alcun argomento di comando. Si consiglia di provare anche questa opzione. È possibile usare questo file DSN per l'automazione e per proteggere le impostazioni di autenticazione:

Creare un file DSN

Complimenti. È stata correttamente stabilita una connessione ad Azure SQL mediante C++ e ODBC in Windows. È possibile continuare la lettura per eseguire la stessa operazione sulla piattaforma Linux.

Connettersi da un'applicazione C/C++ per Linux

È possibile sviluppare applicazioni Linux C++ in Visual Studio. Per altre informazioni, vedere il blog seguente: Visual C++ per lo sviluppo di applicazioni Linux.

Per la compilazione per Linux è necessario un computer remoto in cui è in esecuzione la distribuzione Linux. Se non si ha a disposizione un computer remoto con Linux, è possibile configurarlo rapidamente seguendo i passaggi presenti nell'articolo Macchine virtuali di Linux in Azure.

Questa guida suppone di avere configurata una distribuzione di Linux Ubuntu 16.04. I passaggi si applicano anche a Ubuntu 15.10, Red Hat 6 e Red Hat 7.

I passaggi seguenti consentono di installare le librerie necessarie per ODBC ed SQL per la distribuzione:

    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*

Avviare Visual Studio. In Strumenti -> Opzioni -> Multipiattaforma -> Gestione connessioni, aggiungere una connessione alla casella di Linux:

Opzioni degli strumenti

Dopo aver stabilito la connessione tramite SSH, creare un modello di progetto vuoto (Linux):

Nuovo modello di progetto

È quindi possibile aggiungere un nuovo file di origine C e sostituirlo con questo contenuto. Tramite le API ODBC SQLAllocHandle SQLSetConnectAttr ed SQLDriverConnect dovrebbe essere possibile inizializzare e stabilire una connessione al database. Come nell'esempio di ODBC per Windows, è necessario sostituire la chiamata SQLDriverConnect con i dettagli dei parametri della stringa di connessione al database copiata in precedenza dal portale di Azure.

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

L'ultima operazione da eseguire prima della compilazione consiste nell'aggiungere odbc come dipendenza della libreria:

Aggiunta di ODBC come libreria di input

Per avviare l'applicazione, visualizzare la console Linux nel menu Debug:

Console Linux

Se la connessione è stata stabilita correttamente, viene visualizzato il nome del database corrente stampato nella console Linux:

Output della finestra della console Linux

Complimenti. La guida è stata completata ed è ora possibile connettersi al database SQL di Azure da C++ su piattaforme Windows e Linux.

Ottenere la soluzione completa per l'esercitazione su C/C++

La soluzione GetStarted contenente tutti gli esempi riportati in questo articolo è disponibile su GitHub:

Contenuto correlato