Narzędzie ssbdiagnose

Składnia

ssbdiangose 
[ [ -XML ]
    [ -LEVEL { ERROR | WARNING | INFO } ]
  [-IGNORE error_id ] [ ...n]
    [ <baseconnectionoptions> ]
  { <configurationreport> | <runtimereport> }
]
| -?

<configurationreport> ::=
    CONFIGURATION
  { [ FROM SERVICE service_name
      [ <fromconnectionoptions> ]
      [ MIRROR <mirrorconnectionoptions> ]
    ]
    [ TO SERVICE service_name[, broker_id ]
      [ <toconnectionoptions> ]
      [ MIRROR <mirrorconnectionoptions> ]
    ]
  }
    ON CONTRACT contract_name
  [ ENCRYPTION { ON | OFF | ANONYMOUS } ]

<runtime_report> ::=
    RUNTIME
    [-SHOWEVENTS ]
        [ -NEW
         [ -ID { conversation_handle
                | conversation_group_id
                 | conversation_id
                  }
        ] [ ...n]
        ]
    [ -TIMEOUT timeout_interval ]
    [ <runtimeconnectionoptions> ]

<baseconnectionoptions> ::=
  <connectionoptions>

<fromconnectionoptions> ::=
  <connectionoptions>

<toconnectionoptions> ::=
  <connectionoptions>

<mirrorconnectionoptions> ::=
  <connectionoptions>

<runtimeconnectionoptions> ::=
  [ CONNECT TO <connectionoptions> ] [ ...n]

<connectionoptions> ::=
    [ –E | { -U login_id [ -P password ] } ]
  [ -S server_name[\instance_name] ]
  [ -d database_name ]
  [ -l login_timeout ]

Opcje wiersza polecenia

• -XML
  Określa, że ssbdiagnose wygenerowane jako XML sformatowane dane wyjściowe.To mogą być przekierowywane do pliku lub do innej aplikacji.Jeśli - xml nie jest określony, ssbdiagnose danych wyjściowych jest sformatowana jako tekst czytelny dla człowieka.

• -LEVEL { ERROR | WARNING | INFO}
  Określa poziom wiadomości raportu.

  Błąd: raport tylko komunikaty o błędach.

  Ostrzeżenie: raport błędów i komunikaty ostrzegawcze.

  Informacje o: Raport błędu, ostrzeżenia i komunikaty informacyjne.

  Ustawieniem domyślnym jest Ostrzeżenie.

• -IGNOREerror_id
  Określa, że błędy i komunikaty mają określonego error_id nie być uwzględniane w raportach.Można określić -Ignoruj kilka razy, aby pominąć komunikat wiele identyfikatorów.Aby uzyskać więcej informacji, zobacz Błędy i zdarzenia odniesienia (Service Broker).

• <baseconnectionoptions>
  Określa informacje o połączeniu podstawowej, który jest używany przez ssbdiagnose gdy opcje połączenia nie są uwzględniane w szczególnej klauzula.Informacje o połączeniu w szczególnej klauzula zastępuje baseconnectionoption informacji.Jest to wykonywane oddzielnie dla każdego parametru.Na przykład, jeśli oba -S i -d są określone w baseconnetionoptionsi tylko -d określonych w toconnetionoptions, ssbdiagnose używa -S z baseconnetionoptions i -d z toconnetionoptions.

• KONFIGURACJA
  Żądania raportu błędy konfiguracja między dwoma Service Broker usługa, lub dla pojedynczej usługa.

• FROM SERVICEservice_name
  Określa usługa, która inicjuje konwersacji.

• <fromconnectionoptions>
  Określa informacje wymagane do połączenia z bazą posiada usługa inicjatora.Jeśli fromconnectionoptions nie jest określony, ssbdiagnose używa informacji o połączeniu z baseconnectionoptions z bazą danych inicjatora.Jeśli fromconnectionoptions jest określony, musi on zawierać bazę danych zawierającą usługa inicjatora.Jeśli fromconnectionoptions nie jest określony, baseconnectionoptions należy określić inicjatora bazy danych.

• TO SERVICEservice_name[, broker_id ]
  Określa usługa, która jest miejsce docelowe dla konwersacji.

  service_name: Określa nazwę usługa miejsce docelowe.

  broker_id: Określa Service Broker Identyfikatora, który identyfikuje miejsce docelowe bazy danych. broker_id jest identyfikatorem GUID.W miejsce docelowe bazy danych, aby go znaleźć, można uruchomić następującą kwerendę:

  SELECT service_broker_guid
  FROM sys.databases
  WHERE database_id = DB_ID();
  

• <toconnectionoptions>
  Określa informacje wymagane do połączenia bazy danych, która posiada usługa miejsce docelowe.Jeśli toconnectionoptions nie jest określony, ssbdiagnose używa informacji o połączeniu z baseconnectionoptions się z miejsce docelowe bazy danych.

• DUBLOWANIE
  Specifies that the associated Service Broker service is hosted in a mirrored database.ssbdiagnose verifies that the route to the service is a mirrored route, where MIRROR_ADDRESS was specified on CREATE ROUTE.

• <mirrorconnectionoptions>
  Określa informacje wymagane do łączenia się z duplikat bazy danych.Jeśli mirrorconnectionoptions nie jest określony, ssbdiagnose używa informacji o połączeniu z baseconnectionoptions się z duplikat bazy danych.

• ON CONTRACTcontract_name
  Żąda ssbdiagnose tylko sprawdzić konfiguracje korzystające z określonego kontrakt.Jeśli nie określono w umowie, ssbdiagnose sprawozdania w sprawie kontrakt o nazwie domyślne.

• SZYFROWANIE { na | OFF | ANONIMOWYCH }
  Okno dialogowe jest poprawnie skonfigurowana dla określonego poziom szyfrowanie weryfikacji żądania:

  ON: Ustawienie domyślne.Pełne okno dialogowe zabezpieczeń jest skonfigurowany.Certyfikaty zostały rozmieszczone po obu stronach, w oknie dialogowym powiązanie usługa zdalnej jest obecny i dotacji WYSYŁANIA instrukcja dla użytkownika inicjatora określone usługa miejsce docelowe.

  OFF: Skonfigurowano bez okna dialogowego zabezpieczeń.Brak certyfikatów został wdrożony, została utworzona nie powiązanie usługa zdalnej i wysłać dotacji dla usługa inicjatora określone publicznych rolę.

  ANONIMOWE: Skonfigurowano anonimowe okna dialogowego zabezpieczeń.Jeden certyfikat został wdrożony, powiązanie usługa zdalnej określone klauzula anonimowe i wysłać dotacji dla miejsce docelowe usługa określone public rolę.

  Aby uzyskać więcej informacji, zobacz Service Broker okna dialogowego zabezpieczeń.

• RUNTIME
  Żądania raportu problemów powodujących błędy czasu wykonania dla Service Broker konwersacji. Jeśli żadna -Nowy lub -ID są określone, ssbdiagnose monitoruje wszystkie konwersacje w określonym w opcji połączenia wszystkich baz danych.Jeśli -Nowy lub -ID są określone, ssbdiagnose tworzy listę identyfikatorów określona w parametrach.

  Podczas ssbdiagnose jest uruchomiony, rejestruje wszystkie SQL Server Profiler zdarzenia, które wskazują błędy czasu wykonywania.Rejestruje zdarzenia występujące dla określonych identyfikatorów plus zdarzeń poziom systemu.Jeśli wystąpią błędy wykonania ssbdiagnose uruchamia raport konfiguracja skojarzone konfiguracja.

  Domyślnie błędy wykonania nie są uwzględniane w raporcie dane wyjściowe tylko wyniki analizy konfiguracja.Użyj - showevents błędy czasu wykonania, uwzględnione w raporcie.

• -SHOWEVENTS
  Określa, że ssbdiagnose raport SQL Server Profiler zdarzenia podczas wykonywania raportu.Tylko te zdarzenia, które są uważane za warunki błędów są raportowane.Domyślnie ssbdiagnose monitoruje tylko zdarzenia błędów; go nie zgłasza je w danych wyjściowych.

• -NOWYCH
  Żąda runtime monitorowania pierwszego konwersacji, która rozpoczyna się po ssbdiagnose uruchamiania.

• -ID
  Żądania obsługi monitorowania elementów określonego konwersacji.Można określić -ID wiele razy.

  Jeśli określisz dojście do konwersacji, są zgłaszane tylko zdarzenia skojarzone z punktem końcowym skojarzony konwersacji.Jeśli określony identyfikator konwersacji, wszystkie zdarzenia dla tej konwersacji i jego inicjatora i miejsce docelowe punkty końcowe są raportowane.Jeśli określono identyfikator grupa konwersacji są raportowane wszystkie zdarzenia dla wszystkich konwersacji i punkty końcowe w grupie konwersacji.

• conversation_handle
  Identyfikator unikatowy, który identyfikuje punkt końcowy konwersacji w aplikacji.Uchwyty konwersacji są unikatowe w jednym punkcie końcowym konwersację inicjatora i miejsce docelowe punkty końcowe mają uchwyty oddzielnych konwersacji.

  Konwersacji uchwyty są zwracane do aplikacji przez @dialog_handle parametr Okno DIALOGOWE rozpocząć instrukcja oraz conversation_handle kolumna zestaw wyników odbioru instrukcja.

  Uchwyty konwersacji są zgłaszane w conversation_handle kolumna sys.transmission_queue i sys.conversation_endpoints widoki wykazu.

• conversation_group_id
  Identyfikator unikatowy identyfikująca grupa konwersacji.

  Identyfikatory grup konwersacji są zwracane do aplikacji przez @conversation_group_id parametr Uzyskać grupy KONWERSACJI instrukcja i conversation_group_id kolumna zestaw wyników odbioru instrukcja.

  Identyfikatory grup konwersacji są zgłaszane w conversation_group_id kolumny sys.conversation_groups i sys.conversation_endpoints widoki wykazu.

• conversation_id
  Identyfikator unikatowy, który identyfikuje konwersacji.Identyfikatory konwersacji są takie same dla obu inicjatora i miejsce docelowe punkty końcowe konwersacji.

  Identyfikatory konwersacji są zgłaszane w conversation_id kolumna sys.conversation_endpoints wykazu widoku.

• -TIMEOUTtimeout_interval
  Określa liczbę sekund dla RUNTIME raportu do uruchomienia.Jeśli - timeout nie jest określony, raport runtime nie jest określona.-TIMEOUT jest używana tylko na RUNTIME raporty nie konfiguracji raportów.Use ctrl + C to quit ssbdiagnose if -TIMEOUT was not specified or to end a runtime report before the time-out interval expires.timeout_interval must be a number between 1 and 2,147,483,647.

• <runtimeconnectionoptions>
  Określa informacje o połączeniu dla baz danych, które zawierają usługi skojarzone z elementami konwersacji monitorowany.Jeśli wszystkie usługi są w tej samej bazie danych, wystarczy określić jeden Łączenie z klauzula.Jeśli w odrębnych bazach danych usług należy podać Łączenie z klauzula dla każdej bazy danych.Jeśli runtimeconnectionoptions nie jest określony, ssbdiagnose używa informacji o połączeniu z baseconnectionoptions.

• -E
  Otwórz połączenie z uwierzytelniania systemu Windows do wystąpienie Aparat baz danych za pomocą konta systemu Windows jako identyfikator logowaniaIdentyfikator logowania musi być element członkowski z sysadmin roli-Serwer.

  Opcja -E ignoruje ustawienia użytkownika i hasło, zmiennych środowiskowych SQLCMDUSER i SQLCMDPASSWORD.

  Jeśli żadna -E ani - U jest określony, ssbdiagnose używa wartości zmiennej środowiskowej SQLCMDUSER.Jeśli nie jest SQLCMDUSER zestaw albo, ssbdiagnose używa uwierzytelniania systemu Windows.

  Jeśli -E opcja jest używana wraz z - U opcji lub -P opcji komunikat o błędzie jest generowany.

• -Ulogin_id
  Otwórz SQL Server uwierzytelniania połączeń przy użyciu identyfikator logowania określonyIdentyfikator logowania musi być element członkowski z sysadmin roli-Serwer.

  Jeśli żadna -E ani - U jest określony, ssbdiagnose używa wartości zmiennej środowiskowej SQLCMDUSER.Jeśli nie jest SQLCMDUSER zestaw albo, ssbdiagnose próbuje połączyć się przy użyciu trybu uwierzytelniania systemu Windows, oparte na konto użytkownika, który działa ssbdiagnose.

  Jeśli - U opcja jest używana wraz z -E opcji komunikat o błędzie jest generowany.Jeśli –U opcji występuje więcej niż jeden argument, generowany jest komunikat o błędzie i zamyka program.

• -Ppassword
  Określa hasło dla - U identyfikator logowania.Hasła są przypadek poufne.Jeśli - U jest używana opcja i -P nie jest używana opcja, ssbdiagnose używa wartości zmiennej środowiskowej SQLCMDPASSWORD.Jeśli nie jest SQLCMDPASSWORD zestaw albo, ssbdiagnose monituje użytkownika o hasło.

  Uwaga dotycząca zabezpieczeń
  Po wpisaniu polecenia SQLCMDPASSWORD USTAWIĆ hasło będzie widoczny dla każdego, kto może zobaczyć monitora.

  Jeśli -P bez hasła określono opcję ssbdiagnose używa domyślnego hasła (NULL).

  Uwaga dotycząca zabezpieczeń
  Nie należy używać pustego hasła. Należy używać silnego hasła.Aby uzyskać więcej informacji, zobacz Silne hasła.

  Monitu o hasło jest wyświetlane przez drukowanie monitu o hasło do konsoli, w następujący sposób: Password:

  Dane wejściowe użytkownika jest ukryty.Oznacza to, że nic nie jest wyświetlane, a kursor pozostaje w pozycji.

  Jeśli -P jest używana opcja z -E opcji komunikat o błędzie jest generowany.

  Jeśli -P opcji występuje więcej niż jeden argument, generowany jest komunikat o błędzie.

• -Sserver_name[\instance_name]
  Określa wystąpienie Aparat baz danych przechowuje Service Broker usługi analizowanej.

  Określ server_name do łączenia się z wystąpienie domyślne Aparat baz danych na tym serwerze.Określ server_name**\**instance_name się z wystąpienie nazwane z Aparat baz danych na tym serwerze.Jeśli -S nie jest określony, ssbdiagnose używa wartości zmiennej środowiskowej SQLCMDSERVER.Jeśli nie jest SQLCMDSERVER zestaw albo, ssbdiagnose łączy się z wystąpienie domyślne Aparat baz danych na komputerze lokalnym.

• -ddatabase_name
  Określa bazę danych, który przechowuje Service Broker usługi analizowanej.Jeśli baza danych nie istnieje, zostanie wygenerowany komunikat o błędzie.Jeśli -d nie jest określony, domyślnie jest określone we właściwość domyślnej bazy danych dla swojego identyfikatora logowania bazy danych.

• -llogin_timeout
  Określa limit czasu w sekundach przed próba nawiązania połączenia z serwerem.Jeśli -l nie jest określony, ssbdiagnose używa wartości zestaw dla zmiennej środowiskowej SQLCMDLOGINTIMEOUT.Jeśli SQLCMDLOGINczassię nie ustawiono albo domyślnie czas-out jest 30 sekund.Identyfikator logowania czas-out musi być liczbą pomiędzy 0 i 65534.Jeśli podano wartość nie jest liczbą lub nie należą do zakres, ssbdiagnose generuje komunikat o błędzie.Określa wartość 0, czas-out być nieograniczony.

• -?
  Wyświetla Pomoc w wierszu polecenia.

Uwagi

Użyj ssbdiagnose wykonać następujące czynności:

• Potwierdź, że w nowo skonfigurowany są błędy konfiguracja nie Service Broker aplikacji.

• Potwierdź, że po zmianie konfiguracja istniejącej są błędy konfiguracja nie Service Broker aplikacji.

• Upewnij się, że nie istnieją żadne błędy konfiguracja po Service Broker bazy danych jest odłączony, a następnie ponownie przymocowana do nowego wystąpienie Aparat baz danych.

• Należy zbadać, czy występują błędy konfiguracja, gdy wiadomości nie są pomyślnie przesyłane między usługami.

• Raport o błędach występujących w zestaw z Service Broker elementów konwersacji.

Aby uzyskać informacje dotyczące błędów zwracanych przez ssbdiagnose, zobacz Błędy i zdarzenia odniesienia (Service Broker).

Raportowanie konfiguracji

Raportowanie w czasie wykonywania

Zgłoszono problemów przez ssbdiagnose

polecenie SQLCMD zmiennych środowiskowych

Uprawnienia

W każdym connectionoptions klauzula, logowania z albo -E lub - U musi być element członkowski z sysadmin -serwer roli w wystąpieniu określonego w -S.

Przykłady

Ta sekcja zawiera przykłady użycia ssbdiagnose w wiersz polecenia.

A.Sprawdzanie konfiguracji dwie usługi w tej samej bazy danych

ssbdiagnose -E -d MyDatabase 
CONFIGURATION FROM SERVICE /test/initiator TO SERVICE /test/target

B.Sprawdzanie konfiguracji dwóch usług na oddzielnych komputerach używających jednego logowania

ssbdiagnose -E CONFIGURATION FROM SERVICE /text/initiator -S
 InitiatorComputer -d InitiatorDatabase TO SERVICE /test/target -S 
TargetComputer -d TargetDatabase ON CONTRACT TestContract

C.Sprawdzanie konfiguracji dwóch usług na oddzielnych komputerach oddzielnych logowania do tego użytku

ssbdiagnose CONFIGURATION FROM SERVICE /text/initiator -S 
InitiatorComputer -U InitiatorLogin -p !wEx23Dvb -d InitiatorDatabase 
TO SERVICE /test/target -S TargetComputer -U TargetLogin -p ER!49jiy -d 
TargetDatabase ON CONTRACT TestContract

D.Sprawdzanie dublowanego konfiguracji usługi na oddzielnych komputerach z szyfrowaniem anonimowe

ssbdiagnose -E CONFIGURATION FROM SERVICE /text/initiator -S 
InitiatorComputer -d InitiatorDatabase MIRROR -S 
MirrorComputer/MirrorInstance TO SERVICE /test/target -S TargetComputer –d 
TargetDatabase ON CONTRACT TestContract ENCRYPTION ANONYMOUS

E.Sprawdzanie konfiguracji dwóch umów

ssbdiagnose -E -d MyDatabase 
CONFIGURATION FROM SERVICE /test/initiator TO SERVICE /test/target 
ON CONTRACT PayRaiseContract
ssbdiagnose -E -d MyDatabase CONFIGURATION FROM SERVICE /test/initiator 
TO SERVICE /test/target ON CONTRACT PromotionContract

F.Monitorowanie stanu konwersację na komputerze lokalnym z czas się

ssbdiagnose -E -d TestDatabase 
RUNTIME -ID D68D77A9-B1CF-41BF-A5CE-279ABCAB140D -TIMEOUT 20

G.Monitorowanie stanu konwersację obejmuje dwa komputery

ssbdiagnose RUNTIME -ID D68D77A9-B1CF-41BF-A5CE-279ABCAB140D 
-TIMEOUT 10 CONNECT TO -E -S InitiatorComputer/InitiatorInstance 
-d InitiatorDatabase CONNECT TO -E -S TargetComputer/TargetInstance 
-d TargetDatabase

H.Monitorowanie stanu w dwóch baz danych w tej samej konwersacjiwystąpienie

ssbdiagnose -E -S TestComputer/DevTestInstance RUNTIME -SHOWEVENTS 
-ID 5094d4a7-e38c-4c37-da37-1d58b1cb8455 -TIMEOUT 10 CONNECT TO 
-d InitiatorDatabase CONNECT TO -d TargetDatabase

I.Monitorowanie stanu rozmowy dwóch między dwie bazy danych

ssbdiagnose -E -S TestComputer/DevTestInstance RUNTIME 
-ID 5094d4a7-e38c-4c37-da37-1d58b1cb8455 
-ID 9b293be9-226b-4e22-e169-1d2c2c15be86 -TIMEOUT 10 CONNECT TO 
-d InitiatorDatabase CONNECT TO -d TargetDatabase

J.Monitorowanie stanu wszystkie konwersacje między dwie bazy danych

ssbdiagnose -E -S TestComputer/DevTestInstance RUNTIME 
-TIMEOUT 10 CONNECT TO -d InitiatorDatabase CONNECT TO 
-d TargetDatabase

K.Ignorowanie błędów

ssbdiagnose -IGNORE 303 -IGNORE 304 -E -d TestDatabase 
CONFIGURATION FROM SERVICE /test/initiator TO SERVICE /test/target 
ON CONTRACT TextContract

L.Przekierowywanie danych wyjściowych XML ssbdiagnose

ssbdiagnose -XML -E -d MyDatabase CONFIGURATION FROM SERVICE
 /test/initiator TO SERVICE /test/target >
 c:\MyDiagnostics\TestDiag.xml

M.Przy użyciu zmiennej środowiskowej

SET SQLCMDSERVER=MyComputer
ssbdiagnose -XML -E -d MyDatabase CONFIGURATION FROM SERVICE 
/test/initiator TO SERVICE /test/target

Zobacz także

Odwołanie

Koncepcje