Utwórz punkt końcowy (języka Transact-SQL)
Tworzy punkty końcowe oraz określa ich właściwości, takie jak metody dostępne dla aplikacji klient.Aby uzyskać informacje pokrewne uprawnień Zobacz GRANT Endpoint Permissions (Transact-SQL).
Składnia służąca do punktu KOŃCOWEGO CREATE logicznie można podzielić na dwie części:
Pierwsza część zaczyna się od AS i kończy przed klauzula FOR.
W tej części zawierają informacje specyficzne dla protokołu transportu, jak protokół TCP lub HTTP i ustawić numeru portu nasłuchiwania dla punktu końcowego, a także jako metoda uwierzytelnianie, punkt końcowy lub lista IP adresów (jeśli istnieje) chcesz ograniczyć dostęp do punktu końcowego.
Druga część rozpoczyna się od klauzulę FOR.
Ta część służy do określania ładunek, który jest obsługiwany dla punktu końcowego.Ładunek może być jednym z wielu obsługiwanych typów: Protokół SOAP Transact-SQL, usługa brokera, bazy danych dublowanie. W tej części można także dodać informacje specyficzne dla danego języka.Na przykład korzystając z protokołu SOAP protokołu HTTP, należy zidentyfikować procedury, którą chcesz udostępnić w punkcie końcowym jako metody sieci Web.Dla każdej metody sieci Web należy określić odpowiadającego SQL Server procedura przechowywana lub funkcja zdefiniowanej przez użytkownika, który mapuje. Aplikacja klient mogą następnie wysyłać żądania HTTP SOAP, wywoływać te metody w punkcie końcowym.Można również dołączyć dodatkowe informacje o konfiguracja protokołu SOAP, takie jak:
Czy zezwalać na ad hoc kwerendy żądania
Czy należy wyznaczyć schematu XSD dla zestaw wyników
Kontekst bazy danych, wykonywania metod wymagane
Obszar nazw dla punktu końcowego
Jak obsługiwać znaków w wyniku, które nie są prawidłowe w formacie XML
Uwaga
W SQL Server 2008Usługi sieci Web XML macierzystym (punkty końcowe SOAP/HTTP) została zaniechana. Aby uzyskać więcej informacji zobacz Macierzysty usług XML sieci Web: Zastąpiona w programie SQL Server 2008.
.gif "Topic link icon")
CREATE ENDPOINT endPointName [ AUTHORIZATION login ]
[ STATE = { STARTED | STOPPED | DISABLED } ]
AS { HTTP | TCP } (
<protocol_specific_arguments>
)
FOR { SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
<language_specific_arguments>
)
<AS HTTP_protocol_specific_arguments> ::=
AS HTTP (
PATH = 'url'
, AUTHENTICATION = ( { BASIC | DIGEST | INTEGRATED | NTLM | KERBEROS } [ ,...n ] )
, PORTS = ( { CLEAR | SSL} [ ,... n ] )
[ SITE = {'*' | '+' | 'webSite' },]
[ [ , ] CLEAR_PORT = clearPort ]
[ [ , ] SSL_PORT = SSLPort ]
[ [ , ] AUTH_REALM = { 'realm' | NONE } ]
[ [ , ] DEFAULT_LOGON_DOMAIN = { 'domain' | NONE } ]
[ [ , ] COMPRESSION = { ENABLED | DISABLED } ]
)
<AS TCP_protocol_specific_arguments> ::=
AS TCP (
LISTENER_PORT = listenerPort
[ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]
)
<FOR SOAP_language_specific_arguments> ::=
FOR SOAP(
[ { WEBMETHOD [ 'namespace' .] 'method_alias'
( NAME = 'database.schema.name'
[ [ , ] SCHEMA = { NONE | STANDARD | DEFAULT } ]
[ [ , ] FORMAT = { ALL_RESULTS | ROWSETS_ONLY | NONE } ]
)
} [ ,...n ] ]
[ [ , ] BATCHES = { ENABLED | DISABLED } ]
[ [ , ] WSDL = { NONE | DEFAULT | 'sp_name' } ]
[ [ , ] SESSIONS = { ENABLED | DISABLED } ]
[ [ , ] LOGIN_TYPE = { MIXED | WINDOWS } ]
[ [ , ] SESSION_TIMEOUT = timeoutInterval | NEVER ]
[ [ , ] DATABASE = { 'database_name' | DEFAULT }
[ [ , ] NAMESPACE = { 'namespace' | DEFAULT } ]
[ [ , ] SCHEMA = { NONE | STANDARD } ]
[ [ , ] CHARACTER_SET = { SQL | XML } ]
[ [ , ] HEADER_LIMIT = int ])<FOR SERVICE_BROKER_language_specific_arguments> ::=FOR SERVICE_BROKER ( [ AUTHENTICATION = { WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] | CERTIFICATE certificate_name | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] } ] [ [ , ] ENCRYPTION = { DISABLED | { { SUPPORTED | REQUIRED } [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] } ] [ [ , ] MESSAGE_FORWARDING = { ENABLED | DISABLED } ] [ [ , ] MESSAGE_FORWARD_SIZE = forward_size ])<FOR DATABASE_MIRRORING_language_specific_arguments> ::=
FOR DATABASE_MIRRORING (
[ AUTHENTICATION = {
WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
| CERTIFICATE certificate_name
| WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name
| CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
[ [ [ , ] ] ENCRYPTION = { DISABLED | { { SUPPORTED | REQUIRED }
[ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] }
]
[ , ] ROLE = { WITNESS | PARTNER | ALL }
)
Argumenty
endPointName
Jest to nazwa przypisanego dla punktu końcowego, podczas tworzenia.Stosowane, gdy aktualizacja lub usunięcie punktu końcowego.autoryzacja login
Określa prawidłowy SQL Server lub identyfikatora logowania systemu Windows, przypisane prawo własności obiektu nowo utworzonego punktu końcowego. Jeśli autoryzacja nie zostanie określony, domyślnie rozmówcy staje się właścicielem nowo utworzony obiekt.Przypisać własność przez określenie autoryzacja, obiekt wywołujący musi mieć uprawnienie do PERSONIFIKACJI na określonym login.
Aby ponownie przypisać własność, zobacz ALTER ENDPOINT (Transact-SQL).
STATE**=** {URUCHOMIONY | ZATRZYMANE | DISABLED}
Jest to stan punktu końcowego, podczas jego tworzenia.Stan nie jest określony, po utworzeniu punktu końcowego, ustawieniem domyślnym jest zatrzymano.ROZPOCZĘTO
Punkt końcowy jest uruchomiona i aktywnie nasłuchuje połączeń.WYŁĄCZONE
Punkt końcowy jest wyłączona.W tym stanie z serwerem nie słuchać port punktu końcowego lub odpowiedzieć na wszystkie żądania próby używania punktu końcowego.ZATRZYMANE
Punkt końcowy jest zablokowany.W tym trybie serwer nasłuchuje na porcie żądania, ale zwraca błędy do klientów.
Aby zmienić stan, należy użyć ALTER ENDPOINT (Transact-SQL).
CO {HTTP | TCP}
Określa protokół transportu ma być używany.DLA {SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING}
Określa typ ładunku.Obecnie brak nie Transact-SQL argumenty specyficzne dla języka przekazywane w <language_specific_arguments> parametr.
W SQL Server 2008Usługi sieci Web XML macierzystym (punkty końcowe SOAP/HTTP) została zaniechana. Aby uzyskać więcej informacji zobacz Macierzysty usług XML sieci Web: Zastąpiona w programie SQL Server 2008.
Opcja protokół HTTP
Poniżej dotyczą tylko opcja protokół HTTP.
ścieżka = "url'
Ścieżka adresu URL, który identyfikuje lokalizację punktu końcowego na komputerze hosta określonego w argumencie SITE.ścieżka jest logicznego partycjonowanie nazw adresów URL, który jest używany przez odbiornik rozsyłanie żądań odpowiednio.ścieżka musi być częścią adresu URL, pod którym klient używa do wysyłania żądań protokołu HTTP SOAP z wystąpienie programu SQL Server.Na przykład w adresie URL https://ServerName/Sql, Nazwa_serwera pełni rolę hosta określonego przez SITE i / SQL jest adres URL określony przez ścieżka.uwierzytelnianie = ( {PODSTAWOWE | SZYFROWANE | NTLM | KERBEROS | ZINTEGROWANEGO} ,...n ] )
Określa typ uwierzytelnianie, które używane do uwierzytelnianie użytkowników, którzy logują się do wystąpienie SQL Server. Można określić podstawowy, SZYFROWANIE, NTLM, KERBEROS i układy lub kombinacji tych wartości oddzielone przecinkami),).Aby uzyskać więcej informacji zobacz Endpoint Authentication Types.PORTS**=(** { CLEAR | SSL} [ ,... n ] )
Określa jeden lub więcej nasłuchiwania typy portów skojarzonych z punktem końcowym.CLEAR i SSL może być określony w tym samym czasie.Jeśli tylko CLEAR jest określony, przychodzące żądania muszą używać protokołu HTTP.Jeśli protokół SSL jest określony, przychodzące żądania musi być żądań Secure HTTP (https://).SITE**=** { " * ' | " + " | "webSite' } ]
Określa nazwę komputera-hosta.W przypadku pominięcia SITE gwiazdka jest wartością domyślną.Jeśli sp_reserve_http_namespace zostało wykonane, przekazywać hostpart < > SITE słowo kluczowe. Na przykład jeśli sp_reserve_http_namespace N'http: / / MyServer:80 / sql „ zostało wykonane, określ SITE = "MójSerwer" w instrukcja CREATE punktu KOŃCOWEGO.* (gwiazdka)
Oznacza, że nasłuchiwania operacji jest stosowana do wszystkich nazw hostów możliwe dla komputera, które nie są w przeciwnym razie jawnie zarezerwowane.+ (znak plus)
Oznacza, że operacji nasłuchiwania odnosi się do wszystkich nazw możliwe hosta dla komputera.webSite
Jest nazwą określonego hosta dla komputera.
[ CLEAR_PORT **=**clearPort ]
Określa numer portu wyczyszczone.Jeśli PORTS = (CLEAR), to clearPort Określa numer portu wyczyszczone. Domyślny numer portu jest 80.[ SSL_PORT**=**SSLPort ]
Określa numer portu SSL.Jeśli PORTS = (SSL), SSLPort Określa numer portu SSL. Domyślny numer portu SSL jest 443.AUTH_REALM**=** { "realm' | BRAK } ]
Jeśli uwierzytelnianie = SZYFROWANE, określa wskazówki, który zwraca do klient, który wysłał żądanie protokołu SOAP z punktem końcowym, jako część wezwania uwierzytelnianie HTTP.Wartością domyślną jest brak.DEFAULT_LOGON_DOMAIN**=** { "domain' | BRAK } ]
Jeśli uwierzytelnianie = podstawowy, określa domyślną domena logowania.Wartością domyślną jest brak.COMPRESSION**=** {ENABLED | WYŁĄCZONE } ]
Jeśli zestaw do ENABLED, SQL Server będzie honorować żądania, w którym akceptowane kodowania gzip i zwracają skompresowanych odpowiedzi. Oznacza to jeśli żądanie jest wyposażony w określanie GZIP jako prawidłowy "Akceptuj kodowania" nagłówek HTTP, serwer zwraca odpowiedź kodowania gzip.Domyślnie jest wyłączone.
Opcja protokół TCP
Następujących argumentów odnoszą się tylko do opcji protokół TCP.
LISTENER_PORT **=**listenerPort
Określa numer portu, nasłuch dla połączeń przez usługa Broker protokół TCP/IP.Zgodnie z Konwencją 4022 jest używane, ale dowolna liczba między 1024 a 32767 jest prawidłowa.LISTENER_IP = ALL | **(**4-part-ip ) | ( "ip_address_v6" )
Określa adres IP, który będzie nasłuchiwać punktu końcowego.Wartość domyślna to wszystko.Oznacza to, że odbiornik będzie akceptować połączenia na dowolny prawidłowy adres IP.Po skonfigurowaniu bazy danych dublowanie z adresem IP, zamiast (Nazwa do w pełni kwalifikowana domenaALTER DATABASE SET PARTNER = partner_IP_address lub ALTER DATABASE SET WITNESS = witness_IP_address), należy określić LISTENER_IP =IP_address zamiast LISTENER_IP=ALL Po utworzeniu dublowanie punkty końcowe.
Argumenty protokołu SOAP
Następujące argumenty są specyficzne dla opcji protokołu SOAP.
Uwaga
W SQL Server 2008Usługi sieci Web XML macierzystym (punkty końcowe SOAP/HTTP) została zaniechana. Aby uzyskać więcej informacji zobacz Macierzysty usług XML sieci Web: Zastąpiona w programie SQL Server 2008.
[ WEBMETHOD [ 'namespace' .] 'method_alias' ]
Określa metoda, dla których mogą wysyłać żądania HTTP SOAP do punktu końcowego.Każdej klauzula WEBMETHOD opisuje jedną z tych metod, jednak mogą być narażeni wielu metod dla punktu końcowego.Jeśli namespace to nie jest określona, w obszarze nazw punktu końcowego przyjęto, że.Utwórz punkt końcowy bez żadnych metod, a następnie użyj ZMIENIANIE PUNKTU KOŃCOWEGO dodawać metody do niej.
.gif "Important note")
Important Note:Używając WEBMETHOD dostępne metody, należy upewnić się że istnieją zduplikowane nazwy, gdy więcej niż jeden SQL Server Baza danych jest obsługiwana przez ten sam punkt końcowy HTTP. Aby temu zapobiec, należy rozważyć dodanie adres URL nazwa domena zarejestrowane jako części ścieżka obszaru nazw.
NAME ='database.schema.name'
Określa nazwę procedura przechowywana lub funkcja zdefiniowanej przez użytkownika, który odpowiada określonej w WEBMETHOD metoda protokołu SOAP.database**.** schema**.name musi mieć nazwę trzech części, która jest zgodna z zasadami dotyczącymi identyfikatory.Jeśli database.** schema**.**name nie istnieje, zostanie zwrócony komunikat ostrzegawczy, ale operacja DDL powiedzie się.SCHEMA**=** {NONE | STANDARDOWYCH | DOMYŚLNE}]
(Ta opcja jest klauzula WEBMETHOD.) Określa, czy wbudowanego schematu XSD zostaną zwrócone dla bieżącej metoda sieci Web w odpowiedzi protokołu SOAP.BRAK
Schematu XSD nie jest zwracana dla wyniki instrukcja SELECT wysyłane za pośrednictwem protokołu SOAP.STANDARDOWE
Schematu XSD jest zwracana dla wyniki instrukcja SELECT wysyłane za pośrednictwem protokołu SOAP.WARTOŚĆ DOMYŚLNA
Domyślnie ustawienie opcji SCHEMA punktu końcowego.
Jeżeli nie określono schematu lub opcja ta jest zestaw na domyślny, opcja SCHEMA określony dla danego punktu końcowego określa, czy schemat wynik metoda jest zwracane.
Aby wyniku kwerendę WYBIERAJĄCĄ, która korzysta z opcji XML dla schematu, należy określić opcję XMLSCHEMA kwerendy, niezależnie od ustawienia opcji SCHEMA w tym miejscu.
FORMAT**=** { ALL_RESULTS | ROWSETS_ONLY | NONE}]
Określa, czy liczba wierszy, komunikaty o błędach i ostrzeżenia są zwracane zestaw wyników.Wartość domyślna to ALL_RESULTS.ALL_RESULTS
Zwraca zestaw wyników, liczba wierszy i komunikaty o błędach i ostrzeżenia odpowiedź protokołu SOAP.ROWSETS_ONLY
Zwraca tylko zestawy wyników.Tej opcji należy używać w przypadku aplikacji klienckich używających generator klasy serwera proxy usługa programu Visual Studio 2005 w sieci Web, jeśli chcesz, aby wyniki zwracane w postaci (pojedynczego zestawu danychSystem.Data.dataset obiekt), a nie jako tablica obiektów.
BRAK
Pomija zwrotu adiustacji specyficzne dla protokołu SOAP w odpowiedzi serwera.Ta opcja może służyć jako mechanizm obsługi aplikacji, które mają procedura przechowywana, w którym odpowiedź zostaną zwrócone, jest w trybie nieprzetworzony przez serwer.Gdy opcja ta jest aktywna, aplikacja jest odpowiedzialna za zwrócenie poprawnie sformułowany kod XML.Ta funkcja może być używany do sterowania odpowiedzi różnych powodów, na przykład, może zostać wykorzystana do utworzenia procedura przechowywana, która zwróci WS-Policy.FORMAT = NONE opcja ma następujące warunki użytkowania:
Należy wprowadzić metoda, za pomocą procedura przechowywana bez parametrów wyjściowych.Funkcje zdefiniowane przez użytkownika nie są dozwolone w tym formacie odpowiedzi.
Dane wyjściowe muszą składać się z pojedynczej kolumna o nazwie albo kwerendy musi być instrukcja jednego dla kwerendy XML (wiele XML dla instrukcji nie są dozwolone z tego formatu odpowiedź.); XML_F52E2B61-18A1-11 d 1-B105-00805F49916B i typ nvarchar.
PARTIACH = {ENABLED | WYŁĄCZONE }
Określa, czy żądania SQL ad hoc są obsługiwane w punkcie końcowym.Domyślnie jest wyłączona.ENABLED umożliwia żądania kwerendy ad hoc, używające protokołu SOAP sqlbatch metoda ma być wysłany do tego punktu końcowego.
Po włączeniu instancji SQL ad hoc żądania mogą być wykonywane dla punktu końcowego, wywołując sql:sqlbatch Metoda. Metoda ta opisuje również funkcje kwerend parametrycznych, dlatego może zająć opcjonalnej listy SqlParameter elementy, które będzie opisywać metadane i wartości dla parametrów określonej kwerendy.
W kwerendzie, począwszy od nazwy parametrów znak (@) mogą być osadzone.Pasujące nazwy parametrów muszą być dostarczone; w przeciwnym razie zwracany jest błąd dla żądania.
LOGIN_TYPE = {MIXED | SYSTEM WINDOWS }
Określa SQL Server Tryb uwierzytelnianie dla punktu końcowego. Jeżeli nie określono LOGIN_TYPE, wartością domyślną jest system WINDOWS.LOGIN_TYPE można używać tylko do dalszego ograniczenia trybu uwierzytelnianie dla punktów końcowych, które są oparte na tryb uwierzytelnianie globalnego serwera, który był zaznaczony podczas wystąpienie SQL Server został zainstalowany.
MIESZANE
Umożliwia uwierzytelniania programu SQL Server lub uwierzytelnianie systemu Windows, należy użyć w celu uwierzytelniania użytkowników punktu końcowego.Jeśli określono mieszane i serwera są instalowane w trybie uwierzytelnianie Windows, zwracany jest błąd.
Gdy zestaw do mieszane, uwierzytelnianie programu SQL Server jest obsługiwana dla punktu końcowego, a punkt końcowy musi być skonfigurowany do używania portu Secure Sockets Layer (SSL).
SYSTEM WINDOWS
Dopuszcza tylko uwierzytelnianie systemu Windows ma być używana do uwierzytelniania użytkowników punktu końcowego.
WSDL = {NONE | DEFAULT | "sp_name" }
Wskazuje, czy generowania dokument WSDL jest obsługiwane dla tego punktu końcowego.Jeśli brak, odpowiedź WSDL nie jest generowane lub zwracane dla WSDL kwerendy przesyłane do punktu końcowego.Jeśli DEFAULT, domyślne WSDL odpowiedź jest generowane i zwracane dla WSDL kwerendy przesyłane do punktu końcowego.W wyjątkowych przypadkach, gdy są wykonania WSDL pomocy technicznej dla punktu końcowego, można również określić procedura przechowywana przez nazwę, która będzie zwracać zmodyfikowany dokument WSDL.SESSIONS**=** {ENABLED | WYŁĄCZONE } ]
Określa, czy wystąpienie SQL Server Umożliwia obsługę sesji. Jeśli ustawiona na ENABLED, SQL Server Umożliwia obsługę sesja, zgodnie z którą można określić wiele par wiadomości żądanie/odpowiedź protokołu SOAP w ramach jednej sesja protokołu SOAP. Domyślnie jest wyłączona.SESSION_TIMEOUT **=**timeoutInterval
Określa czas w sekundach (jako liczba całkowita), który jest dostępny, przed upływem sesja protokołu SOAP na serwerze, gdy odbiera nie dalsze żądania.Wartość domyślna to 60 sekund.Ustawienie to zastępuje wartość limitu czas określony w nagłówku sesja protokołu SOAP.Czas limitu czasu jest inicjowany po zakończeniu pracy przez serwer wysyła do klient wiadomość odpowiedzi protokołu SOAP.Limit czas upłynie, zanim kolejnego żądania protokołu SOAP z takim samym IDENTYFIKATOREM sesji określony w nagłówku, sesja zostanie zakończona na serwerze.
DATABASE**=** { "database_name" | DEFAULT}]
Określa bazę danych w ramach których wykonywana jest żądanej operacji.Jeśli database_name nie określono lub jeśli domyślny jest określony, używana jest domyślna baza danych dla logowania się.NAMESPACE**=** { "namespace" | DEFAULT}]
Określa obszar nazw dla punktu końcowego.Jeśli namespace nie określono lub jeśli określono domyślny, założonej obszar nazw jest http://tempuri.org.Po określeniu określonej metoda przy użyciu WEBMETHOD można zastąpić domyślny obszar nazw **"namespace'**namespace.SCHEMA**=** {NONE | STANDARDOWYCH}]
Określa, czy schematu XSD jest zwracany przez punkt końcowy, gdy wysyłane są wyniki protokołu SOAP.BRAK
Pomija wbudowanego schematu z odpowiedzi protokołu SOAP.STANDARDOWE
Zawiera wbudowany schemat w odpowiedzi na punkcie końcowym.
Uwaga
Wyniki SOAP do ładowania System.Data.DataSet obiektów przy użyciu programu Visual Studio 2005, schematy wbudowane są wymagane, dlatego należy określić STANDARD.
CHARACTER_SET**=** { SQL | XML } ]
Określa zachowanie, gdy wynik operacji zawiera znaki, które nie są prawidłowe w formacie XML.Wartość domyślna to XML.SQL
Koduje znaki, które są nieprawidłowe w przypadku odwołania do znaków, a następnie są zwracane w wyniku.W takim przypadek XML parser może odrzucić zwracane XML jako nieprawidłowa.XML
Koduje znaków zgodnie ze specyfikacją XML.Wszystkie znaki, które nie są dozwolone zestaw znaków XML spowoduje, że program SQL Server do wysłania do klient wystąpił błąd XML nieprawidłowy.
HEADER_LIMIT
Określa maksymalny rozmiar w bajtach, w sekcji nagłówka, które ZOSTANĄ dołączone do koperty protokołu SOAP.Jeśli nagłówki SOAP nie mieści się w tym rozmiarze, serwer generuje błąd analizy.Jeśli nie zostanie określony, przyjmowana jest wartość domyślna 8 KB (8192 bajty).
Opcje DATABASE_MIRRORING i SERVICE_BROKER
Następujące argumenty uwierzytelnianie i szyfrowanie są wspólne dla opcji SERVICE_BROKER i DATABASE_MIRRORING.
Uwaga
Dla opcji, które są specyficzne dla SERVICE_BROKER Zobacz „ Opcje z SERVICE_BROKER w dalszej części tej sekcji.Dla opcji, które są specyficzne dla DATABASE_MIRRORING Zobacz „ Opcje z DATABASE_MIRRORING w dalszej części tej sekcji.
AUTHENTICATION = <authentication_options>
Określa wymagania dotyczące uwierzytelnianie protokołu TCP/IP dla połączenia dla tego punktu końcowego.Wartość domyślna to WINDOWS.Metody uwierzytelnianie obsługiwane obejmują NTLM i Kerberos lub oba.Aby uzyskać więcej informacji na temat tych metod zobacz Endpoint Authentication Types.
Important Note:Wszystkie połączenia dublowania w wystąpieniu serwera za pomocą jednej dublowanie bazy danych punktu końcowego.Wszelkie próby ponownego tworzenia dodatkowej dublowanie bazy danych punkt końcowy nie powiedzie się.
<authentication_options> ::=
SYSTEM WINDOWS {NTLM | KERBEROS | NEGOCJOWANIE } ]
Określa, że punkt końcowy do łączenia się przy użyciu protokół uwierzytelnianie systemu Windows do uwierzytelnianie, punkty końcowe.Jest to wartość domyślna.Jeśli określisz metodę autoryzacja (NTLM lub KERBEROS), Metoda ta jest zawsze używana jako protokół uwierzytelnianie.Domyślna wartość NEGOTIATE, powoduje, że punkt końcowy ma być używany protokół negocjacji Windows wybrać NTLM lub Kerberos.
certyfikat certificate_name
Określa, że punkt końcowy do uwierzytelnienia połączenia, za pomocą certyfikat określonego przez certificate_name Aby potwierdzić tożsamość do autoryzacja. Daleko punktu końcowego musi mieć certyfikat z kluczem publicznym pasujących do klucz prywatnego określonego certyfikatu.System WINDOWS [{NTLM | KERBEROS | NEGOCJOWANIE } ] certyfikat certificate_name
Określa tego punktu końcowego jest próby nawiązania połączenia przy użyciu uwierzytelnianie systemu Windows, a jeśli, próba nie powiedzie się, aby następnie spróbuj użyć określonego certyfikat.ŚWIADECTWO certificate_name SYSTEM WINDOWS [{NTLM | KERBEROS | NEGOCJOWANIE } ]
Określa tego punktu końcowego jest próby nawiązania połączenia przy użyciu określonego certyfikat, a w przypadku, próba nie powiedzie się, aby następnie spróbować przy użyciu uwierzytelnianie systemu Windows.
szyfrowanie = {DISABLED | SUPPORTED | WYMAGANE } [ALGORYTMU { RC4 | AES | AES RC4 | RC4 AES}]
Określa, czy w procesie jest używane szyfrowanie.Wartością domyślną jest wymagane.WYŁĄCZONE
Określa, że nie są szyfrowane dane przesyłane za pośrednictwem połączenia.OBSŁUGIWANE
Określa, że dane są szyfrowane tylko wtedy, gdy przeciwległego punktu końcowego określa SUPPORTED lub wymagane.WYMAGANE
Określa, czy połączenia z tego punktu końcowego musi korzystać z szyfrowanie.Aby połączyć się z danym punktem końcowym, innego punktu końcowego musi więc szyfrowanie SUPPORTED lub wymagane.
Opcjonalnie można użyć argumentu ALGORYTMU, aby określić rodzaj szyfrowanie używany przez punkt końcowy, w następujący sposób:
RC4
Określa, że punkt końcowy musi korzystać z algorytmu RC4.Jest to wartość domyślna.AES
Określa, że punkt końcowy musi używać algorytmu AES.AES RC4
Określa, że dwa punkty końcowe będą negocjować dla szyfrowanie algorytm z danym punktem końcowym, podając preferencje algorytm AES.RC4 AES
Określa, że dwa punkty końcowe będzie negocjować dla algorytmu szyfrującego z danym punktem końcowym, podając preferencje algorytm RC4.
Uwaga
Algorytm RC4 została zaniechana.This feature will be removed in a future version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible. Zaleca się, że używasz AES.
Jeśli oba punkty końcowe określone oba algorytmy, ale w różnych zleceniach, zdobywa akceptować połączenia punktu końcowego.
Opcje SERVICE_BROKER
Opcja SERVICE_BROKER dotyczą następujące argumenty.
MESSAGE_FORWARDING = {ENABLED | WYŁĄCZONE }
Określa, czy wiadomości odebrane przez ten punkt końcowy, które są umieszczone w innym usług będą przekazywane dalej.WŁĄCZONE
Przesyła dalej komunikaty, jeśli jest dostępny adres przesyłający dalej.WYŁĄCZONE
Odrzuca wiadomości dla usługi znajdujące się w innym miejscu.Jest to wartość domyślna.
MESSAGE_FORWARD_SIZE **=**forward_size
Określa maksymalną ilość pamięci w megabajtach przydzielić dla punktu końcowego używany do przechowywania wiadomości, które mają być przekazywane.
Opcje DATABASE_MIRRORING
Następujący argument jest specyficzny dla opcji DATABASE_MIRRORING.
ROLE = {DOWÓD | partner | WSZYSTKIE}
Określa dublowanie bazy danych rolę lub role, które obsługuje punktu końcowego.DOWÓD
Włącza punkt końcowy do wykonania w roli dowód w procesie dublowanie.Uwaga
Dla SQL Server 2005 Express EditionDOWÓD jest jedyną dostępną opcją.
PARTNER
Włącza punkt końcowy do wykonania w roli partner w procesie dublowanie.ALL
Włącza punkt końcowy do wykonywania w roli świadka i partner w procesie dublowanie.
Aby uzyskać więcej informacji na temat tych ról zobacz Database Mirroring Overview.
Uwaga
DATABASE_MIRRORING tylko protokół TCP może służyć jako protokołu transportu, nie HTTP.Nie ma żadnych domyślnego portu dla DATABASE_MIRRORING.
Remarks
Nie można wykonać instrukcje DDL punktu KOŃCOWEGO wewnątrz transakcji użytkownika.Instrukcje DDL punktu KOŃCOWEGO nie przejmowane awaryjnie nawet wtedy, gdy transakcja poziom izolacji migawkę aktywnego korzysta z punktem końcowym zostanie zmieniona.
Żądania mogą być wykonywane względem punktu KOŃCOWEGO, co następuje:
Członkowie sysadmin stała rola serwera
Właściciel danego punktu końcowego
Użytkownicy lub grupy, którym przyznano CONNECT uprawnień dla punktu końcowego
Uprawnienia
Wymaga uprawnienia CREATE punktu KOŃCOWEGO lub członkostwo w grupie sysadmin ustalić roli serwera.Aby uzyskać więcej informacji zobacz GRANT Endpoint Permissions (Transact-SQL).
Przykłady
A.Tworzenie punktu końcowego do obsługi żądań protokołu SOAP
Poniższy przykład tworzy punktu końcowego o nazwie sql_endpoint, z dwóch metod: GetSqlInfo and DayAsNumber.Są to metody, dla których klient może wysyłać żądania protokołu SOAP z punktem końcowym.
Dla każdej metoda, domyślnym FORMAT Opcja jest ALL_RESULTS. Dlatego odpowiedź protokołu SOAP dla metoda żądania będzie zawierać komunikaty o błędach, ostrzeżenia i informacje rowcount.
Należy uwzględnić następujące ustawienia specyficzne dla protokołu SOAP:
The SCHEMA option is zestaw to STANDARD for the endpoint. Dlatego domyślnie, wbudowane schematy są zwracane w odpowiedzi protokołu SOAP.
The WSDL option is zestaw to DEFAULT. Dlatego jeśli klient żąda odpowiedzi WSDL z tego punktu końcowego (https://Server/sql?wsdl), serwer generuje i zwraca klientowi odpowiedź WSDL.
DROP ENDPOINT sql_endpoint;
GO
CREATE ENDPOINT sql_endpoint
STATE = STARTED
AS HTTP(
PATH = '/sql',
AUTHENTICATION = (INTEGRATED ),
PORTS = ( CLEAR ),
SITE = 'SERVER'
)
FOR SOAP (
WEBMETHOD 'GetSqlInfo'
(name='master.dbo.xp_msver',
SCHEMA=STANDARD ),
WEBMETHOD 'DayAsNumber'
(name='master.sys.fn_MSdayasnumber'),
WSDL = DEFAULT,
SCHEMA = STANDARD,
DATABASE = 'master',
NAMESPACE = 'http://tempUri.org/'
);
GO
Można wysyłać kwerendy widoku katalogu, aby znaleźć informacje na temat punktu końcowego, który został utworzony, jak pokazano w poniższych przykładach.Można także utworzyć łączyć te wykazu widoki będą pobierane dane.
Kwerendy sys.endpoints Aby pobrać wszystkie informacje o punktach końcowych w systemie. Dotyczy to wszystkich, nazwa, identyfikator punktu końcowego, identyfikator serwera głównego, który jest właścicielem danego punktu końcowego, a także inne właściwości punktu końcowego.
SELECT *
FROM sys.endpoints;
Można wysyłać kwerendy sys.http_endpoints Aby pobrać punkt końcowy szczegółowe informacje związane z protokołu HTTP, takich jak SITE, adres URL, mechanizm uwierzytelnianie i innych szczegółowych informacji HTTP.
SELECT *
FROM sys.http_endpoints;
Aby pobrać informacje specyficzne dla protokołu SOAP punktu końcowego, kwerendy sys.soap_endpoints.
SELECT *
FROM sys.soap_endpoints;
Aby pobrać metod protokołu SOAP, które są zdefiniowane dla punktu końcowego, kwerendy sys.endpoint_webmethods.
SELECT *
FROM sys.endpoint_webmethods;
B.Tworzenie dublowanie bazy danych punktu końcowego
Poniższy przykład tworzy bazę danych dublowanie punktu końcowego.Punkt końcowy korzysta z numeru portu 7022, chociaż dowolną liczbę dostępnych portów będzie działać. Punkt końcowy jest skonfigurowany do korzystania z uwierzytelnianie systemu Windows przy użyciu tylko protokołu Kerberos.The ENCRYPTION option is configured to the nondefault value of SUPPORTED to support encrypted or unencrypted data.Punkt końcowy jest konfigurowany na obsługę zarówno partner oraz obecności ról.
CREATE ENDPOINT endpoint_mirroring
STATE = STARTED
AS TCP ( LISTENER_PORT = 7022 )
FOR DATABASE_MIRRORING (
AUTHENTICATION = WINDOWS KERBEROS,
ENCRYPTION = SUPPORTED,
ROLE=ALL);
GO
C.Określanie portu
Podczas tworzenia punktem końcowym protokołu SOAP na początku systemu Windows Server z systemem Windows Server 2003, jeśli ścieżka (URL) i kombinacji port jest używany przez program IIS, punkt końcowy CREATE nie powiedzie się.
W systemie Windows XP może być konieczne do zatrzymania usług IIS dla punktów końcowych protokołu SOAP do pracy.
CREATE ENDPOINT sql_endpoint
STATE = STARTED
AS HTTP
( PATH = '/sql',
AUTHENTICATION = (INTEGRATED ),
PORTS = ( CLEAR ),
SITE = 'SERVER',
CLEAR_PORT = 2000 )
FOR SOAP
( WEBMETHOD 'GetSqlInfo' (name='master.dbo.xp_msver', SCHEMA=STANDARD ),
WEBMETHOD 'DayAsNumber' (name='master.sys.fn_MSdayasnumber'),
WSDL = DEFAULT,
SCHEMA = STANDARD,
DATABASE = 'master',
NAMESPACE = 'http://tempUri.org/' );
See Also