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

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.

• [ 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ż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.

• 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ż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.