Vlastnosti připojovacího řetězce

platí pro: Analytické služby SQL Serveru Azure Analysis Services Fabric/Power BI Premium

Tento článek popisuje vlastnosti připojovacího řetězce používané klientskými aplikacemi, které se připojují ke službě Azure Analysis Services (Azure AS), Analytické služby SQL Serveru (SSAS) a sémantickým modelům Power BI Premium a dotazují se na ni. Tyto vlastnosti používají klientské knihovny služby Analysis Services, ADOMD.NET, AMO a zprostředkovatel OLE DB (MSOLAP) pro službu Analysis Services. Většinu vlastností připojovacího řetězce je možné použít se všemi třemi klientskými knihovnami. V popisu jsou vyvolány výjimky.

Pomocí selektoru verze nad obsahem vlevo zobrazíte pouze vlastnosti, které platí pro konkrétní platformu nebo verzi.

Vlastnosti připojení

Zdroj dat

Určuje instanci serveru. Tato vlastnost je vyžadována pro všechna připojení.

Platné hodnoty pro službu Analytické služby SQL Serveru zahrnují název sítě nebo IP adresu serveru, místního hostitele nebo místního hostitele pro místní připojení, adresu URL, pokud je server nakonfigurovaný pro přístup pomocí protokolu HTTP nebo HTTPS, nebo název souboru místní datové krychle (.cub).

Example	Description
Data source=AW-SRV01	Výchozí instance a port služby SSAS (TCP 2383).
Data source=AW-SRV01\Finance	Pojmenovaná instance služby SSAS
Data source=AW-SRV01:8081	Výchozí instance služby SSAS, zadaný port.
Data source=AW-SRV01.corp.Adventure-Works.com	Plně kvalifikovaný název domény služby SSAS, výchozí instance a port
Data source=172.16.254.1	IP adresa serveru SSAS, která obchází vyhledávání serveru DNS. Užitečné při řešení potíží s připojením.

Provider

Tato vlastnost je vyžadována v připojovacím řetězci při použití zprostředkovatele OLE DB, jako je MSOLAP. Umožňuje použít buď nezávislého zprostředkovatele verze (obvykle nejnovější), například "Provider=MSOLAP", nebo můžete také zadat závislého zprostředkovatele verze, například "Provider=MSOLAP.7". Platné hodnoty závislé na verzi se řídí vzorem MSOLAP.<verze>, kde <je verze> 7 nebo 8. Například MSOLAP.7 vydané v SQL Serveru 2016. Verze ".8" je nejnovější a považuje se za "evergreen". Očekává se, že se bude aktualizovat pomocí zpětné kompatibility. Starší čísla verzí jsou také možná, ale tyto verze MSOLAP jsou nyní mimo standardní podporu.

Tato vlastnost je volitelná pro ADOMD.NET a AMO. Při kopírování připojovacího řetězce MSOLAP, který se použije s ADOMD.NET a AMO, je povolený pro usnadnění.

Example	Description
Provider=MSOLAP.7	Připojení vyžadující SQL Server 2016 verze zprostředkovatele OLE DB pro Analysis Services

Krychle

Název datové krychle nebo název perspektivy Databáze může obsahovat více datových krychlí a perspektiv. Pokud je možné použít více cílů, zahrňte do připojovacího řetězce název datové krychle nebo perspektivy.

Example	Description
Cube=Sales	Datová krychle s názvem Sales.
Cube=SalesPerspective	Perspektiva s názvem SalesPerspective.

Vlastnosti ověřování a zabezpečení

SLUŽBA Analytické služby SQL Serveru používá pouze ověřování systému Windows. Základní ověřování a anonymní ověřování lze použít, pokud je přístup HTTP povolený prostřednictvím MSMDPUMP.dll, jak je vysvětleno v článku Konfigurace přístupu HTTP ke službě Analysis Services ve službě IIS 8.0. Projděte si krok 3: Konfigurace ověřování IIS , kde najdete podrobnosti o konfiguraci podporovaných metod ověřování pro Analysis Services přes PROTOKOL HTTP.

Vlastnosti jsou uvedeny v abecedním pořadí.

EffectiveUserName

Používá se, když se na serveru musí zosobnět identita uživatele. Pro službu SSAS zadejte ve formátu domény\uživatele. Pro Azure AS a Power BI Premium zadejte ve formátu hlavního názvu uživatele (UPN). Chcete-li použít tuto vlastnost, volající musí mít oprávnění správce ve službě Analysis Services. V Power BI Premium musí být volající správcem pracovního prostoru, ve kterém se nachází sémantický model.

CustomData

Řetězcová hodnota, která se má předat modulu v připojovacím řetězci a pak ji načíst pomocí funkce CUSTOMData() MDX nebo CUSTOMDATA() DAX. Nejčastěji se používá k předání ID uživatele nebo uživatelského jména jako hodnoty a pak ji zadejte v definici výrazu zabezpečení.

Šifrování hesla

Určuje, jestli se má k šifrování místních datových krychlí použít místní heslo. Platné hodnoty jsou True nebo False. Výchozí hodnota je False.

Šifrovací heslo

Heslo použité k dešifrování šifrované místní datové krychle. Výchozí hodnota je prázdná. Tuto hodnotu musí uživatel explicitně nastavit.

Úroveň zosobnění

Označuje úroveň zosobnění, kterou může server používat při zosobnění klienta. Mezi platné hodnoty patří:

• Anonymní. Klient je pro server anonymní. Proces serveru nemůže získat informace o klientovi ani nemůže být zosobněný.
• Identifikovat. Proces serveru může získat identitu klienta. Server může zosobnit identitu klienta pro účely autorizace, ale nemůže přistupovat k systémovým objektům jako klient.
• Zosobnit. Toto je výchozí hodnota. Identita klienta může být zosobněná, ale pouze při navázání připojení, a ne při každém volání.
• Delegát. Proces serveru může zosobnit kontext zabezpečení klienta při jednání jménem klienta. Proces serveru může také provádět odchozí volání na jiné servery při jednání jménem klienta.

Integrované zabezpečení

Identita volajícího systému Windows se používá k připojení ke službě Analysis Services. Platné hodnoty jsou SSPI, blank, Basic a ClaimsToken*.

SSPI je výchozí hodnota pro připojení TCP, která povoluje ověřování NTLM, Kerberos nebo Anonymní ověřování. U Azure AS a Power BI Premium indikuje SSPI překlad AD. Při použití SSPI musí být vlastnost ProtectionLevel nastavena na Connect, Pkt Integrity nebo Pkt Privacy.

Prázdné je výchozí hodnota pro připojení HTTP.

*ClaimsToken je podporovaný pro Azure AS a Power BI Premium.

Interaktivní přihlášení, režim identit

V připojeníCH HTTP ke cloudovým analytickým službám je ověřování ve výchozím nastavení založeno na tichém toku jednotného přihlašování, který bude používat identitu aktuálního uživatele přihlášeného k relaci Windows. Vlastnosti uvedené níže je možné použít k zajištění další kontroly uživatelů a aplikací při procesu ověřování.

Některé pokročilé aspekty připojení je možné řídit nastavením konfigurace klienta.

Interaktivní přihlášení

Vlastnost Interactive Login lze použít k řízení využití interaktivního ověřovacího toku; možné hodnoty:

• Výchozí. Aplikace určuje tok ověřování. Jednotné přihlašování je obvykle povolené s náhradním ověřováním, které je interaktivní, pokud se tiché ověřování nezdaří. Výchozí chování je také ovlivněno jinými vlastnostmi připojovacího řetězce, například Integrated Security=SSPI vynutí tiché ověřování.

• Povoleno. Interaktivní přihlášení je povolené, ale pouze jako záložní způsob selhání v tichém toku jednotného přihlašování.

• Zakázáno. Interaktivní přihlášení je zakázané – pokud se bezobslužné ověřování nezdaří, pokus o připojení selže.

• Vždycky. Tiché ověřování je zakázáno a použije se interaktivní přihlášení.

Režim identity

Vlastnost Režim identity lze použít k řízení toho, co bude identita, která se použije, když připojovací řetězec explicitně nedefinuje pomocí vlastnosti Id uživatele. Možné hodnoty:

• Výchozí. Režim identity je určen jinými vlastnostmi připojovacího řetězce a konfigurací systému.

• CurrentUser. Použijte aktuálního uživatele přihlášeného k relaci Windows.

• Připojení. Identita se určuje na základě zdroje dat, který je cílem připojení. Při prvním otevření připojení ke konkrétnímu zdroji dat může uživatel interaktivně vybrat identitu a tato identita se použije pro jakékoli následné připojení ke stejnému zdroji dat po celou dobu života procesu aplikace.

• Proces. První pokus o připojení je interaktivní a následné pokusy používají identitu použitou u prvního připojení.

Zachování bezpečnostních údajů

Platné hodnoty jsou True nebo False. Pokud je nastavena hodnota True, informace o zabezpečení, jako je identita uživatele nebo heslo dříve zadané v připojovacím řetězci, lze po vytvoření připojení získat z připojení. Výchozí hodnota je False.

Úroveň ochrany

Určuje úroveň zabezpečení použitou u připojení. Podporované hodnoty závisí na podkladovém přenosu. Platné hodnoty jsou:

• Žádné. Neověřené nebo anonymní připojení. Neprovádí žádné ověřování dat odesílaných na server.
• Connect. Ověřená připojení. Ověřuje se pouze v případech, kdy klient vytvoří relaci se serverem.
• Integrita pkt. Šifrovaná připojení. Ověřuje, že se všechna data přijímají z klienta a že se při přenosu nezměnila.
• Ochrana osobních údajů pkt. Podepsané šifrování, podporované pouze pro protokol TCP. Ověřuje, že se všechna data přijímají od klienta, že se při přenosu nezměnila, a chrání ochranu osobních údajů dat tím, že je zašifruje.

Další informace najdete v tématu Vytvoření zabezpečených připojení v ADOMD.NET

Seznam rolí

Zadejte čárkami oddělený seznam předdefinovaných rolí pro připojení k serveru nebo databázi pomocí oprávnění předávaných danou rolí. Pokud tuto vlastnost vynecháte, použijí se všechny role a efektivní oprávnění jsou kombinací všech rolí. Nastavení vlastnosti na prázdnou hodnotu, například znamená, Roles=' ' že připojení klienta nemá členství v roli.

Správce používající tuto vlastnost se připojí pomocí oprávnění předávaných rolí. Některé příkazy můžou selhat, pokud role neposkytuje dostatečná oprávnění.

Pokud při připojování k pracovnímu prostoru Power BI Premium zadáte role pracovního prostoru, použijte role pracovního prostoru z modelu zabezpečení Power BI.

SSPI

Explicitně určuje, který balíček zabezpečení se má použít pro ověřování klientů, když je integrované zabezpečení nastavené na SSPI. SSPI podporuje více balíčků, ale tuto vlastnost můžete použít k určení konkrétního balíčku. Platné hodnoty jsou:

• Jednat
• Kerberos
• NTLM
• Anonymní uživatel

Pokud tato vlastnost není nastavená, budou pro připojení k dispozici všechny balíčky.

Použití šifrování pro data

Šifruje přenosy dat. Platné hodnoty jsou True nebo False.

ID uživatele=...; Heslo=

Vlastnosti ID uživatele a hesla poskytují serveru příslušné přihlašovací údaje, pokud aktuální aktivní uživatel v klientské aplikaci nelze automaticky rozšířit na server. Toto chování závisí na přenosovém protokolu a serveru, ke kterému je připojený:

• Při připojování přes protokol TCP k SSAS zosobní klientská knihovna uživatele systému Windows pomocí zadaného uživatelského jména a hesla a pak se připojí jako obvykle k serveru.

• Při připojování přes protokol HTTP(S) k SSAS se přihlašovací údaje poskytují webovému serveru na základě režimu ověřování nakonfigurovaného na webovém serveru, například základního ověřování nebo ověřování systému Windows. Webový server provede před připojením k serveru SSAS odpovídající zosobnění Windows, a proto poskytne správný tok přihlašovacích údajů na server.

• Při připojování k Azure AS nebo Power BI Premium se ID uživatele a heslo použijí k získání tokenu Microsoft Entra, který se pak službě zobrazí během ověřování. Microsoft Entra ID může také vyžadovat vícefaktorové ověřování (MFA), které může vyžadovat další interakci uživatele před vygenerování tokenu.

• Pokud jste již získali platný přístupový token nosného id Microsoft Entra z vlastní aplikace, můžete nastavit Vlastnost AccessToken objektu AdomdConnection před navázáním připojení. Ve vlastnosti AccessToken příslušného objektu připojení (AdomdConnection, Server atd.) se ujistěte, že jste nastavili přístupový token a zadali jeho čas vypršení platnosti. Ověřování se podporuje pro nosné tokeny získané interaktivně pro uživatele a použití on -Behalf-Of toku OAuth 2.0 (například webová aplikace střední vrstvy, která se připojuje ke službě Analysis Services jménem uživatele). Při předávání přístupového tokenu ve vlastnosti AccessToken vynecháte typ tokenu. Klientské knihovny služby Analysis Services automaticky přidají do přístupového tokenu hodnotu nosné hodnoty schématu ověřování. Nezapomeňte mít na paměti následující skutečnosti:

  • Nosné přístupové tokeny Microsoft Entra mají omezenou životnost. Ve výchozím nastavení je to 60 až 90 minut. Pokud vaše aplikace provádí dlouhotrvající operace, které překračují dobu životnosti přístupového tokenu, můžete prostřednictvím vlastnosti OnAccessTokenExpired objektu AdomdConnection aktualizovat přístupový token, když aktuální přístupový token brzy vyprší. Alternativně můžete aktualizovat vlastnost AccessToken přímo bez pomoci funkce zpětného volání. Použití funkce zpětného volání se doporučuje zajistit, aby se přístupový token aktualizoval během doby životnosti aktuálního přístupového tokenu.
  • Použití vlastnosti připojovacího řetězce hesla k předání přístupového tokenu se nedoporučuje. Vlastnost ID uživatele můžete v připojovacím řetězci vynechat a zadat pouze přístupový token ve vlastnosti Heslo , ale v takových případech se přístupový token nedá aktualizovat. Místo toho použijte vlastnost AccessToken , abyste v případě potřeby mohli poskytnout nový přístupový token pro existující připojení. Nastavení vlastnosti Password i AccessToken není podporováno.

Poznámka: ID uživatele má vložený prostor. Alternativní alias pro ID uživatele je UID a alternativní alias pro Heslo je PWD.

Vlastnosti speciálního účelu

Tyto vlastnosti slouží k zajištění konkrétního chování připojení vyžadovaného aplikací. Vlastnosti jsou uvedeny v abecedním pořadí.

Název aplikace

Nastaví název aplikace přidružené k připojení. Tato hodnota může být užitečná při monitorování událostí trasování, zejména pokud máte několik aplikací, které přistupují ke stejným databázím. Například přidání názvu aplikace ='test' do připojovacího řetězce způsobí, že se v trasování sql Serveru Profiler zobrazí test. Aliasy pro tuto vlastnost zahrnují SspropInitAppName, AppName. Další informace najdete v tématu Název aplikace pro připojení k SQL Serveru.

Období automatické synchronizace

Nastaví frekvenci synchronizace mezipaměti klienta a serveru (v milisekundách). ADOMD.NET poskytuje ukládání klientů do mezipaměti pro často používané objekty, které mají minimální režii na paměť. To pomáhá snížit počet odezvy na server. Výchozí hodnota je 10 000 milisekund (nebo 10 sekund). Pokud je nastavená hodnota null nebo 0, je automatická synchronizace vypnutá.

Z důvodů výkonu klientské knihovny ukládají určité informace ze serveru do mezipaměti, například určité sady řádků schématu. Automatické období synchronizace umožňuje uživateli změnit časové období, po kterém klientská knihovna kontroluje se serverem, zda je potřeba vyprázdnit mezipaměti. Obecně byste neměli měnit hodnotu z výchozí hodnoty.

Kódování znaků

Definuje, jak jsou znaky kódovány v požadavku. Platné hodnoty jsou Výchozí nebo UTF-8 (jsou ekvivalentní) a UTF-16.

CommitTimeout

Vlastnost XMLA. Určuje, jak dlouho v milisekundách čeká fáze potvrzení aktuálně spuštěného příkazu před vrácením zpět. Pokud je hodnota větší než 0, přepíše hodnotu odpovídající vlastnosti CommitTimeout v konfiguraci serveru.

CompareCaseSensitiveStringFlags

Upraví porovnání řetězců s rozlišováním malých a velkých písmen pro zadané národní prostředí.

Úroveň komprese

Pokud je komprimace TransportCompression , můžete nastavit úroveň komprese, která určuje, kolik komprese se používá. Platné hodnoty jsou 0 až 9, přičemž 0 má nejmenší kompresi a 9 má největší kompresi. Zvýšení komprese zpomaluje výkon. Výchozí hodnota je 0.

Časový limit připojení

Určuje maximální dobu (v sekundách), po kterou se klient pokusí o připojení před vypršením časového limitu. Pokud se připojení během tohoto období nepodaří, klient se pokusí připojit a vygeneruje chybu.

DbpropMsmdRequestMemoryLimit

Přepíše hodnotu vlastnosti memory\QueryMemoryLimit serveru pro připojení.

Tato vlastnost zadaná v kilobajtech může snížit množství paměti použité během dotazu z maximální povolené paměti (zadané v procentech) v QueryMemoryLimit. Nemůže zvýšit množství paměti využité nad maximální povolenou paměť zadanou v QueryMemoryLimit.

Výchozí vizuální režim MDX

Nastavte tuto vlastnost tak, aby bylo možné řídit, jak se členové agregují při použití zabezpečení dimenze.

U dat datové krychle, která můžou všichni vidět, dává agregace všech členů smysl, protože jsou viditelné všechny hodnoty, které přispívají k součtu. Pokud ale filtrujete nebo omezujete dimenze na základě identity uživatele, může být zobrazení součtu na základě všech členů (kombinování omezených i povolených hodnot do jednoho součtu) matoucí nebo zobrazovat více informací, než by mělo být odhaleno.

Chcete-li určit, jak se členové agregují při použití zabezpečení dimenze, můžete tuto vlastnost nastavit na Hodnotu True tak, aby používala pouze povolené hodnoty v agregaci nebo Nepravda, pokud chcete vyloučit omezené hodnoty z celkového součtu.

Při nastavení připojovacího řetězce se tato hodnota vztahuje na úroveň datové krychle nebo perspektivy. V rámci modelu můžete řídit vizuální součty na podrobnější úrovni.

Platné hodnoty jsou:

• 0 je výchozí hodnota. V současné době je výchozí chování ekvivalentní 2, kde agregace obsahují hodnoty, které jsou uživateli skryté.
• 1 vyloučí skryté hodnoty z celkového součtu. Toto je výchozí hodnota pro Excel.
• 2 obsahuje skryté hodnoty v součtu. Toto je výchozí hodnota na serveru.

Alias pro tuto vlastnost je VisualMode.

Kompatibilita MDX

Účelem této vlastnosti je zajistit konzistentní sadu chování MDX pro aplikace, které vydávají dotazy MDX. Excel, který používá dotazy MDX k naplnění a výpočtu kontingenční tabulky připojené ke službě Analysis Services, nastaví tuto vlastnost na hodnotu 1, aby se zajistilo, že zástupné členy v nepravidelných hierarchiích jsou viditelné v kontingenční tabulce. Platné hodnoty zahrnují 0, 1, 2.

0 a 1 zveřejňuje zástupné členy; 2 ne. Pokud je tato hodnota prázdná, předpokládá se hodnota 0.

Chybějící režim člena MDX

Označuje, zda chybějící členy jsou ignorovány v příkazech MDX. Platné hodnoty jsou Default (Výchozí), Error (Chyba) a Ignore ( Ignorovat). Výchozí hodnota používá hodnotu definovanou serverem. Chyba vygeneruje chybu, pokud člen neexistuje. Přeskočení určuje, že chybějící hodnoty by se měly ignorovat.

Optimalizace odpovědi

Bitová maska označující, která z následujících optimalizací odpovědí na dotazy je povolená.

• 0x01 Použít NormalTupleSet (výchozí).
• 0x02 Použít, když jsou průřezy prázdné.

Velikost paketu

Platí jenom pro připojení TCP. Velikost síťového paketu (v bajtech) mezi 512 a 32 767. Výchozí velikost síťového paketu je 4096.

Formát protokolu

Nastaví formát XML používaného komunikačním protokolem XMLA. Platné hodnoty jsou Výchozí, XML nebo Binary. Xml můžete zadat v binárním formátu nebo jako textový XML. Binární formát kóduje elementy a atributy XML a zmenšuje je. Kromě toho lze u zpráv povolit kompresi, aby se snížila velikost požadavků a odpovědí pomocí možnosti Komprese přenosu. Požadavky a odpovědi můžou používat různé formáty protokolu v závislosti na tom, co klient a server podporuje. Klientská knihovna může například podporovat pouze binární soubory pro odpovědi, ale ne pro požadavky nebo server může pro příchozí požadavky zakázat binární soubor.

Zprostředkovatel OLE DB může formátovat požadavky a odpovědi v binárním nebo komprimovaném formátu. AMO a ADOMD.NET požadavky formátovat jako text, ale přijmout odpovědi v binárním nebo komprimovaném formátu.

Tato vlastnost připojovacího řetězce je ekvivalentní nastavení konfigurace serveru EnableBinaryXML a EnableCompression .

Olap v reálném čase

Nastavte tuto vlastnost tak, aby se vynechala ukládání do mezipaměti, což způsobí, že všechny dotazy na úložiště načítají data ze zdrojového systému. Ve výchozím nastavení není tato vlastnost nastavená.

Možnosti zabezpečení

Nastaví úroveň zabezpečení pro uživatelem definované funkce a akce. Platné hodnoty jsou 0, 1, 2. V připojení k Excelu je tato vlastnost Safety Options=2. Podrobnosti o této možnosti najdete v ConnectionStringtématu .

SQLQueryMode

Určuje, jestli dotazy SQL obsahují výpočty. Platné hodnoty jsou Data, Calculated, IncludeEmpty. Data znamenají, že nejsou povoleny žádné výpočty. Počítané umožňuje výpočty. IncludeEmpty umožňuje vrácení výpočtů a prázdných řádků ve výsledku dotazu.

Přerušení zápasu

Určuje, jak dlouho (v sekundách) klientská knihovna čeká na dokončení příkazu před vygenerováním chyby.

Komprese přenosu

Definuje, jak se komprimují komunikace klientů a serverů. Platné hodnoty jsou Výchozí, Žádné, Komprimované. Žádná indikuje, že se nepoužívá žádná komprese. Komprimované používá kompresi XPRESS.

UseExistingFile

Používá se při připojování k místní datové krychli. Tato vlastnost určuje, zda je místní datová krychle přepsána. Platné hodnoty jsou True nebo False. Pokud je nastavená hodnota True, soubor datové krychle musí existovat. Existující soubor bude cílem připojení. Pokud je nastavená hodnota False, soubor datové krychle se přepíše.

Viz také

Základní třídy AMO – Objekty serveru
AdomdConnection – vlastnosti