Proprietà della stringa di connessione

Si applica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Questo articolo descrive le proprietà della stringa di connessione usate dalle applicazioni client che si connettono ed eseguono query su Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS) e modelli semantici Power BI Premium. Queste proprietà vengono usate dalle librerie client di Analysis Services, ADOMD.NET, AMO e dal provider OLE DB (MSOLAP) per Analysis Services. La maggior parte delle proprietà della stringa di connessione può essere usata con tutte e tre le librerie client. Le eccezioni vengono evidenziate nella descrizione.

Usare il selettore Version sopra il sommario a sinistra per visualizzare solo le proprietà applicabili a una determinata piattaforma o versione.

Proprietà di connessione

Sorgente dati

Specifica l'istanza del server. Questa proprietà è obbligatoria per tutte le connessioni.

Provider

Questa proprietà è obbligatoria nella stringa di connessione quando si usa un provider OLE DB come MSOLAP. Consente di usare un provider indipendente dalla versione (in genere la più recente) come "Provider=MSOLAP", oppure è anche possibile specificare un provider dipendente dalla versione come "Provider=MSOLAP.7". I valori dipendenti dalla versione validi seguono il modello MSOLAP.<versione>, dove <la versione> è 7 o 8. Ad esempio, MSOLAP.7 rilasciato in SQL Server 2016. La versione ".8" è la più recente e considerata "sempreverdi". È previsto che l'aggiornamento continui con la compatibilità con le versioni precedenti mantenuto. I numeri di versione precedenti sono anche possibili, ma queste versioni di MSOLAP non sono ora supportate standard.

Questa proprietà è facoltativa per ADOMD.NET e AMO. È consentito per praticità quando si copia una stringa di connessione MSOLAP da usare con ADOMD.NET e AMO.

Cube

Nome del cubo o nome della prospettiva. Un database può contenere più cubi e prospettive. Quando sono possibili più destinazioni, includere il nome del cubo o della prospettiva nella stringa di connessione.

Proprietà di autenticazione e sicurezza

Le proprietà sono elencate in ordine alfabetico.

EffectiveUserName

Usare quando un'identità utente deve essere rappresentata nel server. Per SSAS, specificare in un formato dominio\utente. Per Azure AS e Power BI Premium, specificare in formato UPN. Per utilizzare questa proprietà, il chiamante deve disporre di autorizzazioni amministrative in Analysis Services. In Power BI Premium il chiamante deve essere un amministratore dell'area di lavoro in cui si trova il modello semantico.

CustomData

Valore stringa da passare al motore nella stringa di connessione e quindi recuperato tramite la funzione MDX CustomData() o CUSTOMDATA(). Usato più comunemente per passare un id utente o un nome utente come valore e quindi specificare tale valore nella definizione di un'espressione di sicurezza.

Livello di rappresentazione

Indica il livello di rappresentazione che il server può usare durante la rappresentazione del client. I valori validi includono:

• Anonimo. Il client è anonimo al server. Il processo del server non può ottenere informazioni sul client, né può essere rappresentato dal client.
• Identificare. Il processo del server può ottenere l'identità client. Il server può rappresentare l'identità client a scopo di autorizzazione, ma non può accedere agli oggetti di sistema come client.
• Rappresentazione. Questo è il valore predefinito. L'identità client può essere rappresentata, ma solo quando viene stabilita la connessione e non in ogni chiamata.
• Delegato. Il processo del server può rappresentare il contesto di sicurezza client mentre agisce per conto del client. Il processo del server può anche effettuare chiamate in uscita ad altri server mentre agisce per conto del client.

Sicurezza integrata

L'identità di Windows del chiamante viene utilizzata per connettersi ad Analysis Services. I valori validi sono SSPI, blank, Basic e ClaimsToken*.

SSPI è il valore predefinito per le connessioni TCP, consentendo l'autenticazione NTLM, Kerberos o Anonima. Per Azure AS e Power BI Premium, SSPI indica la traduzione di AD. Quando si usa SSPI, la proprietà ProtectionLevel deve essere impostata su Connect, Pkt Integrity o Pkt Privacy.

blank è il valore predefinito per le connessioni HTTP.

*ClaimsToken è supportato per Azure AS e Power BI Premium.

Rendere persistenti le informazioni di sicurezza

I valori validi sono True o False. Se impostato su True, le informazioni di sicurezza, ad esempio l'identità utente o la password specificate in precedenza nella stringa di connessione, possono essere ottenute dalla connessione dopo che è stata stabilita la connessione. Il valore predefinito è False.

Livello di protezione

Determina il livello di sicurezza utilizzato per la connessione. I valori supportati dipendono dal trasporto sottostante. I valori validi sono:

• Nessuna. Connessioni anonime o non autenticate. Non esegue alcuna autenticazione sui dati inviati al server.
• Connect. Connessioni autenticate. Autentica solo quando il client stabilisce una relazione con un server.
• Integrità Pkt. Connessioni crittografate. Verifica che tutti i dati vengano ricevuti dal client e che non siano stati modificati in transito.
• Pkt Privacy. Crittografia firmata, supportata solo per TCP. Verifica che tutti i dati vengano ricevuti dal client, che non siano stati modificati in transito e proteggono la privacy dei dati crittografandoli.

Per altre informazioni, vedere Stabilire connessioni sicure in ADOMD.NET

Ruoli

Specificare un elenco delimitato da virgole di ruoli predefiniti per connettersi a un server o a un database usando le autorizzazioni trasmesse da tale ruolo. Se questa proprietà viene omessa, vengono usati tutti i ruoli e le autorizzazioni valide sono la combinazione di tutti i ruoli. L'impostazione della proprietà su un valore vuoto, ad esempio, Roles=' ' indica che la connessione client non ha alcuna appartenenza al ruolo.

Un amministratore che usa questa proprietà si connette usando le autorizzazioni trasmesse dal ruolo. Alcuni comandi potrebbero non riuscire se il ruolo non fornisce autorizzazioni sufficienti.

Se si specificano ruoli durante la connessione a un'area di lavoro di Power BI Premium, usare i ruoli dell'area di lavoro dal modello di sicurezza di Power BI.

SSPI

Specifica in modo esplicito il pacchetto di sicurezza da usare per l'autenticazione client quando la sicurezza integrata è impostata su SSPI. SSPI supporta più pacchetti, ma è possibile usare questa proprietà per specificare un determinato pacchetto. I valori validi sono:

• Negoziare
• Kerberos
• NTLM
• Utente anonimo

Se questa proprietà non è impostata, tutti i pacchetti saranno disponibili per la connessione.

Usare la crittografia per i dati

Crittografa le trasmissioni di dati. I valori validi sono True o False.

ID utente=...; Password=

Le proprietà ID utente e Password forniscono le credenziali appropriate al server quando l'utente attivo corrente nell'applicazione client non può essere propagato automaticamente al server. Il comportamento dipende dal protocollo di trasporto e dal server a cui è connesso:

• Quando ci si connette tramite TCP a SSAS, la libreria client rappresenta l'utente di Windows usando il nome utente e la password specificati e quindi si connette come di consueto al server.

• Quando ci si connette tramite HTTP(S) a SSAS, le credenziali vengono fornite al server Web in base alla modalità di autenticazione configurata nel server Web, ad esempio autenticazione di base o autenticazione di Windows. Il server Web eseguirà la rappresentazione di Windows appropriata prima di connettersi al server SSAS, fornendo quindi il flusso di credenziali corretto al server.

• Quando ci si connette ad Azure AS o Power BI Premium, vengono usati l'ID utente e la password per ottenere un token Microsoft Entra che viene quindi presentato al servizio durante l'autenticazione. Microsoft Entra ID può anche richiedere l'autenticazione a più fattori (MFA), che può richiedere un'interazione utente aggiuntiva prima che il token possa essere generato.

• Se è già stato acquistato un token di accesso di connessione id Microsoft Entra valido dalla propria applicazione, è possibile impostare la proprietà AccessToken dell'oggetto AdomdConnection prima di stabilire la connessione. Nella proprietà AccessToken dell'oggetto di connettività pertinente (AdomdConnection, Server e così via), assicurarsi di impostare il token di accesso e specificarne l'ora di scadenza. L'autenticazione è supportata per i token di connessione acquisiti in modo interattivo per un utente e tramite il flusso on-Behalf-Of OAuth 2.0 ( ad esempio, un'applicazione Web di livello intermedio che si connette ad Analysis Services per conto dell'utente). Omettere il tipo di token quando si passa il token di accesso nella proprietà AccessToken . Le librerie client di Analysis Services aggiungono automaticamente il valore dello schema di autenticazione "Bearer" al token di accesso. Tenere presente quanto segue:

  • I token di accesso al bearer Di Microsoft Entra hanno una durata limitata. Per impostazione predefinita, tra 60 e 90 minuti. Se l'applicazione esegue operazioni con esecuzione prolungata che superano la durata del token di accesso, è possibile fornire una funzione di callback tramite la proprietà OnAccessTokenExpired dell'oggetto AdomdConnection per aggiornare il token di accesso quando il token di accesso corrente sta per scadere. In alternativa, è possibile aggiornare la proprietà AccessToken direttamente senza l'aiuto di una funzione di callback. L'uso di una funzione di callback è consigliato per garantire che il token di accesso venga aggiornato entro la durata del token di accesso corrente.
  • L'uso della proprietà Della stringa di connessione Password per passare un token di accesso è sconsigliato. È comunque possibile omettere la proprietà USER ID nella stringa di connessione e specificare solo il token di accesso nella proprietà Password , ma in questi casi il token di accesso non può essere aggiornato. Utilizzare invece la proprietà AccessToken in modo da poter fornire un nuovo token di accesso per una connessione esistente quando necessario. L'impostazione della proprietà Password e della proprietà AccessToken non è supportata.

Nota: "ID utente" ha uno spazio incorporato. Un alias alternativo per ID utente è UID e un alias alternativo per Password è PWD.

Proprietà per scopi speciali

Queste proprietà vengono usate per garantire comportamenti di connessione specifici richiesti da un'applicazione. Le proprietà sono elencate in ordine alfabetico.

Nome dell'applicazione

Imposta il nome dell'applicazione associata alla connessione. Questo valore può essere utile durante il monitoraggio degli eventi di traccia, in particolare quando sono presenti diverse applicazioni che accedono agli stessi database. Ad esempio, l'aggiunta di Application Name='test' a una stringa di connessione fa sì che 'test' venga visualizzato in una traccia di SQL Server Profiler. Gli alias per questa proprietà includono SspropInitAppName, AppName. Per altre informazioni, vedere Nome applicazione per connessioni SQL Server.

CommitTimeout

Proprietà XMLA. Determina per quanto tempo, in millisecondi, la fase di commit di un comando attualmente in esecuzione attende prima del rollback. Se maggiore di 0, esegue l'override del valore della proprietà CommitTimeout corrispondente nella configurazione del server.

Timeout connessione

Determina la quantità massima di tempo (in secondi) che il client tenta una connessione prima del timeout. Se una connessione non riesce entro questo periodo, il client si chiude tentando di connettersi e genera un errore.

DbpropMsmdRequestMemoryLimit

Esegue l'override del valore della proprietà del server Memory\QueryMemoryLimit per una connessione.

Specificato in kilobyte, questa proprietà può ridurre la quantità di memoria usata durante una query dalla memoria massima consentita (specificata come percentuale) in QueryMemoryLimit. Non può aumentare la quantità di memoria usata oltre la memoria massima consentita specificata in QueryMemoryLimit.

Compatibilità MDX

Lo scopo di questa proprietà è garantire un set coerente di comportamenti MDX per le applicazioni che eseguono query MDX. Excel, che utilizza query MDX per popolare e calcolare una tabella pivot connessa ad Analysis Services, imposta questa proprietà su 1, per garantire che i membri segnaposto nelle gerarchie incomplete siano visibili in una tabella pivot. I valori validi includono 0, 1, 2.

0 e 1 espongono membri segnaposto; 2 non lo fa. Se è vuoto, si presuppone 0.

Modalità membro mancante MDX

Indica se i membri mancanti vengono ignorati nelle istruzioni MDX. I valori validi sono Default, Error e Ignore. Il valore predefinito usa un valore definito dal server. L'errore genera un errore quando un membro non esiste. Ignora specifica che i valori mancanti devono essere ignorati.

Ottimizzare la risposta

Maschera di bit che indica quali delle ottimizzazioni della risposta di query seguenti sono abilitate.

• 0x01 Usare NormalTupleSet (impostazione predefinita).
• 0x02 Usare quando i filtri dei dati sono vuoti.

Dimensioni pacchetto

Si applica solo alle connessioni TCP. Dimensioni del pacchetto di rete (in byte) comprese tra 512 e 32.767. Le dimensioni predefinite dei pacchetti di rete sono 4096.

Formato protocollo

Imposta il formato del codice XML utilizzato dal protocollo di comunicazione XMLA. I valori validi sono Default, XML o Binary. È possibile specificare il codice XML da inviare in un formato binario o come xml di testo. Il formato binario codifica gli elementi e gli attributi XML, rendendoli più piccoli. Inoltre, la compressione può essere abilitata anche per i messaggi per ridurre le dimensioni delle richieste e delle risposte usando l'opzione Compressione trasporto. Le richieste e le risposte possono usare formati di protocollo diversi a seconda del supporto del client e del server. Ad esempio, una libreria client potrebbe supportare solo il file binario per le risposte, ma non per le richieste oppure un server potrebbe aver disabilitato il file binario per le richieste in ingresso.

Il provider OLE DB può formattare le richieste e le risposte in formato binario o compresso. AMO e ADOMD.NET formattare le richieste come Testo, ma accettare risposte in formato binario o compresso.

Questa proprietà della stringa di connessione equivale alle impostazioni di configurazione del server EnableBinaryXML e EnableCompression .

Interruzione temporanea

Specifica per quanto tempo (in secondi) la libreria client attende il completamento di un comando prima di generare un errore.

Vedere anche

Classi fondamentali di AMO - Oggetti server
Classe AdomdConnection - Proprietà