Proprietà delle stringhe di connessione

Articolo
04/13/2024

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.

I valori validi per Azure Analysis Services includono <protocol>://<region>/<servername> dove il protocollo è stringa asazure o link quando si usa un alias nome server, l'area è l'URI in cui è stato creato il server (ad esempio, westus.asazure.windows.net) e il nome del server è il nome del server univoco all'interno dell'area.

Esempio	Descrizione
`Data source=asazure://westus.asazure.windows.net/myasserver`	Azure Analysis Services.
`Data source=link://friendlyname.salesapp.azurewebsites.net/`	Azure Analysis Services usando l'alias del nome del server.

I valori validi per Power BI Premium includono <protocol>://api.powerbi.com/v1.0/[tenant name]/[workspace name] dove il protocollo è stringa powerbi, l'URI è api.powerbi.com, il nome del tenant dell'organizzazione o myorgil nome dell'area di lavoro è il nome di un'area di lavoro assegnata a una capacità dedicata.

Esempio	Descrizione
`Data source=powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace`	Power BI Premium'area di lavoro.

I valori validi per SQL Server Analysis Services includono il nome di rete o l'indirizzo IP del server, locale o localhost per le connessioni locali, un URL se il server è configurato per l'accesso HTTP o HTTPS o il nome di un file del cubo locale (con estensione cub).

Esempio	Descrizione
`Data source=AW-SRV01`	Istanza e porta predefinita di SSAS (TCP 2383).
`Data source=AW-SRV01\Finance`	Istanza denominata SSAS.
`Data source=AW-SRV01:8081`	Istanza predefinita di SSAS, porta specificata.
`Data source=AW-SRV01.corp.Adventure-Works.com`	Nome di dominio completo di SSAS, istanza predefinita e porta.
`Data source=172.16.254.1`	Indirizzo IP SSAS del server, ignorando la ricerca del server DNS. Utile per la risoluzione dei problemi di connessione.

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.

Esempio	Descrizione
`Provider=MSOLAP.7`	Connections che richiede SQL Server versione 2016 del provider OLE DB per Analysis Services.

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.

Esempio	Descrizione
`Cube=Sales`	Cubo denominato Sales.
`Cube=SalesPerspective`	Prospettiva denominata SalesPerspective.

Proprietà di autenticazione e sicurezza

Azure Analysis Services e Power BI Premium usare Microsoft Entra ID - Universal with MFA (consigliato), Microsoft Entra autenticazione con nome utente e password, token di accesso Microsoft Entra o autenticazione di Windows.

SQL Server Analysis Services usa solo autenticazione di Windows. L'autenticazione di base e l'autenticazione anonima possono essere usate se l'accesso HTTP è abilitato tramite MSMDPUMP.dll, come illustrato nell'articolo Configurare l'accesso HTTP a Analysis Services in IIS 8.0. Fare riferimento al passaggio 3: Configurare l'autenticazione IIS per informazioni dettagliate su come configurare i metodi di autenticazione supportati per Analysis Services su HTTP.

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.

Encrypt Password

Specifica se deve essere usata una password locale per crittografare cubi locali. I valori validi sono True o False. Il valore predefinito è False.

Encryption Password

Password usata per decrittografare un cubo locale crittografato. Il valore predefinito è vuoto. Questo valore deve essere impostato dall'utente in modo esplicito.

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.

Periodo di sincronizzazione automatica

Imposta la frequenza (in millisecondi) della sincronizzazione della cache di client e server. ADOMD.NET offre la memorizzazione nella cache del client per oggetti di utilizzo frequente con overhead di memoria minimo. Ciò consente di ridurre il numero di round trip al server. Il valore predefinito è 10.000 millisecondi (o 10 secondi). Se è impostata su null o 0, la sincronizzazione automatica è disabilitata.

Per motivi di prestazioni, le librerie client memorizzano nella cache alcune informazioni dal server, ad esempio determinati set di righe dello schema. Il periodo di sincronizzazione automatica consente a un utente di modificare il periodo di tempo dopo il quale la libreria client verifica con il server se le cache devono essere svuotate. In generale, non è necessario modificare il valore da predefinito.

Codifica dei caratteri

Definisce la modalità di codifica dei caratteri nella richiesta. I valori validi sono Default o UTF-8 (equivalenti) e UTF-16.

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.

CompareCaseSensitiveStringFlags

Controlla i confronti delle stringhe con distinzione tra maiuscole e minuscole per le impostazioni locali specificate.

Compression Level

Se TransportCompression è compresso, è possibile impostare il livello di compressione per controllare la quantità di compressione utilizzata. I valori validi sono compresi tra 0 e 9, con 0 con compressione minima e 9 con la compressione più elevata. Maggiore è la compressione, minori risulteranno le prestazioni. Il valore predefinito è 0.

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.

Modalità di visualizzazione MDX predefinita

Impostare questa proprietà per controllare la modalità di aggregazione dei membri quando si applica la sicurezza delle dimensioni.

Per i dati del cubo visualizzabili da chiunque l'aggregazione di tutti i membri è utile perché sono visibili tutti i valori che contribuiscono al totale. Se tuttavia si applicano filtri o restrizioni alle dimensioni in base all'identità dell'utente, la visualizzazione di un totale basato su tutti i membri (combinando sia valori consentiti che valori con restrizioni in un singolo totale) potrebbe causare confusione o mostrare più informazioni di quante ne dovrebbero essere rivelate.

Per specificare la modalità di aggregazione dei membri in caso di applicazione della sicurezza delle dimensioni, è possibile impostare questa proprietà su True in modo da usare solo in valori consentiti oppure su False per escludere dal totale i valori con restrizioni.

Se impostato nella stringa di connessione, questo valore si applica a livello di cubo o di prospettiva. In un modello è possibile controllare i totali visualizzati a un livello più granulare.

I valori validi sono:

0 è il valore predefinito. Attualmente, il comportamento predefinito corrisponde a 2, ovvero le aggregazioni includono valori che sono nascosti all'utente.
1 esclude i valori nascosti dal totale. Si tratta della configurazione predefinita per Excel.
2 include i valori nascosti nel totale. Si tratta del valore predefinito nel server.

L'alias per questa proprietà è VisualMode.

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 .

Real Time Olap

Impostare questa proprietà per ignorare la memorizzazione nella cache, causando la recupero dei dati da parte di tutte le query di archiviazione dal sistema di origine. Per impostazione predefinita, questa proprietà non è impostata.

Safety Options

Imposta il livello di sicurezza per le funzioni e le azioni definite dall'utente. I valori validi sono 0, 1, 2. In una connessione Excel questa proprietà è Safety Options=2. Dettagli su questa opzione sono disponibili in ConnectionString.

SQLQueryMode

Specifica se le query SQL includono calcoli. I valori validi sono Data, Calculated, IncludeEmpty. Data indica che non sono consentiti calcoli. Con il valore Calculated sono consentiti calcoli. IncludeEmpty consente la restituzione di calcoli e righe vuote nel risultato della query.

Timeout

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

Transport Compression

Definisce la modalità di compressione delle comunicazioni client e server. I valori validi sono Default, None, Compressed. Nessuno indica che non viene utilizzata alcuna compressione. Compresso usa la compressione XPRESS.

UseExistingFile

Usata per la connessione a un cubo locale. Questa proprietà specifica se il cubo locale viene sovrascritto. I valori validi sono True o False. Se è impostata su true, il file del cubo deve esistere. Il file esistente sarà la destinazione della connessione. Se impostata su False, il file del cubo viene sovrascritto.

Vedi anche

Classi fondamentali AMO - Oggetti server
Classe AdomdConnection - Proprietà

Share via