Condividi tramite

Uso delle parole chiave della stringa di connessione con OLE DB Driver per SQL Server

Si applica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema di Piattaforma Analitica (PDW)Database SQL in Microsoft Fabric

Download del driver OLE DB

Alcune API in OLE DB Driver per SQL Server usano le stringhe di connessione per specificare gli attributi di connessione. Le stringhe di connessione sono un elenco di parole chiave con i relativi valori associati. Ogni parola chiave identifica un particolare attributo di connessione.

Nota

OLE DB Driver per SQL Server consente ambiguità nelle stringhe di connessione per mantenere la compatibilità con le versioni precedenti, ad esempio alcune parole chiave possono essere specificate più volte e le parole chiave in conflitto potrebbero essere consentite con risoluzione in base alla posizione o alla precedenza. Nelle versioni future di OLE DB Driver for SQL Server è possibile che non sia più consentita l'ambiguità nelle stringhe di connessione. Quando si modificano le applicazioni, è consigliabile usare OLE DB Driver per SQL Server per eliminare eventuali dipendenze dall'ambiguità delle stringhe di connessione.

Nelle sezioni seguenti vengono descritte le parole chiave che è possibile specificare con OLE DB Driver per SQL Server e gli oggetti ADO (ActiveX Data Objects) quando si usa OLE DB Driver per SQL Server come provider di dati.

Parole chiave delle stringhe di connessione per il driver OLE DB

Quando si utilizzano le applicazioni OLE DB, è possibile inizializzare gli oggetti origine dati in due modi diversi:

  • IDBInitialize::Initialize
  • IDataInitialize::GetDataSource

Nel primo caso, è possibile utilizzare una stringa del provider per inizializzare le proprietà di connessione impostando la proprietà DBPROP_INIT_PROVIDERSTRING nel DBPROPSET_DBINIT set di proprietà. Nel secondo caso, è possibile passare una stringa di inizializzazione al IDataInitialize::GetDataSource metodo per inizializzare le proprietà di connessione. Entrambi i metodi inizializzano le stesse proprietà di connessione OLE DB, sebbene con set di parole chiave differenti. L'insieme di parole chiave utilizzato da IDataInitialize::GetDataSource corrisponde almeno alla descrizione delle proprietà all'interno del gruppo di proprietà di inizializzazione.

Per qualsiasi impostazione di stringa del provider con una proprietà OLE DB corrispondente impostata su un valore predefinito o impostata in modo esplicito su un valore, tramite il valore della proprietà OLE DB verrà eseguito l'override dell'impostazione nella stringa del provider.

Le proprietà booleane impostate nelle stringhe del provider tramite DBPROP_INIT_PROVIDERSTRING valori vengono impostate usando i valori yes e no. Le proprietà booleane impostate nelle stringhe di inizializzazione che usano IDataInitialize::GetDataSource vengono impostate usando i valori true e false.

Le applicazioni che usano IDataInitialize::GetDataSource possono usare anche le parole chiave usate da IDBInitialize::Initialize, ma solo per le proprietà che non hanno un valore predefinito. Se un'applicazione usa sia la IDataInitialize::GetDataSource parola chiave che la IDBInitialize::Initialize parola chiave nella stringa di inizializzazione, viene usata l'impostazione della IDataInitialize::GetDataSource parola chiave . È consigliabile che le applicazioni non usino IDBInitialize::Initialize parole chiave nelle IDataInitialize:GetDataSource stringhe di connessione, perché questo comportamento potrebbe non essere mantenuto nelle versioni future.

Nota

Una stringa di connessione passata tramite IDataInitialize::GetDataSource viene convertita in proprietà e applicata tramite IDBProperties::SetProperties. Se i servizi componenti hanno trovato la descrizione della proprietà in IDBProperties::GetPropertyInfo, questa proprietà verrà applicata come proprietà autonoma. In caso contrario, verrà applicato tramite la proprietà DBPROP_PROVIDERSTRING. Ad esempio, se si specifica la stringa Data Source=server1;Server=server2di connessione , Data Source verrà impostata come proprietà, ma Server verrà inserita in una stringa del provider.

Se si indicano più istanze per la stessa proprietà specifica del provider, verrà utilizzato il primo valore della prima proprietà.

Uso di IDBInitialize::Initialize

Le stringhe di connessione usate dalle applicazioni OLE DB usando DBPROP_INIT_PROVIDERSTRING con IDBInitialize::Initialize hanno la seguente sintassi:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=[{]attribute-value[}]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier

Anche se è facoltativo, si consiglia di racchiudere i valori di attributo tra parentesi graffe In questo modo si evitano i problemi determinati dalla presenza di caratteri non alfanumerici nei valori di attributo. Poiché si suppone che la prima parentesi graffa chiusa indichi la fine del valore, l'uso di tali parentesi nei valori non è consentito.

Uno spazio dopo il segno = in una parola chiave di una stringa di connessione verrà interpretato come valore letterale, anche se il valore è racchiuso tra virgolette.

Nella tabella seguente vengono descritte le parole chiave che è possibile usare con DBPROP_INIT_PROVIDERSTRING.

Parola chiave Proprietà di inizializzazione Descrizione
Addr SSPROP_INIT_NETWORKADDRESS Sinonimo di Address.
Address SSPROP_INIT_NETWORKADDRESS Indirizzo di rete del server che esegue un'istanza di SQL Server. Address è in genere il nome di rete del server, ma può essere costituito da altri nomi, ad esempio una pipe, un indirizzo IP o una porta TCP/IP e un indirizzo socket.

Se si specifica un indirizzo IP, assicurarsi che i protocolli TCP/IP o Named Pipes siano abilitati in Gestione configurazione SQL Server.

Il valore di Address ha la precedenza sul valore passato a Server nelle stringhe di connessione quando si usa OLE DB Driver per SQL Server. Address=; si connette al server specificato nella Server parola chiave , mentre Address= ;, Address=.;, Address=localhost;e Address=(local); tutti causano una connessione al server locale.

La sintassi completa per la Address parola chiave è la seguente:

[protocollo:]Indirizzo[,port|\pipe\pipename]

protocol può essere tcp (TCP/IP), lpc (memoria condivisa) o np (pipe nominata). Per altre informazioni sui protocolli, vedere Configurare i protocolli client.

Se non viene specificato alcun protocollo né la Network parola chiave , OLE DB Driver per SQL Server userà l'ordine di protocollo specificato in Gestione configurazione SQL Server.

port indica la porta a cui connettersi nel server specificato. Per impostazione predefinita, SQL Server usa la porta 1433.
APP SSPROP_INIT_APPNAME Stringa che identifica l'applicazione.
ApplicationIntent SSPROP_INIT_APPLICATIONINTENT Dichiara il tipo di carico di lavoro dell'applicazione in caso di connessione a un server. I valori possibili sono ReadOnly e ReadWrite.

Il valore predefinito è ReadWrite. Per altre informazioni sul supporto di OLE DB Driver per SQL Server per Gruppi di disponibilità Always On, vedere Supporto di OLE DB Driver per SQL Server per ripristino di emergenza e disponibilità elevata.
AttachDBFileName SSPROP_INIT_FILENAME Nome del file primario, incluso il nome completo del percorso, di un database collegabile. Per utilizzare AttachDBFileName, è necessario specificare anche il nome del database utilizzando la parola chiave "Database" nella stringa del provider. Se il database è stato collegato in precedenza, SQL Server non lo ricollega e usa il database collegato come predefinito per la connessione.
Authentication 1 SSPROP_AUTH_MODE Specifica l'autenticazione SQL o Microsoft Entra usata. I valori validi sono:
  • (not set): Modalità di autenticazione determinata da altre parole chiave.
  • ActiveDirectoryPassword: Identificativo utente e autenticazione tramite password con un'identità di Microsoft Entra.
  • ActiveDirectoryIntegrated: autenticazione integrata con Microsoft Entra ID.

    • Nota: La ActiveDirectoryIntegrated parola chiave può essere utilizzata anche per l'autenticazione Windows su SQL Server. Sostituisce le parole chiave di autenticazione Integrated Security (o Trusted_Connection). Le applicazioni che utilizzano Integrated Security (o Trusted_Connection) parole chiave o le loro relative proprietà dovrebbero impostare il valore della Authentication parola chiave (o della sua proprietà corrispondente) per ActiveDirectoryIntegrated abilitare un nuovo comportamento di crittografia e validazione dei certificati.

  • ActiveDirectoryInteractive: Autenticazione interattiva con un'identità Microsoft Entra. Questo metodo supporta anche l'autenticazione a più fattori di Microsoft Entra.
  • ActiveDirectoryMSI: Autenticazione dell'identità gestita . Per un'identità assegnata dall'utente, l'ID utente deve essere impostato sull'ID oggetto dell'identità utente.
  • ActiveDirectoryServicePrincipal: autenticazione con un principal del servizio Microsoft Entra. L'ID utente deve essere impostato sull'ID applicazione (client). La password deve essere impostata sul segreto client dell'applicazione.
  • SqlPassword: Autenticazione tramite ID utente e password.

    • Nota: Le applicazioni che utilizzano l'autenticazione SQL Server devono impostare il valore della Authentication parola chiave (o della sua proprietà corrispondente) per SqlPassword abilitare un nuovo comportamento di crittografia e validazione dei certificati.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Sinonimo di AutoTranslate.
AutoTranslate SSPROP_INIT_AUTOTRANSLATE Configura la conversione dei caratteri OEM/ANSI. I valori riconosciuti sono yes e no.
ConnectRetryCount SSPROP_INIT_CONNECT_RETRY_COUNT Controlla il numero di tentativi di riconnessione se la connessione si interrompe. I valori validi sono compresi tra 0 e 255. Il valore predefinito è 1. Il valore di 0 non provocherebbe alcun tentativo di riconnessione. Per altre informazioni, vedere Resilienza delle connessioni inattive in OLE DB Driver.
ConnectRetryInterval SSPROP_INIT_CONNECT_RETRY_INTERVAL Specifica il numero di secondi che deve intercorrere tra ogni tentativo di connessione se la connessione si interrompe. I valori validi sono compresi tra 1 e 60. Il valore predefinito è 10. Per altre informazioni, vedere Resilienza delle connessioni inattive in OLE DB Driver.
Database DBPROP_INIT_CATALOG Nome del database.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Specifica la modalità di gestione dei tipi di dati da utilizzare. I valori riconosciuti sono 0 per i tipi di dati del provider e 80 per i tipi di dati di SQL Server 2000 (8.x).
Encrypt 1 SSPROP_INIT_ENCRYPT Specifica se i dati devono essere crittografati prima del relativo invio in rete. I valori possibili sono Optional, Mandatory e Strict. Il valore predefinito è Mandatory. Per le versioni 18.x.x, vedere Differenze tra le versioni principali di MSOLEDBSQL.
FailoverPartner SSPROP_INIT_FAILOVERPARTNER Nome del server di failover utilizzato per il mirroring del database.
FailoverPartnerSPN SSPROP_INIT_FAILOVERPARTNERSPN Nome SPN del partner di failover. Il valore predefinito è una stringa vuota. Una stringa vuota in OLE DB Driver per SQL Server determina l'uso del nome SPN predefinito generato dal provider.
HostNameInCertificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. Se la HostNameInCertificate parola chiave non è impostata, il driver usa il valore della Server parola chiave nell'URL di connessione come nome host per convalidare il certificato TLS/SSL di SQL Server.
Nota: questa proprietà viene ignorata se il certificato del server è attendibile. Se Encrypt è impostato su Strict, il certificato verrà sempre convalidato.
Language SSPROP_INIT_CURRENTLANGUAGE Lingua di SQL Server.
MarsConn SSPROP_INIT_MARSCONNECTION Abilita o disabilita MARS (Multiple Active Result Set) nella connessione se il server è SQL Server 2005 (9.x) o versione successiva. I valori possibili sono yes e no. Il valore predefinito è no.
MultiSubnetFailover SSPROP_INIT_MULTISUBNETFAILOVER Specifica sempre MultiSubnetFailover=Yes quando ti connetti al listener di un gruppo di disponibilità di SQL Server o a un'istanza di SQL Server del cluster di failover. MultiSubnetFailover=Yes configura OLE DB Driver per SQL Server per fornire un rilevamento e una connessione più veloci al server attivo (attualmente). I valori possibili sono Yes e No. Il valore predefinito è No. Ad esempio:

MultiSubnetFailover=Yes

Per altre informazioni sul supporto di OLE DB Driver per SQL Server per Gruppi di disponibilità Always On, vedere Supporto di OLE DB Driver per SQL Server per ripristino di emergenza e disponibilità elevata.
Net SSPROP_INIT_NETWORKLIBRARY Sinonimo di Network.
Network SSPROP_INIT_NETWORKLIBRARY Libreria di rete usata per stabilire una connessione a un'istanza di SQL Server nell'organizzazione.
Network Library SSPROP_INIT_NETWORKLIBRARY Sinonimo di Network.
PacketSize SSPROP_INIT_PACKETSIZE Dimensioni del pacchetto del flusso TDS. Il valore predefinito è 0 (il valore effettivo verrà determinato dal server).
PersistSensitive DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Accetta le stringhe yes e no come valori. Se si usa no, l'oggetto origine dati non può salvare in modo permanente le informazioni di autenticazione sensibili
PWD DBPROP_AUTH_PASSWORD Password di accesso di SQL Server.
Server DBPROP_INIT_DATASOURCE Nome di un'istanza di SQL Server. Il valore deve corrispondere al nome di un server nella rete, a un indirizzo IP o al nome di un alias di Gestione configurazione SQL Server.

Se non viene specificato un nome, viene stabilita una connessione all'istanza predefinita nel computer locale.

La Address parola chiave esegue l'override della Server parola chiave .

È possibile connettersi all'istanza predefinita nel server locale specificando una delle opzioni seguenti:

Server=;
Server=.;
Server=(local);
Server=(local);
Server=(localhost);
Server=(localdb)\<instancename>;

Per altre informazioni sul supporto per Local DB, vedere Supporto del driver OLE DB per SQL Server per Local DB.

Per specificare un'istanza denominata di SQL Server, aggiungere \<InstanceName>.

Se non viene specificato un server, viene stabilita una connessione all'istanza predefinita nel computer locale.

Se si specifica un indirizzo IP, assicurarsi che i protocolli TCP/IP o Named Pipes siano abilitati in Gestione configurazione SQL Server.

La sintassi completa per la Server parola chiave è la seguente:

[protocollo:]Server[,porta]

protocol può essere tcp (TCP/IP), lpc (memoria condivisa) o np (pipe nominata).

L'esempio seguente specifica una named pipe:

np:\\.\pipe\MSSQL$MYINST01\sql\query

La riga precedente specifica il protocollo Named Pipes (np), una named pipe nel computer locale (\\.\pipe), il nome dell'istanza di SQL Server (MSSQL$MYINST01) e il nome predefinito della named pipe (sql/query).

Se non viene specificato alcun protocollo né la Network parola chiave , OLE DB Driver per SQL Server userà l'ordine di protocollo specificato in Gestione configurazione SQL Server.

port indica la porta a cui connettersi nel server specificato. Per impostazione predefinita, SQL Server usa la porta 1433.

Gli spazi vengono ignorati all'inizio del valore passato a Server nelle stringhe di connessione quando si usa OLE DB Driver per SQL Server.
ServerCertificate SSPROP_INIT_SERVER_CERTIFICATE Specifica il percorso di un file di certificato per cui cercare la corrispondenza con il certificato TLS/SSL di SQL Server. Questa opzione può essere usata solo quando è abilitata la crittografia Strict. I formati di certificato accettati sono PEM, DER e CER. Se specificato, il certificato di SQL Server viene controllato esaminando se il certificato fornito è una corrispondenza esatta.
ServerSPN SSPROP_INIT_SERVERSPN Nome SPN del server. Il valore predefinito è una stringa vuota. Una stringa vuota in OLE DB Driver per SQL Server determina l'uso del nome SPN predefinito generato dal provider.
Timeout DBPROP_INIT_TIMEOUT Tempo di attesa in secondi per il completamento dell'inizializzazione dell'origine dati.
TransparentNetworkIPResolution SSPROP_INIT_TNIR Influisce sulla sequenza di connessione quando il primo IP risolto del nome host non risponde e sono presenti più IP associati al nome host. La risoluzione dell'IP di rete trasparente interagisce con MultiSubnetFailover per fornire diverse sequenze di connessione. I valori possibili sono Yes e No. Il valore predefinito è Yes. Per altre informazioni vedere Uso della risoluzione dell'IP di rete trasparente.
Trusted_Connection DBPROP_AUTH_INTEGRATED Se questa opzione è impostata su yes, indica a OLE DB Driver per SQL Server di usare l'autenticazione di Windows per la convalida dell'accesso. In caso contrario, OLE DB Driver per SQL Server userà un nome utente e una password di SQL Server per la convalida dell'accesso ed è necessario specificare le parole chiave UID e PWD.
TrustServerCertificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Accetta le stringhe yes e no come valori. Il valore predefinito è no e indica che il certificato server verrà convalidato.
UID DBPROP_AUTH_USERID Nome di accesso di SQL Server.
UseFMTONLY SSPROP_INIT_USEFMTONLY Controlla la modalità di recupero dei metadati durante la connessione a SQL Server 2012 (11.x) e versioni successive. I valori possibili sono yes e no. Il valore predefinito è no.

Per impostazione predefinita, OLE DB Driver per SQL Server usa le stored procedure sp_describe_first_result_set e sp_describe_undeclared_parameters per recuperare i metadati. Queste stored procedure presentano alcune limitazioni, ad esempio hanno esito negativo se usate con tabelle temporanee. Impostando UseFMTONLY su yes, si istruisce il driver a utilizzare SET FMTONLY per il recupero dei metadati.
UseProcForPrepare SSPROP_INIT_USEPROCFORPREP Questa parola chiave è deprecata e la relativa impostazione viene ignorata da OLE DB Driver per SQL Server.
WSID SSPROP_INIT_WSID Identificatore della workstation.

1 Per migliorare la sicurezza, il comportamento di crittografia e convalida dei certificati viene modificato quando si utilizzano le proprietà di inizializzazione di autenticazione o di token di accesso, oppure le parole chiave della stringa di connessione corrispondenti. Per altre informazioni, vedere Crittografia e convalida di certificati.

Usare IDataInitialize::GetDataSource

Le stringhe di connessione usate dalle applicazioni OLE DB con IDataInitialize::GetDataSource hanno la sintassi seguente:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=[quote]attribute-value[quote]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier
  • quote ::= " | '

L'utilizzo delle proprietà deve essere conforme alla sintassi consentita nel relativo ambito. Ad esempio, WSID usa le parentesi graffe ({}) e Application Name usa virgolette singole (') o doppie ("). Solo per le proprietà delle stringhe è possibile utilizzare le virgolette. Se si tenta di usare le virgolette con una proprietà integer o enumerata, verrà generato un errore Connection String doesn't conform to OLE DB specification.

È consigliabile, ma non obbligatorio, racchiudere i valori di attributo tra virgolette semplici o doppie. In questo modo si evitano i problemi determinati dalla presenza di caratteri non alfanumerici nei valori. Il carattere di virgolette usato può essere presente anche nei valori, se questi sono racchiusi tra virgolette doppie.

Uno spazio dopo il segno = in una parola chiave di una stringa di connessione verrà interpretato come valore letterale, anche se il valore è racchiuso tra virgolette.

Se una stringa di connessione include più di una delle proprietà elencate nella tabella seguente, verrà utilizzato il valore dell'ultima proprietà.

Nella tabella seguente vengono descritte le parole chiave che potrebbero essere usate con IDataInitialize::GetDataSource:

Parola chiave Proprietà di inizializzazione Descrizione
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN Token di accesso usato per eseguire l'autenticazione per Microsoft Entra ID.

Nota: è un errore specificare questa parola chiave e anche le parole chiave della stringa di connessione UID, PWD, Trusted_Connection o Authentication o le loro proprietà/parole chiave corrispondenti.
Application Name SSPROP_INIT_APPNAME Stringa che identifica l'applicazione.
Application Intent SSPROP_INIT_APPLICATIONINTENT Dichiara il tipo di carico di lavoro dell'applicazione in caso di connessione a un server. I valori possibili sono ReadOnly e ReadWrite.

Il valore predefinito è ReadWrite. Per altre informazioni sul supporto di OLE DB Driver per SQL Server per Gruppi di disponibilità Always On, vedere Supporto di OLE DB Driver per SQL Server per ripristino di emergenza e disponibilità elevata.
Authentication 1 SSPROP_AUTH_MODE Specifica l'autenticazione SQL o Microsoft Entra usata. I valori validi sono:
  • (not set): Modalità di autenticazione determinata da altre parole chiave.
  • ActiveDirectoryPassword: Identificativo utente e autenticazione tramite password con un'identità di Microsoft Entra.
  • ActiveDirectoryIntegrated: autenticazione integrata con Microsoft Entra ID.

    • Nota: La ActiveDirectoryIntegrated parola chiave può essere utilizzata anche per l'autenticazione Windows su SQL Server. Sostituisce le parole chiave di autenticazione Integrated Security (o Trusted_Connection). Le applicazioni che utilizzano Integrated Security (o Trusted_Connection) parole chiave o le loro relative proprietà dovrebbero impostare il valore della Authentication parola chiave (o della sua proprietà corrispondente) per ActiveDirectoryIntegrated abilitare un nuovo comportamento di crittografia e validazione dei certificati.

  • ActiveDirectoryInteractive: Autenticazione interattiva con un'identità Microsoft Entra. Questo metodo supporta anche l'autenticazione a più fattori di Microsoft Entra.
  • ActiveDirectoryMSI: Autenticazione dell'identità gestita . Per un'identità assegnata dall'utente, l'ID utente deve essere impostato sull'ID oggetto dell'identità utente.
  • ActiveDirectoryServicePrincipal: autenticazione con un principal del servizio Microsoft Entra. L'ID utente deve essere impostato sull'ID applicazione (client). La password deve essere impostata sul segreto client dell'applicazione.
  • SqlPassword: Autenticazione tramite ID utente e password.

    • Nota: Le applicazioni che utilizzano l'autenticazione SQL Server devono impostare il valore della Authentication parola chiave (o della sua proprietà corrispondente) per SqlPassword abilitare un nuovo comportamento di crittografia e validazione dei certificati.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Configura la conversione dei caratteri OEM/ANSI. I valori riconosciuti sono true e false.
Connect Timeout DBPROP_INIT_TIMEOUT Tempo di attesa in secondi per il completamento dell'inizializzazione dell'origine dati.
Connect Retry Count SSPROP_INIT_CONNECT_RETRY_COUNT Controlla il numero di tentativi di riconnessione se la connessione si interrompe. I valori validi sono compresi tra 0 e 255. Il valore predefinito è 1. Il valore di 0 non provocherebbe alcun tentativo di riconnessione. Per altre informazioni, vedere Resilienza delle connessioni inattive in OLE DB Driver.
Connect Retry Interval SSPROP_INIT_CONNECT_RETRY_INTERVAL Specifica il numero di secondi che deve intercorrere tra ogni tentativo di connessione se la connessione si interrompe. I valori validi sono compresi tra 1 e 60. Il valore predefinito è 10. Per altre informazioni, vedere Resilienza delle connessioni inattive in OLE DB Driver.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Nome della lingua di SQL Server.
Data Source DBPROP_INIT_DATASOURCE Nome di un'istanza di SQL Server nell'organizzazione.

Se non viene specificato un nome, viene stabilita una connessione all'istanza predefinita nel computer locale.

Per altre informazioni sulla sintassi degli indirizzi valida, vedere la descrizione della Server parola chiave, in questo articolo.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Specifica la modalità di gestione dei tipi di dati da utilizzare. I valori riconosciuti sono 0 per i tipi di dati del provider e 80 per i tipi di dati di SQL Server 2000 (8.x).
Failover Partner SSPROP_INIT_FAILOVERPARTNER Nome del server di failover utilizzato per il mirroring del database.
Failover Partner SPN SSPROP_INIT_FAILOVERPARTNERSPN Nome SPN del partner di failover. Il valore predefinito è una stringa vuota. Una stringa vuota in OLE DB Driver per SQL Server determina l'uso del nome SPN predefinito generato dal provider.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. Se la Host Name In Certificate parola chiave non è impostata, il driver usa il valore della Data Source parola chiave nell'URL di connessione come nome host per convalidare il certificato TLS/SSL di SQL Server.
Nota: questa proprietà viene ignorata se il certificato del server è attendibile. Se Use Encryption for Data è impostato su Strict, il certificato verrà sempre convalidato.
Initial Catalog DBPROP_INIT_CATALOG Nome del database.
Initial File Name SSPROP_INIT_FILENAME Nome del file primario, incluso il nome completo del percorso, di un database collegabile. Per usare AttachDBFileName, è necessario specificare anche il nome del database con la parola chiave della stringa DATABASE del provider. Se il database è stato collegato in precedenza, SQL Server non lo ricollega e usa il database collegato come predefinito per la connessione.
Integrated Security DBPROP_AUTH_INTEGRATED Accetta il valore SSPI per l'autenticazione di Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Abilita o disabilita MARS (Multiple Active Result Sets) nella connessione. I valori riconosciuti sono true e false. Il valore predefinito è false.
MultiSubnetFailover SSPROP_INIT_MULTISUBNETFAILOVER Specifica sempre MultiSubnetFailover=True quando ti connetti al listener di un gruppo di disponibilità di SQL Server o a un'istanza di SQL Server del cluster di failover. MultiSubnetFailover=True configura OLE DB Driver per SQL Server per fornire un rilevamento e una connessione più veloci al server attivo (attualmente). I valori possibili sono True e False. Il valore predefinito è False. Ad esempio:

MultiSubnetFailover=True

Per altre informazioni sul supporto di OLE DB Driver per SQL Server per Gruppi di disponibilità Always On, vedere Supporto di OLE DB Driver per SQL Server per ripristino di emergenza e disponibilità elevata.
Network Address SSPROP_INIT_NETWORKADDRESS Indirizzo di rete di un'istanza di SQL Server nell'organizzazione.

Per altre informazioni sulla sintassi degli indirizzi valida, vedere la descrizione della Address parola chiave, in questo articolo.
Network Library SSPROP_INIT_NETWORKLIBRARY Libreria di rete usata per stabilire una connessione a un'istanza di SQL Server nell'organizzazione.
Packet Size SSPROP_INIT_PACKETSIZE Dimensioni del pacchetto del flusso TDS. Il valore predefinito è 0 (il valore effettivo verrà determinato dal server).
Password DBPROP_AUTH_PASSWORD Password di accesso di SQL Server.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Accetta le stringhe true e false come valori. Se il valore è false, l'oggetto origine dati non può salvare in modo permanente le informazioni di autenticazione sensibili
Provider Per OLE DB Driver per SQL Server il valore è MSOLEDBSQL19 o MSOLEDBSQL.
Server Certificate SSPROP_INIT_SERVER_CERTIFICATE Specifica il percorso di un file di certificato per cui cercare la corrispondenza con il certificato TLS/SSL di SQL Server. Questa opzione può essere usata solo quando è abilitata la crittografia Strict. I formati di certificato accettati sono PEM, DER e CER. Se specificato, il certificato di SQL Server viene controllato esaminando se il certificato fornito è una corrispondenza esatta.
Server SPN SSPROP_INIT_SERVERSPN Nome SPN del server. Il valore predefinito è una stringa vuota. Una stringa vuota in OLE DB Driver per SQL Server determina l'uso del nome SPN predefinito generato dal provider.
TransparentNetworkIPResolution SSPROP_INIT_TNIR Influisce sulla sequenza di connessione quando il primo IP risolto del nome host non risponde e sono presenti più IP associati al nome host. La risoluzione dell'IP di rete trasparente interagisce con MultiSubnetFailover per fornire diverse sequenze di connessione. I valori possibili sono True e False. Il valore predefinito è True. Per altre informazioni vedere Uso della risoluzione dell'IP di rete trasparente.
Trust Server Certificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Accetta le stringhe true e false come valori. Il valore predefinito è false e indica che il certificato server verrà convalidato.
Use Encryption for Data 1 SSPROP_INIT_ENCRYPT Specifica se i dati devono essere crittografati prima del relativo invio in rete. I valori possibili sono Optional, Mandatory e Strict. Il valore predefinito è Mandatory. Per le versioni 18.x.x, vedere Differenze tra le versioni principali di MSOLEDBSQL.
Use FMTONLY SSPROP_INIT_USEFMTONLY Controlla la modalità di recupero dei metadati durante la connessione a SQL Server 2012 (11.x) e versioni successive. I valori possibili sono true e false. Il valore predefinito è false.

Per impostazione predefinita, OLE DB Driver per SQL Server usa le stored procedure sp_describe_first_result_set e sp_describe_undeclared_parameters per recuperare i metadati. Queste stored procedure presentano alcune limitazioni, ad esempio hanno esito negativo se usate con tabelle temporanee. L'impostazione del valore Use FMTONLY su true indica al driver di usare SET FMTONLY per il recupero dei metadati.
User ID DBPROP_AUTH_USERID Nome di accesso di SQL Server.
Workstation ID SSPROP_INIT_WSID Identificatore della workstation.

1 Per migliorare la sicurezza, vengono modificati i comportamenti di crittografia e convalida dei certificati quando si usano le proprietà di inizializzazione del token di autenticazione/accesso o le parole chiave della stringa di connessione corrispondenti. Per i dettagli, vedere Crittografia e convalida di certificati.

Nota

Nella stringa di connessione, la proprietà Old Password imposta SSPROP_AUTH_OLD_PASSWORD, ovvero la password corrente (possibilmente scaduta) che non è disponibile attraverso una proprietà della stringa del provider.

Parole chiave delle stringhe di connessione ADO (ActiveX Data Objects)

Le applicazioni ADO impostano la ConnectionString proprietà degli ADODBConnection oggetti o forniscono una stringa di connessione come parametro al Open metodo degli ADODBConnection oggetti .

Le applicazioni ADO possono usare anche le parole chiave usate dal metodo OLE DB IDBInitialize::Initialize , ma solo per le proprietà che non hanno un valore predefinito. Se un'applicazione usa sia le parole chiave ADO che le IDBInitialize::Initialize parole chiave nella stringa di inizializzazione, verrà usata l'impostazione della parola chiave ADO. Nelle applicazioni è consigliabile usare solo parole chiave delle stringhe di connessione ADO.

Le stringhe di connessione utilizzate da ADO presentano la sintassi seguente:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=["]attribute-value["]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier

È consigliabile, ma non obbligatorio, racchiudere i valori di attributo tra virgolette doppie. In questo modo si evitano i problemi determinati dalla presenza di caratteri non alfanumerici nei valori. I valori di attributo non possono contenere virgolette doppie.

La tabella seguente descrive le parole chiave che possono essere usate con una stringa di connessione ADO:

Parola chiave Proprietà di inizializzazione Descrizione
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN Token di accesso usato per eseguire l'autenticazione per Microsoft Entra ID.

Nota: è un errore specificare questa parola chiave insieme alle parole chiave della stringa di connessione UID, PWD, Trusted_Connection o Authentication o alle loro proprietà/parole chiave corrispondenti.
Application Intent SSPROP_INIT_APPLICATIONINTENT Dichiara il tipo di carico di lavoro dell'applicazione in caso di connessione a un server. I valori possibili sono ReadOnly e ReadWrite.

Il valore predefinito è ReadWrite. Per altre informazioni sul supporto di OLE DB Driver per SQL Server per Gruppi di disponibilità Always On, vedere Supporto di OLE DB Driver per SQL Server per ripristino di emergenza e disponibilità elevata.
Application Name SSPROP_INIT_APPNAME Stringa che identifica l'applicazione.
Authentication 1 SSPROP_AUTH_MODE Specifica l'autenticazione SQL o Microsoft Entra usata. I valori validi sono:
  • (not set): Modalità di autenticazione determinata da altre parole chiave.
  • ActiveDirectoryPassword: Identificativo utente e autenticazione tramite password con un'identità di Microsoft Entra.
  • ActiveDirectoryIntegrated: autenticazione integrata con Microsoft Entra ID.

    • Nota: La ActiveDirectoryIntegrated parola chiave può essere utilizzata anche per l'autenticazione Windows su SQL Server. Sostituisce le parole chiave di autenticazione Integrated Security (o Trusted_Connection). Le applicazioni che utilizzano Integrated Security (o Trusted_Connection) parole chiave o le loro relative proprietà dovrebbero impostare il valore della Authentication parola chiave (o della sua proprietà corrispondente) per ActiveDirectoryIntegrated abilitare un nuovo comportamento di crittografia e validazione dei certificati.

  • ActiveDirectoryInteractive: Autenticazione interattiva con un'identità Microsoft Entra. Questo metodo supporta anche l'autenticazione a più fattori di Microsoft Entra.
  • ActiveDirectoryMSI: Autenticazione dell'identità gestita . Per un'identità assegnata dall'utente, l'ID utente deve essere impostato sull'ID oggetto dell'identità utente.
  • ActiveDirectoryServicePrincipal: autenticazione con un principal del servizio Microsoft Entra. L'ID utente deve essere impostato sull'ID applicazione (client). La password deve essere impostata sul segreto client dell'applicazione.
  • SqlPassword: Autenticazione tramite ID utente e password.

    • Nota: Le applicazioni che utilizzano l'autenticazione SQL Server devono impostare il valore della Authentication parola chiave (o della sua proprietà corrispondente) per SqlPassword abilitare un nuovo comportamento di crittografia e validazione dei certificati.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Configura la conversione dei caratteri OEM/ANSI. I valori riconosciuti sono true e false.
Connect Timeout DBPROP_INIT_TIMEOUT Tempo di attesa in secondi per il completamento dell'inizializzazione dell'origine dati.
Connect Retry Count SSPROP_INIT_CONNECT_RETRY_COUNT Controlla il numero di tentativi di riconnessione se la connessione si interrompe. I valori validi sono compresi tra 0 e 255. Il valore predefinito è 1. Il valore di 0 non provocherebbe alcun tentativo di riconnessione. Per altre informazioni, vedere Resilienza delle connessioni inattive in OLE DB Driver.
Connect Retry Interval SSPROP_INIT_CONNECT_RETRY_INTERVAL Specifica il numero di secondi che deve intercorrere tra ogni tentativo di connessione se la connessione si interrompe. I valori validi sono compresi tra 1 e 60. Il valore predefinito è 10. Per altre informazioni, vedere Resilienza delle connessioni inattive in OLE DB Driver.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Nome della lingua di SQL Server.
Data Source DBPROP_INIT_DATASOURCE Nome di un'istanza di SQL Server nell'organizzazione.

Se non viene specificato un nome, viene stabilita una connessione all'istanza predefinita nel computer locale.

Per altre informazioni sulla sintassi degli indirizzi valida, vedere la descrizione della Server parola chiave, in questo articolo.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Specifica la modalità di gestione dei tipi di dati che verrà utilizzata. I valori riconosciuti sono 0 per i tipi di dati del provider e 80 per i tipi di dati di SQL Server 2000 (8.x).
Failover Partner SSPROP_INIT_FAILOVERPARTNER Nome del server di failover utilizzato per il mirroring del database.
Failover Partner SPN SSPROP_INIT_FAILOVERPARTNERSPN Nome SPN del partner di failover. Il valore predefinito è una stringa vuota. Una stringa vuota in OLE DB Driver per SQL Server determina l'uso del nome SPN predefinito generato dal provider.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. Se la Host Name In Certificate parola chiave non è impostata, il driver usa il valore della Data Source parola chiave nell'URL di connessione come nome host per convalidare il certificato TLS/SSL di SQL Server.
Nota: questa proprietà viene ignorata se il certificato del server è attendibile. Se Use Encryption for Data è impostato su Strict, il certificato verrà sempre convalidato.
Initial Catalog DBPROP_INIT_CATALOG Nome del database.
Initial File Name SSPROP_INIT_FILENAME Nome del file primario, incluso il nome completo del percorso, di un database collegabile. Per usare AttachDBFileName, è necessario specificare anche il nome del database con la parola chiave della stringa DATABASE del provider. Se il database è stato collegato in precedenza, SQL Server non lo ricollega e usa il database collegato come predefinito per la connessione.
Integrated Security DBPROP_AUTH_INTEGRATED Accetta il valore SSPI per l'autenticazione di Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Abilita o disabilita MARS (Multiple Active Result Set) nella connessione se il server è SQL Server 2005 (9.x) o versione successiva. I valori riconosciuti sono true e false. Il valore predefinito è false.
MultiSubnetFailover SSPROP_INIT_MULTISUBNETFAILOVER Specifica sempre MultiSubnetFailover=True quando ti connetti al listener di un gruppo di disponibilità di SQL Server o a un'istanza di SQL Server del cluster di failover. MultiSubnetFailover=True configura OLE DB Driver per SQL Server per fornire un rilevamento e una connessione più veloci al server attivo (attualmente). I valori possibili sono True e False. Il valore predefinito è False. Ad esempio:

MultiSubnetFailover=True

Per altre informazioni sul supporto di OLE DB Driver per SQL Server per Gruppi di disponibilità Always On, vedere Supporto di OLE DB Driver per SQL Server per ripristino di emergenza e disponibilità elevata.
Network Address SSPROP_INIT_NETWORKADDRESS Indirizzo di rete di un'istanza di SQL Server nell'organizzazione.

Per altre informazioni sulla sintassi degli indirizzi valida, vedere la descrizione della Address parola chiave, in questo articolo.
Network Library SSPROP_INIT_NETWORKLIBRARY Libreria di rete usata per stabilire una connessione a un'istanza di SQL Server nell'organizzazione.
Packet Size SSPROP_INIT_PACKETSIZE Dimensioni del pacchetto del flusso TDS. Il valore predefinito è 0 (il valore effettivo verrà determinato dal server).
Password DBPROP_AUTH_PASSWORD Password di accesso di SQL Server.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Accetta le stringhe true e false come valori. Se il valore è false, l'oggetto origine dati non può salvare in modo permanente le informazioni di autenticazione sensibili.
Provider Per OLE DB Driver per SQL Server il valore è MSOLEDBSQL19 o MSOLEDBSQL.
Server Certificate SSPROP_INIT_SERVER_CERTIFICATE Specifica il percorso di un file di certificato per cui cercare la corrispondenza con il certificato TLS/SSL di SQL Server. Questa opzione può essere usata solo quando è abilitata la crittografia Strict. I formati di certificato accettati sono PEM, DER e CER. Se specificato, il certificato di SQL Server viene controllato esaminando se il certificato fornito è una corrispondenza esatta.
Server SPN SSPROP_INIT_SERVERSPN Nome SPN del server. Il valore predefinito è una stringa vuota. Una stringa vuota in OLE DB Driver per SQL Server determina l'uso del nome SPN predefinito generato dal provider.
TransparentNetworkIPResolution SSPROP_INIT_TNIR Influisce sulla sequenza di connessione quando il primo IP risolto del nome host non risponde e sono presenti più IP associati al nome host. La risoluzione dell'IP di rete trasparente interagisce con MultiSubnetFailover per fornire diverse sequenze di connessione. I valori possibili sono True e False. Il valore predefinito è True. Per altre informazioni vedere Uso della risoluzione dell'IP di rete trasparente.
Trust Server Certificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Accetta le stringhe true e false come valori. Il valore predefinito è false e indica che il certificato server verrà convalidato.
Use Encryption for Data 1 SSPROP_INIT_ENCRYPT Specifica se i dati devono essere crittografati prima del relativo invio in rete. I valori possibili sono Optional, Mandatory e Strict. Il valore predefinito è Mandatory. Per le versioni 18.x.x, vedere Differenze tra le versioni principali di MSOLEDBSQL.
Use FMTONLY SSPROP_INIT_USEFMTONLY Controlla la modalità di recupero dei metadati durante la connessione a SQL Server 2012 (11.x) e versioni successive. I valori possibili sono true e false. Il valore predefinito è false.

Per impostazione predefinita, OLE DB Driver per SQL Server usa le stored procedure sp_describe_first_result_set e sp_describe_undeclared_parameters per recuperare i metadati. Queste stored procedure presentano alcune limitazioni, ad esempio hanno esito negativo se usate con tabelle temporanee. L'impostazione Use FMTONLY su true indica al driver di usare SET FMTONLY per il recupero dei metadati.
User ID DBPROP_AUTH_USERID Nome di accesso di SQL Server.
Workstation ID SSPROP_INIT_WSID Identificatore della workstation.

1 Per migliorare la sicurezza, crittografia e convalida dei certificati vengono modificati quando si usano le proprietà di inizializzazione del token di autenticazione/accesso o le parole chiave corrispondenti della stringa di connessione. Per i dettagli, vedere Crittografia e convalida di certificati.

Nota

Nella stringa di connessione la proprietà "Vecchia password" imposta SSPROP_AUTH_OLD_PASSWORD, ovvero la password corrente (possibilmente scaduta) non disponibile tramite una proprietà della stringa del provider.

Contenuti correlati

  • Last updated on