Udostępnij za pośrednictwem

  • Artykuł

Utwórz punkt końcowy (Transact-SQL)

Tworzy punkty końcowe i określa ich właściwości, łącznie z metodami, aby aplikacje klient .Uprawnienia pokrewne informacje, zobacz PRZYZNAĆ uprawnienia punktu końcowego (Transact-SQL).

Składnia dla utworzenia punktu KOŃCOWEGO można logicznie można podzielić na dwie części:

  • Pierwsza część zaczyna się i kończy się przed dla klauzula.

    W tej części dostarcza informacji specyficznych dla transportu protokół TCP lub HTTP i zestaw numer portu nasłuchiwania dla punktu końcowego, jak również metoda punktu końcowego uwierzytelnianie i/lub listy IP adresów (jeśli ma zastosowanie) chcesz ograniczyć dostęp do punktu końcowego.

  • Druga część zaczyna się do klauzula.

    W tej części Zdefiniuj ładunek, który jest obsługiwany w punkcie końcowym.Ładunek może być jednym z kilku obsługiwanych typów: MYDŁA, Transact-SQL, usługa broker, dublowanie bazy danych.W tej części również zawierać informacje specyficzne dla języka.Na przykład korzystając z protokołu HTTP SOAP, określenie procedur, które chcesz udostępnić w punkcie końcowym jako metody sieci Web.Dla każdej metody sieci Web można zidentyfikować, odpowiadającego SQL Server procedura składowana lub zdefiniowanej przez użytkownika funkcja które mapuje.Aplikacja klient mogą następnie wysyłać żądań HTTP SOAP, że wywołania tych metod w punkcie końcowym.Można również dołączyć dodatkowe informacje o konfiguracja protokołu SOAP, takie jak:

    • Czy zezwalać na ad hoc kwerend żądania

    • Czy należy wyznaczyć schematu XSD, zestaw wyników

    • Wykonywania metod żądanie kontekstu bazy danych

    • Obszar nazw dla punktu końcowego

    • Jak obsługiwać znaków w wyniku, które nie są prawidłowe w formacie XML

Ostrzeżenie

Macierzysty usług XML sieci Web (punkty końcowe SOAP i HTTP) jest niezalecane.Aby uzyskać więcej informacji, zobacz Macierzysty usług XML sieci Web: Zaniechane w programie SQL Server 2008.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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 przypisaną nazwę tworzonego punktu końcowego.Użyj podczas aktualizowania lub usuwania punktu końcowego.

  • AUTORYZACJAlogin
    Określa prawidłową SQL Server lub identyfikatora logowania systemu Windows przypisany własność obiektu nowo utworzony punkt końcowy.Jeżeli pozwolenie nie jest określony, domyślnie rozmówcy staje się właścicielem nowo utworzonego obiektu.

    Określając autoryzacji, należy przypisać własność, obiekt wywołujący musi mieć uprawnienia PERSONIFIKUJ na określonym login.

    Aby ponownie przypisać własność, zobacz ZMIEŃ punkt końcowy (Transact-SQL).

  • Państwo = {uruchomiono | STOPPED | WYŁĄCZONE}
    Jest to stan punktu końcowego, podczas jego tworzenia.Stan nie jest określony, po utworzeniu punktu końcowego, domyślnym jest ZATRZYMANA.

    • ROZPOCZĘTE
      Punkt końcowy jest uruchomiona i aktywnie nasłuchuje połączeń.

    • WYŁĄCZONE
      Punkt końcowy jest wyłączona.W tym stanie serwer nasłuchuje żądań portu, ale zwraca błędy do klientów.

    • ZATRZYMANE
      Punkt końcowy jest zatrzymana.W tym stanie serwer słuchać port punktu końcowego lub nie odpowiadają na wszelkie próby żądania używać punktu końcowego.

    Aby zmienić stan, należy użyć ZMIEŃ punkt końcowy (Transact-SQL).

  • JAKO {HTTP | TCP}
    Określa używany transportu protokół .

  • DLA {SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING}
    Określa typ ładunku.

    Obecnie nie Transact-SQL argumenty specyficzne dla języka przekazywane w <language_specific_arguments> parametru.

    Macierzysty usług XML sieci Web (punkty końcowe SOAP i HTTP) jest niezalecane.Aby uzyskać więcej informacji, zobacz Macierzysty usług XML sieci Web: Zaniechane w programie SQL Server 2008.

Opcja protokołu HTTP

Poniżej dotyczą tylko opcja protokół HTTP.

  • ŚCIEŻKA = 'url"
    Określa adres URL ścieżka , która identyfikuje lokalizację punktu końcowego na komputerze hosta określonego w argumencie witryny.ŚCIEŻKA jest logicznego partycjonowanie obszaru nazw URL używany przez odbiornik trasa żądań odpowiednio.ŚCIEŻKA musi być częścią adresu URL, który klient używa do wysyłania żądań HTTP SOAP na wystąpienie SQL Server.Na przykład w adresie URL https://ServerName/Sql, nazwa_serwera jest komputer hosta określony przez WITRYNĘ i /Sql jest adresem URL określonym przez ŚCIEŻKĘ.

  • UWIERZYTELNIANIE = ( {BASIC | SZYFROWANE | NTLM | KERBEROS | ZINTEGROWANE} [ ,...n ] )
    Określa typ uwierzytelnianie , które używane do uwierzytelniania użytkowników logujących się do wystąpienie SQL Server.Można określić BASIC, DIGEST, NTLM, KERBEROS i ZINTEGROWANE lub kombinacji tych wartości oddzielone przecinkami (,).Aby uzyskać więcej informacji, zobacz Typy uwierzytelniania końcowy.

  • PORTS**=(** { CLEAR | SSL} [ ,... n ] )
    Określa jeden lub więcej nasłuchiwania typy portów skojarzonych z punktem końcowym.Wyczyść i SSL może być określony w tym samym czas.Jeśli tylko określono wyczyść przychodzące żądania należy użyć protokołu HTTP.Jeśli SSL jest określony, przychodzące żądania musi być żądań Secure HTTP (https://).

  • [ SITE = { ' * ' | ' + ' | 'webSite' } ]
    Określa nazwę komputera hosta.Jeśli witryna jest pominięty, gwiazdka jest domyślnie.Jeśli sp_reserve_http_namespace została wykonana, przekazać <hostpart> do słowa kluczowego witryny.Na przykład jeśli sp_reserve_http_namespace N'http: / / MyServer:80 / sql' wykonano określić WITRYNĘ = "MójSerwer" w tworzenie punktu KOŃCOWEGO instrukcja.

    • * (gwiazdka)
      Oznacza, że operacja nasłuchiwania stosuje się do wszystkich nazw możliwe hosta dla komputera, niezarezerwowane inaczej wyraźnie.

    • + (znak plus)
      Oznacza, że operacja nasłuchiwania stosuje się do wszystkich nazw możliwe hosta dla komputera.

    • webSite
      Jest nazwą określonego hosta dla komputera.

  • [ CLEAR_PORT **=**clearPort ]
    Określa numer portu Wyczyść.Jeśli porty = (Wyczyść), to clearPort Określa numer portu Wyczyść.Domyślny numer portu jest 80.

  • [ SSL_PORT**=**SSLPort ]
    Określa numer portu SSL .Jeśli porty = (SSL), SSLPort Określa numer portu SSL .Domyślnym numerem portu SSL jest 443.

  • [ AUTH_REALM = { 'realm' | NONE } ]
    Jeśli uwierzytelnianie = SZYFROWANEGO, określa wskazówkę, która zwraca do klient, który wysłał żądanie protokołu SOAP do punktu końcowego, jako część challenge uwierzytelnianie HTTP.Wartością domyślną jest brak.

  • [ DEFAULT_LOGON_DOMAIN = { 'domain" | NONE } ]
    Jeśli uwierzytelnianie = podstawowa, określa domyślną logowania w domena.Wartością domyślną jest brak.

  • [ KOMPRESJA = {ENABLED | Wyłączone }]
    Jeśli zestaw na włączone, SQL Server będzie honorować żądania, gdzie kodowania gzip jest akceptowana i zwracają skompresowanych odpowiedzi.Oznacza to, że gdy nadejdzie żądanie z nagłówka HTTP, określając GZIP jako prawidłowy "akceptowania kodowania", serwer zwraca odpowiedź formacie gzip.Jest domyślnie wyłączona.

Opcja protokołu TCP

Następujące argumenty dotyczą tylko opcji protokół TCP.

  • LISTENER_PORT **=**listenerPort
    Określa, że numer portu słuchamy dla połączeń przez usługa broker protokółTCP/IP.Umownie 4022 jest używana ale dowolna liczba między 1024 i 32767 jest prawidłowa.

  • LISTENER_IP = wszystkie | **(**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.

    Jeśli możesz skonfigurować dublowanie bazy danych z adresem IP zamiast nazwy pełni kwalifikowaną domena (ALTER 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 podczas tworzenia dublowanie punkty końcowe.

Argumenty SOAP

Następujące argumenty są specyficzne dla opcji protokołu SOAP.

Ostrzeżenie

Macierzysty usług XML sieci Web (punkty końcowe SOAP i HTTP) jest niezalecane.Aby uzyskać więcej informacji, zobacz Macierzysty usług XML sieci Web: Zaniechane w programie SQL Server 2008.

  • [ WEBMETHOD 'namespace" .] 'method_alias' ]
    Określa metoda , której mogą wysyłać żądania HTTP SOAP do punktu końcowego.Każdej WEBMETHOD klauzula opisano metoda; Jednakże mogą być narażeni wiele metod dla punktu końcowego.Jeśli namespace jest nie określono obszaru nazw punktu końcowego zakłada, że.

    Utwórz punkt końcowy bez żadnych metod, a następnie użyj Zmienić punkt końcowy do dodania do niego metody.

    Ważna informacjaWażne:

    Gdy narazić metody za pomocą WEBMETHOD musi zapewnić ma zduplikowanych nazw, gdy więcej niż jeden SQL Server bazy danych jest obsługiwany przez ten sam punkt końcowy HTTP.Aby temu zapobiec, należy rozważyć dodanie adres URL nazwy domena zarejestrowane jako część obszaru nazw ścieżka.

  • NAME ='database.schema.name"
    Określa nazwę procedura składowana lub zdefiniowanej przez użytkownika funkcja odpowiadający określonej w WEBMETHOD SOAP metoda .database**.schema.name musi być nazwą trzech części, która jest zgodna z zasadami identyfikatorów.If database.schema.**name nie istnieje, zwracany jest komunikat ostrzegawczy, ale operacja DDL powiedzie się.

  • [ SCHEMAT = {Brak | STANDARDOWE | DOMYŚLNIE}]
    (Ta opcja jest WEBMETHOD klauzula.) Określa, czy wbudowanego schematu XSD zostaną zwrócone dla bieżącej sieci Web metoda w odpowiedzi protokołu SOAP.

    • BRAK
      Schematu XSD nie jest zwracana dla instrukcjaSELECTwyniki wysyłane za pośrednictwem protokołu SOAP.

    • STANDARD
      Schematu XSD jest zwracana dla instrukcjaSELECTwyniki wysyłane za pośrednictwem protokołu SOAP.

    • DOMYŚLNE
      Domyślne ustawienie opcji SCHEMATU punktu końcowego.

    Jeśli nie określono schematu lub opcja ta jest zestaw domyślnie, opcja schemat określony dla punktu końcowego określa, czy schemat wynik metoda jest zwracane.

    Pobrać wyników kwerendy WYBIERAJĄCEJ, która używa opcji XML dla schematu, należy określić opcję schematu XML w programie Microsoft query, niezależnie od ustawienia opcji SCHEMATU w tym miejscu.

  • [ FORMAT = { ALL_RESULTS | ROWSETS_ONLY | BRAK}]
    Określa, czy liczba wierszy, komunikaty o błędach i ostrzeżenia są zwracane z zestaw wyników.Wartość domyślna to ALL_RESULTS.

    • ALL_RESULTS
      Zwraca odpowiedź protokołu SOAP zestaw wyników, liczba wierszy i komunikaty o błędach i ostrzeżenia.

    • ROWSETS_ONLY
      Zwraca tylko zestawy wyników.

      Użyj tej opcji z aplikacje klient używające programu Visual Studio 2005 w sieci Web usługa proxy klasy generator, jeśli chcesz, aby wyniki są zwracane jako pojedynczego zestawu danych (System.Data.Dataset obiektu), a nie jako tablica obiektów.

    • BRAK
      Pomija zwrotu adiustacje określonego protokołu SOAP w odpowiedzi z serwera.

      Ta opcja może służyć jako mechanizm obsługi aplikacji, które mają procedura składowana , w którym odpowiedź będzie zwracana jest w trybie nieprzetworzonym przez serwer.Gdy ta opcja jest włączone, aplikacja jest odpowiedzialny za zwrócenie poprawnie sformułowany kod XML.Ta funkcja służy do kontrolowania odpowiedź z kilku powodów, na przykład, może być używane do tworzenia zwróciłby WS-Policy procedura składowana .FORMAT = Brak opcji ma następujące warunki używania:

      • metoda muszą być zaimplementowane przy użyciu procedura składowana bez parametrów wyjściowych.Funkcje zdefiniowane przez użytkownika nie są dozwolone w tym formacie odpowiedź.

        Każda kwerenda musi być jedno -instrukcja kwerendy FOR XML (instrukcje wielu dla XML nie są dozwolone w tym formacie odpowiedź.); lub dane wyjściowe muszą składać się z pojedynczej kolumna o nazwie XML_F52E2B61-18A1-11 d 1-B105-00805F49916B i typu nvarchar.

  • PARTIE = {ENABLED | Wyłączone }
    Określa, czy wnioski składane ad hoc SQL są obsługiwane dla punktu końcowego.Jest domyślnie wyłączona.

    WŁĄCZONE akceptować żądania protokołu SOAP kwerend ad hoc, które korzystają z sqlbatch metoda ma być wysłany do tego punktu końcowego.

    Włączenie instancje ad hoc SQL żądania mogą być wykonywane dla punktu końcowego, wywołując sql:sqlbatch metoda.Ta metoda udostępnia również funkcje kwerend parametrycznych; w związku z tym, można wykonać opcjonalna lista SqlParameter elementy, które będą opisują metadane i wartości parametrów określonej kwerendy.

    W ciągu kwerendy nazw parametrów, począwszy od znaku (@) mogą być osadzone.Pasujące nazwy parametrów muszą być dostarczone; w przeciwnym razie zwracany jest błąd, wniosek.

  • LOGIN_TYPE = {mieszane | WINDOWS }
    Określa SQL Server trybu uwierzytelniania dla punktu końcowego.Jeśli LOGIN_TYPE nie jest określony, domyślnie jest system WINDOWS.

    LOGIN_TYPE należy używać tylko do dalszego ograniczenia trybu uwierzytelnianie dla punktów końcowych, które oparte są na tryb globalny uwierzytelnianie serwera, który został wybrany, gdy wystąpienie SQL Server został zainstalowany.

    • MIESZANE
      Umożliwia uwierzytelnianie serwera SQL lub uwierzytelnianie systemu Windows, ma być używany do uwierzytelniania użytkowników końcowych.

      Jeśli określono mieszane i serwer jest zainstalowany w trybie uwierzytelniania Windows, zwracany jest błąd.

      Gdy zestaw mieszane, uwierzytelniania SQL Server jest obsługiwany dla punktu końcowego i punktu końcowego musi być skonfigurowany do używania portu Secure Sockets Layer (SSL).

    • SYSTEM WINDOWS
      Umożliwia tylko uwierzytelnianie systemu Windows ma być używany do uwierzytelniania użytkowników końcowych.

  • WSDL = { NONE | DOMYŚLNE | 'sp_name' }
    Wskazuje, czy WSDL Generowanie dokumentu jest obsługiwana dla tego punktu końcowego.Jeśli brak, odpowiedź WSDL nie jest generowany lub zwracane dla kwerend WSDL przedłożone do punktu końcowego.Jeśli ustawienie domyślne, domyślne WSDL odpowiedź jest generowane i zwracane dla kwerend WSDL przedłożone do punktu końcowego.W wyjątkowych przypadkach, w których są wykonania pomocy technicznej WSDL dla punktu końcowego, można również określić procedura składowana przez nazwę, która będzie zwracać zmodyfikowany dokument WSDL.

  • [ SESJE = {ENABLED | Wyłączone }]
    Określa, czy wystąpienie SQL Server umożliwia obsługę sesji.Jeśli zestaw na włączone, SQL Server umożliwia obsługuje sesje, według którego wiele par komunikat żądanie i odpowiedź SOAP mogą być zidentyfikowane jako część jednej sesjaprotokołu SOAP.Jest domyślnie wyłączona.

  • SESSION_TIMEOUT **=**timeoutInterval
    Określa czas w sekundach (jako liczba całkowita), które jest dostępne, przed upływem SOAP sesja na serwerze, gdy nie są odebrane żadne dalsze żądania.Wartość domyślna to 60 sekund.Ustawienie to zastępuje czas-out wartość określoną w nagłówku SOAP sesja .

    czas- czas jest inicjowana, gdy serwer kończy wysyłanie do klientkomunikat odpowiedzi protokołu SOAP.Jeśli czas-limit komputera przed kolejnego żądania protokołu SOAP z tej samej sesja ID określoną w nagłówku, zakończenie sesja na serwerze.

  • [ DATABASE = { 'database_name' | DOMYŚLNIE}]
    Określa bazę danych w kontekście którego Żądana operacja jest wykonywana.Jeśli database_name nie została określona lub jeśli określono domyślny domyślna baza danych dla logowania jest używany.

  • [ NAMESPACE = { 'namespace' | DOMYŚLNIE}]
    Określa obszar nazw dla punktu końcowego.Jeśli namespace nie została określona lub jeśli określono domyślny zakładanej obszar nazw jest http://tempuri.org.Można zastąpić domyślny obszar nazw, gdy zostanie określona przy użyciu WEBMETHOD określonej metoda **'namespace"**namespace.

  • [ SCHEMAT = {Brak | STANDARD}]
    Określa, czy schematu XSD jest zwracane przez punkt końcowy, kiedy SOAP wyniki są wysyłane.

    • BRAK
      Pomija wbudowany schemat z odpowiedzi protokołu SOAP.

    • STANDARD
      Zawiera wbudowany schemat w odpowiedzi na punkt końcowy.

    Ostrzeżenie

    Ładowania SOAP wyniki w System.Data.DataSet obiektów podczas korzystania z Visual Studio 2005, schematy wbudowane są wymagane; w związku z tym 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 znaków, które są nieprawidłowe jako znak odniesienia, a następnie zwraca w wyniku.W tym przypadekXML parser może odrzucić zwrócone XML jako nieprawidłowa.

    • XML
      Koduje znaki w specyfikacji XML.Wszystkie znaki, które nie są dozwolone w znaków XML, zestaw spowoduje wysłanie do klientnieprawidłowy błąd XML w SQL Server.

  • HEADER_LIMIT
    Określa maksymalny rozmiar w bajtach sekcji nagłówka w kopercie protokołu SOAP.Jeśli nagłówki SOAP nie dopasowanie w tym rozmiarze, serwer generuje błąd analizy.Jeśli nie jest określony, przyjmowana jest wartość domyślną 8 KB (8192 bajty).

Opcje DATABASE_MIRRORING i SERVICE_BROKER

Następujące argumenty uwierzytelniania i szyfrowania są wspólne dla opcji SERVICE_BROKER i DATABASE_MIRRORING.

Ostrzeżenie

Dla opcji, które są specyficzne dla SERVICE_BROKER zobacz "Opcje SERVICE_BROKER" w dalszej części tej sekcji.Dla opcji, które są specyficzne dla DATABASE_MIRRORING zobacz "Opcje DATABASE_MIRRORING" w dalszej części tej sekcji.

  • UWIERZYTELNIANIE = <authentication_options>
    Określa wymagania dotyczące uwierzytelnianie protokołu TCP/IP dla połączenia dla tego punktu końcowego.Wartość domyślna to systemu WINDOWS.

    Metody uwierzytelnianie obsługiwanych obejmują NTLM i Kerberos lub oba.Aby uzyskać więcej informacji na temat tych metod, zobacz Typy uwierzytelniania końcowy.

    Ważna informacjaWażne:

    Wszystkie połączenia dublowanie w wystąpienie serwera za pomocą pojedynczego, dublowanie bazy danych punktu końcowego.Każda próba utworzyć dodatkowe dublowanie bazy danych punkt końcowy nie powiedzie się.

    <authentication_options> :: =

    • WINDOWS {NTLM | KERBEROS | NEGOTIATE }]
      Określa, że punkt końcowy do połączenia za pomocą uwierzytelniania systemu Windows protokół uwierzytelniania, punkty końcowe.Jest to wartość domyślna.

      Jeśli określisz autoryzacjametoda (NTLM lub KERBEROS) tej metoda jest zawsze używany jakoprotokół uwierzytelnianie. Wartość domyślna NEGOCJOWANIE, powoduje, że punkt końcowy do za pomocą systemu Windows negocjacji protokół NTLM lub Kerberos.

    • CERTYFIKATcertificate_name
      Określa, że punkt końcowy do uwierzytelnienia połączenia przy użyciu certyfikat określonego przez certificate_name do ustalenia tożsamości autoryzacja.Daleko punktu końcowego musi mieć certyfikat z publicznego klucz pasujących do prywatnego klucz określonego certyfikat.

    • SYSTEM WINDOWS [{NTLM | KERBEROS | NEGOTIATE }] certyfikatu certificate_name
      Określa, że próba połączenia przy użyciu uwierzytelniania systemu Windows i jeśli, próba nie powiedzie się, aby następnie spróbuj użyć określonego certyfikattego punktu końcowego.

    • CERTYFIKAT certificate_name systemu WINDOWS [{NTLM | KERBEROS | NEGOTIATE } ]
      Określa, że ten punkt końcowy jest próba połączenia przy użyciu określonego certyfikat , a jeśli, próba nie powiedzie się, aby następnie spróbuj użyć uwierzytelniania systemu Windows.

  • SZYFROWANIE = {WYŁĄCZONE | OBSŁUGIWANE | Wymagane } [ALGORYTM { 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, czy dane przesyłane przez połączenie nie jest zaszyfrowany.

    • OBSŁUGIWANE
      Określa, że dane są szyfrowane tylko wtedy, gdy przeciwległego punktu końcowego określa obsługiwane lub wymagane.

    • WYMAGANE
      Określa, że połączenia tego punktu końcowego musi korzystać z szyfrowanie.Aby połączyć się z tym punktem końcowym, innego punktu końcowego musi więc szyfrowania zestaw obsługiwane lub wymagane.

    Opcjonalnie można użyć argumentu ALGORYTMU, aby określić formularz szyfrowanie używany przez punkt końcowy, w następujący sposób:

    • RC4
      Określa, że punkt końcowy, należy użyć algorytmu RC4.Jest to wartość domyślna.

    • AES
      Określa, że punkt końcowy musi używać algorytm AES.

    • AES RC4
      Określa, że dwa punkty końcowe będzie negocjować dla algorytmu szyfrowanie z danym punktem końcowym preferowanie algorytm AES.

    • RC4 AES
      Określa, że dwa punkty końcowe będzie negocjować dla algorytmu szyfrowanie z danym punktem końcowym preferowanie algorytm RC4.

    Ostrzeżenie

    Algorytm RC4 jest niezalecane.Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Nie należy stosować tej funkcji w nowych projektach oraz jak najszybciej należy zmodyfikować aplikacje, w których obecnie jest używana ta funkcja.Zaleca się, aby użyć AES.

    Jeśli oba punkty końcowe określić oba algorytmy, ale w różnych zleceniach, akceptować połączenia punktu końcowego usługi wins.

Opcje SERVICE_BROKER

Następujące argumenty są specyficzne dla opcji SERVICE_BROKER.

  • MESSAGE_FORWARDING = {ENABLED | Wyłączone }
    Określa, czy zostaną przesłane dalej wiadomości odebrane przez ten punkt końcowy, które są dla usług zlokalizowanych w innym miejscu.

    • WŁĄCZONE
      Przesyła dalej wiadomości, jeśli jest dostępny adres przesyłania dalej.

    • WYŁĄCZONE
      Odrzuca komunikaty usługi zlokalizowanych w innym miejscu.Jest to wartość domyślna.

  • MESSAGE_FORWARD_SIZE **=**forward_size
    Określa maksymalną ilość miejsca w megabajtach, aby przydzielić dla punktu końcowego, używana przy zapisywaniu wiadomości, które są przekazywane.

Opcje DATABASE_MIRRORING

Następujący argument jest specyficzny dla opcji DATABASE_MIRRORING.

  • Rola = {ŚWIADKA | PARTNER | {ALL}
    Określa dublowanie bazy danych rolę lub role, które obsługuje punktu końcowego.

    • MONITOR
      Włącza punkt końcowy do wykonywania w roli świadka w procesie dublowanie .

      Ostrzeżenie

      Dla SQL Server 2005 Express Edition, dowód jest jedyną dostępną opcją.

    • PARTNER
      Włącza punkt końcowy do wykonywania 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 dotyczących tych ról, zobacz Omówienie dublowania bazy danych.

Ostrzeżenie

DATABASE_MIRRORING tylko protokół TCP może służyć jako transportu protokółHTTP nie.Nie ma żadnego domyślnego portu dla DATABASE_MIRRORING.

Uwagi

Nie można wykonać instrukcje DDL punktu KOŃCOWEGO wewnątrz transakcji użytkownika.Instrukcje DDL punkt końcowy nie powiedzie się, nawet jeśli transakcjipoziom izolacji migawkaaktywnego korzysta z punktem końcowym przeliczana.

Żądania mogą być wykonywane przed punktem KOŃCOWYM co następuje:

  • Członkowie sysadmin stała rola serwera

  • Właściciel punkt końcowy

  • Użytkowników lub grup, które zostały przyznane uprawnienia dla punktu końcowego połączenia

Uprawnienia

Wymaga uprawnień do utworzenia punktu KOŃCOWEGO lub członkostwa w sysadmin stała rola serwera.Aby uzyskać więcej informacji, zobacz PRZYZNAĆ uprawnienia punktu końcowego (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 dwiema metodami: GetSqlInfo and DayAsNumber.Są to metody, dla których klient może wysłać żądania protokołu SOAP do punktu końcowego.

Dla każdej metoda, domyślny dla FORMAT jest opcja 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:

  • SCHEMA Opcja jest zestaw na STANDARD dla punktu końcowego.Dlatego domyślnie schematy wbudowane są zwracane w odpowiedzi protokołu SOAP.

  • WSDL Opcja jest zestaw na DEFAULT.Dlatego jeśli klient żąda odpowiedzi WSDL z tego punktu końcowego (https://Server/sql?wsdl), serwer generuje i zwraca do klientodpowiedź 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 wykazu, aby znaleźć informacje dotyczące punktu końcowego, który został utworzony, jak pokazano w poniższych przykładach.Można także utworzyć łączyć te widoki wykazu , pobrać żądane dane.

Kwerenda sys.endpoints , aby pobrać wszystkie informacje o punktach końcowych w systemie.Obejmuje to, nazwa, identyfikator punktu końcowego, identyfikator serwera głównego, który jest właścicielem punktu końcowego i inne właściwości punktu końcowego.

SELECT *
FROM sys.endpoints;

Kwerendy można sys.http_endpoints do pobierania końcowy szczegółowe informacje odnoszące się do protokołu HTTP, takich jak witryny, adres URL, mechanizm uwierzytelniania i inne HTTP określonych informacji.

SELECT *
FROM sys.http_endpoints;

Aby pobrać informacje specyficzne dla protokołu SOAP punktu końcowego, kwerenda sys.soap_endpoints.

SELECT * 
FROM sys.soap_endpoints;

Kwerendy do pobierania metody SOAP, które są zdefiniowane dla punktu końcowego, sys.endpoint_webmethods.

SELECT *
FROM sys.endpoint_webmethods;

B.Tworzenie punktu końcowego dublowanie bazy danych

Poniższy przykład tworzy punkt końcowy dublowanie bazy danych .Punkt końcowy używa numeru portu 7022, chociaż dowolną liczbę dostępnych portów czy działa.Punkt końcowy jest skonfigurowany do korzystania z uwierzytelniania systemu Windows przy użyciu tylko protokołu Kerberos.ENCRYPTION Opcja jest skonfigurowana do wartości niedomyślnych SUPPORTED do obsługi danych zaszyfrowany lub nie.Punkt końcowy jest konfigurowany do obsługi partner i świadka 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 punktu końcowego SOAP na początku systemu Windows Server, Windows Server 2003, jeśli ścieżka (URL) i kombinacji port jest używany przez usługi IIS, Utwórz punkt końcowy 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/' );