Configura le connessioni ODBC a Microsoft SQL

Configura una connessione ODBC scegliendo dove memorizzarne le impostazioni, a quale database connettersi, come autenticarsi e come proteggere la connessione. Aggiungi impostazioni di routing, recovery o specifiche per l'applicazione solo quando la tua distribuzione ne ha bisogno.

Questa guida spiega queste opzioni per il driver Microsoft ODBC per SQL Server su Windows, Linux e macOS. ODBC Driver 18 è la versione principale attuale; ODBC Driver 17 rimane un target supportato. Gli esempi utilizzano il Driver 18 e identificano le impostazioni che differiscono nel Driver 17. Usa il riferimento a parole chiave e attributi per cercare ogni parola chiave, valore e piattaforma accettati.

Scegliere un metodo di connessione

Una stringa di connessione fornisce coppie nome-valore keyword=value; al driver. Un nome di sorgente dati (DSN) memorizza separatamente le impostazioni di connessione in modo che l'applicazione possa riferirsi ad esse per nome. Entrambi i metodi utilizzano lo stesso driver, metodi di autenticazione e permessi del database.

Metodo Quando usarlo Cosa fornisce l'applicazione
Senza DSN Mantieni la configurazione con l'applicazione, ad esempio in una configurazione di distribuzione o in un container. Non è necessario creare un DSN su ogni client. Driver, Server, Database, autenticazione e altre impostazioni di connessione. Il driver deve comunque essere installato.
DSN utente Configura un'applicazione desktop per un utente del sistema operativo, oppure un'applicazione che richiede un'origine dati denominata. DSN=<data_source_name> e qualsiasi impostazione fornita al momento della connessione, incluse le credenziali. Solo le applicazioni di quell'utente possono utilizzare il DSN utente.
DSN di sistema Permette alle applicazioni in esecuzione con identità diverse, come un account di servizio, di utilizzare una configurazione a livello macchina. DSN=<data_source_name> e impostazioni al momento della connessione. Il processo deve avere accesso al DSN di sistema e al suo driver.
File DSN Usa un'applicazione che prevede le impostazioni di connessione in un .dsn file. FileDSN=<file_path> e impostazioni al momento della connessione. Il file non installa il driver né rende i suoi percorsi portatili tra sistemi operativi.

Usa un metodo di selezione per connessione. Non combinare DSN, Driver e FileDSN per provare a cambiare il driver di un DSN. Un servizio non utilizza automaticamente il DSN del tuo utente interattivo.

Nelle applicazioni native, SQLConnect accetta un DSN e argomenti separati per ID utente e password. SQLDriverConnect accetta una stringa di connessione, incluse le forme DSN e DSN-less. Le applicazioni e i framework che utilizzano ODBC determinano quali input espongono. Segui l'interfaccia di configurazione dell'applicazione invece di presumere che accetti ogni parola chiave ODBC come opzione da riga di comando.

Inizia con una stringa di connessione

Scegli prima il modulo connessione, quindi seleziona autenticazione e eventuali opzioni aggiuntive nelle sezioni seguenti. Questi esempi utilizzano l'autenticazione SQL. Non mantenere UID, PWD, o Authentication=SqlPassword quando si passa a un metodo di autenticazione incompatibile.

Sostituire <server>, <database>, <user_id> e <password> con i propri valori. Per database SQL di Azure, usa <server>.database.windows.net come nome host. Gli esempi utilizzano la porta 1433Transmission Control Protocol (TCP); sostituiscila con la porta configurata per il tuo endpoint.

Connettiti senza DSN

Fornisci direttamente il nome del driver installato e le impostazioni di connessione:

Driver={ODBC Driver 18 for SQL Server};Server=tcp:<server>,1433;Database=<database>;UID=<user_id>;PWD=<password>;Authentication=SqlPassword;Encrypt=yes;TrustServerCertificate=no;

Per il Driver 17, sostituisci il nome del driver con ODBC Driver 17 for SQL Server. Le altre impostazioni in questo esempio funzionano con entrambe le versioni principali.

Connettiti con un DSN

Dopo aver creato il DSN, fornisci il suo nome e le impostazioni di autenticazione dell'applicazione:

DSN=MSSQLTest;UID=<user_id>;PWD=<password>;Authentication=SqlPassword;Encrypt=yes;TrustServerCertificate=no;

Il DSN seleziona il driver, il server e il database. L'esempio ripete esplicitamente le impostazioni di sicurezza in modo che l'applicazione richieda la stessa protezione con entrambe le forme di connessione.

Non salvare password reali in un DSN, un file DSN, odbc.ini, un file sorgente o un comando della shell. Recupera i segreti tramite il meccanismo di gestione delle credenziali dell'applicazione e forniscili al momento della connessione. Considera qualsiasi stringa di connessione contenente una password, un token o un segreto di archivio delle chiavi come dati sensibili, inclusi i log e le catture diagnostiche.

Seleziona il driver, il server e il database

Queste impostazioni determinano cosa carica l'applicazione e dove si collega.

Setting Quando e come usarlo
Driver Seleziona il driver installato con il suo nome registrato per una connessione senza DSN. Il driver 17 e il driver 18 hanno nomi diversi e possono essere installati fianco a fianco. L'installazione del Driver 18 non reindirizza una connessione che seleziona esplicitamente il Driver 17.
Server=tcp:<server>,1433 Usa un endpoint TCP e una porta nota. La virgola separa il nome host dalla porta. Linux e macOS supportano solo TCP. Una porta esplicita evita la dipendenza dalla scoperta di istanze denominate.
Server=<server>\<instance> Connettiti a un'istanza denominata di SQL Server quando è disponibile la rilevazione dell'istanza. Su Linux e macOS, questo richiede il driver 17.4 e versioni successive, incluso il driver 18. Se la scoperta non è disponibile, ottieni la porta TCP dell'istanza e utilizza la forma con porta esplicita.
Database=<database> Seleziona deliberatamente il database iniziale, in particolare per un utente di database contenuto o un'applicazione che non deve dipendere dal database predefinito del login. Questa impostazione non crea il database né concede l'accesso.
Address o Addr Mantieni un'applicazione che utilizza un indirizzo di rete separato. Evita di specificare un Server in conflitto; usa un unico endpoint deliberato invece di affidarti alla precedenza tra i nomi.
Network o Net Mantieni una configurazione Windows che selezioni esplicitamente una libreria di rete. Preferisci il tcp: prefisso server per una connessione TCP cross-platform. Non combinare un prefisso di protocollo con una selezione di rete in conflitto.

Un alias server, un'istanza nominata, un nome host del Sistema di Nomi di Dominio (DNS) e una porta non sono intercambiabili. Usa un nome DNS che corrisponda al certificato per una connessione remota crittografata. Un indirizzo di protocollo Internet (IP) non risolve una mancata corrispondenza del nome del certificato.

Per database SQL di Azure e altri servizi gestiti, utilizza l'endpoint pubblicato del servizio. Per un gruppo di disponibilità, usa il suo listener quando desideri il failover o il routing di sola lettura, invece di codificare in codice rigido il nome host di una replica.

Scegliere l'autenticazione

L'autenticazione determina quale identità si collega. Non concede a quell'identità i permessi del database e non sostituisce le impostazioni di crittografia.

Metodo Impostazioni di connessione Quando usarlo e prerequisiti
Autenticazione SQL Authentication=SqlPassword, UIDe PWD. Il server di destinazione abilita l'autenticazione SQL e hai un login SQL o un utente del database con una password. Sia il Driver 17 che il Driver 18 supportano questa forma. UIDè il nome utente SQL, non un account Microsoft Entra ID.
Autenticazione integrata di Windows Trusted_Connection=yes; ometti UID e PWD. Usa l'identità Windows del processo per un target configurato per autenticazione di Windows. Su Linux e macOS, configura Kerberos e ottieni un ticket per l'identità dell'applicazione. Questa non è un'autenticazione integrata Microsoft Entra.
Autenticazione integrata di Microsoft Entra Authentication=ActiveDirectoryIntegrated; Ometti le credenziali SQL. Utilizza un'identità Windows o Kerberos esistente in una configurazione Microsoft Entra che supporta l'autenticazione integrata. Linux e macOS richiedono il Driver 17.6 e versioni successive, incluso il Driver 18.
Autenticazione interattiva di Microsoft Entra Authentication=ActiveDirectoryInteractive; ometti PWD. Una persona può completare l'accesso e l'autenticazione multifattore. Supportato su Windows, inclusi il driver 17.1 e versioni successive. Per il driver 17.1 fino a 17.7, fornisci il nome utente Microsoft Entra in UID. Il driver 17.8 e le versioni successive, incluso il driver 18, ti permettono di omettere UID. Non scegliere questo metodo per un servizio non presidiato.
Identità gestita di Microsoft Entra Authentication=ActiveDirectoryMsi. Esegui su un host che espone un endpoint di identità gestita supportato. Un'identità assegnata dal sistema non richiede UID. È richiesta UID un'identità assegnata dall'utente con l'identificatore appropriato a quell'host. Disponibile nel driver 17.3.1.1 e versioni successive, incluso il driver 18.
Principale del servizio Microsoft Entra Authentication=ActiveDirectoryServicePrincipal; UID è l'ID client dell'applicazione ed PWD è il suo segreto client. Un'applicazione non assistita utilizza un'identità di applicazione Microsoft Entra dove l'identità gestita non è adatta. Disponibile nel Driver 17.7 e nelle versioni successive, incluso il Driver 18. Proteggi e ruota il segreto client.
Token di accesso Microsoft Entra fornito dall'applicazione Imposta l'attributo SQL_COPT_SS_ACCESS_TOKEN di connessione prima di connettersi. L'applicazione acquisisce autonomamente il token. Questo è un attributo dell'interfaccia di programmazione applicativa (API), non una parola chiave di stringa di connessione. Omettere UID, PWD, Trusted_Connection, e Authentication dalla configurazione della connessione.

Scegli un metodo Microsoft Entra solo quando il target lo supporta e hai configurato l'accesso al database dell'identità. Un metodo supportato dal driver non è necessariamente disponibile su ogni distribuzione di SQL Server o servizio gestito. Per la configurazione, gli identificatori di identità gestiti specifici per host e le restrizioni della piattaforma, vedi Usa Microsoft Entra ID con il driver ODBC e Usa l'autenticazione integrata su Linux e macOS.

Non combinare Trusted_Connection=yes con un valore Authentication. Non inserire un token di accesso in PWD. Quando si modifica il metodo di autenticazione di un DSN, rimuovere le credenziali e gli attributi dell'applicazione incompatibili, oltre a modificare il keyword.

ActiveDirectoryPasswordutilizza nomi utente e password di Microsoft Entra ed è deprecato. Non sceglierlo per una nuova applicazione. Preferisci un metodo appropriato per un utente interattivo o un'identità di carico di lavoro.

Configurare crittografia e validazione dei certificati

Utilizzare Encrypt=yes;TrustServerCertificate=no per una connessione Transport Layer Security (TLS) che convalida il certificato server con il Driver 17 o con il Driver 18. Il client deve fidarsi dell'autorità di certificazione emittente e il certificato deve corrispondere al nome del server atteso.

Configuration Quando usarlo Comportamento di Driver 17 e Driver 18
Encrypt=yes;TrustServerCertificate=no Richiedere crittografia e normale validazione del certificato. Supportato da entrambe le principali versioni. Il driver 18 accetta mandatory anche come sinonimo di yes.
Encrypt=strict Richiedere la crittografia Tabular Data Stream (TDS) 8.0 nei confronti di un endpoint che la supporta. Solo il driver 18. Il driver convalida il certificato e ignora TrustServerCertificate. Il Driver 17 non ha equivalenti.
Encrypt=yes;TrustServerCertificate=yes Un'eccezione appositamente approvata che cripta il traffico senza una normale validazione del certificato. Non usarlo come soluzione di routine per un errore di certificato. Non garantisce che il client stia parlando con il server previsto. Non disabilita la validazione in modalità Strict.
Encrypt=no Mantieni una configurazione che non richieda la crittografia a sessione completa da parte del client. Non è il riferimento per le connessioni remote. Anche il Driver 18 accetta optional. Il server può comunque richiedere la crittografia.

Il driver 18 richiede la crittografia per impostazione predefinita. Il Driver 17 di solito imposta di default per non richiederlo, ma un'impostazione non vuota Authentication o un token di accesso fornito cambiano la crittografia predefinita del Driver 17. Imposta Encrypt esplicitamente invece di affidarsi a valori predefiniti dipendenti dall'autenticazione.

Per connessioni ordinarie non Strict con Encrypt=no e TrustServerCertificate=no, una richiesta di crittografia solo server fa sì che il Driver 18 convalidi il certificato, ma non seleziona la normale validazione del certificato nel Driver 17. Non affidarti solo alla crittografia richiesta dal server per ottenere lo stesso comportamento di validazione in entrambi i driver. Per l'interazione completa con le impostazioni del server, consulta le tabelle dei comportamenti di crittografia.

Scegli l'identità del certificato attesa

La maggior parte delle applicazioni richiede solo un certificato affidabile e il nome corretto Server . Utilizza le parole chiave aggiuntive del certificato per un requisito di distribuzione specifico:

Keyword Quando usarlo Applicabilità e limiti
HostnameInCertificate La distribuzione richiede un nome host certificato atteso diverso da quello dell'endpoint di connessione, come un alias configurato. Solo Driver 18. Non stabilisce fiducia in un'autorità emittente non affidabile. Viene ignorato quando ServerCertificate viene usato.
ServerCertificate Abbina un file di certificato server distribuito esplicitamente invece della normale validazione della catena di certificati e del nome host. Driver 18.1 e versioni successive, con Encrypt=strict solo. Utilizza un certificato di Privacy Enhanced Mail (PEM) o di Distinguished Encoding Rules (DER). Il certificato deve corrispondere esattamente e le date di validità vengono comunque verificate. Pianifica come distribuire un certificato sostitutivo prima della rotazione del certificato del server.
ClientCertificate e ClientKey Utilizza il meccanismo specializzato di autenticazione dei certificati per le connessioni di loopback a SQL Server in Linux. Queste non sono sostituti generali dell'autenticazione SQL o Microsoft Entra, né sono le impostazioni di fiducia dei certificati server.

Risolvi problemi di catena di certificati, nome host e file certificati invece di disabilitare la validazione. Su Linux e macOS, controlla anche la dipendenza OpenSSL supportata dal driver e il trust store utilizzato da quel processo. Per ulteriori informazioni, vedi Risoluzione dei problemi di crittografia della connessione.

Fiducia nei certificati Linux e macOS

TLS su Linux e macOS utilizza OpenSSL. Ottieni materiale attendibile approvato e segui la procedura di amministrazione dell'archivio attendibile della tua piattaforma. Un certificato scaricato da un endpoint non autenticato non è una prova sufficiente per fidarsi di esso. Controlla i requisiti di sistema per le librerie supportate dal tuo driver e dalla piattaforma.

Il seguente inventario storico della piattaforma riporta le versioni minime di OpenSSL e le posizioni predefinite dell'archivio di attendibilità dei certificati. Non stabilisce l'attuale supporto dei driver per queste versioni della piattaforma. Conferma la versione OpenSSL e la configurazione del trust-store utilizzate dal driver installato e dalla piattaforma prima di affidarti a una posizione elencata.

Platform Versione minima di OpenSSL Posizione predefinita dell'archivio certificati attendibili
Debian 10, 11, 12 1.1.1 /etc/ssl/certs
Debian 9 1.1.0 /etc/ssl/certs
Debian 8.71 1.0.1 /etc/ssl/certs
OS X 10.11, macOS 1.0.2 /usr/local/etc/openssl/certs
Red Hat Enterprise Linux 9 3.0.1 /etc/pki/tls/cert.pem
Red Hat Enterprise Linux 8 1.1.1 /etc/pki/tls/cert.pem
Red Hat Enterprise Linux 7 1.0.1 /etc/pki/tls/cert.pem
Red Hat Enterprise Linux 6 1.0.0-10 /etc/pki/tls/cert.pem
SUSE Linux Enterprise 15 1.1.0 /etc/ssl/certs
SUSE Linux Enterprise 11, 12 1.0.1 /etc/ssl/certs
Ubuntu 22.04, 23.04 3.0.2 /etc/ssl/certs
Ubuntu 20.04 1.1.1 /etc/ssl/certs
Ubuntu 18.04 1.1.0 /etc/ssl/certs
Ubuntu 16.04 1.0.2 /etc/ssl/certs
Ubuntu 14.04 1.0.1 /etc/ssl/certs
Alpine 3.17, 3.18 3.0.1 /etc/ssl/certs

Configura routing e failover

Seleziona queste impostazioni in base alla topologia di destinazione e al carico di lavoro. Non creano repliche, non configurano un listener né concedono accesso a un secondario.

Setting Quando usarlo Distinzione importante
MultiSubnetFailover=Yes Connettiti a un listener di gruppo di disponibilità, a un'istanza di cluster di failover, a database SQL di Azure, a Istanza gestita di SQL di Azure o a un database SQL in Microsoft Fabric. Il driver tenta in parallelo connessioni TCP agli indirizzi risolti. Funziona anche quando il nome si risolve a un unico indirizzo. È supportato dal Driver 17 e dal Driver 18. Non combinarlo con il mirroring del database Failover_Partner.
ApplicationIntent=ReadOnly Richiedi una connessione per un carico di lavoro di sola lettura, incluso il routing di sola lettura tramite un listener di gruppo di disponibilità adeguatamente configurato. Specifica il database partecipante e configura il routing lato server. Questa impostazione non sostituisce le autorizzazioni del database di sola lettura. Il valore predefinito è ReadWrite.
TransparentNetworkIPResolution Mantieni o diagnostica il fallback legacy del driver su più indirizzi IP risolti. I valori sono Enabled e Disabled; il valore predefinito è Enabled. Non trattare questo come un'altra ortografia di MultiSubnetFailover.
IpAddressPreference Scegli l'ordine degli indirizzi IPv4-first, IPv6-first o del sistema operativo per una distribuzione con un requisito specifico di famiglia di indirizzi. Driver 18.1 e versioni successive. I valori sono IPv4First, IPv6First, e UsePlatformDefault. Questo non modifica i record DNS né ripara il routing di rete.
Failover_Partner Mantieni una connessione di mirroring del database SQL Server esistente. Solo per Windows. Non è l'opzione del listener del gruppo di disponibilità. Il driver 18.7 e le versioni successive accettano anch'essi l'alias FailoverPartner; Il driver 17 utilizza Failover_Partner.

Per una connessione di gruppo di disponibilità di sola lettura, aggiungi ApplicationIntent=ReadOnly;MultiSubnetFailover=Yes alla stringa di connessione autenticata appropriata e usa il listener in Server. Una connessione diretta a un secondario arbitrario non configura il routing di sola lettura.

Dopo un failover, l'applicazione potrebbe dover aprire una nuova connessione. Per i prerequisiti del server e il comportamento delle applicazioni, vedi Alta disponibilità e disaster recovery.

Imposta timeout, recupero e comportamento dei tentativi di nuovo

Scegli un'impostazione per l'operazione che devi controllare. Un timeout di login, un timeout di query, una policy di recupero della connessione inattiva e una policy di ritentativo di comando si applicano a operazioni diverse.

Requirement Setting Quando e come usarlo
Limitare l'instaurazione della connessione. SQL_ATTR_LOGIN_TIMEOUT, oppure ConnectTimeout con il driver 18.7 e versioni successive. Nelle applicazioni native, imposta l'attributo prima di connettersi. Driver 17 e le versioni precedenti a Driver 18 richiedono l'attributo anziché questa parola chiave. Un attributo esplicitamente impostato ha precedenza su ConnectTimeout.
Limita l'esecuzione dell'istruzione. SQL_ATTR_QUERY_TIMEOUT attributo dell'istruzione. Configuralo tramite l'API dell'applicazione. ConnectTimeout non imposta il timeout della query.
Recupera una connessione idonea che si è interrotta mentre era inattiva. ConnectRetryCount e ConnectRetryInterval. Supportato dalle versioni attuali del Driver 17 e del Driver 18. I valori predefiniti sono un tentativo di recupero e 10 secondi tra un tentativo e l'altro. Un valore di 0 disabilita il ripristino. Queste impostazioni non riprovano la connessione iniziale dell'applicazione né rieseguono i suoi comandi.
Rileva una connessione TCP inattiva che non risponde più. KeepAlive e KeepAliveInterval. Regola solo in base a un requisito di rete misurato. I valori predefiniti sono 30 secondi e 1 secondo. Il driver 17.4 ha introdotto il supporto alla configurazione; il supporto per stringa di connessione richiede il driver 17.8 e versioni successive, incluso il driver 18. Le versioni supportate precedenti utilizzano DSN o configurazione dei driver.
Riesegui i comandi selezionati non riusciti. RetryExec. Driver 18.1 e versioni successive. Definisci regole per errori e comandi specifici solo dopo aver deciso se ripetere l'operazione è sicuro. Questo non è il ripristino della connessione inattiva.

Ad esempio, ConnectRetryCount=3;ConnectRetryInterval=2 seleziona fino a tre tentativi di recupero delle connessioni inattive con un intervallo di 2 secondi. Non fa sì che un accesso non riuscito inizialmente vada a buon fine né ritenta una scrittura interrotta.

ConnectRetryCount accetta 0 fino a 255, e ConnectRetryInterval accetta da 1 a 60 secondi. Con il driver 18.7 e versioni successive, ConnectTimeout=30 richiede un timeout di accesso di 30 secondi. Il suo valore predefinito è 15 secondi; 0 richiede un'attesa a tempo indeterminato. Evita un'attesa di login a tempo indeterminato quando l'applicazione necessita di un tempo di risposta limitato.

Implementare una politica di ritentativo dell'applicazione con limiti definiti per errori transitori di connessione iniziale. Non riprovare credenziali errate, registrazioni mancanti o errori di validazione dei certificati come se fossero interruzioni temporanee. Per i tentativi di comando, considera se il server potrebbe aver già completato una scrittura prima che la connessione fallisse.

Per i prerequisiti di ripristino e la gestione degli errori, vedi Resilienza della connessione. Per la sintassi delle regole, vedi RetryExec. Mantieni le scelte di timeout di connessione e di query coerenti con il ritardo totale che la tua applicazione può accettare.

Configurazione keep-alive Linux e macOS

KeepAlive controlla la frequenza con cui TCP invia un pacchetto per verificare una connessione inattiva. KeepAliveInterval Controlla l'intervallo tra una ritrasmissione e l'altra quando non arriva alcuna risposta. I loro valori predefiniti sono rispettivamente 30 secondi e 1 secondo.

Con il driver 17.4 e versioni successive, puoi configurare questi valori nella sezione del driver di odbcinst.ini o nella sezione DSN di odbc.ini. Con una connessione DSN, le impostazioni del DSN hanno la precedenza rispetto a quelle del driver. Senza un DSN, il driver utilizza la sua sezione in odbcinst.ini. Se nessuna delle due posizioni specifica un valore, il driver utilizza il valore predefinito.

Anche il driver 17.8 e le versioni successive, incluso il driver 18, accettano KeepAlive e KeepAliveInterval nella stringa di connessione. Sostituisci una parola chiave esistente invece di aggiungere un duplicato e verifica la precedenza di configurazione quando combini le impostazioni di tempo di connessione con un DSN.

Configura il comportamento delle applicazioni e dei dati

Usa queste opzioni quando l'applicazione necessita del comportamento, invece di aggiungerle a ogni stringa di connessione.

Setting Quando usarlo Comportamento e limiti
APP Identifica l'applicazione nelle informazioni della sessione lato server. Usa un nome di applicazione stabile. Non è un'identità autenticata né un controllo di autorizzazione.
WSID Fornisci un identificatore della postazione di lavoro quando ti serve uno per l'identificazione della sessione. Anche il driver 18.7 e versioni successive accettano WorkstationID. Il driver 17 utilizza WSID. Non usare un nome fornito dal cliente come prova dell'identità del chiamante.
MARS_Connection=Yes L'applicazione necessita di più set di risultati attivi (MARS) su una singola connessione. Il valore predefinito è No. Anche il driver 18.7 e versioni successive accetta MultipleActiveResultSets=Yes. Il driver 17 utilizza MARS_Connection.
LongAsMax=Yes Invia parametri di carattere lunghi o binari come varchar(max), nvarchar(max) o varbinary(max) invece dei tipi legacy di grande oggetto. Solo driver 18; il valore predefinito è No. Controlla le aspettative di parametri e schema dell'applicazione prima di modificarla.
GetDataExtensions=Yes Gestire un'applicazione che deve recuperare i dati delle colonne con SQLGetData fuori ordine. Solo Driver 18. Questo comportamento di compatibilità può aumentare l'uso della memoria e ridurre le prestazioni. Preferisci recuperare le colonne in ordine crescente nelle nuove applicazioni.
Language Seleziona la lingua dei messaggi del server per la sessione. Usa una lingua installata sul server. Non seleziona la codifica del codice sorgente dell'applicazione.
AutoTranslate Controlla la traduzione tra code page client e server per dati di caratteri non Unicode. Il valore predefinito è Yes. Eseguire il test con i dati reali dei caratteri dell'applicazione prima di modificarli; disabilitare la traduzione può modificare il modo in cui i caratteri vengono interpretati.
Regional Mantieni un'applicazione che si aspetta la formattazione regionale del client quando converte dati di valuta, data o ora in dati di caratteri. Il valore predefinito è No. Non dare per scontato che cambiare la formattazione di output renda quelle stringhe regionali parametri di input validi.
AnsiNPW Mantieni il comportamento della sessione per il null handling, il riempimento dei caratteri e gli avvisi. Il valore predefinito è Yes. Rivedere le corrispondenti opzioni di sessione Transact-SQL (T-SQL) e il comportamento della versione del server prima di modificarlo.
QuotedId Specifica se la sessione utilizza virgolette doppie per gli identificatori. Il valore predefinito è Yes. Modificalo solo quando il T-SQL dell'applicazione richiede un comportamento QUOTED_IDENTIFIER diverso.
ConcatNullYieldsNull Controllare il comportamento della concatenazione nulla laddove il server supporti quella scelta di sessione. Driver 18.6 e versioni successive. Il driver 17 non riconosce questa parola chiave.
UseFMTONLY Mantieni un percorso di individuazione dei metadati che richieda SET FMTONLY invece del normale percorso di scoperta dei metadati del driver. Il valore predefinito è No. Non è necessario per una connessione ordinaria.

Configura il pooling delle connessioni tramite il Driver Manager o l'ambiente ODBC dell'applicazione. Non copiare la parola chiave di un altro provider Pooling nella stringa di connessione di questo driver. Per la configurazione ODBC nativa, consulta Driver Manager connection pooling. Per il comportamento di riutilizzo specifico di Windows, vedere pooling di connessioni con riconoscimento del driver.

Configura funzionalità specializzate

Le seguenti opzioni richiedono una configurazione specifica per funzionalità oltre la stringa di connessione.

Settings Quando usarli Che altro occorre
ColumnEncryption=Enabled Leggi o scrivi colonne protette con Always Encrypted. Accesso alle chiavi di crittografia delle colonne tramite uno store di chiavi supportato. Always Encrypted protegge i valori delle colonne ed è separato dalla crittografia di rete. Per le connessioni enclave, utilizza le impostazioni di connessione specifiche per la funzionalità.
KeystoreAuthentication, KeystorePrincipalIde KeystoreSecret Autentica il driver a un archivio chiavi utilizzato per Always Encrypted. L'identità e i permessi dell'archivio chiavi. Queste credenziali non sono le credenziali di accesso al database. Proteggi i segreti del keystore come proteggeresti una password.
ServerSPN Specifica un nome dell'entità servizio (SPN) per un'implementazione Kerberos che richiede un valore esplicito. Le versioni attuali del Driver 17 e del Driver 18 supportano questa impostazione su Windows, Linux e macOS. Configura la registrazione del servizio Kerberos in modo che corrisponda allo SPN fornito. Un SPN non è un nome host di certificato TLS.
FailoverPartnerSPN Mantieni un SPN Kerberos esplicito per un partner di mirroring del database. Solo Windows, con la corrispondente configurazione di mirroring.
AttachDBFileName Utilizza un flusso di lavoro di SQL Server che allega un file di database. Il nome corrispondente Database, il file accessibile al server e le autorizzazioni richieste. Non usarlo per identificare un database esistente in database SQL di Azure.
Replication=Yes Usa una connessione che necessita deliberatamente del comportamento dell'agente di replica. Driver 17.8 e versioni successive, incluso il driver 18. Modifica il comportamento degli oggetti contrassegnati NOT FOR REPLICATION, inclusi i trigger; non è un'opzione generale di prestazione.
QueryLog_On, QueryLogFile, QueryLogTime, StatsLog_On, e StatsLogFile Diagnostica un'applicazione Windows esistente tramite query del driver o log delle prestazioni. Solo Windows; queste impostazioni di connessione richiedono un DSN. Imposta la soglia delle query lente con QueryLogTime, in millisecondi. Utilizza una destinazione di logging controllata, autorizzazioni appropriate e una policy di conservazione. Non trattare i log diagnostici come privi di dati sensibili.

Per configurazioni e limiti, vedi Always Encrypted, Kerberos SPNs e il riferimento alle parole chiave. Alcune funzionalità native, come l'arruolamento nelle transazioni distribuite, richiedono attributi API piuttosto che una parola chiave di stringa di connessione.

Creare una DSN

Crea un DSN solo quando scegli una connessione basata su DSN. Un DSN memorizza la configurazione; salvarla non stabilisce che l'applicazione possa autenticarsi o eseguire una query.

DSN utente Windows

La procedura seguente crea un DSN utente per l'esempio di autenticazione SQL. Per un servizio, scegli deliberatamente System DSN invece e organizza l'accesso sotto l'identità del servizio.

  1. Apri l'Amministratore della Sorgente Dati ODBC che corrisponde all'architettura della tua applicazione.

  2. Su DSN utente, seleziona Aggiungi.

  3. Scegli ODBC Driver 18 per SQL Server o ODBC Driver 17 per SQL Server. Seleziona Finish per aprire la procedura guidata del driver.

  4. Assegna al DSN il nome MSSQLTest. Inserisci tcp:<server>,1433 come server e seleziona Avanti.

  5. Seleziona autenticazione SQL. Cancella ID di accesso e password, e seleziona Avanti.

  6. Abilitare Modifica il database predefinito in. Digita <database> senza aprire l'elenco del database e seleziona Avanti.

  7. Per il driver 18, seleziona la crittografia della connessione Obbligatoria. Per il Driver 17, seleziona Usa crittografia forte per i dati. Lascia Trust server certificate non selezionato.

  8. Seleziona Finish e consulta il riepilogo della configurazione.

  9. Seleziona OK per salvare il DSN senza eseguire il test di connessione della procedura guidata. Conferma che appare MSSQLTest su DSN utente.

L'applicazione fornisce le credenziali SQL al momento della connessione. Per altri metodi di autenticazione e campi della procedura guidata, vedi ODBC Data Source Administrator DSN options.

DSN utente Linux o macOS

Esegui odbcinst -j per trovare i percorsi di USER DATA SOURCES e SYSTEM DATA SOURCES per la tua installazione unixODBC. Aggiungi la seguente sezione al file utente, sostituendo i segnaposti server e database:

[MSSQLTest]
Driver = ODBC Driver 18 for SQL Server
Server = tcp:<server>,1433
Database = <database>
Authentication = SqlPassword
Encrypt = yes
TrustServerCertificate = no

Per il Driver 17, cambia il nome del driver. Non memorizzare PWD in questo file. La registrazione dei driver in odbcinst.ini e il DSN in odbc.ini servono a scopi diversi: uno individua la libreria dei driver e l'altro identifica le impostazioni di connessione.

Per un DSN di sistema, aggiungi le stesse impostazioni al file SYSTEM DATA SOURCES segnalato con privilegi amministrativi. Per un servizio, organizza l'accesso sotto l'identità del servizio.

Il Driver valore può essere il nome del driver registrato o il percorso verso la libreria driver specificata nel modello di installazione. In odbc.ini, usa il nome registrato senza le parentesi di stringa di connessione. Specifica la porta server in Server; Port non è una parola chiave DSN valida per questo driver su Linux o macOS.

In alternativa, salva la sezione DSN in un file modello e registra un DSN utente con il seguente comando:

odbcinst -i -s -h -f <template_file>

Sostituisci <template_file> con il percorso del modello. Per dettagli sul file .ini e sulla registrazione, consulta la documentazione di unixODBC. Verificare la connessione tramite l'applicazione che utilizza il DSN; la registrazione da sola non stabilisce una connessione al database.

File DSN

Usa FileDSN=<file_path> quando l'applicazione si aspetta un'origine dati file. Il client ha ancora bisogno di un driver installato che possa interpretare le impostazioni. Tieni le credenziali fuori dal file.

SaveFile richiede che le impostazioni di connessione vengano salvate in un file dopo una connessione riuscita. Usalo solo quando l'applicazione crea deliberatamente un file DSN. Per il contenuto dei file e le regole di unione, consulta il riferimento SQLDriverConnect.

Comprendere la precedenza di configurazione

Un'applicazione può ricevere impostazioni da un DSN, dalla sua stringa di connessione e dagli attributi dell'API. Rivedi tutti e tre quando la connessione effettiva differisce dalla stringa che ti aspetti.

Sorgente o sintassi Rule
Ortografia delle parole chiave Il driver abbina i nomi delle parole chiave senza distinzione tra maiuscole e minuscole. I valori accettati sono specifici per la parola chiave; non dare per scontato che ogni opzione booleana accetti true e false.
Parola chiave ripetuta Quando si analizzano le opzioni del driver, Driver 17 e Driver 18 mantengono la prima occorrenza di una parola chiave riconosciuta. Gli alias per la stessa opzione non prevedono un override separato. Questa regola non disciplina la precedente selezione del driver o del DSN del Driver Manager: unixODBC utilizza l'ultima occorrenza di un valore Driver o DSN ripetuto in quella fase. Sostituisci i valori esistenti invece di aggiungere duplicati e specifica la parola chiave di selezione una sola volta.
connection string rispetto a DSN I valori espliciti della stringa di connessione normalmente sovrascrino i campi DSN corrispondenti. L'impostazione DSN del RegPrecedence driver può invertire questa precedenza. Ispezionalo quando un DSN esistente si comporta in modo inaspettato.
Attributi API Gli attributi impostati dall'applicazione possono modificare la configurazione effettiva. Controlla il contratto dell'attributo specifico invece di presumere che ogni attributo utilizzi la stessa regola di fusione.
Valori tra parentesi graffe Racchiudi un valore contenente un punto e virgola tra parentesi graffe, e raddoppia una parentesi graffa chiusa all'interno del valore. Ad esempio, Database={database;name} fornisce un nome di database. L'uso delle virgolette nella shell o nel linguaggio di programmazione è separato dall'escape ODBC.

Mantieni coerenti le impostazioni di autenticazione e sicurezza sia nel DSN che nell'applicazione. Quando cambi driver, aggiorna il driver selezionato dal DSN o il valore Driver senza DSN secondo il caso. Per i controlli di migrazione, vedi Differenze tra versioni principali.

Controlla la connessione nella tua applicazione

Esegui il test con l'identità effettiva del sistema operativo e la configurazione di distribuzione dell'applicazione. Un test DSN guidato riuscito non dimostra che un servizio possa vedere lo stesso DSN o acquisire le stesse credenziali.

  1. Connettiti con il DSN scelto o la stringa senza DSN e con il metodo di autenticazione previsto.
  2. Dopo che la connessione ha avuto successo, conferma quale driver e versione carica l'applicazione. Nel codice nativo, usa SQLGetInfo con SQL_DRIVER_NAME e SQL_DRIVER_VER.
  3. Esegui una query nel database previsto e controllane il risultato. Per un esempio completo di applicazione, vedi Connetti a e interroga un database con C++.
  4. Verifica la crittografia e il comportamento richiesto dall'applicazione, come l'instradamento di sola lettura o il ripristino. Testa ogni modulo di connessione che distribuisci indipendentemente.
  5. Registra gli errori senza esporre le credenziali. Per i valori SQLSTATE, i codici di errore nativi e la raccolta diagnostica protetta, vedi diagnostica ODBC.

Se una connessione fallisce, verifica la registrazione del driver e la visibilità DSN prima di modificare l'autenticazione. Controlla l'endpoint e la raggiungibilità prima di modificare le impostazioni di ritentativo. Per un errore di certificato, correggi la configurazione di fiducia o di nome invece di impostare TrustServerCertificate=yes per far scomparire l'errore.