Artykuł
07/22/2011

Właściwość AdomdConnection.ConnectionString

Pobiera lub ustawia ciąg , AdomdConnection używa się, aby otworzyć źródło dane analityczne.

Przestrzeń nazw: Microsoft.AnalysisServices.AdomdClient
Zestaw: Microsoft.AnalysisServices.AdomdClient (w Microsoft.AnalysisServices.AdomdClient.dll)

Składnia

'Deklaracja
Public Property ConnectionString As String
    Get
    Set
'Użycie
Dim instance As AdomdConnection
Dim value As String

value = instance.ConnectionString

instance.ConnectionString = value

public string ConnectionString { get; set; }

public:
virtual property String^ ConnectionString {
    String^ get () sealed;
    void set (String^ value) sealed;
}

abstract ConnectionString : string with get, set
override ConnectionString : string with get, set

final function get ConnectionString () : String
final function set ConnectionString (value : String)

Wartość właściwości

Typ: System.String
A ciąg zawiera parametry połączenia, który jest używany przez AdomdConnection.

Implementacje

IDbConnection.ConnectionString

Uwagi

ConnectionString Właściwość odpowiada połączenie OLE DB ciąg sformatować tak blisko, jak to możliwe.Można użyć ConnectionString właściwość do połączenia ze źródłem dane analityczne, który obsługuje XML for Analysis specyfikacji 1.1.

Wiele połączenia ciąg wartości mają odpowiednie właściwości tylko do odczytu.Podczas ustawiania połączenia ciąg, wszystkie te właściwości są aktualizowane, z wyjątkiem gdy wykryto błąd.Wykrycie błędu zapobiega aktualizacji wszystkich właściwości.

Resetowanie ConnectionString właściwość połączenia zamknięte resetuje wszystkie połączenia ciąg wartości (i powiązane właściwość), w tym hasła.Na przykład ustawić połączenie ciąg zawierającą Catalog= Adventure Works DW.Następnie zresetować połączenia ciąg do DataSource=localhost;Password=MyPassword.Database Właściwość jest teraz już zestaw do Adventure Works DW bazy danych.( Catalog Ustawienia połączenia ciąg odpowiada Database właściwość.)

Wstępne sprawdzanie poprawności połączenia ciąg jest wykonywany, gdy właściwość jest ustawiona.Gdy aplikacja wywołuje Open metody, połączenie ciąg jest analizowany i poszczególnych właściwości są oceniane na podstawie ich poziom obsługi.Jeśli AdomdConnection bezpośrednio obsługuje właściwość, pod warunkiem że w połączeniu z ciąg, wartość tej właściwości jest sprawdzana.Jeśli wartość jest nieprawidłowa lub nie jest obsługiwany, wyjątek.Jeśli właściwość nie jest obsługiwana bezpośrednio przez AdomdConnection, ale właściwości mogą być używane do konstruowania prawidłowego elementu XML, właściwość i jej wartość są przekazywane bezpośrednio do odpowiedniego dostawca.Jeśli taka właściwość zawiera wartość, która jest nieprawidłowa lub nie jest obsługiwany, wyjątek jest w tym czas.

Wartości mogą być rozdzielone w pojedynczych lub podwójnych cudzysłowów (na przykład name='value' lub name="value").Pojedyncze lub podwójne cudzysłowy, mogą być stosowane w parametry połączenia ciąg przy użyciu innych ograniczników (na przykład name="value's" lub name= 'value"s', ale nie name='value's' lub name= ""value"").Wszystkie znaki puste są ignorowane, z wyjątkiem tych umieszczonych w ramach wartość lub ofert.Pary wartość słowa kluczowego muszą być oddzielone średnikiem (;).Jeśli średnikami wartości, to również należy oddzielić spacjami ofert.Sekwencje unikowe nie są obsługiwane.Typ wartości nie ma znaczenia.Nazwy nie są przypadek poufne.Jeśli nazwa właściwość występuje więcej niż raz w połączeniu z ciąg, używana jest wartość skojarzona z ostatniego wystąpienia.

Ostrzeżenie

Aplikacje należy zachować ostrożność podczas tworzenia połączenia ciąg oparte na danych wejściowych użytkownika (na przykład podczas pobierania informacji identyfikator i hasło użytkownika z okno dialogowe i dołączania informacji do połączenia ciąg).Aplikacji powinny zapewnić, że użytkownik nie może osadzać dodatkowe połączenia ciąg parametry w tych wartości (na przykład użytkownik próbuje połączyć się z innej bazy danych może wprowadzić hasło jako validpassword;database=somedb).

W poniższej tabela opisano połączenia ciąg ustawienia bezpośrednio obsługiwane przez AdomdConnection.Ciągi połączeń specyficznych dla dostawcy zestawtings może być również zestaw, ale nie są tutaj wymienione.

Nazwa ustawienia	Ustawienie aliasów	Opis
Timeout	Brak	Ustawia czas oczekiwania na polecenie do uruchomienia przed AdomdConnection przestanie podejmować próby uruchomienia polecenia i generuje błąd.
Limit czasu połączenia	Brak	Ustawia czas oczekiwania na połączenie ustanowione przed AdomdConnection przestanie podejmować próby połączenia i generuje błąd.
Źródło danych	DataSourceLocation	Ustawia lokalne lub wystąpienie moduł (.cub) pliku, do którego AdomdConnection ustanawia połączenie.Podczas łączenia do wystąpienie osadzonej PowerPivot wartość musi być $osadzone$; dołączone znaki dolara.
Nazwa użytkownika	Uwierzytelniony użytkownik UID Identyfikator użytkownika	Ustawia nazwę użytkownika lub nazwę, która AdomdConnection używa do ustanawiania połączenia. Uwaga: Uwierzytelniony użytkownik nie jest już obsługiwany.
Hasło	PWD	Ustawia hasło AdomdConnection używa do ustanowienia połączenia z nazwy określonego użytkownika.
Katalog	Katalog początkowy Baza danych	Ustawia bazy danych, do której AdomdConnection ustanawia połączenie.
ProtectionLevel	Brak	Ustawia poziom ochrony, dostawca używa do podpisywania lub szyfrowania połączenia.To ustawienie ma następujące opcje: Brak wykonuje nie uwierzytelnianie danych wysyłanych do serwera POŁĄCZ uwierzytelnia tylko wtedy, gdy klient nawiąże połączenie z serwerem. INTEGRALNOŚĆ PKT uwierzytelniania jest wszystkie dane odebrane od klient i nie została zmieniona podczas przesyłania. PKT PRIVACY szyfruje dane i uwierzytelnia odbierania danych od klient i czy nie została zmieniona podczas przesyłania.
Opcje bezpieczeństwa	Brak	Ustawia poziom bezpieczeństwa, który określa sposób obsługi zabezpieczeń dla funkcji zdefiniowanych przez użytkownika i akcje.
AutoSyncPeriod	Brak	Ustawia czas, w milisekundach, które musi upłynąć, zanim obiekty automatycznie synchronizować z serwerem.
0	Brak	Ustawia metoda AdomdConnection używa używane do łączenia z serwerem.Jeśli ustawiona na 8.0, używany w procesie XML for Analysis do połączenia z serwerem.Jeśli ustawiona na 9.0, używa połączenia XML for Analysis.Jeśli ustawiona na domyślne, połączenie najpierw próbuje XML for Analysis, a następnie próbuje użyć w procesie XML for Analysis.
Dostawca	Brak	Ustawia nazwę dostawca dla źródło danych.Wartością domyślną jest MSOLAP.
DataSourceInfo	Brak	Ustawia informacje specyficzne dla dostawca, wymagany do uzyskania dostępu do źródło danych.
Zintegrowane zabezpieczenia	Brak	Ustawia kontrola dostępu do używania.Jeśli zestaw do SSPI, pakiet SSPI zabezpieczeń obsługiwane jest używany do uwierzytelnianie użytkownika.Jeśli zestaw do podstawowych, nazwa_użytkownika i hasło zestawtings jest wymagana.Połączenie HTTP można użyć tylko ustawienia podstawowych.
CreateCube	Brak	Zestawy Utwórz Moduł instrukcja, który jest używany podczas tworzenia kostek lokalnych.
Format protokołu	Brak	Ustawia format XML wysyłany do serwera.Ustawienia mogą być domyślne, XML, lub Binary.
Hasło szyfrowania	Brak	Ustawia hasło używane do odszyfrowywania kostek lokalnych.
Poziom personifikacji	Brak	Ustawia poziom personifikacji, które serwer może używać, gdy uosabia klient.Są dostępne ustawienia anonimowych, Identyfikowanie, Personifikuj, i obiektu delegowanego.Wartością domyślną jest Personifikuj.
SSPI	Brak	Ustawia pakiet zabezpieczeń do uwierzytelnianie użytkownika.Dostępne ustawienia obejmują Negotiate, Kerberos, NTLM, i Użytkownika anonimowego.Wartością domyślną jest Negotiate.
UseExistingFile	Brak	Ustawia, czy użyć lub zastąpienie istniejącego pliku.Jeśli zestaw do truemusi istnieć plik lokalny, a moduł jest tworzony, jeśli moduł nie istnieje albo używane, jeśli moduł istnieje.Jeśli zestaw do false, zastąpić istniejące kostki lokalnej.Wartością domyślną jest false.
Kodowanie znaków	Brak	Określa sposób kodowania znaków.Wartością domyślną jest ciąg UTF-8.
Użyj szyfrowania danych	Brak	Ustawia, czy używane jest szyfrowanie między klient i serwera.Jeśli zestaw do true, wszystkie dane przesyłane między klientem a serwerem są szyfrowane za pomocą szyfrowanie SSL (Secure Sockets Layer), pod warunkiem, że serwer ma zainstalowany certyfikat.
Rozmiar pakietu	Brak	Ustawia rozmiar pakiet w bajtach komunikacji sieciowej między klient i serwera.Wartość musi między 512 i 32767.Wartością domyślną jest 4096.
Właściwości rozszerzone	Brak	Ustawia połączenie ciąg właściwości, które mają zastąpić połączenia ciąg w którym Właściwości rozszerzone zawarte.Ta właściwość jest połączenie ciąg, właściwości, które zastępują połączenia ciąg w którym Właściwości rozszerzone zawarte.Właściwości rozszerzonych może zawierać innego Właściwości rozszerzone, właściwości utrzymać pierwszeństwo.Właściwości rozszerzonych obsługuje zagnieżdżanie nieograniczony.
LocaleIdentifier	Brak	Określa preferowany ustawienia regionalne identyfikator aplikacji klient.
Lokalizacja	Brak	Ustawia nazwę serwera.
Ograniczone klienta	Brak	Ustawia, czy klient jest ograniczone.Jeśli zestaw do true, będzie dotyczyć klient przy użyciu funkcji modelu lokalnych górnictwa i kostki lokalnej.W ten sposób klient próbuje użyć lokalnego moduł lub modeli wyszukiwania lokalnych podniesie błąd.
Utrwalić informacje o zabezpieczeniach	Brak	Ustawia, czy informacje dotyczące zabezpieczeń zostaną utrwalone.Jeśli zestaw do true, informacje związane z zabezpieczeniami można uzyskać z połączenia po otwarciu połączenia.
Identyfikator sesji	Brak	Ustawia identyfikator sesja używany połączenia.Jeśli identyfikator sesja nie pasuje do istniejącej sesja, błąd będzie uruchamiany.
Kompresja transportu	Brak	Ustawia, czy połączenie będzie się komunikował z kompresji.Jeśli zestaw do Brak, zostanie użyta bez kompresji.Jeśli zestaw do skompresowane, łączności mogą być skompresowane, aby zmniejszyć rozmiar pakiet.GZIP ustawienie kompresuje połączeń HTTP.Jeśli zestaw do domyślne, GZIP będzie używany przez połączenie HTTP; w przeciwnym razie zostanie użyta bez kompresji.
Poziom kompresji	Brak	Ustawia poziom kompresji, od 0 do 9.Im większa wartość, tym większa kompresja.
SspropInitAppName	Brak	Ustawia nazwę aplikacji, która ma być skojarzony z tym połączeniem.Ta wartość może być przydatne podczas monitorowania zdarzeń śledzenia.
ClientProcessID	Brak	Ustawia identyfikator procesu aplikacji, która ma być skojarzony z tym połączeniem.Jeśli wartość ta nie jest zestaw, i SspropInitAppName została zestaw, ClientProcessID będą automatycznie zestaw do procesu identyfikator pobierany z systemu operacyjnego klient.Ta wartość może być przydatne podczas monitorowania zdarzeń śledzenia.
Poziom izolacji aktualizacji	Brak	Określa, czy komórki w jednym Aktualizacja modułu instrukcja są odizolowane od siebie.Domyślnie nie jest izolowany.
Podkwerendy	Brak	Maska bitowa określa zachowanie podkwerend.Ta właściwość może mieć wartości wymienione w poniższej tabela. WartośćOpis 0 Wartość domyślna, zgodny ze starszymi wersjami Usługi Analysis Services.Składniki obliczeniowe lub zestawy obliczeniowe nie są dozwolone w subselects lub podmodułów. 1 Składniki obliczeniowe lub zestawy obliczeniowe są dozwolone w subselects lub podmodułów.Ascendants obliczeniowy element członkowski nie są uwzględniane w przestrzeni Podselekcja lub podmodułu. 2 Składniki obliczeniowe lub zestawy obliczeniowe są dozwolone w subselects lub podmodułów.Ascendants obliczeniowy element członkowski znajdują się w przestrzeni Podselekcja lub podmodułu. Zero lub puste są domyślne wartości dla tej właściwość. Jest to właściwość sesja, który zestaw tylko podczas tworzenia sesja. Aby uzyskać więcej informacji o zachowaniu składniki obliczeniowe lub obliczone zestawów podkwerend oraz podmodułów, zobacz Składniki obliczeniowe w Subselects i podmodułów.
AutoExists	Brak	Określa zachowanie autoexists.Ta właściwość może mieć wartości wymienione w poniższej tabela. WartośćOpis 0 Wartość domyślna równa 1. 1 Zastosowanie głębokie autoexists osi kwerendy i nazwane zestawy.Zawiera klauzul WHERE i subselects. 2 Zastosowanie głębokie autoexists dla osi kwerendy i wykluczyć nazwane zestawy z autoexists.Zawiera klauzul WHERE i subselects. 3 Zastosowanie nie autoexists dla nazwane zestawy z klauzula WHERE.Zastosowanie autoexists skrócona dla osi kwerendy z klauzula WHERE.Zastosowanie głębokie autoexists osi kwerendy z subselects i nazwane zestawy z subselects. Zero lub puste są domyślne wartości dla tej właściwość. Jest to właściwość sesja, który zestaw tylko podczas tworzenia sesja.

Połączenie kilku ciąg mapy ustawienia odpowiednich właściwości w AdomdConnection.W poniższej tabela przedstawiono połączenia ciąg ustawienia odpowiadające ich AdomdConnection właściwość.

Nazwa ustawienia	Nazwa właściwości
ConnectionTimeout	ConnectionTimeout
Katalog	Baza danych

Ostrzeżenie

Nie można zmienić właściwości, które są właściwości inicjujące, po otwarciu połączenia.Zestaw właściwości inicjujące dostępne można wyszukiwać za pomocą IDBProperties::GetPropertyInfo.

Łączenie z plików kostek lokalnych

Aby połączyć się z istniejącego pliku kostki lokalnej, należy podać pełną ścieżka i nazwę pliku pliku kostki lokalnej prawidłowy w Źródła danych połączenia ciąg ustawienie i, w stosownych przypadkach, prawidłowe hasło w hasło połączenia ciąg ustawienie.Jeśli lokalny moduł plik już istnieje, nowy lokalny moduł plik jest tworzony i chroniony hasłem, pod warunkiem, że hasło zostało określone.Jeśli kostka lokalna ma być utworzony, dodatkowe ustawienia musi być określona w połączeniu z ciąg, takich jak INSERTINTO lub CREATECUBE.

Ustawianie opcji bezpieczeństwa

Wartość Opcje bezpieczeństwa właściwość określa, czy niebezpieczne bibliotek może być zarejestrowany i ładowany przez Microsoft Usługa tabela przestawna lub serwera.Jeśli próby załadowania biblioteki niebezpieczne lub odwołać niebezpiecznych funkcja zdefiniowanej przez użytkownika podczas bezpieczeństwa sprawdzanie jest włączone, a następnie Usługa tabela przestawna zwraca następujący komunikat o błędzie:

User defined function <function name> cannot be used, because the class that implements it is not safe for initialization or scripting, which is required by client settings.

Wartość Opcje bezpieczeństwa właściwość określa, czy przekazywanie słowo kluczowe jest dozwolony w kostek lokalnych.Jeśli aplikacja klient próbuje utworzyć lokalnego moduł z instrukcja INSERT INTO zawierający przekazywanie słowa kluczowego, lub jeśli aplikacja kliencka próby odświeżenia lokalnym moduł zawierający instrukcja INSERT INTO używający przekazywanie wywoływane słowa kluczowego, błąd.

W poniższej tabela przedstawiono możliwe wartości Opcje bezpieczeństwa właściwość.

Wartość	Opis
0	Dla połączeń lokalnych moduł, lub przez serwer IIS (Internet Information Services), wartość ta jest taka sama, jak DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE. Dla innych połączeń, wartość ta jest taka sama jak DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
1	Wartość ta włącza wszystkie biblioteki funkcja zdefiniowana przez użytkownika bez sprawdzenia, czy biblioteki są bezpieczne dla inicjowania i wykonywanie skryptów i umożliwia użycie przekazywanie słowo kluczowe w kostek lokalnych. MDSCHEMA_ACTIONS wyniki są na próbkach niefiltrowanych. Uwaga: Wybranie tej opcji nie jest zalecane.
2	Wartość ta zapewnia wszystkie klasy dla biblioteki określonej funkcja zdefiniowanej przez użytkownika są sprawdzane, aby zapewnić bezpieczne do inicjowania i wykonywanie skryptów i uniemożliwia również wykorzystanie przekazywanie słowo kluczowe w kostek lokalnych. MDSCHEMA_ACTIONS wyniki typu HTML i wiersza polecenia są odfiltrowywane.MDSCHEMA_ACTIONS wyniki wprowadź adres URL są odfiltrowane, chyba że zawartości kolumna zaczyna się od HTTP:// lub HTTPS://.
3	Wartość ta zapobiega funkcje zdefiniowane przez użytkownika są używane podczas sesja i uniemożliwia wykorzystanie przekazywanie słowo kluczowe w kostek lokalnych. MDSCHEMA_ACTIONS wyniki są puste.

Poziom izolacji aktualizacji

Wartość Poziom izolacji aktualizacji właściwość wpływa na sposób Analysis Services ocenia każdą komórka aktualizacji.Komórki mają być aktualizowane może zachodzić polecenia SET do następnego w tej samej instrukcja UPDATE.Jeśli zaktualizowane komórek nie nakładają, można zwiększyć wydajność przez ustawienie Poziomu izolowanie aktualizacji do izolowany (1).Jednak zaktualizowane komórek, nakładają się i Poziomu izolowanie aktualizacji jest zestaw do izolowany (1) będą błędne wyniki instrukcja UPDATE.

W poniższej tabela przedstawiono możliwe wartości Poziomu izolowanie aktualizacji właściwość.

Wartość	Opis
0	Nie występują samodzielnie
1	Izolowane Uwaga: Wartość tę należy używać ostrożnie i używać tylko, gdy komórek nie nakładania instrukcja UPDATE modułu.

Aby zrozumieć kumulacji, przejrzyj następujące tabela fakt proste moduł Prognozowanie sprzedaży z tylko pięć wierszy.

Nazwa	Płeć	Stan	ProjektowanaSprzedaż
Alicja	Kobieta	LUB	Wartość null
Beata	Kobieta	WA	Wartość null
Charles	Męska	WA	Wartość null
Diego	Męska	URZĄD CERTYFIKACJI	Wartość null
Edward	Męska	URZĄD CERTYFIKACJI	Wartość null

Załóżmy, że chcesz przypisać do sprzedaży prognozowane rozproszonych wartości 100 wszystkich samic i rozproszonych 200 dla wszystkich sprzedawców z Kalifornii (CA).W tym przypadek, instrukcja update moduł wyglądałyby następująco:

UPDATE CUBE SalesForcasting SET Female=100, CA=200 USE_EQUAL_INCREMENT

Po zaznaczeniu komórek zaktualizowane można zauważyć, że nie nakładały.Samice komórkach zaktualizowane Alicja i jego Beata komórek i komórki California są Diego i Edward.

Teraz załóżmy, że chcesz przypisać do wszystkich samców i rozproszonych wartość 200 do wszystkich sprzedawców z Waszyngton (WA) rozproszonych wartość 100.W tym przypadek, instrukcja update moduł byłyby następujące:

UPDATE CUBE SalesForcasting SET Male=100, WA=200 USE_EQUAL_INCREMENT

Po zaznaczeniu komórek zaktualizowane można zauważyć, że nakładają się.Samce zaktualizowanych komórek są Charlesa, Diego i Edwards komórki i Waszyngton komórki są Beata i Charlesa.Komórki nakładają się na Charlesa.

Zobacz także

Odwołanie

AdomdConnection Klasa

Przestrzeń nazw Microsoft.AnalysisServices.AdomdClient

Udostępnij za pośrednictwem