Proprietà delle stringhe di connessione

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

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

Usare il selettore Versione sopra il sommario a sinistra per visualizzare solo le proprietà che si applicano a una determinata piattaforma o versione.

Proprietà di connessione

origine dati

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

Provider

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

Questa proprietà è facoltativa per ADOMD.NET e AMO. È consentito per praticità durante la copia di un stringa di connessione MSOLAP da usare con ADOMD.NET e AMO.

Cubo

Nome del cubo o della prospettiva. Un database può contenere più cubi e prospettive. Se 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 domain\user. Per Azure AS e Power BI Premium, specificare in formato UPN. Per usare 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 usando la funzione MDX CustomData() o CUSTOMDATA(). Usato più comunemente per passare un userID o un nome utente come valore e quindi specificare tale valore nella definizione di un'espressione di sicurezza.

Impersonation Level

Indica il livello di rappresentazione che il server è autorizzato a usare per rappresentare il client. I valori validi includono:

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

Sicurezza integrata

Per la connessione ad Analysis Services viene usata l'identità di Windows del chiamante. 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 ACTIVE Directory. 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.

Persist Security Info

I valori validi sono True o False. Se impostata su True, le informazioni di sicurezza quali l'identità dell'utente o la password precedentemente specificate nella stringa di connessione possono essere ottenute dalla connessione dopo che quest'ultima è stata stabilita. Il valore predefinito è False.

Livello di protezione

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

• Nessuno. Connessioni non autenticate o anonime. Non viene eseguita alcuna autenticazione per i dati inviati al server.
• Connetti. Connessioni autenticate. L'autenticazione viene eseguita solo quando il client stabilisce una relazione con un server.
• Pkt Integrity. 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 proteggano la privacy dei dati crittografandoli.

Per altre informazioni, vedere Definizione di Connections sicure in ADOMD.NET

Ruoli

Specificare un elenco con valori delimitati da virgole dei ruoli predefiniti per la connessione a un server o a un database mediante le autorizzazioni trasmesse dal ruolo in questione. Se questa proprietà viene omessa, vengono usati tutti i ruoli e le autorizzazioni valide derivano da una 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 usano questa proprietà si connette con 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 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 Integrated Security è impostato su SSPI. SSPI supporta più pacchetti, tuttavia è possibile usare questa proprietà per specificare un pacchetto particolare. I valori validi sono:

• Negotiate
• Kerberos
• NTLM
• Utente anonimo

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

Use Encryption for Data

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 si è connessi:

• 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 l'autenticazione di base o l'autenticazione di Windows. Il server Web eseguirà la rappresentazione di Windows appropriata prima di connettersi al server SSAS, fornendo quindi il flusso delle credenziali corretto al server.

• Quando ci si connette ad Azure AS o Power BI Premium, l'ID utente e la password vengono usati per ottenere un token di 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 aggiuntiva dell'utente prima che il token possa essere generato.

• Se è già stato acquisito un token di accesso Microsoft Entra ID bearer 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 di 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:

  • Microsoft Entra token di accesso di connessione 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. È consigliabile usare una funzione di callback per assicurarsi che il token di accesso venga aggiornato entro la durata del token di accesso corrente.
  • Non è consigliabile usare la proprietà Password stringa di connessione per passare un token di accesso. È comunque possibile omettere la proprietà USER ID nel 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 token di accesso aggiornato 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 per il monitoraggio degli eventi di traccia, in particolar modo se più applicazioni accedono agli stessi database. Ad esempio, l'aggiunta di Application Name='test' a un stringa di connessione fa sì che 'test' venga visualizzato in una traccia SQL Server Profiler. Gli alias per questa proprietà includono SspropInitAppName, AppName. Per altre informazioni, vedere Nome applicazione per SQL Server Connections.

CommitTimeout

Proprietà XMLA. Determina il tempo di attesa in millisecondi da parte della fase di commit di un comando attualmente in esecuzione prima dell'esecuzione del rollback. Quando è maggiore di 0, sostituisce il valore della proprietà CommitTimeout corrispondente nella configurazione del server.

Timeout di 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 interrompe il tentativo di connessione 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.

MDX Compatibility

Lo scopo di questa proprietà consiste nell'assicurare un set coerente di comportamenti MDX per le applicazioni che eseguono query MDX. Tramite Excel, in cui si usano query MDX per popolare e calcolare una tabella pivot connessa ad Analysis Services, questa proprietà viene impostata su 1 per garantire che i membri segnaposto in gerarchie incomplete siano visibili nella tabella pivot. I valori validi includono 0,1 e 2.

Con 0 e 1 i membri segnaposto vengono esposti, con 2 no. Un valore vuoto equivale a 0.

Modalità membro mancante MDX

Indica se i membri mancanti vengono ignorati nelle istruzioni MDX. I valori validi sono Default, Error e Ignore. Per impostazione predefinita, viene usato un valore definito dal server. L'errore genera un errore quando un membro non esiste. Con Ignore i valori mancanti vengono ignorati.

Optimize Response

Maschera di bit indicante quali delle seguenti ottimizzazioni della risposta alle query sono abilitate.

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

Dimensione pacchetti

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

Protocol Format

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 formato binario o come XML di testo. Il formato binario codifica attributi ed elementi XML, riducendone le dimensioni. 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ò creare richieste e risposte in formato binario o compresso. AMO e ADOMD.NET creano le richieste in formato testo, ma accettano risposte in formato binario o compresso.

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

Timeout

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

Vedi anche

Classi fondamentali AMO - Oggetti server
Classe AdomdConnection - Proprietà