Share via


alter bitiş noktası (Transact-SQL)

Varolan bir bitiş noktası aşağıdaki şekillerde değiştirme etkinleştirir:

  • Varolan bir son nokta için yeni bir yöntem ekleyerek.

  • Değiştirme veya varolan bir yöntem bitiş noktasından bırakılıyor.

  • Bir bitiş noktası özelliklerini değiştirme.

Not

Bu konuda, sözdizimi ve alter bitiş noktası için belirli olan bağımsız değişkenler açıklanmaktadır.Son nokta oluşturun ve alter bitiş noktası için ortak olan bağımsız değişkenler tanımları için bkz: Bitiş noktası (Transact-SQL) oluştur.

Yerel xml Web Hizmetleri (soap/http endpoints) önerilmiyor.Daha fazla bilgi için, bkz. Yerel xml Web Hizmetleri: SQL Server 2008 kullanım dışı..

Konu bağlantısı simgesiTransact-SQL sözdizimi kuralları

Sözdizimi

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 }
)

Bağımsız değişkenler

Not

Aşağıdaki bağımsız değişkenler alter bitiş noktası için özeldir.Geri kalan bağımsız değişkenler tanımları için bkz: Bitiş noktası (Transact-SQL) oluştur.

  • ADD WEBMETHOD
    Yeni bir yöntem bitiş noktası ekler.

    Önemli notÖnemli

    Yöntemleri göstermek için add webmethod kullandığınızda, birden fazla ise emin olmalısınız SQL Server veritabanı servise aynı http bitiş noktası tarafından adı örtüştüğü ortaya.Bunu önlemek için kayıtlı etki alanı adı url ad alanının yolbir parçası olarak eklemeyi düşünün.

  • WEBMETHOD DEĞİŞTİRME
    Varolan bir yöntem bitiş noktası tanımını değiştirir.

  • AS { TCP | HTTP }
    Aktarım protokol değiştiremezsiniz alter bitiş noktası.

  • YETKİLENDİRMElogin
    YETKİLENDİRME seçeneği yok alter bitiş noktası.Sahiplik bitiş noktası oluşturulduğunda, yalnızca atanabilir.

  • BIRAKMA WEBMETHOD
    Varolan bir yöntem bitiş noktası bırakır.

  • İÇİN {SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING}
    İle yük türü değiştirilemiyor alter bitiş noktası.

Açıklamalar

alter bitiş noktası kullandığınızda, yalnızca güncelleştirmek istediğiniz parametreleri belirtin.Açıkça değiştirmediğiniz sürece tüm özelliklerinin varolan bir bitiş noktası aynı kalır.

Bitiş noktası DDL deyimleri kullanıcı işlem içinde yürütülemiyor.

Son nokta ile kullanmak için bir şifreleme algoritmasını seçme hakkında bilgi için bkz: Bir şifreleme algoritması seçme.

Not

RC4 görece zayıf algoritma ve aes nispeten daha güçlü bir algoritma.Ancak aes RC4'den oldukça yavaştır.Güvenlik hızı daha yüksek bir öncelik sizin için ise, aes kullanmanızı öneririz.

İzinler

Kullanıcı üye olması sysadmin sabit sunucu rolü, bitiş noktasının sahibi veya alter any bitiş noktası izni verilmiş olması gerekir.

Varolan bir bitiş noktası sahipliğini değiştirmek için alter YETKİLENDİRME deyimkullanmanız gerekir.Daha fazla bilgi için, bkz. alter YETKİLENDİRME (Transact-SQL).

Daha fazla bilgi için, bkz. Bitiş noktası izinleri (Transact-SQL).

Örnekler

A.Varolan bir son nokta için yeni bir yöntem ekleme

Aşağıdaki örnek önceden oluşturulmuş bitiş noktası için yeni bir yöntem ekler sql_endpoint.

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

B.Ham soap modunda işleyen yeni bir yöntem ekleme

Aşağıdaki örnek, yeni bir Web yöntemeklerReportUsageStats raw modunda tarafından belirtilen çalışır FORMAT=NONE, saklı yordam sonuçlar sunmak için olduğu gibi soap istemciler için. Daha fazla bilgi için bkz: format seçeneği açıklaması Bitiş noktası (Transact-SQL) oluştur.

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