ZMIEŃ punkt końcowy (Transact-SQL)

Umożliwia modyfikowanie istniejący punkt końcowy w następujący sposób:

  • Przez dodanie nowej metoda do istniejącego punktu końcowego.

  • Modyfikując lub upuszczenie metoda istniejącą od punktu końcowego.

  • Zmieniając właściwości punktu końcowego.

Ostrzeżenie

W tym temacie opisano składnię i argumenty, które są specyficzne dla zmiany punktu KOŃCOWEGO.Opisy argumenty, które są wspólne dla utworzenia punktu KOŃCOWEGO i zmieniać punktu KOŃCOWEGO, zobacz Utwórz punkt końcowy (Transact-SQL).

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

ALTER ENDPOINT endPointName [ AUTHORIZATION login ]
[ STATE = { STARTED | STOPPED | DISABLED } ]
[ AS { TCP | HTTP } ( <protocol_specific_items> ) ]
[ FOR { SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
   <language_specific_items>
        ) ]

<AS HTTP_protocol_specific_arguments> ::=
AS HTTP (
  [ [ , ] PATH = 'url' ]
  [ [ , ] PORTS = ( { CLEAR | SSL } [ ,...n ] ) ]
  [ [ , ] SITE = { '*' | '+' | 'webSite' } , ]
  [ [ , ] CLEAR_PORT = clearPort ]
  [ [ , ] SSL_PORT = SSLPort ]
  [ [,] AUTHENTICATION = ( { BASIC | DIGEST | NTLM | KERBEROS | INTEGRATED } [ ,...n ] ) ]
  [ [ , ] 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 (
  [ { ADD WEBMETHOD [ 'namespace' .] 'method_alias' 
    (   NAME = 'database.owner.name'
      [ , SCHEMA = {NONE | STANDARD | DEFAULT } ]
      [ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY | NONE} ]
    )  
  } [ ,...n ] 
  ]

  [ { ALTER WEBMETHOD [ 'namespace' .] 'method_alias' 
    (   NAME = 'database.owner.name'
      [ , SCHEMA = {NONE | STANDARD | DEFAULT} ]
      [ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY } ]
    )  
  } [ ,...n] 
]
  [ [ , ] { DROP WEBMETHOD [ 'namespace' .] 'method_alias' } [ ,...n ] ]
  [ [ , ] BATCHES = { ENABLED | DISABLED } ]
  [ [ , ] WSDL = { NONE | DEFAULT | 'sp_name' } ]
  [ [ , ] SESSIONS = { ENABLED | DISABLED } ]
  [ [ , ] LOGIN_TYPE = { MIXED | WINDOWS } ]
  [ [ , ] SESSION_TIMEOUT = timeoutInterval ]
  [ [ , ] 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 = forwardSize
)

<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

Ostrzeżenie

Zmienianie punktu KOŃCOWEGO dotyczą następujące argumenty.Opisy pozostałe argumenty, zobacz Utwórz punkt końcowy (Transact-SQL).

  • DODAJ WEBMETHOD
    Dodaje nowy punkt końcowy metoda .

    Ważna informacjaWażne:

    Gdy narazić metody za pomocą WEBMETHOD Dodaj, należy się upewnić, że jeśli więcej niż jeden SQL Server bazy danych jest obsługiwany przez ten sam punkt końcowy HTTP nie występują w nakładaniu się nazwa.Aby temu zapobiec, należy rozważyć dodanie adres URL nazwy domena zarejestrowane jako część obszaru nazw ścieżka.

  • ZMIEŃ WEBMETHOD
    Zmienia definicję metoda istniejący punkt końcowy.

  • AS { TCP | HTTP }
    Nie można zmienić transportu protokół z Zmienić punkt końcowy.

  • AUTORYZACJAlogin
    Autoryzacji opcja nie jest dostępna w Zmienić punkt końcowy.Własność można przypisać tylko podczas tworzenia punktu końcowego.

  • UPUŚĆ WEBMETHOD
    Krople istniejący punkt końcowy metoda .

  • DLA {SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING}
    Nie można zmienić typu ładunku z Zmienić punkt końcowy.

Uwagi

Podczas korzystania zmiany punktu KOŃCOWEGO należy określić tylko tych parametrów, które chcesz zaktualizować.Wszystkie właściwości istniejącego punktu końcowego pozostają takie same, chyba że wyraźnie ich nie zmieni.

Nie można wykonać w sprawozdaniu KOŃCOWYM DDL wewnątrz transakcji użytkownika.

Dla informacji na temat wybierania algorytm szyfrowanie do użytku z punktem końcowym, zobacz Wybór algorytmu szyfrowania.

Ostrzeżenie

RC4 jest stosunkowo słaba algorytmu i AES jest stosunkowo silna algorytmu.Ale AES jest znacznie wolniejsze niż RC4.Jeśli zabezpieczenie jest wyższy priorytet dla Ciebie niż prędkość, zalecamy użyć AES.

Uprawnienia

Użytkownik musi być element członkowski sysadmin stała rola serwera, właściciel punktu końcowego, lub mieć udzielone uprawnienie zmienić dowolny punkt końcowy.

Aby zmienić własność istniejący punkt końcowy, należy użyć ALTER autoryzacji instrukcja.Aby uzyskać więcej informacji, zobacz ALTER autoryzacji (Transact-SQL).

Aby uzyskać więcej informacji, zobacz PRZYZNAĆ uprawnienia punktu końcowego (Transact-SQL).

Przykłady

A.Dodawanie nowej metoda do istniejącego punktu końcowego

W następującym przykładzie dodano nową metoda do uprzednio utworzonego punktu końcowego sql_endpoint.

ALTER ENDPOINT sql_endpoint
FOR SOAP
(
  ADD WEBMETHOD 'SayHello' (name='AdventureWorks2008R2.dbo.SayHello')
);

B.Dodawanie nowej metoda , który działa w trybie surowego SOAP

W następującym przykładzie dodano nowe metodasieci WebReportUsageStats , działa w trybie NIEPRZETWORZONYM, określony przez FORMAT=NONE, aby dostarczyć wyniki procedura składowana jest dla klientów protokołu SOAP. Aby uzyskać więcej informacji, zobacz opis opcji formatu w Utwórz punkt końcowy (Transact-SQL).

ALTER ENDPOINT sql_endpoint
FOR SOAP
(
  ADD WEBMETHOD 'ReportUsageStats' (name='myDatabase.dbo.sp_reportserverstats', FORMAT=NONE)
);