Właściwości parametrów połączenia

Dotyczy: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

W tym artykule opisano właściwości parametrów połączenia używane przez aplikacje klienckie łączące się z usługami Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS) i semantyczne modele usługi Power BI Premium. Te właściwości są używane przez biblioteki klienta usług Analysis Services, ADOMD.NET, AMO i OLE DB (MSOLAP) dla usług Analysis Services. Większość właściwości parametrów połączenia może być używana ze wszystkimi trzema bibliotekami klienta. Wyjątki są wywoływane w opisie.

Użyj selektora Wersji powyżej spisu treści po lewej stronie, aby wyświetlić tylko te właściwości, które mają zastosowanie do określonej platformy lub wersji.

Właściwości połączenia

Źródło danych

Określa wystąpienie serwera. Ta właściwość jest wymagana dla wszystkich połączeń.

Prawidłowe wartości usług SQL Server Analysis Services obejmują nazwę sieci lub adres IP serwera, lokalny lub localhost dla połączeń lokalnych, adres URL, jeśli serwer jest skonfigurowany pod kątem dostępu HTTP lub HTTPS, lub nazwę pliku modułu lokalnego (cub).

Example	Description
Data source=AW-SRV01	Domyślne wystąpienie i port usług SSAS (TCP 2383).
Data source=AW-SRV01\Finance	Wystąpienie nazwane usług SSAS.
Data source=AW-SRV01:8081	Domyślne wystąpienie usług SSAS, określonego portu.
Data source=AW-SRV01.corp.Adventure-Works.com	W pełni kwalifikowana nazwa domeny usług SSAS, wystąpienie domyślne i port.
Data source=172.16.254.1	Adres IP usługi SSAS serwera z pominięciem wyszukiwania serwera DNS. Przydatne do rozwiązywania problemów z połączeniem.

Provider

Ta właściwość jest wymagana w parametrach połączenia podczas korzystania z dostawcy OLE DB, takiego jak MSOLAP. Umożliwia korzystanie z niezależnego dostawcy wersji (zazwyczaj najnowszej), takiego jak "Provider=MSOLAP", lub można również określić dostawcę zależną od wersji, na przykład "Provider=MSOLAP.7". Prawidłowe wartości zależne od wersji są zgodne ze wzorcem MSOLAP.<wersja>, gdzie <wersja> to 7 lub 8. Na przykład MSOLAP.7 wydany w programie SQL Server 2016. Wersja ".8" jest najnowsza i uważana za "evergreen". Oczekuje się, że aktualizacja będzie aktualizowana z zachowaniem zgodności z poprzednimi wersjami. Możliwe są również wcześniejsze numery wersji, ale te wersje MSOLAP są obecnie poza standardową obsługą.

Ta właściwość jest opcjonalna dla ADOMD.NET i AMO. Jest to dozwolone dla wygody podczas kopiowania parametrów połączenia MSOLAP do użycia z ADOMD.NET i AMO.

Example	Description
Provider=MSOLAP.7	Połączenia wymagające programu SQL Server 2016 wersji dostawcy OLE DB dla usług Analysis Services.

Sześcian

Nazwa modułu lub nazwa perspektywy. Baza danych może zawierać wiele modułów i perspektyw. Jeśli jest możliwe wiele obiektów docelowych, dołącz nazwę modułu lub perspektywy dla parametrów połączenia.

Example	Description
Cube=Sales	Moduł o nazwie Sales(Sprzedaż).
Cube=SalesPerspective	Perspektywa o nazwie SalesPerspective.

Właściwości uwierzytelniania i zabezpieczeń

Usługi SQL Server Analysis Services używają tylko uwierzytelniania systemu Windows. Uwierzytelnianie podstawowe i uwierzytelnianie anonimowe można użyć, jeśli dostęp HTTP jest włączony za pośrednictwem MSMDPUMP.dll, jak wyjaśniono w artykule Konfigurowanie dostępu HTTP do usług Analysis Services w usługach IIS 8.0. Zobacz Krok 3. Konfigurowanie uwierzytelniania usług IIS , aby uzyskać szczegółowe informacje na temat konfigurowania obsługiwanych metod uwierzytelniania dla usług Analysis Services za pośrednictwem protokołu HTTP.

Właściwości są wymienione w kolejności alfabetycznej.

EffectiveUserName

Użyj polecenia , gdy tożsamość użytkownika musi być personifikowana na serwerze. W przypadku usług SSAS określ wartość w formacie domeny\użytkownika. W przypadku usług Azure AS i Power BI Premium określ format nazwy UPN. Aby użyć tej właściwości, obiekt wywołujący musi mieć uprawnienia administracyjne w usługach Analysis Services. W usłudze Power BI Premium obiekt wywołujący musi być administratorem obszaru roboczego, w którym znajduje się model semantyczny.

CustomData

Wartość parametrów, która ma zostać przekazana do aparatu w parametrach połączenia, a następnie pobrana przy użyciu funkcji MDX CustomData() lub funkcji JĘZYKA DAX CUSTOMDATA(). Najczęściej używane do przekazywania identyfikatora użytkownika lub nazwy użytkownika jako wartości, a następnie określenia tej wartości w definicji wyrażenia zabezpieczeń.

Szyfrowanie hasła

Określa, czy hasło lokalne ma być używane do szyfrowania modułów lokalnych. Prawidłowe wartości to True lub False. Wartość domyślna to False.

Hasło szyfrowania

Hasło używane do odszyfrowywania zaszyfrowanego modułu lokalnego. Wartość domyślna jest pusta. Ta wartość musi być jawnie ustawiona przez użytkownika.

Poziom personifikacji

Wskazuje poziom personifikacji, którego serwer może używać podczas personifikacji klienta. Prawidłowe wartości to:

• Anonimowe. Klient jest anonimowy dla serwera. Proces serwera nie może uzyskać informacji o kliencie ani nie może być personifikowany.
• Zidentyfikuj. Proces serwera może uzyskać tożsamość klienta. Serwer może personifikować tożsamość klienta do celów autoryzacji, ale nie może uzyskać dostępu do obiektów systemowych jako klienta.
• Personifikuj. Jest to wartość domyślna. Tożsamość klienta może być personifikowana, ale tylko wtedy, gdy połączenie zostanie nawiązane, a nie przy każdym wywołaniu.
• Delegowanie. Proces serwera może personifikować kontekst zabezpieczeń klienta podczas działania w imieniu klienta. Proces serwera może również wykonywać połączenia wychodzące z innymi serwerami podczas działania w imieniu klienta.

Zabezpieczenia zintegrowane

Tożsamość systemu Windows obiektu wywołującego służy do nawiązywania połączenia z usługami Analysis Services. Prawidłowe wartości to SSPI, blank, Basic i ClaimsToken*.

SSPI jest wartością domyślną dla połączeń TCP, co umożliwia uwierzytelnianie NTLM, Kerberos lub Anonimowe. W przypadku usług Azure AS i Power BI Premium interfejs SSPI wskazuje tłumaczenie usługi AD. W przypadku korzystania z interfejsu SSPI właściwość ProtectionLevel musi być ustawiona na wartość Connect, Pkt Integrity lub Pkt Privacy.

blank jest wartością domyślną dla połączeń HTTP.

*ClaimsToken jest obsługiwany w przypadku usług Azure AS i Power BI Premium.

Utrwalanie informacji zabezpieczających

Prawidłowe wartości to True lub False. Po ustawieniu wartości True informacje o zabezpieczeniach, takie jak tożsamość użytkownika lub hasło określone wcześniej w parametrach połączenia, można uzyskać z połączenia po nawiązaniu połączenia. Wartość domyślna to False.

Poziom ochrony

Określa poziom zabezpieczeń używany w połączeniu. Obsługiwane wartości zależą od transportu bazowego. Prawidłowe wartości to:

• Brak. Nieuwierzytelnione lub anonimowe połączenia. Nie przeprowadza uwierzytelniania na danych wysyłanych do serwera.
• Connect. Uwierzytelnione połączenia. Uwierzytelnia się tylko wtedy, gdy klient ustanawia relację z serwerem.
• Integralność pkt. Szyfrowane połączenia. Sprawdza, czy wszystkie dane są odbierane od klienta i czy nie zostały zmienione podczas przesyłania.
• Pkt Prywatność. Podpisane szyfrowanie, obsługiwane tylko dla protokołu TCP. Sprawdza, czy wszystkie dane są odbierane od klienta, czy nie zostały zmienione podczas przesyłania, i chronią prywatność danych, szyfrując je.

Aby dowiedzieć się więcej, zobacz Nawiązywanie bezpiecznych połączeń w ADOMD.NET

Role

Określ rozdzielaną przecinkami listę wstępnie zdefiniowanych ról w celu nawiązania połączenia z serwerem lub bazą danych przy użyciu uprawnień przekazanych przez tę rolę. Jeśli ta właściwość zostanie pominięta, zostaną użyte wszystkie role, a skuteczne uprawnienia są kombinacją wszystkich ról. Ustawienie właściwości na wartość pustą, na przykład oznacza, Roles=' ' że połączenie klienta nie ma członkostwa w roli.

Administrator korzystający z tej właściwości nawiązuje połączenie przy użyciu uprawnień przekazanych przez rolę. Niektóre polecenia mogą zakończyć się niepowodzeniem, jeśli rola nie zapewnia wystarczających uprawnień.

Jeśli określisz role podczas nawiązywania połączenia z obszarem roboczym usługi Power BI Premium, użyj ról obszaru roboczego z modelu zabezpieczeń usługi Power BI.

SSPI

Jawnie określa pakiet zabezpieczeń, który ma być używany do uwierzytelniania klienta, gdy zintegrowane zabezpieczenia są ustawione na SSPI. Interfejs SSPI obsługuje wiele pakietów, ale można użyć tej właściwości do określenia określonego pakietu. Prawidłowe wartości to:

• Negocjować
• Kerberos
• NTLM
• Użytkownik anonimowy

Jeśli ta właściwość nie jest ustawiona, wszystkie pakiety będą dostępne dla połączenia.

Używanie szyfrowania dla danych

Szyfruje transmisje danych. Prawidłowe wartości to True lub False.

Identyfikator użytkownika=...; Hasło =

Właściwości Identyfikator użytkownika i Hasło zapewniają odpowiednie poświadczenia do serwera, gdy bieżący aktywny użytkownik w aplikacji klienckiej nie może być automatycznie propagowany do serwera. Zachowanie zależy od protokołu transportowego i serwera połączonego z:

• Podczas nawiązywania połączenia za pośrednictwem protokołu TCP z usługami SSAS biblioteka kliencka personifikuje użytkownika systemu Windows przy użyciu określonej nazwy użytkownika i hasła, a następnie połączy się jak zwykle z serwerem.

• Podczas nawiązywania połączenia za pośrednictwem protokołu HTTP z usługą SSAS poświadczenia są udostępniane serwerowi sieci Web na podstawie trybu uwierzytelniania skonfigurowanego na serwerze internetowym, na przykład uwierzytelniania podstawowego lub uwierzytelniania systemu Windows. Serwer internetowy wykona odpowiednią personifikację systemu Windows przed nawiązaniem połączenia z serwerem usług SSAS, w związku z czym zapewni prawidłowy przepływ poświadczeń do serwera.

• Podczas nawiązywania połączenia z usługą Azure AS lub Power BI Premium identyfikator użytkownika i hasło są używane do uzyskiwania tokenu entra firmy Microsoft, który następnie jest prezentowany usłudze podczas uwierzytelniania. Identyfikator entra firmy Microsoft może również wymagać uwierzytelniania wieloskładnikowego (MFA), co może wymagać dodatkowej interakcji użytkownika przed wygenerowaniem tokenu.

• Jeśli masz już prawidłowy token dostępu elementu nośnego identyfikatora Entra firmy Microsoft z własnej aplikacji, możesz ustawić właściwość AccessToken obiektu AdomdConnection przed nawiązaniem połączenia. We właściwości AccessToken odpowiedniego obiektu łączności (AdomdConnection, Server itp.) upewnij się, że ustawiono token dostępu i określ jego czas wygaśnięcia. Uwierzytelnianie jest obsługiwane w przypadku tokenów elementu nośnego pozyskanych interaktywnie dla użytkownika oraz przy użyciu przepływuBehalf-Of protokołu OAuth 2.0 (na przykład aplikacji internetowej warstwy środkowej łączącej się z usługami Analysis Services w imieniu użytkownika). Pomiń typ tokenu podczas przekazywania tokenu dostępu we właściwości AccessToken . Biblioteki klienckie usług Analysis Services automatycznie dodają wartość schematu uwierzytelniania "Bearer" do tokenu dostępu. Pamiętaj, aby pamiętać o następujących kwestiach:

  • Tokeny dostępu elementu nośnego Entra firmy Microsoft mają ograniczony okres istnienia. Domyślnie od 60 do 90 minut. Jeśli aplikacja wykonuje długotrwałe operacje przekraczające okres istnienia tokenu dostępu, możesz udostępnić funkcję wywołania zwrotnego za pomocą właściwości OnAccessTokenExpired obiektu AdomdConnection w celu odświeżenia tokenu dostępu, gdy bieżący token dostępu wkrótce wygaśnie. Alternatywnie można zaktualizować właściwość AccessToken bezpośrednio bez pomocy funkcji wywołania zwrotnego. Zaleca się użycie funkcji wywołania zwrotnego, aby upewnić się, że token dostępu jest odświeżany w okresie istnienia bieżącego tokenu dostępu.
  • Nie zaleca się przekazywania tokenu dostępu za pomocą właściwości Parametry połączenia Hasło . Nadal można pominąć właściwość Identyfikator użytkownika w parametrach połączenia i określić tylko token dostępu we właściwości Password , ale w takich przypadkach nie można odświeżyć tokenu dostępu. Zamiast tego użyj właściwości AccessToken , aby w razie potrzeby udostępnić nowy token dostępu dla istniejącego połączenia. Ustawienie właściwości Password i właściwości AccessToken nie jest obsługiwane.

Uwaga: "Identyfikator użytkownika" ma osadzoną przestrzeń. Alternatywny alias identyfikatora użytkownika to UID , a alternatywny alias hasła to PWD.

Właściwości przeznaczenia specjalnego

Te właściwości są używane do zapewnienia określonych zachowań połączeń wymaganych przez aplikację. Właściwości są wymienione w kolejności alfabetycznej.

Nazwa aplikacji

Ustawia nazwę aplikacji skojarzonej z połączeniem. Ta wartość może być przydatna podczas monitorowania zdarzeń śledzenia, zwłaszcza gdy masz kilka aplikacji, które uzyskują dostęp do tych samych baz danych. Na przykład dodanie nazwy aplikacji="test" do parametrów połączenia powoduje wyświetlenie ciągu "test" w śladzie profilera programu SQL Server. Aliasy dla tej właściwości obejmują SspropInitAppName, AppName. Aby dowiedzieć się więcej, zobacz Nazwa aplikacji dla połączeń programu SQL Server.

Automatyczne synchronizowanie okresu

Ustawia częstotliwość (w milisekundach) synchronizacji klienta i pamięci podręcznej serwera. ADOMD.NET zapewnia buforowanie klientów dla często używanych obiektów, które mają minimalne obciążenie pamięci. Pomaga to zmniejszyć liczbę rund na serwer. Wartość domyślna to 10 000 milisekund (lub 10 sekund). W przypadku ustawienia wartości null lub 0 automatyczna synchronizacja jest wyłączona.

Ze względu na wydajność biblioteki klienckie buforuje niektóre informacje z serwera, na przykład niektóre zestawy wierszy schematu. Okres automatycznego synchronizowania umożliwia użytkownikowi zmianę okresu, po którym biblioteka klienta sprawdza z serwerem, czy pamięci podręczne muszą zostać opróżnione. Ogólnie rzecz biorąc, nie należy zmieniać wartości domyślnej.

Kodowanie znaków

Definiuje sposób kodowania znaków w żądaniu. Prawidłowe wartości to Default lub UTF-8 (są one równoważne) i UTF-16.

CommitTimeout

Właściwość XMLA. Określa, jak długo, w milisekundach, faza zatwierdzania aktualnie uruchomionego polecenia czeka przed wycofywaniem. Gdy wartość jest większa niż 0, zastępuje wartość odpowiedniej właściwości CommitTimeout w konfiguracji serwera.

CompareCaseSensitiveStringFlags

Dostosowuje porównania ciągów z uwzględnieniem wielkości liter dla określonych ustawień regionalnych.

Poziom kompresji

Jeśli kompresja TransportCompression jest kompresowana, można ustawić poziom kompresji, aby kontrolować ilość używanej kompresji. Prawidłowe wartości to od 0 do 9, a 0 ma najmniej kompresję, a 9 ma największą kompresję. Zwiększona kompresja spowalnia wydajność. Wartość domyślna to 0.

Limit czasu połączenia

Określa maksymalny czas (w sekundach), który klient próbuje nawiązać połączenie przed przekroczeniem limitu czasu. Jeśli połączenie nie powiedzie się w tym okresie, klient kończy próbę nawiązania połączenia i generuje błąd.

DbpropMsmdRequestMemoryLimit

Zastępuje wartość właściwości serwera Memory\QueryMemoryLimit dla połączenia.

Określona w kilobajtach ta właściwość może zmniejszyć ilość pamięci używanej podczas zapytania z maksymalnej dozwolonej pamięci (określonej jako wartość procentowa) w zapytaniu QueryMemoryLimit. Nie może zwiększyć ilości pamięci używanej poza maksymalną dozwoloną pamięcią określoną w zapytaniu QueryMemoryLimit.

Domyślny tryb wizualny MDX

Ustaw tę właściwość, aby kontrolować sposób agregowania elementów członkowskich podczas stosowania zabezpieczeń wymiarów.

W przypadku danych modułu, które wszyscy mogą zobaczyć, agregowanie wszystkich elementów członkowskich ma sens, ponieważ wszystkie wartości, które przyczyniają się do sumy, są widoczne. Jednak jeśli filtrujesz lub ograniczasz wymiary na podstawie tożsamości użytkownika, pokazując sumę opartą na wszystkich elementach członkowskich (łącząc wartości z ograniczeniami i dozwolonymi w jedną sumę) może być mylące lub pokazywane więcej informacji niż powinny zostać ujawnione.

Aby określić sposób agregowania elementów członkowskich podczas stosowania zabezpieczeń wymiarów, można ustawić tę właściwość na wartość True, aby używać tylko dozwolonych wartości w agregacji lub Fałsz, aby wykluczyć wartości z ograniczeniami z sumy.

Po ustawieniu parametrów połączenia ta wartość ma zastosowanie do modułu lub poziomu perspektywy. W modelu można kontrolować sumy wizualne na bardziej szczegółowym poziomie.

Prawidłowe wartości to,

• Wartość domyślna to 0 . Obecnie domyślne zachowanie jest równoważne 2, gdzie agregacje obejmują wartości ukryte przed użytkownikiem.
• 1 wyklucza ukryte wartości z sumy. Jest to wartość domyślna dla programu Excel.
• 2 zawiera wartości ukryte w sumie. Jest to wartość domyślna na serwerze.

Alias tej właściwości to VisualMode.

Zgodność z rozwiązaniem MDX

Celem tej właściwości jest zapewnienie spójnego zestawu zachowań MDX dla aplikacji, które wystawiają zapytania MDX. Program Excel, który używa zapytań MDX do wypełniania i obliczania tabeli przestawnej połączonej z usługami Analysis Services, ustawia tę właściwość na 1, aby upewnić się, że elementy zastępcze w nieszarejeczonych hierarchiach są widoczne w tabeli przestawnej. Prawidłowe wartości obejmują 0, 1, 2.

0 i 1 uwidaczniaj elementy członkowskie symboli zastępczych; 2 nie. Jeśli jest to puste, przyjmuje się, że wartość 0 jest pusta.

Brak trybu składowego MDX

Wskazuje, czy brakujące elementy członkowskie są ignorowane w instrukcjach MDX. Prawidłowe wartości to Domyślne, Błąd i Ignoruj. Wartość domyślna używa wartości zdefiniowanej przez serwer. Błąd generuje błąd, gdy członek nie istnieje. Ignoruj określa, że brakujące wartości powinny być ignorowane.

Optymalizowanie odpowiedzi

Maska bitów wskazująca, które z następujących optymalizacji odpowiedzi na zapytania są włączone.

• 0x01 Użyj elementu NormalTupleSet (ustawienie domyślne).
• 0x02 Użyj, gdy fragmentatory są puste.

Rozmiar pakietu

Dotyczy tylko połączeń TCP. Rozmiar pakietu sieciowego (w bajtach) z zakresu od 512 do 32 767. Domyślny rozmiar pakietu sieciowego to 4096.

Format protokołu

Ustawia format XML używany przez protokół komunikacyjny XMLA. Prawidłowe wartości to Default, XML lub Binary. Można określić kod XML do wysłania w formacie binarnym lub jako tekst XML. Format binarny koduje elementy i atrybuty XML, dzięki czemu są mniejsze. Ponadto można włączyć kompresję dla komunikatów, aby zmniejszyć rozmiar żądań i odpowiedzi przy użyciu opcji Kompresja transportu. Żądania i odpowiedzi mogą używać różnych formatów protokołu w zależności od tego, co obsługuje klient i serwer. Na przykład biblioteka klienta może obsługiwać tylko dane binarne dla odpowiedzi, ale nie dla żądań, lub serwer może wyłączyć plik binarny dla żądań przychodzących.

Dostawca OLE DB może formatować żądania i odpowiedzi w formacie binarnym lub skompresowanym. AMO i ADOMD.NET formatować żądania jako tekst, ale akceptują odpowiedzi w formacie binarnym lub skompresowanym.

Ta właściwość parametrów połączenia jest równoważna ustawieniu konfiguracji serwera EnableBinaryXML i EnableCompression .

OLAP w czasie rzeczywistym

Ustaw tę właściwość, aby pominąć buforowanie, powodując pobieranie danych z systemu źródłowego przez wszystkie zapytania magazynu. Domyślnie ta właściwość nie jest ustawiona.

Opcje bezpieczeństwa

Ustawia poziom bezpieczeństwa dla funkcji i akcji zdefiniowanych przez użytkownika. Prawidłowe wartości to 0, 1, 2. W połączeniu programu Excel ta właściwość to Safety Options=2. Szczegółowe informacje o tej opcji można znaleźć w temacie ConnectionString.

SQLQueryMode

Określa, czy zapytania SQL obejmują obliczenia. Prawidłowe wartości to Dane, Obliczane, IncludeEmpty. Dane oznaczają, że żadne obliczenia nie są dozwolone. Funkcja Calculated zezwala na obliczenia. Funkcja IncludeEmpty umożliwia obliczanie i zwracanie pustych wierszy w wyniku zapytania.

Przerwa czasowa

Określa, jak długo (w sekundach) biblioteka klienta czeka na ukończenie polecenia przed wygenerowaniem błędu.

Kompresja transportu

Definiuje sposób kompresji komunikacji klienta i serwera. Prawidłowe wartości to Default, None, Compressed. Brak wskazuje, że nie jest używana kompresja. Kompresowane używa kompresji XPRESS.

UseExistingFile

Używane podczas nawiązywania połączenia z modułem lokalnym. Ta właściwość określa, czy lokalny moduł jest zastępowany. Prawidłowe wartości to True lub False. Jeśli ustawiono wartość True, plik modułu musi istnieć. Istniejący plik będzie obiektem docelowym połączenia. W przypadku ustawienia wartości False plik modułu zostanie zastąpiony.

Zobacz także

Klasy podstawowe AMO — obiekty serwera
Klasa AdomdConnection — właściwości